@danmoisan/drm-copilot-mcp 1.0.11 → 1.0.13

package/out/mcp-server.js

@@ -8964,13 +8964,13 @@ var $ZodObject = /* @__PURE__ */ $constructor("$ZodObject", (inst, def) => {
     }
     return propValues;
   });
-  const isObject8 = isObject;
+  const isObject9 = isObject;
   const catchall = def.catchall;
   let value;
   inst._zod.parse = (payload, ctx) => {
     value ?? (value = _normalized.value);
     const input = payload.value;
-    if (!isObject8(input)) {
+    if (!isObject9(input)) {
       payload.issues.push({
         expected: "object",
         code: "invalid_type",
@@ -9097,7 +9097,7 @@ var $ZodObjectJIT = /* @__PURE__ */ $constructor("$ZodObjectJIT", (inst, def) =>
     return (payload, ctx) => fn(shape, payload, ctx);
   };
   let fastpass;
-  const isObject8 = isObject;
+  const isObject9 = isObject;
   const jit = !globalConfig.jitless;
   const allowsEval2 = allowsEval;
   const fastEnabled = jit && allowsEval2.value;
@@ -9106,7 +9106,7 @@ var $ZodObjectJIT = /* @__PURE__ */ $constructor("$ZodObjectJIT", (inst, def) =>
   inst._zod.parse = (payload, ctx) => {
     value ?? (value = _normalized.value);
     const input = payload.value;
-    if (!isObject8(input)) {
+    if (!isObject9(input)) {
       payload.issues.push({
         expected: "object",
         code: "invalid_type",
@@ -15561,6 +15561,19 @@ function createBufferedOutput() {
     lines
   };
 }
+function getClaudeProjectsRoot(env = process.env) {
+  const configDirOverride = env["CLAUDE_CONFIG_DIR"]?.trim();
+  if (configDirOverride !== void 0 && configDirOverride.length > 0) {
+    return path2.join(configDirOverride, "projects").replace(/\\/g, "/");
+  }
+  const home = env["HOME"]?.trim() || env["USERPROFILE"]?.trim();
+  if (home === void 0 || home.length === 0) {
+    throw new Error(
+      "Cannot resolve the user-global Claude projects directory: none of CLAUDE_CONFIG_DIR, HOME, or USERPROFILE is set."
+    );
+  }
+  return path2.join(home, ".claude", "projects").replace(/\\/g, "/");
+}
 function resolveBundledScriptPath(extensionRoot, bundledRelativePath) {
   const normalizedExtensionRoot = extensionRoot.replace(/\\/g, "/");
   const normalizedBundledRelativePath = bundledRelativePath.replace(/\\/g, "/").replace(/^\/+/, "");
@@ -16222,6 +16235,22 @@ var REPO_AUTOMATION_TOOL_DEFINITIONS = [
       required: ["artifact_type", "artifact_path"],
       additionalProperties: false
     }
+  },
+  {
+    name: "render_subagent_tree",
+    description: "Render the subagent call tree for a root session id. The session id is a transcript filename stem; the transcript is resolved under the user-global Claude projects directory, searching the encoded workspace directory plus its '-wt-' worktree siblings (case-insensitive) and returning the first match deterministically.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        workspace_root: workspaceRootProperty,
+        session_id: {
+          type: "string",
+          description: "Root session identifier (transcript filename stem under ~/.claude/projects/<encoded-workspace>/, e.g. a UUIDv4)."
+        }
+      },
+      required: ["session_id"],
+      additionalProperties: false
+    }
   }
 ];
 
@@ -16246,7 +16275,8 @@ var REPO_AUTOMATION_TOOLS = [
   "resolve_policy_audit_template_asset",
   "resolve_execute_hard_lock_prompt",
   "resolve_atomic_plan_prompt",
-  "validate_orchestration_artifacts"
+  "validate_orchestration_artifacts",
+  "render_subagent_tree"
 ];
 
 // ../../extensions/drm-copilot/src/mcp-tool-inputs-push-down.ts
@@ -16700,6 +16730,24 @@ async function handleResolveExecuteHardLockPrompt(rawInput, service) {
   });
 }
 
+// ../../extensions/drm-copilot/src/mcp-tool-inputs-subagent-tree.ts
+function resolveRenderSubagentTreeToolInput(rawInput, fallbackWorkspaceRoot) {
+  const args = asToolArgumentObject(rawInput);
+  return {
+    workspaceRoot: normalizeWorkspaceRoot(
+      args["workspace_root"],
+      fallbackWorkspaceRoot
+    ),
+    sessionId: normalizeRequiredText(args["session_id"], "session_id")
+  };
+}
+
+// ../../extensions/drm-copilot/src/mcp-handlers/render-subagent-tree-handler.ts
+async function handleRenderSubagentTree(rawInput, service) {
+  const input = resolveRenderSubagentTreeToolInput(rawInput);
+  return service.renderSubagentTree(input);
+}
+
 // ../../extensions/drm-copilot/src/mcp-handlers/template-validation-handlers.ts
 async function handleResolvePolicyAuditTemplateAsset(rawInput, service) {
   const input = resolvePolicyAuditTemplateAssetToolInput(rawInput);
@@ -16727,7 +16775,8 @@ function toMcpToolResult(result) {
     ...result.artifacts === void 0 ? {} : { artifacts: result.artifacts },
     ...result.assetId === void 0 ? {} : { asset_id: result.assetId },
     ...result.bundledSourcePath === void 0 ? {} : { bundled_source_path: result.bundledSourcePath },
-    ...result.destinationPath === void 0 ? {} : { destination_path: result.destinationPath }
+    ...result.destinationPath === void 0 ? {} : { destination_path: result.destinationPath },
+    ...result.renderedTree === void 0 ? {} : { rendered_tree: result.renderedTree }
   };
 }
 function toFailureToolResult(tool, workspaceRoot, error2) {
@@ -16833,6 +16882,11 @@ async function dispatchRepoAutomationTool(toolName, rawInput, service) {
           await handleValidateOrchestrationArtifacts(rawInput, service)
         );
       }
+      case "render_subagent_tree": {
+        return toMcpToolResult(
+          await handleRenderSubagentTree(rawInput, service)
+        );
+      }
     }
   } catch (error2) {
     return toFailureToolResult(toolName, workspaceRoot, error2);
@@ -17039,6 +17093,26 @@ function parseFirstArtifactPath(execution, pattern) {
   return capturedPath && capturedPath.length > 0 ? normalizeGeneratedPath(capturedPath) : void 0;
 }
 
+// ../../extensions/drm-copilot/src/repo-automation-execute-script.ts
+async function executeScriptServiceCall(output, extensionRoot, options) {
+  const execution = await executeBundledScriptFromExtensionRoot(output, {
+    runtimeKind: options.runtimeKind,
+    bundledRelativePath: options.bundledRelativePath,
+    commandId: options.invocationId,
+    args: options.args,
+    extensionRoot,
+    workspaceRoot: options.workspaceRoot
+  });
+  const parsedArtifactPath = options.stdoutArtifactPattern === void 0 ? void 0 : parseFirstArtifactPath(execution, options.stdoutArtifactPattern);
+  const artifacts = options.artifactPaths ?? (parsedArtifactPath === void 0 ? void 0 : [parsedArtifactPath]);
+  return {
+    tool: options.tool,
+    workspaceRoot: options.workspaceRoot,
+    summary: options.summary,
+    ...artifacts === void 0 ? {} : { artifacts }
+  };
+}
+
 // ../../extensions/drm-copilot/src/repo-automation-args.ts
 function buildPoshQcWorkflowArguments(tool, input) {
   const toolConfig = POSH_QC_TOOL_CONFIG[tool];
@@ -21791,6 +21865,143 @@ var SubprocessRunner = class {
 // ../../extensions/drm-copilot/src/lib/validate/validate-orchestration-service-call.ts
 var path9 = __toESM(require("node:path"));
 
+// ../../extensions/drm-copilot/src/lib/validate/epic-orchestrator-state-resolution.ts
+var LIFECYCLE_PREFIXES = [
+  "docs/features/active/",
+  "docs/features/completed/",
+  "active/",
+  "completed/"
+];
+var VALID_EPIC_TYPES = /* @__PURE__ */ new Set(["business", "enabler"]);
+function isObject2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pythonRepr(value) {
+  if (value === null || value === void 0) {
+    return "None";
+  }
+  if (typeof value === "boolean") {
+    return value ? "True" : "False";
+  }
+  if (typeof value === "string") {
+    return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+  }
+  return String(value);
+}
+function normalizeFolderHint(value) {
+  for (const prefix of LIFECYCLE_PREFIXES) {
+    if (value.startsWith(prefix)) {
+      return value.slice(prefix.length);
+    }
+  }
+  return value;
+}
+function buildFeatureReferenceIndex(features) {
+  const byFolderHint = /* @__PURE__ */ new Map();
+  const byIssueNum = /* @__PURE__ */ new Map();
+  for (const feature of features) {
+    const folder = feature["feature_folder"];
+    if (typeof folder === "string" && folder) {
+      byFolderHint.set(normalizeFolderHint(folder), folder);
+      const issueNum = feature["issue_num"];
+      if (issueNum !== void 0 && issueNum !== null) {
+        byIssueNum.set(issueNum, folder);
+      }
+    }
+  }
+  return { byFolderHint, byIssueNum };
+}
+function resolveFeatureReference(dependency, index) {
+  if (typeof dependency !== "string") {
+    return index.byIssueNum.get(dependency) ?? null;
+  }
+  return index.byFolderHint.get(normalizeFolderHint(dependency)) ?? null;
+}
+function detectDependencyCycle(features) {
+  const index = buildFeatureReferenceIndex(features);
+  const graph = /* @__PURE__ */ new Map();
+  for (const feature of features) {
+    const folder = feature["feature_folder"];
+    if (typeof folder !== "string" || !folder) {
+      continue;
+    }
+    const dependsOn = feature["depends_on"];
+    if (!Array.isArray(dependsOn)) {
+      graph.set(folder, []);
+      continue;
+    }
+    const resolvedEdges = [];
+    for (const dependency of dependsOn) {
+      const resolved = resolveFeatureReference(dependency, index);
+      if (resolved !== null) {
+        resolvedEdges.push(resolved);
+      }
+    }
+    graph.set(folder, resolvedEdges);
+  }
+  const visiting = /* @__PURE__ */ new Set();
+  const visited = /* @__PURE__ */ new Set();
+  function visit(node) {
+    if (visiting.has(node)) {
+      return node;
+    }
+    if (visited.has(node) || !graph.has(node)) {
+      return null;
+    }
+    visiting.add(node);
+    for (const dependency of graph.get(node) ?? []) {
+      const cycleNode = visit(dependency);
+      if (cycleNode !== null) {
+        return cycleNode;
+      }
+    }
+    visiting.delete(node);
+    visited.add(node);
+    return null;
+  }
+  for (const start of graph.keys()) {
+    const cycleNode = visit(start);
+    if (cycleNode !== null) {
+      return `Epic checkpoint depends_on graph contains a cycle involving feature_folder: ${cycleNode}`;
+    }
+  }
+  return null;
+}
+function validateIntentBlock(state) {
+  if (!("intent" in state)) {
+    return [];
+  }
+  const intent = state["intent"];
+  if (!isObject2(intent)) {
+    return ["Epic checkpoint intent must be an object."];
+  }
+  const errors = [];
+  const epicType = intent["epic_type"];
+  if (typeof epicType !== "string" || !VALID_EPIC_TYPES.has(epicType)) {
+    errors.push(
+      `Epic checkpoint intent.epic_type must be 'business' or 'enabler', found: ${pythonRepr(epicType)}`
+    );
+  }
+  const hypothesis = intent["business_outcome_hypothesis"];
+  if (typeof hypothesis !== "string" || !hypothesis.trim()) {
+    errors.push(
+      "Epic checkpoint intent.business_outcome_hypothesis must be a non-empty string."
+    );
+  }
+  for (const fieldName of ["leading_indicators", "nfrs"]) {
+    if (!(fieldName in intent)) {
+      continue;
+    }
+    const value = intent[fieldName];
+    if (!Array.isArray(value) || !value.every((item) => typeof item === "string")) {
+      errors.push(
+        `Epic checkpoint intent.${fieldName} must be a list of strings.`
+      );
+    }
+  }
+  return errors;
+}
+
 // ../../extensions/drm-copilot/src/lib/validate/epic-orchestrator-state-core.ts
 var REQUIRED_BASELINE_KEYS = [
   "objective",
@@ -21820,7 +22031,7 @@ var MERGED_STATUSES = /* @__PURE__ */ new Set([
   "merged",
   "worktree_removed"
 ]);
-function isObject2(value) {
+function isObject3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function extractFeatures(state) {
@@ -21828,7 +22039,7 @@ function extractFeatures(state) {
   if (!Array.isArray(features)) {
     return [];
   }
-  return features.filter(isObject2);
+  return features.filter(isObject3);
 }
 function missingBaselineAndEpicKeys(state) {
   const errors = [];
@@ -21851,13 +22062,7 @@ function validateFeatureFolderUniquenessAndDependencies(features) {
   const errors = [];
   const seen = /* @__PURE__ */ new Set();
   const duplicates = /* @__PURE__ */ new Set();
-  const allFolders = /* @__PURE__ */ new Set();
-  for (const feature of features) {
-    const folder = feature["feature_folder"];
-    if (typeof folder === "string" && folder) {
-      allFolders.add(folder);
-    }
-  }
+  const index = buildFeatureReferenceIndex(features);
   for (const feature of features) {
     const folder = feature["feature_folder"];
     if (typeof folder !== "string" || !folder) {
@@ -21872,7 +22077,7 @@ function validateFeatureFolderUniquenessAndDependencies(features) {
       continue;
     }
     for (const dependency of dependsOn) {
-      if (!allFolders.has(dependency)) {
+      if (resolveFeatureReference(dependency, index) === null) {
         errors.push(
           `Epic checkpoint feature '${folder}' depends_on unresolved feature_folder: ${JSON.stringify(dependency)}`
         );
@@ -21886,49 +22091,6 @@ function validateFeatureFolderUniquenessAndDependencies(features) {
   }
   return errors;
 }
-function detectDependencyCycle(features) {
-  const graph = /* @__PURE__ */ new Map();
-  for (const feature of features) {
-    const folder = feature["feature_folder"];
-    if (typeof folder !== "string" || !folder) {
-      continue;
-    }
-    const dependsOn = feature["depends_on"];
-    graph.set(
-      folder,
-      Array.isArray(dependsOn) ? dependsOn.filter(
-        (d) => typeof d === "string"
-      ) : []
-    );
-  }
-  const visiting = /* @__PURE__ */ new Set();
-  const visited = /* @__PURE__ */ new Set();
-  function visit(node) {
-    if (visiting.has(node)) {
-      return node;
-    }
-    if (visited.has(node) || !graph.has(node)) {
-      return null;
-    }
-    visiting.add(node);
-    for (const dependency of graph.get(node) ?? []) {
-      const cycleNode = visit(dependency);
-      if (cycleNode !== null) {
-        return cycleNode;
-      }
-    }
-    visiting.delete(node);
-    visited.add(node);
-    return null;
-  }
-  for (const start of graph.keys()) {
-    const cycleNode = visit(start);
-    if (cycleNode !== null) {
-      return `Epic checkpoint depends_on graph contains a cycle involving feature_folder: ${cycleNode}`;
-    }
-  }
-  return null;
-}
 function validateMergeStatusEnum(features) {
   const errors = [];
   for (const feature of features) {
@@ -21951,6 +22113,7 @@ function validateWaveBarrierOrdering(features) {
       byFolder.set(folder, feature);
     }
   }
+  const index = buildFeatureReferenceIndex(features);
   for (const feature of features) {
     const folder = feature["feature_folder"];
     const dependsOn = feature["depends_on"];
@@ -21959,7 +22122,8 @@ function validateWaveBarrierOrdering(features) {
     }
     const worktreeCreatedAt = feature["worktree_created_at"];
     for (const dependency of dependsOn) {
-      const dependencyFeature = byFolder.get(dependency);
+      const resolved = resolveFeatureReference(dependency, index);
+      const dependencyFeature = resolved !== null ? byFolder.get(resolved) : void 0;
       if (dependencyFeature === void 0) {
         continue;
       }
@@ -21982,15 +22146,17 @@ function validateWavesConsistency(state) {
   if (!Array.isArray(waves)) {
     return errors;
   }
+  const features = extractFeatures(state);
   const featuresByFolder = /* @__PURE__ */ new Map();
-  for (const feature of extractFeatures(state)) {
+  for (const feature of features) {
     const folder = feature["feature_folder"];
     if (typeof folder === "string") {
       featuresByFolder.set(folder, feature);
     }
   }
+  const index = buildFeatureReferenceIndex(features);
   for (const waveItem of waves) {
-    if (!isObject2(waveItem)) {
+    if (!isObject3(waveItem)) {
       continue;
     }
     const waveNumber = waveItem["wave_number"];
@@ -21999,7 +22165,8 @@ function validateWavesConsistency(state) {
       continue;
     }
     for (const folder of folders) {
-      const feature = featuresByFolder.get(folder);
+      const resolved = resolveFeatureReference(folder, index);
+      const feature = resolved !== null ? featuresByFolder.get(resolved) : void 0;
       if (feature === void 0) {
         continue;
       }
@@ -22024,7 +22191,7 @@ function validateCompletion(features, state) {
     }
   }
   const epicMergePr = state["epic_merge_pr"];
-  const mergeCommitSha = isObject2(epicMergePr) ? epicMergePr["merge_commit_sha"] : void 0;
+  const mergeCommitSha = isObject3(epicMergePr) ? epicMergePr["merge_commit_sha"] : void 0;
   if (typeof mergeCommitSha !== "string" || !mergeCommitSha.trim()) {
     errors.push(
       "Epic checkpoint completion validation failed: epic_merge_pr.merge_commit_sha is missing or empty."
@@ -22041,7 +22208,7 @@ function validateEpicOrchestratorStateText(text, options = {}) {
       `Epic checkpoint is not valid JSON: ${exc instanceof Error ? exc.message : String(exc)}`
     ];
   }
-  if (!isObject2(state)) {
+  if (!isObject3(state)) {
     return ["Epic checkpoint root must be a JSON object."];
   }
   const stateMap = state;
@@ -22057,6 +22224,7 @@ function validateEpicOrchestratorStateText(text, options = {}) {
   errors.push(...validateMergeStatusEnum(features));
   errors.push(...validateWaveBarrierOrdering(features));
   errors.push(...validateWavesConsistency(stateMap));
+  errors.push(...validateIntentBlock(stateMap));
   if (options.requireComplete === true) {
     errors.push(...validateCompletion(features, stateMap));
   }
@@ -22079,11 +22247,11 @@ var PROMOTION_RECEIPT_KEYS = [
   "issue",
   "feature_folder"
 ];
-function isObject3(value) {
+function isObject4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function missingObjectKeys(value, keys) {
-  if (!isObject3(value)) {
+  if (!isObject4(value)) {
     return [...keys];
   }
   const missing = [];
@@ -22098,7 +22266,7 @@ function missingObjectKeys(value, keys) {
 function validateCompletionPrGate(state) {
   const prGate = state["pr_gate"];
   const missing = missingObjectKeys(prGate, PR_GATE_KEYS);
-  if (!isObject3(prGate)) {
+  if (!isObject4(prGate)) {
     return [
       `Checkpoint completion validation failed: pr_gate must be an object with keys: ${PR_GATE_KEYS.join(", ")}.`
     ];
@@ -22121,7 +22289,7 @@ function validateCompletionPrGate(state) {
 function validateCompletionCiGate(state) {
   const ciGate = state["ci_gate"];
   const missing = missingObjectKeys(ciGate, CI_GATE_KEYS);
-  if (!isObject3(ciGate)) {
+  if (!isObject4(ciGate)) {
     return [
       `Checkpoint completion validation failed: ci_gate must be an object with keys: ${CI_GATE_KEYS.join(", ")}.`
     ];
@@ -22138,7 +22306,7 @@ function validateCompletionCiGate(state) {
     );
   }
   const prGate = state["pr_gate"];
-  const prHeadSha = isObject3(prGate) ? prGate["head_sha"] : null;
+  const prHeadSha = isObject4(prGate) ? prGate["head_sha"] : null;
   if (prHeadSha !== null && prHeadSha !== void 0 && ciGate["head_sha"] !== prHeadSha) {
     errors.push(
       "Checkpoint completion validation failed: ci_gate.head_sha must match pr_gate.head_sha."
@@ -22153,7 +22321,7 @@ function validateIssue232PromotionReceipts(state) {
   const receipts = state["delegation_receipts"];
   let promotionSource = "promotion_receipts";
   let promotion = state["promotion_receipts"];
-  if (isObject3(receipts)) {
+  if (isObject4(receipts)) {
     const namespacedPromotion = receipts[PROMOTION_RECEIPT_NAMESPACE_KEY];
     if (namespacedPromotion !== void 0 && namespacedPromotion !== null) {
       promotionSource = "delegation_receipts.promotion";
@@ -22178,10 +22346,10 @@ var HUMAN_INTERACTION_RESPONSE_ENUM = /* @__PURE__ */ new Set([
   "halt"
 ]);
 var HUMAN_INTERACTION_EXCEPTION_RESPONSE = "exception";
-function isObject4(value) {
+function isObject5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function pythonRepr(value) {
+function pythonRepr2(value) {
   if (value === null || value === void 0) {
     return "None";
   }
@@ -22195,7 +22363,7 @@ function pythonRepr(value) {
 }
 function validateHumanInteraction(humanInteraction) {
   const errors = [];
-  if (!isObject4(humanInteraction)) {
+  if (!isObject5(humanInteraction)) {
     errors.push("Checkpoint human_interaction must be an object when present.");
     return errors;
   }
@@ -22205,7 +22373,7 @@ function validateHumanInteraction(humanInteraction) {
     return errors;
   }
   requirements.forEach((requirement, index) => {
-    if (!isObject4(requirement)) {
+    if (!isObject5(requirement)) {
       errors.push(
         `Checkpoint human_interaction.requirements #${index} must be an object.`
       );
@@ -22214,7 +22382,7 @@ function validateHumanInteraction(humanInteraction) {
     const response = requirement["response"];
     if (typeof response !== "string" || !HUMAN_INTERACTION_RESPONSE_ENUM.has(response)) {
       errors.push(
-        `Checkpoint human_interaction.requirements #${index} response must be one of scope_change, exception, halt; got: ` + pythonRepr(response)
+        `Checkpoint human_interaction.requirements #${index} response must be one of scope_change, exception, halt; got: ` + pythonRepr2(response)
       );
       return;
     }
@@ -22235,7 +22403,7 @@ var REMEDIATION_LOOP_KEY = "remediation_loop";
 var REMEDIATION_CYCLES_KEY = "cycles";
 var EXECUTION_STATUSES_REQUIRING_CLEAR_PREFLIGHT = /* @__PURE__ */ new Set(["in_progress", "complete", "failed"]);
 var PREFLIGHT_CLEARED_STATUS = "clear";
-function isObject5(value) {
+function isObject6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function validateRemediationCycle(index, cycle) {
@@ -22249,7 +22417,7 @@ function validateRemediationCycle(index, cycle) {
   const executionStatus = cycle["execution_status"];
   if (typeof executionStatus === "string" && EXECUTION_STATUSES_REQUIRING_CLEAR_PREFLIGHT.has(executionStatus)) {
     const preflight = cycle["preflight"];
-    const preflightStatus = isObject5(preflight) ? preflight["final_status"] : void 0;
+    const preflightStatus = isObject6(preflight) ? preflight["final_status"] : void 0;
     if (preflightStatus !== PREFLIGHT_CLEARED_STATUS) {
       errors.push(
         `Checkpoint remediation cycle #${index} execution_status is ${executionStatus} but preflight.final_status is not 'clear'.`
@@ -22265,7 +22433,7 @@ function validateRemediationCycle(index, cycle) {
 }
 function validateRemediationLoop(remediationLoop) {
   const errors = [];
-  if (!isObject5(remediationLoop)) {
+  if (!isObject6(remediationLoop)) {
     return errors;
   }
   const cycles = remediationLoop[REMEDIATION_CYCLES_KEY];
@@ -22273,7 +22441,7 @@ function validateRemediationLoop(remediationLoop) {
     return errors;
   }
   cycles.forEach((cycle, index) => {
-    if (!isObject5(cycle)) {
+    if (!isObject6(cycle)) {
       errors.push(`Checkpoint remediation cycle #${index} must be an object.`);
       return;
     }
@@ -22284,7 +22452,7 @@ function validateRemediationLoop(remediationLoop) {
 
 // ../../extensions/drm-copilot/src/lib/validate/orchestrator-state-routing.ts
 var ROUTING_MATRIX_RELATIVE_PATH = "config/orchestration-routing.json";
-function isObject6(value) {
+function isObject7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function loadRoutingMatrix(fs9, root) {
@@ -22321,7 +22489,7 @@ function listReceipts(receipts) {
   if (!Array.isArray(receipts)) {
     return [];
   }
-  return receipts.filter(isObject6);
+  return receipts.filter(isObject7);
 }
 function receiptAgents(state) {
   const agents = /* @__PURE__ */ new Set();
@@ -22340,7 +22508,7 @@ function receiptSkills(state) {
     return skills;
   }
   for (const receipt of receipts) {
-    if (!isObject6(receipt)) {
+    if (!isObject7(receipt)) {
       continue;
     }
     const skill = receipt["skill"];
@@ -22359,7 +22527,7 @@ function mcpTools(state) {
     return tools;
   }
   for (const receipt of receipts) {
-    if (!isObject6(receipt)) {
+    if (!isObject7(receipt)) {
       continue;
     }
     const tool = receipt["tool"];
@@ -22391,7 +22559,7 @@ function validateLifecycleOperations(state) {
   }
   const errors = [];
   operations.forEach((operation, index) => {
-    if (!isObject6(operation)) {
+    if (!isObject7(operation)) {
       errors.push(
         `Checkpoint lifecycle_operations #${index} must be an object.`
       );
@@ -22407,11 +22575,11 @@ function validateLifecycleOperations(state) {
 }
 function validateRoutingContract(state, options = {}) {
   const matrix = options.routingMatrix;
-  if (!isObject6(matrix)) {
+  if (!isObject7(matrix)) {
     return ["Routing matrix missing routes object."];
   }
   const rawRoutes = matrix["routes"];
-  if (!isObject6(rawRoutes)) {
+  if (!isObject7(rawRoutes)) {
     return ["Routing matrix missing routes object."];
   }
   const routeIdValue = state["route_id"] !== void 0 ? state["route_id"] : state["path_selected"];
@@ -22420,7 +22588,7 @@ function validateRoutingContract(state, options = {}) {
   }
   const routeId = routeIdValue;
   const rawRoute = rawRoutes[routeId];
-  if (!isObject6(rawRoute)) {
+  if (!isObject7(rawRoute)) {
     return [
       `Checkpoint selected route has no routing-matrix entry: ${routeId}.`
     ];
@@ -22538,13 +22706,13 @@ var DELEGATING_AGENTS = /* @__PURE__ */ new Set([
   "prd-feature",
   "pr-author"
 ]);
-function isObject7(value) {
+function isObject8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function validateListDelegationReceipts(receipts) {
   const errors = [];
   receipts.forEach((receipt, index) => {
-    if (!isObject7(receipt)) {
+    if (!isObject8(receipt)) {
       errors.push(`Checkpoint delegation receipt #${index} must be an object.`);
       return;
     }
@@ -22576,7 +22744,7 @@ function validateNamespacedDelegationReceipts(receipts) {
   if (promotionReceipts === void 0 || promotionReceipts === null) {
     return errors;
   }
-  if (!isObject7(promotionReceipts)) {
+  if (!isObject8(promotionReceipts)) {
     errors.push(
       "Checkpoint delegation_receipts.promotion must be an object namespace."
     );
@@ -22606,7 +22774,7 @@ function delegatedAgents(stateMap) {
   const receipts = stateMap["delegation_receipts"];
   if (Array.isArray(receipts)) {
     receipts.forEach((receipt) => {
-      if (!isObject7(receipt)) {
+      if (!isObject8(receipt)) {
         return;
       }
       const agentName = receipt["agent_name"];
@@ -22631,7 +22799,7 @@ function validateModelRoutingExistence(stateMap) {
   const receipts = stateMap["model_routing_receipts"];
   if (Array.isArray(receipts)) {
     receipts.forEach((receipt) => {
-      if (!isObject7(receipt)) {
+      if (!isObject8(receipt)) {
         return;
       }
       const agent = receipt["agent"];
@@ -22658,7 +22826,7 @@ function validateOrchestratorStateText(text, options = {}) {
       `Checkpoint is not valid JSON: ${exc instanceof Error ? exc.message : String(exc)}`
     ];
   }
-  if (!isObject7(state)) {
+  if (!isObject8(state)) {
     return ["Checkpoint root must be a JSON object."];
   }
   const stateMap = state;
@@ -22683,7 +22851,7 @@ function validateOrchestratorStateText(text, options = {}) {
   if (receipts !== void 0 && receipts !== null) {
     if (Array.isArray(receipts)) {
       errors.push(...validateListDelegationReceipts(receipts));
-    } else if (isObject7(receipts)) {
+    } else if (isObject8(receipts)) {
       errors.push(...validateNamespacedDelegationReceipts(receipts));
     } else {
       errors.push(
@@ -27041,6 +27209,13 @@ function copyTemplate(featureType, templateDir, targetDir, fs9) {
         }
       }
     }
+  } else if (featureType === "epic") {
+    for (const name of ["epic.md", "epic-status.md"]) {
+      const src = joinPosix13(templateDir, name);
+      if (fs9.exists(src)) {
+        fs9.copyFile(src, joinPosix13(targetDir, name));
+      }
+    }
   } else {
     fs9.copyTree(templateDir, targetDir);
   }
@@ -27238,9 +27413,9 @@ function updateFeatureDocs(featureType, featureName, targetDir, issueField, owne
     );
     filesToOpen.push(spec, plan);
   } else if (featureType === "epic") {
-    const initiative = joinPosix13(targetDir, "initiative.md");
+    const epic = joinPosix13(targetDir, "epic.md");
     applyHeaderAndSections(
-      initiative,
+      epic,
       featureName,
       issueField,
       ownerField,
@@ -27251,7 +27426,7 @@ function updateFeatureDocs(featureType, featureName, targetDir, issueField, owne
       fs9,
       []
     );
-    filesToOpen.push(initiative);
+    filesToOpen.push(epic);
   } else if (featureType === "bug") {
     const spec = joinPosix13(targetDir, "spec.md");
     const plan = planPath ?? joinPosix13(targetDir, "plan.md");
@@ -27418,15 +27593,18 @@ function createActiveFolder(options) {
   if (!normalizedIssueNumber) {
     normalizedIssueNumber = parseIssueNumber(potentialContent);
   }
-  const folderSlug = buildFolderSlug(
-    resolvedFeatureName,
-    potentialFile,
-    normalizedIssueNumber
-  );
-  const targetDir = joinPosix13(
-    workspacePath,
-    `docs/features/active/${folderSlug}`
-  );
+  let targetDir;
+  if (featureType === "epic") {
+    const epicSlug = buildFolderSlug(resolvedFeatureName, null, null);
+    targetDir = joinPosix13(workspacePath, `docs/features/epics/${epicSlug}`);
+  } else {
+    const folderSlug = buildFolderSlug(
+      resolvedFeatureName,
+      potentialFile,
+      normalizedIssueNumber
+    );
+    targetDir = joinPosix13(workspacePath, `docs/features/active/${folderSlug}`);
+  }
   if (filesystem.exists(targetDir) && !force) {
     throw new Error(
       `Target exists: ${targetDir}. Re-run with --force to overwrite.`
@@ -27631,6 +27809,299 @@ function newActiveFeatureFolderServiceCall(input) {
   };
 }
 
+// ../../extensions/drm-copilot/src/lib/subagent-tree/tree-assembler.ts
+var ROOT_KEY = "__root__";
+function assembleTree(scanned) {
+  const transcriptsByKey = /* @__PURE__ */ new Map();
+  transcriptsByKey.set(ROOT_KEY, scanned.root);
+  for (const subagent of scanned.subagents) {
+    transcriptsByKey.set(subagent.meta.agentId, subagent.transcript);
+  }
+  const matchedChildrenByParentKey = /* @__PURE__ */ new Map();
+  const orphans = [];
+  for (const subagent of scanned.subagents) {
+    const parentKey = findParentKey(subagent.meta.toolUseId, transcriptsByKey);
+    if (parentKey === void 0) {
+      orphans.push(subagent);
+      continue;
+    }
+    const siblings = matchedChildrenByParentKey.get(parentKey) ?? [];
+    siblings.push(subagent);
+    matchedChildrenByParentKey.set(parentKey, siblings);
+  }
+  orphans.sort(compareByAgentId);
+  return buildNode({
+    key: ROOT_KEY,
+    agentType: "root",
+    description: "",
+    depth: 0,
+    models: scanned.root.models,
+    transcriptsByKey,
+    matchedChildrenByParentKey,
+    orphans
+  });
+}
+function findParentKey(toolUseId, transcriptsByKey) {
+  for (const [key, transcript] of transcriptsByKey) {
+    if (transcript.agentToolUseIds.includes(toolUseId)) {
+      return key;
+    }
+  }
+  return void 0;
+}
+function compareByAgentId(a, b) {
+  if (a.meta.agentId < b.meta.agentId) {
+    return -1;
+  }
+  if (a.meta.agentId > b.meta.agentId) {
+    return 1;
+  }
+  return 0;
+}
+function sortBySpawnIndex(children, parentTranscript) {
+  return [...children].sort((a, b) => {
+    const indexA = parentTranscript.agentToolUseIds.indexOf(a.meta.toolUseId);
+    const indexB = parentTranscript.agentToolUseIds.indexOf(b.meta.toolUseId);
+    if (indexA !== indexB) {
+      return indexA - indexB;
+    }
+    return compareByAgentId(a, b);
+  });
+}
+function buildNode(input) {
+  const {
+    key,
+    agentType,
+    description,
+    depth,
+    models,
+    transcriptsByKey,
+    matchedChildrenByParentKey,
+    orphans
+  } = input;
+  const transcript = transcriptsByKey.get(key);
+  const matchedChildren = matchedChildrenByParentKey.get(key) ?? [];
+  const orderedMatched = transcript ? sortBySpawnIndex(matchedChildren, transcript) : matchedChildren;
+  const isRoot = key === ROOT_KEY;
+  const orderedChildren = isRoot ? [...orderedMatched, ...orphans] : orderedMatched;
+  const children = orderedChildren.map(
+    (subagent) => buildNode({
+      key: subagent.meta.agentId,
+      agentType: subagent.meta.agentType,
+      description: subagent.meta.description,
+      depth: subagent.meta.spawnDepth,
+      models: subagent.transcript.models,
+      transcriptsByKey,
+      matchedChildrenByParentKey,
+      orphans
+    })
+  );
+  return {
+    agentType,
+    description,
+    depth,
+    models: [...models].sort(),
+    children
+  };
+}
+
+// ../../extensions/drm-copilot/src/lib/subagent-tree/transcript-parser.ts
+function parseTranscriptLines(lines) {
+  const models = [];
+  const seenModels = /* @__PURE__ */ new Set();
+  const agentToolUseIds = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) {
+      continue;
+    }
+    const parsed = tryParseJson(trimmed);
+    if (!isRecord2(parsed)) {
+      continue;
+    }
+    const message = parsed["message"];
+    if (!isRecord2(message)) {
+      continue;
+    }
+    recordModel(message["model"], models, seenModels);
+    collectAgentToolUseIds(message["content"], agentToolUseIds);
+  }
+  return { models, agentToolUseIds };
+}
+function tryParseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function recordModel(model, models, seenModels) {
+  if (typeof model === "string" && model.length > 0 && !seenModels.has(model)) {
+    seenModels.add(model);
+    models.push(model);
+  }
+}
+function collectAgentToolUseIds(content, agentToolUseIds) {
+  if (!Array.isArray(content)) {
+    return;
+  }
+  for (const block of content) {
+    if (!isRecord2(block)) {
+      continue;
+    }
+    if (block["type"] === "tool_use" && block["name"] === "Agent" && typeof block["id"] === "string") {
+      agentToolUseIds.push(block["id"]);
+    }
+  }
+}
+
+// ../../extensions/drm-copilot/src/lib/subagent-tree/transcript-scanner.ts
+var META_SUFFIX = ".meta.json";
+var TRANSCRIPT_SUFFIX = ".jsonl";
+var META_FILENAME_PATTERN = /agent-([^/\\]+)\.meta\.json$/;
+function scanTranscripts(rootSessionPath, fileSystem) {
+  if (!rootSessionPath.endsWith(TRANSCRIPT_SUFFIX)) {
+    throw new Error(
+      `scanTranscripts: rootSessionPath must end in "${TRANSCRIPT_SUFFIX}", got: ${rootSessionPath}`
+    );
+  }
+  const root = readTranscript(rootSessionPath, fileSystem);
+  const subagentsDir = `${rootSessionPath.slice(0, -TRANSCRIPT_SUFFIX.length)}/subagents`;
+  const metaPaths = fileSystem.glob(subagentsDir, "agent-*.meta.json");
+  const subagents = metaPaths.map((metaPath) => readSubagent(metaPath, fileSystem)).filter((subagent) => subagent !== void 0);
+  return { root, subagents };
+}
+function readTranscript(path11, fileSystem) {
+  const content = fileSystem.readTextFile(path11);
+  return parseTranscriptLines(content.split(/\r?\n/));
+}
+function readSubagent(metaPath, fileSystem) {
+  const filenameMatch = META_FILENAME_PATTERN.exec(metaPath);
+  const agentId = filenameMatch?.[1];
+  if (agentId === void 0) {
+    return void 0;
+  }
+  const metaContent = fileSystem.readTextFile(metaPath);
+  const meta2 = parseSubagentMeta(agentId, metaContent);
+  if (!meta2) {
+    return void 0;
+  }
+  const transcriptPath = metaPath.slice(0, -META_SUFFIX.length) + TRANSCRIPT_SUFFIX;
+  const transcript = readTranscript(transcriptPath, fileSystem);
+  return { meta: meta2, transcript };
+}
+function parseSubagentMeta(agentId, content) {
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch {
+    return void 0;
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    return void 0;
+  }
+  const record2 = parsed;
+  const agentType = record2["agentType"];
+  const description = record2["description"];
+  const toolUseId = record2["toolUseId"];
+  const spawnDepth = record2["spawnDepth"];
+  if (typeof agentType !== "string" || typeof description !== "string" || typeof toolUseId !== "string" || typeof spawnDepth !== "number") {
+    return void 0;
+  }
+  const worktreePath = record2["worktreePath"];
+  const worktreeBranch = record2["worktreeBranch"];
+  return {
+    agentId,
+    agentType,
+    description,
+    toolUseId,
+    spawnDepth,
+    ...typeof worktreePath === "string" ? { worktreePath } : {},
+    ...typeof worktreeBranch === "string" ? { worktreeBranch } : {}
+  };
+}
+
+// ../../extensions/drm-copilot/src/lib/subagent-tree/tree-formatter.ts
+function formatTree(node) {
+  return renderLines(node).join("\n");
+}
+function renderLines(node) {
+  const indent = "  ".repeat(node.depth);
+  const sortedModels = [...node.models].sort();
+  const line = `${indent}${node.agentType} \xB7 [${sortedModels.join(",")}] \xB7 ${node.depth} \xB7 ${node.description}`;
+  const childLines = node.children.flatMap((child) => renderLines(child));
+  return [line, ...childLines];
+}
+
+// ../../extensions/drm-copilot/src/lib/subagent-tree/index.ts
+function buildSubagentTree(rootSessionPath, deps) {
+  const scanned = scanTranscripts(rootSessionPath, deps.fileSystem);
+  return assembleTree(scanned);
+}
+
+// ../../extensions/drm-copilot/src/lib/subagent-tree/workspace-encoding.ts
+var WORKTREE_INFIX = "-wt-";
+function encodeWorkspacePath(workspacePath) {
+  return workspacePath.replace(/[\\/:]/g, "-");
+}
+function matchEncodedDirectories(directoryNames, encodedWorkspaceName) {
+  const target = encodedWorkspaceName.toLowerCase();
+  const worktreePrefix = `${target}${WORKTREE_INFIX}`;
+  return directoryNames.filter((directoryName) => {
+    const lowerDirectoryName = directoryName.toLowerCase();
+    return lowerDirectoryName === target || lowerDirectoryName.startsWith(worktreePrefix);
+  });
+}
+
+// ../../extensions/drm-copilot/src/lib/subagent-tree/session-transcript-resolver.ts
+var SESSION_ID_PATTERN = /^[0-9A-Za-z-]{8,64}$/;
+var SESSION_ID_RULE = "^[0-9A-Za-z-]{8,64}$ (8-64 characters of digits, ASCII letters, or hyphen)";
+function resolveSessionTranscriptPath(sessionId, workspaceRoot, claudeProjectsRoot, fileSystem) {
+  if (!SESSION_ID_PATTERN.test(sessionId)) {
+    throw new Error(
+      `Invalid session id '${sessionId}': must match ${SESSION_ID_RULE}.`
+    );
+  }
+  const encodedWorkspaceName = encodeWorkspacePath(workspaceRoot);
+  const matchingDirectories = matchEncodedDirectories(
+    fileSystem.listDirectory(claudeProjectsRoot),
+    encodedWorkspaceName
+  );
+  for (const directoryName of matchingDirectories) {
+    const transcriptPath = `${claudeProjectsRoot}/${directoryName}/${sessionId}.jsonl`;
+    if (fileSystem.isFile(transcriptPath)) {
+      return transcriptPath;
+    }
+  }
+  const searched = matchingDirectories.length === 0 ? "(no directories matched the encoded workspace path)" : matchingDirectories.map((directoryName) => `${claudeProjectsRoot}/${directoryName}`).join(", ");
+  throw new Error(
+    `No transcript found for session id '${sessionId}' under ${claudeProjectsRoot}. Searched: ${searched}.`
+  );
+}
+
+// ../../extensions/drm-copilot/src/repo-automation-service-subagent-tree.ts
+function renderSubagentTreeServiceCall(input, env = process.env) {
+  const claudeProjectsRoot = getClaudeProjectsRoot(env);
+  const transcriptPath = resolveSessionTranscriptPath(
+    input.sessionId,
+    input.workspaceRoot,
+    claudeProjectsRoot,
+    input.fileSystem
+  );
+  const renderedTree = formatTree(
+    buildSubagentTree(transcriptPath, { fileSystem: input.fileSystem })
+  );
+  return {
+    tool: "render_subagent_tree",
+    workspaceRoot: input.workspaceRoot,
+    summary: `Rendered subagent tree for session ${input.sessionId} (${transcriptPath}).`,
+    renderedTree
+  };
+}
+
 // ../../extensions/drm-copilot/src/repo-automation-service.ts
 var DefaultRepoAutomationService = class {
   extensionRoot;
@@ -27800,23 +28271,14 @@ var DefaultRepoAutomationService = class {
       buildValidateOrchestrationServiceCallInput(this.fileSystem, input)
     );
   }
-  async executeScript(options) {
-    const execution = await executeBundledScriptFromExtensionRoot(this.output, {
-      runtimeKind: options.runtimeKind,
-      bundledRelativePath: options.bundledRelativePath,
-      commandId: options.invocationId,
-      args: options.args,
-      extensionRoot: this.extensionRoot,
-      workspaceRoot: options.workspaceRoot
+  async renderSubagentTree(input) {
+    return renderSubagentTreeServiceCall({
+      ...input,
+      fileSystem: this.fileSystem
     });
-    const parsedArtifactPath = options.stdoutArtifactPattern === void 0 ? void 0 : parseFirstArtifactPath(execution, options.stdoutArtifactPattern);
-    const artifacts = options.artifactPaths ?? (parsedArtifactPath === void 0 ? void 0 : [parsedArtifactPath]);
-    return {
-      tool: options.tool,
-      workspaceRoot: options.workspaceRoot,
-      summary: options.summary,
-      ...artifacts === void 0 ? {} : { artifacts }
-    };
+  }
+  async executeScript(options) {
+    return executeScriptServiceCall(this.output, this.extensionRoot, options);
   }
 };
 function createRepoAutomationService(options) {