@codedrifters/configulator 0.0.286 → 0.0.288

package/lib/index.d.mts

@@ -364,11 +364,6 @@ interface AgentSubAgent {
      * Rendered to the platform-specific sub-agent config.
      */
     readonly mcpServers?: Readonly<Record<string, McpServerConfig>>;
-    /**
-     * Sub-agents this agent can invoke/delegate to.
-     * @example ['test-writer', 'code-reviewer']
-     */
-    readonly canDelegateToAgents?: ReadonlyArray<string>;
     /** Optional per-platform overrides for this sub-agent. */
     readonly platforms?: AgentSubAgentPlatformOverrides;
 }
@@ -1698,7 +1693,7 @@ interface ScopeGateConfig {
  * drifts.
  *
  * The counter persists in a small gitignored JSON state file
- * (default `.claude/state/orchestrator-runs.json`). Every orchestrator
+ * (default `.state/orchestrator-runs.json`). Every orchestrator
  * invocation ticks the counter once and classifies the run based on
  * `runCounter % (ratio + 1) == 0` — the `ratio + 1`th run in every
  * cycle is a housekeeping run, all others dispatch.
@@ -1742,7 +1737,7 @@ interface RunRatioConfig {
      * session maintains its own counter.
      *
      * Must be a non-empty relative path (no leading `/`). Defaults to
-     * `.claude/state/orchestrator-runs.json`.
+     * `.state/orchestrator-runs.json`.
      */
     readonly stateFilePath?: string;
     /**
@@ -2837,7 +2832,7 @@ interface AgentConfigOptions {
      * When the whole config is omitted, the orchestrator ships with
      * openhi's published 4:1 defaults (four dispatch runs, one
      * housekeeping run, state file at
-     * `.claude/state/orchestrator-runs.json`, `opus` / `sonnet`
+     * `.state/orchestrator-runs.json`, `opus` / `sonnet`
      * recommended models).
      *
      * Supply `ratio` to change the cadence, `stateFilePath` to move
@@ -3692,7 +3687,7 @@ declare const DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO = 4;
  *
  * @see RunRatioConfig
  */
-declare const DEFAULT_STATE_FILE_PATH = ".claude/state/orchestrator-runs.json";
+declare const DEFAULT_STATE_FILE_PATH = ".state/orchestrator-runs.json";
 /**
  * Default recommended model label for dispatch runs. Rendered into
  * the orchestrator-conventions rule so agents and humans can read the
@@ -4314,7 +4309,7 @@ declare function renderUnblockDependentsScript(ud: ResolvedUnblockDependents): s
  * (small: ≤3 AC + ≤2 sources; medium: ≤6 AC + ≤5 sources;
  * auto-file off) when the caller omits them. Run-ratio settings
  * default to the openhi 4:1 cadence with the counter persisted at
- * `.claude/state/orchestrator-runs.json`. Pre-flight settings default
+ * `.state/orchestrator-runs.json`. Pre-flight settings default
  * to vortex's step 0b contract (enabled, delegated to the
  * `pr-reviewer` sub-agent, squash merges, linked-issue keyword
  * required).
@@ -4604,11 +4599,10 @@ declare const DEFAULT_PROGRESS_FILES_ENABLED = true;
  * `<stateDir>/<filename>` where `<filename>` is produced from
  * `filenamePattern` at runtime.
  *
- * Lives at the top-level `.state/` directory rather than under
- * `.claude/state/` so the path stays harness-neutral — any agent
- * runtime (Claude Code, Cursor, a bespoke worker) can read and
- * write the same progress files without having to scope under a
- * Claude-specific tree.
+ * Lives at the top-level `.state/` directory so the path stays
+ * harness-neutral — any agent runtime (Claude Code, Cursor, a
+ * bespoke worker) can read and write the same progress files
+ * without having to scope under a harness-specific tree.
  *
  * @see ProgressFilesConfig
  */
@@ -6583,7 +6577,7 @@ declare function compileFencedSamples(options?: CompileFencedSamplesOptions): Ar
  * The report is the durable output of Phase 1 (Scan) of the docs-sync
  * pipeline (parent epic #448). Phase 1 walks the repo, runs every
  * registered drift check, and persists a single combined report to
- * `.claude/state/docs-sync/<N>-audit.json` (where `<N>` is the
+ * `.state/docs-sync/<N>-audit.json` (where `<N>` is the
  * tracking-issue number). Phase 2 (Fix) reads the persisted report
  * and applies mechanical fixes — the two phases never share an
  * in-memory handle, so the JSON shape on disk is the contract
@@ -6863,7 +6857,7 @@ type AuditFinding = ApiDiffFinding | TsdocCoverageFinding | ReferenceMismatchFin
 declare const DOCS_SYNC_AUDIT_SCHEMA_VERSION = 1;
 /**
  * Top-level audit-report shape persisted to
- * `.claude/state/docs-sync/<N>-audit.json`. The category-keyed
+ * `.state/docs-sync/<N>-audit.json`. The category-keyed
  * arrays are the durable surface; the flat `findings` array is a
  * convenience aggregation of the same records.
  */
@@ -6942,9 +6936,9 @@ declare function auditReportJsonSchema(): Record<string, unknown>;
 /**
  * Default subdirectory beneath the repo root where audit reports are
  * persisted. Mirrors the path declared on issue #518's acceptance
- * criteria: `.claude/state/docs-sync/<N>-audit.json`.
+ * criteria: `.state/docs-sync/<N>-audit.json`.
  */
-declare const DEFAULT_AUDIT_REPORT_DIR = ".claude/state/docs-sync";
+declare const DEFAULT_AUDIT_REPORT_DIR = ".state/docs-sync";
 /**
  * Stable iteration order for category keys. Matches the order they
  * appear in the persisted report and the order they ran during the
@@ -7044,7 +7038,7 @@ interface RunScanOptions {
      * {@link RunScanOptions.repoRoot}). Defaults to
      * {@link DEFAULT_AUDIT_REPORT_DIR}.
      *
-     * @default ".claude/state/docs-sync"
+     * @default ".state/docs-sync"
      */
     readonly reportDir?: string;
 }

package/lib/index.d.ts

@@ -413,11 +413,6 @@ interface AgentSubAgent {
      * Rendered to the platform-specific sub-agent config.
      */
     readonly mcpServers?: Readonly<Record<string, McpServerConfig>>;
-    /**
-     * Sub-agents this agent can invoke/delegate to.
-     * @example ['test-writer', 'code-reviewer']
-     */
-    readonly canDelegateToAgents?: ReadonlyArray<string>;
     /** Optional per-platform overrides for this sub-agent. */
     readonly platforms?: AgentSubAgentPlatformOverrides;
 }
@@ -1747,7 +1742,7 @@ interface ScopeGateConfig {
  * drifts.
  *
  * The counter persists in a small gitignored JSON state file
- * (default `.claude/state/orchestrator-runs.json`). Every orchestrator
+ * (default `.state/orchestrator-runs.json`). Every orchestrator
  * invocation ticks the counter once and classifies the run based on
  * `runCounter % (ratio + 1) == 0` — the `ratio + 1`th run in every
  * cycle is a housekeeping run, all others dispatch.
@@ -1791,7 +1786,7 @@ interface RunRatioConfig {
      * session maintains its own counter.
      *
      * Must be a non-empty relative path (no leading `/`). Defaults to
-     * `.claude/state/orchestrator-runs.json`.
+     * `.state/orchestrator-runs.json`.
      */
     readonly stateFilePath?: string;
     /**
@@ -2886,7 +2881,7 @@ interface AgentConfigOptions {
      * When the whole config is omitted, the orchestrator ships with
      * openhi's published 4:1 defaults (four dispatch runs, one
      * housekeeping run, state file at
-     * `.claude/state/orchestrator-runs.json`, `opus` / `sonnet`
+     * `.state/orchestrator-runs.json`, `opus` / `sonnet`
      * recommended models).
      *
      * Supply `ratio` to change the cadence, `stateFilePath` to move
@@ -3741,7 +3736,7 @@ declare const DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO = 4;
  *
  * @see RunRatioConfig
  */
-declare const DEFAULT_STATE_FILE_PATH = ".claude/state/orchestrator-runs.json";
+declare const DEFAULT_STATE_FILE_PATH = ".state/orchestrator-runs.json";
 /**
  * Default recommended model label for dispatch runs. Rendered into
  * the orchestrator-conventions rule so agents and humans can read the
@@ -4363,7 +4358,7 @@ declare function renderUnblockDependentsScript(ud: ResolvedUnblockDependents): s
  * (small: ≤3 AC + ≤2 sources; medium: ≤6 AC + ≤5 sources;
  * auto-file off) when the caller omits them. Run-ratio settings
  * default to the openhi 4:1 cadence with the counter persisted at
- * `.claude/state/orchestrator-runs.json`. Pre-flight settings default
+ * `.state/orchestrator-runs.json`. Pre-flight settings default
  * to vortex's step 0b contract (enabled, delegated to the
  * `pr-reviewer` sub-agent, squash merges, linked-issue keyword
  * required).
@@ -4653,11 +4648,10 @@ declare const DEFAULT_PROGRESS_FILES_ENABLED = true;
  * `<stateDir>/<filename>` where `<filename>` is produced from
  * `filenamePattern` at runtime.
  *
- * Lives at the top-level `.state/` directory rather than under
- * `.claude/state/` so the path stays harness-neutral — any agent
- * runtime (Claude Code, Cursor, a bespoke worker) can read and
- * write the same progress files without having to scope under a
- * Claude-specific tree.
+ * Lives at the top-level `.state/` directory so the path stays
+ * harness-neutral — any agent runtime (Claude Code, Cursor, a
+ * bespoke worker) can read and write the same progress files
+ * without having to scope under a harness-specific tree.
  *
  * @see ProgressFilesConfig
  */
@@ -6632,7 +6626,7 @@ declare function compileFencedSamples(options?: CompileFencedSamplesOptions): Ar
  * The report is the durable output of Phase 1 (Scan) of the docs-sync
  * pipeline (parent epic #448). Phase 1 walks the repo, runs every
  * registered drift check, and persists a single combined report to
- * `.claude/state/docs-sync/<N>-audit.json` (where `<N>` is the
+ * `.state/docs-sync/<N>-audit.json` (where `<N>` is the
  * tracking-issue number). Phase 2 (Fix) reads the persisted report
  * and applies mechanical fixes — the two phases never share an
  * in-memory handle, so the JSON shape on disk is the contract
@@ -6912,7 +6906,7 @@ type AuditFinding = ApiDiffFinding | TsdocCoverageFinding | ReferenceMismatchFin
 declare const DOCS_SYNC_AUDIT_SCHEMA_VERSION = 1;
 /**
  * Top-level audit-report shape persisted to
- * `.claude/state/docs-sync/<N>-audit.json`. The category-keyed
+ * `.state/docs-sync/<N>-audit.json`. The category-keyed
  * arrays are the durable surface; the flat `findings` array is a
  * convenience aggregation of the same records.
  */
@@ -6991,9 +6985,9 @@ declare function auditReportJsonSchema(): Record<string, unknown>;
 /**
  * Default subdirectory beneath the repo root where audit reports are
  * persisted. Mirrors the path declared on issue #518's acceptance
- * criteria: `.claude/state/docs-sync/<N>-audit.json`.
+ * criteria: `.state/docs-sync/<N>-audit.json`.
  */
-declare const DEFAULT_AUDIT_REPORT_DIR = ".claude/state/docs-sync";
+declare const DEFAULT_AUDIT_REPORT_DIR = ".state/docs-sync";
 /**
  * Stable iteration order for category keys. Matches the order they
  * appear in the persisted report and the order they ran during the
@@ -7093,7 +7087,7 @@ interface RunScanOptions {
      * {@link RunScanOptions.repoRoot}). Defaults to
      * {@link DEFAULT_AUDIT_REPORT_DIR}.
      *
-     * @default ".claude/state/docs-sync"
+     * @default ".state/docs-sync"
      */
     readonly reportDir?: string;
 }

package/lib/index.js

@@ -8340,7 +8340,7 @@ function buildDocsSyncSubAgent(_paths) {
       "persisted at:",
       "",
       "```",
-      ".claude/state/docs-sync/<issue-number>-audit.json",
+      ".state/docs-sync/<issue-number>-audit.json",
       "```",
       "",
       "Every report carries a `schemaVersion`, the `issueNumber`, the",
@@ -11456,7 +11456,7 @@ function assertValidEligibleLabels(labels) {
 
 // src/agent/bundles/run-ratio.ts
 var DEFAULT_DISPATCH_TO_HOUSEKEEPING_RATIO = 4;
-var DEFAULT_STATE_FILE_PATH = ".claude/state/orchestrator-runs.json";
+var DEFAULT_STATE_FILE_PATH = ".state/orchestrator-runs.json";
 var DEFAULT_DISPATCH_MODEL = "opus";
 var DEFAULT_HOUSEKEEPING_MODEL = "sonnet";
 function resolveRunRatio(config) {
@@ -12111,10 +12111,33 @@ function renderPipelineSkillBody(task, lines) {
     "filter issues by `type:*` or phase label. Each invocation runs the",
     `target sub-agent's full end-to-end cycle exactly once.`,
     "",
-    `Run \`.claude/agents/${task.agent}.md\` and follow its workflow`,
-    "from start to finish. The sub-agent is responsible for picking the",
-    "next unit of work, delegating implementation to other workers as",
-    "needed, and exiting cleanly.",
+    "## Depth-0 execution contract",
+    "",
+    "**You \u2014 the scheduled-task session \u2014 are the pipeline manager.**",
+    "Do **not** spawn the target sub-agent via the `Agent` tool. The",
+    "Claude Code runtime forbids nested sub-agent spawning: a depth-1",
+    "sub-agent cannot invoke `Agent` to reach depth-2, so a pipeline",
+    "manager that delegates to other workers must run at depth-0 (this",
+    "scheduled-task session). See",
+    '<https://code.claude.com/docs/en/sub-agents> \u2014 *"Subagents cannot',
+    "spawn other subagents. If your workflow requires nested delegation,",
+    'use Skills or chain subagents from the main conversation."*',
+    "",
+    "Therefore:",
+    "",
+    `1. **Read \`.claude/agents/${task.agent}.md\` in this session** and`,
+    "   execute its phase pipeline directly. Treat the agent file as a",
+    "   workflow runbook the scheduled-task session follows step-by-step,",
+    "   not as a sub-agent to spawn.",
+    "2. **Use the `Agent` tool (with the `subagent_type` parameter set",
+    "   to the target worker name) to delegate one tier down.** From",
+    "   depth-0, you can spawn a depth-1 sub-agent (e.g. `issue-worker`,",
+    "   `pr-reviewer`) for the implementation, review, or merge step the",
+    "   pipeline calls out.",
+    "3. **Never spawn the pipeline manager itself as a sub-agent.** Do",
+    `   not call \`Agent(subagent_type: "${task.agent}", ...)\`. That`,
+    "   would put the pipeline manager at depth-1 and break every",
+    "   subsequent delegation step.",
     "",
     "## Recommended model",
     "",
@@ -13536,7 +13559,6 @@ var orchestratorSubAgent = {
   description: "End-to-end pipeline manager that runs one full cycle every invocation: pre-flight PR merge \u2192 triage \u2192 maintenance \u2192 queue scan \u2192 delegate the picked issue to the issue-worker \u2192 cleanup",
   model: AGENT_MODEL.POWERFUL,
   maxTurns: 100,
-  canDelegateToAgents: ["issue-worker", "pr-reviewer"],
   platforms: { cursor: { exclude: true } },
   prompt: [
     "# Orchestrator Agent",
@@ -13917,7 +13939,6 @@ var issueWorkerSubAgent = {
   description: "Selects the next ready issue from the queue, claims it, and implements the change end-to-end following repository conventions",
   model: AGENT_MODEL.POWERFUL,
   maxTurns: 100,
-  canDelegateToAgents: [],
   platforms: { cursor: { exclude: true } },
   prompt: [
     "# Issue Worker",
@@ -14346,7 +14367,13 @@ var ORCHESTRATOR_CONVENTIONS_PREAMBLE = [
   "- The queue scan reads only `priority:*` and `status:*` labels \u2014 type-routing (which typed agent handles a given `type:*` label) is the `issue-worker`'s concern, not the orchestrator's. The orchestrator's funnel-tier sort is a tie-breaker on `priority:*`, not a routing decision.",
   "- Priority order: critical > high > medium > low > trivial, then **funnel tier asc** (lower tier wins ties), then FIFO by issue number",
   "- Stale thresholds: 72h for in-progress, 168h for blocked",
-  "- Flagged issues get `status:needs-attention` \u2014 they are not auto-reset"
+  "- Flagged issues get `status:needs-attention` \u2014 they are not auto-reset",
+  "",
+  "## Depth-0 invocation requirement",
+  "",
+  'The orchestrator agent **must run as the top-level (depth-0) session** when its Phase G needs to delegate work to the `issue-worker` sub-agent. The Claude Code harness forbids nested sub-agent spawning \u2014 *"Subagents cannot spawn other subagents. If your workflow requires nested delegation, use Skills or chain subagents from the main conversation."* (see <https://code.claude.com/docs/en/sub-agents>). If the orchestrator itself were spawned as a depth-1 sub-agent (e.g. via `Agent(subagent_type: "orchestrator")` from another session), the `Agent` tool needed to reach the `issue-worker` at depth-2 would not be available and Phase G would silently abort.',
+  "",
+  'Practical implication for scheduled-task wiring: the `worker-orchestrator` scheduled task\'s `SKILL.md` instructs the **scheduled-task session itself** to read `.claude/agents/orchestrator.md` and execute its phase pipeline in-session, then use the `Agent` tool to delegate the picked work item to `issue-worker` (depth-1). The scheduled task does **not** call `Agent(subagent_type: "orchestrator")` \u2014 that would put the orchestrator at depth-1 and break the chain.'
 ].join("\n");
 function buildOrchestratorConventionsContent(tiers, scopeGate = resolveScopeGate(), runRatio = resolveRunRatio(), preflight = resolvePreflightPr(), scheduledTasks = resolveScheduledTasks(), unblockDependents = resolveUnblockDependents()) {
   return [
@@ -27518,12 +27545,6 @@ var ClaudeRenderer = class _ClaudeRenderer {
       if (agent.platforms?.claude?.memory) {
         lines.push(`memory: ${agent.platforms.claude.memory}`);
       }
-      if (agent.canDelegateToAgents && agent.canDelegateToAgents.length > 0) {
-        lines.push(`canDelegateToAgents:`);
-        for (const delegateName of agent.canDelegateToAgents) {
-          lines.push(`  - "${delegateName}"`);
-        }
-      }
       lines.push("---");
       lines.push("");
       lines.push(...agent.prompt.split("\n"));
@@ -30181,7 +30202,7 @@ function toPosix3(p) {
 // src/docs-sync/scan/run-scan.ts
 var fs3 = __toESM(require("fs"));
 var path6 = __toESM(require("path"));
-var DEFAULT_AUDIT_REPORT_DIR = ".claude/state/docs-sync";
+var DEFAULT_AUDIT_REPORT_DIR = ".state/docs-sync";
 var SEVERITY_RANK = {
   blocking: 0,
   advisory: 1,