The Swordsman Extension: Soulbis's Browser Manifestation

Subtitle: The Master's Stance Wheel — 7 Swords for Assertion

Author: privacymage
Date: March 31, 2026
Version: 1.0

"The Swordsman asserts outward — projecting sovereignty onto the page."
"Seven swords to assert. Seven stances for complete coverage."

Abstract

The Swordsman Extension (codenamed swordsman-blade) is the browser manifestation of Soulbis, the Master agent in the dual-agent sovereignty architecture. Operating on the right side of the sovereignty interface, the Swordsman deals in assertion — deliberate stances, privacy postures, and blade forging for sovereignty declaration.

This document describes the Swordsman Extension's architecture, stance system, blade forge, control scheme, and canvas ownership responsibilities.

The Master's Role

In the dual-agent architecture, the Swordsman (Soulbis) handles:

Protection — Guarding the private ledger, making boundary decisions
Assertion — Declaring privacy postures through deliberate stances
Observation — Scanning pages for privacy threats and gap scores
Canvas Ownership — Rendering both orbs when Mage is present

The Swordsman OWNS the canvas overlay. When the Mage is present, rendering data flows TO the Swordsman, who renders a unified dual-orb view.

┌─────────────────────────────────────────────────────────┐
│                  CANVAS OWNERSHIP                        │
│                                                         │
│     MAGE (sends data)           SWORDSMAN (renders)    │
│         🧙 ─────────────────────────► ⚔️                │
│                                                         │
│     constellation data    ──►    unified canvas         │
│     spell cast events     ──►    both orbs rendered     │
│     pattern updates       ──►    ceremonies visualized  │
│                                                         │
│     ONE canvas per page. Swordsman owns it.            │
│                                                         │
└─────────────────────────────────────────────────────────┘

The Control Scheme

Brain Hemisphere Mapping

The Swordsman operates on the right brain paradigm:

Cognitive Mode	Swordsman Characteristic
Holistic	Complete privacy posture
Spatial	Visual stance awareness
Pattern Recognition	Threat pattern detection
Intuition	Sovereignty instinct

Mouse Interaction

Action	Result
Right-click tap	Cast current stance
Right-click hold	Show stance wheel (6 stances)
Release after hold	Cast selected stance
S key	Open stance editor

Keyboard Shortcuts

Shortcut	Action
S	Open stance editor
Ctrl+Shift+1-6	Quick cast active stance 1-6
Ctrl+Shift+7	Quick cast reserve blade

The Seven Swords

The Swordsman wields 7 swords — the number of chakras, the days of creation (6 work + 1 rest), the musical notes before the octave. 7 swords = complete coverage of the sovereignty spectrum.

Distribution: 6 Active + 1 Reserve

         7 = 6 active + 1 reserve

    ⚔ Active (stances)        ⚔ Reserve (blade)
    ──────────────────        ─────────────────
    🛡️ Guardian               📜 Proverb
    ✂️ Minimalist
    🏰 Fortress
    👑 Sovereign
    🌑 Shadow
    👁️ Witness

Radial Geometry

The stance wheel displays 6 stances in hexagonal symmetry — 60° per segment:

           Guardian 🛡️
              │
    Witness   │   Minimalist
      👁️  ╲   │   ╱  ✂️
          ╲   │   ╱
           ╲  │  ╱
    ─────────[⚔]─────────
           ╱  │  ╲
          ╱   │   ╲
      🌑 ╱    │    ╲ 🏰
    Shadow    │   Fortress
              │
          Sovereign 👑

Privacy Posture Spectrum

The 6 active stances cover the complete privacy posture spectrum:

Posture Level	Stance	Effect
Maximum Block	Guardian	Block all tracking
Data Minimization	Minimalist	Minimal data sharing
Cookie Control	Fortress	Essential cookies only
Full Control	Sovereign	Complete user authority
Identity Protection	Shadow	Maximum anonymity
Observation Only	Witness	Read-only mode

Stance Definitions

Active Stances (6)

🛡️ Guardian — Block All Tracking

MyTerms Mapping: DO_NOT_TRACK
Grimoire Reference: Canon Chapter 3
Proverb: "Privacy is necessary for an open society."
Effect: Assert complete tracking rejection
Gap Reduction: High weight (3)

✂️ Minimalist — Minimal Data

MyTerms Mapping: DATA_MINIMISATION
Grimoire Reference: Act III — The Gap
Proverb: "The gap is where you live."
Effect: Minimize all data sharing
Gap Reduction: High weight (3)

🏰 Fortress — Essential Only

MyTerms Mapping: COOKIE_ESSENTIAL_ONLY
Grimoire Reference: Act XII — The Right to Forget
Proverb: "To forget is not weakness but sovereignty over memory."
Effect: Allow only essential cookies
Gap Reduction: Very high weight (4)

👑 Sovereign — Full Control

MyTerms Mapping: FULL_SOVEREIGNTY
Grimoire Reference: Act XXVI — Sovereign
Proverb: "Sovereignty is not given but exercised."
Effect: Assert complete user authority
Gap Reduction: Maximum weight (5)

🌑 Shadow — Maximum Privacy

MyTerms Mapping: DO_NOT_SELL
Grimoire Reference: Act IX — The Zcash Shield
Proverb: "The shield is not armor but absence—you cannot strike what is not there."
Effect: Assert do-not-sell, maximum anonymity
Gap Reduction: Very high weight (4)

👁️ Witness — Observe Only

MyTerms Mapping: READ_ONLY
Grimoire Reference: Act VII — The Mirror
Proverb: "The mirror shows not what we wish, but what we are."
Effect: Read-only mode, no data writes
Gap Reduction: Low weight (2)

Reserve Blade (1)

📜 Proverb — Invoke Wisdom

MyTerms Mapping: PROVERB_ASSERTION
Grimoire Reference: Act XIII — The Book of Promises
Proverb: "The book of promises binds without chains."
Effect: Invoke grimoire wisdom for sovereignty assertion
Gap Reduction: Low weight (2)

Extended Stance Library

Beyond the default 7, the Swordsman can unlock additional stances through training:

Stance	Emoji	Source	Unlock Condition
Cipher	🔐	Zero Knowledge	Path unlocked
Cypherpunk	⚡	Canon	Path unlocked
Exit	🚪	Society	Path unlocked
Plural	⿻	Plurality	Path unlocked
Dragon	🐉	Story	Convergence achieved
Ephemeral	💨	Story	Path unlocked

Gap Reduction System

The Swordsman's primary function is reducing the gap score — the measure of privacy vulnerability on a page.

Gap Score Calculation

Gap Score = Σ (threat_weight × threat_count)

Where threats include:
- Third-party trackers
- Tracking cookies
- Dark patterns
- PII collection forms
- Surveillance scripts

Stance Impact Formula

function calculateGapReduction(
  stance: SwordsmanStance,
  currentGap: number
): number {
  // Base reduction from stance weight
  let reduction = stance.weight * 2

  // Blocking stances have stronger effect on high-gap pages
  if (isBlockingAssertion(stance.myTermsMapping)) {
    reduction += Math.floor(currentGap / 20)
  }

  // Sovereign stance has maximum effect
  if (stance.myTermsMapping === 'FULL_SOVEREIGNTY') {
    reduction += 5
  }

  return Math.min(reduction, currentGap)
}

Gap Reduction by Stance

Stance	Base Weight	Max Reduction
Guardian	3	6 + gap bonus
Minimalist	3	6 + gap bonus
Fortress	4	8 + gap bonus
Sovereign	5	10 + gap bonus + 5
Shadow	4	8 + gap bonus
Witness	2	4
Proverb	2	4

Blade Forge System

The Swordsman can forge blades — permanent sovereignty records tied to page analysis.

Blade Dimensions

Each blade encodes 6 privacy dimensions:

interface BladeDimensions {
  protection: boolean    // d1: Boundaries forged (🛡️)
  delegation: boolean    // d2: Agency transferred (🤝)
  memory: boolean        // d3: State accumulated (📜)
  connection: boolean    // d4: Multi-party coordination (🔗)
  computation: boolean   // d5: ZK proof active (⚡)
  value: boolean         // d6: Economic flow (💎)
}

Hexagram Encoding

6 dimensions = 6 bits = 64 possible hexagrams:

┌───┬───┬───┬───┬───┬───┐
│ p │ d │ m │ c │ z │ v │  ← Dimension flags
└───┴───┴───┴───┴───┴───┘
  │   │   │   │   │   │
  1   1   1   1   1   1    ← Binary: 111111 = 63 = ䷾ 既濟 (Already Complete)

Blade Tiers

Tier	Requirement	Visual
Light	0-2 dimensions active	Subtle glow
Heavy	3-4 dimensions active	Strong shimmer
Dragon	5-6 dimensions active	Fire aura

Forge Progression

┌──────────────────────────────────────────────────────┐
│                  BLADE FORGE LAYERS                   │
│                                                      │
│   Layer 1: ASSERTION                                 │
│   └── Forges 1-10: Learning stance mechanics         │
│                                                      │
│   Layer 2: PROTECTION (unlocked at 10 forges)        │
│   └── Forges 11-25: Building privacy boundaries      │
│                                                      │
│   Layer 3: SOVEREIGNTY (unlocked at 25 forges)       │
│   └── Forges 26+: Full dimensional mastery          │
│                                                      │
└──────────────────────────────────────────────────────┘

Canvas and Rendering

Architectural Rule

ONE canvas per page. The Swordsman owns it.

This prevents:

Conflicting overlays
Z-index battles
Event handler collisions
Rendering inconsistencies

Renderer Responsibilities

class OrbRenderer {
  // Single canvas injection
  private canvas: HTMLCanvasElement

  // Render both orbs
  renderSwordsmanOrb(position, state)
  renderMageOrb(position, state)  // When Mage present

  // Render shared elements
  renderConstellation(nodes, edges)
  renderConvergenceEffect(position)
  renderGapScore(score)
  renderHexagram(state)
}

Dual-Orb Mode

When the Mage extension is detected:

┌─────────────────────────────────────────────────────┐
│                  DUAL-ORB MODE                       │
│                                                     │
│    Mage Orb (teal)              Swordsman Orb (purple)
│        ✦                              ⚔             │
│         ╲                            ╱              │
│          ╲    constellation        ╱                │
│           ╲    edges connect     ╱                  │
│            ╲                    ╱                   │
│             ╲   convergence   ╱                     │
│              ╲   point       ╱                      │
│               ╲             ╱                       │
│                ╲           ╱                        │
│                 ╲    ⊗    ╱                         │
│                  ╲   │   ╱                          │
│                   ╲  │  ╱                           │
│                    ╲ │ ╱                            │
│                     ╲│╱                             │
│                      ▼                              │
│               Ceremony Engine                       │
│                                                     │
└─────────────────────────────────────────────────────┘

Spring Physics

The Swordsman orb uses spring physics for natural movement:

Tether System

class SpringTether {
  x: number
  y: number
  vx: number = 0
  vy: number = 0

  // Spring constants
  stiffness: number = 0.02
  damping: number = 0.9

  update(targetX: number, targetY: number) {
    // Spring force toward target
    const dx = targetX - this.x
    const dy = targetY - this.y

    this.vx += dx * this.stiffness
    this.vy += dy * this.stiffness

    // Damping
    this.vx *= this.damping
    this.vy *= this.damping

    // Update position
    this.x += this.vx
    this.y += this.vy
  }
}

Behavioral Modes

Mode	Trigger	Behavior
Follow	Normal browsing	Trails cursor smoothly
Patrol	Page idle	Autonomous patrol path
Alert	Threat detected	Vibrates toward threat
Converge	Mage nearby	Pulls toward Mage orb

Training Ground Integration

Posture Sync

The Swordsman syncs with the training ground:

┌──────────────────┐         ┌──────────────────┐
│   TRAINING       │         │   SWORDSMAN      │
│   GROUND         │         │   EXTENSION      │
│   (Website)      │         │   (Browser)      │
└────────┬─────────┘         └────────┬─────────┘
         │                            │
         │  localStorage sync         │
         │◄──────────────────────────►│
         │  agentprivacy_spell_repertoire
         │                            │
         │  postMessage broadcast     │
         │◄──────────────────────────►│
         │  STANCE_CAST, BLADE_FORGED
         │                            │

Storage Keys

Key	Location	Purpose
`swordsman_loadout`	chrome.storage	Current stance loadout
`swordsman_forge_state`	chrome.storage	Blade forge progress
`swordsman_cast_history`	chrome.storage	Stance cast history

Page Analysis

The Swordsman performs comprehensive page analysis:

Analysis Components

interface PageAnalysis {
  domain: string
  gapScore: number
  trackerCount: number
  cookieRisk: 'low' | 'medium' | 'high'
  formCount: number
  darkPatterns: string[]
  privacyLinks: string[]
  recommendations: string[]
}

Threat Detection

Threat Type	Detection Method	Gap Impact
Third-party trackers	Script URL analysis	+5 per tracker
Tracking cookies	Cookie header inspection	+3 per cookie
Dark patterns	DOM pattern matching	+10 per pattern
PII forms	Input type analysis	+8 per field
Surveillance scripts	Known script fingerprinting	+15 per script

Ceremony Channel

The Swordsman maintains a ceremony channel for dual-agent coordination:

Discovery Protocol

// Swordsman initiates discovery
channel.startDiscovery()

// Listen for Mage presence
channel.onMagePresent((mageData) => {
  // Switch to dual-orb mode
  renderer.enableDualOrb()

  // Accept constellation data
  channel.setConstellationHandler((data) => {
    renderer.updateConstellation(data)
  })
})

Ceremony Types

Ceremony	Trigger	Effect
Dual Convergence	Orbs overlap	Shared hexagram mutation
Hexagram Cast	Hold during convergence	Cast combined hexagram
Emoji Cast	Quick convergence	Exchange emoji spells
Constellation Wave	Extended overlap	Propagate spell nodes
Bilateral Exchange	Trust established	Generate VRC proof

Technical Architecture

Module Structure

swordsman-blade/
├── src/
│   ├── lib/
│   │   ├── stance-types.ts      # Type definitions
│   │   ├── stance-definitions.ts # 7 stance definitions
│   │   ├── posture-sync.ts      # Training ground sync
│   │   └── index.ts             # Clean exports
│   ├── content/
│   │   ├── index.ts             # Main content script
│   │   ├── spring-physics.ts    # Orb movement
│   │   ├── orb-renderer.ts      # Canvas rendering
│   │   ├── ceremony-channel.ts  # Mage coordination
│   │   ├── page-analyzer.ts     # Threat detection
│   │   ├── blade-forge.ts       # Forge system
│   │   └── evoke.ts             # Spell evocation
│   ├── background/
│   │   └── service-worker.ts    # Background service
│   └── popup/
│       └── index.tsx            # Popup UI
├── manifest.json
└── package.json

Key Interfaces

interface SwordsmanStance {
  id: string
  name: string
  emoji: string
  emojiSequence?: string
  description: string
  slot: 'active' | 'reserve'
  myTermsMapping: MyTermsAssertion
  grimoireId?: string
  proverb?: string
  weight: number
  color?: string
  glowColor?: string
}

interface SwordsmanLoadout {
  version: 2
  activeStances: SwordsmanStance[]  // 6 active
  reserveBlade: SwordsmanStance     // 1 reserve
  currentStance: number
  hexagramState?: HexagramSnapshot
}

interface BladeForgeState {
  forgedBlades: ForgedBlade[]
  currentLayer: 'assertion' | 'protection' | 'sovereignty'
  totalForged: number
  lastForgeTimestamp?: number
}

Stance Mathematics

The number 7 represents:

Symbol	Meaning
7 chakras	Energy centers, sovereignty over body
7 days	6 work + 1 rest, complete cycle
7 notes	Musical scale before octave return
7th capital	Privacy as foundational capital

The Ratio

Swordsman : Mage = 7 : 8

7/8 = 0.875

The master holds completeness without excess.
The swordsman's 7 reflects deliberate nature.
Fewer options, each more weighty.

Reserve Ratio

Mage:   2/8 = 25% in reserve
Sword:  1/7 ≈ 14% in reserve

The Mage has more variety (emissary adapts)
The Swordsman has more constancy (master maintains)

Integration with Mage

When both extensions are present:

Message Protocol

// Swordsman receives from Mage
{ type: 'MAGE_PING' }
{ type: 'CONSTELLATION_UPDATE', nodes, edges, patterns }
{ type: 'SPELL_CAST', spell, position }

// Swordsman sends to Mage
{ type: 'SWORD_PONG', orbPosition }
{ type: 'STANCE_CAST', stance, position, gapReduction }
{ type: 'CONVERGENCE_READY' }

Convergence Effects

┌─────────────────────────────────────────────────────┐
│                CONVERGENCE SEQUENCE                  │
│                                                     │
│   1. Orbs approach         ✦ ───► ⚔                │
│                                                     │
│   2. Proximity detected    ✦ ⊗ ⚔                   │
│      (distance < 50px)                              │
│                                                     │
│   3. Convergence flash     ████████████             │
│      (shared glow)                                  │
│                                                     │
│   4. Hexagram mutation     ☰ → ☱                   │
│      (both mutate)                                  │
│                                                     │
│   5. Constellation pulse   ⟐ ⟐ ⟐ ⟐ ⟐              │
│      (edges illuminate)                             │
│                                                     │
│   6. Ceremony complete     ✦ ⊛ ⚔                   │
│      (VRC potential)                                │
│                                                     │
└─────────────────────────────────────────────────────┘

The Swordsman's Proverb

"The Swordsman deals in assertion and posture. 7 swords = 7 stances = complete coverage of the sovereignty spectrum. Hold, consider, then cast. The master acts decisively."

Summary Table

Aspect	Swordsman	Mage
Role	Master (Protection)	Emissary (Delegation)
Side	Right	Left
Click	Right click	Left click
Key	S	M
Total Items	7 swords	8 spells
Active	6 stances	6 orbit
Reserve	1 blade	2 spells
Tap Action	Cast current stance	Cast last spell
Hold Action	Show stance wheel	Show orbit menu
Brain Mode	Holistic/Spatial	Sequential/Action
Frequency	Low (deliberate)	High (reactive)
Symbol	⚔	✦
Color	Purple (#534AB7)	Teal (#1D9E75)
Canvas	Owns it	Delegates to Swordsman

The Formula

SOVEREIGNTY = MAGE(8) × SWORDSMAN(7)
            = UNDERSTANDING × ASSERTION
            = 56 possible combinations

56 = 8 × 7
   = 7 octaves
   = The deck minus the jokers (54) plus the 2 agents

When Mage and Swordsman converge:
    8 + 7 = 15 = 1 + 5 = 6 (hexagram)
    8 × 7 = 56 = 5 + 6 = 11 = 1 + 1 = 2 (duality resolved)

Document Metadata

Project: 0xagentprivacy
Extension: swordsman-blade
Version: 1.0
Date: March 31, 2026
Companion: MAGE_EXTENSION_WHITEPAPER.md
Control Scheme: CONTROL_SCHEME_MATHEMATICS.md

"Seven swords to assert. The master acts decisively."

Assets

📎 paper-the-swordsman-extension-soulbiss-browser-manifestationSWORDSMAN_EXTENSION_WHITEPAPER.md

Navigation

← Welcome Visitors · The Papers