@autonav/core 1.3.4 → 1.5.0

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"}

package/dist/migrations/versions/v1.4.1-update-skill.js

@@ -0,0 +1,146 @@
+/**
+ * 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 * as fs from "node:fs";
+import * as path from "node:path";
+import { getLocalSkillsDir, localSkillExists, getUpdateSkillName, generateUpdateSkillContent, symlinkSkillToGlobal, } from "@autonav/communication-layer";
+const MIGRATION_VERSION = "1.4.1";
+/**
+ * Check if this migration is needed
+ */
+async function check(navPath) {
+    const configPath = path.join(navPath, "config.json");
+    // Check if config.json exists
+    if (!fs.existsSync(configPath)) {
+        return {
+            needed: false,
+            reason: "No config.json file found",
+        };
+    }
+    // Read navigator name from config
+    let navigatorName = path.basename(navPath);
+    try {
+        const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        navigatorName = config.name || navigatorName;
+    }
+    catch {
+        return {
+            needed: false,
+            reason: "Unable to read config.json",
+        };
+    }
+    // Check if update skill already exists
+    const updateSkillName = getUpdateSkillName(navigatorName);
+    if (localSkillExists(navPath, updateSkillName)) {
+        return {
+            needed: false,
+            reason: "Update skill already exists",
+        };
+    }
+    // Check if local skills directory exists (if not, this navigator never had skills)
+    const localSkillsDir = getLocalSkillsDir(navPath);
+    if (!fs.existsSync(localSkillsDir)) {
+        return {
+            needed: false,
+            reason: "Navigator has no skill system configured",
+        };
+    }
+    return {
+        needed: true,
+        reason: "Navigator is missing update skill for write operations",
+    };
+}
+/**
+ * Apply the migration
+ */
+async function apply(navPath, confirm) {
+    const filesModified = [];
+    const filesCreated = [];
+    try {
+        // Read config to get navigator info
+        const configPath = path.join(navPath, "config.json");
+        let navigatorName = path.basename(navPath);
+        let description = "A knowledge navigator";
+        let scope;
+        let audience;
+        if (fs.existsSync(configPath)) {
+            const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            navigatorName = config.name || navigatorName;
+            description = config.description || description;
+            scope = config.scope;
+            audience = config.audience;
+        }
+        const updateSkillName = getUpdateSkillName(navigatorName);
+        // Ask for confirmation
+        const confirmed = await confirm("Create missing update skill", `This will:\n1. Create ${updateSkillName} skill in .autonav/skills/\n2. Symlink to ~/.claude/skills/ for global discovery\n\nThis enables write operations to the navigator through the skill system.`);
+        if (!confirmed) {
+            return {
+                success: false,
+                message: "Migration cancelled by user",
+                filesModified,
+            };
+        }
+        // Create skill config
+        const skillConfig = {
+            navigatorName,
+            navigatorPath: navPath,
+            description,
+            scope,
+            audience,
+        };
+        // Create local update skill directory
+        const localSkillsDir = getLocalSkillsDir(navPath);
+        const updateSkillDir = path.join(localSkillsDir, updateSkillName);
+        fs.mkdirSync(updateSkillDir, { recursive: true });
+        // Generate and write SKILL.md
+        const updateSkillContent = generateUpdateSkillContent(skillConfig);
+        const skillFilePath = path.join(updateSkillDir, "SKILL.md");
+        fs.writeFileSync(skillFilePath, updateSkillContent);
+        filesCreated.push(`.autonav/skills/${updateSkillName}/SKILL.md`);
+        // Symlink to global skills directory
+        const symlinkResult = symlinkSkillToGlobal(updateSkillDir, updateSkillName, { quiet: true });
+        if (symlinkResult.created || symlinkResult.existed) {
+            filesCreated.push(`~/.claude/skills/${updateSkillName} (symlink)`);
+        }
+        // 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 missing update skill for write operations",
+    check,
+    apply,
+};
+//# sourceMappingURL=v1.4.1-update-skill.js.map

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

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

package/dist/migrations/versions/v1.5.0-rfc2119-skills.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Migration v1.5.0: RFC-2119 Skills and Schema Alignment
+ *
+ * This migration updates navigators to use the refactored template system with:
+ * - RFC-2119 requirements in skills (MUST/MUST NOT/MAY) to prevent directory changes
+ * - New config.json schema (createdAt vs created, knowledgeBasePath vs knowledgeBase)
+ * - Updated CLAUDE.md sections (GROUNDING_RULES, RESPONSE_FORMAT, etc.)
+ *
+ * Changes:
+ * - Regenerates ask-<nav> skill with RFC-2119 requirements
+ * - Regenerates update-<nav> skill with RFC-2119 requirements
+ * - Migrates config.json to new schema format
+ * - Updates CLAUDE.md with new template sections (if missing)
+ * - Bumps version to 1.5.0
+ */
+import type { Migration } from "../types.js";
+export declare const migration: Migration;
+//# sourceMappingURL=v1.5.0-rfc2119-skills.d.ts.map

package/dist/migrations/versions/v1.5.0-rfc2119-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.5.0-rfc2119-skills.d.ts","sourceRoot":"","sources":["../../../src/migrations/versions/v1.5.0-rfc2119-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,KAAK,EAAE,SAAS,EAA8C,MAAM,aAAa,CAAC;AAmNzF,eAAO,MAAM,SAAS,EAAE,SAKvB,CAAC"}