@planu/cli 0.78.0 → 0.79.1

package/dist/tools/capture-idea-handler.js

@@ -0,0 +1,39 @@
+import { loadIdeas, saveIdea } from '../storage/ideas-store.js';
+const EXPIRY_DAYS = 90;
+/** Generate a unique idea ID based on date and sequence number. */
+async function generateIdeaId(projectPath) {
+    const ideas = await loadIdeas(projectPath);
+    const today = new Date();
+    const dateStr = today.toISOString().slice(0, 10).replace(/-/g, '');
+    const todayPrefix = `idea-${dateStr}-`;
+    const todayCount = ideas.filter((i) => i.id.startsWith(todayPrefix)).length;
+    const seq = String(todayCount + 1).padStart(3, '0');
+    return `${todayPrefix}${seq}`;
+}
+/** Calculate expiry date 90 days from now. */
+function calculateExpiry() {
+    const expiry = new Date();
+    expiry.setDate(expiry.getDate() + EXPIRY_DAYS);
+    return expiry.toISOString();
+}
+/** Handle capture_idea tool call. */
+export async function handleCaptureIdea(input) {
+    const { projectPath, title, description, tags = [] } = input;
+    const id = await generateIdeaId(projectPath);
+    const now = new Date().toISOString();
+    const idea = {
+        id,
+        title,
+        description,
+        tags,
+        capturedAt: now,
+        capturedFrom: 'tool',
+        status: 'new',
+        expiresAt: calculateExpiry(),
+    };
+    await saveIdea(projectPath, idea);
+    return {
+        content: [{ type: 'text', text: `Idea guardada: [${id}] ${title}` }],
+    };
+}
+//# sourceMappingURL=capture-idea-handler.js.map

package/dist/tools/capture-idea-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-idea-handler.js","sourceRoot":"","sources":["../../src/tools/capture-idea-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,mEAAmE;AACnE,KAAK,UAAU,cAAc,CAAC,WAAmB;IAC/C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,QAAQ,OAAO,GAAG,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5E,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,WAAW,GAAG,GAAG,EAAE,CAAC;AAChC,CAAC;AAED,8CAA8C;AAC9C,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAC1B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;AAC9B,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAuB;IAC7D,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC;IAE7D,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,IAAI,GAAa;QACrB,EAAE;QACF,KAAK;QACL,WAAW;QACX,IAAI;QACJ,UAAU,EAAE,GAAG;QACf,YAAY,EAAE,MAAM;QACpB,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,eAAe,EAAE;KAC7B,CAAC;IAEF,MAAM,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAElC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,KAAK,EAAE,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/tools/ci-planu-handler.d.ts

@@ -1,8 +1,8 @@
 import type { GeneratePlanuCIInput, ToolResult } from '../types/index.js';
 /**
  * Handle the generate_planu_ci tool.
- * Generates a GitHub Actions workflow YAML for Planu spec validation in CI,
- * including drift detection, PR comments, badge, and .planu.yml config.
+ * Always generates a local planu-check.sh script (no GitHub billing required).
+ * Optionally generates a GitHub Actions workflow YAML for cloud CI.
  */
 export declare function handleGeneratePlanuCI(args: GeneratePlanuCIInput): ToolResult;
 //# sourceMappingURL=ci-planu-handler.d.ts.map

package/dist/tools/ci-planu-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ci-planu-handler.d.ts","sourceRoot":"","sources":["../../src/tools/ci-planu-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG1E;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,UAAU,CA0C5E"}
+{"version":3,"file":"ci-planu-handler.d.ts","sourceRoot":"","sources":["../../src/tools/ci-planu-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG1E;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,UAAU,CAqF5E"}

package/dist/tools/ci-planu-handler.js

@@ -1,42 +1,75 @@
-// tools/ci-planu-handler.ts — Handle generate_planu_ci tool calls (SPEC-066 AC-02..07)
+// tools/ci-planu-handler.ts — Handle generate_planu_ci tool calls (SPEC-066 AC-02..07, SPEC-201)
 import { generatePlanuCI } from '../engine/ci-generator/planu-steps.js';
 /**
  * Handle the generate_planu_ci tool.
- * Generates a GitHub Actions workflow YAML for Planu spec validation in CI,
- * including drift detection, PR comments, badge, and .planu.yml config.
+ * Always generates a local planu-check.sh script (no GitHub billing required).
+ * Optionally generates a GitHub Actions workflow YAML for cloud CI.
  */
 export function handleGeneratePlanuCI(args) {
+    const includeGithubActions = args.includeGithubActions ?? true;
     const result = generatePlanuCI(args);
     const lines = [
         '## Planu CI Workflow Generated',
         '',
         `**Features enabled**: ${result.features.join(', ')}`,
-        `**Workflow path**: \`${result.workflowPath}\``,
         '',
-        '### Generated Workflow YAML',
+        '---',
         '',
-        '```yaml',
-        result.workflowYaml.trimEnd(),
+        '### Option 1 — Local script (no GitHub billing required)',
+        '',
+        'Save `planu-check.sh` to your project root and run it directly:',
+        '',
+        '```bash',
+        'chmod +x planu-check.sh',
+        './planu-check.sh',
+        '```',
+        '',
+        '```bash',
+        result.localScript.trimEnd(),
+        '```',
+        '',
+        '**Optional: run as git pre-push hook** (catches issues before pushing):',
+        '',
+        '```bash',
+        'ln -s ../../planu-check.sh .git/hooks/pre-push',
+        '```',
+        '',
+        '---',
+        '',
+        '### Option 2 — Run GitHub Actions locally with act (no billing)',
+        '',
+        '[act](https://github.com/nektos/act) runs GitHub Actions workflows on your machine.',
+        'The generated workflow is fully compatible with act:',
+        '',
+        '```bash',
+        '# Install act (macOS)',
+        'brew install act',
+        '',
+        '# Run the Planu check locally',
+        'act -j planu-check',
         '```',
         '',
     ];
+    if (includeGithubActions && result.workflowYaml) {
+        lines.push('---', '', `### Option 3 — GitHub Actions (requires billing for private repos)`, '', `**Workflow path**: \`${result.workflowPath}\``, '', '```yaml', result.workflowYaml.trimEnd(), '```', '');
+    }
     // .planu.yml config
-    lines.push('### Generated .planu.yml Configuration');
-    lines.push('');
-    lines.push('```yaml');
+    lines.push('---', '', '### Generated .planu.yml Configuration', '', '```yaml');
     lines.push(result.planuConfigYaml.trimEnd());
-    lines.push('```');
-    lines.push('');
-    // Badge
-    lines.push('### Badge for README');
-    lines.push('');
-    lines.push('Add this to your README.md (replace `{owner}` and `{repo}` with your values):');
-    lines.push('');
-    lines.push('```markdown');
-    lines.push(result.badgeMarkdown);
-    lines.push('```');
-    lines.push('');
-    lines.push(`> Save the workflow to \`${result.workflowPath}\` and the config to \`.planu.yml\` in your project root.`);
+    lines.push('```', '');
+    // Badge (only if GitHub Actions enabled)
+    if (includeGithubActions && result.badgeMarkdown) {
+        lines.push('### Badge for README', '');
+        lines.push('Add this to your README.md (replace `{owner}` and `{repo}` with your values):');
+        lines.push('', '```markdown');
+        lines.push(result.badgeMarkdown);
+        lines.push('```', '');
+    }
+    lines.push(`> **Save**: \`${result.localScriptPath}\` (local script, always)`);
+    if (includeGithubActions && result.workflowPath) {
+        lines.push(`> **Save**: \`${result.workflowPath}\` (GitHub Actions, optional)`);
+    }
+    lines.push('> **Save**: `.planu.yml` (shared config for both modes)');
     return {
         content: [{ type: 'text', text: lines.join('\n') }],
     };

package/dist/tools/ci-planu-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"ci-planu-handler.js","sourceRoot":"","sources":["../../src/tools/ci-planu-handler.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAGvF,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA0B;IAC9D,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAErC,MAAM,KAAK,GAAa;QACtB,gCAAgC;QAChC,EAAE;QACF,yBAAyB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACrD,wBAAwB,MAAM,CAAC,YAAY,IAAI;QAC/C,EAAE;QACF,6BAA6B;QAC7B,EAAE;QACF,SAAS;QACT,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC7B,KAAK;QACL,EAAE;KACH,CAAC;IAEF,oBAAoB;IACpB,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,QAAQ;IACR,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CACR,4BAA4B,MAAM,CAAC,YAAY,2DAA2D,CAC3G,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ci-planu-handler.js","sourceRoot":"","sources":["../../src/tools/ci-planu-handler.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAGjG,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA0B;IAC9D,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC;IAC/D,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAErC,MAAM,KAAK,GAAa;QACtB,gCAAgC;QAChC,EAAE;QACF,yBAAyB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACrD,EAAE;QACF,KAAK;QACL,EAAE;QACF,0DAA0D;QAC1D,EAAE;QACF,iEAAiE;QACjE,EAAE;QACF,SAAS;QACT,yBAAyB;QACzB,kBAAkB;QAClB,KAAK;QACL,EAAE;QACF,SAAS;QACT,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE;QAC5B,KAAK;QACL,EAAE;QACF,yEAAyE;QACzE,EAAE;QACF,SAAS;QACT,gDAAgD;QAChD,KAAK;QACL,EAAE;QACF,KAAK;QACL,EAAE;QACF,iEAAiE;QACjE,EAAE;QACF,qFAAqF;QACrF,sDAAsD;QACtD,EAAE;QACF,SAAS;QACT,uBAAuB;QACvB,kBAAkB;QAClB,EAAE;QACF,+BAA+B;QAC/B,oBAAoB;QACpB,KAAK;QACL,EAAE;KACH,CAAC;IAEF,IAAI,oBAAoB,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CACR,KAAK,EACL,EAAE,EACF,oEAAoE,EACpE,EAAE,EACF,wBAAwB,MAAM,CAAC,YAAY,IAAI,EAC/C,EAAE,EACF,SAAS,EACT,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,EAC7B,KAAK,EACL,EAAE,CACH,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,wCAAwC,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEtB,yCAAyC;IACzC,IAAI,oBAAoB,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;QAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,eAAe,2BAA2B,CAAC,CAAC;IAC/E,IAAI,oBAAoB,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,YAAY,+BAA+B,CAAC,CAAC;IAClF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAEtE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/tools/discard-idea-handler.d.ts

@@ -0,0 +1,4 @@
+import type { ToolResult, DiscardIdeaInput } from '../types/index.js';
+/** Handle discard_idea tool call. Idempotent if already discarded. */
+export declare function handleDiscardIdea(input: DiscardIdeaInput): Promise<ToolResult>;
+//# sourceMappingURL=discard-idea-handler.d.ts.map

package/dist/tools/discard-idea-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discard-idea-handler.d.ts","sourceRoot":"","sources":["../../src/tools/discard-idea-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGtE,sEAAsE;AACtE,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BpF"}

package/dist/tools/discard-idea-handler.js

@@ -0,0 +1,27 @@
+import { loadIdeas, updateIdea } from '../storage/ideas-store.js';
+/** Handle discard_idea tool call. Idempotent if already discarded. */
+export async function handleDiscardIdea(input) {
+    const { projectPath, ideaId, reason } = input;
+    const ideas = await loadIdeas(projectPath);
+    const idea = ideas.find((i) => i.id === ideaId);
+    if (!idea) {
+        return {
+            content: [{ type: 'text', text: `Idea not found: ${ideaId}` }],
+            isError: true,
+        };
+    }
+    // Idempotent: already discarded
+    if (idea.status === 'discarded') {
+        return {
+            content: [{ type: 'text', text: `Idea "${idea.title}" was already discarded.` }],
+        };
+    }
+    await updateIdea(projectPath, ideaId, {
+        status: 'discarded',
+        discardedReason: reason,
+    });
+    return {
+        content: [{ type: 'text', text: `Idea "${idea.title}" discarded. Reason: ${reason}` }],
+    };
+}
+//# sourceMappingURL=discard-idea-handler.js.map

package/dist/tools/discard-idea-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discard-idea-handler.js","sourceRoot":"","sources":["../../src/tools/discard-idea-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAElE,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAuB;IAC7D,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE9C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAEhD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;YAC9D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,CAAC,KAAK,0BAA0B,EAAE,CAAC;SACjF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE;QACpC,MAAM,EAAE,WAAW;QACnB,eAAe,EAAE,MAAM;KACxB,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,CAAC,KAAK,wBAAwB,MAAM,EAAE,EAAE,CAAC;KACvF,CAAC;AACJ,CAAC"}

package/dist/tools/git/cleanup-ops.d.ts

@@ -0,0 +1,15 @@
+import type { ToolResult, GitConfig, SpecDoneCleanupResult } from '../../types/index.js';
+/**
+ * AC-02: Eliminate gone branches + remote prune.
+ * AC-03: List stale stashes (>7d); drop if force=true.
+ * AC-05: Idempotent.
+ * AC-06: Never deletes active branch or current HEAD.
+ * AC-07: Returns detailed report.
+ */
+export declare function handleCleanup(projectId: string, config?: GitConfig): Promise<ToolResult>;
+/**
+ * AC-01: When a spec is marked done, clean its worktree, local branch, and remote branch.
+ * Best-effort — never throws. Caller should fire-and-forget or log result.
+ */
+export declare function cleanupSpecOnDone(projectPath: string, specId: string, gitBranch: string | undefined): Promise<SpecDoneCleanupResult>;
+//# sourceMappingURL=cleanup-ops.d.ts.map

package/dist/tools/git/cleanup-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-ops.d.ts","sourceRoot":"","sources":["../../../src/tools/git/cleanup-ops.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EAGV,SAAS,EACT,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAgR9B;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA8E9F;AAsBD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAqFhC"}

package/dist/tools/git/cleanup-ops.js

@@ -0,0 +1,417 @@
+// tools/git/cleanup-ops.ts — Git cleanup: worktrees, branches, remote prune, stashes (SPEC-203)
+import { existsSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { git, resolveProjectPath } from './git-helpers.js';
+const WORKTREES_DIR = '.claude/worktrees';
+const STALE_DAYS_THRESHOLD = 7;
+const MILLISECONDS_PER_DAY = 86_400_000;
+// ---------------------------------------------------------------------------
+// Worktree helpers
+// ---------------------------------------------------------------------------
+/** Parse `git worktree list --porcelain` output into {path, branch} records. */
+function parseWorktreeList(output) {
+    const entries = [];
+    let current = {};
+    for (const line of output.split('\n')) {
+        if (line.startsWith('worktree ')) {
+            current = { path: line.slice('worktree '.length).trim() };
+        }
+        else if (line.startsWith('branch ')) {
+            current.branch = line.slice('branch '.length).trim().replace('refs/heads/', '');
+        }
+        else if (line === '' && current.path) {
+            if (current.branch) {
+                entries.push({ path: current.path, branch: current.branch });
+            }
+            current = {};
+        }
+    }
+    return entries;
+}
+/** Returns the set of branches already merged into develop (or main as fallback). */
+async function getMergedBranches(projectPath) {
+    const bases = ['develop', 'main', 'master'];
+    for (const base of bases) {
+        try {
+            const { stdout } = await git(projectPath, ['branch', '--merged', base]);
+            return new Set(stdout
+                .split('\n')
+                .map((b) => b.replace(/^\*?\s+/, '').trim())
+                .filter(Boolean));
+        }
+        catch {
+            // try next base
+        }
+    }
+    return new Set();
+}
+/** Remove a worktree — idempotent (ignores "not a worktree" errors). */
+async function removeWorktree(projectPath, worktreePath) {
+    try {
+        await git(projectPath, ['worktree', 'remove', '--force', worktreePath]);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        // Already gone — not an error
+        if (!msg.includes('not a working tree') && !msg.includes('does not exist')) {
+            throw err;
+        }
+    }
+}
+async function cleanupOrphanWorktrees(projectPath, mergedBranches) {
+    const removed = [];
+    const errors = [];
+    let worktreeOutput;
+    try {
+        const { stdout } = await git(projectPath, ['worktree', 'list', '--porcelain']);
+        worktreeOutput = stdout;
+    }
+    catch {
+        return { removed, errors };
+    }
+    const worktrees = parseWorktreeList(worktreeOutput);
+    const worktreesSubdir = join(projectPath, WORKTREES_DIR);
+    for (const wt of worktrees) {
+        // Never touch the main worktree (same path as projectPath)
+        if (wt.path === projectPath) {
+            continue;
+        }
+        const isInWorktreesDir = wt.path.startsWith(worktreesSubdir);
+        const isMergedBranch = wt.branch && mergedBranches.has(wt.branch);
+        if (isInWorktreesDir || isMergedBranch) {
+            // Never remove if it's the current HEAD
+            try {
+                const { stdout: headBranch } = await git(projectPath, [
+                    'rev-parse',
+                    '--abbrev-ref',
+                    'HEAD',
+                ]);
+                if (headBranch.trim() === wt.branch) {
+                    continue;
+                }
+            }
+            catch {
+                // Skip safety check failure — do not remove
+                continue;
+            }
+            try {
+                await removeWorktree(projectPath, wt.path);
+                removed.push(wt.path);
+            }
+            catch (err) {
+                errors.push(`worktree ${wt.path}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    // Also prune stale worktree admin dirs (git worktree prune)
+    try {
+        await git(projectPath, ['worktree', 'prune']);
+    }
+    catch {
+        // best-effort
+    }
+    return { removed, errors };
+}
+// ---------------------------------------------------------------------------
+// Branch helpers
+// ---------------------------------------------------------------------------
+async function cleanupGoneBranches(projectPath) {
+    const removed = [];
+    const errors = [];
+    let vvOutput;
+    try {
+        const { stdout } = await git(projectPath, ['branch', '-vv']);
+        vvOutput = stdout;
+    }
+    catch {
+        return { removed, errors };
+    }
+    // Lines containing ": gone]" mean upstream was deleted (git branch -vv format: [origin/...: gone])
+    const goneBranches = vvOutput
+        .split('\n')
+        .filter((line) => line.includes(': gone]'))
+        .map((line) => line
+        .replace(/^\*?\s+/, '')
+        .split(/\s+/)[0]
+        ?.trim() ?? '')
+        .filter(Boolean);
+    // Resolve current branch only when needed to avoid an extra git call (AC-05)
+    let currentBranch = '';
+    if (goneBranches.length > 0) {
+        try {
+            const { stdout } = await git(projectPath, ['rev-parse', '--abbrev-ref', 'HEAD']);
+            currentBranch = stdout.trim();
+        }
+        catch {
+            // ignore
+        }
+    }
+    for (const branch of goneBranches) {
+        if (branch === currentBranch) {
+            continue;
+        }
+        try {
+            await git(projectPath, ['branch', '-d', branch]);
+            removed.push(branch);
+        }
+        catch {
+            // Force-delete if branch is not fully merged (upstream gone = safe)
+            try {
+                await git(projectPath, ['branch', '-D', branch]);
+                removed.push(branch);
+            }
+            catch (err) {
+                errors.push(`branch ${branch}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    return { removed, errors };
+}
+// ---------------------------------------------------------------------------
+// Stash helpers
+// ---------------------------------------------------------------------------
+function parseDaysOld(stashMessage) {
+    // git stash list format: stash@{0}: WIP on branch: hash message
+    // We detect age from the stash index timestamp via git log on the stash ref
+    // Since we can't get date from the message directly, we return 0 here
+    // and use git log to get the actual date per stash ref in detectStaleStashes.
+    void stashMessage;
+    return 0;
+}
+async function detectStaleStashes(projectPath) {
+    const stale = [];
+    let listOutput;
+    try {
+        const { stdout } = await git(projectPath, ['stash', 'list']);
+        listOutput = stdout;
+    }
+    catch {
+        return stale;
+    }
+    const lines = listOutput.split('\n').filter(Boolean);
+    const now = Date.now();
+    for (const line of lines) {
+        const match = /^(stash@\{(\d+)\}):\s+(.+)$/.exec(line);
+        if (!match) {
+            continue;
+        }
+        const [, ref, indexStr, message] = match;
+        if (!ref || !indexStr || !message) {
+            continue;
+        }
+        const index = parseInt(indexStr, 10);
+        // Get commit date for this stash ref
+        let daysOld = parseDaysOld(message);
+        try {
+            const { stdout: dateOut } = await git(projectPath, ['log', '-1', '--format=%ct', ref]);
+            const epochSeconds = parseInt(dateOut.trim(), 10);
+            if (!isNaN(epochSeconds)) {
+                daysOld = Math.floor((now - epochSeconds * 1000) / MILLISECONDS_PER_DAY);
+            }
+        }
+        catch {
+            // Can't determine age — skip this stash
+            continue;
+        }
+        if (daysOld >= STALE_DAYS_THRESHOLD) {
+            stale.push({ index, ref, message, daysOld });
+        }
+    }
+    return stale;
+}
+async function dropStaleStashes(projectPath, stale) {
+    const errors = [];
+    // Drop in reverse index order so indices stay valid
+    const sorted = [...stale].sort((a, b) => b.index - a.index);
+    let dropped = 0;
+    for (const stash of sorted) {
+        try {
+            await git(projectPath, ['stash', 'drop', stash.ref]);
+            dropped++;
+        }
+        catch (err) {
+            errors.push(`stash ${stash.ref}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return { dropped, errors };
+}
+// ---------------------------------------------------------------------------
+// Public handler
+// ---------------------------------------------------------------------------
+/**
+ * AC-02: Eliminate gone branches + remote prune.
+ * AC-03: List stale stashes (>7d); drop if force=true.
+ * AC-05: Idempotent.
+ * AC-06: Never deletes active branch or current HEAD.
+ * AC-07: Returns detailed report.
+ */
+export async function handleCleanup(projectId, config) {
+    const force = config?.force ?? false;
+    const errors = [];
+    let projectPath;
+    try {
+        projectPath = await resolveProjectPath(projectId);
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: err instanceof Error ? err.message : String(err) }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // 1. Remote prune
+    let remotePruned = false;
+    try {
+        await git(projectPath, ['remote', 'prune', 'origin']);
+        remotePruned = true;
+    }
+    catch (err) {
+        errors.push(`remote prune: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // 2. Get merged branches (used for worktree and branch cleanup)
+    const mergedBranches = await getMergedBranches(projectPath);
+    // 3. Remove orphan worktrees
+    const { removed: worktreesRemoved, errors: wtErrors } = await cleanupOrphanWorktrees(projectPath, mergedBranches);
+    errors.push(...wtErrors);
+    // 4. Remove branches with gone upstream
+    const { removed: branchesRemoved, errors: branchErrors } = await cleanupGoneBranches(projectPath);
+    errors.push(...branchErrors);
+    // 5. Detect / drop stale stashes
+    const staleStashes = await detectStaleStashes(projectPath);
+    let stashesDropped = 0;
+    if (force && staleStashes.length > 0) {
+        const { dropped, errors: stashErrors } = await dropStaleStashes(projectPath, staleStashes);
+        stashesDropped = dropped;
+        errors.push(...stashErrors);
+    }
+    const messageParts = [
+        `Worktrees removed: ${worktreesRemoved.length}`,
+        `Branches removed: ${branchesRemoved.length}`,
+        `Remote pruned: ${remotePruned ? 'yes' : 'no'}`,
+        `Stale stashes (>${STALE_DAYS_THRESHOLD}d): ${staleStashes.length}`,
+        ...(force ? [`Stashes dropped: ${stashesDropped}`] : ['Use force:true to drop stale stashes']),
+        ...(errors.length > 0 ? [`Errors: ${errors.length}`] : []),
+    ];
+    const report = {
+        action: 'cleanup',
+        worktreesRemoved,
+        branchesRemoved,
+        remotePruned,
+        stalesStashes: staleStashes,
+        stashesDropped,
+        errors,
+        message: messageParts.join(' | '),
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(report, null, 2) }],
+    };
+}
+// ---------------------------------------------------------------------------
+// Spec-done cleanup (AC-01) — called from update-status-actions.ts
+// ---------------------------------------------------------------------------
+/** Checks whether a worktree path for a given spec exists in .claude/worktrees/ */
+async function findSpecWorktree(projectPath, specId) {
+    const worktreesPath = join(projectPath, WORKTREES_DIR);
+    if (!existsSync(worktreesPath)) {
+        return null;
+    }
+    try {
+        const entries = await readdir(worktreesPath);
+        const match = entries.find((e) => e.toLowerCase().includes(specId.toLowerCase()));
+        return match ? join(worktreesPath, match) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * AC-01: When a spec is marked done, clean its worktree, local branch, and remote branch.
+ * Best-effort — never throws. Caller should fire-and-forget or log result.
+ */
+export async function cleanupSpecOnDone(projectPath, specId, gitBranch) {
+    const result = {
+        worktreeRemoved: null,
+        localBranchRemoved: null,
+        remoteBranchRemoved: null,
+        errors: [],
+    };
+    // 1. Remove worktree if it exists
+    const worktreePath = await findSpecWorktree(projectPath, specId);
+    if (worktreePath) {
+        try {
+            await removeWorktree(projectPath, worktreePath);
+            result.worktreeRemoved = worktreePath;
+        }
+        catch (err) {
+            result.errors.push(`worktree: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (!gitBranch) {
+        return result;
+    }
+    // 2. Remove local branch if merged
+    try {
+        const { stdout } = await git(projectPath, ['branch', '--merged', 'develop']);
+        const merged = new Set(stdout
+            .split('\n')
+            .map((b) => b.replace(/^\*?\s+/, '').trim())
+            .filter(Boolean));
+        const isMerged = merged.has(gitBranch);
+        // Also check main as fallback
+        let isMergedMain = false;
+        if (!isMerged) {
+            try {
+                const { stdout: mainOut } = await git(projectPath, ['branch', '--merged', 'main']);
+                const mergedMain = new Set(mainOut
+                    .split('\n')
+                    .map((b) => b.replace(/^\*?\s+/, '').trim())
+                    .filter(Boolean));
+                isMergedMain = mergedMain.has(gitBranch);
+            }
+            catch {
+                // ignore
+            }
+        }
+        if (isMerged || isMergedMain) {
+            // Never delete current branch
+            const { stdout: headOut } = await git(projectPath, ['rev-parse', '--abbrev-ref', 'HEAD']);
+            if (headOut.trim() !== gitBranch) {
+                try {
+                    await git(projectPath, ['branch', '-d', gitBranch]);
+                    result.localBranchRemoved = gitBranch;
+                }
+                catch {
+                    // Force-delete if needed
+                    try {
+                        await git(projectPath, ['branch', '-D', gitBranch]);
+                        result.localBranchRemoved = gitBranch;
+                    }
+                    catch (err) {
+                        result.errors.push(`local branch: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                }
+            }
+        }
+    }
+    catch (err) {
+        result.errors.push(`merged check: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // 3. Remove remote branch if it exists
+    try {
+        const { stdout } = await git(projectPath, ['ls-remote', '--heads', 'origin', gitBranch]);
+        if (stdout.trim()) {
+            await git(projectPath, ['push', 'origin', '--delete', gitBranch]);
+            result.remoteBranchRemoved = `origin/${gitBranch}`;
+        }
+    }
+    catch (err) {
+        result.errors.push(`remote branch: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return result;
+}
+//# sourceMappingURL=cleanup-ops.js.map