@hasna/todos 0.13.5 → 0.13.7

package/dist/contracts.js

@@ -2331,6 +2331,7 @@ function ensureSchema(db) {
   ensureColumn("tasks", "reason", "TEXT");
   ensureColumn("tasks", "spawned_from_session", "TEXT");
   ensureColumn("tasks", "assigned_by", "TEXT");
+  ensureColumn("tasks", "created_by", "TEXT");
   ensureColumn("tasks", "assigned_from_project", "TEXT");
   ensureColumn("tasks", "started_at", "TEXT");
   ensureColumn("tasks", "task_type", "TEXT");
@@ -2493,6 +2494,8 @@ function ensureSchema(db) {
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_sources_project ON project_sources(project_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_sources_type ON project_sources(type)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_assigned_by ON tasks(assigned_by)");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_created_by ON tasks(created_by)");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_assigned_created ON tasks(assigned_to, created_by)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_rel_source ON task_relationships(source_task_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_rel_target ON task_relationships(target_task_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_rel_type ON task_relationships(relationship_type)");
@@ -8792,13 +8795,14 @@ function createTask(input, db) {
   const timestamp2 = now();
   const tags = input.tags || [];
   const machineId = currentStorageMachineId(d);
+  const createdBy = input.created_by || input.agent_id || null;
   const assignedBy = input.assigned_by || input.agent_id;
   const assignedFromProject = input.assigned_from_project || null;
   let id = uuid();
   for (let attempt = 0;attempt < 3; attempt++) {
     try {
-      d.run(`INSERT INTO tasks (id, short_id, project_id, parent_id, plan_id, task_list_id, cycle_id, title, description, status, priority, agent_id, assigned_to, session_id, working_dir, tags, metadata, version, created_at, updated_at, due_at, estimated_minutes, sla_minutes, confidence, retry_count, max_retries, retry_after, requires_approval, approved_by, approved_at, recurrence_rule, recurrence_parent_id, spawns_template_id, reason, spawned_from_session, assigned_by, assigned_from_project, task_type, machine_id)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      d.run(`INSERT INTO tasks (id, short_id, project_id, parent_id, plan_id, task_list_id, cycle_id, title, description, status, priority, agent_id, assigned_to, session_id, working_dir, tags, metadata, version, created_at, updated_at, due_at, estimated_minutes, sla_minutes, confidence, retry_count, max_retries, retry_after, requires_approval, approved_by, approved_at, recurrence_rule, recurrence_parent_id, spawns_template_id, reason, spawned_from_session, assigned_by, created_by, assigned_from_project, task_type, machine_id)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
         id,
         null,
         input.project_id || null,
@@ -8834,6 +8838,7 @@ function createTask(input, db) {
         input.reason || null,
         input.spawned_from_session || null,
         assignedBy || null,
+        createdBy,
         assignedFromProject || null,
         input.task_type || null,
         machineId
@@ -8943,6 +8948,14 @@ function listTasks(filter = {}, db) {
     conditions.push("agent_id = ?");
     params.push(filter.agent_id);
   }
+  if (filter.created_by) {
+    conditions.push("LOWER(created_by) = LOWER(?)");
+    params.push(filter.created_by);
+  }
+  if (filter.not_created_by) {
+    conditions.push("(created_by IS NULL OR LOWER(created_by) != LOWER(?))");
+    params.push(filter.not_created_by);
+  }
   if (filter.session_id) {
     conditions.push("session_id = ?");
     params.push(filter.session_id);
@@ -9096,6 +9109,14 @@ function countTasks(filter = {}, db) {
     conditions.push("agent_id = ?");
     params.push(filter.agent_id);
   }
+  if (filter.created_by) {
+    conditions.push("LOWER(created_by) = LOWER(?)");
+    params.push(filter.created_by);
+  }
+  if (filter.not_created_by) {
+    conditions.push("(created_by IS NULL OR LOWER(created_by) != LOWER(?))");
+    params.push(filter.not_created_by);
+  }
   if (filter.session_id) {
     conditions.push("session_id = ?");
     params.push(filter.session_id);
@@ -9156,6 +9177,10 @@ function updateTask(id, input, db) {
     sets.push("description = ?");
     params.push(input.description);
   }
+  if (input.agent_id !== undefined) {
+    sets.push("agent_id = ?");
+    params.push(input.agent_id);
+  }
   if (input.status !== undefined) {
     if (input.status === "completed") {
       checkCompletionGuard(task, task.assigned_to || task.agent_id || null, d);
@@ -11900,7 +11925,7 @@ var init_tasks = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.5",
+  version: "0.13.7",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",
@@ -15332,6 +15357,7 @@ function task(input) {
     reason: "Bundled deterministic onboarding fixture",
     spawned_from_session: null,
     assigned_by: null,
+    created_by: null,
     assigned_from_project: null,
     task_type: "onboarding",
     cost_tokens: 0,

package/dist/db/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAoChD;AA8BD,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAy+C/C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CA4BnD"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAoChD;AA8BD,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAi/C/C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CA4BnD"}

package/dist/db/task-crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-crud.d.ts","sourceRoot":"","sources":["../../src/db/task-crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,eAAe,EACf,IAAI,EACJ,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAkB3B,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAS5C;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI,CAMjF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI,CAGlF;AAwCD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAkFtE;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAK9D;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,EAAE,CAAC,EAAE,QAAQ,GACZ,iBAAiB,GAAG,IAAI,CA4D1B;AAED,wBAAgB,SAAS,CAAC,MAAM,GAAE,UAAe,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE,CAwIxE;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,GAAG,IAAI,CAKb;AAcD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,EACnC,EAAE,CAAC,EAAE,QAAQ,GACZ,6BAA6B,CAmD/B;AAED,wBAAgB,UAAU,CAAC,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,QAAQ,CAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAwGnG;AAED,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,eAAe,EACtB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,CA2ON;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAY7D"}
+{"version":3,"file":"task-crud.d.ts","sourceRoot":"","sources":["../../src/db/task-crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,eAAe,EACf,IAAI,EACJ,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAkB3B,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAS5C;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI,CAMjF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI,CAGlF;AAwCD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAwFtE;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAK9D;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,EAAE,CAAC,EAAE,QAAQ,GACZ,iBAAiB,GAAG,IAAI,CA4D1B;AAED,wBAAgB,SAAS,CAAC,MAAM,GAAE,UAAe,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE,CA2JxE;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,GAAG,IAAI,CAKb;AAcD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,EACnC,EAAE,CAAC,EAAE,QAAQ,GACZ,6BAA6B,CAmD/B;AAED,wBAAgB,UAAU,CAAC,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,QAAQ,CAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CA2HnG;AAED,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,eAAe,EACtB,EAAE,CAAC,EAAE,QAAQ,GACZ,IAAI,CAkPN;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAY7D"}

package/dist/index.js

@@ -2331,6 +2331,7 @@ function ensureSchema(db) {
   ensureColumn("tasks", "reason", "TEXT");
   ensureColumn("tasks", "spawned_from_session", "TEXT");
   ensureColumn("tasks", "assigned_by", "TEXT");
+  ensureColumn("tasks", "created_by", "TEXT");
   ensureColumn("tasks", "assigned_from_project", "TEXT");
   ensureColumn("tasks", "started_at", "TEXT");
   ensureColumn("tasks", "task_type", "TEXT");
@@ -2493,6 +2494,8 @@ function ensureSchema(db) {
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_sources_project ON project_sources(project_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_project_sources_type ON project_sources(type)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_assigned_by ON tasks(assigned_by)");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_created_by ON tasks(created_by)");
+  ensureIndex("CREATE INDEX IF NOT EXISTS idx_tasks_assigned_created ON tasks(assigned_to, created_by)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_rel_source ON task_relationships(source_task_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_rel_target ON task_relationships(target_task_id)");
   ensureIndex("CREATE INDEX IF NOT EXISTS idx_task_rel_type ON task_relationships(relationship_type)");
@@ -8792,13 +8795,14 @@ function createTask(input, db) {
   const timestamp2 = now();
   const tags = input.tags || [];
   const machineId = currentStorageMachineId(d);
+  const createdBy = input.created_by || input.agent_id || null;
   const assignedBy = input.assigned_by || input.agent_id;
   const assignedFromProject = input.assigned_from_project || null;
   let id = uuid();
   for (let attempt = 0;attempt < 3; attempt++) {
     try {
-      d.run(`INSERT INTO tasks (id, short_id, project_id, parent_id, plan_id, task_list_id, cycle_id, title, description, status, priority, agent_id, assigned_to, session_id, working_dir, tags, metadata, version, created_at, updated_at, due_at, estimated_minutes, sla_minutes, confidence, retry_count, max_retries, retry_after, requires_approval, approved_by, approved_at, recurrence_rule, recurrence_parent_id, spawns_template_id, reason, spawned_from_session, assigned_by, assigned_from_project, task_type, machine_id)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      d.run(`INSERT INTO tasks (id, short_id, project_id, parent_id, plan_id, task_list_id, cycle_id, title, description, status, priority, agent_id, assigned_to, session_id, working_dir, tags, metadata, version, created_at, updated_at, due_at, estimated_minutes, sla_minutes, confidence, retry_count, max_retries, retry_after, requires_approval, approved_by, approved_at, recurrence_rule, recurrence_parent_id, spawns_template_id, reason, spawned_from_session, assigned_by, created_by, assigned_from_project, task_type, machine_id)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
         id,
         null,
         input.project_id || null,
@@ -8834,6 +8838,7 @@ function createTask(input, db) {
         input.reason || null,
         input.spawned_from_session || null,
         assignedBy || null,
+        createdBy,
         assignedFromProject || null,
         input.task_type || null,
         machineId
@@ -8943,6 +8948,14 @@ function listTasks(filter = {}, db) {
     conditions.push("agent_id = ?");
     params.push(filter.agent_id);
   }
+  if (filter.created_by) {
+    conditions.push("LOWER(created_by) = LOWER(?)");
+    params.push(filter.created_by);
+  }
+  if (filter.not_created_by) {
+    conditions.push("(created_by IS NULL OR LOWER(created_by) != LOWER(?))");
+    params.push(filter.not_created_by);
+  }
   if (filter.session_id) {
     conditions.push("session_id = ?");
     params.push(filter.session_id);
@@ -9096,6 +9109,14 @@ function countTasks(filter = {}, db) {
     conditions.push("agent_id = ?");
     params.push(filter.agent_id);
   }
+  if (filter.created_by) {
+    conditions.push("LOWER(created_by) = LOWER(?)");
+    params.push(filter.created_by);
+  }
+  if (filter.not_created_by) {
+    conditions.push("(created_by IS NULL OR LOWER(created_by) != LOWER(?))");
+    params.push(filter.not_created_by);
+  }
   if (filter.session_id) {
     conditions.push("session_id = ?");
     params.push(filter.session_id);
@@ -9156,6 +9177,10 @@ function updateTask(id, input, db) {
     sets.push("description = ?");
     params.push(input.description);
   }
+  if (input.agent_id !== undefined) {
+    sets.push("agent_id = ?");
+    params.push(input.agent_id);
+  }
   if (input.status !== undefined) {
     if (input.status === "completed") {
       checkCompletionGuard(task, task.assigned_to || task.agent_id || null, d);
@@ -12013,7 +12038,7 @@ var init_dispatches = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.13.5",
+  version: "0.13.7",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",
@@ -15445,6 +15470,7 @@ function task(input) {
     reason: "Bundled deterministic onboarding fixture",
     spawned_from_session: null,
     assigned_by: null,
+    created_by: null,
     assigned_from_project: null,
     task_type: "onboarding",
     cost_tokens: 0,
@@ -25274,7 +25300,11 @@ function createLocalSqliteTodosStorageAdapter(options = {}) {
       sync: true
     },
     tasks: {
-      create: (input) => createTask(input, database()),
+      create: (input, context) => createTask({
+        ...input,
+        agent_id: input.agent_id ?? context?.agentId,
+        created_by: input.created_by ?? input.agent_id ?? context?.agentId
+      }, database()),
       get: (id) => getTask(id, database()),
       resolveRef: (ref) => resolveTaskRefLocal(database(), ref),
       list: (filter = {}) => listTasksMaybeSearch(filter, database()),
@@ -25997,6 +26027,10 @@ class PostgresJsonRecordStore {
       conds.push(`payload->>'assigned_to' = ${p(filter.assigned_to)}`);
     if (filter.agent_id !== undefined)
       conds.push(`payload->>'agent_id' = ${p(filter.agent_id)}`);
+    if (filter.created_by !== undefined)
+      conds.push(`LOWER(payload->>'created_by') = LOWER(${p(filter.created_by)})`);
+    if (filter.not_created_by !== undefined)
+      conds.push(`(payload->>'created_by' IS NULL OR LOWER(payload->>'created_by') <> LOWER(${p(filter.not_created_by)}))`);
     if (filter.session_id !== undefined)
       conds.push(`payload->>'session_id' = ${p(filter.session_id)}`);
     if (filter.tags?.length) {
@@ -26510,7 +26544,7 @@ async function createTask2(input, store, context) {
     description: input.description ?? null,
     status: input.status ?? "pending",
     priority: input.priority ?? "medium",
-    agent_id: input.agent_id ?? null,
+    agent_id: input.agent_id ?? context?.agentId ?? null,
     assigned_to: input.assigned_to ?? null,
     session_id: input.session_id ?? context?.sessionId ?? null,
     working_dir: input.working_dir ?? null,
@@ -26535,7 +26569,8 @@ async function createTask2(input, store, context) {
     confidence: input.confidence ?? null,
     reason: input.reason ?? null,
     spawned_from_session: input.spawned_from_session ?? null,
-    assigned_by: input.assigned_by ?? null,
+    assigned_by: input.assigned_by ?? input.agent_id ?? context?.agentId ?? null,
+    created_by: input.created_by ?? input.agent_id ?? context?.agentId ?? null,
     assigned_from_project: input.assigned_from_project ?? null,
     task_type: input.task_type ?? null,
     cost_tokens: 0,
@@ -26572,7 +26607,8 @@ async function updateTask2(id, input, store) {
     tags: input.tags ?? existing.tags,
     metadata: input.metadata ?? existing.metadata,
     requires_approval: input.requires_approval ?? existing.requires_approval,
-    task_list_id: input.task_list_id !== undefined ? input.task_list_id : existing.task_list_id
+    task_list_id: input.task_list_id !== undefined ? input.task_list_id : existing.task_list_id,
+    created_by: existing.created_by
   };
   await store.upsert("tasks", task2);
   return task2;

package/dist/lib/creator-identity.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Ambient creator identity.
+ *
+ * The defect this closes: `todos init <name>` registered an agent and printed
+ * "Use --agent <id> on future commands", but persisted that identity NOWHERE.
+ * Every later command therefore had to re-supply `--agent` by hand, and in
+ * practice nothing did — so `todos add` recorded who a task was FOR
+ * (`assigned_to`) and never who FILED it. Measured on project 931835c7:
+ * agent_id populated on 35/436 tasks, assigned_by on 0/436.
+ *
+ * Resolution order, most explicit first:
+ *   1. an explicit value (the `--agent` flag)
+ *   2. TODOS_AGENT_ID
+ *   3. HASNA_TODOS_AGENT_ID
+ *   4. the identity persisted by `todos init`
+ *
+ * Returns null when no identity can be established. Callers must treat null as
+ * "unattributable" and say so — never as "attributable to nobody in particular".
+ */
+export interface PersistedIdentity {
+    agent_id: string;
+    agent_name?: string;
+    session_id?: string;
+    registered_at: string;
+}
+export type CreatorIdentitySource = "explicit" | "env" | "persisted" | "none";
+export interface ResolvedCreatorIdentity {
+    agent_id: string | null;
+    source: CreatorIdentitySource;
+}
+export declare function identityFilePath(): string;
+export declare function readPersistedIdentity(): PersistedIdentity | null;
+export interface IdentityCollision {
+    /** The identity already on disk that a new `init` would have overwritten. */
+    existing: PersistedIdentity;
+}
+/**
+ * The file is keyed on $HOME, and this fleet runs many named agent sessions per
+ * station under one HOME. Two sessions each running `todos init` would silently
+ * leave the loser attributing its tasks to the winner — and a WRONG author is
+ * worse than a missing one, because a null is visibly absent while a name is
+ * simply believed. So a second, different identity is refused rather than
+ * clobbered; the per-session escape hatch is the TODOS_AGENT_ID environment
+ * variable, which outranks this file and cannot collide between processes.
+ */
+export declare function detectIdentityCollision(agentId: string, agentName?: string): IdentityCollision | null;
+/** Persist the identity established by `todos init` so later commands inherit it. */
+export declare function persistIdentity(identity: {
+    agent_id: string;
+    agent_name?: string;
+    session_id?: string;
+}): PersistedIdentity;
+/** Drop the persisted identity — used by `todos release` so the seat does not leak into the next session. */
+export declare function clearPersistedIdentity(): boolean;
+/**
+ * Canonicalise exactly as `registerAgent` does (src/db/agents.ts: trim + lower-case).
+ *
+ * Without this the three sources disagree about the SAME agent: the persisted file
+ * returns the registered name, which is already lower-cased, while the flag and the
+ * environment variable were taken verbatim. An agent that registered with `todos init`
+ * in one session and `TODOS_AGENT_ID=Cassius` in another — both sanctioned, and the
+ * env var is the very escape hatch this module recommends for concurrent sessions —
+ * would file some tasks as "cassius" and others as "Cassius". The comparison is a SQL
+ * string inequality, so `not_created_by` would fail to exclude half of the agent's own
+ * filings and leak them back into its own inbox: exactly the self-noise the filter
+ * exists to remove.
+ */
+export declare function canonicalAgentRef(value: string): string;
+/**
+ * Is this identity bound to THIS PROCESS, or merely lying around on the disk?
+ *
+ * `explicit` (--agent) and `env` (TODOS_AGENT_ID) travel with the process, so two
+ * concurrent sessions cannot be handed the same one by accident. `persisted` is a
+ * single file keyed on $HOME, and this fleet runs many named agent sessions per
+ * station under one HOME — so it identifies the STATION, never the caller.
+ *
+ * The write side was already guarded: `todos init` refuses to clobber a foreign
+ * identity (detectIdentityCollision). Nothing guarded the read side, and that is
+ * the whole defect — refusing to record session B's identity silently converted
+ * into attributing B's work to A. Measured on station01 2026-07-31: one agent ran
+ * `todos init` at 17:31:04Z and every unregistered session on the box filed as it
+ * from 17:37:36Z onward.
+ *
+ * So an ambient identity may be DISPLAYED, but it must never be written into a
+ * task. A wrong name is worse than a missing one — this module's own doctrine —
+ * and it is worse here in the direction that costs most: `assigned_to` is the
+ * queue every seat reads, and `agent_id` is a filterable column
+ * (task-crud.ts `filter.agent_id`) that also stands in as the acting agent
+ * wherever `assigned_to` is null (`task.assigned_to || task.agent_id`).
+ */
+export declare function isProcessBoundSource(source: CreatorIdentitySource): boolean;
+/**
+ * The identity this process may WRITE onto a task, or null when it has none.
+ *
+ * Deliberately narrower than `resolveCreatorIdentity`, which still reports the
+ * ambient identity so that `todos init`/diagnostics can show what is on disk.
+ */
+export declare function resolveWritableIdentity(explicit?: string | null): ResolvedCreatorIdentity;
+export declare function resolveCreatorIdentity(explicit?: string | null): ResolvedCreatorIdentity;
+//# sourceMappingURL=creator-identity.d.ts.map

package/dist/lib/creator-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creator-identity.d.ts","sourceRoot":"","sources":["../../src/lib/creator-identity.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,qBAAqB,IAAI,iBAAiB,GAAG,IAAI,CAMhE;AAED,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAOrG;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAU3H;AAED,6GAA6G;AAC7G,wBAAgB,sBAAsB,IAAI,OAAO,CAShD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,uBAAuB,CAIzF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,uBAAuB,CAmBxF"}

package/dist/lib/onboarding-fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-fixtures.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding-fixtures.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,wCAAwC,eAAe,CAAC;AACrE,eAAO,MAAM,+BAA+B,sCAAsC,CAAC;AAEnF,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,oBAAoB,EAAE,MAAM,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoXD,wBAAgB,sBAAsB,IAAI,wBAAwB,EAAE,CAMnE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,SAAuB,GAAG,iBAAiB,CAUnF;AAED,wBAAgB,0BAA0B,CAAC,IAAI,SAAuB,GAAG,sBAAsB,CAE9F;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,4BAA4B,CAS3F;AAED,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CAMzB"}
+{"version":3,"file":"onboarding-fixtures.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding-fixtures.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,wCAAwC,eAAe,CAAC;AACrE,eAAO,MAAM,+BAA+B,sCAAsC,CAAC;AAEnF,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,oBAAoB,EAAE,MAAM,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAqXD,wBAAgB,sBAAsB,IAAI,wBAAwB,EAAE,CAMnE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,SAAuB,GAAG,iBAAiB,CAUnF;AAED,wBAAgB,0BAA0B,CAAC,IAAI,SAAuB,GAAG,sBAAsB,CAE9F;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,4BAA4B,CAS3F;AAED,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CAMzB"}