@hasna/todos 0.11.49 → 0.11.50

package/dist/lib/external-issue-importers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-issue-importers.d.ts","sourceRoot":"","sources":["../../src/lib/external-issue-importers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAGnF,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,CAAC,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;QACvC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;IACF,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,gBAAgB,EAAE,0BAA0B,EAAE,CAAC;IAC/C,oBAAoB,EAAE,sBAAsB,EAAE,CAAC;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAoYD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,wBAAwB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,yBAAyB,CAsG9G"}

package/dist/lib/extract.d.ts

@@ -0,0 +1,108 @@
+import type { Task, TaskPriority } from "../types/index.js";
+import type { Database } from "bun:sqlite";
+export declare const EXTRACT_TAGS: readonly ["TODO", "FIXME", "HACK", "XXX", "BUG", "NOTE"];
+export type ExtractTag = (typeof EXTRACT_TAGS)[number];
+export interface ExtractedComment {
+    tag: ExtractTag;
+    message: string;
+    file: string;
+    line: number;
+    /** Full line content from the source file */
+    raw: string;
+    /** Stable fingerprint used to dedupe across line moves */
+    fingerprint: string;
+    /** Nearest enclosing or preceding symbol, when recognized locally */
+    symbol?: string;
+    symbol_kind?: SourceSymbolKind;
+}
+export type SourceSymbolKind = "function" | "class" | "interface" | "type" | "variable" | "method";
+export interface SourceSymbol {
+    name: string;
+    kind: SourceSymbolKind;
+    file: string;
+    line: number;
+    raw: string;
+}
+export interface SourceIndexFile {
+    file: string;
+    checksum: string;
+    symbols: SourceSymbol[];
+    comments: ExtractedComment[];
+}
+export interface CodebaseIndex {
+    root: string;
+    generated_at: string;
+    files: SourceIndexFile[];
+    total_comments: number;
+    total_symbols: number;
+    respects_gitignore: boolean;
+    excludes: string[];
+}
+export interface ExtractOptions {
+    /** Directory or file to scan */
+    path: string;
+    /** Comment tags to look for (default: all) */
+    patterns?: ExtractTag[];
+    /** Project ID to assign tasks to */
+    project_id?: string;
+    /** Task list ID */
+    task_list_id?: string;
+    /** Extra tags to add to created tasks */
+    tags?: string[];
+    /** Agent to assign tasks to */
+    assigned_to?: string;
+    /** Agent ID performing the extraction */
+    agent_id?: string;
+    /** If true, return extracted comments without creating tasks */
+    dry_run?: boolean;
+    /** File extensions to scan (default: common code extensions) */
+    extensions?: string[];
+    /** Extra glob-ish path patterns to exclude */
+    exclude?: string[];
+    /** Respect .gitignore files from the scanned root (default true) */
+    respect_gitignore?: boolean;
+    /** Include a local codebase index in the result */
+    include_index?: boolean;
+}
+export interface ExtractResult {
+    /** All comments found */
+    comments: ExtractedComment[];
+    /** Tasks created (empty if dry_run) */
+    tasks: Task[];
+    /** Number of duplicates skipped */
+    skipped: number;
+    /** Local codebase index, when requested */
+    index?: CodebaseIndex;
+}
+export interface WatchSourceTodosOptions extends ExtractOptions {
+    /** Poll interval for repeated local scans */
+    interval_ms?: number;
+    /** Run a single scan and return */
+    once?: boolean;
+    /** Maximum scans before returning. Defaults to 1 when once=true, otherwise Infinity. */
+    max_runs?: number;
+}
+export interface SourceTodoWatchRun {
+    run: number;
+    scanned_at: string;
+    changed_files: string[];
+    result: ExtractResult;
+}
+export interface SourceTodoWatchResult {
+    root: string;
+    interval_ms: number;
+    runs: SourceTodoWatchRun[];
+}
+/** Priority mapping from comment tag */
+export declare function tagToPriority(tag: ExtractTag): TaskPriority;
+/**
+ * Extract TODO-style comments from a single file's contents.
+ */
+export declare function extractFromSource(source: string, filePath: string, tags?: ExtractTag[]): ExtractedComment[];
+export declare function buildCodebaseIndex(options: ExtractOptions): CodebaseIndex;
+/**
+ * Scan a directory or file for TODO-style comments and optionally create tasks.
+ */
+export declare function extractTodos(options: ExtractOptions, db?: Database): ExtractResult;
+export declare function watchSourceTodos(options: WatchSourceTodosOptions, onRun?: (run: SourceTodoWatchRun) => void | Promise<void>): Promise<SourceTodoWatchResult>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/lib/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/lib/extract.ts"],"names":[],"mappings":"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"}

package/dist/lib/failure-triage.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Local failure triage and retry playbooks for tasks, plans, and runs.
+ */
+import type { Database } from "bun:sqlite";
+import { retryAgentRun } from "./agent-run-dispatcher.js";
+import type { Task } from "../types/index.js";
+export declare const FAILURE_TRIAGE_SCHEMA = "todos.failure_triage.v1";
+export declare const FAILURE_CLASSES: readonly ["command_failure", "verification_failure", "timeout", "dependency_blocked", "resource_error", "unknown"];
+export type FailureClass = (typeof FAILURE_CLASSES)[number];
+export interface FailureTriageItem {
+    entity_type: "task" | "run" | "verification" | "agent_run";
+    entity_id: string;
+    title: string;
+    classification: FailureClass;
+    reason: string;
+    retry_count: number;
+    max_retries: number;
+    can_retry: boolean;
+    playbook: string[];
+}
+export interface FailureTriageReport {
+    schema_version: typeof FAILURE_TRIAGE_SCHEMA;
+    generated_at: string;
+    project_id: string | null;
+    plan_id: string | null;
+    items: FailureTriageItem[];
+    summary: {
+        total: number;
+        retriable: number;
+        exhausted: number;
+        by_class: Record<FailureClass, number>;
+    };
+}
+export interface ApplyFailureTriageInput {
+    task_id?: string;
+    run_record_id?: string;
+    agent_run_id?: string;
+    root_cause?: string;
+    action?: "annotate" | "retry" | "reopen" | "split" | "escalate";
+    agent_id?: string;
+    split_title?: string;
+    max_retries?: number;
+}
+export interface ApplyFailureTriageResult {
+    schema_version: typeof FAILURE_TRIAGE_SCHEMA;
+    action: string;
+    classification: FailureClass;
+    playbook: string[];
+    task?: Task;
+    retry_task?: Task;
+    comment_id?: string;
+    follow_up_task?: Task;
+    agent_run?: ReturnType<typeof retryAgentRun>;
+    escalated: boolean;
+}
+export declare function buildFailureTriageReport(filter?: {
+    project_id?: string;
+    plan_id?: string;
+    limit?: number;
+}, db?: Database): FailureTriageReport;
+export declare function applyFailureTriage(input: ApplyFailureTriageInput, db?: Database): ApplyFailureTriageResult;
+export declare function formatFailureTriageMarkdown(report: FailureTriageReport): string;
+export declare function getFailureTriageDocs(): string;
+//# sourceMappingURL=failure-triage.d.ts.map

package/dist/lib/failure-triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-triage.d.ts","sourceRoot":"","sources":["../../src/lib/failure-triage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C,OAAO,EAAiB,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,eAAO,MAAM,eAAe,oHAOlB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,YAAY,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,OAAO,qBAAqB,CAAC;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,OAAO,qBAAqB,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,YAAY,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IAC7C,SAAS,EAAE,OAAO,CAAC;CACpB;AAiGD,wBAAgB,wBAAwB,CACtC,MAAM,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EACtE,EAAE,CAAC,EAAE,QAAQ,GACZ,mBAAmB,CA8FrB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,wBAAwB,CAyF1G;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAqB/E;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C"}

package/dist/lib/feature-manifest.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Local feature/capability manifest — CLI commands, MCP tools, profiles, env vars.
+ * Fully local; no network required for discovery.
+ */
+import { type CliCommandGroup, type EnvVarRef } from "./cli-reference.js";
+import { type AccessProfile, type AccessProfileMeta } from "./access-profiles.js";
+export declare const FEATURE_MANIFEST_SCHEMA = "todos.feature_manifest.v1";
+export interface FeatureArea {
+    id: string;
+    name: string;
+    description: string;
+    surfaces: Array<"cli" | "mcp" | "sdk">;
+    cli_commands: string[];
+    mcp_tools: string[];
+}
+export interface McpToolGroup {
+    id: string;
+    name: string;
+    description: string;
+    tools: string[];
+}
+export interface FeatureManifest {
+    schema_version: typeof FEATURE_MANIFEST_SCHEMA;
+    generated_at: string;
+    local_only: true;
+    active_profile: AccessProfile;
+    cli: {
+        command_groups: CliCommandGroup[];
+        top_level_commands: string[];
+        nested_subcommands: Record<string, string[]>;
+        command_count: number;
+    };
+    mcp: {
+        tool_groups: McpToolGroup[];
+        total_tools: number;
+        tools_for_profile: string[];
+        tools_for_profile_count: number;
+    };
+    profiles: AccessProfileMeta[];
+    env_vars: EnvVarRef[];
+    feature_areas: FeatureArea[];
+    summary: {
+        feature_area_count: number;
+        cli_command_count: number;
+        mcp_tool_count: number;
+        profile_count: number;
+        env_var_count: number;
+    };
+}
+export type CapabilityKind = "feature_area" | "cli_command" | "mcp_tool" | "profile" | "env_var";
+export interface CapabilityMatch {
+    kind: CapabilityKind;
+    id: string;
+    name: string;
+    description: string;
+    surface: "cli" | "mcp" | "config" | "meta";
+    group?: string;
+}
+export interface CapabilityDiscovery {
+    schema_version: typeof FEATURE_MANIFEST_SCHEMA;
+    generated_at: string;
+    query: string | null;
+    surface: "all" | "cli" | "mcp";
+    matches: CapabilityMatch[];
+    feature_areas: FeatureArea[];
+    totals: {
+        cli: number;
+        mcp: number;
+        areas: number;
+        profiles: number;
+        env_vars: number;
+        matched: number;
+    };
+}
+export interface BuildFeatureManifestOptions {
+    profile?: AccessProfile;
+    generated_at?: string;
+}
+export interface GetCapabilityDiscoveryOptions {
+    query?: string;
+    surface?: "all" | "cli" | "mcp";
+    profile?: AccessProfile;
+    generated_at?: string;
+    limit?: number;
+}
+/** Canonical sorted MCP tool names registered in src/mcp/tools. */
+export declare const ALL_MCP_TOOLS: string[];
+export declare const FEATURE_AREAS: FeatureArea[];
+export declare function listMcpToolNames(): string[];
+export declare function categorizeMcpTool(tool: string): string;
+export declare function buildMcpToolGroups(tools?: string[]): McpToolGroup[];
+export declare function buildFeatureManifest(options?: BuildFeatureManifestOptions): FeatureManifest;
+export declare function getCapabilityDiscovery(options?: GetCapabilityDiscoveryOptions): CapabilityDiscovery;
+export declare function normalizeFeatureManifest(manifest: FeatureManifest, generatedAt?: string): Record<string, unknown>;
+export declare function formatFeatureManifestReport(manifest: FeatureManifest, options?: {
+    deterministic?: boolean;
+}): string;
+export declare function getFeatureManifestDocs(): string;
+export declare function validateFeatureManifest(manifest: FeatureManifest): string[];
+//# sourceMappingURL=feature-manifest.d.ts.map

package/dist/lib/feature-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-manifest.d.ts","sourceRoot":"","sources":["../../src/lib/feature-manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,OAAO,uBAAuB,CAAC;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,IAAI,CAAC;IACjB,cAAc,EAAE,aAAa,CAAC;IAC9B,GAAG,EAAE;QACH,cAAc,EAAE,eAAe,EAAE,CAAC;QAClC,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,GAAG,EAAE;QACH,WAAW,EAAE,YAAY,EAAE,CAAC;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,uBAAuB,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,OAAO,EAAE;QACP,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,OAAO,uBAAuB,CAAC;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC/B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,eAAO,MAAM,aAAa,UAsUzB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAAW,EAiDtC,CAAC;AA+FF,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,MAAM,EAAuB,GAAG,YAAY,EAAE,CAwBvF;AA0BD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,eAAe,CAkC/F;AAMD,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,6BAAkC,GAAG,mBAAmB,CAsGvG;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,eAAe,EACzB,WAAW,SAA6B,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,MAAM,CAgCR;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAmC/C;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE,CAqB3E"}

package/dist/lib/gatherer.d.ts

@@ -0,0 +1,16 @@
+type GatherTrainingDataFn = (options?: {
+    limit?: number;
+    since?: Date;
+}) => Promise<{
+    source: string;
+    examples: Array<{
+        messages: Array<{
+            role: "system" | "user" | "assistant";
+            content: string;
+        }>;
+    }>;
+    count: number;
+}>;
+export declare const gatherTrainingData: GatherTrainingDataFn;
+export {};
+//# sourceMappingURL=gatherer.d.ts.map

package/dist/lib/gatherer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatherer.d.ts","sourceRoot":"","sources":["../../src/lib/gatherer.ts"],"names":[],"mappings":"AAMA,KAAK,oBAAoB,GAAG,CAAC,OAAO,CAAC,EAAE;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;CACd,KAAK,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC;QACd,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7E,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AA8EH,eAAO,MAAM,kBAAkB,EAAE,oBAoDhC,CAAC"}

package/dist/lib/git-traceability.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Git traceability — capture branch, commit, changed files, PR URLs, CI snapshots locally.
+ */
+import type { Database } from "bun:sqlite";
+import { getTaskTraceability, type CiSnapshot, type TaskCommit, type TaskTraceabilityReport } from "../db/task-commits.js";
+export declare const GIT_TRACEABILITY_SCHEMA_VERSION = "todos.git_traceability.v1";
+export interface GitCommitInfo {
+    sha: string;
+    message: string;
+    author: string;
+    committed_at: string;
+    files_changed: string[];
+    branch: string | null;
+    repo_path: string | null;
+}
+export interface LinkGitTraceInput {
+    task_id: string;
+    sha?: string;
+    branch?: string;
+    pr_url?: string;
+    pr_number?: number;
+    pr_state?: string;
+    release_tag?: string;
+    ci_snapshot_path?: string;
+    ci_snapshot?: CiSnapshot;
+    cwd?: string;
+    traceability?: Record<string, unknown>;
+}
+export declare function resolveGitRoot(cwd?: string): string | null;
+export declare function getCurrentBranch(cwd?: string): string | null;
+export declare function getHeadSha(cwd?: string): string | null;
+export declare function inspectGitCommit(sha: string, cwd?: string): GitCommitInfo | null;
+export declare function loadCiSnapshot(path?: string): CiSnapshot | null;
+/** Try gh CLI for PR info on current branch (local gh auth, no hosted todos API). */
+export declare function detectPrForBranch(branch: string, cwd?: string): {
+    pr_url: string;
+    pr_number: number;
+    pr_state: string;
+} | null;
+export declare function linkTaskGitTrace(input: LinkGitTraceInput, db?: Database): TaskCommit;
+export declare function formatTraceabilityReport(report: TaskTraceabilityReport): string;
+export { getTaskTraceability };
+//# sourceMappingURL=git-traceability.d.ts.map

package/dist/lib/git-traceability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-traceability.d.ts","sourceRoot":"","sources":["../../src/lib/git-traceability.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAEL,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,+BAA+B,8BAA8B,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAQD,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5D;AAED,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqBhF;AAED,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAS/D;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAe9H;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,UAAU,CA2CpF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CA4B/E;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/lib/github.d.ts

@@ -0,0 +1,25 @@
+import type { CreateTaskInput } from "../types/index.js";
+export interface GitHubIssue {
+    number: number;
+    title: string;
+    body: string | null;
+    labels: string[];
+    state: string;
+    assignee: string | null;
+    url: string;
+}
+/** Parse a GitHub issue URL into owner/repo/number */
+export declare function parseGitHubUrl(url: string): {
+    owner: string;
+    repo: string;
+    number: number;
+} | null;
+/** Fetch a GitHub issue using the gh CLI with safe argument passing */
+export declare function fetchGitHubIssue(owner: string, repo: string, number: number): GitHubIssue;
+/** Convert a GitHub issue to a CreateTaskInput */
+export declare function issueToTask(issue: GitHubIssue, opts?: {
+    project_id?: string;
+    task_list_id?: string;
+    agent_id?: string;
+}): CreateTaskInput;
+//# sourceMappingURL=github.d.ts.map

package/dist/lib/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/lib/github.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKlG;AAOD,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAoBzF;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAuBzI"}

package/dist/lib/goal-workflow.d.ts

@@ -0,0 +1,86 @@
+/**
+ * /goal-style workflow: translate a goal into a plan + tasks, claim steps,
+ * track progress, and produce deterministic handoffs — local-only, no hosted calls.
+ */
+import type { Database } from "bun:sqlite";
+import type { Task, TaskPriority } from "../types/index.js";
+export declare const GOAL_WORKFLOW_VERSION = "todos.goal-workflow.v1";
+export interface GoalStep {
+    title: string;
+    description?: string;
+    priority?: TaskPriority;
+    estimated_minutes?: number;
+    tags?: string[];
+}
+export interface GoalInput {
+    goal: string;
+    project_id?: string;
+    task_list_id?: string;
+    agent_id?: string;
+    steps?: GoalStep[];
+    /** Chain steps sequentially with dependencies (default true) */
+    sequential?: boolean;
+}
+export interface GoalManifest {
+    schema_version: typeof GOAL_WORKFLOW_VERSION;
+    goal: string;
+    plan_id: string;
+    plan_name: string;
+    root_task_id: string;
+    step_task_ids: string[];
+    project_id: string | null;
+    agent_id: string | null;
+    created_at: string;
+}
+export interface GoalProgress {
+    plan_id: string;
+    goal: string;
+    total_steps: number;
+    pending: number;
+    in_progress: number;
+    completed: number;
+    failed: number;
+    current_step: Task | null;
+    steps: Array<{
+        id: string;
+        title: string;
+        status: string;
+        short_id: string | null;
+    }>;
+}
+export interface ParsedGoalCommand {
+    action: "execute" | "status" | "handoff" | "create" | "unknown";
+    target: string;
+    raw: string;
+}
+/** Command recipes for Codex, Claude Code, Takumi, and MCP agents */
+export declare const GOAL_COMMAND_RECIPES: readonly [{
+    readonly host: "codex|claude-code|takumi|mcp";
+    readonly command: "/goal execute <plan-name>";
+    readonly description: "Claim and start the next ready step for a goal plan";
+    readonly equivalent_cli: "todos goal execute <plan-name> --agent <name>";
+}, {
+    readonly host: "codex|claude-code|takumi|mcp";
+    readonly command: "/goal create \"<goal text>\" --steps step1,step2,step3";
+    readonly description: "Create a plan and decompose into sequential tasks";
+    readonly equivalent_cli: "todos goal create \"<goal>\" --step \"step1\" --step \"step2\"";
+}, {
+    readonly host: "codex|claude-code|takumi|mcp";
+    readonly command: "/goal status <plan-name>";
+    readonly description: "Show plan progress and current step";
+    readonly equivalent_cli: "todos goal status <plan-name>";
+}, {
+    readonly host: "codex|claude-code|takumi|mcp";
+    readonly command: "/goal handoff <plan-name>";
+    readonly description: "Produce JSON/Markdown handoff packet for session transfer";
+    readonly equivalent_cli: "todos goal handoff <plan-name> --format md";
+}];
+export declare function parseGoalCommand(command: string): ParsedGoalCommand;
+export declare function resolvePlanId(planRef: string, db?: Database): string | null;
+export declare function createGoalWorkflow(input: GoalInput, db?: Database): GoalManifest;
+export declare function getGoalProgress(planRef: string, db?: Database): GoalProgress | null;
+export declare function claimGoalStep(planRef: string, agentId: string, db?: Database): Task | null;
+export declare function logGoalProgress(taskId: string, message: string, agentId?: string, pctComplete?: number, db?: Database): void;
+export declare function formatGoalHandoff(planRef: string, format?: "json" | "markdown", agentId?: string, db?: Database): string | null;
+export declare function getGoalCommandRecipesMarkdown(): string;
+//# sourceMappingURL=goal-workflow.d.ts.map

package/dist/lib/goal-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-workflow.d.ts","sourceRoot":"","sources":["../../src/lib/goal-workflow.ts"],"names":[],"mappings":"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"}

package/dist/lib/handoff-packets.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Agent handoff packets — offline summaries of goal/project state, tasks,
+ * blockers, comments, verification, and next actions. Portable local export.
+ */
+import type { Database } from "bun:sqlite";
+import { type Handoff } from "../db/handoffs.js";
+export declare const HANDOFF_PACKET_SCHEMA = "todos.handoff_packet.v1";
+export interface HandoffPacketContext {
+    project: {
+        id: string;
+        name: string;
+        path: string;
+    } | null;
+    plan: {
+        id: string;
+        name: string;
+        status: string;
+        percent_complete?: number;
+    } | null;
+    goal_summary: string | null;
+}
+export interface HandoffTaskSummary {
+    id: string;
+    short_id: string | null;
+    title: string;
+    status: string;
+    priority: string;
+    assigned_to: string | null;
+}
+export interface HandoffCommentSummary {
+    task_id: string;
+    content: string;
+    created_at: string;
+    agent_id: string | null;
+}
+export interface HandoffVerificationSummary {
+    task_id: string | null;
+    status: string;
+    summary: string;
+    confidence: number | null;
+}
+export interface HandoffPacket {
+    schema_version: typeof HANDOFF_PACKET_SCHEMA;
+    id: string | null;
+    agent_id: string | null;
+    created_at: string;
+    context: HandoffPacketContext;
+    active_tasks: HandoffTaskSummary[];
+    blocked_tasks: HandoffTaskSummary[];
+    dependencies_note: string | null;
+    recent_comments: HandoffCommentSummary[];
+    changed_files: string[];
+    verification: HandoffVerificationSummary[];
+    next_suggested_action: string | null;
+    completed: string[];
+    in_progress: string[];
+    blockers: string[];
+    next_steps: string[];
+    summary: string;
+}
+export interface BuildHandoffPacketInput {
+    agent_id?: string;
+    project_id?: string;
+    plan_id?: string;
+    task_id?: string;
+    include_files?: boolean;
+}
+export declare function buildHandoffPacket(input?: BuildHandoffPacketInput, db?: Database): HandoffPacket;
+export declare function createHandoffPacket(input?: BuildHandoffPacketInput, db?: Database): HandoffPacket;
+export declare function formatHandoffPacket(packet: HandoffPacket, format?: "json" | "markdown"): string;
+export declare function exportHandoffPacket(input?: BuildHandoffPacketInput, path?: string, db?: Database): HandoffPacket;
+export declare function getStoredHandoffAsPacket(handoff: Handoff, db?: Database): HandoffPacket;
+export declare function getLatestHandoffPacket(agentId?: string, projectId?: string, db?: Database): HandoffPacket | null;
+//# sourceMappingURL=handoff-packets.d.ts.map

package/dist/lib/handoff-packets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-packets.d.ts","sourceRoot":"","sources":["../../src/lib/handoff-packets.ts"],"names":[],"mappings":"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"}

package/dist/lib/headless-boundaries.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Headless agent-native boundary definitions for @hasna/todos.
+ * OSS stays local-first: CLI/MCP/SDK are primary; the optional local dashboard
+ * may mutate via localhost API only — never hosted auth or platform-todos APIs.
+ */
+export declare const HEADLESS_BOUNDARY_VERSION = "todos.headless-boundary.v1";
+export interface HeadlessBoundaryManifest {
+    schema_version: typeof HEADLESS_BOUNDARY_VERSION;
+    agent_native: true;
+    hosted_auth: false;
+    hosted_mutation: false;
+    browser_mutations: "local_admin_only";
+    primary_surfaces: ["cli", "mcp", "sdk"];
+    optional_surfaces: ["local_dashboard"];
+    local_api_only: true;
+    forbidden_remote_hosts: string[];
+    notes: string[];
+}
+export declare const FORBIDDEN_HOSTED_HOSTS: readonly ["todos.md", "www.todos.md", "preview.todos.md", "pay.hasna.tools", "platform-todos"];
+export declare const FORBIDDEN_WEB_PATTERNS: Array<{
+    name: string;
+    pattern: RegExp;
+}>;
+/** Returns true when URL targets the local todos serve API (same machine). */
+export declare function isAllowedLocalApiUrl(urlString: string, port?: number): boolean;
+/** Throws if an outbound URL targets a forbidden hosted/platform surface. */
+export declare function assertHeadlessOutboundUrl(urlString: string): void;
+export declare function scanSourceForForbiddenWebPatterns(label: string, source: string): string[];
+export declare function getHeadlessBoundaryManifest(): HeadlessBoundaryManifest;
+//# sourceMappingURL=headless-boundaries.d.ts.map

package/dist/lib/headless-boundaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-boundaries.d.ts","sourceRoot":"","sources":["../../src/lib/headless-boundaries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,yBAAyB,+BAA+B,CAAC;AAEtE,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,OAAO,yBAAyB,CAAC;IACjD,YAAY,EAAE,IAAI,CAAC;IACnB,WAAW,EAAE,KAAK,CAAC;IACnB,eAAe,EAAE,KAAK,CAAC;IACvB,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACxC,iBAAiB,EAAE,CAAC,iBAAiB,CAAC,CAAC;IACvC,cAAc,EAAE,IAAI,CAAC;IACrB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,sBAAsB,gGAMzB,CAAC;AAEX,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAM3E,CAAC;AAIF,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,SAAQ,GAAG,OAAO,CAS7E;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAWjE;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAOzF;AAED,wBAAgB,2BAA2B,IAAI,wBAAwB,CAiBtE"}