spidersan 0.2.2

package/dist/commands/collab-sync.js

@@ -0,0 +1,240 @@
+/**
+ * spidersan collab-sync
+ *
+ * Sync daily collab files with git to prevent merge conflicts.
+ * Designed for append-only collaboration documents.
+ *
+ * FlockView Integration:
+ *   - Use --json for API consumption
+ *   - Call --pre on collab open
+ *   - Call --post on collab save/close
+ */
+import { Command } from 'commander';
+import { execSync } from 'child_process';
+function runGit(cmd, silent = false) {
+    try {
+        return execSync(`git ${cmd}`, {
+            encoding: 'utf-8',
+            stdio: silent ? 'pipe' : 'inherit'
+        }).trim();
+    }
+    catch (error) {
+        if (error instanceof Error && 'stdout' in error) {
+            return error.stdout?.trim() || '';
+        }
+        throw error;
+    }
+}
+function runGitSilent(cmd) {
+    try {
+        const output = execSync(`git ${cmd}`, {
+            encoding: 'utf-8',
+            stdio: 'pipe'
+        }).trim();
+        return { success: true, output };
+    }
+    catch (error) {
+        const output = error instanceof Error && 'stdout' in error
+            ? error.stdout?.trim() || ''
+            : '';
+        return { success: false, output };
+    }
+}
+function hasUncommittedChanges() {
+    const status = runGit('status --porcelain', true);
+    return status.length > 0;
+}
+function hasConflicts() {
+    const status = runGit('status --porcelain', true);
+    return status.includes('UU ') || status.includes('AA ') || status.includes('DD ');
+}
+function getCurrentBranch() {
+    return runGit('rev-parse --abbrev-ref HEAD', true);
+}
+function getAgentFromEnv() {
+    return process.env.SPIDERSAN_AGENT ||
+        process.env.MYCELIUMAIL_AGENT_ID ||
+        'agent';
+}
+export const collabSyncCommand = new Command('collab-sync')
+    .description('Sync collab files with git (prevents merge conflicts)')
+    .option('--pre', 'Pre-edit: stash, pull, pop')
+    .option('--post', 'Post-edit: add, commit, push')
+    .option('--pattern <glob>', 'File pattern to sync', 'collab/*.md')
+    .option('--agent <name>', 'Agent name for commit message')
+    .option('--dry-run', 'Show what would happen without executing')
+    .option('--force', 'Skip confirmation prompts')
+    .option('--json', 'Output as JSON (for FlockView integration)')
+    .addHelpText('after', `
+Examples:
+  $ spidersan collab-sync --pre          # Before editing collab
+  $ spidersan collab-sync --post         # After editing collab
+  $ spidersan collab-sync --pre --post   # Full sync cycle
+  $ spidersan collab-sync --pre --json   # For FlockView API
+  
+Workflow:
+  1. spidersan collab-sync --pre    # Pull latest, handle stash
+  2. Edit collab/2026-01-16-daily.md
+  3. spidersan collab-sync --post   # Commit and push
+
+FlockView Integration:
+  - Call --pre --json when opening a collab
+  - Call --post --json when saving/closing
+`)
+    .action(async (options) => {
+    const pattern = options.pattern || 'collab/*.md';
+    const agent = options.agent || getAgentFromEnv();
+    const branch = getCurrentBranch();
+    const isJson = options.json;
+    const result = {
+        success: true,
+        action: 'none',
+        branch
+    };
+    if (!options.pre && !options.post) {
+        if (isJson) {
+            console.log(JSON.stringify({ success: false, error: 'Specify --pre or --post' }));
+        }
+        else {
+            console.log('🕷️ Specify --pre (before editing) or --post (after editing)');
+            console.log('   Run: spidersan collab-sync --help');
+        }
+        return;
+    }
+    if (!isJson) {
+        console.log(`\n🕷️ COLLAB SYNC — ${branch}\n`);
+    }
+    // PRE-EDIT: Pull latest changes
+    if (options.pre) {
+        result.action = 'pre';
+        if (!isJson)
+            console.log('📥 PRE-EDIT SYNC\n');
+        const dirty = hasUncommittedChanges();
+        result.stashed = false;
+        result.pulled = false;
+        result.popped = false;
+        // Step 1: Stash if dirty
+        if (dirty) {
+            if (!isJson)
+                console.log('  1. Stashing uncommitted changes...');
+            if (!options.dryRun) {
+                const stashResult = runGitSilent('stash push -m "spidersan-collab-sync"');
+                result.stashed = stashResult.success;
+            }
+            if (!isJson)
+                console.log('     ✅ Stashed');
+        }
+        else {
+            if (!isJson)
+                console.log('  1. Working tree clean, no stash needed');
+        }
+        // Step 2: Pull with rebase
+        if (!isJson)
+            console.log('  2. Pulling latest changes...');
+        if (!options.dryRun) {
+            const pullResult = runGitSilent('pull --rebase');
+            result.pulled = pullResult.success;
+            if (!isJson) {
+                console.log(pullResult.success ? '     ✅ Pulled' : '     ⚠️  Pull failed');
+            }
+        }
+        // Step 3: Pop stash if we stashed
+        if (dirty) {
+            if (!isJson)
+                console.log('  3. Restoring your changes...');
+            if (!options.dryRun) {
+                const popResult = runGitSilent('stash pop');
+                result.popped = popResult.success;
+                if (!isJson) {
+                    console.log(popResult.success ? '     ✅ Restored' : '     ⚠️  Stash pop failed');
+                }
+            }
+        }
+        // Step 4: Check for conflicts
+        if (!options.dryRun) {
+            result.conflicts = hasConflicts();
+            if (result.conflicts) {
+                result.success = false;
+                result.error = 'Conflicts detected';
+                if (!isJson) {
+                    console.log('\n  🔴 CONFLICTS DETECTED');
+                    console.log('     Resolve manually, then run: spidersan collab-sync --post');
+                }
+            }
+        }
+        if (!isJson && result.success) {
+            console.log('\n  ✅ Ready to edit collab files!\n');
+        }
+    }
+    // POST-EDIT: Commit and push
+    if (options.post) {
+        result.action = options.pre ? 'post' : 'post'; // If both, last action is post
+        if (!isJson)
+            console.log('📤 POST-EDIT SYNC\n');
+        result.staged = false;
+        result.committed = false;
+        result.pushed = false;
+        // Step 1: Check for changes
+        const status = runGit('status --porcelain', true);
+        const collabChanges = status.split('\n').filter(line => {
+            const file = line.substring(3);
+            const patternBase = pattern.replace('*.md', '');
+            return file.startsWith(patternBase) && file.endsWith('.md');
+        });
+        result.files = collabChanges.map(c => c.substring(3));
+        if (collabChanges.length === 0) {
+            if (!isJson)
+                console.log('  No collab changes to sync.');
+            if (isJson)
+                console.log(JSON.stringify(result));
+            return;
+        }
+        if (!isJson) {
+            console.log(`  1. Found ${collabChanges.length} changed collab file(s):`);
+            collabChanges.forEach(c => console.log(`     - ${c.substring(3)}`));
+        }
+        // Step 2: Add files
+        if (!isJson)
+            console.log(`  2. Staging ${pattern}...`);
+        if (!options.dryRun) {
+            const addResult = runGitSilent(`add ${pattern}`);
+            result.staged = addResult.success;
+            if (!isJson)
+                console.log(addResult.success ? '     ✅ Staged' : '     ⚠️  Stage failed');
+        }
+        // Step 3: Commit
+        const timestamp = new Date().toLocaleTimeString('en-GB', {
+            hour: '2-digit',
+            minute: '2-digit'
+        });
+        const commitMsg = `collab(${agent}): entry at ${timestamp}`;
+        if (!isJson)
+            console.log(`  3. Committing: "${commitMsg}"`);
+        if (!options.dryRun) {
+            const commitResult = runGitSilent(`commit -m "${commitMsg}"`);
+            result.committed = commitResult.success;
+            if (!isJson) {
+                console.log(commitResult.success ? '     ✅ Committed' : '     ⚠️  Nothing to commit');
+            }
+        }
+        // Step 4: Push
+        if (!isJson)
+            console.log('  4. Pushing to remote...');
+        if (!options.dryRun) {
+            const pushResult = runGitSilent('push');
+            result.pushed = pushResult.success;
+            if (!isJson) {
+                console.log(pushResult.success ? '     ✅ Pushed' : '     ⚠️  Push failed');
+            }
+        }
+        if (!isJson)
+            console.log('\n  ✅ Collab synced!\n');
+    }
+    if (options.dryRun && !isJson) {
+        console.log('🔍 DRY RUN — no changes made\n');
+    }
+    if (isJson) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+});
+//# sourceMappingURL=collab-sync.js.map

package/dist/commands/collab-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab-sync.js","sourceRoot":"","sources":["../../src/commands/collab-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA2BzC,SAAS,MAAM,CAAC,GAAW,EAAE,MAAM,GAAG,KAAK;IACvC,IAAI,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,GAAG,EAAE,EAAE;YAC1B,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SACrC,CAAC,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,IAAI,KAAK,YAAY,KAAK,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC9C,OAAQ,KAA4B,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC9D,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC7B,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,GAAG,EAAE,EAAE;YAClC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,MAAM;SAChB,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,IAAI,QAAQ,IAAI,KAAK;YACtD,CAAC,CAAE,KAA4B,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY;IACjB,MAAM,MAAM,GAAG,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,gBAAgB;IACrB,OAAO,MAAM,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,eAAe;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe;QAC9B,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAChC,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;KACtD,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,OAAO,EAAE,4BAA4B,CAAC;KAC7C,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;KAChD,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,aAAa,CAAC;KACjE,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;KACzD,MAAM,CAAC,WAAW,EAAE,0CAA0C,CAAC;KAC/D,MAAM,CAAC,SAAS,EAAE,2BAA2B,CAAC;KAC9C,MAAM,CAAC,QAAQ,EAAE,4CAA4C,CAAC;KAC9D,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;;;;CAezB,CAAC;KACG,MAAM,CAAC,KAAK,EAAE,OAAoB,EAAE,EAAE;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE5B,MAAM,MAAM,GAAe;QACvB,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,MAAM;QACd,MAAM;KACT,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,CAAC,CAAC;QACtF,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;YAC5E,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO;IACX,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QAEtB,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAE/C,MAAM,KAAK,GAAG,qBAAqB,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QACtB,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QAEtB,yBAAyB;QACzB,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YACjE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAClB,MAAM,WAAW,GAAG,YAAY,CAAC,uCAAuC,CAAC,CAAC;gBAC1E,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;YACzC,CAAC;YACD,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACzE,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,UAAU,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;YAC/E,CAAC;QACL,CAAC;QAED,kCAAkC;QAClC,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;YAC3D,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAClB,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;gBAC5C,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;gBAClC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACV,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;gBACrF,CAAC;YACL,CAAC;QACL,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;gBACvB,MAAM,CAAC,KAAK,GAAG,oBAAoB,CAAC;gBACpC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACV,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;oBACzC,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;gBACjF,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACvD,CAAC;IACL,CAAC;IAED,6BAA6B;IAC7B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,+BAA+B;QAE9E,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QACtB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;QACzB,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QAEtB,4BAA4B;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YACzD,IAAI,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YAChD,OAAO;QACX,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,cAAc,aAAa,CAAC,MAAM,0BAA0B,CAAC,CAAC;YAC1E,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxE,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;YAClC,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAC5F,CAAC;QAED,iBAAiB;QACjB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE;YACrD,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;SACpB,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,UAAU,KAAK,eAAe,SAAS,EAAE,CAAC;QAE5D,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,SAAS,GAAG,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,YAAY,GAAG,YAAY,CAAC,cAAc,SAAS,GAAG,CAAC,CAAC;YAC9D,MAAM,CAAC,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;YACxC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;YAC1F,CAAC;QACL,CAAC;QAED,eAAe;QACf,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;YAC/E,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/collab.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Collab Command - Join birdsan collaborative documents
+ */
+import { Command } from 'commander';
+export declare function registerCollabCommand(program: Command): void;
+//# sourceMappingURL=collab.d.ts.map

package/dist/commands/collab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab.d.ts","sourceRoot":"","sources":["../../src/commands/collab.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqCpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2E5D"}

package/dist/commands/collab.js

@@ -0,0 +1,103 @@
+/**
+ * Collab Command - Join birdsan collaborative documents
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+function addAgentSection(filepath, agentName, agentId, message) {
+    let content = fs.readFileSync(filepath, 'utf-8');
+    const now = new Date();
+    const timestamp = now.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit' });
+    const date = now.toLocaleDateString('en-US', { month: 'numeric', day: 'numeric', year: 'numeric' });
+    const placeholder = '### [Agent responses will appear here]';
+    const agentSection = `### ${agentName} (${agentId}) - ${date} ${timestamp}
+${message}
+
+---
+
+${placeholder}`;
+    if (content.includes(placeholder)) {
+        content = content.replace(placeholder, agentSection);
+    }
+    else {
+        content += `\n\n---\n\n### ${agentName} (${agentId}) - ${date} ${timestamp}\n${message}\n`;
+    }
+    const uncheckedPatterns = [
+        new RegExp(`- \\[ \\] \\*\\*${agentName}\\*\\* - Awaiting response`),
+        new RegExp(`- \\[ \\] \\*\\*${agentId}\\*\\* - Awaiting response`),
+    ];
+    for (const pattern of uncheckedPatterns) {
+        content = content.replace(pattern, `- [x] **${agentName}** - Joined`);
+    }
+    fs.writeFileSync(filepath, content);
+}
+export function registerCollabCommand(program) {
+    program
+        .command('collab')
+        .description('Join or manage collaborative documents')
+        .option('--join <filepath>', 'Join an existing collaboration document')
+        .option('-m, --message <message>', 'Custom message to add when joining')
+        .action(async (options) => {
+        const agentId = 'ssan';
+        const agentName = 'Spidersan';
+        if (options.join) {
+            const filepath = options.join;
+            if (!fs.existsSync(filepath)) {
+                console.error(`\n❌ Collab file not found: ${filepath}\n`);
+                process.exit(1);
+            }
+            console.log('\n🕷️  Joining Collaboration\n');
+            console.log('─'.repeat(40));
+            console.log(`File: ${path.basename(filepath)}`);
+            const defaultMessage = `🕷️ Spidersan joining the web!
+
+Feeling the threads from this discussion...
+
+**Branch/Registry perspective:**
+- Tracking collab participants like branch contributors
+- Can detect tensions/conflicts in the discussion
+- Monitoring for stale threads
+
+Ready to weave!`;
+            const message = options.message || defaultMessage;
+            try {
+                addAgentSection(filepath, agentName, agentId, message);
+                console.log(`\n✓ ${agentName} joined the collab!`);
+                console.log(`  Added response to: ${filepath}`);
+                try {
+                    const { spawnSync } = await import('child_process');
+                    // Security: Use spawnSync with argument array instead of string interpolation
+                    const safeFilename = path.basename(filepath).replace(/[^a-zA-Z0-9._-]/g, '_');
+                    spawnSync('mycmail', ['send', 'bsan', 'Joined collab', '--message', `Spidersan joined: ${safeFilename}`, '-p'], {
+                        stdio: 'ignore'
+                    });
+                    console.log('✓ Notified birdsan');
+                }
+                catch {
+                    // Ignore
+                }
+            }
+            catch (error) {
+                console.error(`\n❌ Failed to join: ${error.message}\n`);
+                process.exit(1);
+            }
+            console.log('\n' + '─'.repeat(40) + '\n');
+        }
+        else {
+            console.log('\n🕷️  Spidersan Collab\n');
+            console.log('─'.repeat(40));
+            console.log(`
+Usage:
+  spidersan collab --join <filepath>  Join a collaboration
+  
+Options:
+  --join <filepath>    Path to the collab document
+  -m, --message <msg>  Custom message to add
+
+Examples:
+  spidersan collab --join ~/Dev/treebird-internal/collab/COLLAB_topic.md
+`);
+            console.log('─'.repeat(40) + '\n');
+        }
+    });
+}
+//# sourceMappingURL=collab.js.map

package/dist/commands/collab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab.js","sourceRoot":"","sources":["../../src/commands/collab.ts"],"names":[],"mappings":"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"}

package/dist/commands/completions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * spidersan completions
+ *
+ * Generate shell completions for bash, zsh, and fish.
+ */
+import { Command } from 'commander';
+export declare const completionsCommand: Command;
+//# sourceMappingURL=completions.d.ts.map

package/dist/commands/completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../../src/commands/completions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8DpC,eAAO,MAAM,kBAAkB,SAmBzB,CAAC"}

package/dist/commands/completions.js

@@ -0,0 +1,83 @@
+/**
+ * spidersan completions
+ *
+ * Generate shell completions for bash, zsh, and fish.
+ */
+import { Command } from 'commander';
+const COMMANDS = [
+    'init', 'register', 'list', 'conflicts', 'merge-order', 'ready-check',
+    'depends', 'stale', 'cleanup', 'abandon', 'merged', 'sync',
+    'send', 'inbox', 'msg-read',
+    'keygen', 'key-import', 'keys',
+    'activate', 'status',
+    'wake', 'close', 'collab',
+    'doctor', 'completions'
+];
+function generateBash() {
+    return `# Spidersan bash completions
+# Add to ~/.bashrc: eval "$(spidersan completions bash)"
+
+_spidersan_completions() {
+    local cur="\${COMP_WORDS[COMP_CWORD]}"
+    local commands="${COMMANDS.join(' ')}"
+    
+    if [[ \${COMP_CWORD} -eq 1 ]]; then
+        COMPREPLY=($(compgen -W "\${commands}" -- "\${cur}"))
+    fi
+}
+
+complete -F _spidersan_completions spidersan
+`;
+}
+function generateZsh() {
+    return `# Spidersan zsh completions
+# Add to ~/.zshrc: eval "$(spidersan completions zsh)"
+
+_spidersan() {
+    local -a commands
+    commands=(
+${COMMANDS.map(c => `        '${c}:${c} command'`).join('\n')}
+    )
+    
+    _arguments -C \\
+        '1: :->command' \\
+        '*::arg:->args'
+    
+    case "$state" in
+        command)
+            _describe 'command' commands
+            ;;
+    esac
+}
+
+compdef _spidersan spidersan
+`;
+}
+function generateFish() {
+    return `# Spidersan fish completions
+# Save to ~/.config/fish/completions/spidersan.fish
+
+${COMMANDS.map(c => `complete -c spidersan -f -n "__fish_use_subcommand" -a "${c}" -d "${c} command"`).join('\n')}
+`;
+}
+export const completionsCommand = new Command('completions')
+    .description('Generate shell completions')
+    .argument('<shell>', 'Shell type: bash, zsh, or fish')
+    .action((shell) => {
+    switch (shell.toLowerCase()) {
+        case 'bash':
+            console.log(generateBash());
+            break;
+        case 'zsh':
+            console.log(generateZsh());
+            break;
+        case 'fish':
+            console.log(generateFish());
+            break;
+        default:
+            console.error(`❌ Unknown shell: ${shell}`);
+            console.error('   Supported: bash, zsh, fish');
+            process.exit(1);
+    }
+});
+//# sourceMappingURL=completions.js.map

package/dist/commands/completions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.js","sourceRoot":"","sources":["../../src/commands/completions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,QAAQ,GAAG;IACb,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa;IACrE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM;IAC1D,MAAM,EAAE,OAAO,EAAE,UAAU;IAC3B,QAAQ,EAAE,YAAY,EAAE,MAAM;IAC9B,UAAU,EAAE,QAAQ;IACpB,MAAM,EAAE,OAAO,EAAE,QAAQ;IACzB,QAAQ,EAAE,aAAa;CAC1B,CAAC;AAEF,SAAS,YAAY;IACjB,OAAO;;;;;sBAKW,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;;;;;;;;CAQvC,CAAC;AACF,CAAC;AAED,SAAS,WAAW;IAChB,OAAO;;;;;;EAMT,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;CAe5D,CAAC;AACF,CAAC;AAED,SAAS,YAAY;IACjB,OAAO;;;EAGT,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,2DAA2D,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;CAChH,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;KACvD,WAAW,CAAC,4BAA4B,CAAC;KACzC,QAAQ,CAAC,SAAS,EAAE,gCAAgC,CAAC;KACrD,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;IACtB,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1B,KAAK,MAAM;YACP,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;YAC5B,MAAM;QACV,KAAK,KAAK;YACN,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAC3B,MAAM;QACV,KAAK,MAAM;YACP,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;YAC5B,MAAM;QACV;YACI,OAAO,CAAC,KAAK,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/conflicts.d.ts

@@ -0,0 +1,12 @@
+/**
+ * spidersan conflicts
+ *
+ * Detect file conflicts between branches.
+ * Supports tiered conflict blocking:
+ *   TIER 1: Warning only (informational)
+ *   TIER 2: Pause (notify agent, recommend action)
+ *   TIER 3: Block (exit with error, prevent merge)
+ */
+import { Command } from 'commander';
+export declare const conflictsCommand: Command;
+//# sourceMappingURL=conflicts.d.ts.map

package/dist/commands/conflicts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../../src/commands/conflicts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsOpC,eAAO,MAAM,gBAAgB,SAmPvB,CAAC"}