@a5c-ai/babysitter-sdk 0.0.186 → 0.0.187-staging.02a0ee21

package/dist/prompts/templates/process-creation.md

@@ -55,7 +55,14 @@ After the process is created and before creating the run:
 - wrong: skipping repo/process-library research before writing the process
 - wrong: bypassing the orchestration model with helper scripts or inline logic
 - wrong: using `kind: 'node'` in generated tasks
-- correct: use `agent` or `skill` tasks for reasoning work, with `shell` only
-  for existing CLIs, tests, linters, git, or builds
+- wrong: using `kind: 'agent'` for deterministic verification (compilation,
+  linting, test execution, grep checks, dependency validation) -- these MUST
+  use `kind: 'shell'` with `expectedExitCode` for binary pass/fail enforcement
+- correct: use `agent` or `skill` tasks for reasoning work (planning, code
+  review, architecture assessment, subjective evaluation)
+- correct: use `shell` tasks for all objectively verifiable checks (tsc, eslint,
+  vitest, grep, dependency imports, runtime smoke tests)
 - correct: include verification loops, refinement loops, quality gates, and
   breakpoints where appropriate
+- correct: pair shell verification gates with agent analysis tasks (shell runs
+  the check, agent interprets failures and suggests fixes)

package/dist/prompts/templates/process-guidelines.md

@@ -75,8 +75,11 @@ specified:
   - Integrate/link the main pages (or entry points) with functionality created
     for every phase of the development process
   - Quality gated iterative and convergent development/refinement loops
-  - Test driven -- where quality gates can use executable tools, scripts, and
-    tests to verify accuracy and completeness
+  - Test driven -- where quality gates use `kind: 'shell'` tasks with
+    `expectedExitCode` for deterministic verification (compilation, linting,
+    test suites, grep checks, dependency availability, runtime smoke tests).
+    Reserve `kind: 'agent'` for subjective assessment only (code review,
+    architecture evaluation, UX quality)
   - Integration phases for each new functionality in every milestone
   - Where relevant -- beautiful and polished UX with pixel-perfect verification
   - Accurate and complete implementation of the user request

package/dist/prompts/templates/run-overlap-detection.md

@@ -0,0 +1,63 @@
+### 2.0 Run Overlap Detection
+
+Before calling `$CLI run:create`, scan for recent runs that may already cover
+the same work. This avoids creating duplicate runs that waste tokens and
+complicate the run history.
+
+**Scan procedure:**
+
+1. List recent run directories:
+   ```bash
+   ls -lt .a5c/runs/ | head -20
+   ```
+2. For each run created within the last 30 minutes, read its metadata:
+   ```bash
+   cat .a5c/runs/<runId>/run.json
+   ```
+3. Compare the candidate run's `prompt` and `processId` against the new
+   request:
+   - **Keyword overlap**: does the existing prompt share 3 or more significant
+     keywords with the new prompt?
+   - **Process match**: does `processId` match the process you intend to use?
+4. If overlap is detected, check its current status:
+   ```bash
+   $CLI run:status .a5c/runs/<runId>
+   ```
+
+**If an overlapping run is found:**
+
+{{#interactive}}
+Surface a clear warning to the user with the similar run's details:
+
+- Run ID: `<runId>`
+- Process: `<processId>`
+- Created: `<createdAt>`
+- Status: `<status>`
+- Prompt excerpt: `<first 120 chars of prompt>`
+
+Ask the user to choose one of:
+1. **Proceed** — create a new run anyway (e.g., intentional retry or variant)
+2. **Skip** — abort run creation; the existing run already covers the request
+3. **Resume** — resume the existing run via `$CLI run:iterate .a5c/runs/<runId>`
+
+Do not proceed with `run:create` until the user has responded.
+{{/interactive}}
+{{^interactive}}
+Log a warning with the overlapping run's details (runId, processId, createdAt,
+status) and continue creating the new run. Non-interactive mode does not block
+on overlap — the caller is responsible for deduplication.
+{{/interactive}}
+
+**No overlap found:** proceed directly to `$CLI run:create` as normal.
+
+**Tracking run chains:**
+
+When creating a run that intentionally follows or retries a previous run,
+include the related run ID in the inputs so the process can reference it:
+
+```json
+{
+  "relatedRunId": "<previousRunId>",
+  "relatedRunReason": "retry|variant|follow-up"
+}
+```

package/dist/prompts/templates/task-examples.md

@@ -37,6 +37,53 @@ export const agentTask = defineTask('agent-scorer', (args, taskCtx) => ({
 }));
 ```
 
+### Shell Verification Task Example
+
+Use shell tasks for all deterministic verification gates. Shell tasks produce
+binary pass/fail results via exit codes that cannot be bypassed by agent
+reasoning.
+
+```javascript
+// Grep-based integration check
+export const grepCheckTask = defineTask('grep-integration-check', (args, taskCtx) => ({
+  kind: 'shell',
+  title: 'Verify integration points exist',
+  shell: {
+    command: `cd ${args.projectDir || '.'} && grep -q "${args.pattern}" ${args.file}`,
+    expectedExitCode: 0,
+    timeout: 10000
+  },
+  io: {
+    inputJsonPath: `tasks/${taskCtx.effectId}/input.json`,
+    outputJsonPath: `tasks/${taskCtx.effectId}/output.json`
+  }
+}));
+
+// Multi-check verification gate
+export const verificationGateTask = defineTask('verification-gate', (args, taskCtx) => ({
+  kind: 'shell',
+  title: 'Deterministic verification gate',
+  shell: {
+    command: [
+      `cd ${args.projectDir || '.'}`,
+      'npx tsc --noEmit',
+      'npx eslint src/ --max-warnings=0',
+      'npx vitest run --reporter=verbose'
+    ].join(' && '),
+    expectedExitCode: 0,
+    timeout: 300000
+  },
+  io: {
+    inputJsonPath: `tasks/${taskCtx.effectId}/input.json`,
+    outputJsonPath: `tasks/${taskCtx.effectId}/output.json`
+  }
+}));
+```
+
+Use `library/processes/shared/deterministic-quality-gate.js` for composable
+preset gates (createGrepCheck, createCompilationGate, createTestSuiteGate,
+createRuntimeSmokeTest).
+
 ### Skill Task Example
 
 Important: Check which skills are actually available before assigning the skill

package/dist/prompts/templates/task-kinds.md

@@ -10,12 +10,54 @@ build tools), `breakpoint` (human approval), and `sleep` (time gates).
 | Kind | Description | Executor | When to use |
 |------|-------------|----------|-------------|
 | ~~`node`~~ | ~~Node.js script~~ | ~~Local node process~~ | **NEVER -- forbidden. Convert to `agent` or `skill`.** |
-| `shell` | Shell command | Local shell process | Only for running existing CLI tools, test suites, git, linters, builds. The orchestrating agent must execute it intentionally and post the result |
-| `agent` | LLM agent | Agent runtime | **Default for all tasks** -- planning, implementation, analysis, verification, scoring, debugging, code writing, research |
+| `shell` | Shell command | Local shell process | **Deterministic verification** (compilation, linting, tests, grep, dependency checks, smoke tests) AND running existing CLI tools, git, builds. The orchestrating agent must execute it intentionally and post the result |
+| `agent` | LLM agent | Agent runtime | **Default for reasoning tasks** -- planning, implementation, analysis, scoring, debugging, code writing, research. Also for **subjective verification** (code review, architecture assessment, UX evaluation) |
 | `skill` | {{skillSystemLabel}} | Skill system | When a matching installed skill exists (preferred over agent when available) |
 | `breakpoint` | Human approval | UI/CLI | Decision gates requiring user input |
 | `sleep` | Time gate | Scheduler | Time-based pauses |
 
+### Shell vs Agent for Verification Tasks
+
+**CRITICAL:** Verification tasks that produce deterministic, binary pass/fail
+results MUST use `kind: 'shell'` with `expectedExitCode`, NOT `kind: 'agent'`.
+Agent-interpreted verification creates soft gates where an LLM subjectively
+assesses pass/fail -- this is unreliable for objectively testable checks.
+
+| Verification type | Correct kind | Why |
+|-------------------|-------------|-----|
+| Compilation (tsc, gcc) | `shell` | Exit code is deterministic pass/fail |
+| Linting (eslint, ruff) | `shell` | Exit code is deterministic pass/fail |
+| Test suites (vitest, jest) | `shell` | Exit code is deterministic pass/fail |
+| Grep/pattern checks | `shell` | Pattern exists or it doesn't |
+| Dependency availability | `shell` | `node -e "require('pkg')"` succeeds or fails |
+| Runtime smoke tests | `shell` | Start, curl, check status code, stop |
+| Code review / design quality | `agent` | Requires subjective judgment |
+| Architecture assessment | `agent` | Requires reasoning about tradeoffs |
+| UX evaluation | `agent` | Subjective quality assessment |
+
+**Anti-pattern (wrong):**
+```javascript
+// BAD: agent-interpreted verification -- the agent can say "looks good" without running anything
+const verifyTask = defineTask('verify-compilation', (args, taskCtx) => ({
+  kind: 'agent',
+  title: 'Verify TypeScript compiles',
+  agent: { prompt: { instructions: ['Run tsc and check it passes'] } }
+}));
+```
+
+**Correct pattern:**
+```javascript
+// GOOD: deterministic shell gate -- exit code cannot be negotiated
+const verifyTask = defineTask('verify-compilation', (args, taskCtx) => ({
+  kind: 'shell',
+  title: 'TypeScript compilation check',
+  shell: { command: 'npx tsc --noEmit', expectedExitCode: 0, timeout: 120000 }
+}));
+```
+
+Use `library/processes/shared/deterministic-quality-gate.js` for composable
+preset gates (grep checks, compilation, test suites, runtime smoke tests).
+
 ### Effect Execution Hints
 
 Tasks can include an `execution` field to express preferences about how the effect should be executed:

package/dist/runtime/intrinsics/breakpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"breakpoint.d.ts","sourceRoot":"","sources":["../../../src/runtime/intrinsics/breakpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAmC,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC1H,OAAO,EAAoB,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAkChE,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAChD,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,iBAAiB,GAAG,wBAAwB,GACrD,OAAO,CAAC,gBAAgB,CAAC,CA+B3B"}
+{"version":3,"file":"breakpoint.d.ts","sourceRoot":"","sources":["../../../src/runtime/intrinsics/breakpoint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAmC,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC1H,OAAO,EAAoB,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAkChE,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAChD,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,iBAAiB,GAAG,wBAAwB,GACrD,OAAO,CAAC,gBAAgB,CAAC,CAiD3B"}

package/dist/runtime/intrinsics/breakpoint.js

@@ -1,6 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runBreakpointIntrinsic = runBreakpointIntrinsic;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
 const task_1 = require("./task");
 const journal_1 = require("../../storage/journal");
 const BREAKPOINT_TASK_ID = "__sdk.breakpoint";
@@ -28,10 +33,24 @@ function runBreakpointIntrinsic(payload, context, options) {
     const ctx = context;
     if (ctx.nonInteractive) {
         const bpLabel = options?.label ?? "unnamed";
+        let logSeq;
+        if (ctx.logSeq !== undefined && ctx.recordedLogSeqs !== undefined) {
+            logSeq = ++ctx.logSeq;
+            if (ctx.recordedLogSeqs.has(logSeq)) {
+                return Promise.resolve({ approved: true, response: "Auto-approved (non-interactive mode)" });
+            }
+            ctx.recordedLogSeqs.add(logSeq);
+            void node_fs_1.promises.appendFile(node_path_1.default.join(context.runDir, "state", "logSeqs.txt"), `${logSeq}\n`).catch(() => {
+                // Never let logging break orchestration.
+            });
+        }
+        else {
+            logSeq = -1;
+        }
         void (0, journal_1.appendEvent)({
             runDir: context.runDir,
             eventType: "PROCESS_LOG",
-            event: { logSeq: -1, label: "breakpoint:skipped", message: `Breakpoint '${bpLabel}' auto-approved (non-interactive mode)` },
+            event: { logSeq, label: "breakpoint:skipped", message: `Breakpoint '${bpLabel}' auto-approved (non-interactive mode)` },
         }).catch(() => {
             // Never let logging break orchestration.
         });

package/dist/runtime/orchestrateIteration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrateIteration.d.ts","sourceRoot":"","sources":["../../src/runtime/orchestrateIteration.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,eAAe,EACf,kBAAkB,EAInB,MAAM,SAAS,CAAC;AAgBjB,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqIhG"}
+{"version":3,"file":"orchestrateIteration.d.ts","sourceRoot":"","sources":["../../src/runtime/orchestrateIteration.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,eAAe,EACf,kBAAkB,EAInB,MAAM,SAAS,CAAC;AAgBjB,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmJhG"}

package/dist/runtime/orchestrateIteration.js

@@ -41,6 +41,7 @@ const path_1 = __importDefault(require("path"));
 const url_1 = require("url");
 const journal_1 = require("../storage/journal");
 const runFiles_1 = require("../storage/runFiles");
+const journal_2 = require("../cost/journal");
 const lock_1 = require("../storage/lock");
 const createReplayEngine_1 = require("./replay/createReplayEngine");
 const stateCache_1 = require("./replay/stateCache");
@@ -86,11 +87,24 @@ async function orchestrateIteration(options) {
         try {
             const output = await (0, processContext_1.withProcessContext)(engine.internalContext, () => processFn(inputs, engine.context, options.context));
             const outputRef = await (0, runFiles_1.writeRunOutput)(options.runDir, output);
+            // Compute cost stats for run completion
+            let costStats = undefined;
+            try {
+                const journalEvents = await (0, journal_1.loadJournal)(options.runDir);
+                const costEvents = (0, journal_2.extractCostEvents)(journalEvents);
+                if (costEvents.length > 0) {
+                    costStats = (0, journal_2.computeRunCostStats)(engine.runId, journalEvents);
+                }
+            }
+            catch {
+                // Cost stats are optional - don't fail the run
+            }
             await (0, journal_1.appendEvent)({
                 runDir: options.runDir,
                 eventType: "RUN_COMPLETED",
                 event: {
                     outputRef,
+                    costStats,
                 },
             });
             // Rebuild state cache so it includes the terminal event.

package/dist/session/types.d.ts

@@ -20,6 +20,8 @@ export interface SessionState {
     lastIterationAt: string;
     /** Array of recent iteration durations in seconds (last 3) */
     iterationTimes: number[];
+    /** Optional key-value metadata (e.g. external correlation IDs) */
+    metadata?: Record<string, string>;
 }
 /**
  * Complete session file content including state and prompt.

package/dist/session/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,+BAA+B;IAC/B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,gBAAgB;aACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,8BAA8B;IAC9B,kBAAkB,uBAAuB;IACzC,gCAAgC;IAChC,cAAc,mBAAmB;IACjC,2BAA2B;IAC3B,iBAAiB,sBAAsB;IACvC,6BAA6B;IAC7B,sBAAsB,2BAA2B;IACjD,oBAAoB;IACpB,aAAa,kBAAkB;IAC/B,4BAA4B;IAC5B,aAAa,kBAAkB;IAC/B,2BAA2B;IAC3B,eAAe,oBAAoB;IACnC,0BAA0B;IAC1B,mBAAmB,wBAAwB;IAC3C,wBAAwB;IACxB,QAAQ,aAAa;CACtB"}

package/dist/storage/createRunDir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createRunDir.d.ts","sourceRoot":"","sources":["../../src/storage/createRunDir.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAyB,WAAW,EAAE,MAAM,SAAS,CAAC;AAkBlF,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB;;;GAoC9D"}
+{"version":3,"file":"createRunDir.d.ts","sourceRoot":"","sources":["../../src/storage/createRunDir.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAyB,WAAW,EAAE,MAAM,SAAS,CAAC;AAmBlF,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB;;;GAqC9D"}

package/dist/storage/createRunDir.js

@@ -9,9 +9,11 @@ const path_1 = __importDefault(require("path"));
 const paths_1 = require("./paths");
 const atomic_1 = require("./atomic");
 const clock_1 = require("./clock");
+const icloudWarning_1 = require("./icloudWarning");
 const GITIGNORE_CONTENT = `state/\ntasks/*/artifacts/\nblobs/\norphaned/\n`;
 async function createRunDir(options) {
     const runDir = (0, paths_1.getRunDir)(options.runsRoot, options.runId);
+    await (0, icloudWarning_1.warnIfICloudDrivePath)(runDir);
     await fs_1.promises.mkdir(runDir, { recursive: true });
     await Promise.all([
         fs_1.promises.mkdir((0, paths_1.getJournalDir)(runDir), { recursive: true }),

package/dist/storage/icloudWarning.d.ts

@@ -0,0 +1,6 @@
+type WarningOutput = Pick<NodeJS.WriteStream, "write">;
+export declare function detectICloudDrivePath(inputPath: string): Promise<string | undefined>;
+export declare function warnIfICloudDrivePath(inputPath: string, output?: WarningOutput): Promise<boolean>;
+export declare function __resetICloudDriveWarningCacheForTests(): void;
+export {};
+//# sourceMappingURL=icloudWarning.d.ts.map

package/dist/storage/icloudWarning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icloudWarning.d.ts","sourceRoot":"","sources":["../../src/storage/icloudWarning.ts"],"names":[],"mappings":"AAMA,KAAK,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AA0CvD,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS1F;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,aAA8B,GACrC,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED,wBAAgB,sCAAsC,IAAI,IAAI,CAE7D"}

package/dist/storage/icloudWarning.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectICloudDrivePath = detectICloudDrivePath;
+exports.warnIfICloudDrivePath = warnIfICloudDrivePath;
+exports.__resetICloudDriveWarningCacheForTests = __resetICloudDriveWarningCacheForTests;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const ICLOUD_DRIVE_MARKER = "/Library/Mobile Documents/com~apple~CloudDocs";
+const warnedPaths = new Set();
+function normalizePathForMatch(inputPath) {
+    return inputPath.replace(/\\/g, "/").replace(/\/+$/, "");
+}
+function getICloudWarningKey(candidatePath) {
+    const normalized = normalizePathForMatch(candidatePath);
+    const markerIndex = normalized.indexOf(ICLOUD_DRIVE_MARKER);
+    if (markerIndex === -1) {
+        return normalized;
+    }
+    return normalized.slice(0, markerIndex + ICLOUD_DRIVE_MARKER.length);
+}
+function isICloudDrivePath(candidatePath) {
+    const normalized = normalizePathForMatch(candidatePath);
+    return normalized === ICLOUD_DRIVE_MARKER || normalized.includes(`${ICLOUD_DRIVE_MARKER}/`);
+}
+async function resolveExistingAncestorRealPath(inputPath) {
+    let current = path_1.default.resolve(inputPath);
+    let reachedFilesystemRoot = false;
+    while (!reachedFilesystemRoot) {
+        try {
+            return await fs_1.promises.realpath(current);
+        }
+        catch (error) {
+            const err = error;
+            if (err.code !== "ENOENT") {
+                return undefined;
+            }
+            const parent = path_1.default.dirname(current);
+            if (parent === current) {
+                reachedFilesystemRoot = true;
+            }
+            else {
+                current = parent;
+            }
+        }
+    }
+    return undefined;
+}
+async function detectICloudDrivePath(inputPath) {
+    const realAncestor = await resolveExistingAncestorRealPath(inputPath);
+    const candidates = [
+        realAncestor,
+        path_1.default.resolve(inputPath),
+        inputPath,
+    ].filter((candidate) => typeof candidate === "string" && candidate.trim() !== "");
+    return candidates.find((candidate) => isICloudDrivePath(candidate));
+}
+async function warnIfICloudDrivePath(inputPath, output = process.stderr) {
+    const matchedPath = await detectICloudDrivePath(inputPath);
+    if (!matchedPath) {
+        return false;
+    }
+    const dedupeKey = getICloudWarningKey(matchedPath);
+    if (warnedPaths.has(dedupeKey)) {
+        return true;
+    }
+    warnedPaths.add(dedupeKey);
+    const message = [
+        "",
+        "!!! WARNING: Babysitter state is inside iCloud Drive.",
+        `Path: ${path_1.default.resolve(inputPath)}`,
+        "iCloud sync can race .a5c journal writes and produce duplicate or conflicting journal events.",
+        "Recommendation: move the project or set BABYSITTER_STATE_DIR/BABYSITTER_RUNS_DIR outside iCloud Drive.",
+        "Known issue: github.com/a5c-ai/babysitter/issues/77",
+        "",
+    ].join("\n");
+    output.write(`${message}\n`);
+    return true;
+}
+function __resetICloudDriveWarningCacheForTests() {
+    warnedPaths.clear();
+}

package/dist/storage/journal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/storage/journal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAc,MAAM,SAAS,CAAC;AAuB1F,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuBtF;AA2BD,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA6BzE"}
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/storage/journal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAc,MAAM,SAAS,CAAC;AAwB1F,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwBtF;AA2BD,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA6BzE"}

package/dist/storage/journal.js

@@ -12,6 +12,7 @@ const paths_1 = require("./paths");
 const atomic_1 = require("./atomic");
 const ulids_1 = require("./ulids");
 const clock_1 = require("./clock");
+const icloudWarning_1 = require("./icloudWarning");
 function formatSeq(seq) {
     return seq.toString().padStart(6, "0");
 }
@@ -31,6 +32,7 @@ async function getExistingSeqs(journalDir) {
 }
 async function appendEvent(opts) {
     const journalDir = (0, paths_1.getJournalDir)(opts.runDir);
+    await (0, icloudWarning_1.warnIfICloudDrivePath)(journalDir);
     await fs_1.promises.mkdir(journalDir, { recursive: true });
     const seqs = await getExistingSeqs(journalDir);
     const seq = (seqs.length ? Math.max(...seqs) : 0) + 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a5c-ai/babysitter-sdk",
-  "version": "0.0.186",
+  "version": "0.0.187-staging.02a0ee21",
   "description": "Storage and run-registry primitives for event-sourced babysitter workflows.",
   "license": "UNLICENSED",
   "type": "commonjs",