@hasna/todos 0.11.29 → 0.11.30

package/dist/lib/github.d.ts

@@ -14,7 +14,7 @@ export declare function parseGitHubUrl(url: string): {
     repo: string;
     number: number;
 } | null;
-/** Fetch a GitHub issue using the gh CLI */
+/** 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?: {

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

@@ -1 +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,CAIlG;AAED,4CAA4C;AAC5C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAezF;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"}
+{"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/north-star.d.ts

@@ -0,0 +1,33 @@
+import type { Database } from "bun:sqlite";
+export interface NorthStarSnapshot {
+    timestamp: string;
+    active_tasks: number;
+    stale_tasks: number;
+    completion_rate_per_hour: number;
+    agents_online: AgentActivity[];
+    top_agent: string | null;
+    health: "healthy" | "degraded" | "critical";
+}
+export interface AgentActivity {
+    agent_id: string;
+    active_tasks: number;
+    last_heartbeat?: string | null;
+    completions_last_hour: number;
+}
+/**
+ * 1-minute north star loop — fires every 60s to track progress.
+ * Returns a snapshot of current system health and throughput.
+ */
+export declare function getNorthStarSnapshot(filters?: {
+    project_id?: string;
+}, db?: Database): NorthStarSnapshot;
+/**
+ * Start a recurring north star loop that logs snapshots.
+ * Returns a stop function.
+ */
+export declare function startNorthStarLoop(opts?: {
+    interval_ms?: number;
+    project_id?: string;
+    logger?: (snapshot: NorthStarSnapshot) => void;
+}): () => void;
+//# sourceMappingURL=north-star.d.ts.map

package/dist/lib/north-star.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"north-star.d.ts","sourceRoot":"","sources":["../../src/lib/north-star.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK3C,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB,EAAE,MAAM,CAAC;IACjC,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACjC,EAAE,CAAC,EAAE,QAAQ,GACZ,iBAAiB,CAoFnB;AAqBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAAE,GACnG,MAAM,IAAI,CAYZ"}

package/dist/lib/task-runner.d.ts

@@ -0,0 +1,101 @@
+import type { Database } from "bun:sqlite";
+import type { Task } from "../types/index.js";
+import { type Checkpoint, type Heartbeat } from "../db/checkpoints.js";
+export type RetryStrategy = {
+    type: "none";
+} | {
+    type: "fixed";
+    delay_ms: number;
+    max_attempts: number;
+} | {
+    type: "exponential";
+    base_ms: number;
+    max_attempts: number;
+    max_delay_ms?: number;
+} | {
+    type: "linear";
+    base_ms: number;
+    max_attempts: number;
+};
+export interface TaskRunnerOptions {
+    agent_id: string;
+    retry_strategy?: RetryStrategy;
+    heartbeat_interval_ms?: number;
+    checkpoint_on_error?: boolean;
+}
+export interface StepDefinition {
+    name: string;
+    description?: string;
+    max_attempts?: number;
+    timeout_ms?: number;
+}
+export type StepResult = {
+    status: "completed" | "failed" | "skipped";
+    data?: Record<string, unknown>;
+    error?: string;
+};
+export type StepFn = (ctx: StepContext) => Promise<StepResult> | StepResult;
+export interface StepContext {
+    task: Task;
+    agent_id: string;
+    step_name: string;
+    attempt: number;
+    data: Record<string, unknown>;
+    db: Database;
+    emitHeartbeat: (opts?: {
+        message?: string;
+        progress?: number;
+        meta?: Record<string, unknown>;
+    }) => Heartbeat;
+    checkpoint: (updates: Partial<Checkpoint>) => Checkpoint;
+}
+export declare class TaskRunner {
+    private agentId;
+    private retryStrategy;
+    private heartbeatIntervalMs;
+    private checkpointOnError;
+    private db;
+    private heartbeatTimer;
+    private _aborted;
+    private _currentStep;
+    private _stepIndex;
+    constructor(opts: TaskRunnerOptions, db?: Database);
+    abort(): void;
+    get aborted(): boolean;
+    /** Start heartbeats at regular intervals */
+    startHeartbeat(taskId: string): void;
+    stopHeartbeat(): void;
+    /** Initialize a task run: set runner metadata, create checkpoints for each step */
+    init(taskId: string, steps: StepDefinition[]): Task;
+    /** Run all steps sequentially with retry support */
+    run(taskId: string, stepFns: Map<string, StepFn>): Promise<{
+        success: boolean;
+        steps: StepResult[];
+    }>;
+    /** Mark a task run as completed in the DB */
+    complete(taskId: string): Task;
+    /** Mark a task run as failed */
+    fail(taskId: string, reason?: string): {
+        task: Task;
+    };
+    /** Get progress summary for a task */
+    progress(taskId: string): {
+        total_steps: number;
+        completed_steps: number;
+        failed_steps: number;
+        pending_steps: number;
+        last_heartbeat?: Heartbeat | null;
+    };
+    /** Get last heartbeat for a task */
+    lastHeartbeat(taskId: string): Heartbeat | null;
+    private handleStepFailure;
+    private shouldRetry;
+    private computeRetryDelay;
+    private getDefaultMaxAttempts;
+}
+/** Convenience: create a runner and claim + start a task in one call */
+export declare function runTask(taskId: string, opts: TaskRunnerOptions): {
+    runner: TaskRunner;
+    task: Task;
+};
+//# sourceMappingURL=task-runner.d.ts.map

package/dist/lib/task-runner.d.ts.map

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

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAyJA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAO9E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AA8FA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAO9E"}