@azure-id/orc 2.0.2 → 2.1.1

package/bin/webui/fixtures/index.js

@@ -30,7 +30,7 @@ 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");
@@ -280,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":
@@ -464,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)",
@@ -481,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",

package/bin/webui/fixtures/knowledge.js

@@ -191,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.

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 };