@wrongstack/tools 0.303.0 → 0.305.1

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}`;
@@ -53,7 +55,16 @@ export declare function taskInput(input: KanbanToolInput): {
         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;
@@ -67,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. Contract Map actions are optional advisory metadata unless an operator explicitly enabled strict enforcement. Use verify_completion to validate executable success criteria before Done.";
-export declare const KANBAN_TOOL_USAGE_HINT = "Use this for durable project kanban state. Read workbench when orienting across boards; it returns bounded Now, Next, Blocked, Review lanes and operational alerts. Before coding mutation, create a fully detailed card on a managed board with executable acceptance criteria, then call start_task. The runtime blocks product mutations until start_task binds a ready Running card. Do not create, inspect, repair, or enable a Contract Map during ordinary work; every map mode stays off the execution and completion path. Worker completion enters Review; Done requires passed acceptance criteria and review evidence. Surface existing strict-map findings for operator review without stopping work to repair them.";
+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, 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' | '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' | 'get_contract_graph' | 'configure_contract_graph' | 'upsert_contract_node' | 'link_contract_nodes' | 'remove_contract_node' | 'remove_contract_edge' | 'evaluate_contract_graph' | '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';
+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,16 +9,8 @@ export interface KanbanToolInput extends Omit<AssignKanbanTaskInput, 'status'> {
     targetBoardId?: string | undefined;
     taskIds?: string[] | undefined;
     chainId?: string | undefined;
-    contractNodeId?: string | undefined;
-    contractNodeKind?: KanbanContractNodeKind | undefined;
-    contractNodeState?: KanbanContractNodeState | undefined;
-    contractEnforcement?: KanbanContractEnforcement | undefined;
-    contractGraphEnforcement?: KanbanContractGraphEnforcement | undefined;
-    contractEdgeId?: string | undefined;
-    contractEdgeType?: KanbanContractEdgeType | undefined;
     fromNodeId?: string | undefined;
     toNodeId?: string | undefined;
-    contractRationale?: string | undefined;
     baseline?: string | number | undefined;
     threshold?: string | number | undefined;
     title?: string | undefined;
@@ -55,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;
@@ -108,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. */
@@ -143,9 +164,9 @@ export interface KanbanToolOutput {
     chain?: KanbanTask[] | undefined;
     snapshot?: KanbanOrchestrationSnapshot | undefined;
     workbench?: KanbanWorkbenchSnapshot | undefined;
-    contractGraph?: KanbanContractGraph | undefined;
-    contractEvaluation?: KanbanContractGraphEvaluation | undefined;
     taskGraph?: SerializedTaskGraph | undefined;
     markdown?: string | undefined;
+    contractGraph?: KanbanContractGraph | null | undefined;
+    contractEvaluation?: KanbanContractGraphEvaluation | undefined;
 }
 //# sourceMappingURL=kanban-tool-types.d.ts.map