@wrongstack/tools 0.281.3 → 0.282.1

package/dist/index.d.ts

@@ -1,42 +1,42 @@
-export { readTool } from './read.js';
-export { writeTool } from './write.js';
-export { editTool } from './edit.js';
-export { replaceTool } from './replace.js';
-export { globTool } from './glob.js';
-export { grepTool } from './grep.js';
-export { bashTool } from './bash.js';
 export { D as DangerAssessment, a as DangerLevel, c as configureDangerBypass, b as configureExecPolicy, d as detectDanger, e as execTool, g as getDangerBypass, f as getExecAllowlist, i as isExecCommandAllowed, r as resetDangerBypass, h as resetExecPolicy } from './exec-Ca3fnpUh.js';
+export { auditTool } from './audit.js';
+export { bashTool } from './bash.js';
+export { batchToolUseTool } from './batch-tool-use.js';
+export { OPTIONAL_TOOLS, TIER1_TOOLS, TIER2_TOOLS, TIER3_TOOLS, builtinTools } from './builtin.js';
+export { CircuitBreaker, CircuitBreakerConfig, CircuitBreakerSnapshot } from './circuit-breaker.js';
+export { C as CircuitOpenError, e as CircuitSnapshot, f as CircuitState, h as IndexCircuitBreaker, i as IndexTimeoutError, k as cancelPendingReindexes, l as codebaseIndexStats, m as codebaseIndexTool, n as codebaseSearchTool, o as codebaseStatsTool, p as enqueueReindex, q as getIndexState, r as indexCircuitBreaker, s as isIndexReady, t as isIndexableFile, u as isIndexing, v as onIndexStateChange, w as resetIndexCircuitBreaker, x as runStartupIndex, y as searchCodebaseIndex, z as shutdownCodebaseIndexHost } from './background-indexer-BeDBxfSh.js';
+import { Tool, AssignKanbanTaskInput, KanbanTaskPriority, KanbanTaskStatus, KanbanAgentRunStatus, KanbanBoard, KanbanBoardSummary, KanbanTask, KanbanSearchResult, KanbanOrchestrationSnapshot, SerializedTaskGraph, SkillLoader } from '@wrongstack/core';
+export { diffTool } from './diff.js';
+export { documentTool } from './document.js';
+export { editTool } from './edit.js';
 export { fetchTool } from './fetch.js';
-export { searchTool } from './search.js';
-export { todoTool } from './todo.js';
-import { Tool, SkillLoader } from '@wrongstack/core';
+export { formatTool } from './format.js';
 export { gitTool } from './git.js';
-export { patchTool } from './patch.js';
+export { globTool } from './glob.js';
+export { grepTool } from './grep.js';
+export { installTool } from './install.js';
 export { jsonTool } from './json.js';
-export { diffTool } from './diff.js';
-export { treeTool } from './tree.js';
 export { lintTool } from './lint.js';
-export { formatTool } from './format.js';
-export { typecheckTool } from './typecheck.js';
-export { testTool } from './test.js';
-export { installTool } from './install.js';
-export { auditTool } from './audit.js';
-export { outdatedTool } from './outdated.js';
 export { logsTool } from './logs.js';
-export { documentTool } from './document.js';
-export { scaffoldTool } from './scaffold.js';
-export { toolSearchTool } from './tool-search.js';
-export { toolUseTool } from './tool-use.js';
-export { batchToolUseTool } from './batch-tool-use.js';
-export { toolHelpTool } from './tool-help.js';
 export { forgetTool, relatedMemoryTool, rememberTool, searchMemoryTool } from './memory.js';
 export { createModeTool } from './mode.js';
+export { outdatedTool } from './outdated.js';
+export { builtinToolsPack } from './pack.js';
+export { patchTool } from './patch.js';
 import { ProcessRegistryImpl } from './process-registry.js';
 export { BreakerCountdown, KillOpts, RegistryStats, TrackedProcess, _resetProcessRegistry, getProcessRegistry } from './process-registry.js';
-export { CircuitBreaker, CircuitBreakerConfig, CircuitBreakerSnapshot } from './circuit-breaker.js';
-export { C as CircuitOpenError, e as CircuitSnapshot, f as CircuitState, h as IndexCircuitBreaker, i as IndexTimeoutError, k as cancelPendingReindexes, l as codebaseIndexStats, m as codebaseIndexTool, n as codebaseSearchTool, o as codebaseStatsTool, p as enqueueReindex, q as getIndexState, r as indexCircuitBreaker, s as isIndexReady, t as isIndexableFile, u as isIndexing, v as onIndexStateChange, w as resetIndexCircuitBreaker, x as runStartupIndex, y as searchCodebaseIndex, z as shutdownCodebaseIndexHost } from './background-indexer-BeDBxfSh.js';
-export { OPTIONAL_TOOLS, TIER1_TOOLS, TIER2_TOOLS, TIER3_TOOLS, builtinTools } from './builtin.js';
-export { builtinToolsPack } from './pack.js';
+export { readTool } from './read.js';
+export { replaceTool } from './replace.js';
+export { scaffoldTool } from './scaffold.js';
+export { searchTool } from './search.js';
+export { testTool } from './test.js';
+export { todoTool } from './todo.js';
+export { toolHelpTool } from './tool-help.js';
+export { toolSearchTool } from './tool-search.js';
+export { toolUseTool } from './tool-use.js';
+export { treeTool } from './tree.js';
+export { typecheckTool } from './typecheck.js';
+export { writeTool } from './write.js';
 import 'node:child_process';
 
 /**
@@ -148,6 +148,128 @@ interface EnsureSessionShellOptions {
  */
 declare function ensureSessionShell(opts?: EnsureSessionShellOptions): BashShell | undefined;
 
+type Overrides = Record<string, string>;
+interface DesignInput {
+    action?: 'list' | 'use' | 'foundations' | 'set' | 'materialize' | 'verify' | undefined;
+    kit?: string | undefined;
+    stack?: string | undefined;
+    /** action "set" / "use": token overrides, e.g. { primary: "oklch(...)", "dark.bg": "#111" }. */
+    set?: Overrides | undefined;
+    /** action "materialize": output path (project-relative); defaults per stack. */
+    out?: string | undefined;
+    /** action "materialize": overwrite an existing file. */
+    force?: boolean | undefined;
+    /** action "verify": explicit files to scan (project-relative). Defaults to a UI-file walk. */
+    files?: string[] | undefined;
+}
+interface DesignOutput {
+    action: string;
+    kit?: string | undefined;
+    stack?: string | undefined;
+    output: string;
+    /** action "materialize": where the theme file was (or would be) written. */
+    path?: string | undefined;
+    /** action "verify": adherence score 0..1 and violation count. */
+    score?: number | undefined;
+    violations?: number | undefined;
+}
+/**
+ * Design Studio tool — progressive disclosure + token enforcement.
+ *
+ * `list`/`use`/`foundations` browse and pin kits. `set` records structured color
+ * overrides (these win over kit tokens). `materialize` writes the active kit's
+ * (override-applied) tokens to a real, stack-appropriate theme file so the
+ * palette becomes the codebase's source of truth — not just a prompt hint.
+ * `verify` scans UI files for off-palette drift.
+ */
+declare const designTool: Tool<DesignInput, DesignOutput>;
+
+type KanbanAction = 'list_boards' | 'get_board' | 'create_board' | 'duplicate_board' | 'update_board' | 'delete_board' | 'generate_board' | 'export_markdown' | 'export_task_graph' | 'sync_task_graph' | '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' | 'move_task' | 'delete_task' | 'set_chain' | 'get_chain' | 'claim_task' | 'release_task' | 'assign_task' | 'mark_assignment' | 'add_dependency' | 'add_goal_metric' | 'update_goal_metric' | 'add_check' | 'update_check' | 'add_note' | 'add_link';
+interface KanbanToolInput extends Omit<AssignKanbanTaskInput, 'status'> {
+    action: KanbanAction;
+    boardId?: string | undefined;
+    taskId?: string | undefined;
+    columnId?: string | undefined;
+    targetBoardId?: string | undefined;
+    taskIds?: string[] | undefined;
+    chainId?: string | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    labels?: string[] | undefined;
+    priority?: KanbanTaskPriority | undefined;
+    status?: KanbanTaskStatus | undefined;
+    order?: number | undefined;
+    targetColumnId?: string | undefined;
+    moveTasksToColumnId?: string | undefined;
+    query?: string | undefined;
+    limit?: number | undefined;
+    dependencyTaskId?: string | undefined;
+    enforceDependencies?: boolean | undefined;
+    childTitles?: string[] | undefined;
+    inheritAssignment?: boolean | undefined;
+    inheritLabels?: boolean | undefined;
+    inheritSuccessCriteria?: boolean | undefined;
+    inheritGoalMetrics?: boolean | undefined;
+    inheritDependencies?: boolean | undefined;
+    chainChildren?: boolean | undefined;
+    rewireDependents?: boolean | undefined;
+    closeSourceTasks?: boolean | undefined;
+    metricId?: string | undefined;
+    metricName?: string | undefined;
+    metricTarget?: string | number | undefined;
+    metricCurrent?: string | number | undefined;
+    metricUnit?: string | undefined;
+    metricStatus?: 'pending' | 'met' | 'missed' | 'waived' | undefined;
+    metricNotes?: string | undefined;
+    checkId?: string | undefined;
+    checkDescription?: string | undefined;
+    checkStatus?: 'pending' | 'passed' | 'failed' | 'skipped' | undefined;
+    note?: string | undefined;
+    author?: string | undefined;
+    url?: string | undefined;
+    linkTitle?: string | undefined;
+    linkType?: 'issue' | 'pr' | 'doc' | 'commit' | 'design' | 'file' | 'url' | 'other' | undefined;
+    context?: string | undefined;
+    columns?: string[] | undefined;
+    generatedBy?: string | undefined;
+    includeTasks?: boolean | undefined;
+    includeCompletedTasks?: boolean | undefined;
+    preserveAssignment?: boolean | undefined;
+    preserveDependencies?: boolean | undefined;
+    subagentId?: string | undefined;
+    runTaskId?: string | undefined;
+    lastResult?: string | undefined;
+    error?: string | undefined;
+    assignmentStatus?: KanbanAgentRunStatus | undefined;
+    releaseStatus?: 'pending' | 'ready' | 'blocked' | undefined;
+    releaseReason?: string | undefined;
+    clearAssignee?: boolean | undefined;
+    taskGraph?: unknown;
+    graphId?: string | undefined;
+    specId?: string | undefined;
+    sourceSystem?: string | undefined;
+    phaseId?: string | undefined;
+    preserveOriginTaskIds?: boolean | undefined;
+    includeArchived?: boolean | undefined;
+    archiveMissingTasks?: boolean | undefined;
+    preserveManualDependencies?: boolean | undefined;
+}
+interface KanbanToolOutput {
+    ok: boolean;
+    message: string;
+    board?: KanbanBoard | undefined;
+    boards?: KanbanBoardSummary[] | undefined;
+    task?: KanbanTask | undefined;
+    tasks?: KanbanSearchResult[] | undefined;
+    children?: KanbanTask[] | undefined;
+    chain?: KanbanTask[] | undefined;
+    snapshot?: KanbanOrchestrationSnapshot | undefined;
+    taskGraph?: SerializedTaskGraph | undefined;
+    markdown?: string | undefined;
+}
+declare const kanbanTool: Tool<KanbanToolInput, KanbanToolOutput>;
+
 /**
  * `planTool` — the LLM-callable counterpart to the `/plan` slash command.
  *
@@ -201,84 +323,95 @@ interface PlanOutput {
 }
 declare const planTool: Tool<PlanInput, PlanOutput>;
 
-type Overrides = Record<string, string>;
-interface DesignInput {
-    action?: 'list' | 'use' | 'foundations' | 'set' | 'materialize' | 'verify' | undefined;
-    kit?: string | undefined;
-    stack?: string | undefined;
-    /** action "set" / "use": token overrides, e.g. { primary: "oklch(...)", "dark.bg": "#111" }. */
-    set?: Overrides | undefined;
-    /** action "materialize": output path (project-relative); defaults per stack. */
-    out?: string | undefined;
-    /** action "materialize": overwrite an existing file. */
-    force?: boolean | undefined;
-    /** action "verify": explicit files to scan (project-relative). Defaults to a UI-file walk. */
-    files?: string[] | undefined;
-}
-interface DesignOutput {
-    action: string;
-    kit?: string | undefined;
-    stack?: string | undefined;
-    output: string;
-    /** action "materialize": where the theme file was (or would be) written. */
-    path?: string | undefined;
-    /** action "verify": adherence score 0..1 and violation count. */
-    score?: number | undefined;
-    violations?: number | undefined;
-}
 /**
- * Design Studio tool — progressive disclosure + token enforcement.
+ * Process Guardian — Protects WrongStack processes from being killed via
+ * bash/kill commands. Runs as a watchdog that:
  *
- * `list`/`use`/`foundations` browse and pin kits. `set` records structured color
- * overrides (these win over kit tokens). `materialize` writes the active kit's
- * (override-applied) tokens to a real, stack-appropriate theme file so the
- * palette becomes the codebase's source of truth — not just a prompt hint.
- * `verify` scans UI files for off-palette drift.
+ * 1. Registers the main process and all children with persistent registry
+ * 2. Monitors for kill attempts against protected PIDs
+ * 3. Provides recovery mechanisms when killed processes are detected
+ * 4. Coordinates protection across multiple WrongStack instances
+ *
+ * This is NOT a security mechanism against intentional root-level kills.
+ * A user with sudo/root can still kill any process. This is a guardrail
+ * to prevent accidental kills from the WrongStack agent itself.
  */
-declare const designTool: Tool<DesignInput, DesignOutput>;
-
-interface SkillToolInput {
-    name: string;
-    /** Optional relative path of a bundled resource to load (e.g. `references/REF.md`, `scripts/extract.py`, `assets/template.html`). Omit to list resources. */
-    resource?: string | undefined;
-}
-interface SkillResource {
-    /** Path relative to the skill directory (e.g. `scripts/extract.py`). */
-    path: string;
-    bytes: number;
-}
-interface LoadedResource {
-    rel: string;
-    absPath: string;
-    content: string;
-    bytes: number;
-    truncated: boolean;
-}
-interface SkillToolOutput {
-    name: string;
-    description: string;
-    /** Frontmatter-stripped SKILL.md body (capped). */
-    body: string;
-    /** All bundled resource files (recursive), when no specific resource was requested. */
-    resources: SkillResource[];
-    /** Absolute directory of the skill — run scripts via bash using paths under here. */
-    dir: string;
-    /** When `resource` was requested: the loaded file. */
-    loadedResource?: LoadedResource | undefined;
+interface ProcessGuardianConfig {
+    /** Interval for heartbeat in ms */
+    heartbeatIntervalMs?: number;
+    /** Enable automatic process resurrection */
+    autoResurrect?: boolean;
+    /** Maximum resurrection attempts */
+    maxResurrectionAttempts?: number;
+    /** Custom protection patterns */
+    protectedPatterns?: string[];
 }
 /**
- * Skill tool — the agentskills.io progressive-disclosure primitive.
- *
- * - `skill({ name })` → SKILL.md body + a recursive listing of every bundled
- *   resource file (scripts/ references/ assets/ templates/ … any subdir).
- * - `skill({ name, resource })` → the content of that one resource file.
- *
- * Use this (not the `read` tool) to load skill resources: it works for foreign
- * skills that live outside the project root (e.g. `~/.claude/skills/…`), which
- * a project-root-restricted `read` tool may refuse. Scripts are returned with
- * their absolute path so the agent can run them via `bash`.
+ * Process Guardian watches over WrongStack processes and prevents accidental kills.
  */
-declare function makeSkillTool(skillLoader: SkillLoader): Tool<SkillToolInput, SkillToolOutput>;
+declare class ProcessGuardian {
+    private readonly registry;
+    private readonly config;
+    private readonly protectedProcesses;
+    private heartbeatTimer;
+    private isRunning;
+    private instanceId;
+    constructor(config?: ProcessGuardianConfig);
+    /**
+     * Start the guardian - begins monitoring and registration.
+     */
+    start(): void;
+    /**
+     * Stop the guardian gracefully.
+     */
+    stop(): void;
+    /**
+     * Register a process with the guardian.
+     */
+    registerProcess(pid: number, name: string): void;
+    /**
+     * Unregister a process (e.g., when it exits normally).
+     */
+    unregisterProcess(pid: number): void;
+    /**
+     * Register all child processes that already exist.
+     */
+    private registerExistingChildren;
+    /**
+     * Sync protected processes with the base ProcessRegistry.
+     */
+    private syncWithProcessRegistry;
+    /**
+     * Heartbeat - updates timestamps and checks for anomalies.
+     */
+    private heartbeat;
+    /**
+     * Set up process-level event handlers.
+     */
+    private setupProcessHandlers;
+    /**
+     * Check if a PID is protected by this guardian.
+     */
+    isProtected(pid: number): boolean;
+    /**
+     * Get all PIDs protected by this guardian.
+     */
+    getProtectedPids(): number[];
+    /**
+     * Get status information for monitoring.
+     */
+    getStatus(): {
+        instanceId: string;
+        mainPid: number;
+        protectedCount: number;
+        platform: string;
+        hostname: string;
+        uptime: number;
+    };
+}
+declare function getProcessGuardian(): ProcessGuardian;
+declare function startProcessGuardian(config?: ProcessGuardianConfig): ProcessGuardian;
+declare function stopProcessGuardian(): void;
 
 /**
  * PersistentProcessRegistry — filesystem-backed process registry that survives
@@ -401,96 +534,6 @@ declare class PersistentProcessRegistry {
 declare function getPersistentProcessRegistry(): PersistentProcessRegistry;
 declare function resetPersistentProcessRegistry(): void;
 
-/**
- * Process Guardian — Protects WrongStack processes from being killed via
- * bash/kill commands. Runs as a watchdog that:
- *
- * 1. Registers the main process and all children with persistent registry
- * 2. Monitors for kill attempts against protected PIDs
- * 3. Provides recovery mechanisms when killed processes are detected
- * 4. Coordinates protection across multiple WrongStack instances
- *
- * This is NOT a security mechanism against intentional root-level kills.
- * A user with sudo/root can still kill any process. This is a guardrail
- * to prevent accidental kills from the WrongStack agent itself.
- */
-interface ProcessGuardianConfig {
-    /** Interval for heartbeat in ms */
-    heartbeatIntervalMs?: number;
-    /** Enable automatic process resurrection */
-    autoResurrect?: boolean;
-    /** Maximum resurrection attempts */
-    maxResurrectionAttempts?: number;
-    /** Custom protection patterns */
-    protectedPatterns?: string[];
-}
-/**
- * Process Guardian watches over WrongStack processes and prevents accidental kills.
- */
-declare class ProcessGuardian {
-    private readonly registry;
-    private readonly config;
-    private readonly protectedProcesses;
-    private heartbeatTimer;
-    private isRunning;
-    private instanceId;
-    constructor(config?: ProcessGuardianConfig);
-    /**
-     * Start the guardian - begins monitoring and registration.
-     */
-    start(): void;
-    /**
-     * Stop the guardian gracefully.
-     */
-    stop(): void;
-    /**
-     * Register a process with the guardian.
-     */
-    registerProcess(pid: number, name: string): void;
-    /**
-     * Unregister a process (e.g., when it exits normally).
-     */
-    unregisterProcess(pid: number): void;
-    /**
-     * Register all child processes that already exist.
-     */
-    private registerExistingChildren;
-    /**
-     * Sync protected processes with the base ProcessRegistry.
-     */
-    private syncWithProcessRegistry;
-    /**
-     * Heartbeat - updates timestamps and checks for anomalies.
-     */
-    private heartbeat;
-    /**
-     * Set up process-level event handlers.
-     */
-    private setupProcessHandlers;
-    /**
-     * Check if a PID is protected by this guardian.
-     */
-    isProtected(pid: number): boolean;
-    /**
-     * Get all PIDs protected by this guardian.
-     */
-    getProtectedPids(): number[];
-    /**
-     * Get status information for monitoring.
-     */
-    getStatus(): {
-        instanceId: string;
-        mainPid: number;
-        protectedCount: number;
-        platform: string;
-        hostname: string;
-        uptime: number;
-    };
-}
-declare function getProcessGuardian(): ProcessGuardian;
-declare function startProcessGuardian(config?: ProcessGuardianConfig): ProcessGuardian;
-declare function stopProcessGuardian(): void;
-
 /**
  * Global Process Registry - Cross-Instance Process Tracking
  *
@@ -593,6 +636,49 @@ declare function createGlobalPsSlashCommand(): {
     }>;
 };
 
+interface SkillToolInput {
+    name: string;
+    /** Optional relative path of a bundled resource to load (e.g. `references/REF.md`, `scripts/extract.py`, `assets/template.html`). Omit to list resources. */
+    resource?: string | undefined;
+}
+interface SkillResource {
+    /** Path relative to the skill directory (e.g. `scripts/extract.py`). */
+    path: string;
+    bytes: number;
+}
+interface LoadedResource {
+    rel: string;
+    absPath: string;
+    content: string;
+    bytes: number;
+    truncated: boolean;
+}
+interface SkillToolOutput {
+    name: string;
+    description: string;
+    /** Frontmatter-stripped SKILL.md body (capped). */
+    body: string;
+    /** All bundled resource files (recursive), when no specific resource was requested. */
+    resources: SkillResource[];
+    /** Absolute directory of the skill — run scripts via bash using paths under here. */
+    dir: string;
+    /** When `resource` was requested: the loaded file. */
+    loadedResource?: LoadedResource | undefined;
+}
+/**
+ * Skill tool — the agentskills.io progressive-disclosure primitive.
+ *
+ * - `skill({ name })` → SKILL.md body + a recursive listing of every bundled
+ *   resource file (scripts/ references/ assets/ templates/ … any subdir).
+ * - `skill({ name, resource })` → the content of that one resource file.
+ *
+ * Use this (not the `read` tool) to load skill resources: it works for foreign
+ * skills that live outside the project root (e.g. `~/.claude/skills/…`), which
+ * a project-root-restricted `read` tool may refuse. Scripts are returned with
+ * their absolute path so the agent can run them via `bash`.
+ */
+declare function makeSkillTool(skillLoader: SkillLoader): Tool<SkillToolInput, SkillToolOutput>;
+
 /**
  * Shared tool icon mapping for all WrongStack UIs (WebUI, TUI, REPL).
  *
@@ -638,4 +724,4 @@ declare const TOOL_ICON_CONFIG: Record<ToolIconId, ToolIconConfig>;
  */
 declare const FALLBACK_ICON: ToolIconId;
 
-export { type BashShell, type EnsureSessionShellOptions, FALLBACK_ICON, type GlobalProcessStatus, type InstanceInfo, type InstanceListOptions, type PersistentProcessEntry, type PersistentRegistryData, type ProcessGuardianConfig, ProcessRegistryImpl, type ResolveSessionShellDeps, TOOL_ICON_CONFIG, TOOL_ICON_MAP, type ToolIconConfig, type ToolIconId, createGlobalPsSlashCommand, designTool, ensureSessionShell, formatGlobalStatus, formatInstanceList, formatInstanceSummary, getInstanceCount, getPersistentProcessRegistry, getProcessGuardian, getToolIcon, listInstances, makeSkillTool, normalizeShell, planTool, resetPersistentProcessRegistry, resolveSessionShell, startProcessGuardian, stopProcessGuardian };
+export { type BashShell, type EnsureSessionShellOptions, FALLBACK_ICON, type GlobalProcessStatus, type InstanceInfo, type InstanceListOptions, type PersistentProcessEntry, type PersistentRegistryData, type ProcessGuardianConfig, ProcessRegistryImpl, type ResolveSessionShellDeps, TOOL_ICON_CONFIG, TOOL_ICON_MAP, type ToolIconConfig, type ToolIconId, createGlobalPsSlashCommand, designTool, ensureSessionShell, formatGlobalStatus, formatInstanceList, formatInstanceSummary, getInstanceCount, getPersistentProcessRegistry, getProcessGuardian, getToolIcon, kanbanTool, listInstances, makeSkillTool, normalizeShell, planTool, resetPersistentProcessRegistry, resolveSessionShell, startProcessGuardian, stopProcessGuardian };