mandrel 1.94.0 → 2.1.0

package/.agents/scripts/lib/git-utils.js

@@ -43,6 +43,18 @@ import { execFileSync, spawnSync } from 'node:child_process';
 let _execFileSync = execFileSync;
 let _spawnSync = spawnSync;
 
+/**
+ * Memoized cleaned env shared by every `gitSync` / `gitSpawn` /
+ * `createGitInterface` invocation in this process. Built lazily on first
+ * use so cold imports pay nothing. Call sites pass the object through to
+ * `child_process` only — none mutate `GIT_*` (or any other key) between
+ * git calls, so reuse is safe. Tests that mutate `process.env` and need
+ * a fresh snapshot must call {@link __resetCleanGitEnv}.
+ *
+ * @type {NodeJS.ProcessEnv | null}
+ */
+let _cleanGitEnv = null;
+
 /**
  * Build a child-process env that drops every `GIT_*` variable inherited from
  * the parent. When this module's helpers run inside a git hook (e.g. husky
@@ -53,13 +65,28 @@ let _spawnSync = spawnSync;
  * that spin up real git fixtures break reproducibly under that shape.
  *
  * Stripping every `GIT_*` is broader than strictly necessary but cheap and
- * impossible to drift out of sync with future git releases. Author/committer
- * identity is restored via per-call `env:` overrides where required.
+ * impossible to drift out of sync with future git releases. The result is
+ * memoized per process (see `_cleanGitEnv`); author/committer identity is
+ * restored via per-call `env:` overrides where required.
+ *
+ * @returns {NodeJS.ProcessEnv}
  */
 function cleanGitEnv() {
-  return Object.fromEntries(
-    Object.entries(process.env).filter(([k]) => !k.startsWith('GIT_')),
+  if (_cleanGitEnv) return _cleanGitEnv;
+  _cleanGitEnv = Object.freeze(
+    Object.fromEntries(
+      Object.entries(process.env).filter(([k]) => !k.startsWith('GIT_')),
+    ),
   );
+  return _cleanGitEnv;
+}
+
+/**
+ * Drop the memoized cleaned env so the next git call rebuilds from
+ * `process.env`. Testing-only seam — not part of the stable API.
+ */
+export function __resetCleanGitEnv() {
+  _cleanGitEnv = null;
 }
 
 /**
@@ -288,20 +315,6 @@ export function gitPullWithRetry(cwd, ...args) {
   return gitWithContentionRetry(cwd, ['pull', '--rebase'], args);
 }
 
-/**
- * Resolves the canonical branch name for an Epic.
- * v5 Standard: epic/[EPIC_ID]
- * @param {string|number} epicId
- * @returns {string}
- */
-export function getEpicBranch(epicId) {
-  const id = typeof epicId === 'number' ? epicId : Number.parseInt(epicId, 10);
-  if (!Number.isFinite(id) || id <= 0) {
-    throw new Error(`getEpicBranch: invalid epicId: ${epicId}`);
-  }
-  return `epic/${id}`;
-}
-
 /**
  * Sanitize a string into a URL/branch-safe slug.
  * Lowercases, replaces non-alphanumeric characters with hyphens,
@@ -321,11 +334,10 @@ export function slugify(text) {
 /**
  * Resolves the canonical branch name for a Story.
  * v5 Standard: story-[STORY_ID]
- * @param {string|number} _epicId - Unused; retained for back-compat call sites.
  * @param {string|number} storyId
  * @returns {string}
  */
-export function getStoryBranch(_epicId, storyId) {
+export function getStoryBranch(storyId) {
   const id =
     typeof storyId === 'number' ? storyId : Number.parseInt(storyId, 10);
   if (!Number.isFinite(id) || id <= 0) {

package/.agents/scripts/lib/github/framework-repo.js

@@ -0,0 +1,6 @@
+/**
+ * Canonical framework repository slug used by follow-up / graduator
+ * paths when the consumer config does not supply owner/repo.
+ */
+
+export const DEFAULT_FRAMEWORK_REPO = 'dsj1984/mandrel';

package/.agents/scripts/lib/json-utils.js

@@ -2,8 +2,7 @@
  * json-utils.js — shared JSON-shape helpers.
  *
  * Hoisted out of five callers (`lib/baselines/writer.js`,
- * `lib/config/defaults.js`, `lib/observability/baseline-refresh-rate.js`,
- * `lib/observability/perf-aggregator.js`, `lib/signals/schema.js`) which
+ * `lib/config/defaults.js`, `lib/signals/schema.js`) which
  * shipped functionally-equivalent copies of these predicates. See Story
  * #2464.
  *

package/.agents/scripts/lib/label-constants.js

@@ -1,8 +1,8 @@
 /**
  * Central source of truth for all GitHub label names used by the orchestrator.
  *
- * Every other module (label-taxonomy, dispatch-engine, story-close,
- * etc.) should import from here rather than using string literals. Renames
+ * Every other module (label-taxonomy, single-story-close.js,
+ * stories-wave-tick.js, etc.) should import from here rather than using string literals. Renames
  * land in one place.
  */
 
@@ -10,12 +10,12 @@ export const AGENT_LABELS = {
   REVIEW_SPEC: 'agent::review-spec',
   READY: 'agent::ready',
   EXECUTING: 'agent::executing',
-  // Story #2144 — intermediate state owned by `story-close.js`. A Story
+  // Story #2144 — intermediate state owned by `single-story-close.js`. A Story
   // flips to `agent::closing` after preflight validation succeeds and
-  // before the merge into `epic/<id>` is attempted. It flips to
-  // `agent::done` only after the post-merge pipeline confirms the merge
+  // the Story PR is opened against `main`. It flips to
+  // `agent::done` only after the close pipeline confirms the PR merge
   // landed; if the close is killed mid-flight, the Story remains at
-  // `agent::closing` so a `/story-execute --resume` can pick up at the
+  // `agent::closing` so `/deliver` can pick up at the
   // post-merge phase rather than re-running preflight. The label is the
   // distinguishing signal between "hung close" and "finished work".
   CLOSING: 'agent::closing',
@@ -75,7 +75,6 @@ export function isValidTransition(fromState, toState) {
 }
 
 export const TYPE_LABELS = {
-  EPIC: 'type::epic',
   STORY: 'type::story',
 };
 
@@ -83,14 +82,6 @@ export const STATUS_LABELS = {
   BLOCKED: 'status::blocked',
 };
 
-/**
- * Persona labels are derived at bootstrap time from `.agents/personas/*.md`
- * (see `label-taxonomy.js`), not hard-coded here — the persona file is the
- * source of truth, and ticket hydration resolves the label value to the
- * matching filename.
- */
-export const PERSONA_LABEL_PREFIX = 'persona::';
-
 /**
  * Acceptance-axis labels for opt-out signalling on Epics that
  * intentionally have no acceptance-table coverage. (Story #4324 retired
@@ -122,13 +113,10 @@ export const META_LABELS = {
 
 /**
  * Planning-axis labels (Epic #2880 F7). Currently scoped to the
- * `planning::healthcheck-waived` operator-applied waiver, which is the
- * documented escape hatch for the inline post-plan readiness
- * healthcheck (`runPlanHealthcheck`). The persist surface
- * (`plan-persist.js`) refuses to flip an Epic to `agent::ready`
- * when the healthcheck returned `ok: false` unless this label is
- * present — see `.agents/docs/SDLC.md` § "`agent::ready` exit conditions"
- * for the full handoff contract.
+ * `planning::healthcheck-waived` operator-applied waiver — a historical
+ * escape hatch for the retired post-plan readiness healthcheck. The
+ * label remains in the taxonomy for tickets that still carry it; the
+ * healthcheck CLI itself was deleted in the v2 epic-scripts sweep.
  *
  * Future planning-axis waivers (one per failing exit condition) extend
  * this enum so consumers can reference them by symbol.
@@ -147,27 +135,11 @@ export const PLANNING_LABELS = {
  */
 export const PLANNING_HEALTHCHECK_WAIVED = 'planning::healthcheck-waived';
 
-/**
- * Delivery-routing labels (Epic #4474 PR4 — design §2 mode matrix).
- * `delivery::single` marks an Epic whose plan was persisted in the
- * spec-only single-delivery mode: no Story tree exists and the Delivery
- * Slicing table of the Epic body's Tech Spec is the audit trail.
- * `plan-persist.js` applies it when the risk verdict declares
- * `deliveryShape: "single"`; a fan-out re-persist over the same Epic
- * removes it. The marker is **inert until #4475** lands the deliver-side
- * reader — nothing in the deliver path consumes it yet.
- */
-export const DELIVERY_LABELS = {
-  SINGLE: 'delivery::single',
-};
-
 /** Palette for the taxonomy; consumed by label-taxonomy.js. */
 export const LABEL_COLORS = {
   TYPE: '#7057FF',
   AGENT: '#0E8A16',
   STATUS_BLOCKED: '#D93F0B',
-  PERSONA: '#C5DEF5',
   ACCEPTANCE: '#FBCA04',
   PLANNING: '#FEF2C0',
-  DELIVERY: '#BFD4F2',
 };

package/.agents/scripts/lib/label-taxonomy.js

@@ -4,59 +4,29 @@
  *
  * All label names are sourced from `label-constants.js` so renames only need
  * to happen in one place. Colors come from `LABEL_COLORS` in the same module.
+ *
+ * v2 deleted the behavioral persona concept (`.agents/personas/` +
+ * `persona::*` labels). Role framing for spawns lives in `.agents/agents/`
+ * via `delivery.routing.roleScopedAgents`; QA auth identities live in
+ * `qa.personas` — neither is a GitHub label axis.
  */
 
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
 import {
   ACCEPTANCE_LABELS,
   AGENT_LABELS,
-  DELIVERY_LABELS,
   LABEL_COLORS,
-  PERSONA_LABEL_PREFIX,
   PLANNING_LABELS,
   STATUS_LABELS,
   TYPE_LABELS,
 } from './label-constants.js';
 
-const PERSONAS_DIR = path.resolve(
-  path.dirname(fileURLToPath(import.meta.url)),
-  '..',
-  '..',
-  'personas',
-);
-
-/**
- * Discover persona labels from `.agents/personas/*.md`. The filename
- * (without extension) is the label suffix — this is the same value the
- * context hydrator uses to resolve `persona::<name>` to its markdown file.
- */
-function buildPersonaLabels() {
-  return fs
-    .readdirSync(PERSONAS_DIR)
-    .filter((f) => f.endsWith('.md'))
-    .map((f) => f.slice(0, -3))
-    .sort()
-    .map((name) => ({
-      name: `${PERSONA_LABEL_PREFIX}${name}`,
-      color: LABEL_COLORS.PERSONA,
-      description: `${name} persona`,
-    }));
-}
-
 /** @type {Array<{ name: string, color: string, description: string }>} */
 export const LABEL_TAXONOMY = [
   // Type
-  {
-    name: TYPE_LABELS.EPIC,
-    color: LABEL_COLORS.TYPE,
-    description: 'Epic-level work item',
-  },
   {
     name: TYPE_LABELS.STORY,
     color: LABEL_COLORS.TYPE,
-    description: 'User story under an Epic',
+    description: 'Story work item',
   },
 
   // Agent State
@@ -80,7 +50,7 @@ export const LABEL_TAXONOMY = [
   {
     name: AGENT_LABELS.CLOSING,
     color: LABEL_COLORS.AGENT,
-    description: 'Close preflight passed; awaiting merge into the Epic branch',
+    description: 'Close preflight passed; awaiting merge into the base branch',
   },
   {
     name: AGENT_LABELS.DONE,
@@ -95,9 +65,6 @@ export const LABEL_TAXONOMY = [
     description: 'Blocked by a dependency',
   },
 
-  // Persona — dynamically derived from .agents/personas/*.md
-  ...buildPersonaLabels(),
-
   // Acceptance axis — explicit opt-out signal for Epics that
   // intentionally have no acceptance-table coverage (waives the Epic
   // body's ## Acceptance Table section — Story #4324).
@@ -108,25 +75,13 @@ export const LABEL_TAXONOMY = [
   },
 
   // Planning axis — operator-applied waivers for the planning → delivery
-  // handoff gates. Currently the sole entry is the `healthcheck-waived`
-  // override consumed by `plan-persist.js` when the inline healthcheck
-  // (`runPlanHealthcheck`) returned `ok: false` for a reason the
-  // operator has triaged and accepted.
+  // handoff gates. `healthcheck-waived` remains for tickets that still
+  // carry the historical label; the healthcheck CLI was retired.
   {
     name: PLANNING_LABELS.HEALTHCHECK_WAIVED,
     color: LABEL_COLORS.PLANNING,
     description:
-      'Operator override — allows agent::ready handoff despite a failing post-plan healthcheck',
-  },
-
-  // Delivery routing — applied by `plan-persist.js` when the risk verdict
-  // declares `deliveryShape: "single"` (Epic #4474 PR4). Inert until #4475
-  // lands the deliver-side reader.
-  {
-    name: DELIVERY_LABELS.SINGLE,
-    color: LABEL_COLORS.DELIVERY,
-    description:
-      'Single-delivery plan — no Story tree; the Delivery Slicing table is the audit trail (#4474/#4475)',
+      'Historical operator override for the retired post-plan healthcheck',
   },
 ];
 

package/.agents/scripts/lib/observability/active-story-env.js

@@ -2,14 +2,14 @@
  * Active-Story env-var propagation (Epic #1030 Story #1043 / Task #1061).
  *
  * The PreToolUse / PostToolUse trace hook in
- * `lib/observability/tool-trace-hook.js` resolves the active Epic +
- * Story from `process.env.CC_EPIC_ID` and `process.env.CC_STORY_ID`.
- * This module is the single writer/clearer of those vars:
- *
- *   - `setActiveStoryEnv({ epicId, storyId, workCwd })` is called from
- *     `story-init.js` after the worktree is materialised. It sets the
- *     vars on the current `process.env` (so any child commands the
- *     orchestrator spawns inherit them) and exports them to a sibling
+ * `lib/observability/tool-trace-hook.js` resolves the active Story from
+ * `process.env.CC_STORY_ID`. This module is the single writer/clearer of
+ * that var:
+ *
+ *   - `setActiveStoryEnv({ storyId, workCwd })` is called from
+ *     `single-story-init.js` after the worktree is materialised. It sets the
+ *     var on the current `process.env` (so any child commands the
+ *     orchestrator spawns inherit it) and exports it to a sibling
  *     `.env.local` inside the worktree. The harness re-spawns the
  *     agent with that file's contents loaded, so the trace hook fires
  *     with the right ids on the *next* tool call after init returns.
@@ -37,96 +37,76 @@ const ENV_LOCAL_BASENAME = '.env.local';
 /**
  * Names of the env vars we own. Keeping the list central makes the
  * round-trip (set on init, clear on close) trivially auditable —
- * grep `CC_EPIC_ID` / `CC_STORY_ID` / `CC_SLICE_ID` to find every read site.
- *
- * Epic #4476 (M5) added `CC_SLICE_ID` (the single-delivery analogue of
- * `CC_STORY_ID` — set on the ONE long guarded session so the PostToolUse
- * hook can emit `slice.heartbeat` off the token stream) and `CC_OPERATOR`
- * (the resolved lease-owner handle, stamped onto hook-emitted heartbeats so
- * `latestHeartbeatForOwner` keeps resolving a live claim). The clear path
- * wipes all four so no stale context leaks past close.
+ * grep `CC_STORY_ID` / `CC_EPIC_ID` to find every read site.
+ *
+ * `CC_STORY_ID` is the one var this module writes. `CC_EPIC_ID` is retained
+ * on the CLEAR path only: v2 has no Epics and nothing here sets it, but
+ * `tool-trace-hook.js`'s `resolveActiveStory` still reads it, so wiping it at
+ * close keeps the trace path's "no stale context past close" contract honest
+ * against a value that leaked in from outside (a pre-upgrade `.env.local` the
+ * harness already loaded, or an operator's shell).
+ *
+ * `CC_SLICE_ID` / `CC_OPERATOR` were removed with the heartbeat substrate:
+ * their only writer was the never-called `setActiveSliceEnv` and their only
+ * reader the deleted `hook-heartbeat.js`.
  */
-export const ACTIVE_STORY_ENV_KEYS = [
-  'CC_EPIC_ID',
-  'CC_STORY_ID',
-  'CC_SLICE_ID',
-  'CC_OPERATOR',
-];
+export const ACTIVE_STORY_ENV_KEYS = ['CC_EPIC_ID', 'CC_STORY_ID'];
 
 /**
  * Render the `.env.local` body. One `KEY=value` line per var, LF
  * line endings (the harness's dotenv parser tolerates CRLF too but LF
  * keeps the file deterministic across Windows / macOS / Linux).
  *
- * Story #2874 — when `epicId === null` (standalone Story, no parent
- * Epic), the `CC_EPIC_ID=` line is omitted entirely. The trace
- * hook's no-op contract reads "var absent from env" as the signal,
- * so emitting an empty `CC_EPIC_ID=` line would set the var to the
- * empty string and change the contract.
+ * Only `CC_STORY_ID` is emitted: v2 Stories are standalone, so there is no
+ * parent Epic to key. The trace hook's no-op contract reads "var absent from
+ * env" as the signal, so no `CC_EPIC_ID=` line is written at all — an empty
+ * one would set the var to the empty string and change the contract.
  *
  * Exported for testing.
  *
- * @param {{ epicId: number|null, storyId: number }} input
+ * @param {{ storyId: number }} input
  * @returns {string}
  */
-export function renderActiveStoryEnvFile({ epicId, storyId }) {
-  const lines = [
+export function renderActiveStoryEnvFile({ storyId }) {
+  return [
     '# Auto-managed by .agents/scripts/lib/observability/active-story-env.js',
     '# Re-generated on every story-init; deleted on story-close.',
-  ];
-  if (epicId !== null) lines.push(`CC_EPIC_ID=${epicId}`);
-  lines.push(`CC_STORY_ID=${storyId}`, '');
-  return lines.join('\n');
+    `CC_STORY_ID=${storyId}`,
+    '',
+  ].join('\n');
 }
 
 /**
- * Set `CC_EPIC_ID` / `CC_STORY_ID` on the current process and (when
- * `workCwd` is provided) export them to `<workCwd>/.env.local`.
+ * Set `CC_STORY_ID` on the current process and (when `workCwd` is provided)
+ * export it to `<workCwd>/.env.local`.
  *
- * Idempotent: re-running with the same ids is a no-op on disk; with
- * different ids the `.env.local` is overwritten.
+ * Idempotent: re-running with the same id is a no-op on disk; with a
+ * different id the `.env.local` is overwritten.
  *
- * Story #2874 — `epicId: null` is the standalone-Story sentinel.
- * When passed:
- *   - `CC_EPIC_ID` is removed from `env` (the var MUST NOT be set
- *     to an empty string — the trace hook's `resolveActiveStory`
- *     no-op contract is keyed on the var's absence).
- *   - The rendered `.env.local` omits the `CC_EPIC_ID=` line.
- *   - `CC_STORY_ID` behaviour is unchanged.
- * All other invalid `epicId` values (`0`, negative, NaN, non-integer)
- * still throw — `null` is the only standalone signal.
+ * v2 Stories are standalone — there is no parent Epic — so `CC_EPIC_ID` is
+ * never set, and any pre-existing value is removed: the trace hook's
+ * `resolveActiveStory` no-op contract is keyed on the var's absence, and a
+ * stale epic id would key this Story's traces to a foreign Epic directory.
  *
- * @param {{ epicId: number|null, storyId: number, workCwd?: string,
+ * @param {{ storyId: number, workCwd?: string,
  *           env?: NodeJS.ProcessEnv, fs?: typeof nodeFs,
  *           logger?: { warn?: (m: string) => void } }} args
  * @returns {{ envSet: boolean, fileWritten: boolean, filePath: string|null }}
  */
 export function setActiveStoryEnv({
-  epicId,
   storyId,
   workCwd,
   env = process.env,
   fs = nodeFs,
   logger,
 } = {}) {
-  if (epicId !== null && (!Number.isInteger(epicId) || epicId <= 0)) {
-    throw new Error(
-      `[active-story-env] epicId must be a positive integer or null; got ${epicId}`,
-    );
-  }
   if (!Number.isInteger(storyId) || storyId <= 0) {
     throw new Error(
       `[active-story-env] storyId must be a positive integer; got ${storyId}`,
     );
   }
 
-  if (epicId === null) {
-    // Standalone Story — ensure CC_EPIC_ID is absent so the trace
-    // hook's no-op contract sees "no epic" rather than "epic=''".
-    if ('CC_EPIC_ID' in env) delete env.CC_EPIC_ID;
-  } else {
-    env.CC_EPIC_ID = String(epicId);
-  }
+  if ('CC_EPIC_ID' in env) delete env.CC_EPIC_ID;
   env.CC_STORY_ID = String(storyId);
 
   let fileWritten = false;
@@ -134,13 +114,9 @@ export function setActiveStoryEnv({
   if (typeof workCwd === 'string' && workCwd.length > 0) {
     filePath = nodePath.join(workCwd, ENV_LOCAL_BASENAME);
     try {
-      fs.writeFileSync(
-        filePath,
-        renderActiveStoryEnvFile({ epicId, storyId }),
-        {
-          encoding: 'utf8',
-        },
-      );
+      fs.writeFileSync(filePath, renderActiveStoryEnvFile({ storyId }), {
+        encoding: 'utf8',
+      });
       fileWritten = true;
     } catch (err) {
       logger?.warn?.(
@@ -192,100 +168,3 @@ export function clearActiveStoryEnv({
   }
   return { envCleared: true, fileRemoved, filePath };
 }
-
-/**
- * Render the single-delivery `.env.local` body. The single-delivery executor
- * (`deliver-epic-single.md`) walks the Delivery Slicing table inside ONE long
- * session; there is no Story fan-out and thus no `CC_STORY_ID`. Instead the
- * "current slice" is exported as `CC_SLICE_ID` so the PostToolUse hook emits
- * `slice.heartbeat` — the watchdog's forward-progress signal for the single
- * session — as a free byproduct of tool activity.
- *
- * `CC_STORY_ID` MUST be absent (its presence would make the hook emit
- * `story.heartbeat` and the trace path key off a non-existent Story). The
- * optional `operator` handle is emitted as `CC_OPERATOR` only when supplied.
- *
- * Exported for testing.
- *
- * @param {{ epicId: number, sliceId: string, operator?: string }} input
- * @returns {string}
- */
-export function renderActiveSliceEnvFile({ epicId, sliceId, operator }) {
-  const lines = [
-    '# Auto-managed by .agents/scripts/lib/observability/active-story-env.js',
-    '# Re-generated on every slice-start; deleted on epic-close.',
-    `CC_EPIC_ID=${epicId}`,
-    `CC_SLICE_ID=${sliceId}`,
-  ];
-  if (typeof operator === 'string' && operator.length > 0) {
-    lines.push(`CC_OPERATOR=${operator}`);
-  }
-  lines.push('');
-  return lines.join('\n');
-}
-
-/**
- * Set `CC_EPIC_ID` / `CC_SLICE_ID` (+ optional `CC_OPERATOR`) on the current
- * process and, when `workCwd` is provided, export them to
- * `<workCwd>/.env.local` for the harness to reload on the next tool call. The
- * single-delivery analogue of {@link setActiveStoryEnv}; called at each
- * `slice.start` boundary so the hook's throttled `slice.heartbeat` is keyed to
- * the slice currently being implemented.
- *
- * `CC_STORY_ID` is explicitly removed so a prior Story context (if any ever
- * leaked in) cannot make the hook emit the wrong heartbeat shape.
- *
- * @param {{ epicId: number, sliceId: string, operator?: string|null,
- *           workCwd?: string, env?: NodeJS.ProcessEnv, fs?: typeof nodeFs,
- *           logger?: { warn?: (m: string) => void } }} args
- * @returns {{ envSet: boolean, fileWritten: boolean, filePath: string|null }}
- */
-export function setActiveSliceEnv({
-  epicId,
-  sliceId,
-  operator,
-  workCwd,
-  env = process.env,
-  fs = nodeFs,
-  logger,
-} = {}) {
-  if (!Number.isInteger(epicId) || epicId <= 0) {
-    throw new Error(
-      `[active-story-env] epicId must be a positive integer; got ${epicId}`,
-    );
-  }
-  if (typeof sliceId !== 'string' || sliceId.length === 0) {
-    throw new Error(
-      `[active-story-env] sliceId must be a non-empty string; got ${sliceId}`,
-    );
-  }
-  const normOperator =
-    typeof operator === 'string' && operator.length > 0 ? operator : undefined;
-
-  if ('CC_STORY_ID' in env) delete env.CC_STORY_ID;
-  env.CC_EPIC_ID = String(epicId);
-  env.CC_SLICE_ID = sliceId;
-  if (normOperator) env.CC_OPERATOR = normOperator;
-  else if ('CC_OPERATOR' in env) delete env.CC_OPERATOR;
-
-  let fileWritten = false;
-  let filePath = null;
-  if (typeof workCwd === 'string' && workCwd.length > 0) {
-    filePath = nodePath.join(workCwd, ENV_LOCAL_BASENAME);
-    try {
-      fs.writeFileSync(
-        filePath,
-        renderActiveSliceEnvFile({ epicId, sliceId, operator: normOperator }),
-        { encoding: 'utf8' },
-      );
-      fileWritten = true;
-    } catch (err) {
-      logger?.warn?.(
-        `[active-story-env] Failed to write ${filePath}: ${
-          err instanceof Error ? err.message : String(err)
-        }`,
-      );
-    }
-  }
-  return { envSet: true, fileWritten, filePath };
-}