@a5c-ai/babysitter-sdk 0.0.186 → 0.0.187-staging.1ec5e9f0

package/dist/cli/commands/instructions.js

@@ -30,7 +30,7 @@ const COMPOSERS = {
         promptType: "babysit-skill",
         partsIncluded: [
             "non-negotiables", "dependencies", "interview", "user-profile",
-            "process-creation", "intent-fidelity-checks", "run-creation",
+            "process-creation", "intent-fidelity-checks", "run-overlap-detection", "run-creation",
             "iteration", "effects", "breakpoint-handling", "results-posting",
             "loop-control", "completion-proof", "task-kinds", "task-examples",
             "quick-reference", "recovery", "process-guidelines", "critical-rules",
@@ -50,7 +50,7 @@ const COMPOSERS = {
         fn: prompts_1.composeOrchestrationPrompt,
         promptType: "orchestrate",
         partsIncluded: [
-            "run-creation", "iteration", "effects", "breakpoint-handling",
+            "run-overlap-detection", "run-creation", "iteration", "effects", "breakpoint-handling",
             "results-posting", "loop-control", "completion-proof",
             "quick-reference", "recovery", "critical-rules",
         ],

package/dist/prompts/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/prompts/compose.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA0EpE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAUrE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAarE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAKlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/prompts/compose.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA2EpE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAUrE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAcrE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAKlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD"}

package/dist/prompts/compose.js

@@ -101,6 +101,7 @@ function composeBabysitSkillPrompt(ctx) {
         parts.renderUserProfile(ctx),
         parts.renderProcessCreation(ctx),
         parts.renderIntentFidelityChecks(ctx),
+        parts.renderRunOverlapDetection(ctx),
         parts.renderRunCreation(ctx),
         parts.renderIteration(ctx),
         parts.renderEffects(ctx),
@@ -136,6 +137,7 @@ function composeProcessCreatePrompt(ctx) {
  */
 function composeOrchestrationPrompt(ctx) {
     return joinNonEmpty([
+        parts.renderRunOverlapDetection(ctx),
         parts.renderRunCreation(ctx),
         parts.renderIteration(ctx),
         parts.renderEffects(ctx),

package/dist/prompts/parts/index.d.ts

@@ -9,6 +9,7 @@ export { renderUserProfile } from './userProfile';
 export { renderProcessCreation } from './processCreation';
 export { renderIntentFidelityChecks } from './intentFidelityChecks';
 export { renderRunCreation } from './runCreation';
+export { renderRunOverlapDetection } from './runOverlapDetection';
 export { renderIteration } from './iteration';
 export { renderEffects } from './effects';
 export { renderBreakpointHandling } from './breakpointHandling';

package/dist/prompts/parts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompts/parts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompts/parts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/prompts/parts/index.js

@@ -5,7 +5,7 @@
  * @module prompts/parts
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderNonNegotiables = exports.renderSeeAlso = exports.renderCriticalRules = exports.renderProcessGuidelines = exports.renderRecovery = exports.renderQuickReference = exports.renderTaskExamples = exports.renderTaskKinds = exports.renderCompletionProof = exports.renderLoopControl = exports.renderResultsPosting = exports.renderBreakpointHandling = exports.renderEffects = exports.renderIteration = exports.renderRunCreation = exports.renderIntentFidelityChecks = exports.renderProcessCreation = exports.renderUserProfile = exports.renderInterview = exports.renderDependencies = void 0;
+exports.renderNonNegotiables = exports.renderSeeAlso = exports.renderCriticalRules = exports.renderProcessGuidelines = exports.renderRecovery = exports.renderQuickReference = exports.renderTaskExamples = exports.renderTaskKinds = exports.renderCompletionProof = exports.renderLoopControl = exports.renderResultsPosting = exports.renderBreakpointHandling = exports.renderEffects = exports.renderIteration = exports.renderRunOverlapDetection = exports.renderRunCreation = exports.renderIntentFidelityChecks = exports.renderProcessCreation = exports.renderUserProfile = exports.renderInterview = exports.renderDependencies = void 0;
 var dependencies_1 = require("./dependencies");
 Object.defineProperty(exports, "renderDependencies", { enumerable: true, get: function () { return dependencies_1.renderDependencies; } });
 var interview_1 = require("./interview");
@@ -18,6 +18,8 @@ var intentFidelityChecks_1 = require("./intentFidelityChecks");
 Object.defineProperty(exports, "renderIntentFidelityChecks", { enumerable: true, get: function () { return intentFidelityChecks_1.renderIntentFidelityChecks; } });
 var runCreation_1 = require("./runCreation");
 Object.defineProperty(exports, "renderRunCreation", { enumerable: true, get: function () { return runCreation_1.renderRunCreation; } });
+var runOverlapDetection_1 = require("./runOverlapDetection");
+Object.defineProperty(exports, "renderRunOverlapDetection", { enumerable: true, get: function () { return runOverlapDetection_1.renderRunOverlapDetection; } });
 var iteration_1 = require("./iteration");
 Object.defineProperty(exports, "renderIteration", { enumerable: true, get: function () { return iteration_1.renderIteration; } });
 var effects_1 = require("./effects");

package/dist/prompts/parts/runOverlapDetection.d.ts

@@ -0,0 +1,6 @@
+import type { PromptContext } from '../types';
+/**
+ * Renders the Run Overlap Detection section.
+ */
+export declare function renderRunOverlapDetection(ctx: PromptContext): string;
+//# sourceMappingURL=runOverlapDetection.d.ts.map

package/dist/prompts/parts/runOverlapDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runOverlapDetection.d.ts","sourceRoot":"","sources":["../../../src/prompts/parts/runOverlapDetection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAEpE"}

package/dist/prompts/parts/runOverlapDetection.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderRunOverlapDetection = renderRunOverlapDetection;
+const templateRenderer_1 = require("../templateRenderer");
+/**
+ * Renders the Run Overlap Detection section.
+ */
+function renderRunOverlapDetection(ctx) {
+    return (0, templateRenderer_1.renderTemplate)((0, templateRenderer_1.resolveTemplatePath)('run-overlap-detection.md'), ctx);
+}

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/package.json

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