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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -52,4 +52,5 @@ __exportStar(require("./plugins"), exports);
 __exportStar(require("./interaction"), exports);
 __exportStar(require("./prompts"), exports);
 __exportStar(require("./logging"), exports);
+__exportStar(require("./cost/index"), exports);
 exports.anycli = __importStar(require("./anycli/index"));

package/dist/logging/runLogger.js

@@ -57,13 +57,13 @@ exports.appendRunLog = appendRunLog;
 exports.createRunLogger = createRunLogger;
 const node_fs_1 = require("node:fs");
 const path = __importStar(require("node:path"));
-const os = __importStar(require("node:os"));
+const config_1 = require("../config");
 // ---------------------------------------------------------------------------
 // Paths
 // ---------------------------------------------------------------------------
 const LOG_DIR_ENV = "BABYSITTER_LOG_DIR";
 function getDefaultLogDir() {
-    return process.env[LOG_DIR_ENV] || path.join(os.homedir(), ".a5c", "logs");
+    return process.env[LOG_DIR_ENV] || (0, config_1.getGlobalLogDir)();
 }
 /** Log file names by type. */
 const LOG_FILE_NAMES = {

package/dist/prompts/babysitterMdDiscovery.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Discovery of BABYSITTER.md files from a starting directory up to the git repo root.
+ *
+ * Walks the directory hierarchy upward, collecting BABYSITTER.md files (case-insensitive)
+ * at each level, and returns them sorted from repo root to leaf.
+ *
+ * @module prompts/babysitterMdDiscovery
+ */
+/** A discovered BABYSITTER.md file with its content and location metadata. */
+export interface BabysitterMdFile {
+    /** Absolute file path */
+    filePath: string;
+    /** Content of the file */
+    content: string;
+    /** Path relative to the repo root (forward-slash separated) */
+    relativePath: string;
+}
+/**
+ * Finds the git repository root by walking upward from `startDir` looking for
+ * a `.git` directory or file.
+ *
+ * @param startDir - The directory to start searching from.
+ * @returns The absolute path to the repo root, or `undefined` if not inside a git repo.
+ */
+export declare function findGitRoot(startDir: string): string | undefined;
+/**
+ * Discovers BABYSITTER.md files from `startDir` upward to the git repo root.
+ *
+ * At each directory level the function reads directory entries and performs a
+ * case-insensitive match against "babysitter.md". Results are returned sorted
+ * from repo root to leaf (outermost first).
+ *
+ * @param startDir - The directory to start searching from. Defaults to `process.cwd()`.
+ * @returns An array of discovered files sorted root-to-leaf, or an empty array
+ *   if not inside a git repo or no files are found.
+ */
+export declare function discoverBabysitterMdFiles(startDir?: string): BabysitterMdFile[];
+//# sourceMappingURL=babysitterMdDiscovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"babysitterMdDiscovery.d.ts","sourceRoot":"","sources":["../../src/prompts/babysitterMdDiscovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsBhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA2C/E"}

package/dist/prompts/babysitterMdDiscovery.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Discovery of BABYSITTER.md files from a starting directory up to the git repo root.
+ *
+ * Walks the directory hierarchy upward, collecting BABYSITTER.md files (case-insensitive)
+ * at each level, and returns them sorted from repo root to leaf.
+ *
+ * @module prompts/babysitterMdDiscovery
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findGitRoot = findGitRoot;
+exports.discoverBabysitterMdFiles = discoverBabysitterMdFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Finds the git repository root by walking upward from `startDir` looking for
+ * a `.git` directory or file.
+ *
+ * @param startDir - The directory to start searching from.
+ * @returns The absolute path to the repo root, or `undefined` if not inside a git repo.
+ */
+function findGitRoot(startDir) {
+    let current = path.resolve(startDir);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        try {
+            const gitPath = path.join(current, ".git");
+            const stat = fs.statSync(gitPath);
+            // .git can be a directory (normal repo) or a file (worktree/submodule)
+            if (stat.isDirectory() || stat.isFile()) {
+                return current;
+            }
+        }
+        catch {
+            // .git not found at this level — keep walking up
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            // Reached filesystem root without finding .git
+            return undefined;
+        }
+        current = parent;
+    }
+}
+/**
+ * Discovers BABYSITTER.md files from `startDir` upward to the git repo root.
+ *
+ * At each directory level the function reads directory entries and performs a
+ * case-insensitive match against "babysitter.md". Results are returned sorted
+ * from repo root to leaf (outermost first).
+ *
+ * @param startDir - The directory to start searching from. Defaults to `process.cwd()`.
+ * @returns An array of discovered files sorted root-to-leaf, or an empty array
+ *   if not inside a git repo or no files are found.
+ */
+function discoverBabysitterMdFiles(startDir) {
+    const resolvedStart = path.resolve(startDir ?? process.cwd());
+    const repoRoot = findGitRoot(resolvedStart);
+    if (repoRoot === undefined) {
+        return [];
+    }
+    const found = [];
+    let current = path.resolve(resolvedStart);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const match = findBabysitterMdInDir(current);
+        if (match !== undefined) {
+            const rel = path.relative(repoRoot, match);
+            // Normalize to forward slashes for cross-platform consistency
+            const relativePath = rel.split(path.sep).join("/");
+            try {
+                const content = fs.readFileSync(match, "utf-8");
+                found.push({ filePath: match, content, relativePath });
+            }
+            catch {
+                // File couldn't be read — skip it
+            }
+        }
+        // Stop after processing the repo root
+        if (normalizePath(current) === normalizePath(repoRoot)) {
+            break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            // Reached filesystem root without hitting repo root (shouldn't happen
+            // since we verified repoRoot is an ancestor, but guard anyway)
+            break;
+        }
+        current = parent;
+    }
+    // Reverse so repo root comes first (we collected leaf-to-root)
+    found.reverse();
+    return found;
+}
+/**
+ * Looks for a BABYSITTER.md file (case-insensitive) in the given directory.
+ *
+ * @returns The absolute path to the matched file, or `undefined` if not found.
+ */
+function findBabysitterMdInDir(dir) {
+    try {
+        const entries = fs.readdirSync(dir);
+        for (const entry of entries) {
+            if (entry.toLowerCase() === "babysitter.md") {
+                return path.join(dir, entry);
+            }
+        }
+    }
+    catch {
+        // Directory unreadable — skip
+    }
+    return undefined;
+}
+/** Normalizes a path for reliable comparison (resolves case, trailing separators). */
+function normalizePath(p) {
+    return path.resolve(p).toLowerCase();
+}

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,CA4EpE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAYrE;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),
@@ -115,6 +116,7 @@ function composeBabysitSkillPrompt(ctx) {
         parts.renderProcessGuidelines(ctx),
         parts.renderCriticalRules(ctx),
         parts.renderSeeAlso(ctx),
+        parts.renderProjectInstructions(ctx),
     ]);
 }
 /**
@@ -127,8 +129,10 @@ function composeProcessCreatePrompt(ctx) {
         parts.renderProcessCreation(ctx),
         parts.renderIntentFidelityChecks(ctx),
         parts.renderProcessGuidelines(ctx),
+        parts.renderParallelPhaseDetection(ctx),
         parts.renderTaskKinds(ctx),
         parts.renderTaskExamples(ctx),
+        parts.renderProjectInstructions(ctx),
     ]);
 }
 /**
@@ -136,6 +140,7 @@ function composeProcessCreatePrompt(ctx) {
  */
 function composeOrchestrationPrompt(ctx) {
     return joinNonEmpty([
+        parts.renderRunOverlapDetection(ctx),
         parts.renderRunCreation(ctx),
         parts.renderIteration(ctx),
         parts.renderEffects(ctx),

package/dist/prompts/context.d.ts

@@ -32,5 +32,9 @@ export declare function createOpenCodeContext(overrides?: Partial<PromptContext>
  * Create a PromptContext pre-configured for PI.
  */
 export declare function createPiContext(overrides?: Partial<PromptContext>): PromptContext;
+/**
+ * Create a PromptContext pre-configured for OpenClaw.
+ */
+export declare function createOpenClawContext(overrides?: Partial<PromptContext>): PromptContext;
 export declare function createOhMyPiContext(overrides?: Partial<PromptContext>): PromptContext;
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/prompts/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAUxC;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CA+Bf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAgCf;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAiCf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAiCf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CA+Bf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAkCf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CA+Bf;AAED,wBAAgB,mBAAmB,CACjC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CA+Bf"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/prompts/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAUxC;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CA+Bf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAgCf;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAiCf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAiCf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CA+Bf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAkCf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CA+Bf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAgCf;AAED,wBAAgB,mBAAmB,CACjC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CA+Bf"}

package/dist/prompts/context.js

@@ -12,6 +12,7 @@ exports.createCursorContext = createCursorContext;
 exports.createGeminiCliContext = createGeminiCliContext;
 exports.createOpenCodeContext = createOpenCodeContext;
 exports.createPiContext = createPiContext;
+exports.createOpenClawContext = createOpenClawContext;
 exports.createOhMyPiContext = createOhMyPiContext;
 const COMMON_DEFAULTS = {
     interactive: true,
@@ -272,6 +273,42 @@ function createPiContext(overrides) {
         ...overrides,
     };
 }
+/**
+ * Create a PromptContext pre-configured for OpenClaw.
+ */
+function createOpenClawContext(overrides) {
+    return {
+        ...COMMON_DEFAULTS,
+        harness: 'openclaw',
+        harnessLabel: 'OpenClaw',
+        capabilities: ['session-binding', 'mcp', 'headless-prompt', 'task-tool', 'breakpoint-routing'],
+        pluginRootVar: '',
+        // Daemon model: no stop-hook. Agent lifecycle managed by agent_end signal.
+        loopControlTerm: 'agent_end',
+        sessionBindingFlags: '',
+        hookDriven: false,
+        interactiveToolName: 'AskUserQuestion tool',
+        sessionEnvVars: 'BABYSITTER_SESSION_ID, OPENCLAW_SHELL (auto-injected by gateway)',
+        resumeFlags: '',
+        cliSetupSnippet: [
+            'Use the installed CLI alias:',
+            '',
+            '```bash',
+            'CLI="babysitter"',
+            '```',
+            '',
+            'If it is not available on the path, use:',
+            '',
+            '```bash',
+            'CLI="npx -y @a5c-ai/babysitter-sdk"',
+            '```',
+        ].join('\n'),
+        iterateFlags: '',
+        hasIntentFidelityChecks: false,
+        hasNonNegotiables: false,
+        ...overrides,
+    };
+}
 function createOhMyPiContext(overrides) {
     return {
         ...COMMON_DEFAULTS,

package/dist/prompts/index.d.ts

@@ -8,5 +8,5 @@ export { createClaudeCodeContext, createCodexContext, createGeminiCliContext, cr
 export { renderTemplate, renderTemplateString, resolveTemplatePath, } from './templateRenderer';
 export { renderCommandTemplate, resolveCommandTemplatePath, } from './commandTemplates';
 export { composeBabysitSkillPrompt, composeProcessCreatePrompt, composeOrchestrationPrompt, composeBreakpointPrompt, joinNonEmpty, } from './compose';
-export { renderDependencies, renderInterview, renderUserProfile, renderProcessCreation, renderIntentFidelityChecks, renderRunCreation, renderIteration, renderEffects, renderBreakpointHandling, renderResultsPosting, renderLoopControl, renderCompletionProof, renderTaskKinds, renderTaskExamples, renderQuickReference, renderRecovery, renderProcessGuidelines, renderCriticalRules, renderSeeAlso, renderNonNegotiables, } from './parts';
+export { renderDependencies, renderInterview, renderUserProfile, renderProcessCreation, renderIntentFidelityChecks, renderRunCreation, renderIteration, renderEffects, renderBreakpointHandling, renderResultsPosting, renderLoopControl, renderCompletionProof, renderTaskKinds, renderTaskExamples, renderQuickReference, renderRecovery, renderProcessGuidelines, renderCriticalRules, renderSeeAlso, renderNonNegotiables, renderProjectInstructions, } from './parts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,uBAAuB,EACvB,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,uBAAuB,EACvB,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,SAAS,CAAC"}

package/dist/prompts/index.js

@@ -5,7 +5,7 @@
  * @module prompts
  */
 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 = exports.joinNonEmpty = exports.composeBreakpointPrompt = exports.composeOrchestrationPrompt = exports.composeProcessCreatePrompt = exports.composeBabysitSkillPrompt = exports.resolveCommandTemplatePath = exports.renderCommandTemplate = exports.resolveTemplatePath = exports.renderTemplateString = exports.renderTemplate = exports.createPiContext = exports.createGeminiCliContext = exports.createCodexContext = exports.createClaudeCodeContext = void 0;
+exports.renderProjectInstructions = 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 = exports.joinNonEmpty = exports.composeBreakpointPrompt = exports.composeOrchestrationPrompt = exports.composeProcessCreatePrompt = exports.composeBabysitSkillPrompt = exports.resolveCommandTemplatePath = exports.renderCommandTemplate = exports.resolveTemplatePath = exports.renderTemplateString = exports.renderTemplate = exports.createPiContext = exports.createGeminiCliContext = exports.createCodexContext = exports.createClaudeCodeContext = void 0;
 // Context factories
 var context_1 = require("./context");
 Object.defineProperty(exports, "createClaudeCodeContext", { enumerable: true, get: function () { return context_1.createClaudeCodeContext; } });
@@ -49,3 +49,4 @@ Object.defineProperty(exports, "renderProcessGuidelines", { enumerable: true, ge
 Object.defineProperty(exports, "renderCriticalRules", { enumerable: true, get: function () { return parts_1.renderCriticalRules; } });
 Object.defineProperty(exports, "renderSeeAlso", { enumerable: true, get: function () { return parts_1.renderSeeAlso; } });
 Object.defineProperty(exports, "renderNonNegotiables", { enumerable: true, get: function () { return parts_1.renderNonNegotiables; } });
+Object.defineProperty(exports, "renderProjectInstructions", { enumerable: true, get: function () { return parts_1.renderProjectInstructions; } });

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

@@ -9,8 +9,10 @@ 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 { renderParallelPhaseDetection } from './parallelPhaseDetection';
 export { renderBreakpointHandling } from './breakpointHandling';
 export { renderResultsPosting } from './resultsPosting';
 export { renderLoopControl } from './loopControl';
@@ -23,4 +25,5 @@ export { renderProcessGuidelines } from './processGuidelines';
 export { renderCriticalRules } from './criticalRules';
 export { renderSeeAlso } from './seeAlso';
 export { renderNonNegotiables } from './nonNegotiables';
+export { renderProjectInstructions } from './projectInstructions';
 //# sourceMappingURL=index.d.ts.map

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,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,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;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,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.renderProjectInstructions = 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.renderParallelPhaseDetection = 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,10 +18,14 @@ 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");
 Object.defineProperty(exports, "renderEffects", { enumerable: true, get: function () { return effects_1.renderEffects; } });
+var parallelPhaseDetection_1 = require("./parallelPhaseDetection");
+Object.defineProperty(exports, "renderParallelPhaseDetection", { enumerable: true, get: function () { return parallelPhaseDetection_1.renderParallelPhaseDetection; } });
 var breakpointHandling_1 = require("./breakpointHandling");
 Object.defineProperty(exports, "renderBreakpointHandling", { enumerable: true, get: function () { return breakpointHandling_1.renderBreakpointHandling; } });
 var resultsPosting_1 = require("./resultsPosting");
@@ -46,3 +50,5 @@ var seeAlso_1 = require("./seeAlso");
 Object.defineProperty(exports, "renderSeeAlso", { enumerable: true, get: function () { return seeAlso_1.renderSeeAlso; } });
 var nonNegotiables_1 = require("./nonNegotiables");
 Object.defineProperty(exports, "renderNonNegotiables", { enumerable: true, get: function () { return nonNegotiables_1.renderNonNegotiables; } });
+var projectInstructions_1 = require("./projectInstructions");
+Object.defineProperty(exports, "renderProjectInstructions", { enumerable: true, get: function () { return projectInstructions_1.renderProjectInstructions; } });

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

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

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

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

package/dist/prompts/parts/parallelPhaseDetection.js

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

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

@@ -0,0 +1,8 @@
+import type { PromptContext } from '../types';
+/**
+ * Renders a "Project Instructions" section from BABYSITTER.md files
+ * found between the current directory and the git repo root.
+ * Returns empty string if no files are found.
+ */
+export declare function renderProjectInstructions(_ctx: PromptContext): string;
+//# sourceMappingURL=projectInstructions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectInstructions.d.ts","sourceRoot":"","sources":["../../../src/prompts/parts/projectInstructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAmBrE"}

package/dist/prompts/parts/projectInstructions.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderProjectInstructions = renderProjectInstructions;
+const babysitterMdDiscovery_1 = require("../babysitterMdDiscovery");
+/**
+ * Renders a "Project Instructions" section from BABYSITTER.md files
+ * found between the current directory and the git repo root.
+ * Returns empty string if no files are found.
+ */
+function renderProjectInstructions(_ctx) {
+    const files = (0, babysitterMdDiscovery_1.discoverBabysitterMdFiles)();
+    if (files.length === 0)
+        return '';
+    const sections = files.map(f => {
+        const header = files.length > 1
+            ? `### ${f.relativePath}\n\n`
+            : '';
+        return header + f.content.trim();
+    });
+    return [
+        '## Project Instructions (BABYSITTER.md)',
+        '',
+        ...(files.length > 1
+            ? ['*Merged from ' + files.length + ' BABYSITTER.md files (repo root to current directory):*', '']
+            : []),
+        sections.join('\n\n'),
+    ].join('\n');
+}

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/commands/doctor.md

@@ -177,13 +177,13 @@ Mark as PASS if no issues. Mark as WARN if runaway loops or stale sessions detec
 **Goal:** Analyze babysitter log files for errors, warnings, and stop hook decisions.
 
 Read the last 50 lines of each of these log files (if they exist):
-- `$CLAUDE_PLUGIN_ROOT/.a5c/logs/hooks.log`
-- `$CLAUDE_PLUGIN_ROOT/.a5c/logs/babysitter-stop-hook.log`
-- `$CLAUDE_PLUGIN_ROOT/.a5c/logs/babysitter-stop-hook-stderr.log`
-- `$CLAUDE_PLUGIN_ROOT/.a5c/logs/babysitter-session-start-hook.log`
-- `$CLAUDE_PLUGIN_ROOT/.a5c/logs/babysitter-session-start-hook-stderr.log`
-- `$CLAUDE_PLUGIN_ROOT/.a5c/logs/babysitter.log`
-- `$HOME/.a5c/logs/` and relevant logs and run/session specific logs there
+- `${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}/hooks.log`
+- `${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}/babysitter-stop-hook.log`
+- `${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}/babysitter-stop-hook-stderr.log`
+- `${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}/babysitter-session-start-hook.log`
+- `${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}/babysitter-session-start-hook-stderr.log`
+- `${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}/babysitter.log`
+- `${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}/` and relevant run/session specific logs there
 
 
 For each log file:
@@ -285,7 +285,7 @@ The hooks delegate to the `babysitter` CLI. Check if it is available:
 Check whether the stop hook has actually been invoked during this run's lifetime:
 
 **From log files:**
-- Read `$CLAUDE_PLUGIN_ROOT/.a5c/logs/babysitter-stop-hook.log` (if it exists).
+- Read `${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}/babysitter-stop-hook.log` (if it exists).
 - Count the number of "Hook script invoked" lines. This is the total invocation count.
 - Count the number of "CLI exit code=" lines and extract exit codes.
 - If the log file does not exist or has zero invocations, the stop hook has NOT been running.
@@ -297,7 +297,7 @@ Check whether the stop hook has actually been invoked during this run's lifetime
 - If no STOP_HOOK_INVOKED events exist in the journal, note that the stop hook has not recorded any decisions for this run.
 
 **From stderr:**
-- Read `$CLAUDE_PLUGIN_ROOT/.a5c/logs/babysitter-stop-hook-stderr.log`.
+- Read `${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}/babysitter-stop-hook-stderr.log`.
 - If it contains error output, display it and diagnose:
   - "command not found" or exit code 127 → CLI not installed (see 10c)
   - "MODULE_NOT_FOUND" or "Cannot find module" → SDK package corrupted or not built

package/dist/prompts/templates/intent-fidelity-checks.md

@@ -6,7 +6,9 @@ Before calling `run:create`, verify and document in your working notes:
 2. The process structure follows library style/composition patterns rather than
    a one-off minimal flow.
 3. Quality gates exist (verification/refinement loops, integration checks,
-   and/or breakpoints appropriate for the task).
+   and/or breakpoints appropriate for the task). Objectively verifiable checks
+   (compilation, linting, tests, grep, dependencies) use `kind: 'shell'` with
+   `expectedExitCode`, not `kind: 'agent'`.
 4. Any scope reduction, simplification, or recovery tradeoff is explicitly
    approved by the user before execution.
 

package/dist/prompts/templates/parallel-phase-detection.md

@@ -0,0 +1,59 @@
+### Parallel Phase Design
+
+When authoring a process definition, identify phases that have no mutual
+dependencies and express them as parallel groups. This reduces total run time
+without compromising correctness.
+
+**Identifying independent phases:**
+
+Two phases are independent — and safe to parallelize — when **all** of the
+following hold:
+
+1. They do not write to any resource that the other reads (no write-to-read
+   dependency).
+2. They do not both write to the same resource (no write-to-write conflict).
+3. Each phase depends only on already-completed phases, not on each other.
+
+**Example:** If phases 4, 5, and 6 all depend on the outputs of phases 1 and 2
+but share no inputs or outputs with each other, they are candidates for
+parallel execution.
+
+**Expressing parallelism in the process definition:**
+
+Use `ctx.parallel.all()` for a fixed set of independent tasks:
+
+```js
+const [featureTagging, hookImpl, retrospectIntegration] = await ctx.parallel.all([
+  ctx.task(featureTaggingTask, { architecture, coreImpl }),
+  ctx.task(hookImplementationTask, { architecture, coreImpl }),
+  ctx.task(retrospectIntegrationTask, { architecture, coreImpl }),
+]);
+```
+
+Use `ctx.parallel.map()` when applying the same task across multiple
+independent items:
+
+```js
+const results = await ctx.parallel.map(modules, (mod) =>
+  ctx.task(moduleImplementationTask, { module: mod, architecture }),
+);
+```
+
+**When to use parallelism:**
+
+- Multiple implementation phases that depend on the same planning/architecture
+  output but not on each other.
+- Per-module or per-component work where each unit is self-contained.
+- Independent verification steps (e.g., linting, type-checking, and unit tests
+  can often run in parallel).
+
+**Safety constraints:**
+
+- **Max 3 concurrent phases** by default. Keep parallel groups small to avoid
+  overwhelming the execution environment.
+- **Correctness over speed.** When dependency analysis is ambiguous or the
+  phases might interact through shared files, fall back to sequential execution.
+- **Merge before dependents.** Always `await` the full parallel group before
+  dispatching any phase that consumes their outputs.
+- **When in doubt, run sequentially.** A correct slow run is always preferable
+  to a fast broken one.