@event4u/agent-config 9.29.0 → 9.31.0

package/dist/cli-delegate/chunk-EJITJBJX.js

@@ -0,0 +1,172 @@
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+
+// src/scripts/hooks/state_io.ts
+import fs from "node:fs";
+import path from "node:path";
+var LOCK_BASENAME = ".dispatcher.lock";
+var REPLAY_ENV_VAR = "AGENT_CONFIG_REPLAY";
+function is_replay_mode() {
+  return (process.env[REPLAY_ENV_VAR] ?? "").trim() === "1";
+}
+function _lock_path(state_dir) {
+  return path.join(state_dir, LOCK_BASENAME);
+}
+function _py_json_dumps(value, indent) {
+  const pad = " ".repeat(indent);
+  const escapeString = (s) => {
+    let out = '"';
+    for (const ch of s) {
+      const code = ch.codePointAt(0);
+      switch (ch) {
+        case '"':
+          out += '\\"';
+          break;
+        case "\\":
+          out += "\\\\";
+          break;
+        case "\n":
+          out += "\\n";
+          break;
+        case "\r":
+          out += "\\r";
+          break;
+        case "	":
+          out += "\\t";
+          break;
+        case "\b":
+          out += "\\b";
+          break;
+        case "\f":
+          out += "\\f";
+          break;
+        default:
+          if (code < 32 || code > 126) {
+            if (code > 65535) {
+              const c = code - 65536;
+              const hi = 55296 + (c >> 10);
+              const lo = 56320 + (c & 1023);
+              out += "\\u" + hi.toString(16).padStart(4, "0") + "\\u" + lo.toString(16).padStart(4, "0");
+            } else {
+              out += "\\u" + code.toString(16).padStart(4, "0");
+            }
+          } else {
+            out += ch;
+          }
+      }
+    }
+    return out + '"';
+  };
+  const render = (v, depth) => {
+    if (v === null || v === void 0) {
+      return "null";
+    }
+    if (typeof v === "boolean") {
+      return v ? "true" : "false";
+    }
+    if (typeof v === "number") {
+      if (!Number.isFinite(v)) {
+        if (Number.isNaN(v)) return "NaN";
+        return v > 0 ? "Infinity" : "-Infinity";
+      }
+      return String(v);
+    }
+    if (typeof v === "string") {
+      return escapeString(v);
+    }
+    const curPad = pad.repeat(depth + 1);
+    const closePad = pad.repeat(depth);
+    if (Array.isArray(v)) {
+      if (v.length === 0) {
+        return "[]";
+      }
+      const items = v.map((item) => curPad + render(item, depth + 1));
+      return "[\n" + items.join(",\n") + "\n" + closePad + "]";
+    }
+    if (typeof v === "object") {
+      const obj = v;
+      const keys = Object.keys(obj);
+      if (keys.length === 0) {
+        return "{}";
+      }
+      const items = keys.map(
+        (k) => curPad + escapeString(k) + ": " + render(obj[k], depth + 1)
+      );
+      return "{\n" + items.join(",\n") + "\n" + closePad + "}";
+    }
+    throw new TypeError(`Object of type ${typeof v} is not JSON serializable`);
+  };
+  return render(value, 0);
+}
+function atomic_write_json(target, payload, options = {}) {
+  if (is_replay_mode()) {
+    return;
+  }
+  const indent = options.indent ?? 2;
+  const targetPath = path.resolve(target);
+  const state_dir = path.dirname(targetPath);
+  fs.mkdirSync(state_dir, { recursive: true });
+  const body = _py_json_dumps(payload, indent) + "\n";
+  _atomic_write_text(targetPath, body);
+}
+function atomic_write_text(target, text) {
+  if (is_replay_mode()) {
+    return;
+  }
+  const targetPath = path.resolve(target);
+  const state_dir = path.dirname(targetPath);
+  fs.mkdirSync(state_dir, { recursive: true });
+  _atomic_write_text(targetPath, text);
+}
+function _acquire_lock(lock_path) {
+  const fd = fs.openSync(lock_path, "a", 420);
+  const held = lock_path + ".held";
+  const deadlineMs = 5e3;
+  const start = Date.now();
+  for (; ; ) {
+    try {
+      const heldFd = fs.openSync(held, "wx", 420);
+      fs.closeSync(heldFd);
+      return fd;
+    } catch (err) {
+      if (err.code !== "EEXIST") {
+        return fd;
+      }
+      if (Date.now() - start > deadlineMs) {
+        try {
+          fs.rmSync(held, { force: true });
+        } catch {
+        }
+        continue;
+      }
+      const sab = new Int32Array(new SharedArrayBuffer(4));
+      Atomics.wait(sab, 0, 0, 2);
+    }
+  }
+}
+function _release_lock(fd, lock_path) {
+  try {
+    fs.closeSync(fd);
+  } catch {
+  }
+  try {
+    fs.rmSync(lock_path + ".held", { force: true });
+  } catch {
+  }
+}
+function _atomic_write_text(target, text) {
+  const tmp = target + `.tmp.${process.pid}`;
+  const lock_path = _lock_path(path.dirname(target));
+  const fd = _acquire_lock(lock_path);
+  try {
+    fs.writeFileSync(tmp, text, { encoding: "utf-8" });
+    fs.renameSync(tmp, target);
+  } finally {
+    _release_lock(fd, lock_path);
+  }
+}
+
+export {
+  is_replay_mode,
+  atomic_write_json,
+  atomic_write_text
+};

package/dist/cli-delegate/{chunk-NZ5N2XQL.js → chunk-ITIQSGOQ.js}

@@ -2,10 +2,10 @@ import { createRequire as __acCreateRequire } from 'node:module'; const require
 import {
   ZodFirstPartyTypeKind,
   settingsSchema
-} from "./chunk-MMXA5GY7.js";
+} from "./chunk-UVKNIJH2.js";
 import {
   main
-} from "./chunk-MP3JT3IU.js";
+} from "./chunk-DS6BLDMG.js";
 import {
   RULE_SOURCE_REL
 } from "./chunk-BKO2AZ7Z.js";
@@ -48,7 +48,7 @@ import {
 import {
   find_project_root_with_anchor,
   load_agent_settings
-} from "./chunk-LCFJIQ4J.js";
+} from "./chunk-JEJABGKB.js";
 import {
   event4u_root,
   legacy_xdg_root,

package/dist/cli-delegate/{chunk-LCFJIQ4J.js → chunk-JEJABGKB.js}

@@ -4,11 +4,67 @@ import {
   write_target
 } from "./chunk-NDJLNC6Q.js";
 
+// src/shared/settingsCarveOut.ts
+var SETTINGS_CARVE_OUT = [
+  {
+    key: "projection.mode",
+    reader: "src/scripts/install.ts:3409 _resolve_scoped_projection",
+    absentResolvesTo: "legacy-all",
+    reason: "The template fallback applies only when NO global settings file exists. Once a file exists, an absent key means legacy-all by documented contract, so an existing install is never silently narrowed on upgrade."
+  },
+  {
+    key: "projection.rule_workspaces",
+    reader: "src/install/rule_scope.ts:96 ruleScopeFromSettings",
+    absentResolvesTo: "null \u2014 LEGACY_ALL, i.e. every rule ships including maintainer-only ones",
+    reason: "Same upgrade contract as projection.mode, and the failure is louder: an absent list widens the projection instead of narrowing it."
+  },
+  {
+    key: "discipline_profile",
+    reader: "work_engine/_lib/agent_settings.ts:1263",
+    absentResolvesTo: "essential, unconditionally",
+    reason: "The template ships `auto`, which resolves to `off` on any measured-null model, any non-Claude host, and any host exposing no model id. Absent skips that resolution entirely and loads the essential tier everywhere."
+  },
+  {
+    key: "chat_history.frequency",
+    reader: "src/scripts/chat_history.ts:1140",
+    absentResolvesTo: "per_phase",
+    reason: "Canonical substitution is `per_turn`. Absent gives coarser capture than the shipped default \u2014 an audit-thinning change, which the class contract's own test 8 (what can the attacker HIDE) names as the severe direction."
+  },
+  {
+    key: "profile.id",
+    reader: "src/scripts/config/profiles.ts:221 resolve_profile",
+    absentResolvesTo: "the id `developer`, but a DEGRADED profile \u2014 packs: [], personas: [], hints: []",
+    reason: "Exactly the projection.mode shape: the template default is honoured only when no settings file exists. With a file present the id resolves but its profile body does not load, so the install silently loses every pack and persona."
+  },
+  {
+    key: "quality.local_auto_run",
+    reader: "src/scripts/lint_roadmap_ci_steps.ts:106",
+    absentResolvesTo: "true \u2014 which DISABLES the CI-step gate",
+    reason: "Inverted polarity, and the most dangerous row in the set: the template ships `false`, which ARMS the gate. Omitting the key would disarm a quality gate for every fresh install while the reference page says it is on."
+  },
+  {
+    key: "onboarding.onboarded",
+    reader: "src/scripts/onboarding_gate_hook.ts:99",
+    absentResolvesTo: "gate skipped, as if onboarding had already completed",
+    reason: "Absent behaves like `onboarded: true`, not like the template default `false`. Omitting it would skip the onboarding gate on precisely the fresh installs the gate exists for."
+  },
+  {
+    key: "chat_history.enabled",
+    reader: "src/scripts/chat_history.ts:1025 _read_chat_history_enabled",
+    absentResolvesTo: "false",
+    reason: "The reader falls back to false while the template ships true. This one is privacy-shaped: fixing the reader would start recording history for every install whose file lacks the key. Writing it explicitly keeps the decision visible in the file the user can read."
+  }
+];
+function carveOutKeys() {
+  return SETTINGS_CARVE_OUT.map((c) => c.key);
+}
+
 // src/scripts/_lib/agent_settings.ts
 import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
+import { fileURLToPath } from "node:url";
 var _require = createRequire(import.meta.url);
 var Logger = class {
   name = "scripts._lib.agent_settings";
@@ -117,7 +173,45 @@ var MERGEABLE_KEYS = [
   "knowledge.global_sharing.freshness.hypothesis_after_days",
   "knowledge.global_sharing.freshness.stale_after_days"
 ];
-var _DEFAULTS = {};
+var TEMPLATE_RELATIVE = path.join("src", "config", "agent-settings.template.yml");
+var _PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
+function default_template_path() {
+  return path.join(_PACKAGE_ROOT, TEMPLATE_RELATIVE);
+}
+function _is_placeholder(value) {
+  return typeof value === "string" && /^__[A-Z0-9_]+__$/.test(value);
+}
+function _prune_template(tree, excluded, prefix = "") {
+  const out = {};
+  for (const [key, value] of Object.entries(tree)) {
+    const dotted = prefix === "" ? key : `${prefix}.${key}`;
+    if (excluded.has(dotted) || _is_placeholder(value)) {
+      continue;
+    }
+    if (_is_plain_dict(value)) {
+      const child = _prune_template(value, excluded, dotted);
+      if (Object.keys(child).length > 0) {
+        out[key] = child;
+      }
+      continue;
+    }
+    out[key] = value;
+  }
+  return out;
+}
+var _template_defaults_cache = null;
+function template_defaults(template_path) {
+  const use_cache = template_path === void 0;
+  if (use_cache && _template_defaults_cache !== null) {
+    return _deepcopy(_template_defaults_cache);
+  }
+  const parsed = _read_yaml(template_path ?? default_template_path()) ?? {};
+  const pruned = _prune_template(parsed, new Set(carveOutKeys()));
+  if (use_cache) {
+    _template_defaults_cache = pruned;
+  }
+  return _deepcopy(pruned);
+}
 var ANCHOR_AGENT_SETTINGS = "agent-settings";
 var ANCHOR_AGENTS_DIR = "agents-dir";
 var ANCHOR_GIT = "git";
@@ -386,6 +480,7 @@ function load_agent_settings(options = {}) {
   const user_global_path = options.user_global_path ?? null;
   const verbose = options.verbose ?? false;
   const cwd = options.cwd ?? null;
+  const template_path = options.template_path ?? null;
   const user_global_raw = {};
   for (const p of user_global_path ? [user_global_path] : user_global_settings_paths()) {
     _deep_merge(user_global_raw, _read_yaml(p) ?? {});
@@ -398,7 +493,7 @@ function load_agent_settings(options = {}) {
     );
   }
   const cascade = _resolve_cascade_paths(cwd, project_path);
-  const merged = _deep_copy_defaults(_DEFAULTS);
+  const merged = template_defaults(template_path ?? void 0);
   _deep_merge(merged, user_global_filtered);
   for (const p of cascade) {
     const layer = _read_yaml(p) ?? {};
@@ -555,16 +650,25 @@ function _deep_merge(dst, src) {
     }
   }
 }
-function _deep_copy_defaults(src) {
-  const out = {};
-  _deep_merge(out, src);
-  return out;
+function _deepcopy(value) {
+  if (Array.isArray(value)) {
+    return value.map((v) => _deepcopy(v));
+  }
+  if (_is_plain_dict(value)) {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[k] = _deepcopy(v);
+    }
+    return out;
+  }
+  return value;
 }
 function _is_plain_dict(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
 export {
+  SETTINGS_CARVE_OUT,
   logger,
   DEFAULT_PROJECT_FILE,
   LOCAL_PROJECT_FILE,

package/dist/cli-delegate/chunk-MMJL4TIX.js

@@ -0,0 +1,18 @@
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+
+// src/scripts/hooks/hook_stdin.ts
+import * as fs from "node:fs";
+var _override = null;
+function readHookStdin() {
+  if (_override !== null) return _override;
+  try {
+    if (process.stdin.isTTY) return "";
+    return fs.readFileSync(0, "utf-8");
+  } catch {
+    return "";
+  }
+}
+
+export {
+  readHookStdin
+};

package/dist/cli-delegate/{chunk-REKCMYOU.js → chunk-PFBV6XRT.js}

@@ -422,6 +422,11 @@ var binaryTag = defineScalarTag("tag:yaml.org,2002:binary", {
 });
 var YAML_DATE_REGEXP = /* @__PURE__ */ new RegExp("^([0-9][0-9][0-9][0-9])-([0-9][0-9])-([0-9][0-9])$");
 var YAML_TIMESTAMP_REGEXP = /* @__PURE__ */ new RegExp("^([0-9][0-9][0-9][0-9])-([0-9][0-9]?)-([0-9][0-9]?)(?:[Tt]|[ \\t]+)([0-9][0-9]?):([0-9][0-9]):([0-9][0-9])(?:\\.([0-9]*))?(?:[ \\t]*(Z|([-+])([0-9][0-9]?)(?::([0-9][0-9]))?))?$");
+function makeUtcDate(year, month, day, hour = 0, minute = 0, second = 0, fraction = 0) {
+  const date = new Date(Date.UTC(year, month, day, hour, minute, second, fraction));
+  date.setUTCFullYear(year, month, day);
+  return date;
+}
 function resolveYamlTimestamp(source) {
   let match = YAML_DATE_REGEXP.exec(source);
   if (match === null) match = YAML_TIMESTAMP_REGEXP.exec(source);
@@ -430,7 +435,7 @@ function resolveYamlTimestamp(source) {
   const month = +match[2] - 1;
   const day = +match[3];
   if (!match[4]) {
-    const date2 = new Date(Date.UTC(year, month, day));
+    const date2 = makeUtcDate(year, month, day);
     if (date2.getUTCFullYear() !== year || date2.getUTCMonth() !== month || date2.getUTCDate() !== day) return NOT_RESOLVED;
     return date2;
   }
@@ -444,7 +449,7 @@ function resolveYamlTimestamp(source) {
     while (value.length < 3) value += "0";
     fraction = +value;
   }
-  const date = new Date(Date.UTC(year, month, day, hour, minute, second, fraction));
+  const date = makeUtcDate(year, month, day, hour, minute, second, fraction);
   if (date.getUTCFullYear() !== year || date.getUTCMonth() !== month || date.getUTCDate() !== day) return NOT_RESOLVED;
   if (match[9]) {
     const offsetHour = +match[10];
@@ -542,7 +547,11 @@ var mapTag = defineMappingTag("tag:yaml.org,2002:map", {
     return Object.prototype.hasOwnProperty.call(container, String(key));
   },
   keys: (container) => Object.keys(container),
-  get: (container, key) => container[String(key)]
+  get: (container, key) => {
+    const normalizedKey = String(key);
+    if (!Object.prototype.hasOwnProperty.call(container, normalizedKey)) return null;
+    return container[normalizedKey];
+  }
 });
 var setTag = defineMappingTag("tag:yaml.org,2002:set", {
   create: () => /* @__PURE__ */ new Set(),
@@ -563,9 +572,9 @@ var setTag = defineMappingTag("tag:yaml.org,2002:set", {
 });
 function createTagDefinitionMap() {
   return {
-    scalar: {},
-    sequence: {},
-    mapping: {}
+    scalar: /* @__PURE__ */ Object.create(null),
+    sequence: /* @__PURE__ */ Object.create(null),
+    mapping: /* @__PURE__ */ Object.create(null)
   };
 }
 function createTagDefinitionListMap() {
@@ -735,7 +744,11 @@ var legacyMapTag = defineMappingTag("tag:yaml.org,2002:map", {
     return normalizedKey !== null && Object.prototype.hasOwnProperty.call(container, normalizedKey);
   },
   keys: (container) => Object.keys(container),
-  get: (container, key) => container[String(key)]
+  get: (container, key) => {
+    const normalizedKey = String(key);
+    if (!Object.prototype.hasOwnProperty.call(container, normalizedKey)) return null;
+    return container[normalizedKey];
+  }
 });
 var DEFAULT_SNIPPET_OPTIONS = {
   maxLength: 79,
@@ -1071,10 +1084,10 @@ function getScalarValue(input, scalar) {
       return getPlainValue(input, valueStart, valueEnd);
   }
 }
-var DEFAULT_TAG_HANDLERS = {
+var DEFAULT_TAG_HANDLERS = Object.assign(/* @__PURE__ */ Object.create(null), {
   "!": "!",
   "!!": "tag:yaml.org,2002:"
-};
+});
 function tagPercentEncode(source) {
   return encodeURI(source).replace(/!/g, "%21");
 }
@@ -1327,6 +1340,10 @@ function constructFromEvents(events, options) {
       }
       case 6: {
         const frame = state.frames.pop();
+        if (frame.kind === "mapping" && frame.hasKey) {
+          state.position = frame.keyPosition;
+          throwError$1(state, "incomplete mapping pair in event stream");
+        }
         if (frame.kind === "document") state.documents.push(frame.value);
         else {
           const value = frame.tag.carrierIsResult ? frame.value : finalizeCollection(state, frame.position, frame.tag, frame.value);
@@ -1997,10 +2014,6 @@ function parseNode(state, parentIndent, nodeContext, allowToSeek, allowCompact,
     else if (state.lineIndent === parentIndent) indentStatus = 0;
     else indentStatus = -1;
   }
-  if (state.position === state.lineStart && testDocumentSeparator(state)) {
-    state.depth--;
-    return false;
-  }
   if (indentStatus === 1) while (true) {
     const ch = state.input.charCodeAt(state.position);
     const propertyState = snapshotState(state);
@@ -2549,14 +2562,14 @@ function chooseScalarStyle(state, string, layout, singleLineOnly, forceQuote, in
       if (char === CHAR_LINE_FEED) {
         hasLineBreak = true;
         if (shouldTrackWidth) {
-          hasFoldableLine = hasFoldableLine || i - previousLineBreak - 1 > lineWidth && string[previousLineBreak + 1] !== " ";
+          hasFoldableLine = hasFoldableLine || i - previousLineBreak - 1 > lineWidth && !isMoreIndented(string[previousLineBreak + 1]);
           previousLineBreak = i;
         }
       } else if (!isPrintable(char)) return STYLE_DOUBLE;
       plain = plain && isPlainSafe(char, prevChar, inblock);
       prevChar = char;
     }
-    hasFoldableLine = hasFoldableLine || shouldTrackWidth && i - previousLineBreak - 1 > lineWidth && string[previousLineBreak + 1] !== " ";
+    hasFoldableLine = hasFoldableLine || shouldTrackWidth && i - previousLineBreak - 1 > lineWidth && !isMoreIndented(string[previousLineBreak + 1]);
   }
   if (!hasLineBreak && !hasFoldableLine) {
     if (plain && !forceQuote) return STYLE_PLAIN;
@@ -2621,27 +2634,30 @@ function encodeFlowBreaks(string, indent) {
 function dropEndingNewline(string) {
   return string[string.length - 1] === "\n" ? string.slice(0, -1) : string;
 }
+function isMoreIndented(char) {
+  return char === " " || char === "	";
+}
 function foldBlockScalar(string, width) {
   const lineRe = /(\n+)([^\n]*)/g;
   let nextLF = string.indexOf("\n");
   if (nextLF === -1) nextLF = string.length;
   lineRe.lastIndex = nextLF;
   let result = foldLine(string.slice(0, nextLF), width);
-  let prevMoreIndented = string[0] === "\n" || string[0] === " ";
+  let prevMoreIndented = string[0] === "\n" || isMoreIndented(string[0]);
   let moreIndented;
   let match;
   while (match = lineRe.exec(string)) {
     const prefix = match[1];
     const line = match[2];
-    moreIndented = line[0] === " ";
+    moreIndented = line !== "" && isMoreIndented(line[0]);
     result += prefix + (!prevMoreIndented && !moreIndented && line !== "" ? "\n" : "") + foldLine(line, width);
     prevMoreIndented = moreIndented;
   }
   return result;
 }
 function foldLine(line, width) {
-  if (line === "" || line[0] === " ") return line;
-  const breakRe = / [^ ]/g;
+  if (line === "" || isMoreIndented(line[0])) return line;
+  const breakRe = / [^ \t]/g;
   let match;
   let start = 0;
   let end;
@@ -2987,5 +3003,5 @@ export {
 /*! Bundled license information:
 
 js-yaml/dist/js-yaml.mjs:
-  (*! js-yaml 5.2.2 https://github.com/nodeca/js-yaml @license MIT *)
+  (*! js-yaml 5.2.3 https://github.com/nodeca/js-yaml @license MIT *)
 */

package/dist/cli-delegate/{chunk-OJM3MBJM.js → chunk-QEEB4LHO.js}

@@ -1,28 +1,16 @@
 import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+import {
+  readHookStdin
+} from "./chunk-MMJL4TIX.js";
 import {
   load_agent_settings
-} from "./chunk-LCFJIQ4J.js";
+} from "./chunk-JEJABGKB.js";
 
 // src/scripts/chat_history.ts
 import { createHash } from "node:crypto";
-import * as fs2 from "node:fs";
+import * as fs from "node:fs";
 import * as path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-
-// src/scripts/hooks/hook_stdin.ts
-import * as fs from "node:fs";
-var _override = null;
-function readHookStdin() {
-  if (_override !== null) return _override;
-  try {
-    if (process.stdin.isTTY) return "";
-    return fs.readFileSync(0, "utf-8");
-  } catch {
-    return "";
-  }
-}
-
-// src/scripts/chat_history.ts
 var DEFAULT_FILE = "agents/runtime/.agent-chat-history";
 var DEFAULT_SETTINGS_FILE = ".agent-settings.yml";
 var SCHEMA_VERSION = 4;
@@ -249,14 +237,14 @@ function derive_session_tag(session_id) {
 }
 function _isFile(p) {
   try {
-    return fs2.statSync(p).isFile();
+    return fs.statSync(p).isFile();
   } catch {
     return false;
   }
 }
 function _statSize(p) {
   try {
-    return fs2.statSync(p).size;
+    return fs.statSync(p).size;
   } catch {
     return -1;
   }
@@ -307,7 +295,7 @@ function _session_tag_enabled() {
   return (process.env.AGENT_CHAT_HISTORY_SESSION_TAG ?? "true").trim().toLowerCase() !== "false";
 }
 function _readLines(p) {
-  const raw = fs2.readFileSync(p, "utf-8");
+  const raw = fs.readFileSync(p, "utf-8");
   if (raw === "") {
     return [];
   }
@@ -353,7 +341,7 @@ function read_header(p) {
   }
   let first;
   try {
-    const raw = fs2.readFileSync(target, "utf-8");
+    const raw = fs.readFileSync(target, "utf-8");
     first = _strip(raw.split("\n", 1)[0] ?? "");
   } catch {
     return null;
@@ -383,8 +371,8 @@ function init(freq = "per_phase", options = {}) {
   if (_is_replay_mode()) {
     return header;
   }
-  fs2.mkdirSync(path.dirname(target), { recursive: true });
-  fs2.writeFileSync(target, _pyDumps(header) + "\n", { encoding: "utf-8" });
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  fs.writeFileSync(target, _pyDumps(header) + "\n", { encoding: "utf-8" });
   return header;
 }
 function migrate_header(p, options = {}) {
@@ -410,7 +398,7 @@ function migrate_header(p, options = {}) {
   if (typeof existing.started === "string") {
     new_header.started = existing.started;
   }
-  const raw = fs2.readFileSync(target, "utf-8");
+  const raw = fs.readFileSync(target, "utf-8");
   const lines = _pySplitlines(raw);
   if (lines.length === 0) {
     return null;
@@ -465,7 +453,7 @@ function append(entry, options = {}) {
   if (_is_replay_mode()) {
     return;
   }
-  fs2.appendFileSync(target, _pyDumps(entry) + "\n", { encoding: "utf-8" });
+  fs.appendFileSync(target, _pyDumps(entry) + "\n", { encoding: "utf-8" });
 }
 function _atomic_write_text(target, text) {
   if (_is_replay_mode()) {
@@ -475,11 +463,11 @@ function _atomic_write_text(target, text) {
   const uniq = `${process.pid}.${createHash("sha256").update(`${process.pid}:${Date.now()}:${Math.random()}`).digest("hex").slice(0, 8)}`;
   const tmp = target.slice(0, target.length - suffix.length) + `${suffix}.${uniq}.tmp`;
   try {
-    fs2.writeFileSync(tmp, text, { encoding: "utf-8" });
-    fs2.renameSync(tmp, target);
+    fs.writeFileSync(tmp, text, { encoding: "utf-8" });
+    fs.renameSync(tmp, target);
   } catch (exc) {
     try {
-      fs2.unlinkSync(tmp);
+      fs.unlinkSync(tmp);
     } catch {
     }
     throw exc;
@@ -509,7 +497,7 @@ function reset_with_entries(entries, freq = "per_phase", options = {}) {
   const target = options.path ?? file_path();
   const header = _build_header(freq);
   const body = _normalize_entries(entries);
-  fs2.mkdirSync(path.dirname(target), { recursive: true });
+  fs.mkdirSync(path.dirname(target), { recursive: true });
   const lines = [_pyDumps(header), ...body.map((e) => _pyDumps(e))];
   _atomic_write_text(target, lines.join("\n") + "\n");
   return header;
@@ -530,7 +518,7 @@ function prepend_entries(entries, options = {}) {
   return new_lines.length;
 }
 function _readLinesKeepNewline(p) {
-  const raw = fs2.readFileSync(p, "utf-8");
+  const raw = fs.readFileSync(p, "utf-8");
   if (raw === "") {
     return [];
   }
@@ -552,8 +540,8 @@ function clear(options = {}) {
     return;
   }
   const target = options.path ?? file_path();
-  if (fs2.existsSync(target)) {
-    fs2.unlinkSync(target);
+  if (fs.existsSync(target)) {
+    fs.unlinkSync(target);
   }
 }
 function read_entries(options = {}) {
@@ -2010,8 +1998,8 @@ function _isCliEntry() {
     return true;
   }
   try {
-    const here = fs2.realpathSync(fileURLToPath(import.meta.url));
-    const argv = fs2.realpathSync(path.resolve(process.argv[1]));
+    const here = fs.realpathSync(fileURLToPath(import.meta.url));
+    const argv = fs.realpathSync(path.resolve(process.argv[1]));
     return here === argv;
   } catch {
     return false;
@@ -2033,7 +2021,6 @@ if (_invokedDirectly) {
 }
 
 export {
-  readHookStdin,
   derive_session_tag,
   read_entries,
   list_sessions