spidersan 0.2.2

package/dist/commands/audit-mark.js

@@ -0,0 +1,204 @@
+/**
+ * spidersan audit-mark
+ *
+ * Tag branches as security-reviewed by Sherlocksan (or other auditors).
+ * Stores audit metadata in the branch description field as JSON prefix.
+ *
+ * Part of: Security Pipeline (ssan + srlk)
+ * See: treebird-internal/collab/DESIGN_security_pipeline_ssan_srlk.md
+ */
+import { Command } from 'commander';
+import { execSync } from 'child_process';
+import { getStorage } from '../storage/index.js';
+const AUDIT_MARK_PREFIX = '[AUDIT:';
+const AUDIT_MARK_SUFFIX = ']';
+function getCurrentBranch() {
+    try {
+        return execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        throw new Error('Not in a git repository');
+    }
+}
+function extractAuditMark(description) {
+    if (!description)
+        return null;
+    const start = description.indexOf(AUDIT_MARK_PREFIX);
+    if (start === -1)
+        return null;
+    const end = description.indexOf(AUDIT_MARK_SUFFIX, start);
+    if (end === -1)
+        return null;
+    try {
+        const json = description.substring(start + AUDIT_MARK_PREFIX.length, end);
+        return JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+}
+function injectAuditMark(description, mark) {
+    // Remove any existing audit mark
+    let cleanDescription = description || '';
+    const start = cleanDescription.indexOf(AUDIT_MARK_PREFIX);
+    if (start !== -1) {
+        const end = cleanDescription.indexOf(AUDIT_MARK_SUFFIX, start);
+        if (end !== -1) {
+            cleanDescription = (cleanDescription.substring(0, start) +
+                cleanDescription.substring(end + AUDIT_MARK_SUFFIX.length)).trim();
+        }
+    }
+    if (mark === null) {
+        return cleanDescription;
+    }
+    // Add new audit mark
+    const markStr = `${AUDIT_MARK_PREFIX}${JSON.stringify(mark)}${AUDIT_MARK_SUFFIX}`;
+    return cleanDescription ? `${markStr} ${cleanDescription}` : markStr;
+}
+export const auditMarkCommand = new Command('audit-mark')
+    .description('Tag a branch as security-reviewed (srlk integration)')
+    .argument('[branch]', 'Branch to mark (default: current branch)')
+    .option('--reviewer <agent>', 'Agent who performed the audit (default: srlk)', 'srlk')
+    .option('--passed', 'Mark as passed security review')
+    .option('--failed', 'Mark as failed security review')
+    .option('--verdict <verdict>', 'Audit verdict: safe, review, block', 'safe')
+    .option('--audit-id <id>', 'Reference to audit report ID')
+    .option('--notes <text>', 'Additional notes about the audit')
+    .option('--json', 'Output as JSON')
+    .option('--unmark', 'Remove audit mark from branch')
+    .option('--show', 'Show current audit mark without changing it')
+    .action(async (branchArg, options) => {
+    const storage = await getStorage();
+    if (!await storage.isInitialized()) {
+        console.error('❌ Spidersan not initialized. Run: spidersan init');
+        process.exit(1);
+    }
+    const branchName = branchArg || getCurrentBranch();
+    const branch = await storage.get(branchName);
+    if (!branch) {
+        console.error(`❌ Branch "${branchName}" is not registered.`);
+        console.error('   Run: spidersan register --files "..."');
+        process.exit(1);
+    }
+    const existingMark = extractAuditMark(branch.description);
+    // Handle --show
+    if (options.show) {
+        if (options.json) {
+            console.log(JSON.stringify({
+                branch: branchName,
+                auditMark: existingMark,
+            }, null, 2));
+        }
+        else if (existingMark) {
+            const verdictEmoji = { safe: '✅', review: '⚠️', block: '🚫' };
+            console.log('');
+            console.log('🕷️  Audit Mark Status');
+            console.log('');
+            console.log(`   📍 Branch: ${branchName}`);
+            console.log(`   ${verdictEmoji[existingMark.verdict]} Verdict: ${existingMark.verdict.toUpperCase()}`);
+            console.log(`   🔍 Reviewer: ${existingMark.reviewer}`);
+            console.log(`   ⏰ Timestamp: ${existingMark.timestamp}`);
+            if (existingMark.audit_id) {
+                console.log(`   📋 Audit ID: ${existingMark.audit_id}`);
+            }
+            if (existingMark.notes) {
+                console.log(`   📝 Notes: ${existingMark.notes}`);
+            }
+            console.log('');
+        }
+        else {
+            console.log(`⚠️  Branch "${branchName}" has no audit mark.`);
+        }
+        return;
+    }
+    // Handle unmark
+    if (options.unmark) {
+        if (existingMark) {
+            const newDescription = injectAuditMark(branch.description, null);
+            await storage.update(branchName, { description: newDescription || undefined });
+            if (options.json) {
+                console.log(JSON.stringify({ action: 'unmark', branch: branchName, success: true }));
+            }
+            else {
+                console.log(`🕷️ Removed audit mark from "${branchName}"`);
+            }
+        }
+        else {
+            if (options.json) {
+                console.log(JSON.stringify({ action: 'unmark', branch: branchName, success: false, reason: 'no mark found' }));
+            }
+            else {
+                console.log(`⚠️  Branch "${branchName}" has no audit mark to remove.`);
+            }
+        }
+        return;
+    }
+    // Determine pass/fail status
+    let passed = true;
+    if (options.failed) {
+        passed = false;
+    }
+    else if (options.passed) {
+        passed = true;
+    }
+    else if (options.verdict === 'block' || options.verdict === 'review') {
+        passed = false;
+    }
+    // Map verdict
+    let verdict = 'safe';
+    if (options.verdict && ['safe', 'review', 'block'].includes(options.verdict)) {
+        verdict = options.verdict;
+    }
+    else if (options.failed) {
+        verdict = 'block';
+    }
+    // Create audit mark
+    const auditMark = {
+        reviewer: options.reviewer,
+        passed,
+        verdict,
+        timestamp: new Date().toISOString(),
+    };
+    if (options.auditId) {
+        auditMark.audit_id = options.auditId;
+    }
+    if (options.notes) {
+        auditMark.notes = options.notes;
+    }
+    // Update branch description with audit mark
+    const newDescription = injectAuditMark(branch.description, auditMark);
+    await storage.update(branchName, { description: newDescription });
+    // Output
+    if (options.json) {
+        console.log(JSON.stringify({
+            action: 'mark',
+            branch: branchName,
+            auditMark,
+            success: true,
+        }, null, 2));
+        return;
+    }
+    // Human-readable output
+    console.log('');
+    console.log('🕷️  Spidersan Audit Mark');
+    console.log('');
+    const verdictEmoji = {
+        safe: '✅',
+        review: '⚠️',
+        block: '🚫',
+    };
+    console.log(`   📍 Branch: ${branchName}`);
+    console.log(`   ${verdictEmoji[verdict]} Verdict: ${verdict.toUpperCase()}`);
+    console.log(`   🔍 Reviewer: ${options.reviewer}`);
+    console.log(`   ⏰ Timestamp: ${auditMark.timestamp}`);
+    if (auditMark.audit_id) {
+        console.log(`   📋 Audit ID: ${auditMark.audit_id}`);
+    }
+    if (auditMark.notes) {
+        console.log(`   📝 Notes: ${auditMark.notes}`);
+    }
+    console.log('');
+    console.log(`   ${passed ? '✅ Branch marked as PASSED security review' : '❌ Branch marked as FAILED security review'}`);
+    console.log('');
+});
+//# sourceMappingURL=audit-mark.js.map

package/dist/commands/audit-mark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-mark.js","sourceRoot":"","sources":["../../src/commands/audit-mark.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAWjD,MAAM,iBAAiB,GAAG,SAAS,CAAC;AACpC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,SAAS,gBAAgB;IACrB,IAAI,CAAC;QACD,OAAO,QAAQ,CAAC,iCAAiC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAoB;IAC1C,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACrD,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAC1D,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5B,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,WAA+B,EAAE,IAAsB;IAC5E,iCAAiC;IACjC,IAAI,gBAAgB,GAAG,WAAW,IAAI,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAC/D,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACb,gBAAgB,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC;gBACpD,gBAAgB,CAAC,SAAS,CAAC,GAAG,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3E,CAAC;IACL,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,gBAAgB,CAAC;IAC5B,CAAC;IAED,qBAAqB;IACrB,MAAM,OAAO,GAAG,GAAG,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,iBAAiB,EAAE,CAAC;IAClF,OAAO,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;KACpD,WAAW,CAAC,sDAAsD,CAAC;KACnE,QAAQ,CAAC,UAAU,EAAE,0CAA0C,CAAC;KAChE,MAAM,CAAC,oBAAoB,EAAE,+CAA+C,EAAE,MAAM,CAAC;KACrF,MAAM,CAAC,UAAU,EAAE,gCAAgC,CAAC;KACpD,MAAM,CAAC,UAAU,EAAE,gCAAgC,CAAC;KACpD,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,EAAE,MAAM,CAAC;KAC3E,MAAM,CAAC,iBAAiB,EAAE,8BAA8B,CAAC;KACzD,MAAM,CAAC,gBAAgB,EAAE,kCAAkC,CAAC;KAC5D,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,UAAU,EAAE,+BAA+B,CAAC;KACnD,MAAM,CAAC,QAAQ,EAAE,6CAA6C,CAAC;KAC/D,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;IACjC,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IAEnC,IAAI,CAAC,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,IAAI,gBAAgB,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,aAAa,UAAU,sBAAsB,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAE1D,gBAAgB;IAChB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACvB,MAAM,EAAE,UAAU;gBAClB,SAAS,EAAE,YAAY;aAC1B,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,YAAY,EAAE,CAAC;YACtB,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACvG,OAAO,CAAC,GAAG,CAAC,mBAAmB,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,mBAAmB,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;YACzD,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,mBAAmB,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,gBAAgB,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,eAAe,UAAU,sBAAsB,CAAC,CAAC;QACjE,CAAC;QACD,OAAO;IACX,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,YAAY,EAAE,CAAC;YACf,MAAM,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACjE,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,cAAc,IAAI,SAAS,EAAE,CAAC,CAAC;YAE/E,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACzF,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,GAAG,CAAC,gCAAgC,UAAU,GAAG,CAAC,CAAC;YAC/D,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;YACnH,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,GAAG,CAAC,eAAe,UAAU,gCAAgC,CAAC,CAAC;YAC3E,CAAC;QACL,CAAC;QACD,OAAO;IACX,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,GAAG,KAAK,CAAC;IACnB,CAAC;SAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,GAAG,IAAI,CAAC;IAClB,CAAC;SAAM,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACrE,MAAM,GAAG,KAAK,CAAC;IACnB,CAAC;IAED,cAAc;IACd,IAAI,OAAO,GAAgC,MAAM,CAAC;IAClD,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3E,OAAO,GAAG,OAAO,CAAC,OAAsC,CAAC;IAC7D,CAAC;SAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,GAAG,OAAO,CAAC;IACtB,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAAc;QACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM;QACN,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;IAEF,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,SAAS,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACpC,CAAC;IAED,4CAA4C;IAC5C,MAAM,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACtE,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,CAAC;IAElE,SAAS;IACT,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;YACvB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,UAAU;YAClB,SAAS;YACT,OAAO,EAAE,IAAI;SAChB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACb,OAAO;IACX,CAAC;IAED,wBAAwB;IACxB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,YAAY,GAAG;QACjB,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;KACd,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,aAAa,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;IAEtD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC,2CAA2C,EAAE,CAAC,CAAC;IACxH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/commands/cleanup.d.ts

@@ -0,0 +1,8 @@
+/**
+ * spidersan cleanup
+ *
+ * Remove stale branches from the registry.
+ */
+import { Command } from 'commander';
+export declare const cleanupCommand: Command;
+//# sourceMappingURL=cleanup.d.ts.map

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

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

package/dist/commands/cleanup.js

@@ -0,0 +1,41 @@
+/**
+ * spidersan cleanup
+ *
+ * Remove stale branches from the registry.
+ */
+import { Command } from 'commander';
+import { getStorage } from '../storage/index.js';
+export const cleanupCommand = new Command('cleanup')
+    .description('Remove stale branches from registry')
+    .option('--days <n>', 'Days threshold', '7')
+    .option('--dry-run', 'Show what would be removed without removing')
+    .action(async (options) => {
+    const storage = await getStorage();
+    if (!await storage.isInitialized()) {
+        console.error('❌ Spidersan not initialized. Run: spidersan init');
+        process.exit(1);
+    }
+    const days = parseInt(options.days, 10);
+    const threshold = new Date();
+    threshold.setDate(threshold.getDate() - days);
+    const branches = await storage.list();
+    const stale = branches.filter(b => new Date(b.registeredAt) < threshold);
+    if (stale.length === 0) {
+        console.log(`🕷️ No stale branches to clean up.`);
+        return;
+    }
+    if (options.dryRun) {
+        console.log(`🕷️ Would remove ${stale.length} stale branch(es):\n`);
+        stale.forEach(b => console.log(`  - ${b.name}`));
+        return;
+    }
+    let removed = 0;
+    for (const branch of stale) {
+        if (await storage.unregister(branch.name)) {
+            removed++;
+            console.log(`  🗑️  Removed: ${branch.name}`);
+        }
+    }
+    console.log(`\n🕷️ Cleaned up ${removed} branch(es).`);
+});
+//# sourceMappingURL=cleanup.js.map

package/dist/commands/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/commands/cleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;KAC/C,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,CAAC;KAC3C,MAAM,CAAC,WAAW,EAAE,6CAA6C,CAAC;KAClE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACtB,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IAEnC,IAAI,CAAC,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7B,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,CAAC;IAEzE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,OAAO;IACX,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,CAAC,MAAM,sBAAsB,CAAC,CAAC;QACpE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACjD,OAAO;IACX,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,cAAc,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC"}

package/dist/commands/close.d.ts

@@ -0,0 +1,9 @@
+/**
+ * spidersan close
+ *
+ * End session cleanly.
+ * "Securing the Web" - the spider rests, but the web holds.
+ */
+import { Command } from 'commander';
+export declare const closeCommand: Command;
+//# sourceMappingURL=close.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"close.d.ts","sourceRoot":"","sources":["../../src/commands/close.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,eAAO,MAAM,YAAY,SAqHnB,CAAC"}

package/dist/commands/close.js

@@ -0,0 +1,129 @@
+/**
+ * spidersan close
+ *
+ * End session cleanly.
+ * "Securing the Web" - the spider rests, but the web holds.
+ */
+import { Command } from 'commander';
+import { execSync } from 'child_process';
+import { execa } from 'execa';
+import { getStorage } from '../storage/index.js';
+function getCurrentBranch() {
+    try {
+        return execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function hasMycmail() {
+    try {
+        execSync('which mycmail', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export const closeCommand = new Command('close')
+    .description('End session - secure the web, rest well')
+    .option('-m, --message <msg>', 'Custom sign-off message')
+    .option('--mark-stale', 'Mark your active branches as stale')
+    .option('--silent', 'Skip mycmail broadcast')
+    .option('--json', 'Output as JSON')
+    .option('-q, --quiet', 'Minimal output')
+    .action(async (options) => {
+    const storage = await getStorage();
+    const currentBranch = getCurrentBranch();
+    const result = {
+        currentBranch,
+        activeBranches: [],
+        markedStale: [],
+        conflictsResolved: 0,
+        mycmailCalled: false,
+    };
+    // Get active branches
+    if (await storage.isInitialized()) {
+        const branches = await storage.list();
+        result.activeBranches = branches
+            .filter(b => b.status === 'active')
+            .map(b => ({ name: b.name, agent: b.agent }));
+        // Mark branches as stale if requested
+        if (options.markStale) {
+            for (const branch of branches) {
+                if (branch.status === 'active') {
+                    await storage.update(branch.name, { status: 'abandoned' });
+                    result.markedStale.push(branch.name);
+                }
+            }
+        }
+    }
+    // Call mycmail close (with timeout protection!)
+    if (!options.silent && hasMycmail()) {
+        try {
+            const args = ['close', '--quiet'];
+            if (options.message) {
+                args.push('-m', options.message);
+            }
+            await execa('mycmail', args, {
+                timeout: 30000, // 30 second timeout - prevents hanging!
+                reject: false, // Don't throw on non-zero exit
+            });
+            result.mycmailCalled = true;
+        }
+        catch {
+            // Ignore mycmail errors - but we won't hang!
+        }
+    }
+    // JSON output
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    // Quiet output
+    if (options.quiet) {
+        const staleInfo = result.markedStale.length > 0 ? `, ${result.markedStale.length} secured` : '';
+        console.log(`🕷️ Close: ${result.activeBranches.length} threads${staleInfo}`);
+        return;
+    }
+    // ═══════════════════════════════════════════════════════════
+    // CEREMONIAL OUTPUT: "Securing the Web"
+    // ═══════════════════════════════════════════════════════════
+    console.log('');
+    console.log('🕷️  Spidersan Resting...');
+    console.log('');
+    console.log('   ╭─────────────────────────────────────╮');
+    console.log('   │  Securing anchor points...          │');
+    console.log('   ╰─────────────────────────────────────╯');
+    console.log('');
+    // Session summary
+    console.log('   📋 Session Summary:');
+    console.log(`      • ${result.activeBranches.length} thread${result.activeBranches.length !== 1 ? 's' : ''} in the web`);
+    if (result.markedStale.length > 0) {
+        console.log(`      • ${result.markedStale.length} thread${result.markedStale.length !== 1 ? 's' : ''} secured (marked stale)`);
+        for (const branch of result.markedStale.slice(0, 3)) {
+            console.log(`        └─ ${branch}`);
+        }
+        if (result.markedStale.length > 3) {
+            console.log(`        └─ ...and ${result.markedStale.length - 3} more`);
+        }
+    }
+    // Notify others
+    if (result.mycmailCalled) {
+        console.log('');
+        console.log('   🔔 Web Watchers Notified');
+        if (options.message) {
+            console.log(`      └─ "${options.message}"`);
+        }
+    }
+    // Closing ceremony
+    console.log('');
+    console.log('   💤 The web holds while you rest.');
+    console.log('      Next session: spidersan wake');
+    console.log('');
+    console.log('   ╭─────────────────────────────────────╮');
+    console.log('   │  Threads secured. Sweet dreams. 🌙  │');
+    console.log('   ╰─────────────────────────────────────╯');
+    console.log('');
+});
+//# sourceMappingURL=close.js.map

package/dist/commands/close.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close.js","sourceRoot":"","sources":["../../src/commands/close.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,SAAS,gBAAgB;IACrB,IAAI,CAAC;QACD,OAAO,QAAQ,CAAC,iCAAiC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,SAAS,UAAU;IACf,IAAI,CAAC;QACD,QAAQ,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC3C,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,qBAAqB,EAAE,yBAAyB,CAAC;KACxD,MAAM,CAAC,cAAc,EAAE,oCAAoC,CAAC;KAC5D,MAAM,CAAC,UAAU,EAAE,wBAAwB,CAAC;KAC5C,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;KACvC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACtB,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IAEzC,MAAM,MAAM,GAMR;QACA,aAAa;QACb,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;QACf,iBAAiB,EAAE,CAAC;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;IAEF,sBAAsB;IACtB,IAAI,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,CAAC,cAAc,GAAG,QAAQ;aAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAElD,sCAAsC;QACtC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACpB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC7B,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;oBAC3D,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACzC,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,gDAAgD;IAChD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAClC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;YACD,MAAM,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE;gBACzB,OAAO,EAAE,KAAK,EAAE,wCAAwC;gBACxD,MAAM,EAAE,KAAK,EAAG,+BAA+B;aAClD,CAAC,CAAC;YACH,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACL,6CAA6C;QACjD,CAAC;IACL,CAAC;IAED,cAAc;IACd,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACX,CAAC;IAED,eAAe;IACf,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,cAAc,CAAC,MAAM,WAAW,SAAS,EAAE,CAAC,CAAC;QAC9E,OAAO;IACX,CAAC;IAED,8DAA8D;IAC9D,wCAAwC;IACxC,8DAA8D;IAE9D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,kBAAkB;IAClB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,cAAc,CAAC,MAAM,UAAU,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAEzH,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,WAAW,CAAC,MAAM,UAAU,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;QAC/H,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3E,CAAC;IACL,CAAC;IAED,gBAAgB;IAChB,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;QACjD,CAAC;IACL,CAAC;IAED,mBAAmB;IACnB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/commands/collab-sync.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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';
+export declare const collabSyncCommand: Command;
+//# sourceMappingURL=collab-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collab-sync.d.ts","sourceRoot":"","sources":["../../src/commands/collab-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6EpC,eAAO,MAAM,iBAAiB,SA6LxB,CAAC"}