@cluesmith/codev 1.1.1 → 1.2.0

package/dist/commands/import.js

@@ -0,0 +1,278 @@
+/**
+ * codev import - AI-assisted protocol import from other codev projects
+ *
+ * Fetches codev/ directory from another project (local or GitHub) and
+ * spawns an interactive Claude session to analyze differences and
+ * recommend imports.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { spawn, execSync } from 'node:child_process';
+import chalk from 'chalk';
+import { findProjectRoot } from '../lib/skeleton.js';
+/**
+ * Parse a source argument into its type and path
+ */
+function parseSource(source) {
+    // GitHub URL patterns:
+    // - github:owner/repo
+    // - https://github.com/owner/repo
+    // - git@github.com:owner/repo.git
+    if (source.startsWith('github:')) {
+        const repo = source.slice('github:'.length);
+        return { type: 'github', path: repo, repo };
+    }
+    if (source.includes('github.com')) {
+        // Extract owner/repo from URL
+        // Regex captures owner/repo including dots (e.g., vercel/next.js, owner/repo.name)
+        const match = source.match(/github\.com[/:]([\w.-]+\/[\w.-]+)/);
+        if (match) {
+            const repo = match[1].replace(/\.git$/, '');
+            return { type: 'github', path: repo, repo };
+        }
+    }
+    // Treat as local path
+    return { type: 'local', path: source };
+}
+/**
+ * Fetch codev directory from GitHub
+ */
+async function fetchFromGitHub(repo, tempDir) {
+    console.log(chalk.dim(`Fetching from GitHub: ${repo}...`));
+    // Clone with depth 1 to get only latest
+    const cloneUrl = `https://github.com/${repo}.git`;
+    try {
+        execSync(`git clone --depth 1 "${cloneUrl}" "${tempDir}"`, {
+            stdio: 'pipe',
+            encoding: 'utf-8',
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to clone ${repo}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const codevDir = path.join(tempDir, 'codev');
+    if (!fs.existsSync(codevDir)) {
+        throw new Error(`Repository ${repo} does not have a codev/ directory`);
+    }
+    return codevDir;
+}
+/**
+ * Read relevant codev files for comparison
+ */
+function readCodevDirectory(dir) {
+    const files = new Map();
+    // Directories to include in comparison
+    const includeDirs = ['protocols', 'resources', 'roles'];
+    function walkDir(currentPath, relativePath) {
+        if (!fs.existsSync(currentPath))
+            return;
+        const entries = fs.readdirSync(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentPath, entry.name);
+            const relPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                walkDir(fullPath, relPath);
+            }
+            else if (entry.name.endsWith('.md')) {
+                try {
+                    const content = fs.readFileSync(fullPath, 'utf-8');
+                    files.set(relPath, content);
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+        }
+    }
+    for (const subdir of includeDirs) {
+        walkDir(path.join(dir, subdir), subdir);
+    }
+    return files;
+}
+/**
+ * Format files map for Claude context
+ */
+function formatFilesForContext(files, label) {
+    let output = `## ${label}\n\n`;
+    if (files.size === 0) {
+        output += '(No codev files found)\n';
+        return output;
+    }
+    for (const [filePath, content] of files) {
+        output += `### ${filePath}\n\n`;
+        output += '```markdown\n';
+        // Truncate very long files
+        if (content.length > 10000) {
+            output += content.substring(0, 10000);
+            output += '\n\n... (truncated, ' + content.length + ' chars total)\n';
+        }
+        else {
+            output += content;
+        }
+        output += '\n```\n\n';
+    }
+    return output;
+}
+/**
+ * Build the prompt for Claude
+ */
+function buildImportPrompt(sourceFiles, targetFiles, sourceLabel) {
+    return `You are helping import protocol improvements from another codev project.
+
+The user wants to import improvements from "${sourceLabel}" into their local codev installation.
+
+${formatFilesForContext(sourceFiles, 'SOURCE (from ' + sourceLabel + ')')}
+
+${formatFilesForContext(targetFiles, 'TARGET (local codev/)')}
+
+---
+
+## Your Task
+
+Analyze the differences between SOURCE and TARGET and help the user decide what to import.
+
+Focus on:
+1. **Protocol improvements**: New phases, better documentation, additional guidance
+2. **Lessons learned**: Wisdom from other projects' reviews
+3. **Architectural patterns**: Better ways to document or structure things
+4. **New protocols**: Protocols that exist in source but not target
+
+For each potential import, explain:
+- What it is and why it might be valuable
+- Any risks or considerations
+- Your recommendation (import, skip, or merge manually)
+
+Be interactive - discuss with the user and wait for their approval before making changes.
+
+When the user approves a change, make the edit to the appropriate file in codev/.
+
+Start by summarizing the key differences you found.`;
+}
+/**
+ * Main import entry point
+ */
+export async function importCommand(source, options = {}) {
+    const { dryRun = false } = options;
+    if (!source) {
+        throw new Error('Source required.\n\n' +
+            'Usage:\n' +
+            '  codev import /path/to/other-project\n' +
+            '  codev import github:owner/repo\n' +
+            '  codev import https://github.com/owner/repo');
+    }
+    const projectRoot = findProjectRoot();
+    const localCodevDir = path.join(projectRoot, 'codev');
+    if (!fs.existsSync(localCodevDir)) {
+        throw new Error('No codev/ directory found in current project.\n' +
+            'Run "codev init" or "codev adopt" first.');
+    }
+    console.log('');
+    console.log(chalk.bold('Codev Import'));
+    console.log(chalk.dim('AI-assisted protocol import from other projects'));
+    console.log('');
+    const parsed = parseSource(source);
+    let sourceCodevDir;
+    let tempDir = null;
+    let sourceLabel = source;
+    try {
+        if (parsed.type === 'github') {
+            // Create temp directory for GitHub clone
+            tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codev-import-'));
+            sourceCodevDir = await fetchFromGitHub(parsed.repo, tempDir);
+            sourceLabel = `github:${parsed.repo}`;
+            console.log(chalk.green('✓'), `Fetched ${parsed.repo}`);
+        }
+        else {
+            // Local path
+            sourceCodevDir = path.join(parsed.path, 'codev');
+            if (!fs.existsSync(sourceCodevDir)) {
+                // Maybe they specified the codev dir directly?
+                if (fs.existsSync(parsed.path) && fs.statSync(parsed.path).isDirectory()) {
+                    // Check if it looks like a codev directory
+                    if (fs.existsSync(path.join(parsed.path, 'protocols')) ||
+                        fs.existsSync(path.join(parsed.path, 'roles'))) {
+                        sourceCodevDir = parsed.path;
+                    }
+                    else {
+                        throw new Error(`No codev/ directory found at ${parsed.path}`);
+                    }
+                }
+                else {
+                    throw new Error(`Path not found: ${parsed.path}`);
+                }
+            }
+            sourceLabel = path.basename(path.dirname(sourceCodevDir)) || parsed.path;
+            console.log(chalk.green('✓'), `Found local source: ${sourceCodevDir}`);
+        }
+        // Read files from both directories
+        console.log(chalk.dim('Reading source files...'));
+        const sourceFiles = readCodevDirectory(sourceCodevDir);
+        console.log(chalk.dim(`  Found ${sourceFiles.size} files`));
+        console.log(chalk.dim('Reading target files...'));
+        const targetFiles = readCodevDirectory(localCodevDir);
+        console.log(chalk.dim(`  Found ${targetFiles.size} files`));
+        if (sourceFiles.size === 0) {
+            throw new Error('No codev files found in source');
+        }
+        // Build the prompt
+        const prompt = buildImportPrompt(sourceFiles, targetFiles, sourceLabel);
+        if (dryRun) {
+            console.log('');
+            console.log(chalk.yellow('Dry run - would spawn Claude with this context:'));
+            console.log('');
+            console.log(chalk.dim('Source files:'));
+            for (const file of sourceFiles.keys()) {
+                console.log(chalk.dim(`  - ${file}`));
+            }
+            console.log('');
+            console.log(chalk.dim('Target files:'));
+            for (const file of targetFiles.keys()) {
+                console.log(chalk.dim(`  - ${file}`));
+            }
+            console.log('');
+            console.log(chalk.dim('Prompt length:'), prompt.length, 'chars');
+            return;
+        }
+        // Check if claude is available
+        try {
+            execSync('which claude', { stdio: 'pipe' });
+        }
+        catch {
+            throw new Error('Claude CLI not found.\n' +
+                'Install with: npm install -g @anthropic-ai/claude-code');
+        }
+        console.log('');
+        console.log(chalk.bold('Starting interactive Claude session...'));
+        console.log(chalk.dim('Claude will analyze the differences and help you decide what to import.'));
+        console.log('');
+        // Spawn interactive Claude session
+        // We use -p to pass the initial prompt, but NOT --print so it stays interactive
+        const claudeProcess = spawn('claude', ['-p', prompt], {
+            stdio: 'inherit',
+            cwd: projectRoot, // Run from project root so Claude can make edits
+        });
+        await new Promise((resolve, reject) => {
+            claudeProcess.on('close', (code) => {
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Claude exited with code ${code}`));
+                }
+            });
+            claudeProcess.on('error', (error) => {
+                reject(error);
+            });
+        });
+        console.log('');
+        console.log(chalk.green('✓'), 'Import session complete');
+    }
+    finally {
+        // Clean up temp directory if we created one
+        if (tempDir && fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+    }
+}
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMrD;;GAEG;AACH,SAAS,WAAW,CAAC,MAAc;IACjC,uBAAuB;IACvB,sBAAsB;IACtB,kCAAkC;IAClC,kCAAkC;IAElC,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,8BAA8B;QAC9B,mFAAmF;QACnF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAChE,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe;IAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,IAAI,KAAK,CAAC,CAAC,CAAC;IAE3D,wCAAwC;IACxC,MAAM,QAAQ,GAAG,sBAAsB,IAAI,MAAM,CAAC;IAElD,IAAI,CAAC;QACH,QAAQ,CAAC,wBAAwB,QAAQ,MAAM,OAAO,GAAG,EAAE;YACzD,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,mCAAmC,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,uCAAuC;IACvC,MAAM,WAAW,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAExD,SAAS,OAAO,CAAC,WAAmB,EAAE,YAAoB;QACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO;QAExC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;YAE5E,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7B,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBACnD,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9B,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,KAA0B,EAAE,KAAa;IACtE,IAAI,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAE/B,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,0BAA0B,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;QACxC,MAAM,IAAI,OAAO,QAAQ,MAAM,CAAC;QAChC,MAAM,IAAI,eAAe,CAAC;QAC1B,2BAA2B;QAC3B,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,IAAI,sBAAsB,GAAG,OAAO,CAAC,MAAM,GAAG,iBAAiB,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,OAAO,CAAC;QACpB,CAAC;QACD,MAAM,IAAI,WAAW,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,WAAgC,EAChC,WAAgC,EAChC,WAAmB;IAEnB,OAAO;;8CAEqC,WAAW;;EAEvD,qBAAqB,CAAC,WAAW,EAAE,eAAe,GAAG,WAAW,GAAG,GAAG,CAAC;;EAEvE,qBAAqB,CAAC,WAAW,EAAE,uBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;oDAuBT,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,UAAyB,EAAE;IAC7E,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,sBAAsB;YACtB,UAAU;YACV,yCAAyC;YACzC,oCAAoC;YACpC,8CAA8C,CAC/C,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,iDAAiD;YACjD,0CAA0C,CAC3C,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,cAAsB,CAAC;IAC3B,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,WAAW,GAAG,MAAM,CAAC;IAEzB,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,yCAAyC;YACzC,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;YAClE,cAAc,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,IAAK,EAAE,OAAO,CAAC,CAAC;YAC9D,WAAW,GAAG,UAAU,MAAM,CAAC,IAAI,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,aAAa;YACb,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBACnC,+CAA+C;gBAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBACzE,2CAA2C;oBAC3C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;wBAClD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;wBACnD,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC;oBAC/B,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;oBACjE,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;YACD,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,uBAAuB,cAAc,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,mCAAmC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,WAAW,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;QAE5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,WAAW,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;QAE5D,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,mBAAmB;QACnB,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QAExE,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,iDAAiD,CAAC,CAAC,CAAC;YAC7E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;YACxC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;YACxC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC;YACH,QAAQ,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,yBAAyB;gBACzB,wDAAwD,CACzD,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,mCAAmC;QACnC,gFAAgF;QAChF,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;YACpD,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,WAAW,EAAE,iDAAiD;SACpE,CAAC,CAAC;QAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACjC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAE3D,CAAC;YAAS,CAAC;QACT,4CAA4C;QAC5C,IAAI,OAAO,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cluesmith/codev",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Codev CLI - AI-assisted software development framework",
   "type": "module",
   "bin": {
@@ -33,7 +33,7 @@
     "@types/node": "^22.10.1",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.6"
+    "vitest": "^4.0.15"
   },
   "engines": {
     "node": ">=18.0.0"

package/skeleton/DEPENDENCIES.md

@@ -141,6 +141,7 @@ You need at least one AI CLI installed to use Codev. Install more for multi-agen
 | Requirement | Value |
 |-------------|-------|
 | Purpose | Primary AI agent for development |
+| Required For | `codev import` command (spawns interactive Claude session) |
 | Documentation | [docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code) |
 
 **Installation:**

package/skeleton/docs/commands/overview.md

@@ -46,6 +46,7 @@ This installs all three commands globally: `codev`, `af`, and `consult`.
 | `codev doctor` | Check system dependencies |
 | `codev update` | Update codev templates and protocols |
 | `codev eject [path]` | Copy embedded files for customization |
+| `codev import <source>` | AI-assisted protocol import from other projects |
 | `codev tower` | Cross-project dashboard |
 
 See [codev.md](codev.md) for full documentation.

package/skeleton/maintain/.gitkeep

@@ -0,0 +1,2 @@
+# Maintenance run files go here
+# Files are numbered: 0001-maintenance.md, 0002-maintenance.md, etc.