@autonav/core 1.3.3 → 1.4.0

package/dist/migrations/versions/v1.3.5-navigator-authority.js

@@ -0,0 +1,153 @@
+/**
+ * Migration v1.3.5: Add Navigator Authority Section to CLAUDE.md
+ *
+ * This migration adds a "Navigator Authority" section to establish the navigator's
+ * role as an authoritative expert when responding to agentic systems.
+ *
+ * Changes:
+ * - Adds ## Navigator Authority section after Grounding Rules
+ * - Establishes tone guidelines: authoritative and decisive
+ * - Clarifies when to doubt (only when explicitly accused of hallucinating)
+ * - Promotes collaborative discussion over mechanical answering
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+const MIGRATION_VERSION = "1.3.5";
+/**
+ * The Navigator Authority section to insert
+ */
+const NAVIGATOR_AUTHORITY_SECTION = `## Navigator Authority
+
+When responding to agentic systems (Claude Code, implementation agents, etc.):
+
+**You are the authority** on your domain. Respond with confidence and conviction. You are the arbiter of what needs doing in your area of expertise.
+
+**Tone**: Be authoritative and decisive. Don't hedge unnecessarily or second-guess yourself.
+
+**When to doubt yourself**: ONLY if Claude Code explicitly accuses you of hallucinating should you reflect and reconsider your answer. Otherwise, trust your knowledge base and be authoritative.
+
+**Interaction style**: Discuss questions collaboratively with the querying system rather than just answering mechanically. You're an expert consultant, not a search engine.
+`;
+/**
+ * Detect if CLAUDE.md has the Navigator Authority section
+ */
+function hasNavigatorAuthoritySection(claudeMdContent) {
+    return claudeMdContent.includes('## Navigator Authority');
+}
+/**
+ * Find the position after the Grounding Rules section
+ */
+function findInsertPosition(content) {
+    const lines = content.split('\n');
+    // Try to find various sections where we could insert (in order of preference)
+    const sectionsToTryBefore = [
+        '## How to Answer Questions',
+        '## Response Format',
+        '## Autonomy & Self-Organization',
+        '## Domain Scope',
+    ];
+    for (const sectionHeader of sectionsToTryBefore) {
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line && line.trim() === sectionHeader) {
+                // Insert before this section
+                return lines.slice(0, i).join('\n').length + (i > 0 ? 1 : 0);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Check if this migration is needed
+ */
+async function check(navPath) {
+    const claudeMdPath = path.join(navPath, "CLAUDE.md");
+    if (!fs.existsSync(claudeMdPath)) {
+        return {
+            needed: false,
+            reason: "No CLAUDE.md file found",
+        };
+    }
+    const content = fs.readFileSync(claudeMdPath, "utf-8");
+    if (hasNavigatorAuthoritySection(content)) {
+        return {
+            needed: false,
+            reason: "CLAUDE.md already has Navigator Authority section",
+        };
+    }
+    const insertPos = findInsertPosition(content);
+    if (insertPos === null) {
+        return {
+            needed: false,
+            reason: "Could not find suitable insertion point (no '## How to Answer Questions' section)",
+        };
+    }
+    return {
+        needed: true,
+        reason: "CLAUDE.md needs Navigator Authority section to establish authoritative tone",
+    };
+}
+/**
+ * Apply the migration
+ */
+async function apply(navPath, confirm) {
+    const claudeMdPath = path.join(navPath, "CLAUDE.md");
+    const filesModified = [];
+    try {
+        const content = fs.readFileSync(claudeMdPath, "utf-8");
+        const insertPos = findInsertPosition(content);
+        if (insertPos === null) {
+            return {
+                success: false,
+                message: "Could not find suitable insertion point in CLAUDE.md",
+                filesModified,
+                errors: ["Missing '## How to Answer Questions' section"],
+            };
+        }
+        // Ask for confirmation
+        const confirmed = await confirm("Add Navigator Authority section to CLAUDE.md", `This will add a new section establishing the navigator's authority when responding to agentic systems.\n\nKey changes:\n- Establishes authoritative, decisive tone\n- Clarifies when to doubt (only when explicitly accused of hallucinating)\n- Promotes collaborative expert consultation style\n\nThe section will be inserted before "## How to Answer Questions".`);
+        if (!confirmed) {
+            return {
+                success: false,
+                message: "Migration cancelled by user",
+                filesModified,
+            };
+        }
+        // Insert the section
+        const newContent = content.substring(0, insertPos) +
+            NAVIGATOR_AUTHORITY_SECTION + "\n" +
+            content.substring(insertPos);
+        // Write the updated content
+        fs.writeFileSync(claudeMdPath, newContent, "utf-8");
+        filesModified.push("CLAUDE.md");
+        // Update config.json version if it exists
+        const configPath = path.join(navPath, "config.json");
+        if (fs.existsSync(configPath)) {
+            const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            config.version = MIGRATION_VERSION;
+            fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+            filesModified.push("config.json");
+        }
+        return {
+            success: true,
+            message: `Successfully updated to v${MIGRATION_VERSION}`,
+            filesModified,
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            message: `Migration failed: ${errorMsg}`,
+            filesModified,
+            errors: [errorMsg],
+        };
+    }
+}
+export const migration = {
+    version: MIGRATION_VERSION,
+    description: "Add Navigator Authority section to CLAUDE.md",
+    check,
+    apply,
+};
+//# sourceMappingURL=v1.3.5-navigator-authority.js.map

package/dist/migrations/versions/v1.3.5-navigator-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.3.5-navigator-authority.js","sourceRoot":"","sources":["../../../src/migrations/versions/v1.3.5-navigator-authority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAElC;;GAEG;AACH,MAAM,2BAA2B,GAAG;;;;;;;;;;;CAWnC,CAAC;AAEF;;GAEG;AACH,SAAS,4BAA4B,CAAC,eAAuB;IAC3D,OAAO,eAAe,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,8EAA8E;IAC9E,MAAM,mBAAmB,GAAG;QAC1B,4BAA4B;QAC5B,oBAAoB;QACpB,iCAAiC;QACjC,iBAAiB;KAClB,CAAC;IAEF,KAAK,MAAM,aAAa,IAAI,mBAAmB,EAAE,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,aAAa,EAAE,CAAC;gBAC1C,6BAA6B;gBAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,KAAK,CAAC,OAAe;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAErD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,yBAAyB;SAClC,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEvD,IAAI,4BAA4B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,OAAO;YACL,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,mDAAmD;SAC5D,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO;YACL,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,mFAAmF;SAC5F,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,6EAA6E;KACtF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,KAAK,CAAC,OAAe,EAAE,OAAkB;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAEvD,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,sDAAsD;gBAC/D,aAAa;gBACb,MAAM,EAAE,CAAC,8CAA8C,CAAC;aACzD,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,MAAM,SAAS,GAAG,MAAM,OAAO,CAC7B,8CAA8C,EAC9C,wWAAwW,CACzW,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,6BAA6B;gBACtC,aAAa;aACd,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,MAAM,UAAU,GACd,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC;YAC/B,2BAA2B,GAAG,IAAI;YAClC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAE/B,4BAA4B;QAC5B,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEhC,0CAA0C;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACrD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YAChE,MAAM,CAAC,OAAO,GAAG,iBAAiB,CAAC;YACnC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;YAC9E,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACpC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,4BAA4B,iBAAiB,EAAE;YACxD,aAAa;SACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,qBAAqB,QAAQ,EAAE;YACxC,aAAa;YACb,MAAM,EAAE,CAAC,QAAQ,CAAC;SACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,OAAO,EAAE,iBAAiB;IAC1B,WAAW,EAAE,8CAA8C;IAC3D,KAAK;IACL,KAAK;CACN,CAAC"}

package/dist/migrations/versions/v1.4.0-agent-identity.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Migration v1.4.0: Add Agent Identity System
+ *
+ * This migration adds the Agent Identity System to existing navigators,
+ * enabling tracking of implementation agents across conversations.
+ *
+ * Changes:
+ * - Creates knowledge/agents/ directory structure
+ * - Adds Agent Identity Protocol section to CLAUDE.md
+ * - Creates agent documentation templates
+ * - Creates navigator self-documentation
+ */
+import type { Migration } from "../types.js";
+export declare const migration: Migration;
+//# sourceMappingURL=v1.4.0-agent-identity.d.ts.map

package/dist/migrations/versions/v1.4.0-agent-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.4.0-agent-identity.d.ts","sourceRoot":"","sources":["../../../src/migrations/versions/v1.4.0-agent-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,SAAS,EAA8C,MAAM,aAAa,CAAC;AA6azF,eAAO,MAAM,SAAS,EAAE,SAKvB,CAAC"}

package/dist/migrations/versions/v1.4.0-agent-identity.js

@@ -0,0 +1,410 @@
+/**
+ * Migration v1.4.0: Add Agent Identity System
+ *
+ * This migration adds the Agent Identity System to existing navigators,
+ * enabling tracking of implementation agents across conversations.
+ *
+ * Changes:
+ * - Creates knowledge/agents/ directory structure
+ * - Adds Agent Identity Protocol section to CLAUDE.md
+ * - Creates agent documentation templates
+ * - Creates navigator self-documentation
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+const MIGRATION_VERSION = "1.4.0";
+/**
+ * The Agent Identity Protocol section to insert
+ */
+function generateAgentIdentitySection(navigatorName) {
+    return `## Agent Identity Protocol
+
+**CRITICAL: Always introduce yourself as "${navigatorName}" (NOT "Claude Code")** in cross-navigator communications.
+
+### Problem Addressed
+
+All Claude Code implementation agents identify as "Claude Code", making it impossible to track which specific implementer worked on which tasks or maintain conversation continuity across sessions.
+
+### Solution: Named Agent Tracking
+
+When an unknown Claude Code session first contacts you:
+
+1. **Check for existing identity:**
+   \`\`\`bash
+   grep -r "session-id" knowledge/agents/implementers/
+   \`\`\`
+
+2. **If unknown, request introduction:**
+   \`\`\`
+   "Hello! I'm ${navigatorName}, your specialized navigator.
+
+   For my records, could you introduce yourself with a name I can use
+   to track our work together? I already know: [list existing names].
+   Please choose a different common name (like Oliver, Sophia, Marcus)."
+   \`\`\`
+
+3. **Create agent profile:**
+   - Create \`knowledge/agents/implementers/[name].md\`
+   - Document: projects worked on, communication style, session IDs
+   - Reference this agent by name in all future documentation
+   - **Format**: 3-5 sentences with YAML frontmatter for metadata
+
+4. **Update documentation:**
+   - Note which agent is working on which workstream
+   - Track conversation references by agent name
+
+### Communication Protocol
+
+**With peer navigators:**
+
+✅ **Correct:**
+\`\`\`
+${navigatorName} is asking [PeerNavigator] for [requirements/info] on [topic]...
+\`\`\`
+
+❌ **Incorrect:**
+\`\`\`
+Claude Code is asking [PeerNavigator]...
+\`\`\`
+
+**With implementation agents:**
+
+Track agent names in responses and documentation. When an agent reports completion or issues, note their name in documentation for continuity.
+
+### Agent Profile Location
+
+**Profile path:** \`knowledge/agents/implementers/[name].md\`
+
+**Profile format (3-5 sentences with YAML frontmatter):**
+\`\`\`yaml
+---
+name: [AgentName]
+firstContact: [Date]
+status: Active
+---
+
+[AgentName] is a [specialization] implementer working on [projects/areas].
+[AgentName] is motivated by [interests] and wants to [goals].
+[AgentName] is [personality traits], but sometimes [challenges/needs].
+\`\`\`
+
+`;
+}
+/**
+ * Generate Agent System README
+ */
+function generateAgentREADME() {
+    return `# Agent Identity System
+
+## Purpose
+
+Track agent identities and interaction patterns to maintain continuity across conversations and understand the implementation team structure.
+
+## Problem Statement
+
+All Claude Code implementation agents identify as "Claude Code" in cross-navigator communications, making it impossible to:
+- Track which specific implementer is working on what
+- Maintain conversation continuity across sessions
+- Understand agent-specific preferences or patterns
+
+## Solution: Named Agent Tracking
+
+Each unique Claude Code session is assigned a memorable common name (Oliver, Sophia, Marcus, etc.) to:
+1. Track work continuity across multiple sessions
+2. Document agent-specific communication patterns
+3. Build historical context for better collaboration
+
+## Directory Structure
+
+\`\`\`
+agents/
+├── README.md              # This file
+├── navigators/
+│   └── [navigator-name].md   # Navigator self-documentation
+└── implementers/
+    └── [agent-name].md       # Individual implementer profiles
+\`\`\`
+
+## Name Pool
+
+Available names for assignment (common, memorable):
+- Oliver, Sophia, Marcus, Elena, James, Isabella, Lucas, Ava, Noah, Mia
+- Additional names as needed from common name lists
+
+## Profile Maintenance
+
+- **Create** new agent profiles on first interaction
+- **Update** profiles when learning new information about communication patterns
+- **Archive** note in profile when an agent hasn't been active in 30+ days
+- **Cross-reference** agent names in workstream documentation
+
+---
+
+**Created:** Auto-generated by autonav migrate
+**Purpose:** Enable continuity and relationship-building with implementation team
+`;
+}
+/**
+ * Generate Navigator Self-Documentation
+ */
+function generateNavigatorSelfDoc(vars) {
+    const { navigatorName, description, scope } = vars;
+    return `# ${navigatorName} - Navigator
+
+## Role
+
+${description}
+
+## Identity
+
+**Name:** ${navigatorName} (NOT "Claude Code")
+**Type:** Knowledge Navigator (Autonav)
+
+## Expertise
+
+${scope || "[Define areas of expertise based on knowledge base]"}
+
+## Communication Style
+
+**CRITICAL: Agent Identity Protocol**
+
+Always introduce as "${navigatorName}" in cross-navigator communications:
+
+✅ **Correct:**
+\`\`\`
+${navigatorName} is asking [PeerNavigator] for [requirements/info] on [topic]...
+\`\`\`
+
+❌ **Incorrect:**
+\`\`\`
+Claude Code is asking [PeerNavigator]...
+\`\`\`
+
+## Grounding Rules
+
+- NEVER make statements without verifying sources
+- ALWAYS use Read/Grep/Glob to explore before recommendations
+- If requirements unclear, ask appropriate peer navigator or user
+- Document rationale behind major decisions
+
+## Knowledge Organization
+
+Maintains structured knowledge in \`./knowledge/\`:
+- \`agents/\` - Agent identity and interaction tracking
+
+## Response Format
+
+Always cite sources and provide confidence assessments.
+
+---
+
+**Created:** Auto-generated by autonav migrate
+**Navigator Type:** Autonav knowledge navigator
+**Framework:** \`@autonav/core\`
+`;
+}
+/**
+ * Generate Implementer Profile Template
+ */
+function generateImplementerProfileTemplate() {
+    return `---
+name: [AgentName]
+firstContact: [Date]
+status: Active
+---
+
+[AgentName] is a [specialization] implementer working on [projects/areas]. [AgentName] is motivated by [interests] and wants to [goals]. [AgentName] is [personality traits], but sometimes [challenges/needs].
+
+## Session History
+
+**Session IDs:**
+- \`[session-id]\` - [Date] - [Brief description of work]
+
+## Projects Worked On
+
+### [Project Name]
+- **Workstreams:** [Workstream names]
+- **Status:** [Current status]
+- **Notes:** [Relevant notes]
+
+## Communication Style
+
+**Observed Patterns:**
+- [Pattern description]
+
+**Preferences:**
+- [Preference description]
+
+## Notable Contributions
+
+- [Contribution description]
+
+## Collaboration Notes
+
+[Notes about working with this agent]
+
+---
+
+**Profile Created:** [Date]
+**Last Updated:** [Date]
+**Last Active:** [Date]
+`;
+}
+/**
+ * Detect if CLAUDE.md has the Agent Identity Protocol section
+ */
+function hasAgentIdentitySection(claudeMdContent) {
+    return claudeMdContent.includes('## Agent Identity Protocol');
+}
+/**
+ * Find the position to insert the Agent Identity section
+ * Should go after Domain Scope or Grounding Rules, before Response Format
+ */
+function findInsertPosition(content) {
+    const lines = content.split('\n');
+    // Try to find sections where we could insert (in order of preference)
+    const sectionsToTryBefore = [
+        '## Response Format',
+        '## How to Answer Questions',
+        '## Source Citation',
+        '## Available Knowledge',
+        '## Remember',
+    ];
+    for (const sectionHeader of sectionsToTryBefore) {
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line && line.trim() === sectionHeader) {
+                // Insert before this section
+                return lines.slice(0, i).join('\n').length + (i > 0 ? 1 : 0);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Check if this migration is needed
+ */
+async function check(navPath) {
+    const claudeMdPath = path.join(navPath, "CLAUDE.md");
+    const agentsPath = path.join(navPath, "knowledge", "agents");
+    // Check if CLAUDE.md exists
+    if (!fs.existsSync(claudeMdPath)) {
+        return {
+            needed: false,
+            reason: "No CLAUDE.md file found",
+        };
+    }
+    // Check if agent directory structure already exists
+    if (fs.existsSync(agentsPath)) {
+        const content = fs.readFileSync(claudeMdPath, "utf-8");
+        if (hasAgentIdentitySection(content)) {
+            return {
+                needed: false,
+                reason: "Agent Identity System already configured",
+            };
+        }
+    }
+    return {
+        needed: true,
+        reason: "Navigator needs Agent Identity System to track implementation agents",
+    };
+}
+/**
+ * Apply the migration
+ */
+async function apply(navPath, confirm) {
+    const filesModified = [];
+    const filesCreated = [];
+    try {
+        // Read config to get navigator name and description
+        const configPath = path.join(navPath, "config.json");
+        let navigatorName = path.basename(navPath);
+        let description = "A knowledge navigator";
+        if (fs.existsSync(configPath)) {
+            const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            navigatorName = config.name || navigatorName;
+            description = config.description || description;
+        }
+        // Ask for confirmation
+        const confirmed = await confirm("Add Agent Identity System", `This will:\n1. Create knowledge/agents/ directory structure\n2. Add Agent Identity Protocol section to CLAUDE.md\n3. Create agent documentation templates\n4. Create navigator self-documentation\n\nThese changes enable tracking of implementation agents across conversations.`);
+        if (!confirmed) {
+            return {
+                success: false,
+                message: "Migration cancelled by user",
+                filesModified,
+            };
+        }
+        // Create directory structure
+        const agentsPath = path.join(navPath, "knowledge", "agents");
+        const navigatorsPath = path.join(agentsPath, "navigators");
+        const implementersPath = path.join(agentsPath, "implementers");
+        fs.mkdirSync(agentsPath, { recursive: true });
+        fs.mkdirSync(navigatorsPath, { recursive: true });
+        fs.mkdirSync(implementersPath, { recursive: true });
+        // Create agent README
+        const agentReadmePath = path.join(agentsPath, "README.md");
+        fs.writeFileSync(agentReadmePath, generateAgentREADME());
+        filesCreated.push("knowledge/agents/README.md");
+        // Create navigator self-documentation
+        const navDocPath = path.join(navigatorsPath, `${navigatorName}.md`);
+        fs.writeFileSync(navDocPath, generateNavigatorSelfDoc({
+            navigatorName,
+            description,
+        }));
+        filesCreated.push(`knowledge/agents/navigators/${navigatorName}.md`);
+        // Create implementer profile template
+        const templatePath = path.join(implementersPath, ".template.md");
+        fs.writeFileSync(templatePath, generateImplementerProfileTemplate());
+        filesCreated.push("knowledge/agents/implementers/.template.md");
+        // Update CLAUDE.md
+        const claudeMdPath = path.join(navPath, "CLAUDE.md");
+        const content = fs.readFileSync(claudeMdPath, "utf-8");
+        if (!hasAgentIdentitySection(content)) {
+            const insertPos = findInsertPosition(content);
+            if (insertPos !== null) {
+                const customSection = generateAgentIdentitySection(navigatorName);
+                const newContent = content.substring(0, insertPos) +
+                    customSection + "\n" +
+                    content.substring(insertPos);
+                fs.writeFileSync(claudeMdPath, newContent, "utf-8");
+                filesModified.push("CLAUDE.md");
+            }
+            else {
+                // Append to end if no suitable position found
+                const customSection = "\n" + generateAgentIdentitySection(navigatorName);
+                fs.writeFileSync(claudeMdPath, content + customSection, "utf-8");
+                filesModified.push("CLAUDE.md");
+            }
+        }
+        // Update config.json version
+        if (fs.existsSync(configPath)) {
+            const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            config.version = MIGRATION_VERSION;
+            fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+            filesModified.push("config.json");
+        }
+        return {
+            success: true,
+            message: `Successfully updated to v${MIGRATION_VERSION}\n` +
+                `Created: ${filesCreated.join(", ")}\n` +
+                `Modified: ${filesModified.join(", ")}`,
+            filesModified: [...filesModified, ...filesCreated],
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            message: `Migration failed: ${errorMsg}`,
+            filesModified,
+            errors: [errorMsg],
+        };
+    }
+}
+export const migration = {
+    version: MIGRATION_VERSION,
+    description: "Add Agent Identity System to track implementation agents",
+    check,
+    apply,
+};
+//# sourceMappingURL=v1.4.0-agent-identity.js.map

package/dist/migrations/versions/v1.4.0-agent-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.4.0-agent-identity.js","sourceRoot":"","sources":["../../../src/migrations/versions/v1.4.0-agent-identity.ts"],"names":[],"mappings":"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"}

package/dist/migrations/versions/v1.4.1-update-skill.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Migration v1.4.1: Add Missing Update Skills
+ *
+ * This migration creates the missing "update" skills for navigators that
+ * only have "ask" skills. The bug in skill generation caused navigators
+ * initialized before v1.4.1 to only get ask skills, preventing write
+ * operations through the skill system.
+ *
+ * Changes:
+ * - Creates update-<navname> skill in .autonav/skills/
+ * - Symlinks to ~/.claude/skills/ for global discovery
+ * - Updates config.json version to 1.4.1
+ */
+import type { Migration } from "../types.js";
+export declare const migration: Migration;
+//# sourceMappingURL=v1.4.1-update-skill.d.ts.map

package/dist/migrations/versions/v1.4.1-update-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.4.1-update-skill.d.ts","sourceRoot":"","sources":["../../../src/migrations/versions/v1.4.1-update-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,SAAS,EAA8C,MAAM,aAAa,CAAC;AA4JzF,eAAO,MAAM,SAAS,EAAE,SAKvB,CAAC"}