@hasna/todos 0.11.74 → 0.11.81

package/dist/lib/routing-doctor.d.ts

@@ -0,0 +1,144 @@
+import type { Database } from "bun:sqlite";
+import type { Project, Task, TaskStatus } from "../types/index.js";
+export declare const TODOS_ROUTING_DOCTOR_SCHEMA_VERSION = "todos.routing_doctor.v1";
+/** Deterministic finding categories the routing doctor can emit. */
+export type RoutingFindingCategory = "null_working_dir" | "wrong_working_dir" | "null_task_list_id" | "unresolvable_task_list" | "invalid_project_path" | "missing_project" | "no_auto_conflict" | "cross_repo_intent" | "route_not_enabled";
+/**
+ * Repairability classification consumed by OpenLoops. Only `safe_auto` findings
+ * are ever mutated by `--apply`; every other class is reported for a human or a
+ * different owning repo and is never guessed at.
+ */
+export type RoutingRepairClass = "safe_auto" | "blocker_human" | "blocker_cross_repo" | "blocker_invalid_path" | "unsupported";
+export type RoutingFindingSeverity = "error" | "warn";
+export type RoutingRepairField = "working_dir" | "task_list_id";
+export interface RoutingSuggestedRepair {
+    field: RoutingRepairField;
+    from: string | null;
+    to: string;
+    /** Supported CLI invocation that performs this exact repair. */
+    command: string;
+}
+export interface RoutingFinding {
+    category: RoutingFindingCategory;
+    severity: RoutingFindingSeverity;
+    repair_class: RoutingRepairClass;
+    task_id: string;
+    task_short_id: string | null;
+    title: string;
+    status: TaskStatus;
+    project_id: string | null;
+    project_name: string | null;
+    /** Resolved owning-repo path (machine-local override honoured). */
+    project_path: string | null;
+    working_dir: string | null;
+    expected_working_dir: string | null;
+    task_list_id: string | null;
+    task_list_state: "ok" | "null" | "unresolvable";
+    route_eligible: boolean;
+    route_class: string;
+    route_reasons: string[];
+    detail: string;
+    suggested_repair: RoutingSuggestedRepair | null;
+}
+export interface RoutingRepairRecord {
+    task_id: string;
+    task_short_id: string | null;
+    category: RoutingFindingCategory;
+    field: RoutingRepairField;
+    from: string | null;
+    to: string;
+    command: string;
+    applied: boolean;
+    error?: string;
+}
+export interface RoutingDoctorSummary {
+    inspected: number;
+    eligible: number;
+    findings_total: number;
+    by_category: Record<string, number>;
+    by_repair_class: Record<string, number>;
+    safe_auto: number;
+    blockers: number;
+    unsupported: number;
+    repaired: number;
+    repair_failed: number;
+}
+export interface RoutingDoctorScope {
+    statuses: TaskStatus[];
+    project_id: string | null;
+    tag: string | null;
+    shard: {
+        index: number;
+        total: number;
+    } | null;
+    include_archived: boolean;
+    verify_project_root: boolean;
+    limit: number | null;
+}
+export interface RoutingDoctorBackup {
+    path: string;
+    files: string[];
+}
+export interface RoutingDoctorResult {
+    schema_version: typeof TODOS_ROUTING_DOCTOR_SCHEMA_VERSION;
+    generated_at: string;
+    /** True when no findings remain (post-repair when `apply` is set). */
+    ok: boolean;
+    dry_run: boolean;
+    database_path: string;
+    scope: RoutingDoctorScope;
+    summary: RoutingDoctorSummary;
+    findings: RoutingFinding[];
+    repairs: RoutingRepairRecord[];
+    backup?: RoutingDoctorBackup;
+    undo_record_path?: string;
+}
+export interface RunRoutingDoctorOptions {
+    db?: Database;
+    dbPath?: string;
+    statuses?: TaskStatus[];
+    projectId?: string;
+    tag?: string;
+    shardIndex?: number;
+    shardTotal?: number;
+    includeArchived?: boolean;
+    verifyProjectRoot?: boolean;
+    apply?: boolean;
+    actor?: string;
+    undoRecordPath?: string;
+    limit?: number;
+    now?: () => string;
+}
+/** Assign a stable shard. A task's shard key is its project (so a project never splits) else its id. */
+export declare function routingShardOf(task: Pick<Task, "id" | "project_id">, total: number): number;
+/**
+ * Conservative, heuristic cross-repo intent detector. Returns the foreign repo
+ * slug only when the title explicitly names a *different, known* `open-*` repo
+ * and does NOT also name its own repo. Never triggers an automatic repair —
+ * cross-repo findings are always reported for a human.
+ */
+export declare function detectCrossRepoIntent(task: Pick<Task, "title" | "tags">, project: Project | null, knownRepoSlugs: Set<string>): string | null;
+interface ClassifyContext {
+    task: Task;
+    project: Project | null;
+    db: Database;
+    knownRepoSlugs: Set<string>;
+    verifyProjectRoot: boolean;
+}
+/**
+ * Pure-ish classification for one task. Emits zero or more findings. Depends on
+ * `getTaskRouteState` for the authoritative eligibility/route context so the
+ * doctor and the OpenLoops drain agree on route enablement.
+ */
+export declare function classifyTaskRouting(ctx: ClassifyContext): RoutingFinding[];
+/**
+ * Supported CLI command that restores a repair's prior value. Null-origin
+ * repairs (the field was null before we set it) restore via the explicit
+ * `--clear-working-dir` / `--clear-list` reset flags — a bare `--working-dir ''`
+ * or `--list ''` is falsy in the CLI wiring and would be a silent no-op, which
+ * is exactly the fake-undo the record must never contain.
+ */
+export declare function routingRepairUndoCommand(repair: Pick<RoutingRepairRecord, "task_id" | "field" | "from">): string;
+export declare function runRoutingDoctor(options?: RunRoutingDoctorOptions): RoutingDoctorResult;
+export {};
+//# sourceMappingURL=routing-doctor.d.ts.map

package/dist/lib/routing-doctor.d.ts.map

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

package/dist/lib/shadow-status.d.ts

@@ -0,0 +1,38 @@
+import type { TodosPostgresQueryClient } from "../storage/postgres-sync.js";
+import type { TodosStorageAdapter } from "../storage/interfaces.js";
+/**
+ * Divergence report for the dual-write shadow: how many live rows exist locally
+ * versus in the remote Postgres sync tables, and how stale the last mirror is.
+ * This is the ONLY place that reads from the remote store, and it is a
+ * read-only diagnostic — never a runtime read path.
+ */
+export interface ShadowStatusObjectCount {
+    object_type: string;
+    local: number;
+    cloud: number;
+    cloud_tombstones: number;
+    diff: number;
+}
+export interface ShadowStatusReport {
+    service: string;
+    cloud_reachable: boolean;
+    in_sync: boolean;
+    objects: ShadowStatusObjectCount[];
+    totals: {
+        local: number;
+        cloud: number;
+        diff: number;
+        cloud_tombstones: number;
+    };
+    last_mirror_at: string | null;
+    last_mirror_lag_ms: number | null;
+    error: string | null;
+}
+export interface GetTodosShadowStatusOptions {
+    local: TodosStorageAdapter;
+    cloud: TodosPostgresQueryClient;
+    service?: string;
+    now?: number;
+}
+export declare function getTodosShadowStatus(options: GetTodosShadowStatusOptions): Promise<ShadowStatusReport>;
+//# sourceMappingURL=shadow-status.d.ts.map

package/dist/lib/shadow-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-status.d.ts","sourceRoot":"","sources":["../../src/lib/shadow-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AA2CD,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,EAAE,wBAAwB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,kBAAkB,CAAC,CAsE7B"}