specweave 3.1.16 → 3.1.17

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "3.1.16",
+  "version": "3.1.17",
   "description": "Portable intent, specifications, task evidence, and handoffs across AI coding tools.",
   "owner": {
     "name": "Anton Abyzov",
@@ -12,7 +12,7 @@
       "description": "SpecWeave unified plugin — increment lifecycle (plan, work the ledger, verify, review, complete), cross-tool handoff, GitHub/Jira/ADO sync",
       "source": "./plugins/specweave",
       "category": "development",
-      "version": "3.1.16",
+      "version": "3.1.17",
       "author": {
         "name": "Anton Abyzov",
         "email": "anton.abyzov@gmail.com"

package/bin/help.js

@@ -1,44 +1,26 @@
 export function registerHelp(program) {
-// Help text
+// Help text: the loop first, then a few everyday commands. Plumbing and legacy
+// commands are registered with { hidden: true } and still run.
 program.on('--help', () => {
   console.log('');
-  console.log('Examples:');
-  console.log('  $ specweave init my-saas                    # Create new project (auto-detect tool)');
-  console.log('  $ specweave init my-saas --adapter cursor   # Create project for Cursor');
-  console.log('  $ specweave init my-saas --language ru      # Create project with Russian language');
-  console.log('  $ specweave status                          # Show all increments status');
-  console.log('  $ specweave status --verbose                # Show detailed increment info');
-  console.log('  $ specweave pause 0007 --reason "blocked"   # Pause increment 0007');
-  console.log('  $ specweave resume 0007                     # Resume increment 0007');
-  console.log('  $ specweave abandon 0007 --reason "obsolete" # Abandon increment 0007');
-  console.log('  $ specweave qa 0008                         # Quick quality check');
-  console.log('  $ specweave qa 0008 --pre                   # Pre-implementation check');
-  console.log('  $ specweave qa 0008 --gate --export         # Quality gate + export to tasks');
-  console.log('  $ specweave sync status                     # Token/account, provider health, sync gaps');
-  console.log('  $ specweave sync push 0008                  # Push increment progress to GitHub/Jira/ADO');
-  console.log('  $ specweave sync pull --since 3             # Show external changes from the last 3 days');
-  console.log('  $ specweave sync setup --validate           # Validate tracker configuration + credentials');
-  console.log('  $ specweave doctor --fix-status             # Fix metadata/spec status desyncs');
-  console.log('  $ specweave refresh-plugins                 # Refresh core SpecWeave plugin');
-  console.log('  $ specweave refresh-plugins --all           # Refresh every installed plugin');
-  console.log('  $ specweave refresh-plugins --force         # Force reinstall (skip hash check)');
-  console.log('  $ specweave update                          # Update CLI + instructions + config');
-  console.log('  $ specweave update --plugins                # Also refresh marketplace plugins');
-  console.log('  $ specweave update --no-self                # Skip CLI update, only project files');
-  console.log('  $ specweave update --check                  # Dry run - preview changes');
+  console.log('The loop:');
+  console.log('  $ specweave init                               # Set up SpecWeave in this folder');
+  console.log('  $ specweave create-increment "Add login form"  # Plan: fill spec.md (Problem, ACs, Tasks)');
+  console.log('  $ specweave task done T-01 --run "npm test"    # After the commit: run the task\'s Test, record it');
+  console.log('  $ specweave verify                             # Run the project\'s build/test/lint commands');
+  console.log('  $ specweave complete 0001                      # Close the increment');
+  console.log('  $ specweave handoff --reason "out of tokens"   # Stop here; another tool or account continues');
+  console.log('  $ specweave pickup                             # Continue handed-off work');
   console.log('');
-  console.log('Plugin Management (use Claude CLI commands):');
-  console.log('  $ claude plugin install sw@specweave        # Install core SpecWeave');
-  console.log('  $ claude plugin list                        # Show installed plugins');
-  console.log('  $ vskill install anton-abyzov/vskill --plugin mobile  # Install domain plugin');
+  console.log('Also:');
+  console.log('  $ specweave status                             # Increments and their progress');
+  console.log('  $ specweave task next                          # The next open task with its acceptance criteria');
+  console.log('  $ specweave sync setup                         # Connect GitHub Issues, Jira or Azure DevOps');
+  console.log('  $ specweave doctor                             # Check project health');
+  console.log('  $ specweave update                             # Update the CLI, instructions and skills');
   console.log('');
-  console.log('Supported AI Tools:');
-  console.log('  - Claude Code (full automation) - Native skills, agents, hooks');
-  console.log('  - Cursor (semi-automation) - .cursorrules, @ shortcuts');
-  console.log('  - GitHub Copilot (basic) - Workspace instructions');
-  console.log('  - Generic (manual) - Works with ANY AI (ChatGPT, Gemini, etc.)');
-  console.log('');
-  console.log('For more information, visit: https://spec-weave.com');
+  console.log('Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI and any tool that reads AGENTS.md.');
+  console.log('More: https://spec-weave.com');
 });
 
 }

package/bin/specweave.js

@@ -23,7 +23,7 @@ const program = new Command();
 
 program
   .name('specweave')
-  .description('Spec-Driven Development framework with AI-powered autonomous agents')
+  .description('Spec-driven increments for AI coding agents: plan in spec.md, do each task, verify, close, hand off')
   .version(packageJson.version)
   .option('--workspace <root>', 'Select the planning workspace explicitly');
 
@@ -256,7 +256,7 @@ program
 // Create Increment command - Create template files for a new increment
 program
   .command('create-increment [title]')
-  .description('Create increment template files (metadata.json, spec.md, tasks.md). Short form: specweave create-increment "Add login form"')
+  .description('Create an increment: metadata.json and spec.md (Problem, Scope, ACs, Approach, Tasks). Short form: specweave create-increment "Add login form"')
   .option('--id <increment-id>', 'Increment ID (e.g., "0042-my-feature")')
   .option('--auto-id', 'Auto-generate next available increment ID (default when --id is absent)')
   .option('--name <name>', 'Increment name suffix (defaults to a slug of the title)')
@@ -382,7 +382,7 @@ program
   });
 
 program
-  .command('statusline')
+  .command('statusline', { hidden: true })
   .description('Claude Code status line that records usage for auto-handoff')
   .option('--wrap <command>', 'Print this status line command\'s output instead of the built-in line')
   .action(async (options) => {
@@ -391,7 +391,7 @@ program
   });
 
 program
-  .command('usage-guard')
+  .command('usage-guard', { hidden: true })
   .description('Stop hook: save a local checkpoint; at the auto-handoff threshold, suggest or ask for a handoff once')
   .option('--limit-hit', 'StopFailure hook: the turn hit the rate limit, so hand off now (or only save, in checkpoint-only mode)')
   .action(async (options) => {
@@ -401,7 +401,7 @@ program
 
 // Auto-compact window for Claude Code (400K keeps 1M-context turns small)
 program
-  .command('autocompact [action]')
+  .command('autocompact [action]', { hidden: true })
   .description('on | off | status: where Claude Code summarizes a long session (default 400k)')
   .option('--at <tokens>', 'Window for `on`, 100k to 1M (default 400k)')
   .option('--project', 'Write .claude/settings.json in this project instead of ~/.claude/settings.json')
@@ -457,7 +457,7 @@ program
 
 // Next ID command - Return the next available increment number
 program
-  .command('next-id')
+  .command('next-id', { hidden: true })
   .description('Return the next available increment number. Prefer: create-increment --auto-id')
   .option('--project <project-id>', 'Project ID for per-project collision prevention')
   .option('--project-root <path>', 'Override project root directory')
@@ -512,7 +512,7 @@ program
 
 // Save command - Smart save with auto-sync
 program
-  .command('save [message]')
+  .command('save [message]', { hidden: true })
   .description('Smart save - auto-generate commit message, sync with remote, commit and push')
   .option('-i, --interactive', 'Interactive mode - ask before each step')
   .option('--dry-run', 'Preview without executing')
@@ -559,7 +559,7 @@ program
 // Auto mode commands - Autonomous execution with stop hook feedback loop (v3.0)
 // No session files. No complex state. Just: "Are there active increments?"
 program
-  .command('auto [incrementIds...]')
+  .command('auto [incrementIds...]', { hidden: true })
   .description('Start autonomous execution (stop hook feedback loop)')
   .option('--dry-run', 'Preview without activating')
   .option('--all-backlog', 'Activate all backlog items')
@@ -588,7 +588,7 @@ program
   });
 
 program
-  .command('auto-status')
+  .command('auto-status', { hidden: true })
   .description('Check auto session status and progress')
   .option('--verbose', 'Show detailed information')
   .option('--json', 'Output as JSON')
@@ -602,7 +602,7 @@ program
   });
 
 program
-  .command('cancel-auto')
+  .command('cancel-auto', { hidden: true })
   .description('Cancel running auto session')
   .option('--force', 'Force cancel without confirmation')
   .action(async (options) => {
@@ -615,7 +615,7 @@ program
 
 // Team command - Launch Claude Code with native agent teams
 program
-  .command('team [description]')
+  .command('team [description]', { hidden: true })
   .description('Launch Claude Code with agent teams (tmux/iTerm2 split panes)')
   .option('--mode <mode>', 'Display mode: tmux (default) or in-process', 'tmux')
   .option('--no-increment', 'Launch without requiring a SpecWeave increment (free-form agent swarm)')
@@ -632,7 +632,7 @@ program
 
 // Update instructions command - Smart merge CLAUDE.md/AGENTS.md
 program
-  .command('update-instructions')
+  .command('update-instructions', { hidden: true })
   .description('Update CLAUDE.md and AGENTS.md with smart merge (preserves user content)')
   .option('--dry-run', 'Preview changes without writing')
   .option('-v, --verbose', 'Show detailed merge information')
@@ -661,7 +661,7 @@ program
 
 // Check discipline command - Validate increment discipline
 program
-  .command('check-discipline')
+  .command('check-discipline', { hidden: true })
   .description('Report increment status counts, advisory WIP note and metadata consistency')
   .option('-v, --verbose', 'Show detailed increment information')
   .option('--json', 'Output results as JSON')
@@ -677,7 +677,7 @@ program
 
 // GC command - purge junk from .specweave/state (dry-run by default)
 program
-  .command('gc')
+  .command('gc', { hidden: true })
   .description('Purge stale .specweave/state files (dry-run; --yes to delete), report .worktrees size and nested .specweave dirs, expire session checkpoints older than 7 days')
   .option('-y, --yes', 'Actually delete (default is dry-run)')
   .option('--json', 'Output as JSON')
@@ -689,7 +689,7 @@ program
 
 // QA command - Quality assessment
 program
-  .command('qa <increment-id>')
+  .command('qa <increment-id>', { hidden: true })
   .description('Run quality assessment on an increment')
   .option('--quick', 'Quick mode (default)')
   .option('--pre', 'Pre-implementation check')
@@ -708,7 +708,7 @@ program
 
 // Link PR - Link pull requests to external tickets (JIRA remote links, ADO hyperlinks)
 program
-  .command('link-pr')
+  .command('link-pr', { hidden: true })
   .description('Link a pull request to external tickets (JIRA, ADO)')
   .requiredOption('--increment <id>', 'Increment ID')
   .requiredOption('--pr-url <url>', 'Pull request URL')
@@ -721,7 +721,7 @@ program
 
 // Branch-name command - Compute branch name with optional external ticket key
 program
-  .command('branch-name <increment-id>')
+  .command('branch-name <increment-id>', { hidden: true })
   .description('Output the computed branch name for an increment (with optional JIRA/ADO ticket key)')
   .action(async (incrementId) => {
     const { branchNameCommand } = await import('../dist/src/cli/commands/branch-name.js');
@@ -737,7 +737,7 @@ async function runLspCommand(args) {
 
 // LSP command - Code intelligence operations
 const lspCmd = program
-  .command('lsp')
+  .command('lsp', { hidden: true })
   .description('LSP code intelligence (refs, def, hover, symbols, search)');
 
 lspCmd
@@ -865,7 +865,7 @@ syncCmd
 
 // Refresh plugins command - Copy first-party plugins to ~/.claude/commands/
 program
-  .command('refresh-plugins')
+  .command('refresh-plugins', { hidden: true })
   .description('Refresh SpecWeave plugins (core only by default, use --all for everything)')
   .option('--all', 'Install ALL plugins (not just core sw)')
   .option('--plugin <name>', 'Install a specific plugin by name')

package/dist/src/adapters/generic/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/generic/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,SAAa;IACjB,WAAW,SAAyF;IACpG,eAAe,EAAG,QAAQ,CAAU;IAEpC;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAKhC;;;;;OAKG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;IAgDzB;;;;;;OAMG;IACH,eAAe,IAAI,OAAO;IAI1B,kBAAkB,IAAI,MAAM;IAI5B;;;;;;;OAOG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DlD;;;;OAIG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCrD;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAwB/C"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/generic/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,SAAa;IACjB,WAAW,SAAyF;IACpG,eAAe,EAAG,QAAQ,CAAU;IAEpC;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAKhC;;;;;OAKG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;IAQzB;;;;;;OAMG;IACH,eAAe,IAAI,OAAO;IAI1B,kBAAkB,IAAI,MAAM;IAI5B;;;;;;;OAOG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DlD;;;;OAIG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCrD;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAwB/C"}

package/dist/src/adapters/generic/adapter.js

@@ -54,51 +54,11 @@ export class GenericAdapter extends AdapterBase {
      * Get usage instructions for Generic adapter
      */
     getInstructions() {
+        // Short on purpose: init's "Next steps" prints the loop right after this.
         return `
-================================================================
-        Generic Adapter - Universal Compatibility
-================================================================
-
-Your project is now configured for ANY AI tool!
-
-WHAT THIS PROVIDES:
-
-- AGENTS.md (Universal Standard)
-  - Works with: GitHub Copilot, ChatGPT, Gemini, Claude web, etc.
-  - Contains all workflow instructions and project structure
-  - Following agents.md standard (https://agents.md/)
-
-HOW TO USE AGENTS.MD:
-
-Method 1: Auto-Discovery (Copilot - Recommended)
-  AI reads AGENTS.md → Ask "create increment for payments" → Done!
-
-Method 2: Copy-Paste (ChatGPT, Claude web, etc.)
-  Open AGENTS.md → Copy workflow section → Paste to AI → Save output
-
-Method 3: File System Access (AI with file access)
-  AI reads AGENTS.md automatically → Ask "Create increment" → Files created
-
-QUICK START:
-
-1. Open AGENTS.md - read "Common Workflows" section
-2. Use your AI tool: ChatGPT, Claude web, Gemini, Copilot, etc.
-3. Ask AI to follow the workflow instructions
-4. Save generated files to .specweave/increments/
-
-AVAILABLE COMMANDS (the CLI works in any tool):
-specweave create-increment "feature"   Plan the work (spec.md + tasks.md)
-specweave task next | task claim T-01 | task done T-01 --run "<test>"
-specweave verify <id>                  Run the checks, write reports/verify.json
-specweave complete <id>                Close the increment
-specweave handoff [id]                 Write handoff.md before you stop
-
-DOCUMENTATION:
-- AGENTS.md - Workflow instructions (works with any AI!)
-- .specweave/docs/ - Project documentation
-
-Ready to build with SpecWeave using ANY AI tool!
-    `;
+AGENTS.md now holds the workflow for any AI tool (Copilot, Gemini, ChatGPT and others).
+Open the project in your tool and ask: "Create an increment for <your feature>".
+`;
     }
     /**
      * Check if Generic adapter supports plugins

package/dist/src/adapters/generic/adapter.js.map

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

package/dist/src/cli/commands/complete.d.ts

@@ -26,5 +26,11 @@ interface CompleteCommandOptions {
  * @since v4.1 - Short-ID resolution and batch mode
  */
 export declare function completeCommand(incrementId: string | undefined, moreIds?: string[], options?: CompleteCommandOptions): Promise<void>;
+/**
+ * `complete` never commits, so say how when the closed increment has
+ * uncommitted changes. Only inside a git work tree. The pathspec keeps other
+ * staged work out of the commit; the path is relative to where the user is.
+ */
+export declare function commitHint(projectRoot: string, incrementId: string, cwd?: string): string | undefined;
 export {};
 //# sourceMappingURL=complete.d.ts.map

package/dist/src/cli/commands/complete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/complete.ts"],"names":[],"mappings":"AAQA,UAAU,sBAAsB;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,GAAE,MAAM,EAAO,EACtB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAiFf"}
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/complete.ts"],"names":[],"mappings":"AASA,UAAU,sBAAsB;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,GAAE,MAAM,EAAO,EACtB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAmFf;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAc,GAAG,MAAM,GAAG,SAAS,CAO1G"}

package/dist/src/cli/commands/complete.js

@@ -1,4 +1,5 @@
 import * as path from 'path';
+import { spawnSync } from 'child_process';
 import { detectSessionId } from '../../core/tasks/ledger.js';
 import { recordIncrementWork } from '../../core/tasks/work-session.js';
 import { completeIncrement } from '../../core/increment/status-commands.js';
@@ -78,6 +79,9 @@ export async function completeCommand(incrementId, moreIds = [], options = {}) {
         }
         if (success) {
             recordIncrementWork(path.join(projectRoot, '.specweave', 'increments', resolved), { e: 'complete' }, { sessionId: detectSessionId() });
+            const hint = options.silent || options.yes ? undefined : commitHint(projectRoot, resolved, process.cwd());
+            if (hint)
+                console.log(hint);
         }
         results.push({ id, resolved, success });
     }
@@ -98,4 +102,18 @@ export async function completeCommand(incrementId, moreIds = [], options = {}) {
         process.exit(1);
     }
 }
+/**
+ * `complete` never commits, so say how when the closed increment has
+ * uncommitted changes. Only inside a git work tree. The pathspec keeps other
+ * staged work out of the commit; the path is relative to where the user is.
+ */
+export function commitHint(projectRoot, incrementId, cwd = projectRoot) {
+    const folder = path.join(projectRoot, '.specweave', 'increments', incrementId);
+    const status = spawnSync('git', ['status', '--porcelain', '--', folder], { cwd: projectRoot, encoding: 'utf-8' });
+    if (status.status !== 0 || !status.stdout.trim())
+        return undefined;
+    const rel = path.relative(cwd, folder).split(path.sep).join('/') || '.';
+    const num = incrementId.match(/^\d{3,}[A-Za-z]?(?=-)/)?.[0] ?? incrementId;
+    return `Commit it: git add ${rel} && git commit -m "${num}: close" -- ${rel}`;
+}
 //# sourceMappingURL=complete.js.map

package/dist/src/cli/commands/complete.js.map

@@ -1 +1 @@
-{"version":3,"file":"complete.js","sourceRoot":"","sources":["../../../../src/cli/commands/complete.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"complete.js","sourceRoot":"","sources":["../../../../src/cli/commands/complete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAYrG;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAA+B,EAC/B,UAAoB,EAAE,EACtB,UAAkC,EAAE;IAEpC,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAE3C,IAAI,MAAgB,CAAC;IACrB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;YACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,4BAA4B,CAAC,WAAW,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;QAChF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;YACrF,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,gCAAgC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,iFAAiF,CAAC,CAAC;YACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,OAAO,GAA8D,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAElC,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,gCAAgC;QAChC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAErD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,gCAAgC,CAAC,CAAC;YACpF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QAED,wEAAwE;QACxE,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,iBAAiB,CAAC;gBAChC,WAAW,EAAE,QAAQ;gBACrB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG;gBACrC,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,qBAAqB,QAAQ,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvG,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;YACvI,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAC1G,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACxD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,qBAAqB,SAAS,eAAe,MAAM,SAAS,CAAC,CAAC;QAC1E,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,WAAmB,EAAE,GAAG,GAAG,WAAW;IACpF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAClH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACnE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IACxE,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;IAC3E,OAAO,sBAAsB,GAAG,sBAAsB,GAAG,eAAe,GAAG,EAAE,CAAC;AAChF,CAAC"}

package/dist/src/cli/commands/task.d.ts

@@ -4,7 +4,9 @@
  *   task whoami                         print the agent id
  *   task list [inc] [--json]            table: task, status, by, evidence
  *   task next [inc] [--json]            first open task with deps met + no Files overlap
- *   task claim T-01 [inc] [--force]     append a claim (exit 3 lost race, 4 Files overlap)
+ *                                       (exit 7 while it is still a template placeholder)
+ *   task claim T-01 [inc] [--force]     append a claim (exit 3 lost race, 4 Files overlap,
+ *                                       7 unfilled template placeholder)
  *   task done T-01 [inc] --evidence "…" | --run "<cmd>"   (exit 5 when the command fails;
  *                                       auto-claims when nobody holds a live claim)
  *   task release T-01 [inc] | --all-mine
@@ -26,6 +28,7 @@
  *
  * @module cli/commands/task
  */
+import { type BoardTask } from '../../core/tasks/task-board.js';
 export interface TaskCommandOptions {
     force?: boolean;
     evidence?: string;
@@ -52,6 +55,21 @@ export declare const EXIT_LOST_RACE = 3;
 export declare const EXIT_FILES_OVERLAP = 4;
 export declare const EXIT_RUN_FAILED = 5;
 export declare const EXIT_DEPS_UNMET = 6;
+/** `next` / `claim` on a task still holding create-increment's bracketed placeholders. */
+export declare const EXIT_TEMPLATE_TASK = 7;
 /** Entry point. Returns the process exit code (the bin sets process.exitCode). */
 export declare function taskCommand(action: string, a?: string, b?: string, opts?: TaskCommandOptions): Promise<number>;
+/**
+ * Quote a Test so the printed `--run` argument pastes as one shell word. Plain
+ * text stays in double quotes (works in every shell); anything a shell would
+ * expand or that would end the double quotes goes in POSIX single quotes.
+ */
+export declare function shellQuote(s: string): string;
+/** A task still titled as create-increment's scaffold. */
+export declare function isTemplateTask(t: Pick<BoardTask, 'title'>): boolean;
+/**
+ * A Test that is a bracketed placeholder (`[command]`, `[command that checks …]`).
+ * A letter must follow the bracket, so a shell test such as `[ -f dist/cli.js ]` is real.
+ */
+export declare function isPlaceholderTest(test: string | undefined): boolean;
 //# sourceMappingURL=task.d.ts.map

package/dist/src/cli/commands/task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA0BH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,eAAe,IAAI,CAAC;AAIjC,kFAAkF;AAClF,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0PxH"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AASH,OAAO,EASL,KAAK,SAAS,EACf,MAAM,gCAAgC,CAAC;AAOxC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAIpC,kFAAkF;AAClF,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwQxH;AAoFD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5C;AASD,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,OAAO,CAEnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE"}

package/dist/src/cli/commands/task.js

@@ -4,7 +4,9 @@
  *   task whoami                         print the agent id
  *   task list [inc] [--json]            table: task, status, by, evidence
  *   task next [inc] [--json]            first open task with deps met + no Files overlap
- *   task claim T-01 [inc] [--force]     append a claim (exit 3 lost race, 4 Files overlap)
+ *                                       (exit 7 while it is still a template placeholder)
+ *   task claim T-01 [inc] [--force]     append a claim (exit 3 lost race, 4 Files overlap,
+ *                                       7 unfilled template placeholder)
  *   task done T-01 [inc] --evidence "…" | --run "<cmd>"   (exit 5 when the command fails;
  *                                       auto-claims when nobody holds a live claim)
  *   task release T-01 [inc] | --all-mine
@@ -43,6 +45,8 @@ export const EXIT_LOST_RACE = 3;
 export const EXIT_FILES_OVERLAP = 4;
 export const EXIT_RUN_FAILED = 5;
 export const EXIT_DEPS_UNMET = 6;
+/** `next` / `claim` on a task still holding create-increment's bracketed placeholders. */
+export const EXIT_TEMPLATE_TASK = 7;
 const ACTIONS = new Set(['whoami', 'list', 'next', 'claim', 'done', 'release', 'block', 'skip', 'render']);
 /** Entry point. Returns the process exit code (the bin sets process.exitCode). */
 export async function taskCommand(action, a, b, opts = {}) {
@@ -138,7 +142,16 @@ export async function taskCommand(action, a, b, opts = {}) {
         return 0;
     }
     if (action === 'next') {
-        const t = nextTask(board, agent);
+        const t = nextTask(board, agent, isTemplateTask);
+        // Only unfilled placeholders are left to hand out: say so instead of "nothing to do".
+        const placeholder = t ? undefined : nextTask(board, agent);
+        if (placeholder) {
+            if (opts.json)
+                out(JSON.stringify({ increment: inc.id, next: null, error: 'template-task', task: placeholder.id }));
+            else
+                err(templateRefusal(placeholder, inc.id));
+            return EXIT_TEMPLATE_TASK;
+        }
         if (!t) {
             const c = board.counts;
             const finished = c.total > 0 && c.done + c.skipped === c.total;
@@ -188,6 +201,10 @@ export async function taskCommand(action, a, b, opts = {}) {
                 err(`${taskId} is already ${task.state.status}`);
                 return 1;
             }
+            if (isTemplateTask(task)) {
+                err(templateRefusal(task, inc.id));
+                return EXIT_TEMPLATE_TASK;
+            }
             // Claiming a task starts the increment (planned → active). This is the
             // CLI transition the skills point at; nobody hand-edits metadata.json.
             const started = ensureIncrementStarted(inc.dir);
@@ -229,12 +246,18 @@ export async function taskCommand(action, a, b, opts = {}) {
                 err(`${taskId} was skipped by ${task.state.by}${task.state.note ? ` (${task.state.note})` : ''} — skip is terminal; add a new task to ${tasksFileName(inc.dir)} if the work is needed after all`);
                 return 1;
             }
+            if (isTemplateTask(task)) {
+                err(templateRefusal(task, inc.id));
+                return EXIT_TEMPLATE_TASK;
+            }
             if (heldByOther(task) && !opts.force) {
                 err(refusal(task, taskId, leaseHours));
                 return EXIT_LOST_RACE;
             }
             let evidence = (opts.evidence ?? '').trim();
-            const cmd = opts.run?.trim() || (!evidence && isShellCommand(task.test) ? task.test : undefined);
+            // A placeholder Test (`[command]`) is not run: the agent passes --run or --evidence.
+            const runnable = isShellCommand(task.test) && !isPlaceholderTest(task.test);
+            const cmd = opts.run?.trim() || (!evidence && runnable ? task.test : undefined);
             let logPath;
             if (cmd) {
                 const result = await runShell(cmd, projectRoot);
@@ -283,10 +306,14 @@ export async function taskCommand(action, a, b, opts = {}) {
             const c = board.counts;
             const allDone = c.done + c.skipped === c.total && c.total > 0;
             const committed = commitIncrement('done', [taskId]);
-            out(opts.json ? JSON.stringify({ done: taskId, evidence, log: logPath ? rel(projectRoot, logPath) : undefined, counts: c, ...(allDone ? { close: closeChain(inc.id) } : {}), ...commitJson(committed) }) : `Done ${taskId} (${c.done}/${c.total}) — evidence: ${firstLine(evidence)}`);
+            // Not the last task: hand the agent the next one, so it needs no `task next`.
+            const following = allDone ? undefined : nextTask(board, agent, isTemplateTask);
+            out(opts.json ? JSON.stringify({ done: taskId, evidence, log: logPath ? rel(projectRoot, logPath) : undefined, counts: c, ...(allDone ? { close: closeChain(inc.id) } : {}), ...(following ? { next: brief(following, acsOf()) } : {}), ...commitJson(committed) }) : `Done ${taskId} (${c.done}/${c.total}) — evidence: ${firstLine(evidence)}`);
             reportCommit(committed);
             if (allDone)
                 finishedAll(inc.id);
+            else if (following && !opts.json)
+                out(`\nNext: ${describeTask(following, inc.id, acsOf())}`);
             return 0;
         }
         case 'release': {
@@ -423,7 +450,37 @@ function describeTask(t, incId, acs = []) {
         ...(criteria.length ? criteria.map((a) => `  ${a.id}: ${a.text || '(text not found in spec.md)'}`) : ['  AC: -']),
         `  Files: ${(t.filesAffected ?? []).join(', ') || '-'} | Test: ${t.test ?? '-'}`,
         `  state: ${describeState(t.state)}`,
-        `  when done: specweave task done ${t.id} ${incId}${t.test ? ` --run "${t.test}"` : ' --evidence "<sha / output>"'}`,
+        `  when done: specweave task done ${t.id} ${incId}${t.test && !isPlaceholderTest(t.test) ? ` --run ${shellQuote(t.test)}` : ' --run "<command that checks the AC>"'}`,
     ].join('\n');
 }
+/**
+ * Quote a Test so the printed `--run` argument pastes as one shell word. Plain
+ * text stays in double quotes (works in every shell); anything a shell would
+ * expand or that would end the double quotes goes in POSIX single quotes.
+ */
+export function shellQuote(s) {
+    if (!/["$`\\!]/.test(s))
+        return `"${s}"`;
+    return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+/**
+ * create-increment's scaffold task titles. Only these mark a task as unfilled:
+ * imported increments keep real titles next to `[src/...]` and `[command]`, and
+ * a user's own `[WIP] …` title is a real task.
+ */
+const SCAFFOLD_TITLES = new Set(['[First task]', '[Second task]']);
+/** A task still titled as create-increment's scaffold. */
+export function isTemplateTask(t) {
+    return SCAFFOLD_TITLES.has(t.title.trim());
+}
+/**
+ * A Test that is a bracketed placeholder (`[command]`, `[command that checks …]`).
+ * A letter must follow the bracket, so a shell test such as `[ -f dist/cli.js ]` is real.
+ */
+export function isPlaceholderTest(test) {
+    return test !== undefined && /^\[[A-Za-z][^\]]*\]$/.test(test.trim());
+}
+function templateRefusal(t, incId) {
+    return `refused: ${t.id} in ${incId} is still the create-increment placeholder ("${t.title}"). Fill in spec.md ## Tasks first: a real title, then "- AC: AC-01 | Files: <paths> | Test: <command that checks the AC>".`;
+}
 //# sourceMappingURL=task.js.map