@event4u/agent-config 16.4.0 → 17.0.0

package/dist/cli-delegate/{chunk-KR6EM23A.js → chunk-TULVDQ4L.js}

@@ -1,4 +1,7 @@
 import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+import {
+  sanitize_entry
+} from "./chunk-7NXCZSDL.js";
 import {
   LexicalIndex,
   loadSqliteSync,
@@ -7,9 +10,6 @@ import {
   stampUserVersion,
   tokenize
 } from "./chunk-ZBZV2G5R.js";
-import {
-  _classify
-} from "./chunk-JQOM7TTM.js";
 import {
   require_dist
 } from "./chunk-OY53J6II.js";
@@ -25,51 +25,6 @@ import process5 from "node:process";
 import { fileURLToPath as fileURLToPath4, pathToFileURL as pathToFileURL3 } from "node:url";
 import { createRequire } from "node:module";
 
-// src/scripts/_lib/retrieval_sanitize.ts
-var MAX_FIELD_CHARS = 8192;
-var _INVISIBLE_FILLERS = /* @__PURE__ */ new Set([
-  12644,
-  // HANGUL FILLER
-  4447,
-  // HANGUL CHOSEONG FILLER
-  4448
-  // HANGUL JUNGSEONG FILLER
-]);
-function _isStrippableControl(cp) {
-  if (cp === 9 || cp === 10) return false;
-  if (cp <= 31) return true;
-  if (cp === 127) return true;
-  if (cp >= 128 && cp <= 159) return true;
-  return false;
-}
-function sanitize_text(s) {
-  let out = "";
-  for (const ch of s) {
-    const cp = ch.codePointAt(0);
-    if (cp === void 0) continue;
-    if (_classify(cp) !== null) continue;
-    if (_isStrippableControl(cp)) continue;
-    if (_INVISIBLE_FILLERS.has(cp)) continue;
-    out += ch;
-  }
-  return out.length > MAX_FIELD_CHARS ? out.slice(0, MAX_FIELD_CHARS) : out;
-}
-function sanitize_entry(entry) {
-  const out = {};
-  for (const [k, v] of Object.entries(entry)) {
-    out[k] = _sanitize_value(v);
-  }
-  return out;
-}
-function _sanitize_value(v) {
-  if (typeof v === "string") return sanitize_text(v);
-  if (Array.isArray(v)) return v.map((x) => typeof x === "string" ? sanitize_text(x) : _sanitize_value(x));
-  if (v && typeof v === "object" && v.constructor === Object) {
-    return sanitize_entry(v);
-  }
-  return v;
-}
-
 // src/scripts/_lib/memory_fts_index.ts
 import * as fs3 from "node:fs";
 import * as path3 from "node:path";

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

@@ -0,0 +1,20 @@
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+
+// src/scripts/_lib/consumer_impact.ts
+var CONSUMER_IMPACT_VALUES = ["none", "automatic", "notice", "action"];
+var NO_IMPACT_TRAILERS = Object.freeze({
+  impact: "none",
+  recorded: false,
+  invalid: null,
+  security: false
+});
+var IMPACT_RANK = Object.freeze({
+  none: 0,
+  automatic: 1,
+  notice: 2,
+  action: 3
+});
+
+export {
+  CONSUMER_IMPACT_VALUES
+};

package/dist/cli-delegate/{chunk-7XGD2OEU.js → chunk-UXWHY6CQ.js}

@@ -50,11 +50,12 @@ function evaluateDashboardState(inp) {
 }
 function evaluateDashboardOnDisk(opts) {
   const present = fs.existsSync(opts.target);
+  const norm = opts.normalize ?? ((t) => t);
   return evaluateDashboardState({
     mode: opts.mode,
     present,
     trackedInGit: opts.mode === "untracked" && isTrackedInGit(opts.target, opts.repo_root),
-    current: present && fs.readFileSync(opts.target, { encoding: "utf-8" }) === opts.rendered,
+    current: present && norm(fs.readFileSync(opts.target, { encoding: "utf-8" })) === norm(opts.rendered),
     rel: opts.rel,
     ...opts.regen === void 0 ? {} : { regen: opts.regen },
     ...opts.noun === void 0 ? {} : { noun: opts.noun }

package/dist/cli-delegate/{chunk-PWX7CKMD.js → chunk-VC3ECUEK.js}

@@ -2,7 +2,7 @@ import { createRequire as __acCreateRequire } from 'node:module'; const require
 import {
   DEFAULT_PROJECT_FILE,
   logger
-} from "./chunk-H76PHZBI.js";
+} from "./chunk-XLY5G3CM.js";
 import {
   artefact_roots
 } from "./chunk-YCU3TIXH.js";

package/dist/cli-delegate/{chunk-KXXWJTDO.js → chunk-WMNYVIYX.js}

@@ -2,7 +2,7 @@ import { createRequire as __acCreateRequire } from 'node:module'; const require
 import {
   blocker_class,
   collect
-} from "./chunk-PHD7OOLE.js";
+} from "./chunk-MQ2UDEGV.js";
 import {
   GATE_BUDGET_LEDGER_REL,
   appendGateBudgetReceipt,

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

@@ -0,0 +1,181 @@
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+import {
+  git_common_dir
+} from "./chunk-IAYTIIQW.js";
+import {
+  write_atomic
+} from "./chunk-MWRD5YOH.js";
+import {
+  event4u_root
+} from "./chunk-T6BP34WI.js";
+
+// src/scripts/_lib/session_register.ts
+import fs from "node:fs";
+import path from "node:path";
+var REGISTER_DIRNAME = "agent-sessions";
+var TTL_MEASURED_SECONDS = Object.freeze({
+  claude: 14400
+  // 4 h — raw p99 13 705 s / raw user→user max 14 199 s, rounded up
+});
+var TTL_DEFAULT_SECONDS = 43200;
+function ttl_seconds_for(platform) {
+  const key = String(platform ?? "").trim().toLowerCase();
+  return TTL_MEASURED_SECONDS[key] ?? TTL_DEFAULT_SECONDS;
+}
+function ttl_is_measured(platform) {
+  const key = String(platform ?? "").trim().toLowerCase();
+  return Object.prototype.hasOwnProperty.call(TTL_MEASURED_SECONDS, key);
+}
+var DEREGISTER_ON_STOP_PLATFORMS = /* @__PURE__ */ new Set(["cline"]);
+function stop_means_session_end(platform) {
+  return DEREGISTER_ON_STOP_PLATFORMS.has(String(platform ?? "").trim().toLowerCase());
+}
+var HEARTBEAT_REACHABLE_PLATFORMS = /* @__PURE__ */ new Set([
+  "claude",
+  "augment",
+  // post-reply `stop` only — sufficient for a liveness stamp
+  "cline",
+  // pre-reply `user_prompt_submit` only
+  "windsurf",
+  "gemini"
+]);
+function safe_stem(session_id) {
+  const collapsed = String(session_id ?? "").replace(/\.\./g, "_").replace(/[/\\]/g, "_").replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 128);
+  return /[A-Za-z0-9]/.test(collapsed) ? collapsed : "unknown-session";
+}
+function register_dir(workspace_root) {
+  const common = git_common_dir(workspace_root);
+  return common === null ? null : path.join(common, REGISTER_DIRNAME);
+}
+function global_register_dir(env) {
+  return path.join(event4u_root(env), "runtime", "sessions");
+}
+function iso_now(now = /* @__PURE__ */ new Date()) {
+  return now.toISOString().replace(/\.\d{3}Z$/, "+00:00");
+}
+function epoch_ms(stamp) {
+  if (typeof stamp !== "string" || stamp.length === 0) return null;
+  const ms = Date.parse(stamp);
+  return Number.isFinite(ms) ? ms : null;
+}
+function is_expired(rec, now = /* @__PURE__ */ new Date()) {
+  const seen = epoch_ms(rec.last_seen);
+  if (seen === null) return true;
+  const age_s = (now.getTime() - seen) / 1e3;
+  return age_s > ttl_seconds_for(rec.platform);
+}
+function is_record(v) {
+  if (typeof v !== "object" || v === null) return false;
+  const o = v;
+  return typeof o["session_id"] === "string" && typeof o["last_seen"] === "string";
+}
+function write_record(dir, rec) {
+  try {
+    const target = path.join(dir, `${safe_stem(rec.session_id)}.json`);
+    write_atomic(target, `${JSON.stringify(rec, null, 2)}
+`);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function read_own_record(dir, session_id) {
+  try {
+    const target = path.join(dir, `${safe_stem(session_id)}.json`);
+    const parsed = JSON.parse(fs.readFileSync(target, "utf-8"));
+    return is_record(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function delete_record(dir, session_id) {
+  try {
+    fs.unlinkSync(path.join(dir, `${safe_stem(session_id)}.json`));
+    return true;
+  } catch {
+    return false;
+  }
+}
+var PRUNE_GRACE_MS = 24 * 60 * 60 * 1e3;
+function read_live_records(dir, options = {}) {
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const prune = options.prune === true;
+  const grace = options.prune_grace_ms ?? PRUNE_GRACE_MS;
+  let names;
+  try {
+    names = fs.readdirSync(dir).filter((n) => n.endsWith(".json"));
+  } catch {
+    return [];
+  }
+  const live = [];
+  for (const name of names) {
+    const full = path.join(dir, name);
+    let rec = null;
+    try {
+      const parsed = JSON.parse(fs.readFileSync(full, "utf-8"));
+      rec = is_record(parsed) ? parsed : null;
+    } catch {
+      rec = null;
+    }
+    if (rec === null || is_expired(rec, now)) {
+      if (prune && (rec === null || is_expired(rec, new Date(now.getTime() - grace)))) {
+        try {
+          fs.unlinkSync(full);
+        } catch {
+        }
+      }
+      continue;
+    }
+    live.push(rec);
+  }
+  return live;
+}
+function foreign_live_records(dir, session_id, options = {}) {
+  const own = safe_stem(session_id);
+  return read_live_records(dir, options).filter((r) => safe_stem(r.session_id) !== own);
+}
+function any_live_session(dir, session_id, now = /* @__PURE__ */ new Date()) {
+  const records = session_id === void 0 || session_id === null ? read_live_records(dir, { now }) : foreign_live_records(dir, session_id, { now });
+  return records.length > 0;
+}
+function classify_collisions(others, here) {
+  const out = [];
+  for (const r of others) {
+    if (here.roadmap_slug !== null && r.roadmap_slug !== null && r.roadmap_slug === here.roadmap_slug) {
+      out.push({ kind: "roadmap", record: r });
+    }
+  }
+  for (const r of others) {
+    if (here.branch !== null && r.branch === here.branch) {
+      out.push({ kind: "branch", record: r });
+    }
+  }
+  const mine = new Set(here.owned_paths ?? []);
+  if (mine.size > 0) {
+    for (const r of others) {
+      const shared = (r.owned_paths ?? []).filter((p) => mine.has(p)).sort();
+      if (shared.length > 0) {
+        out.push({ kind: "path", record: r, paths: shared });
+      }
+    }
+  }
+  return out;
+}
+
+export {
+  ttl_seconds_for,
+  ttl_is_measured,
+  stop_means_session_end,
+  HEARTBEAT_REACHABLE_PLATFORMS,
+  safe_stem,
+  register_dir,
+  global_register_dir,
+  iso_now,
+  write_record,
+  read_own_record,
+  delete_record,
+  read_live_records,
+  foreign_live_records,
+  any_live_session,
+  classify_collisions
+};

package/dist/cli-delegate/{chunk-H76PHZBI.js → chunk-XLY5G3CM.js}

@@ -15,12 +15,6 @@ var SETTINGS_CARVE_OUT = [
     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",
@@ -69,6 +63,7 @@ import * as os from "node:os";
 import * as path from "node:path";
 
 // src/scripts/_lib/settings_renamed_keys.ts
+var SETTINGS_REMOVAL_RULE = "A settings key may be removed or renamed in a minor release only when no consumer project can rely on it \u2014 default-neutral and derivable, proven by a named test; any other removal or rename ships only in a major, and a renamed key's alias is dropped only in a major.";
 var RENAMED_KEYS = /* @__PURE__ */ new Map([
   ["planning.challenge_on_create", "planning.closure_pass"]
 ]);
@@ -99,7 +94,7 @@ function applyRenamedKeys(layer) {
     if (_warned.has(oldKey)) continue;
     _warned.add(oldKey);
     process.stderr.write(
-      `\u26A0\uFE0F  settings: \`${oldKey}\` was renamed to \`${newKey}\`. The old key still works for one minor; rename it in your .agent-settings.yml.
+      `\u26A0\uFE0F  settings: \`${oldKey}\` was renamed to \`${newKey}\`; the old key still works. ${SETTINGS_REMOVAL_RULE} Rename it in your .agent-settings.yml.
 `
     );
   }
@@ -175,7 +170,11 @@ var REMOVED_KEYS = /* @__PURE__ */ new Map([
   ["pipelines.skill_improvement", "the skill-improvement-trigger rule; the capture is a proposal the user confirms"],
   ["consistency.cross_source", "the cross-source-consistency rule, always on; batching and the no-cheap-questions floor bound the noise"],
   ["subagents.downshift", "the model_tier each sub-task declares; downshift is always on"],
-  ["ai_team.suppress_setup_hint", "nothing: the one-line team-mode setup hint is always shown"]
+  ["ai_team.suppress_setup_hint", "nothing: the one-line team-mode setup hint is always shown"],
+  // 2026-10-20 — the projection keys (ADR-293, road-to-a-setup-that-decides-itself Phase 4)
+  ["lean_projection.mode", "the computed layer-form decision (_lib/layer_form_decision.ts), plus `install --full` and src/config/layer-form-brakes.json as the two brakes. For one release window an installer converts a leftover `eager-all` into the install receipt pin and drops any other value, saying which (_lib/projection_key_migration.ts); the project tree reads the package-owned src/config/project-tree-form.json, never this key"],
+  ["lean_projection.hosts", "THINNABLE_HOSTS in _lib/lean_projection_mode.ts and the per-host row in src/config/host-injection-effect.json; no reader of this key remains"],
+  ["projection.rule_workspaces", "consumerRuleWorkspaces() in _lib/scoped_projection.ts, which derives the consumer workspace set from src/config/discovery/packs.yml \u2014 every id minus `agent-config-maintainer` \u2014 so a new pack reaches consumers without a settings edit"]
 ]);
 var _warnedRemovedKeys = /* @__PURE__ */ new Set();
 function _readDotted(root, dotted) {
@@ -312,17 +311,12 @@ var MERGEABLE_KEYS = [
   // GUI; whitelisting decides only whether the value SURVIVES the merge
   // (ADR-271, road-to-design-intent-conformance 2.3).
   "design.fidelity_mode",
-  // `lean_projection.*` is a per-MACHINE setting and the install it governs is
-  // a user-scope one: the layer being thinned is `~/.claude/rules`, which
-  // belongs to the machine and not to any checkout. Without these two rows a
-  // consumer who wrote the opt-in into the user-global file got no error, no
-  // warning and no effect — the same silent-filter defect the two entries
-  // above repair, reaching a third key, and unsatisfiable-by-construction on
-  // an ADR-020 global-only install, where no project layer exists to carry it.
-  // Whitelisting decides only whether a value SURVIVES the merge: it sets
-  // nothing, and `installerThinsHost` still refuses a template-only value.
-  "lean_projection.mode",
-  "lean_projection.hosts"
+  // `retro.enabled` is the one switch over the automatic retro (ADR-292). It
+  // ships `true`, so the only value worth writing is `false`, and a user who
+  // writes it once in the user-global file expects every checkout without its
+  // own value to honour it — without this row the off switch would be
+  // discarded silently. A project value still wins.
+  "retro.enabled"
 ];
 var TEMPLATE_RELATIVE = path.join("src", "config", "agent-settings.template.yml");
 var _PACKAGE_ROOT = resolvePackageRoot(import.meta.url);
@@ -832,6 +826,7 @@ export {
   ROOT_OVERRIDE_ENV,
   ProjectRootError,
   resolve_project_root,
+  _resolve_cascade_paths,
   settings_layer_states,
   load_agent_settings,
   iter_setting_overrides

package/dist/cli-delegate/cmd_adr_effective.js

@@ -791,7 +791,25 @@ function trigger_state(fm, asOfDate) {
   if (DATED_TRIGGER_PROBE.test(t)) return "dated-unparsed";
   return "indeterminate";
 }
+function first_sentence(text) {
+  const trimmed = text.trim();
+  const m = /^[\s\S]*?[.!?](?=\s|$)/u.exec(trimmed);
+  return (m === null ? trimmed : m[0]).trim();
+}
+function successor_id(file, fm) {
+  const base = path3.basename(file);
+  const m = /^(ADR-(?:[A-Za-z]+-)?\d+)/u.exec(base);
+  if (m !== null) return m[1];
+  const n = fm["adr"];
+  return n !== void 0 && n !== "" ? `ADR-${n.padStart(3, "0")}` : base;
+}
 function verdict_for(r) {
+  const base = _verdict_base(r);
+  if (!r.resolved || r.scoped_successors.length === 0) return base;
+  const names = r.scoped_successors.map((x) => x.adr).join(", ");
+  return `${base} PARTLY SUPERSEDED IN SCOPE by ${names} \u2014 one clause of this record has been replaced in scope and the rest stands. Read the scope line before citing the clause it names.`;
+}
+function _verdict_base(r) {
   if (!r.resolved) return "UNRESOLVED \u2014 no ADR file carries this number on a scanned surface.";
   const status = (r.status ?? "").toLowerCase();
   if (status === "superseded" || status === "deprecated") {
@@ -833,7 +851,8 @@ function cite_check(refs, repo_root = REPO_ROOT2) {
         resolved: false,
         trigger_state: "none",
         amendment_blocks: [],
-        referenced_by: []
+        referenced_by: [],
+        scoped_successors: []
       };
       return { ...empty, verdict: verdict_for(empty) };
     }
@@ -847,7 +866,8 @@ function cite_check(refs, repo_root = REPO_ROOT2) {
         resolved: false,
         trigger_state: "none",
         amendment_blocks: [],
-        referenced_by: []
+        referenced_by: [],
+        scoped_successors: []
       };
       return { ...empty, verdict: verdict_for(empty) };
     }
@@ -867,6 +887,20 @@ function cite_check(refs, repo_root = REPO_ROOT2) {
     const body = bodyStart === -1 ? text : text.slice(bodyStart + 5);
     const cited = area === null ? new RegExp(`ADR-0*${num}\\b`, "i") : new RegExp(`ADR-${area}-0*${Number(num)}\\b`, "i");
     const referenced_by = files.filter((f) => f !== match && cited.test(contents.get(f) ?? "")).map((f) => path3.relative(repo_root, f));
+    const scoped_successors = files.filter((f) => f !== match).flatMap((f) => {
+      const otherFm = parse_frontmatter(contents.get(f) ?? "") ?? {};
+      const declared = otherFm["supersedes"];
+      if (declared === void 0 || declared === "" || declared === "\u2014") return [];
+      if (!cited.test(declared)) return [];
+      const scopeRaw = otherFm["supersedes_scope"];
+      return [
+        {
+          adr: successor_id(f, otherFm),
+          file: path3.relative(repo_root, f),
+          scope: scopeRaw === void 0 || scopeRaw.trim() === "" ? "\u2014 (successor declares no `supersedes_scope`; read the successor in full)" : first_sentence(scopeRaw)
+        }
+      ];
+    }).sort((a, b) => a.adr.localeCompare(b.adr));
     const partial = {
       ref: id,
       resolved: true,
@@ -882,6 +916,7 @@ function cite_check(refs, repo_root = REPO_ROOT2) {
       ...fm["amended_by"] !== void 0 ? { amended_by: fm["amended_by"] } : {},
       amendment_blocks: amendment_blocks(body),
       referenced_by,
+      scoped_successors,
       ...provenance?.kind !== void 0 && provenance.kind !== null ? { provenance_kind: provenance.kind } : {},
       ...provenance?.agenticMode !== void 0 && provenance.agenticMode !== null ? { provenance_agentic_mode: provenance.agenticMode } : {},
       ...evidence?.strength !== void 0 && evidence.strength !== null ? { evidence_strength: evidence.strength } : {},
@@ -921,6 +956,10 @@ ${r.ref}${r.file !== void 0 ? `  \xB7  ${r.file}` : ""}`);
       lines.push(`  amendments       ${String(r.amendment_blocks.length)}: ${r.amendment_blocks.join(" \xB7 ")}`);
     if (r.referenced_by.length > 0)
       lines.push(`  referenced by    ${String(r.referenced_by.length)} other ADR(s): ${r.referenced_by.join(", ")}`);
+    for (const sc of r.scoped_successors) {
+      lines.push(`  superseded in scope by   ${sc.adr}  \xB7  ${sc.file}`);
+      lines.push(`    scope          ${sc.scope}`);
+    }
     const provenanceLine = r.provenance_kind ?? "\u2014 (no provenance axis)";
     const mode = r.provenance_agentic_mode !== void 0 ? `  \xB7  mode ${r.provenance_agentic_mode}` : "";
     lines.push(`  provenance       ${provenanceLine}${mode}`);

package/dist/cli-delegate/cmd_analyze_session.js

@@ -1,19 +1,19 @@
 #!/usr/bin/env tsx
 import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
-import {
-  atomic_write_json
-} from "./chunk-7HKRE54K.js";
-import {
-  readHookStdin
-} from "./chunk-F7DQWYR5.js";
 import {
   StateLoadError,
   load_state
 } from "./chunk-GME3Q44L.js";
+import {
+  atomic_write_json
+} from "./chunk-7HKRE54K.js";
 import {
   ProjectRootError,
   resolve_project_root
-} from "./chunk-H76PHZBI.js";
+} from "./chunk-XLY5G3CM.js";
+import {
+  readHookStdin
+} from "./chunk-RAXQOETZ.js";
 import "./chunk-T6BP34WI.js";
 import "./chunk-MCJYCQPF.js";
 import "./chunk-J55WI3RR.js";