/** * CLI: `specweave task …` — the multi-vendor task ledger. * * 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 * (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 "" (exit 5 when the command fails; * auto-claims when nobody holds a live claim) * task release T-01 [inc] | --all-mine * task block T-01 [inc] --reason "…" * task skip T-01 [inc] --reason "…" (terminal; reason mandatory) * * A block or skip reason is one short plain sentence a person reads on the * board, with normal spaces and code in backticks. Safe spacing is fixed * (whitespace runs, a missing space after `,` or `;`); glued words * (`offline37profileattestation`) are refused with exit 2 and nothing is * appended; a reason over 280 characters is stored with a warning. * task render [inc] [--write] print the board; --write refreshes a legacy tasks.md * task repos [inc] [--set "a,b"] metadata.repositories: Files owners plus declared entries * * `claim`, `done` and `block` accept `--line ""` (max 100 chars, * longer text is truncated with a warning) and `--link `; they * feed the card checklist (`specweave cards --md`). * * `inc` defaults to the single active increment. Every command is read+append * only on ledger.jsonl. Task definitions (spec.md `## Tasks`, or a legacy * tasks.md) are never rewritten, so bookkeeping does not dirty the tree. * With `git.autoCommitIncrement` on, claim/done/release/block/skip then commit * the increment's spec.md, ledger.jsonl and metadata.json (`--no-commit` skips). * `next` and `claim` print the text of the task's acceptance criteria so the * agent does not need to reread spec.md for every task. * * @module cli/commands/task */ import { type BoardTask } from '../../core/tasks/task-board.js'; export interface TaskCommandOptions { force?: boolean; evidence?: string; run?: string; note?: string; /** Alias of --note; mandatory for `skip`. */ reason?: string; json?: boolean; allMine?: boolean; /** `render --write`: refresh a legacy tasks.md from the ledger. */ write?: boolean; /** Override cwd (tests). */ cwd?: string; /** Override agent id (tests). */ agent?: string; /** Card text for claim/done/block (max 100 chars). */ line?: string; /** Card link (PR URL, report path, artifact URL) for claim/done/block. */ link?: string; /** `--no-commit` → false: skip the `git.autoCommitIncrement` commit. */ commit?: boolean; /** `repos --set`: comma-separated repository paths or registered ids (replaces the declared entries). */ set?: string; } 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; /** A task still titled as create-increment's scaffold. */ export declare function isTemplateTask(t: Pick): 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