@azure-id/orc 1.9.2 → 2.1.0

package/bin/webui/fixtures/index.js

@@ -25,11 +25,12 @@ const { wiki, wikiDocs, wikiShow, wikiCoverage, wikiCoverageFull, wikiUnregister
 const { runs, runDetail, runDetailClosed, aftermath } = require("./runs.js");
 const { stats, budgetForecast, budgetRates } = require("./stats.js");
 const { pact } = require("./pact.js");
+const B = require("./behaviour.js");
 const { boundary } = require("./boundary.js");
 const { usage, waitLanes, waitStatus } = require("./wait.js");
 const hookui = require("./hookui.js");
 const { handoff } = require("./handoff.js");
-const { exportState, mocks } = require("./maintenance.js");
+const { exportState, mocks, clearLogsSummary, clearLogsPreview, clearLogsPreviewEmpty } = require("./maintenance.js");
 const { chGoals, chDims, challengeRoles, challengeCouncil, challengeCycles, challengeList, challengeShow, challengeDiff, challengeDiffMissing, challengeLint } = require("./challenge.js");
 const { docList, docParts, docStatuses, docMapSections, docMap, docLint, docPlan, docShow, docSection, docShipped, docShippedDrifted, docNext, docAudit, docJournalRich, docJournalEmpty, docContext, docRules, docRulesFrozen, docForecast, docCost } = require("./docs.js");
 const { laneList, lanePhases, laneCalls } = require("./lanes.js");
@@ -279,7 +280,7 @@ module.exports.get = function get(route, q) {
     case "/api/budget/rates":
       return budgetRates;
     case "/api/budget/actual":
-      return { ok: true, run: "store-credit", lane: "orc", trace: "run-orc-store-credit-100826-093012.txt", rows: [{ band: "[40,55)", dispatches: 3, forecast_weighted: 96000, actual_weighted: 138000, diff_pct: 44, tokens: { input: 9000, cache_write: 61000, cache_read: 121000, output: 11000 } }, { band: "[70,80)", dispatches: 1, forecast_weighted: 121000, actual_weighted: 304000, diff_pct: 151, tokens: { input: 12000, cache_write: 98000, cache_read: 240000, output: 24000 } }], actual: { tokens: { input: 21000, cache_write: 159000, cache_read: 361000, output: 35000 }, raw: 576000, weighted: 251100, usd: 7.02 }, cache_read_share: 0.71, unattributed: { blocks: 12, tokens: { input: 900, cache_write: 12000, cache_read: 24000, output: 1100 } }, joined: 17, dispatches: 19 };
+      return { ok: true, run: "store-credit", lane: "orc", trace: "run-orc-store-credit-100826-093012.txt", rows: [{ band: "[31,41)", dispatches: 3, forecast_weighted: 96000, actual_weighted: 138000, diff_pct: 44, tokens: { input: 9000, cache_write: 61000, cache_read: 121000, output: 11000 } }, { band: "[41,90)", dispatches: 1, forecast_weighted: 121000, actual_weighted: 304000, diff_pct: 151, tokens: { input: 12000, cache_write: 98000, cache_read: 240000, output: 24000 } }], actual: { tokens: { input: 21000, cache_write: 159000, cache_read: 361000, output: 35000 }, raw: 576000, weighted: 251100, usd: 7.02 }, cache_read_share: 0.71, unattributed: { blocks: 12, tokens: { input: 900, cache_write: 12000, cache_read: 24000, output: 1100 } }, joined: 17, dispatches: 19 };
     case "/api/aftermath":
       return aftermath;
     case "/api/export":
@@ -339,6 +340,30 @@ module.exports.get = function get(route, q) {
       return gotchaPrunePreview;
     case "/api/stats":
       return stats;
+    // v2.0.0 W7 — the Behaviour panel. The `habits` mode is the one fixture
+    // with STATE: the learning switch posts `/api/config/set` (below), and
+    // the next read answers in that mode, so off · observe · propose are all
+    // reachable from the panel itself. The 30d window is the EMPTY answer
+    // (no ASK lines yet, and below the review floor) — a window with nothing
+    // in it is exactly where those two states happen on a real machine.
+    case "/api/habits":
+      if (HABITS_MODE.value === "off") return B.habitsOff;
+      if (q && q.window === "30d") return B.habitsEmpty;
+      return HABITS_MODE.value === "observe" ? B.habitsObserve : B.habitsPropose;
+    case "/api/habits/log":
+      return HABITS_MODE.value === "off" ? B.habitLogEmpty : B.habitLog;
+    case "/api/habits/states":
+      return B.habitStates;
+    case "/api/habits/points":
+      return B.habitPoints;
+    // A path under a scope some gotcha holds answers the card; anything else is
+    // the zero-match ANSWER, which is the CLI's exit 1 and "no card".
+    case "/api/gotcha/card":
+      return /src\/routes\/|tests\/|client\/src\/i18n\//.test(String((q && q.files) || "")) ? B.gotchaCard : B.gotchaCardNone;
+    case "/api/gotcha/quality":
+      return q && q.window === "30d" ? B.gotchaQualityLow : B.gotchaQuality;
+    case "/api/gotcha/candidates":
+      return B.gotchaCandidates;
     case "/api/diy":
       return diy;
     case "/api/crosslink":
@@ -439,10 +464,37 @@ module.exports.get = function get(route, q) {
           { id: "prune", label: "Update AND delete ORC-named orphans from a pre-manifest install", command: "orc update --prune", network: false, names_files: true },
           { id: "fix", label: "Apply every fix orc doctor found (= update + prune + settings re-merge)", command: "orc doctor --fix", network: false, names_files: false },
           { id: "upgrade", label: "Fetch the LATEST package from the network, then apply it", command: "orc upgrade", network: true, names_files: false },
+          { id: "export", label: "Recompile AGENTS.md from the wiki, patterns, PACT.md and boundary cards", command: "orc export", network: false, names_files: false },
+          {
+            id: "clear-logs",
+            label: "Delete finished traces and run folders older than log_retention_days (never user data, never a waiting run)",
+            command: "orc clear logs --apply",
+            network: false,
+            names_files: true,
+            danger: true,
+            restarts_ui: false,
+            status: clearLogsSummary,
+          },
           { id: "update-global", label: "Re-copy this package's payload over the GLOBAL install in ~/.claude", command: "orc update --global", network: false, names_files: false, advanced: true },
         ],
       };
     case "/api/maintenance/preview":
+      if (q.action === "clear-logs")
+        return {
+          action: q.action,
+          label: "Preview (fixtures)",
+          command: "orc clear logs --apply",
+          network: false,
+          names_files: true,
+          advanced: false,
+          danger: true,
+          restarts_ui: false,
+          preview_command: "orc clear logs",
+          // ORC_UI_FIXTURE_CLEAR=empty shows the "nothing is old enough" state.
+          preview: process.env.ORC_UI_FIXTURE_CLEAR === "empty" ? clearLogsPreviewEmpty : clearLogsPreview,
+          waiting_runs: runs.runs.filter((r) => r.status === "waiting").map((r) => r.slug),
+          dirty_tree: false,
+        };
       return {
         action: q.action,
         label: "Preview (fixtures)",
@@ -456,7 +508,9 @@ module.exports.get = function get(route, q) {
                 ? "upgrade"
                 : q.action === "update-global"
                   ? "update --global"
-                  : "update"),
+                  : q.action === "export"
+                    ? "export"
+                    : "update"),
         network: q.action === "upgrade",
         names_files: q.action === "prune",
         advanced: q.action === "update-global",
@@ -549,7 +603,16 @@ module.exports.get = function get(route, q) {
 // outcome is a file on disk, not a state.
 const TEST_ENV = { "api-users": [1, testEnvUnhealthy], "orders-api": [1, testEnvAbsent], "staging-checkout": [2, testEnvRemote] };
 
+// The one piece of fixture STATE: which `habits` mode the Behaviour panel sees.
+// Only the `habits` key is canned — every other config write still answers
+// "nothing ran", because its outcome is a file on disk, not a state.
+const HABITS_MODE = { value: "propose" };
+
 module.exports.post = function post(route, body) {
+  if (route === "/api/config/set" && body && body.key === "habits" && ["off", "observe", "propose"].includes(String(body.value))) {
+    HABITS_MODE.value = String(body.value);
+    return { exit_code: 0, data: { ok: true, key: "habits", value: HABITS_MODE.value } };
+  }
   // `add` answers OK so the CONNECT FLOW can be walked end to end in fixture
   // mode — the add is only the step before the test, and the test's outcome is
   // the state worth designing. Every other write still answers "nothing ran".

package/bin/webui/fixtures/knowledge.js

@@ -12,6 +12,7 @@
    fixture is worse than no fixture. */
 
 const { PROJECT } = require("./shell.js");
+const { gotchaExtraEntries, gotchaPanel } = require("./behaviour.js");
 
 const wiki = {
   state: "registered",
@@ -190,8 +191,8 @@ const wikiPlan = {
     { id: "orientation", cost: "free", cmd: "/orc-wiki refresh wiki/orc-orientation.md", what: "regenerate the derived orientation doc (read first by every consumer)" },
   ],
   rows: [
-    { doc: "wiki/orc-feature-refunds.md", state: "STRUCTURAL", delta: 0, delta_files: [], gone: ["api/refunds/window.ts"], used: 17, used_of: 20, last_used: "2026-08-10", tier: "deep", agent: "orc-wiki-scanner-opus-4-8-high", tier_rule: "structural", tier_why: "STRUCTURAL — a covered file is gone; a targeted refresh cannot re-anchor blind", new_surface: false, estimate: { p50: { input: 8000, cache_write: 40000, cache_read: 69000, output: 21000 }, p90: { input: 11000, cache_write: 58000, cache_read: 99000, output: 30000 }, samples: 7 }, usd: 0.42, retire_hint: false },
-    { doc: "wiki/orc-feature-payments.md", state: "TOUCHED", delta: 6, delta_files: ["src/payments/ledger.ts", "src/payments/idempotency.ts"], gone: [], used: 14, used_of: 20, last_used: "2026-08-09", tier: "deep", agent: "orc-wiki-scanner-opus-4-8-high", tier_rule: "wide-delta", tier_why: "covered files touched >= wiki_tier_deep_files", new_surface: false, estimate: { p50: { input: 7000, cache_write: 36000, cache_read: 62000, output: 19000 }, p90: { input: 10000, cache_write: 51000, cache_read: 88000, output: 27000 }, samples: 7 }, usd: 0.38, retire_hint: false },
+    { doc: "wiki/orc-feature-refunds.md", state: "STRUCTURAL", delta: 0, delta_files: [], gone: ["api/refunds/window.ts"], used: 17, used_of: 20, last_used: "2026-08-10", tier: "deep", agent: "orc-wiki-scanner-opus-5-low", tier_rule: "structural", tier_why: "STRUCTURAL — a covered file is gone; a targeted refresh cannot re-anchor blind", new_surface: false, estimate: { p50: { input: 8000, cache_write: 40000, cache_read: 69000, output: 21000 }, p90: { input: 11000, cache_write: 58000, cache_read: 99000, output: 30000 }, samples: 7 }, usd: 0.42, retire_hint: false },
+    { doc: "wiki/orc-feature-payments.md", state: "TOUCHED", delta: 6, delta_files: ["src/payments/ledger.ts", "src/payments/idempotency.ts"], gone: [], used: 14, used_of: 20, last_used: "2026-08-09", tier: "deep", agent: "orc-wiki-scanner-opus-5-low", tier_rule: "wide-delta", tier_why: "covered files touched >= wiki_tier_deep_files", new_surface: false, estimate: { p50: { input: 7000, cache_write: 36000, cache_read: 62000, output: 19000 }, p90: { input: 10000, cache_write: 51000, cache_read: 88000, output: 27000 }, samples: 7 }, usd: 0.38, retire_hint: false },
     { doc: "wiki/orc-reference-config.md", state: "TOUCHED", delta: 1, delta_files: ["src/config/index.ts"], gone: [], used: 2, used_of: 20, last_used: "2026-07-25", tier: "light", agent: "orc-wiki-scanner-sonnet-5-high", tier_rule: "small-delta", tier_why: "small delta, no new surface", new_surface: false, estimate: { p50: { input: 3000, cache_write: 11000, cache_read: 17000, output: 4000 }, p90: { input: 4000, cache_write: 16000, cache_read: 25000, output: 6000 }, samples: 4 }, usd: 0.06, retire_hint: false },
     // The zero-use retire candidate. It KEEPS ITS SLOT and renders muted with a
     // hint — filtering it out would make "unused" and "does not exist" identical.
@@ -251,7 +252,7 @@ const patterns = {
 
 const gotchas = {
   file: PROJECT + "/.claude/orc/gotchas.md",
-  count: 3,
+  count: 11,
   // v0.49.1: the cap is what makes the count mean anything, and only `prune`
   // used to print it — so "11 of 40" was not renderable from this payload.
   gotchas_max: 40,
@@ -262,7 +263,12 @@ const gotchas = {
     { id: "G-001", area: "express", kind: "repair", hits: 7, last_seen: "05-08-2026", trigger: "Jest suite hangs unless the server handle is closed in afterAll", fields: { trigger: "Jest suite hangs unless the server handle is closed in afterAll", symptom: "`npm test` never exits; CI times out at 10 minutes", fix: "close the http server in afterAll and await it", why: "supertest keeps the listener open, and Jest waits for the handle", first_seen: "14-05-2026", hits: "7", last_seen: "05-08-2026" } },
     { id: "G-002", area: "react", kind: "review", hits: 2, last_seen: "22-07-2026", trigger: "Date pickers must use the tz-aware helper, never new Date(string)", fields: { trigger: "Date pickers must use the tz-aware helper, never new Date(string)", symptom: "bookings land one day early for users west of UTC", fix: "use parseInZone from src/time/zone.ts", why: "new Date(string) parses as UTC and then renders local", first_seen: "02-06-2026", hits: "2", last_seen: "22-07-2026" } },
     { id: "G-003", area: "build", kind: "verify", hits: 0, last_seen: "14-06-2026", trigger: "`npm run build` needs NODE_OPTIONS=--max-old-space-size=4096 on CI", fields: { trigger: "`npm run build` needs NODE_OPTIONS=--max-old-space-size=4096 on CI", symptom: "the CI build is OOM-killed with no error line", fix: "set NODE_OPTIONS in the workflow, not in package.json", why: "the runner has less memory than a dev laptop", first_seen: "14-06-2026", hits: "0", last_seen: "14-06-2026" } },
+    // v2.0.0 W7 — eight more, so every source and status the Behaviour
+    // panel's Gotchas tab draws is designable. They live in behaviour.js.
+    ...gotchaExtraEntries,
   ],
+  // v2.0.0 W7 — the panel view `orc gotcha list --json` carries.
+  panel: gotchaPanel,
 };
 
 // STALE, so the Flow panel's gated state is designable.

package/bin/webui/fixtures/maintenance.js

@@ -1,42 +1,123 @@
-"use strict";
-/* fixtures/maintenance.js — canned data for `orc ui --fixtures`.
-   The export state and the mocked-example listing.
-
-   THE RULE FOR EVERY FILE IN HERE: carry ONE OF EVERY STATE, including the
-   ugly ones. You cannot DESIGN a STALE chip on a fresh wiki, and a state
-   with no fixture is a state nobody has ever looked at. A per-state count
-   test asserts this, so a new state cannot ship without one.
-
-   Shapes MUST match what `bin/cli.js --json` really emits — a drifted
-   fixture is worse than no fixture. */
-
-const { PROJECT } = require("./shell.js");
-
-const exportState = {
-  ok: false,
-  out: PROJECT + "/AGENTS.md",
-  exists: true,
-  source_commit: "c273793aa1b4",
-  sources: 17,
-  drifted: ["PACT.md", "wiki/orc-feature-payments.md", ".claude/orc/patterns/ts-pattern.md"],
-  removed: [],
-  stale: true,
-};
-
-/* ============================================================ v0.47.0 ====== */
-/* /orc-challenge. ONE OF EVERY STATE, including the ugly ones — you cannot
-   design a TAMPERED chip on a healthy cycle, a MISSING-REVISION candidate list
-   on a cycle whose revision is right where it should be, or a `NOT-CHECKED`
-   dimension chip on a cycle that has a template. test/webui.test.js asserts one
-   fixture per state, so a new state cannot ship without one. */
-
-const mocks = {
-  root: PROJECT + "/mock-examples",
-  total: 2,
-  mocks: [
-    { slug: "merchant-notifications", dir: PROJECT + "/mock-examples/merchant-notifications", mtime_ms: Date.now() - 40 * 60 * 1000, has_readme: true },
-    { slug: "invoice-pdf-export", dir: PROJECT + "/mock-examples/invoice-pdf-export", mtime_ms: Date.now() - 5 * 24 * 60 * 60 * 1000, has_readme: false },
-  ],
-};
-
-module.exports = { exportState, mocks };
+"use strict";
+/* fixtures/maintenance.js — canned data for `orc ui --fixtures`.
+   The export state and the mocked-example listing.
+
+   THE RULE FOR EVERY FILE IN HERE: carry ONE OF EVERY STATE, including the
+   ugly ones. You cannot DESIGN a STALE chip on a fresh wiki, and a state
+   with no fixture is a state nobody has ever looked at. A per-state count
+   test asserts this, so a new state cannot ship without one.
+
+   Shapes MUST match what `bin/cli.js --json` really emits — a drifted
+   fixture is worse than no fixture. */
+
+const { PROJECT } = require("./shell.js");
+
+const exportState = {
+  ok: false,
+  out: PROJECT + "/AGENTS.md",
+  exists: true,
+  source_commit: "c273793aa1b4",
+  sources: 17,
+  drifted: ["PACT.md", "wiki/orc-feature-payments.md", ".claude/orc/patterns/ts-pattern.md"],
+  removed: [],
+  stale: true,
+};
+
+/* ============================================================ v0.47.0 ====== */
+/* /orc-challenge. ONE OF EVERY STATE, including the ugly ones — you cannot
+   design a TAMPERED chip on a healthy cycle, a MISSING-REVISION candidate list
+   on a cycle whose revision is right where it should be, or a `NOT-CHECKED`
+   dimension chip on a cycle that has a template. test/webui.test.js asserts one
+   fixture per state, so a new state cannot ship without one. */
+
+const mocks = {
+  root: PROJECT + "/mock-examples",
+  total: 2,
+  mocks: [
+    { slug: "merchant-notifications", dir: PROJECT + "/mock-examples/merchant-notifications", mtime_ms: Date.now() - 40 * 60 * 1000, has_readme: true },
+    { slug: "invoice-pdf-export", dir: PROJECT + "/mock-examples/invoice-pdf-export", mtime_ms: Date.now() - 5 * 24 * 60 * 60 * 1000, has_readme: false },
+  ],
+};
+
+/* ============================================================ v2.1.0 W7 ==== */
+/* `orc clear logs`. The summary is `--summary --json` (no scan); the preview
+   is the print mode's `--json`. ONE OF EVERY STATE the renderer draws: a trace
+   set, a leftover, a closed run with its git ref, a done run whose ref is
+   already gone, every keep reason, the moved cutoff, and the old default
+   folder. `ORC_UI_FIXTURE_CLEAR=empty` gives the nothing-to-delete preview. */
+
+const clearLogsSummary = {
+  ok: true,
+  older_than_days: 30,
+  auto: "on",
+  last_sweep: { date: "2026-10-02", at: Date.now() - 3 * 60 * 60 * 1000, files: 41, bytes: 309112, older_than_days: 60 },
+  last_apply: null,
+  pruned_runs: 17,
+  rollup: ".claude/orc/logs-rollup.json",
+};
+
+const L = ".claude/orc/traces/";
+const R = ".claude/orc/run/";
+const clearLogsPreview = {
+  ok: true,
+  applied: false,
+  older_than_days: 30,
+  effective_days: 60,
+  cutoff: "2026-08-03",
+  cutoff_moved: { from: 30, to: 60, reason: "aftermath_window_days" },
+  log_dir: ".claude/orc/traces",
+  run_dir: ".claude/orc/run",
+  delete: [
+    {
+      path: L + "run-mini-order-store-extract-150626-192929.txt",
+      kind: "trace",
+      last_activity: "2026-06-15T20:04:11",
+      dated_by: "line stamp",
+      bytes: 9214,
+      files: [L + "run-mini-order-store-extract-150626-192929.txt", L + "run-mini-order-store-extract-150626-192929.txt.jsonl", L + "run-mini-order-store-extract-150626-192929.txt.pending.json"],
+    },
+    { path: L + "run-300626-005724.txt.superseded", kind: "leftover", last_activity: "2026-06-30T00:57:24", dated_by: "name stamp", bytes: 5830, files: [L + "run-300626-005724.txt.superseded"] },
+    {
+      path: R + "orders-cancel-endpoint/",
+      kind: "run",
+      status: "closed",
+      ref: "refs/orc/runs/orders-cancel-endpoint/pre",
+      last_activity: "2026-07-02T11:40:00",
+      dated_by: "mtime",
+      bytes: 22410,
+      files: [R + "orders-cancel-endpoint/RESUME.closed.md", R + "orders-cancel-endpoint/closed.json", R + "orders-cancel-endpoint/checkpoint.json", R + "orders-cancel-endpoint/snapshot.json"],
+    },
+    { path: R + "health-endpoint/", kind: "run", status: "done", ref: null, last_activity: "2026-06-20T09:12:45", dated_by: "mtime", bytes: 4096, files: [R + "health-endpoint/checkpoint.json"] },
+  ],
+  keep: [
+    { path: L + ".current", reason: "the active-run pointer — never touched" },
+    { path: L + "run-orc-orders-users-get-by-id-auth-011026-091500.txt", reason: "the active run — `.current` names it" },
+    { path: L + "run-quick-version-route-020926-101500.txt", reason: "holds habit answers (younger than 180 days)" },
+    { path: L + "run-fast-health-endpoint-210926-143000.txt", reason: "younger than 60 days (last activity 2026-09-21T14:41:09)" },
+    { path: L + "run-verify-cancel-endpoint-tree-021026-071000.txt", reason: "changed less than 6 hours ago — a run may still write to it" },
+    { path: L + "retro/", reason: "retro/ holds /orc-retro reports (deliverables) — never touched" },
+    { path: L + "habits-state.json", reason: "user data — never deleted" },
+    { path: R + "add-version-route/", reason: "a waiting run (RESUME.md, no RESUME.closed.md) — never touched" },
+    { path: R + "orders-search-endpoint/", reason: "a wait is armed (wait.json) — never touched" },
+  ],
+  totals: { units: 4, files: 9, bytes: 41550 },
+  default_dir: { path: ".claude/orc/logs", files: 132, bytes: 784384, included: false },
+  notes: [
+    "The cutoff moved from 30 to 60 days: aftermath_window_days is 60, and /orc-aftermath grades that window.",
+    "The old default folder .claude/orc/logs still holds 132 file(s) (766.0 KB). No reader sees it. Add --include-default-dir to clear it with the same rules.",
+  ],
+};
+
+const clearLogsPreviewEmpty = Object.assign({}, clearLogsPreview, {
+  older_than_days: 90,
+  effective_days: 90,
+  cutoff: "2026-07-04",
+  cutoff_moved: null,
+  delete: [],
+  keep: clearLogsPreview.keep.slice(0, 4),
+  totals: { units: 0, files: 0, bytes: 0 },
+  default_dir: null,
+  notes: [],
+});
+
+module.exports = { exportState, mocks, clearLogsSummary, clearLogsPreview, clearLogsPreviewEmpty };