@agimon-ai/doompi-task 0.0.1-alpha.0 → 0.0.1-alpha.10

package/dist/store/reducer.mjs

@@ -1,3 +1 @@
-import{DELETED_STATUS as e,isDelegationActive as t}from"./types.mjs";import{detectCycle as n}from"./taskGraph.mjs";import{isTransitionValid as r}from"./invariants.mjs";const i=100,a=/^[A-Za-z][A-Za-z0-9_-]{0,31}$/;function o(e){switch(e.kind){case`error`:case`list`:case`get`:return!1;case`upsert`:return e.applied>0;case`delete`:case`clear`:return!0}}function s(e){return e.items.filter(e=>e.kind===`failed`).map(e=>`item[${e.index}]: ${e.message}`).join(`
-`)}function c(e){return e.kind===`upsert`?e.items[0]:void 0}function l(e,t){return{document:e,op:{kind:`error`,message:t}}}function u(e,t){let n=e??[],r=t??[];return n.length===r.length&&n.every((e,t)=>e===r[t])}function d(e,t){return JSON.stringify(e??null)===JSON.stringify(t??null)}function f(e,t){return e.subject!==t.subject||e.status!==t.status||e.description!==t.description||e.activeForm!==t.activeForm||e.owner!==t.owner||!u(e.blockedBy,t.blockedBy)||!d(e.metadata,t.metadata)}function p(e,t,n=e.nextId){return{...e,tasks:t,nextId:n}}function m(e,t){let n={...e};for(let[e,r]of Object.entries(t))r===null?delete n[e]:n[e]=r;return Object.keys(n).length?n:void 0}function h(e,t){if(t.subject!==void 0&&(e.subject=t.subject),t.description!==void 0&&(e.description=t.description),t.activeForm!==void 0&&(e.activeForm=t.activeForm),t.owner!==void 0&&(e.owner=t.owner),t.metadata!==void 0){let n=m(e.metadata,t.metadata);n===void 0?delete e.metadata:e.metadata=n}}function g(e,t,n){if(typeof n==`number`)return{ok:!0,id:n};if(!a.test(n))return{ok:!1,message:`${t}: "${n}" is not a valid ref; pass an existing task id as a number`};let r=e.refIds.get(n);if(r!==void 0)return{ok:!0,id:r};let i=e.failedRefs.get(n);return i===void 0?{ok:!1,message:`${t}: unknown ref "${n}" — a ref must be declared by an earlier entry in the same call`}:{ok:!1,message:`${t}: ref "${n}" refers to item[${i}], which failed`}}function _(e){return{ok:!1,message:e}}function v(e,t){if(t.ref!==void 0){if(t.id!==void 0)return`ref is only valid when creating a task; drop the id, or drop the ref`;if(!a.test(t.ref))return`ref "${t.ref}" is invalid: a ref must start with a letter and contain only letters, digits, - or _`;if(e.refIds.get(t.ref)!==void 0||e.failedRefs.has(t.ref))return`duplicate ref "${t.ref}": it was already declared by an earlier entry`}}function y(e,t,n,r){if(t.subject===void 0)return _(`subject is required when the entry has no id`);if(!t.subject.trim())return _(`subject must not be blank`);if(t.addBlockedBy!==void 0||t.removeBlockedBy!==void 0)return _(`addBlockedBy / removeBlockedBy are only for an entry with an id; a new task uses blockedBy`);if(t.status===`deleted`)return _(`cannot create a task with status deleted; create it, then use action delete`);let i=[];for(let n of t.blockedBy??[]){let t=g(e,`blockedBy`,n);if(!t.ok)return _(t.message);let r=e.tasks.find(e=>e.id===t.id);if(!r)return _(`blockedBy: #${t.id} not found`);if(r.status===`deleted`)return _(`blockedBy: #${t.id} is deleted`);i.includes(t.id)||i.push(t.id)}let a={id:e.nextId,subject:t.subject,status:t.status??`pending`,createdAt:r,updatedAt:r};return h(a,t),i.length&&(a.blockedBy=i),e.nextId+=1,e.tasks.push(a),t.ref&&e.refIds.set(t.ref,a.id),{ok:!0,outcome:{index:n,kind:`created`,id:a.id,subject:a.subject,status:a.status,...t.ref?{ref:t.ref}:{},...i.length?{blockedBy:i}:{}}}}function b(e,t,i,a){let o=t.id,s=e.tasks.findIndex(e=>e.id===o);if(s===-1)return _(`#${o} not found`);if(t.blockedBy!==void 0)return _(`blockedBy is only for a new entry; use addBlockedBy / removeBlockedBy on an entry that has an id`);if(!(t.subject!==void 0||t.description!==void 0||t.activeForm!==void 0||t.status!==void 0||t.owner!==void 0||t.metadata!==void 0||t.addBlockedBy?.length||t.removeBlockedBy?.length))return _(`nothing to change: provide at least one of subject, description, activeForm, status, owner, metadata, addBlockedBy, or removeBlockedBy`);let c=e.tasks[s];if(t.subject!==void 0&&!t.subject.trim())return _(`subject must not be blank`);let l=c.status;if(t.status!==void 0){if(!r(c.status,t.status))return _(`illegal transition ${c.status} -> ${t.status}`);l=t.status}let u=c.blockedBy?[...c.blockedBy]:[];for(let n of t.removeBlockedBy??[]){let t=g(e,`removeBlockedBy`,n);if(!t.ok)return _(t.message);u=u.filter(e=>e!==t.id)}for(let n of t.addBlockedBy??[]){let t=g(e,`addBlockedBy`,n);if(!t.ok)return _(t.message);if(t.id===o)return _(`cannot block #${o} on itself`);let r=e.tasks.find(e=>e.id===t.id);if(!r)return _(`addBlockedBy: #${t.id} not found`);if(r.status===`deleted`)return _(`addBlockedBy: #${t.id} is deleted`);u.includes(t.id)||u.push(t.id)}let d={...c,status:l};h(d,t),u.length?d.blockedBy=u:delete d.blockedBy;let p=[...e.tasks];if(p[s]=d,t.addBlockedBy?.length&&n(p,o,u))return _(`addBlockedBy would create a cycle in the blockedBy graph`);let m=f(c,d);return m&&(d.updatedAt=a),e.tasks=p,{ok:!0,outcome:m?{index:i,kind:`updated`,id:o,fromStatus:c.status,toStatus:l}:{index:i,kind:`unchanged`,id:o,status:l}}}function x(e,t,n){let r={tasks:[...e.tasks],nextId:e.nextId,refIds:new Map,failedRefs:new Map},i=[],o=0;for(let[e,s]of t.entries()){let t=v(r,s),c=t?_(t):s.id===void 0?y(r,s,e,n):b(r,s,e,n);if(c.ok){i.push(c.outcome),o+=1;continue}s.ref&&a.test(s.ref)&&!r.refIds.has(s.ref)&&r.failedRefs.set(s.ref,e),i.push({index:e,kind:`failed`,message:c.message,...s.id===void 0?{}:{id:s.id},...s.ref?{ref:s.ref}:{}})}return{document:o>0?p(e,r.tasks,r.nextId):e,op:{kind:`upsert`,items:i,applied:o,failed:i.length-o}}}function S(n,r,i,a=new Date().toISOString()){switch(r){case`upsert`:{let e=i.tasks;return!Array.isArray(e)||e.length===0?l(n,`upsert requires a non-empty tasks array, e.g. {"action":"upsert","tasks":[{"subject":"Write tests"}]}`):e.length>100?l(n,`upsert accepts at most 100 entries per call (received ${e.length})`):x(n,e,a)}case`list`:return{document:n,op:{kind:`list`,includeDeleted:i.includeDeleted===!0,...i.status===void 0?{}:{statusFilter:i.status}}};case`get`:{if(i.id===void 0)return l(n,`id required for get`);let e=n.tasks.find(e=>e.id===i.id);return e?{document:n,op:{kind:`get`,task:e}}:l(n,`#${i.id} not found`)}case`delete`:{if(i.id===void 0)return l(n,`id required for delete`);let r=n.tasks.findIndex(e=>e.id===i.id);if(r===-1)return l(n,`#${i.id} not found`);let o=n.tasks[r];if(o.status===`deleted`)return l(n,`#${o.id} is already deleted`);if(t(o))return l(n,`#${o.id} has a running delegation — cancel it before deleting`);let s=[...n.tasks];return s[r]={...o,status:e,updatedAt:a},{document:p(n,s),op:{kind:`delete`,id:o.id,subject:o.subject}}}case`clear`:{let e=n.tasks.filter(t);if(e.length>0)return l(n,`cannot clear while delegations are running (${e.map(e=>`#${e.id}`).join(`, `)}) — cancel them first`);let r=n.tasks.length;return{document:p(n,[],1),op:{kind:`clear`,count:r}}}}}export{i as MAX_UPSERT_ITEMS,a as REF_PATTERN,S as applyTaskMutation,s as formatUpsertFailure,o as isCommittingOp,c as singleItemOutcome};
-//# sourceMappingURL=reducer.mjs.map
+import{MAX_UPSERT_ITEMS as e,REF_PATTERN as t,applyTaskMutation as n,formatUpsertFailure as r,isCommittingOp as i,singleItemOutcome as a}from"../services/store/reducer.mjs";export{e as MAX_UPSERT_ITEMS,t as REF_PATTERN,n as applyTaskMutation,r as formatUpsertFailure,i as isCommittingOp,a as singleItemOutcome};

package/dist/store/taskGraph.cjs

@@ -1,2 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=`completed`,t=`deleted`;function n(n){let r=n.filter(e=>e.status!==t);return r.length>0&&r.every(t=>t.status===e)}function r(e,t,n){let r=new Map;for(let i of e)i.id===t?r.set(i.id,[...new Set([...i.blockedBy??[],...n])]):r.set(i.id,i.blockedBy?[...i.blockedBy]:[]);let i=new Set,a=new Set,o=e=>{if(i.has(e))return!0;if(a.has(e))return!1;i.add(e);for(let t of r.get(e)??[])if(o(t))return!0;return i.delete(e),a.add(e),!1};for(let e of r.keys())if(o(e))return!0;return!1}function i(e){let t=new Map;for(let n of e)for(let e of n.blockedBy??[]){let r=t.get(e)??[];r.push(n.id),t.set(e,r)}return t}function a(n,r){return(r.blockedBy??[]).filter(r=>{let i=n.find(e=>e.id===r);return i?i.status!==e&&i.status!==t:!1})}function o(e,t){return a(e,t).length>0}exports.deriveBlocks=i,exports.detectCycle=r,exports.isBlocked=o,exports.isTaskListComplete=n,exports.unresolvedBlockers=a;
-//# sourceMappingURL=taskGraph.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../services/store/taskGraph.cjs");exports.deriveBlocks=e.deriveBlocks,exports.detectCycle=e.detectCycle,exports.isBlocked=e.isBlocked,exports.isTaskListComplete=e.isTaskListComplete,exports.unresolvedBlockers=e.unresolvedBlockers;

package/dist/store/taskGraph.d.cts

@@ -1,25 +1,2 @@
-import { Task } from "./types.cjs";
-//#region src/store/taskGraph.d.ts
-/** True when a non-empty list has no visible work left to finish. */
-declare function isTaskListComplete(taskList: readonly Task[]): boolean;
-/**
- * Would merging `newBlockedBy` into `taskId`'s dependencies introduce a cycle?
- *
- * Takes the proposed additions explicitly so the reducer can ask the question
- * before mutating anything.
- */
-declare function detectCycle(taskList: readonly Task[], taskId: number, newBlockedBy: readonly number[]): boolean;
-/** Inverse adjacency: for each task, which tasks list it in their blockedBy. */
-declare function deriveBlocks(taskList: readonly Task[]): Map<number, number[]>;
-/**
- * Blocking dependencies of a task that are not yet resolved.
- *
- * `completed` clears a dependency; `failed` deliberately does not, so a failed
- * delegation keeps its dependents blocked instead of silently releasing work
- * that was never actually finished.
- */
-declare function unresolvedBlockers(taskList: readonly Task[], task: Task): number[];
-declare function isBlocked(taskList: readonly Task[], task: Task): boolean;
-//#endregion
-export { deriveBlocks, detectCycle, isBlocked, isTaskListComplete, unresolvedBlockers };
-//# sourceMappingURL=taskGraph.d.cts.map
+import { deriveBlocks, detectCycle, isBlocked, isTaskListComplete, unresolvedBlockers } from "../services/store/taskGraph.cjs";
+export { deriveBlocks, detectCycle, isBlocked, isTaskListComplete, unresolvedBlockers };

package/dist/store/taskGraph.d.mts

@@ -1,25 +1,2 @@
-import { Task } from "./types.mjs";
-//#region src/store/taskGraph.d.ts
-/** True when a non-empty list has no visible work left to finish. */
-declare function isTaskListComplete(taskList: readonly Task[]): boolean;
-/**
- * Would merging `newBlockedBy` into `taskId`'s dependencies introduce a cycle?
- *
- * Takes the proposed additions explicitly so the reducer can ask the question
- * before mutating anything.
- */
-declare function detectCycle(taskList: readonly Task[], taskId: number, newBlockedBy: readonly number[]): boolean;
-/** Inverse adjacency: for each task, which tasks list it in their blockedBy. */
-declare function deriveBlocks(taskList: readonly Task[]): Map<number, number[]>;
-/**
- * Blocking dependencies of a task that are not yet resolved.
- *
- * `completed` clears a dependency; `failed` deliberately does not, so a failed
- * delegation keeps its dependents blocked instead of silently releasing work
- * that was never actually finished.
- */
-declare function unresolvedBlockers(taskList: readonly Task[], task: Task): number[];
-declare function isBlocked(taskList: readonly Task[], task: Task): boolean;
-//#endregion
-export { deriveBlocks, detectCycle, isBlocked, isTaskListComplete, unresolvedBlockers };
-//# sourceMappingURL=taskGraph.d.mts.map
+import { deriveBlocks, detectCycle, isBlocked, isTaskListComplete, unresolvedBlockers } from "../services/store/taskGraph.mjs";
+export { deriveBlocks, detectCycle, isBlocked, isTaskListComplete, unresolvedBlockers };

package/dist/store/taskGraph.mjs

@@ -1,2 +1 @@
-const e=`completed`,t=`deleted`;function n(n){let r=n.filter(e=>e.status!==t);return r.length>0&&r.every(t=>t.status===e)}function r(e,t,n){let r=new Map;for(let i of e)i.id===t?r.set(i.id,[...new Set([...i.blockedBy??[],...n])]):r.set(i.id,i.blockedBy?[...i.blockedBy]:[]);let i=new Set,a=new Set,o=e=>{if(i.has(e))return!0;if(a.has(e))return!1;i.add(e);for(let t of r.get(e)??[])if(o(t))return!0;return i.delete(e),a.add(e),!1};for(let e of r.keys())if(o(e))return!0;return!1}function i(e){let t=new Map;for(let n of e)for(let e of n.blockedBy??[]){let r=t.get(e)??[];r.push(n.id),t.set(e,r)}return t}function a(n,r){return(r.blockedBy??[]).filter(r=>{let i=n.find(e=>e.id===r);return i?i.status!==e&&i.status!==t:!1})}function o(e,t){return a(e,t).length>0}export{i as deriveBlocks,r as detectCycle,o as isBlocked,n as isTaskListComplete,a as unresolvedBlockers};
-//# sourceMappingURL=taskGraph.mjs.map
+import{deriveBlocks as e,detectCycle as t,isBlocked as n,isTaskListComplete as r,unresolvedBlockers as i}from"../services/store/taskGraph.mjs";export{e as deriveBlocks,t as detectCycle,n as isBlocked,r as isTaskListComplete,i as unresolvedBlockers};

package/dist/store/taskStore.cjs

@@ -1,2 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../logSinkTelemetry.cjs"),n=require("./processLiveness.cjs"),r=require("./types.cjs"),i=require("./paths.cjs");let a=require("node:path");a=e.__toESM(a,1);let o=require("node:fs");o=e.__toESM(o,1);const s=`utf8`,c=`ENOENT`,l=`store.path`;function u(e){return new Promise(t=>setTimeout(t,e))}function d(e){if(!e||typeof e!=`object`)return r.emptyDocument();let t=e;if(!Array.isArray(t.tasks))return r.emptyDocument();let n=t.tasks.filter(e=>!!e&&typeof e==`object`&&typeof e.id==`number`),i=n.reduce((e,t)=>Math.max(e,t.id),0);return{version:typeof t.version==`number`?t.version:1,rev:typeof t.rev==`number`?t.rev:0,nextId:typeof t.nextId==`number`&&t.nextId>i?t.nextId:i+1,tasks:n}}var f=class{storePath;cwd;env;cached=r.emptyDocument();lastKnownRev=-1;watcher;pollTimer;debounceTimer;listeners=new Set;pollIntervalMs;lockTimeoutMs;report;constructor(e={}){this.cwd=e.cwd??process.cwd(),this.env=e.env??process.env,this.storePath=e.storePath??i.resolveStorePath(this.cwd,this.env),this.pollIntervalMs=e.pollIntervalMs??2e3,this.lockTimeoutMs=e.lockTimeoutMs??2e3,this.report=e.report}configureSession(e){this.env.DOOM_TASK_STORE?.trim()||(this.stopWatching(),this.storePath=i.resolveStorePath(this.cwd,this.env,e),this.cached=r.emptyDocument(),this.lastKnownRev=-1)}get snapshot(){return this.cached}read(){try{let e=o.default.readFileSync(this.storePath,s);this.cached=d(JSON.parse(e))}catch(e){e.code!==c&&this.report?.error(t.TASK_EVENT.storeReadFailed,e,{[l]:this.storePath}),this.cached=r.emptyDocument()}return this.lastKnownRev=this.cached.rev,this.cached}async mutate(e){let t=await this.acquireLock();try{let t=this.read(),n=e(t);return n.document?{document:this.write(n.document),value:n.value}:{document:t,value:n.value}}finally{t()}}write(e){let t={...e,version:1,rev:e.rev+1};o.default.mkdirSync(a.default.dirname(this.storePath),{recursive:!0});let n=i.tempPathFor(this.storePath);return o.default.writeFileSync(n,`${JSON.stringify(t,void 0,2)}\n`,s),o.default.renameSync(n,this.storePath),this.cached=t,this.lastKnownRev=t.rev,t}async acquireLock(){let e=i.lockPathFor(this.storePath);o.default.mkdirSync(a.default.dirname(this.storePath),{recursive:!0});let n=Date.now()+this.lockTimeoutMs;for(;;)try{let t=o.default.openSync(e,`wx`);return o.default.writeSync(t,JSON.stringify({pid:process.pid,time:Date.now()})),o.default.closeSync(t),()=>o.default.rmSync(e,{force:!0})}catch(r){if(r.code!==`EEXIST`)throw r;if(Date.now()>=n)return this.report?.warn(t.TASK_EVENT.storeLockTimeout,Error(`Task store lock still held after ${this.lockTimeoutMs}ms; proceeding without it`),{[l]:this.storePath}),()=>{};this.breakStaleLock(e),await u(10+Math.random()*60)}}breakStaleLock(e){try{let t=JSON.parse(o.default.readFileSync(e,s)),r=typeof t.time==`number`&&Date.now()-t.time>1e4,i=typeof t.pid==`number`&&!n.isProcessAlive(t.pid);return!r&&!i?!1:(o.default.unlinkSync(e),!0)}catch(n){return n.code!==c&&this.report?.warn(t.TASK_EVENT.storeLockBreakFailed,n,{[l]:e}),!1}}onExternalChange(e){return this.listeners.add(e),this.startWatching(),()=>{this.listeners.delete(e),this.listeners.size===0&&this.stopWatching()}}startWatching(){if(this.watcher||this.pollTimer)return;let e=a.default.dirname(this.storePath),n=a.default.basename(this.storePath);try{o.default.mkdirSync(e,{recursive:!0}),this.watcher=o.default.watch(e,(e,t)=>{t&&t!==n||this.scheduleCheck()})}catch(e){this.report?.warn(t.TASK_EVENT.storeWatchFailed,e,{[l]:this.storePath})}this.pollTimer=setInterval(()=>this.checkForChange(),this.pollIntervalMs),this.pollTimer.unref?.()}scheduleCheck(){clearTimeout(this.debounceTimer),this.debounceTimer=setTimeout(()=>this.checkForChange(),150),this.debounceTimer.unref?.()}checkForChange(){let e=this.lastKnownRev,n=this.read();if(n.rev!==e)for(let e of this.listeners)try{e(n)}catch(e){this.report?.error(t.TASK_EVENT.storeListenerFailed,e,{[l]:this.storePath})}}stopWatching(){this.watcher?.close(),this.watcher=void 0,this.pollTimer&&clearInterval(this.pollTimer),this.pollTimer=void 0,clearTimeout(this.debounceTimer),this.debounceTimer=void 0}dispose(){this.listeners.clear(),this.stopWatching()}};exports.TaskStore=f;
-//# sourceMappingURL=taskStore.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../adapters/store/taskStore.cjs");require("../services/store/taskStore.cjs"),exports.TaskStore=e.TaskStore;

package/dist/store/taskStore.d.cts

@@ -1,77 +1,3 @@
-import { TaskFailureReporter } from "../logSinkTelemetry.cjs";
-import { TaskDocument } from "./types.cjs";
-//#region src/store/taskStore.d.ts
-interface TaskStoreOptions {
-  cwd?: string;
-  env?: NodeJS.ProcessEnv;
-  storePath?: string;
-  /** Backstop poll cadence for change detection. Lowered in tests so they do
-   * not depend on `fs.watch`, whose delivery timing is platform-dependent. */
-  pollIntervalMs?: number;
-  /** How long to wait for the advisory lock before proceeding lock-free. */
-  lockTimeoutMs?: number;
-  /** Where swallowed failures go, so silent degradation stays visible. */
-  report?: TaskFailureReporter;
-}
-/**
- * File-backed task store shared by one root session and its delegated children.
- *
- * Durability model: the JSON file is the source of truth. Mutations are
- * read-modify-write under an advisory lock so concurrent delegated processes
- * cannot clobber each other, and writes land via temp-file rename so a
- * crash mid-write can never leave a partial document behind.
- */
-declare class TaskStore {
-  storePath: string;
-  private readonly cwd;
-  private readonly env;
-  private cached;
-  private lastKnownRev;
-  private watcher?;
-  private pollTimer?;
-  private debounceTimer?;
-  private readonly listeners;
-  private readonly pollIntervalMs;
-  private readonly lockTimeoutMs;
-  private readonly report?;
-  constructor(options?: TaskStoreOptions);
-  /** Bind a default store to the current session tree before reading or watching it. */
-  configureSession(sessionKey: string): void;
-  /** Last document read from disk, without hitting the filesystem. */
-  get snapshot(): TaskDocument;
-  read(): TaskDocument;
-  /**
-   * Apply a mutation under the store lock.
-   *
-   * `mutate` receives the freshest on-disk document and returns either the next
-   * document to commit or `undefined` for a read-only action (list/get), which
-   * skips the write entirely so queries never bump `rev`.
-   */
-  mutate<T>(mutate: (document: TaskDocument) => {
-    document?: TaskDocument;
-    value: T;
-  }): Promise<{
-    document: TaskDocument;
-    value: T;
-  }>;
-  private write;
-  private acquireLock;
-  /** Remove a lock left behind by a dead process or one held implausibly long. */
-  private breakStaleLock;
-  /**
-   * Notify when another process changes the store.
-   *
-   * `fs.watch` alone is unreliable across the rename-based write (and on some
-   * network filesystems), so a slow poll backs it up. Writes made by this
-   * process are filtered out by revision so the UI does not redraw twice.
-   */
-  onExternalChange(listener: (document: TaskDocument) => void): () => void;
-  private startWatching;
-  private scheduleCheck;
-  private checkForChange;
-  private stopWatching;
-  dispose(): void;
-}
-//#endregion
-export { TaskStore, TaskStoreOptions };
-//# sourceMappingURL=taskStore.d.cts.map
+import { TaskStore, TaskStoreCommitListener, TaskStoreOptions } from "../adapters/store/taskStore.cjs";
+import "../services/store/taskStore.cjs";
+export { TaskStore, type TaskStoreCommitListener, type TaskStoreOptions };

package/dist/store/taskStore.d.mts

@@ -1,77 +1,3 @@
-import { TaskFailureReporter } from "../logSinkTelemetry.mjs";
-import { TaskDocument } from "./types.mjs";
-//#region src/store/taskStore.d.ts
-interface TaskStoreOptions {
-  cwd?: string;
-  env?: NodeJS.ProcessEnv;
-  storePath?: string;
-  /** Backstop poll cadence for change detection. Lowered in tests so they do
-   * not depend on `fs.watch`, whose delivery timing is platform-dependent. */
-  pollIntervalMs?: number;
-  /** How long to wait for the advisory lock before proceeding lock-free. */
-  lockTimeoutMs?: number;
-  /** Where swallowed failures go, so silent degradation stays visible. */
-  report?: TaskFailureReporter;
-}
-/**
- * File-backed task store shared by one root session and its delegated children.
- *
- * Durability model: the JSON file is the source of truth. Mutations are
- * read-modify-write under an advisory lock so concurrent delegated processes
- * cannot clobber each other, and writes land via temp-file rename so a
- * crash mid-write can never leave a partial document behind.
- */
-declare class TaskStore {
-  storePath: string;
-  private readonly cwd;
-  private readonly env;
-  private cached;
-  private lastKnownRev;
-  private watcher?;
-  private pollTimer?;
-  private debounceTimer?;
-  private readonly listeners;
-  private readonly pollIntervalMs;
-  private readonly lockTimeoutMs;
-  private readonly report?;
-  constructor(options?: TaskStoreOptions);
-  /** Bind a default store to the current session tree before reading or watching it. */
-  configureSession(sessionKey: string): void;
-  /** Last document read from disk, without hitting the filesystem. */
-  get snapshot(): TaskDocument;
-  read(): TaskDocument;
-  /**
-   * Apply a mutation under the store lock.
-   *
-   * `mutate` receives the freshest on-disk document and returns either the next
-   * document to commit or `undefined` for a read-only action (list/get), which
-   * skips the write entirely so queries never bump `rev`.
-   */
-  mutate<T>(mutate: (document: TaskDocument) => {
-    document?: TaskDocument;
-    value: T;
-  }): Promise<{
-    document: TaskDocument;
-    value: T;
-  }>;
-  private write;
-  private acquireLock;
-  /** Remove a lock left behind by a dead process or one held implausibly long. */
-  private breakStaleLock;
-  /**
-   * Notify when another process changes the store.
-   *
-   * `fs.watch` alone is unreliable across the rename-based write (and on some
-   * network filesystems), so a slow poll backs it up. Writes made by this
-   * process are filtered out by revision so the UI does not redraw twice.
-   */
-  onExternalChange(listener: (document: TaskDocument) => void): () => void;
-  private startWatching;
-  private scheduleCheck;
-  private checkForChange;
-  private stopWatching;
-  dispose(): void;
-}
-//#endregion
-export { TaskStore, TaskStoreOptions };
-//# sourceMappingURL=taskStore.d.mts.map
+import { TaskStore, TaskStoreCommitListener, TaskStoreOptions } from "../adapters/store/taskStore.mjs";
+import "../services/store/taskStore.mjs";
+export { TaskStore, type TaskStoreCommitListener, type TaskStoreOptions };

package/dist/store/taskStore.mjs

@@ -1,2 +1 @@
-import{TASK_EVENT as e}from"../logSinkTelemetry.mjs";import{isProcessAlive as t}from"./processLiveness.mjs";import{emptyDocument as n}from"./types.mjs";import{lockPathFor as r,resolveStorePath as i,tempPathFor as a}from"./paths.mjs";import o from"node:path";import s from"node:fs";const c=`utf8`,l=`ENOENT`,u=`store.path`;function d(e){return new Promise(t=>setTimeout(t,e))}function f(e){if(!e||typeof e!=`object`)return n();let t=e;if(!Array.isArray(t.tasks))return n();let r=t.tasks.filter(e=>!!e&&typeof e==`object`&&typeof e.id==`number`),i=r.reduce((e,t)=>Math.max(e,t.id),0);return{version:typeof t.version==`number`?t.version:1,rev:typeof t.rev==`number`?t.rev:0,nextId:typeof t.nextId==`number`&&t.nextId>i?t.nextId:i+1,tasks:r}}var p=class{storePath;cwd;env;cached=n();lastKnownRev=-1;watcher;pollTimer;debounceTimer;listeners=new Set;pollIntervalMs;lockTimeoutMs;report;constructor(e={}){this.cwd=e.cwd??process.cwd(),this.env=e.env??process.env,this.storePath=e.storePath??i(this.cwd,this.env),this.pollIntervalMs=e.pollIntervalMs??2e3,this.lockTimeoutMs=e.lockTimeoutMs??2e3,this.report=e.report}configureSession(e){this.env.DOOM_TASK_STORE?.trim()||(this.stopWatching(),this.storePath=i(this.cwd,this.env,e),this.cached=n(),this.lastKnownRev=-1)}get snapshot(){return this.cached}read(){try{let e=s.readFileSync(this.storePath,c);this.cached=f(JSON.parse(e))}catch(t){t.code!==l&&this.report?.error(e.storeReadFailed,t,{[u]:this.storePath}),this.cached=n()}return this.lastKnownRev=this.cached.rev,this.cached}async mutate(e){let t=await this.acquireLock();try{let t=this.read(),n=e(t);return n.document?{document:this.write(n.document),value:n.value}:{document:t,value:n.value}}finally{t()}}write(e){let t={...e,version:1,rev:e.rev+1};s.mkdirSync(o.dirname(this.storePath),{recursive:!0});let n=a(this.storePath);return s.writeFileSync(n,`${JSON.stringify(t,void 0,2)}\n`,c),s.renameSync(n,this.storePath),this.cached=t,this.lastKnownRev=t.rev,t}async acquireLock(){let t=r(this.storePath);s.mkdirSync(o.dirname(this.storePath),{recursive:!0});let n=Date.now()+this.lockTimeoutMs;for(;;)try{let e=s.openSync(t,`wx`);return s.writeSync(e,JSON.stringify({pid:process.pid,time:Date.now()})),s.closeSync(e),()=>s.rmSync(t,{force:!0})}catch(r){if(r.code!==`EEXIST`)throw r;if(Date.now()>=n)return this.report?.warn(e.storeLockTimeout,Error(`Task store lock still held after ${this.lockTimeoutMs}ms; proceeding without it`),{[u]:this.storePath}),()=>{};this.breakStaleLock(t),await d(10+Math.random()*60)}}breakStaleLock(n){try{let e=JSON.parse(s.readFileSync(n,c)),r=typeof e.time==`number`&&Date.now()-e.time>1e4,i=typeof e.pid==`number`&&!t(e.pid);return!r&&!i?!1:(s.unlinkSync(n),!0)}catch(t){return t.code!==l&&this.report?.warn(e.storeLockBreakFailed,t,{[u]:n}),!1}}onExternalChange(e){return this.listeners.add(e),this.startWatching(),()=>{this.listeners.delete(e),this.listeners.size===0&&this.stopWatching()}}startWatching(){if(this.watcher||this.pollTimer)return;let t=o.dirname(this.storePath),n=o.basename(this.storePath);try{s.mkdirSync(t,{recursive:!0}),this.watcher=s.watch(t,(e,t)=>{t&&t!==n||this.scheduleCheck()})}catch(t){this.report?.warn(e.storeWatchFailed,t,{[u]:this.storePath})}this.pollTimer=setInterval(()=>this.checkForChange(),this.pollIntervalMs),this.pollTimer.unref?.()}scheduleCheck(){clearTimeout(this.debounceTimer),this.debounceTimer=setTimeout(()=>this.checkForChange(),150),this.debounceTimer.unref?.()}checkForChange(){let t=this.lastKnownRev,n=this.read();if(n.rev!==t)for(let t of this.listeners)try{t(n)}catch(t){this.report?.error(e.storeListenerFailed,t,{[u]:this.storePath})}}stopWatching(){this.watcher?.close(),this.watcher=void 0,this.pollTimer&&clearInterval(this.pollTimer),this.pollTimer=void 0,clearTimeout(this.debounceTimer),this.debounceTimer=void 0}dispose(){this.listeners.clear(),this.stopWatching()}};export{p as TaskStore};
-//# sourceMappingURL=taskStore.mjs.map
+import{TaskStore as e}from"../adapters/store/taskStore.mjs";import"../services/store/taskStore.mjs";export{e as TaskStore};

package/dist/store/types.cjs

@@ -1,2 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(){return{version:1,rev:0,nextId:1,tasks:[]}}function t(e){let t=e.delegation?.state;return t===`requested`||t===`running`}exports.DELETED_STATUS=`deleted`,exports.STORE_SCHEMA_VERSION=1,exports.emptyDocument=e,exports.isDelegationActive=t;
-//# sourceMappingURL=types.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../services/store/types.cjs");exports.DELETED_STATUS=e.DELETED_STATUS,exports.STORE_SCHEMA_VERSION=e.STORE_SCHEMA_VERSION,exports.emptyDocument=e.emptyDocument,exports.isDelegationActive=e.isDelegationActive;

package/dist/store/types.d.cts

@@ -1,165 +1,2 @@
-import { InlineAgent } from "@agimon-ai/doompi-extension-contracts/subagent-tool";
-//#region src/store/types.d.ts
-type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'deleted';
-declare const DELETED_STATUS: TaskStatus;
-type TaskAction = 'upsert' | 'list' | 'get' | 'delete' | 'clear' | 'assign' | 'cancel';
-type DelegationState = 'requested' | 'running' | 'completed' | 'failed' | 'cancelled';
-/** Terminal result of a delegated subagent run, copied off the delegation response. */
-interface DelegationResult {
-  status: string;
-  output?: string;
-  outputPath?: string;
-  sessionFile?: string;
-  error?: string;
-  durationMs?: number;
-  toolCount?: number;
-}
-/**
- * Delegation bookkeeping attached to a task that was handed to a subagent.
- *
- * `pid` is the harness process that owns the run: it is the only way to tell an
- * genuinely-running delegation from one orphaned by a harness crash, since the
- * child dies with its parent but the file survives.
- */
-interface TaskDelegation {
-  requestId: string;
-  agent: string;
-  state: DelegationState;
-  sessionId?: string;
-  pid?: number;
-  runId?: string;
-  model?: string;
-  startedAt?: string;
-  endedAt?: string;
-  result?: DelegationResult;
-}
-interface Task {
-  id: number;
-  subject: string;
-  description?: string;
-  activeForm?: string;
-  status: TaskStatus;
-  blockedBy?: number[];
-  owner?: string;
-  metadata?: Record<string, unknown>;
-  createdAt?: string;
-  updatedAt?: string;
-  delegation?: TaskDelegation;
-}
-declare const STORE_SCHEMA_VERSION = 1;
-/** The complete on-disk document. `rev` increments on every committed write. */
-interface TaskDocument {
-  version: number;
-  rev: number;
-  nextId: number;
-  tasks: Task[];
-}
-declare function emptyDocument(): TaskDocument;
-/**
- * A dependency target inside an upsert item: an existing task id, or the `ref`
- * of a task created earlier in the same call.
- *
- * Refs must start with a letter (see `REF_PATTERN`), so a ref is structurally
- * unconfusable with a stringified id and the discrimination is just `typeof`.
- */
-type DepToken = number | string;
-/**
- * One entry of an `upsert` call. No `id` creates a task; an `id` updates one.
- *
- * `blockedBy` (absolute set) is create-only and `addBlockedBy`/`removeBlockedBy`
- * (additive merge) are update-only, matching the split the two former actions
- * had. A field used against the wrong kind fails that item rather than being
- * silently ignored.
- */
-interface TaskItemMutation {
-  id?: number;
-  ref?: string;
-  subject?: string;
-  description?: string;
-  activeForm?: string;
-  status?: TaskStatus;
-  blockedBy?: DepToken[];
-  addBlockedBy?: DepToken[];
-  removeBlockedBy?: DepToken[];
-  owner?: string;
-  metadata?: Record<string, unknown>;
-}
-/**
- * What one upsert item did. `index` is its position in the request array, so a
- * model reading a partial result can tell which entries still need resending.
- *
- * `message` is unprefixed: the `item[N] failed:` framing belongs to the
- * formatter, because the Task Space overlay shows this text on its own.
- */
-type UpsertItemOutcome = {
-  index: number;
-  kind: 'created';
-  id: number;
-  subject: string;
-  status: TaskStatus;
-  ref?: string;
-  blockedBy?: number[];
-} | {
-  index: number;
-  kind: 'updated';
-  id: number;
-  fromStatus: TaskStatus;
-  toStatus: TaskStatus;
-} | {
-  index: number;
-  kind: 'unchanged';
-  id: number;
-  status: TaskStatus;
-} | {
-  index: number;
-  kind: 'failed';
-  message: string;
-  id?: number;
-  ref?: string;
-};
-/** Which tasks an upsert touched, so renderResult names them instead of guessing. */
-interface UpsertSummary {
-  /** Ids of applied entries, in request order. A failed entry contributes nothing. */
-  applied: number[];
-  failed: number;
-}
-/**
- * Open-shape input bag the reducer accepts. The index signature lets the
- * runtime pass a TypeBox `Static<typeof TaskParamsSchema>` through without
- * casting each field.
- *
- * Per-task fields live on `tasks[]`, not here: a top-level `subject` or
- * `status` would be ambiguous once one call can carry many tasks.
- */
-interface TaskMutationParams {
-  [key: string]: unknown;
-  tasks?: TaskItemMutation[];
-  /** `list` filter only. To set a status, upsert the task by id. */
-  status?: TaskStatus;
-  /** `get`, `delete`, `assign` and `cancel` only. */
-  id?: number;
-  includeDeleted?: boolean;
-  agent?: string;
-  inlineAgent?: InlineAgent;
-  instructions?: string;
-  /** `assign` only: the context pack the parent hands to the child. */
-  relevantFiles?: string[];
-  priorFindings?: string;
-  model?: string;
-  context?: 'fresh' | 'fork';
-}
-/** Snapshot returned under a tool result's `details` for renderResult. */
-interface TaskDetails {
-  action: TaskAction;
-  params: Record<string, unknown>;
-  tasks: Task[];
-  nextId: number;
-  rev: number;
-  error?: string;
-  upsert?: UpsertSummary;
-}
-/** A delegation is "live" while the owning run may still produce a response. */
-declare function isDelegationActive(task: Task): boolean;
-//#endregion
-export { DELETED_STATUS, DelegationResult, DelegationState, DepToken, STORE_SCHEMA_VERSION, Task, TaskAction, TaskDelegation, TaskDetails, TaskDocument, TaskItemMutation, TaskMutationParams, TaskStatus, UpsertItemOutcome, UpsertSummary, emptyDocument, isDelegationActive };
-//# sourceMappingURL=types.d.cts.map
+import { DELETED_STATUS, DelegationResult, DelegationState, DepToken, STORE_SCHEMA_VERSION, Task, TaskAction, TaskDelegation, TaskDetails, TaskDocument, TaskItemMutation, TaskMutationParams, TaskStatus, UpsertItemOutcome, UpsertSummary, emptyDocument, isDelegationActive } from "../services/store/types.cjs";
+export { DELETED_STATUS, DelegationResult, DelegationState, DepToken, STORE_SCHEMA_VERSION, Task, TaskAction, TaskDelegation, TaskDetails, TaskDocument, TaskItemMutation, TaskMutationParams, TaskStatus, UpsertItemOutcome, UpsertSummary, emptyDocument, isDelegationActive };

package/dist/store/types.d.mts

@@ -1,165 +1,2 @@
-import { InlineAgent } from "@agimon-ai/doompi-extension-contracts/subagent-tool";
-//#region src/store/types.d.ts
-type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'deleted';
-declare const DELETED_STATUS: TaskStatus;
-type TaskAction = 'upsert' | 'list' | 'get' | 'delete' | 'clear' | 'assign' | 'cancel';
-type DelegationState = 'requested' | 'running' | 'completed' | 'failed' | 'cancelled';
-/** Terminal result of a delegated subagent run, copied off the delegation response. */
-interface DelegationResult {
-  status: string;
-  output?: string;
-  outputPath?: string;
-  sessionFile?: string;
-  error?: string;
-  durationMs?: number;
-  toolCount?: number;
-}
-/**
- * Delegation bookkeeping attached to a task that was handed to a subagent.
- *
- * `pid` is the harness process that owns the run: it is the only way to tell an
- * genuinely-running delegation from one orphaned by a harness crash, since the
- * child dies with its parent but the file survives.
- */
-interface TaskDelegation {
-  requestId: string;
-  agent: string;
-  state: DelegationState;
-  sessionId?: string;
-  pid?: number;
-  runId?: string;
-  model?: string;
-  startedAt?: string;
-  endedAt?: string;
-  result?: DelegationResult;
-}
-interface Task {
-  id: number;
-  subject: string;
-  description?: string;
-  activeForm?: string;
-  status: TaskStatus;
-  blockedBy?: number[];
-  owner?: string;
-  metadata?: Record<string, unknown>;
-  createdAt?: string;
-  updatedAt?: string;
-  delegation?: TaskDelegation;
-}
-declare const STORE_SCHEMA_VERSION = 1;
-/** The complete on-disk document. `rev` increments on every committed write. */
-interface TaskDocument {
-  version: number;
-  rev: number;
-  nextId: number;
-  tasks: Task[];
-}
-declare function emptyDocument(): TaskDocument;
-/**
- * A dependency target inside an upsert item: an existing task id, or the `ref`
- * of a task created earlier in the same call.
- *
- * Refs must start with a letter (see `REF_PATTERN`), so a ref is structurally
- * unconfusable with a stringified id and the discrimination is just `typeof`.
- */
-type DepToken = number | string;
-/**
- * One entry of an `upsert` call. No `id` creates a task; an `id` updates one.
- *
- * `blockedBy` (absolute set) is create-only and `addBlockedBy`/`removeBlockedBy`
- * (additive merge) are update-only, matching the split the two former actions
- * had. A field used against the wrong kind fails that item rather than being
- * silently ignored.
- */
-interface TaskItemMutation {
-  id?: number;
-  ref?: string;
-  subject?: string;
-  description?: string;
-  activeForm?: string;
-  status?: TaskStatus;
-  blockedBy?: DepToken[];
-  addBlockedBy?: DepToken[];
-  removeBlockedBy?: DepToken[];
-  owner?: string;
-  metadata?: Record<string, unknown>;
-}
-/**
- * What one upsert item did. `index` is its position in the request array, so a
- * model reading a partial result can tell which entries still need resending.
- *
- * `message` is unprefixed: the `item[N] failed:` framing belongs to the
- * formatter, because the Task Space overlay shows this text on its own.
- */
-type UpsertItemOutcome = {
-  index: number;
-  kind: 'created';
-  id: number;
-  subject: string;
-  status: TaskStatus;
-  ref?: string;
-  blockedBy?: number[];
-} | {
-  index: number;
-  kind: 'updated';
-  id: number;
-  fromStatus: TaskStatus;
-  toStatus: TaskStatus;
-} | {
-  index: number;
-  kind: 'unchanged';
-  id: number;
-  status: TaskStatus;
-} | {
-  index: number;
-  kind: 'failed';
-  message: string;
-  id?: number;
-  ref?: string;
-};
-/** Which tasks an upsert touched, so renderResult names them instead of guessing. */
-interface UpsertSummary {
-  /** Ids of applied entries, in request order. A failed entry contributes nothing. */
-  applied: number[];
-  failed: number;
-}
-/**
- * Open-shape input bag the reducer accepts. The index signature lets the
- * runtime pass a TypeBox `Static<typeof TaskParamsSchema>` through without
- * casting each field.
- *
- * Per-task fields live on `tasks[]`, not here: a top-level `subject` or
- * `status` would be ambiguous once one call can carry many tasks.
- */
-interface TaskMutationParams {
-  [key: string]: unknown;
-  tasks?: TaskItemMutation[];
-  /** `list` filter only. To set a status, upsert the task by id. */
-  status?: TaskStatus;
-  /** `get`, `delete`, `assign` and `cancel` only. */
-  id?: number;
-  includeDeleted?: boolean;
-  agent?: string;
-  inlineAgent?: InlineAgent;
-  instructions?: string;
-  /** `assign` only: the context pack the parent hands to the child. */
-  relevantFiles?: string[];
-  priorFindings?: string;
-  model?: string;
-  context?: 'fresh' | 'fork';
-}
-/** Snapshot returned under a tool result's `details` for renderResult. */
-interface TaskDetails {
-  action: TaskAction;
-  params: Record<string, unknown>;
-  tasks: Task[];
-  nextId: number;
-  rev: number;
-  error?: string;
-  upsert?: UpsertSummary;
-}
-/** A delegation is "live" while the owning run may still produce a response. */
-declare function isDelegationActive(task: Task): boolean;
-//#endregion
-export { DELETED_STATUS, DelegationResult, DelegationState, DepToken, STORE_SCHEMA_VERSION, Task, TaskAction, TaskDelegation, TaskDetails, TaskDocument, TaskItemMutation, TaskMutationParams, TaskStatus, UpsertItemOutcome, UpsertSummary, emptyDocument, isDelegationActive };
-//# sourceMappingURL=types.d.mts.map
+import { DELETED_STATUS, DelegationResult, DelegationState, DepToken, STORE_SCHEMA_VERSION, Task, TaskAction, TaskDelegation, TaskDetails, TaskDocument, TaskItemMutation, TaskMutationParams, TaskStatus, UpsertItemOutcome, UpsertSummary, emptyDocument, isDelegationActive } from "../services/store/types.mjs";
+export { DELETED_STATUS, DelegationResult, DelegationState, DepToken, STORE_SCHEMA_VERSION, Task, TaskAction, TaskDelegation, TaskDetails, TaskDocument, TaskItemMutation, TaskMutationParams, TaskStatus, UpsertItemOutcome, UpsertSummary, emptyDocument, isDelegationActive };

package/dist/store/types.mjs

@@ -1,2 +1 @@
-const e=`deleted`,t=1;function n(){return{version:1,rev:0,nextId:1,tasks:[]}}function r(e){let t=e.delegation?.state;return t===`requested`||t===`running`}export{e as DELETED_STATUS,t as STORE_SCHEMA_VERSION,n as emptyDocument,r as isDelegationActive};
-//# sourceMappingURL=types.mjs.map
+import{DELETED_STATUS as e,STORE_SCHEMA_VERSION as t,emptyDocument as n,isDelegationActive as r}from"../services/store/types.mjs";export{e as DELETED_STATUS,t as STORE_SCHEMA_VERSION,n as emptyDocument,r as isDelegationActive};

package/dist/tool/promptGuidelines.cjs

@@ -1,2 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=["Use `task` for work with 3+ steps, when the user gives you a list of tasks, or immediately after receiving new instructions to capture requirements. Skip it for single trivial tasks and purely conversational requests.",`Capture a whole plan in one call: {"action":"upsert","tasks":[{"subject":"Research existing tool"},{"subject":"Write the reducer"},{"subject":"Add tests"}]}. Batch whenever you are writing the plan down — the initial list, a revised plan, or wiring dependencies across several tasks — because one call keeps ids and blockers consistent and shows the user the whole plan at once.`,`Do not batch progress. Mark a task in_progress with its own call BEFORE beginning work, and completed with its own call IMMEDIATELY when it is done. upsert accepts many tasks, but a batch of completions sent at the end of a turn is still wrong: batching is for writing a plan down, single calls are for reporting progress, and the user watches the task list to see where you are. Exactly one task should be in_progress for your own work; delegated tasks run in parallel and do not count against that.`,`Never mark a task completed if tests are failing, the implementation is partial, or you hit unresolved errors, use status "failed" or keep it in_progress and add a new task for the blocker in the same upsert.`,`When every non-deleted task is completed, review the full task list once more and call task {"action":"clear"} to close it. Do not leave an all-completed list open.`,`Status is a state machine: pending → in_progress → completed, plus failed (recoverable, can go back to pending or in_progress) and deleted as a tombstone. Pass activeForm (present-continuous, e.g. 'writing tests') when marking in_progress.`,`One call does both: an entry with an id changes that task, an entry without an id creates one. To change status, upsert the task by id, e.g. {"action":"upsert","tasks":[{"id":3,"status":"completed"}]}. Never omit the id when you meant to change an existing task — an entry with no id creates a new one instead. An entry that carries an id and no other field is rejected.`,`Use blockedBy for dependencies (A is blocked by B). On an entry with no id pass blockedBy as the initial set; on an entry with an id use addBlockedBy / removeBlockedBy (additive merge, do not resend the full array). To depend on a task created earlier in the SAME call, give that earlier entry a "ref" and list the ref string in place of an id: [{"ref":"api","subject":"Design the API"},{"subject":"Implement the API","blockedBy":["api"]}]. A ref must be declared before it is used. Cycles are rejected.`,`upsert applies each entry independently: the entries that pass are committed and the failures are reported with their array index. A failed entry changed nothing, so resend only the corrected failures — never resend the whole call, because an already-applied entry with no id would create a duplicate task.`,`Before assigning work, call subagent with {"action":"agents"} and match each task to an exact discovered agent name. Prefer a discovered general-purpose write-capable agent such as delegate or worker when no specialist fits. Use a focused inlineAgent only for read-only work.`,`Assign every unblocked pending task with task {"action":"assign","id":3,"agent":"reviewer"}, including implementation tasks. Do not use a direct subagent run for work already represented in the shared task list. Use task assign so ownership and terminal results stay visible.`,`Hand over what you already know when you assign. Pass relevantFiles with the paths you have actually read or located for that task, and priorFindings with the facts you established: symbol names, call sites, the approach you picked, what you ruled out. The child starts with none of your context and will otherwise spend most of its run re-reading the repo. Send at most a dozen files and only ones you really opened — a guessed path costs the child more than an omitted one — and keep priorFindings to a few lines of facts, not directives.`,`After assigning work, continue non-overlapping parent work or end the turn and wait. Do not poll or duplicate delegated scope.`,`When a delegated task completes and unblocks another task, repeat agent discovery if needed and assign that newly eligible task promptly. Do not poll in a loop. Completion notifications wake the parent session.`,`If a child asks for a decision through intercom, or an assignment fails to start for another concrete issue, respond, rescope, or retry explicitly. Do not silently leave the task pending.`,`assign refuses tasks that are blocked, already delegated, or completed. Resolve blockers first. Use {"action":"cancel","id":3} to stop a running delegation; the task returns to pending.`,`Doom Task records delegated lifecycle and results on the shared task. The child does not update task status directly. Read the completion or failure result before deciding what to do next.`,`The task list is scoped to this session tree: delegated subagents share it, while unrelated sessions start empty. It persists for later inspection until retention cleanup.`,`Subject must be short and imperative (e.g. 'Research existing tool'); description is long-form detail written when you plan the task, and the delegated brief is that description plus the assign-time instructions, relevantFiles and priorFindings. Put durable scope in description and what you learned while exploring in the assign-time pack — do not repeat one in the other.`];exports.DEFAULT_PROMPT_GUIDELINES=e;
-//# sourceMappingURL=promptGuidelines.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../commands/task/promptGuidelines.cjs");exports.DEFAULT_PROMPT_GUIDELINES=e.DEFAULT_PROMPT_GUIDELINES;

package/dist/tool/promptGuidelines.d.cts

@@ -1,5 +1,2 @@
-//#region src/tool/promptGuidelines.d.ts
-declare const DEFAULT_PROMPT_GUIDELINES: string[];
-//#endregion
-export { DEFAULT_PROMPT_GUIDELINES };
-//# sourceMappingURL=promptGuidelines.d.cts.map
+import { DEFAULT_PROMPT_GUIDELINES } from "../commands/task/promptGuidelines.cjs";
+export { DEFAULT_PROMPT_GUIDELINES };