@hasna/todos 0.15.6 → 0.15.9

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

@@ -65,6 +65,50 @@ export type AssigneeVerdict = {
     message: string;
     candidates?: KnownAgent[];
 };
+/**
+ * What a READ-side `--assigned <ref>` filter is about to do, when that is worth
+ * saying out loud. See {@link describeAssigneeFilter}.
+ */
+export type AssigneeFilterNotice = {
+    kind: "ok";
+} | {
+    kind: "ambiguous";
+    message: string;
+    candidates: KnownAgent[];
+};
+/**
+ * The read-path counterpart to {@link validateAssignee}, for `list --assigned`.
+ *
+ * WHY THIS EXISTS (todos task 0cbf512c). Both storage engines resolve an
+ * `assigned_to` filter through an alias set — `resolveAssignedToAliases`
+ * (db/database.ts) and `resolveAgentForAssignedFilter`
+ * (storage/postgres-adapter.ts). Both deliberately degrade an AMBIGUOUS name,
+ * one that case-insensitively occupies 2+ agent rows, to LITERAL-ONLY matching
+ * rather than picking a row at random. That choice is right and is not changed
+ * here: picking is how a task lands on a stranger.
+ *
+ * What was wrong is that the degradation was SILENT. Both call sites describe
+ * literal-only as "same as no match". It is not. "No match" returns zero rows
+ * and the caller can see it; literal-only returns a POPULATED, PLAUSIBLE,
+ * PARTIAL set at rc=0 with nothing on stderr, so a complete answer and a
+ * truncated one are indistinguishable.
+ *
+ * Measured live on the cloud store, @hasna/todos 0.15.6, 2026-08-07:
+ * `--assigned 01d4cc12` returned 190 rows (`{fabricius: 182, '01d4cc12': 8}`)
+ * while `--assigned fabricius` returned 182 and 0 bytes of stderr. Eight rows
+ * whose `assigned_to` holds a raw agent id are invisible to the name query that
+ * seat actually runs.
+ *
+ * This WARNS rather than refusing, which is the one place it departs from
+ * `validateAssignee`. A write can be refused and retried; a read is run by
+ * scripts and by every agent's own queue check, and making it exit non-zero
+ * would be a worse regression than the defect. The partial set is still the
+ * best available answer — it just has to say that it is partial.
+ *
+ * Bridging two rows into one identity is a separate identity-model decision and
+ * is deliberately NOT attempted here (todos task a37a7137).
+ */
+export declare function describeAssigneeFilter(input: string, ctx: Pick<AssigneeContext, "agents">): AssigneeFilterNotice;
 /**
  * The canonical declarative seat roster, in the `AgentRoster` format shipped
  * by `@hasna/identities`. `identities` has no built-in path for it — every

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

@@ -1 +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;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;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,CAsErF"}
+{"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;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;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;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,oBAAoB,CAgChH;AAED;;;;;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,CAsErF"}

package/dist/lib/project-task-list-ensure.d.ts

@@ -0,0 +1,19 @@
+import type { ProjectTaskListEnsureResult, ProjectTaskListRollbackResult } from "../types/index.js";
+import type { TodosStorageAdapter } from "../storage/interfaces.js";
+export declare const PROJECT_TASK_LIST_ENSURE_SCHEMA_VERSION: "todos.project-task-list-ensure.v1";
+export type ProjectTaskListEnsureErrorCode = "PROJECT_NOT_FOUND" | "PROJECT_TASK_LIST_NOT_DECLARED" | "PROJECT_REVISION_CONFLICT" | "TASK_LIST_SCOPE_COLLISION" | "PROJECT_TASK_LIST_IDEMPOTENCY_KEY_INVALID" | "PROJECT_TASK_LIST_IDEMPOTENCY_CONFLICT" | "PROJECT_TASK_LIST_RECEIPT_NOT_FOUND" | "PROJECT_TASK_LIST_ROLLBACK_CONFLICT" | "PROJECT_TASK_LIST_ROLLBACK_HAS_DEPENDENTS";
+export declare class ProjectTaskListEnsureError extends Error {
+    readonly code: ProjectTaskListEnsureErrorCode;
+    readonly details: Record<string, unknown>;
+    constructor(code: ProjectTaskListEnsureErrorCode, message: string, details?: Record<string, unknown>);
+}
+export declare function planProjectTaskListEnsure(store: TodosStorageAdapter, projectId: string): Promise<ProjectTaskListEnsureResult>;
+export declare function applyProjectTaskListEnsure(store: TodosStorageAdapter, projectId: string, options: {
+    expected_project_revision: string;
+    idempotency_key?: string;
+}): Promise<ProjectTaskListEnsureResult>;
+export declare function rollbackProjectTaskListEnsure(store: TodosStorageAdapter, projectId: string, options: {
+    receipt_id: string;
+    expected_task_list_revision: string;
+}): Promise<ProjectTaskListRollbackResult>;
+//# sourceMappingURL=project-task-list-ensure.d.ts.map

package/dist/lib/project-task-list-ensure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-task-list-ensure.d.ts","sourceRoot":"","sources":["../../src/lib/project-task-list-ensure.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,2BAA2B,EAC3B,6BAA6B,EAE9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,eAAO,MAAM,uCAAuC,EAClD,mCAA4C,CAAC;AAa/C,MAAM,MAAM,8BAA8B,GACtC,mBAAmB,GACnB,gCAAgC,GAChC,2BAA2B,GAC3B,2BAA2B,GAC3B,2CAA2C,GAC3C,wCAAwC,GACxC,qCAAqC,GACrC,qCAAqC,GACrC,2CAA2C,CAAC;AAEhD,qBAAa,0BAA2B,SAAQ,KAAK;IAEjD,QAAQ,CAAC,IAAI,EAAE,8BAA8B;IAE7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFhC,IAAI,EAAE,8BAA8B,EAC7C,OAAO,EAAE,MAAM,EACN,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAKjD;AA+ID,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,2BAA2B,CAAC,CAStC;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,yBAAyB,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC,2BAA2B,CAAC,CA8HtC;AAED,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,2BAA2B,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,6BAA6B,CAAC,CAyExC"}