@hasna/todos 0.13.7 → 0.13.8

package/dist/lib/assignee-validation.d.ts

@@ -0,0 +1,72 @@
+/** The subset of an agent row this validator needs. */
+export interface KnownAgent {
+    id: string;
+    name: string;
+}
+export interface AssigneeContext {
+    /** Every agent row known to the store. */
+    agents: KnownAgent[];
+    /** Roster seat slugs, normalised. See {@link loadSeatSlugs}. */
+    seats: Set<string>;
+    /** Caller passed `--assign-seat`: filing at a seat is deliberate. */
+    allowSeat?: boolean;
+}
+/**
+ * Three outcomes, and the split between REFUSE and WARN is evidence-driven
+ * rather than a matter of taste:
+ *
+ * - `seat` REFUSES. The seat list is a closed, declared set and an owner
+ *   directive says the row is ownerless. There is no honest reading of
+ *   `--assign agent-ceo` that means "a session will pick this up".
+ * - `ambiguous` REFUSES. The name certainly exists; what cannot be done is
+ *   PICK, and picking the first row is precisely how a task lands on a
+ *   stranger. A fresh store cannot trip this, because a name has to occupy two
+ *   rows to be ambiguous.
+ * - `unknown` only WARNS. Assigning to an agent that has not registered yet is
+ *   a REAL, EXISTING, TESTED contract in this CLI — `todos add --assign
+ *   brutus` against a store where brutus has never registered must succeed
+ *   (src/cli/creator-attribution.test.ts). Refusing it broke 9 existing tests
+ *   when this validator was first written to refuse, which is exactly the
+ *   legitimate flow that measurement was supposed to find. The check cannot
+ *   tell a typo from a not-yet-registered agent, so it says so and gets out of
+ *   the way.
+ */
+export type AssigneeVerdict = {
+    ok: true;
+    assignee: string;
+    agentId?: string;
+    isSeat: boolean;
+    warning?: string;
+} | {
+    ok: false;
+    reason: "seat" | "ambiguous";
+    message: string;
+    candidates?: KnownAgent[];
+};
+/**
+ * The canonical declarative seat roster, in the `AgentRoster` format shipped
+ * by `@hasna/identities`. `identities` has no built-in path for it — every
+ * consumer passes `--roster <file>` — so the path is config here, not a
+ * constant baked into a code path.
+ */
+export declare function defaultSeatRosterPath(): string;
+/**
+ * Read seat slugs out of the roster file.
+ *
+ * Returns an EMPTY SET on a missing or malformed roster, and never throws. The
+ * roster is a station-local file that does not exist inside an e2b sandbox or
+ * a cloud runner, and a validator that refused every assignment when it could
+ * not find its config would be a worse defect than the one it fixes. The cost
+ * of degrading is bounded and stated: without the roster the seat check is
+ * skipped, while the unknown-agent and ambiguous-name checks still apply.
+ */
+export declare function loadSeatSlugs(path?: string): Set<string>;
+/**
+ * Resolve and validate an `--assign` value.
+ *
+ * Accepts either an agent name (case-insensitive) or an agent ID. An ID is
+ * resolved to its name first, so that passing a seat's ID is caught by the
+ * seat rule exactly as passing its slug is.
+ */
+export declare function validateAssignee(input: string, ctx: AssigneeContext): AssigneeVerdict;
+//# sourceMappingURL=assignee-validation.d.ts.map

package/dist/lib/assignee-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignee-validation.d.ts","sourceRoot":"","sources":["../../src/lib/assignee-validation.ts"],"names":[],"mappings":"AA2CA,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,gEAAgE;IAChE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnF;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAK9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAgC,GAAG,GAAG,CAAC,MAAM,CAAC,CAajF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,eAAe,CAoErF"}

package/dist/lib/claude-tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-tasks.d.ts","sourceRoot":"","sources":["../../src/lib/claude-tasks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAwF9D;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,UAAU,CA4GZ;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,UAAU,CAwFZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,UAAU,CAQZ"}
+{"version":3,"file":"claude-tasks.d.ts","sourceRoot":"","sources":["../../src/lib/claude-tasks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA0F9D;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,UAAU,CAgHZ;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,UAAU,CAwFZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,UAAU,CAQZ"}

package/dist/lib/sync-utils.d.ts

@@ -1,4 +1,5 @@
 import type { SyncConflict } from "./sync-types.js";
+export declare const TODO_SYNC_FINGERPRINT_KEY = "todos_sync_fingerprint";
 export declare const HOME: string;
 export declare function getHomeDir(): string;
 export declare function getTodosGlobalDir(): string;
@@ -11,4 +12,10 @@ export declare function writeHighWaterMark(dir: string, value: number): void;
 export declare function getFileMtimeMs(path: string): number | null;
 export declare function parseTimestamp(value: unknown): number | null;
 export declare function appendSyncConflict(metadata: Record<string, unknown>, conflict: SyncConflict, limit?: number): Record<string, unknown>;
+export declare function withSyncFingerprint<T extends {
+    metadata: Record<string, unknown>;
+}>(record: T): T;
+export declare function hasSyncFingerprintChanged(record: {
+    metadata?: Record<string, unknown>;
+}): boolean | null;
 //# sourceMappingURL=sync-utils.d.ts.map

package/dist/lib/sync-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-utils.d.ts","sourceRoot":"","sources":["../../src/lib/sync-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,eAAO,MAAM,IAAI,QAA2D,CAAC;AAE7E,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAGnD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMtD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAE/D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,YAAY,EACtB,KAAK,SAAI,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB"}
+{"version":3,"file":"sync-utils.d.ts","sourceRoot":"","sources":["../../src/lib/sync-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,eAAO,MAAM,yBAAyB,2BAA2B,CAAC;AAElE,eAAO,MAAM,IAAI,QAA2D,CAAC;AAE7E,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAGnD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMtD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAE/D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,YAAY,EACtB,KAAK,SAAI,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB;AAsBD,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CASjG;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,OAAO,GAAG,IAAI,CAIxG"}