@event4u/agent-config 14.21.0 → 14.23.0

package/dist/cli-delegate/roadmap_set_step.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env tsx
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+import {
+  isCliEntry
+} from "./chunk-5EK5WQN6.js";
+import "./chunk-JO25G5H7.js";
+
+// src/agent-src/scripts/roadmap_set_step.ts
+import * as fs from "node:fs";
+import * as path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+var _HERE = fileURLToPath(import.meta.url);
+var GLYPHS = ["x", " ", "~", "-"];
+var LOCK_STALE_MS = 6e4;
+var RoadmapWriteError = class extends Error {
+};
+function scanSteps(content) {
+  const out = [];
+  const lines = content.split("\n");
+  for (let i = 0; i < lines.length; i += 1) {
+    const m = /^(\s*-\s\[)([ x~-])(\]\s?)(.*)$/.exec(lines[i]);
+    if (m !== null) out.push({ line: i, glyph: m[2], text: m[4] });
+  }
+  return out;
+}
+function findStep(content, stepId) {
+  const needle = stepId.trim();
+  if (needle === "") throw new RoadmapWriteError("step id is empty");
+  const strip = (t) => t.replace(/^\*\*/, "");
+  const hits = scanSteps(content).filter(
+    (s) => s.text.startsWith(needle) || strip(s.text).startsWith(strip(needle))
+  );
+  if (hits.length === 0) {
+    throw new RoadmapWriteError(`no step whose text starts with "${needle}"`);
+  }
+  if (hits.length > 1) {
+    throw new RoadmapWriteError(
+      `"${needle}" matches ${String(hits.length)} steps (lines ${hits.map((h) => h.line + 1).join(", ")}) \u2014 refusing rather than picking the first. Give a longer prefix.`
+    );
+  }
+  return hits[0];
+}
+function setGlyphOnLine(content, lineIndex, glyph) {
+  const lines = content.split("\n");
+  const line = lines[lineIndex];
+  if (line === void 0) throw new RoadmapWriteError(`line ${String(lineIndex)} is out of range`);
+  const m = /^(\s*-\s\[)([ x~-])(\].*)$/.exec(line);
+  if (m === null) throw new RoadmapWriteError(`line ${String(lineIndex + 1)} is not a checkbox line`);
+  lines[lineIndex] = `${m[1]}${glyph}${m[3]}`;
+  return lines.join("\n");
+}
+function acquireLock(file, nowMs = Date.now()) {
+  const lock = `${file}.lock`;
+  try {
+    fs.writeFileSync(lock, `${String(process.pid)}
+`, { flag: "wx" });
+    return lock;
+  } catch {
+    let age = 0;
+    try {
+      age = nowMs - fs.statSync(lock).mtimeMs;
+    } catch {
+      fs.writeFileSync(lock, `${String(process.pid)}
+`, { flag: "wx" });
+      return lock;
+    }
+    if (age > LOCK_STALE_MS) {
+      fs.rmSync(lock, { force: true });
+      fs.writeFileSync(lock, `${String(process.pid)}
+`, { flag: "wx" });
+      return lock;
+    }
+    throw new RoadmapWriteError(
+      `${path.basename(file)} is locked by another writer (${String(Math.round(age / 1e3))}s old) \u2014 refusing`
+    );
+  }
+}
+function setStep(file, stepId, glyph, nowMs = Date.now()) {
+  const lock = acquireLock(file, nowMs);
+  try {
+    const before = fs.readFileSync(file, "utf8");
+    const stepsBefore = scanSteps(before).length;
+    const target = findStep(before, stepId);
+    const after = setGlyphOnLine(before, target.line, glyph);
+    const stepsAfter = scanSteps(after).length;
+    if (stepsAfter !== stepsBefore) {
+      throw new RoadmapWriteError(
+        `structural invariant failed: ${String(stepsBefore)} step(s) before, ${String(stepsAfter)} after. A glyph flip may not change the step count \u2014 this is the signature of a pattern that spanned entries.`
+      );
+    }
+    const tmp = `${file}.${String(process.pid)}.tmp`;
+    fs.writeFileSync(tmp, after, "utf8");
+    fs.renameSync(tmp, file);
+    const verify = fs.readFileSync(file, "utf8");
+    const survivors = scanSteps(verify).filter(
+      (s) => s.line === target.line && s.glyph === glyph && s.text === target.text
+    );
+    if (survivors.length !== 1) {
+      throw new RoadmapWriteError(
+        `write did not survive: expected exactly 1 occurrence of the mutated step, found ${String(survivors.length)}. A parallel writer very likely landed after ours.`
+      );
+    }
+    return { file, line: target.line + 1, from: target.glyph, to: glyph, stepsBefore, stepsAfter };
+  } finally {
+    fs.rmSync(lock, { force: true });
+  }
+}
+function resolvePlan(roots) {
+  const found = [];
+  for (const root of roots) {
+    const dir = path.join(root, "agents", "roadmaps");
+    if (!fs.existsSync(dir)) continue;
+    for (const name of fs.readdirSync(dir)) {
+      if (name.endsWith(".md") && name !== "README.md") found.push(path.join(dir, name));
+    }
+  }
+  if (found.length === 0) throw new RoadmapWriteError("no active roadmap found under any candidate root");
+  if (found.length > 1) {
+    throw new RoadmapWriteError(
+      `ambiguous plan \u2014 ${String(found.length)} active roadmaps in scope:
+  ${found.join("\n  ")}
+Refusing to choose. Name the file explicitly with --file.`
+    );
+  }
+  return found[0];
+}
+function main(argv = process.argv.slice(2)) {
+  const usage = "usage: roadmap_set_step --file <roadmap.md> --step <id-prefix> --glyph <x| |~|->\n  Refuses on: an ambiguous step prefix, a changed step count, a write that did not survive.\n";
+  if (argv.includes("-h") || argv.includes("--help")) {
+    process.stdout.write(usage);
+    return 0;
+  }
+  const val = (flag) => {
+    const i = argv.indexOf(flag);
+    return i !== -1 && i + 1 < argv.length ? argv[i + 1] : null;
+  };
+  const file = val("--file");
+  const step = val("--step");
+  const glyph = val("--glyph");
+  if (file === null || step === null || glyph === null || !GLYPHS.includes(glyph)) {
+    process.stderr.write(`roadmap_set_step: error: --file, --step and a valid --glyph are required
+${usage}`);
+    return 2;
+  }
+  try {
+    const r = setStep(path.resolve(file), step, glyph);
+    process.stdout.write(
+      `\u2705  ${path.basename(r.file)}:${String(r.line)} [${r.from}] \u2192 [${r.to}] \xB7 ${String(r.stepsAfter)} step(s) intact
+`
+    );
+    return 0;
+  } catch (e) {
+    process.stderr.write(`\u274C  ${e instanceof Error ? e.message : String(e)}
+`);
+    return e instanceof RoadmapWriteError ? 1 : 2;
+  }
+}
+if (isCliEntry(import.meta.url, "roadmap_set_step")) {
+  process.exit(main());
+}
+export {
+  GLYPHS,
+  LOCK_STALE_MS,
+  RoadmapWriteError,
+  acquireLock,
+  findStep,
+  main,
+  resolvePlan,
+  scanSteps,
+  setGlyphOnLine,
+  setStep
+};

package/dist/cli-delegate/stub_queue.js

@@ -0,0 +1,47 @@
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+import "./chunk-JO25G5H7.js";
+
+// src/agent-src/scripts/stub_queue.ts
+import * as fs from "node:fs";
+import * as path from "node:path";
+var FRONTMATTER_RE = /^---\n([\s\S]*?)\n---[ \t\n\r\f\v]*\n/;
+var OWNER_ROUTING = [
+  "owner-reserved",
+  "owner reserved",
+  "owner: maintainer",
+  "reserved to the owner",
+  "requires owner",
+  "maintainer decision",
+  "owner decision",
+  "owner sign-off",
+  "awaiting the owner"
+];
+function stub_queue_counts(roadmap_root, today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)) {
+  const dir = path.join(roadmap_root, "stubs");
+  let names;
+  try {
+    names = fs.readdirSync(dir).filter((n) => n.endsWith(".md") && n !== "README.md");
+  } catch {
+    return null;
+  }
+  if (names.length === 0) return null;
+  let overdue = 0;
+  let owner = 0;
+  for (const n of names) {
+    let source;
+    try {
+      source = fs.readFileSync(path.join(dir, n), "utf-8");
+    } catch {
+      continue;
+    }
+    const fm = FRONTMATTER_RE.exec(source);
+    const due = /^review_by:\s*(\d{4}-\d{2}-\d{2})\s*$/m.exec(fm?.[1] ?? "");
+    if (due === null || due[1] <= today) overdue += 1;
+    const lower = source.toLowerCase();
+    if (OWNER_ROUTING.some((phrase) => lower.includes(phrase))) owner += 1;
+  }
+  return { overdue, owner };
+}
+export {
+  stub_queue_counts
+};

package/dist/cli-delegate/stubs_due.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+import {
+  BLOCKED_QUICKWIN_FIELDS,
+  CADENCE_DAYS,
+  CHANGELOG_ERAS,
+  QUICKWIN_BLOCKER_CLASSES,
+  count_owner_decisions,
+  counts,
+  due_date,
+  headerFragment,
+  is_blocked_quickwin,
+  main,
+  release_dates,
+  releases_since,
+  repo_root,
+  scan,
+  scan_dir
+} from "./chunk-ULET4BYS.js";
+import "./chunk-5EK5WQN6.js";
+import "./chunk-JO25G5H7.js";
+export {
+  BLOCKED_QUICKWIN_FIELDS,
+  CADENCE_DAYS,
+  CHANGELOG_ERAS,
+  QUICKWIN_BLOCKER_CLASSES,
+  count_owner_decisions,
+  counts,
+  due_date,
+  headerFragment,
+  is_blocked_quickwin,
+  main,
+  release_dates,
+  releases_since,
+  repo_root,
+  scan,
+  scan_dir
+};

package/dist/cli-delegate/ticket_bundles.js

@@ -0,0 +1,59 @@
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+import "./chunk-JO25G5H7.js";
+
+// src/agent-src/scripts/ticket_bundles.ts
+import { createRequire } from "node:module";
+import * as fs from "node:fs";
+import * as path from "node:path";
+var _require = createRequire(import.meta.url);
+function _isDir(p) {
+  try {
+    return fs.statSync(p).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function collect_bundles(repo_root) {
+  const reg = path.join(repo_root, "agents", "tickets", "_registry.yml");
+  if (!fs.existsSync(reg)) {
+    return [];
+  }
+  let YAML;
+  try {
+    YAML = _require("yaml");
+  } catch {
+    return [];
+  }
+  let data;
+  try {
+    data = YAML.parse(fs.readFileSync(reg, { encoding: "utf-8" }), { version: "1.1" }) ?? {};
+  } catch {
+    return [];
+  }
+  const out = [];
+  const bundles = data && typeof data === "object" && !Array.isArray(data) ? data["bundles"] ?? null : null;
+  const bundleMap = bundles && typeof bundles === "object" && !Array.isArray(bundles) ? bundles : {};
+  for (const slug of Object.keys(bundleMap).sort()) {
+    const metaRaw = bundleMap[slug];
+    const meta = metaRaw && typeof metaRaw === "object" && !Array.isArray(metaRaw) ? metaRaw : {};
+    const bdir = path.join(repo_root, "agents", "tickets", slug);
+    let n = 0;
+    if (_isDir(bdir)) {
+      try {
+        n = fs.readdirSync(bdir).filter((f) => f.startsWith("T-") && f.endsWith(".md")).length;
+      } catch {
+        n = 0;
+      }
+    }
+    out.push({
+      slug,
+      tickets: n,
+      status: meta["status"] ?? "?",
+      roadmap: meta["source_roadmap"] ?? ""
+    });
+  }
+  return out;
+}
+export {
+  collect_bundles
+};

package/dist/cli-delegate/update_roadmap_progress.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env tsx
+import { createRequire as __acCreateRequire } from 'node:module'; const require = globalThis.require ?? __acCreateRequire(import.meta.url);
+import {
+  CHECKBOX_RE,
+  FRONTMATTER_RE,
+  PHASE_RE,
+  PhaseStats,
+  RoadmapStats,
+  TITLE_RE,
+  _pyRound,
+  bar,
+  blocker_class,
+  blocker_is_resolved,
+  blocker_needs_user,
+  collect,
+  collect_bundles,
+  count_checkboxes,
+  is_roadmap_candidate,
+  is_unscheduled,
+  main,
+  merge_gated_pending,
+  parse_blockers,
+  parse_frontmatter,
+  parse_roadmap,
+  pending_iron_law_3,
+  render,
+  unarchived_complete
+} from "./chunk-QAJS5YWY.js";
+import "./chunk-ULET4BYS.js";
+import "./chunk-5EK5WQN6.js";
+import "./chunk-YWVXLR44.js";
+import "./chunk-7XGD2OEU.js";
+import "./chunk-YDQSHTD7.js";
+import "./chunk-JO25G5H7.js";
+export {
+  CHECKBOX_RE,
+  FRONTMATTER_RE,
+  PHASE_RE,
+  PhaseStats,
+  RoadmapStats,
+  TITLE_RE,
+  _pyRound,
+  bar,
+  blocker_class,
+  blocker_is_resolved,
+  blocker_needs_user,
+  collect,
+  collect_bundles,
+  count_checkboxes,
+  is_roadmap_candidate,
+  is_unscheduled,
+  main,
+  merge_gated_pending,
+  parse_blockers,
+  parse_frontmatter,
+  parse_roadmap,
+  pending_iron_law_3,
+  render,
+  unarchived_complete
+};

package/dist/discovery/deprecation-report.md

@@ -1,6 +1,6 @@
 # Discovery — Deprecation Report
 
-- Generated: `2026-09-07T14:13:52Z`
+- Generated: `2026-09-09T13:37:07Z`
 - Deprecated artefacts: **0**
 
 _None. Tree is clean._

package/dist/discovery/discovery-manifest.json

@@ -361,7 +361,7 @@
     },
     {
       "category": "command",
-      "checksum": "sha256:1d1332f264559b672056ffff251598bd7ea9115d237d8932e65d457616925dad",
+      "checksum": "sha256:e1965998bd3055f5848a07b09168167219f80beffb3adaca8552f446f71a39a6",
       "install": {
         "default": true,
         "removable": false
@@ -486,7 +486,7 @@
     },
     {
       "category": "command",
-      "checksum": "sha256:2047dbc3f325b811312ecdc170a0215e24327149eb8d94cb1653e34b9d76b2a6",
+      "checksum": "sha256:43a65c016638da0d799e876bde537378e056e206c68dcf72ba2c8416f27f8718",
       "install": {
         "default": true,
         "removable": false
@@ -2422,12 +2422,12 @@
     },
     {
       "category": "command",
-      "checksum": "sha256:74b20b35447065553ac5e40a22e0fda92e9191d3cd74350cae8895a4fac35337",
+      "checksum": "sha256:21332b2ed898e38da738030ec3add5f2be4f7672ee72e531205dfdaef3d6a26b",
       "install": {
         "default": true,
         "removable": false
       },
-      "intent": "Prepare an open PR to mergeable — sync the base in, resolve conflicts semantically, drive required checks green — merging itself is gated and inert",
+      "intent": "Prepare an open PR to mergeable — sync the base in, resolve conflicts semantically, drive required checks green — then merge what the invocation named",
       "lifecycle": "active",
       "name": "git-pr-merge",
       "pack": "git",
@@ -5113,7 +5113,7 @@
     },
     {
       "category": "command",
-      "checksum": "sha256:e8de5246b3d5b6631a7ad24e2bea091fe490e0552edacace5c3ac080e9271c12",
+      "checksum": "sha256:5a10124143c2baa3fb481461ce0225f7eaece711ff688811ad66763654fee531",
       "install": {
         "default": true,
         "removable": false
@@ -6361,7 +6361,7 @@
     },
     {
       "category": "rule",
-      "checksum": "sha256:3861cd884113414d968a6de79c4f2391da668ff469f17266340e10abe4425815",
+      "checksum": "sha256:c879c0699998f3ebf50d08ec1199b2f78c70e74201af3bdbbb28dc293746758c",
       "install": {
         "default": true,
         "removable": false
@@ -7123,7 +7123,7 @@
     },
     {
       "category": "rule",
-      "checksum": "sha256:e89979656ebfee82c9ef2e929e663992c75d3c3115cdd46f209e9f4a426bc99d",
+      "checksum": "sha256:185fe198df456bd7e3b0ed79e2665a29ea0352df338a20e98214c6d88825b4c2",
       "install": {
         "default": true,
         "removable": false
@@ -7998,7 +7998,7 @@
     },
     {
       "category": "rule",
-      "checksum": "sha256:dd70f0ea2b5afbc29f8f22039336e91db123cc54d1bbed5c11a8fad260140498",
+      "checksum": "sha256:8e1a0c0f7fccaa87dc91e496561e80e2d9dac9eed54251b66c86b53f5c866fae",
       "install": {
         "default": true,
         "removable": false
@@ -8987,7 +8987,7 @@
     },
     {
       "category": "skill",
-      "checksum": "sha256:92818fb17a955560ee92ef421b18b8dd76552c51037e09fcd17b81e676c88334",
+      "checksum": "sha256:90de0462c11d94c41340447e32e4d5d004d540f3d6d9c02ded4634782d481753",
       "install": {
         "default": true,
         "removable": false
@@ -13415,7 +13415,7 @@
     },
     {
       "category": "skill",
-      "checksum": "sha256:360a42db776044fa1c4b73d2baaa9b7eee73803af9eea4ce1dc79b953452ebd0",
+      "checksum": "sha256:b7ece37dfb4884630b616914fa0d72449156973383bdd92c9b03e5dc96b52e91",
       "install": {
         "default": true,
         "removable": false
@@ -14141,7 +14141,7 @@
     },
     {
       "category": "skill",
-      "checksum": "sha256:6ebc9ffda0b1fd23d47c7606afd1595bbcf1a2cc653a1c83d235281c572c1522",
+      "checksum": "sha256:ca9de1086258a23f5bcc3cd626434545f493f736a67f93eb52621746c136fca6",
       "install": {
         "default": true,
         "removable": false
@@ -14818,7 +14818,7 @@
       "workspaces": []
     }
   ],
-  "checksum": "sha256:cf03b5ccd276ba03e81909bd96e990e377a6d0335b59cf003ffd22a8ea2ac2a2",
+  "checksum": "sha256:aa82784e196e180afe8767be33e034fe331d62b7f2f1a257eee5e67a7f61ee89",
   "deprecations": [
     {
       "key": "tier",
@@ -14967,7 +14967,7 @@
       "reason": "scaffold template for ticket-bundle tickets (ADR-101); carries no runtime frontmatter — emit-tickets fills it in per ticket"
     }
   ],
-  "generated_at": "2026-09-07T14:13:52Z",
+  "generated_at": "2026-09-09T13:37:07Z",
   "packs": [
     {
       "artefact_count": 128,

package/dist/discovery/discovery-manifest.json.sha256

@@ -1 +1 @@
-d39fa064d7fd108c014186a747f95fec8dd418e52a2120bb58cb19dd3c0593e0  discovery-manifest.json
+d129b3747c38a0ef013d82f0afa89a18a205d4fdb4294fd7b8b427b526d92c7d  discovery-manifest.json

package/dist/discovery/discovery-manifest.summary.md

@@ -1,6 +1,6 @@
 # Discovery Manifest — Summary
 
-- Generated: `2026-09-07T14:13:52Z`
+- Generated: `2026-09-09T13:37:07Z`
 - Scanner: `de0a22b4ac4c`
 - Artefacts: **625**
 - Unassigned: **0**

package/dist/discovery/dormancy-report.md

@@ -1,6 +1,6 @@
 # Discovery — Dormancy Report
 
-- Generated: `2026-09-07T14:13:52Z`
+- Generated: `2026-09-09T13:37:07Z`
 - Window: **6 months** without a commit
 
 > Dormancy triggers **review, never auto-deprecation**

package/dist/discovery/orphan-report.md

@@ -1,6 +1,6 @@
 # Discovery — Orphan Report
 
-- Generated: `2026-09-07T14:13:52Z`
+- Generated: `2026-09-09T13:37:07Z`
 - Orphan artefacts: **0**
 
 > An orphan is an artefact whose declared pack has no other members.

package/dist/discovery/packs.json

@@ -1,6 +1,6 @@
 {
-  "checksum": "sha256:cf03b5ccd276ba03e81909bd96e990e377a6d0335b59cf003ffd22a8ea2ac2a2",
-  "generated_at": "2026-09-07T14:13:52Z",
+  "checksum": "sha256:aa82784e196e180afe8767be33e034fe331d62b7f2f1a257eee5e67a7f61ee89",
+  "generated_at": "2026-09-09T13:37:07Z",
   "packs": [
     {
       "always_on": false,

package/dist/discovery/trust-report.md

@@ -1,6 +1,6 @@
 # Discovery — Trust Report
 
-- Generated: `2026-09-07T14:13:52Z`
+- Generated: `2026-09-09T13:37:07Z`
 - Workspaces tracked: **10**
 - Human-review-required artefacts: **3**
 

package/dist/discovery/workspaces.json

@@ -1,6 +1,6 @@
 {
-  "checksum": "sha256:cf03b5ccd276ba03e81909bd96e990e377a6d0335b59cf003ffd22a8ea2ac2a2",
-  "generated_at": "2026-09-07T14:13:52Z",
+  "checksum": "sha256:aa82784e196e180afe8767be33e034fe331d62b7f2f1a257eee5e67a7f61ee89",
+  "generated_at": "2026-09-09T13:37:07Z",
   "scanner_version": "de0a22b4ac4c",
   "workspaces": [
     {