@wrongstack/tools 0.302.2 → 0.305.0

package/dist/kanban-contract-actions.d.ts

@@ -0,0 +1,7 @@
+import type { KanbanToolInput, KanbanToolOutput } from './kanban-tool-types.js';
+/**
+ * Handle a contract-map action, or return `undefined` when the action belongs
+ * to another handler. Mirrors the shape of `handleKanbanDetailAction`.
+ */
+export declare function handleKanbanContractAction(projectRoot: string, input: KanbanToolInput, actor: string | undefined): Promise<KanbanToolOutput | undefined>;
+//# sourceMappingURL=kanban-contract-actions.d.ts.map

package/dist/kanban-task-inputs.d.ts

@@ -18,12 +18,14 @@ export declare function taskInput(input: KanbanToolInput): {
     order?: number;
     retryPolicy?: "exponential" | "incremental" | "off";
     costCeilingUsd?: number;
+    atomic?: boolean;
     childTaskIds?: string[];
     successCriteria?: {
         id: `${string}-${string}-${string}-${string}-${string}`;
         description: string;
-        type: 'manual';
+        type: "command" | "file_exists" | "file_matches" | "git_diff" | "manual" | "metric" | "test";
         status: "failed" | "passed" | "pending" | "skipped";
+        notes?: string;
     }[];
     goalMetrics?: {
         id: `${string}-${string}-${string}-${string}-${string}`;
@@ -49,10 +51,20 @@ export declare function taskInput(input: KanbanToolInput): {
         system: string;
         graphId?: string;
         specId?: string;
+        specRequirementId?: string;
         phaseId?: string;
     };
 };
-/** Union of the single `dependencyTaskId` and the multi `dependsOn[]` inputs. */
+/**
+ * Union of the single `dependencyTaskId` and the multi `dependsOn[]` inputs.
+ *
+ * Returns `undefined` only when neither was supplied, so an explicit
+ * `dependsOn: []` CLEARS the list instead of being silently ignored. It used to
+ * collapse empty to `undefined`, which meant a dependency added by mistake
+ * could never be taken back from the tool surface: `dependency-incomplete`
+ * then held the card out of Running for good, and the only escapes were
+ * finishing work nobody wanted or deleting the blocking card outright.
+ */
 export declare function mergedDependsOn(input: KanbanToolInput): string[] | undefined;
 export declare function taskPatch(input: KanbanToolInput): {
     title: string | undefined;
@@ -66,6 +78,8 @@ export declare function taskPatch(input: KanbanToolInput): {
     labels: string[] | undefined;
     assignedAgent: string | undefined;
     dependsOn?: string[] | undefined;
+    atomic?: boolean;
+    childTaskIds?: string[];
     estimatedHours?: number;
     actualHours?: number;
 };

package/dist/kanban-tool-schema.d.ts

@@ -1,5 +1,5 @@
 import type { JSONSchema } from '@wrongstack/core/types';
-export declare const KANBAN_TOOL_DESCRIPTION = "Manage and audit project-scoped multi-kanban boards through the shared IPC Kanban server and its SQLite store. Managed cards enforce fully specified details and adjacent Backlog \u2192 Todo \u2192 Running \u2192 Review \u2192 Done transitions with persistent comments and evidence. Successful board access records live agent/session presence. Use verify_completion to validate a task against its success criteria and persist the verification report. Use split_atomic to split a task into child tasks with parent.atomic=true in a single atomic board mutation, enforcing subtree verification before the parent can complete.";
-export declare const KANBAN_TOOL_USAGE_HINT = "Use this for durable project kanban state. Reassess with get_board whenever evidence changes; agents may add, update, split, merge, reprioritize, or remove tasks so the board remains a live plan. Presence includes active/last-seen session and agent metadata. For managed boards, fully fill card details, use transition_task after every material step, attach truthful evidence, and never use update_task/move_task to bypass lifecycle guards. Worker completion enters Review; only passed acceptance criteria plus review evidence allow Done. Use verify_completion to generate a verification report (persisted automatically) and split_atomic to atomically create child subtasks with the atomic flag pre-set.";
+export declare const KANBAN_TOOL_DESCRIPTION = "Durable project task boards: create and move cards, record checks, notes, links and assignments. The board is a record of the work, not a permit for it \u2014 nothing here gates other tools. Managed boards additionally enforce ordered Backlog \u2192 Todo \u2192 Running \u2192 Review \u2192 Done transitions; release_managed_lifecycle turns that off.";
+export declare const KANBAN_TOOL_USAGE_HINT = "Track substantial or multi-step work so it survives the session; a trivial edit or a question needs no card. Work stays on ONE board: call list_boards first and add_task to the board this project already uses. create_board is for a genuinely separate line of work, not for each new piece of it \u2014 a second board splits the same effort in two, and a board holding a single card is the usual sign. Common flow: list_boards or search_tasks to orient, add_task to record work, start_task when you begin, update_check with checkStatus \"passed\" to tick acceptance criteria (read their ids from get_task), then transition_task. On a managed board a refused transition names the field it wants \u2014 supply it and retry. When the acceptance criterion is something a machine can run, say so: set checkType (\"command\", \"test\", \"file_exists\", \"file_matches\", \"git_diff\", \"metric\") and put the command, pattern or path in checkNotes, then verify_completion executes it and the result is real evidence. Leave checkType off (or \"manual\") only for criteria that genuinely need a human eye \u2014 a manual check records your assertion, it does not test anything.";
 export declare const KANBAN_INPUT_SCHEMA: JSONSchema;
 //# sourceMappingURL=kanban-tool-schema.d.ts.map

package/dist/kanban-tool-types.d.ts

@@ -1,6 +1,6 @@
 import type { SerializedTaskGraph } from '@wrongstack/core/types';
-import type { AssignKanbanTaskInput, KanbanAgentRunStatus, KanbanBoard, KanbanBoardSummary, KanbanCompletionGateEnforcement, KanbanDecompositionSubtask, KanbanEvent, KanbanLifecycleStage, KanbanOrchestrationSnapshot, KanbanQueueHealth, KanbanSearchResult, KanbanTask, KanbanTaskPriority, KanbanTaskStatus, KanbanTaskType, KanbanVerificationReport } from '@wrongstack/kanban';
-export type KanbanAction = 'list_boards' | 'get_board' | 'create_board' | 'duplicate_board' | 'update_board' | 'adopt_managed_lifecycle' | 'delete_board' | 'generate_board' | 'export_markdown' | 'export_task_graph' | 'sync_task_graph' | 'create_from_graph' | 'import_session_tasks' | 'search_tasks' | 'ready_tasks' | 'snapshot' | 'add_column' | 'update_column' | 'delete_column' | 'add_task' | 'split_task' | 'merge_tasks' | 'copy_task' | 'transfer_task' | 'get_task' | 'update_task' | 'transition_task' | 'repair_managed_projection' | 'move_task' | 'delete_task' | 'set_chain' | 'get_chain' | 'claim_task' | 'release_task' | 'assign_task' | 'mark_assignment' | 'heartbeat_assignment' | 'recover_stale' | 'events' | 'queue_health' | 'add_dependency' | 'add_goal_metric' | 'update_goal_metric' | 'add_check' | 'update_check' | 'add_note' | 'add_link' | 'verify_completion' | 'split_atomic' | 'assess_atomicity' | 'propose_decomposition';
+import type { AssignKanbanTaskInput, KanbanAgentRunStatus, KanbanBoard, KanbanBoardSummary, KanbanCompletionGateEnforcement, KanbanContractEdgeType, KanbanContractEnforcement, KanbanContractGraph, KanbanContractGraphEnforcement, KanbanContractGraphEvaluation, KanbanContractNodeKind, KanbanContractNodeState, KanbanDecompositionSubtask, KanbanEvent, KanbanLifecycleStage, KanbanOrchestrationSnapshot, KanbanQueueHealth, KanbanSearchResult, KanbanTask, KanbanTaskPriority, KanbanTaskStatus, KanbanTaskType, KanbanVerificationReport, KanbanWorkbenchSnapshot } from '@wrongstack/kanban';
+export type KanbanAction = 'list_boards' | 'get_board' | 'create_board' | 'duplicate_board' | 'update_board' | 'adopt_managed_lifecycle' | 'release_managed_lifecycle' | 'delete_board' | 'generate_board' | 'export_markdown' | 'export_task_graph' | 'sync_task_graph' | 'create_from_graph' | 'import_session_tasks' | 'search_tasks' | 'ready_tasks' | 'snapshot' | 'workbench' | 'add_column' | 'update_column' | 'delete_column' | 'add_task' | 'split_task' | 'merge_tasks' | 'copy_task' | 'transfer_task' | 'get_task' | 'start_task' | 'update_task' | 'transition_task' | 'repair_managed_projection' | 'move_task' | 'delete_task' | 'set_chain' | 'get_chain' | 'claim_task' | 'release_task' | 'assign_task' | 'mark_assignment' | 'heartbeat_assignment' | 'recover_stale' | 'events' | 'queue_health' | 'add_dependency' | 'add_goal_metric' | 'update_goal_metric' | 'add_check' | 'update_check' | 'remove_check' | 'add_note' | 'add_link' | 'verify_completion' | 'split_atomic' | 'assess_atomicity' | 'propose_decomposition' | 'get_contract_graph' | 'configure_contract_graph' | 'upsert_contract_node' | 'remove_contract_node' | 'add_contract_edge' | 'remove_contract_edge';
 export interface KanbanToolInput extends Omit<AssignKanbanTaskInput, 'status'> {
     action: KanbanAction;
     boardId?: string | undefined;
@@ -9,6 +9,10 @@ export interface KanbanToolInput extends Omit<AssignKanbanTaskInput, 'status'> {
     targetBoardId?: string | undefined;
     taskIds?: string[] | undefined;
     chainId?: string | undefined;
+    fromNodeId?: string | undefined;
+    toNodeId?: string | undefined;
+    baseline?: string | number | undefined;
+    threshold?: string | number | undefined;
     title?: string | undefined;
     description?: string | undefined;
     dueDate?: string | undefined;
@@ -43,6 +47,30 @@ export interface KanbanToolInput extends Omit<AssignKanbanTaskInput, 'status'> {
     checkId?: string | undefined;
     checkDescription?: string | undefined;
     checkStatus?: 'pending' | 'passed' | 'failed' | 'skipped' | undefined;
+    /**
+     * Verifier type for an acceptance criterion. Narrower than `KanbanCheckType`
+     * on purpose: only the types the default deterministic registry can actually
+     * run are offered, so a criterion this tool creates never reports
+     * `skipped — no verifier plugin registered`.
+     */
+    checkType?: 'manual' | 'command' | 'test' | 'file_exists' | 'file_matches' | 'git_diff' | 'metric' | undefined;
+    /** Executable body for a non-manual `checkType`; plugins read it before the description. */
+    checkNotes?: string | undefined;
+    contractEnforcement?: KanbanContractGraphEnforcement | undefined;
+    contractNodeId?: string | undefined;
+    contractNodeKind?: KanbanContractNodeKind | undefined;
+    contractNodeTitle?: string | undefined;
+    contractNodeDescription?: string | undefined;
+    contractNodeState?: KanbanContractNodeState | undefined;
+    contractNodeEnforcement?: KanbanContractEnforcement | undefined;
+    contractCheckId?: string | undefined;
+    contractMetricId?: string | undefined;
+    contractWaiverReason?: string | undefined;
+    contractEdgeId?: string | undefined;
+    contractEdgeFrom?: string | undefined;
+    contractEdgeTo?: string | undefined;
+    contractEdgeType?: KanbanContractEdgeType | undefined;
+    contractEdgeRationale?: string | undefined;
     note?: string | undefined;
     author?: string | undefined;
     url?: string | undefined;
@@ -88,6 +116,7 @@ export interface KanbanToolInput extends Omit<AssignKanbanTaskInput, 'status'> {
     taskGraph?: unknown;
     graphId?: string | undefined;
     specId?: string | undefined;
+    specRequirementId?: string | undefined;
     sourceSystem?: string | undefined;
     phaseId?: string | undefined;
     preserveOriginTaskIds?: boolean | undefined;
@@ -95,7 +124,12 @@ export interface KanbanToolInput extends Omit<AssignKanbanTaskInput, 'status'> {
     archiveMissingTasks?: boolean | undefined;
     preserveManualDependencies?: boolean | undefined;
     /** Full dependency id list for add_task/update_task (superset of dependencyTaskId). */
+    /** `update_task`: an explicit `[]` clears every dependency. */
     dependsOn?: string[] | undefined;
+    /** `update_task`: mark a card a composite parent, or `false` to make it a leaf again. */
+    atomic?: boolean | undefined;
+    /** `update_task`: an explicit `[]` detaches every child from a composite parent. */
+    childTaskIds?: string[] | undefined;
     /** Estimated effort in hours for add_task/update_task. */
     estimatedHours?: number | undefined;
     /** Actual effort in hours for add_task/update_task. */
@@ -129,7 +163,10 @@ export interface KanbanToolOutput {
     children?: KanbanTask[] | undefined;
     chain?: KanbanTask[] | undefined;
     snapshot?: KanbanOrchestrationSnapshot | undefined;
+    workbench?: KanbanWorkbenchSnapshot | undefined;
     taskGraph?: SerializedTaskGraph | undefined;
     markdown?: string | undefined;
+    contractGraph?: KanbanContractGraph | null | undefined;
+    contractEvaluation?: KanbanContractGraphEvaluation | undefined;
 }
 //# sourceMappingURL=kanban-tool-types.d.ts.map