@dzhechkov/harness-cli 0.4.1 → 0.4.2

package/.dz-manifest.json

@@ -9,7 +9,7 @@
       },
       {
         "path": "README.md",
-        "sha256": "357bb891e287a2af120a66914085b3b7dec24092aa99f46a8767c096741d713f"
+        "sha256": "4e4049b871ded58ff38fc36b60387a2324610db81dedcb623fb9cce6e77b057b"
       },
       {
         "path": "coverage/coverage-final.json",
@@ -37,15 +37,15 @@
       },
       {
         "path": "dist/cli.d.ts.map",
-        "sha256": "a8cff82f9f31b06b6a5f1934747631fcc551945ee3b7ac2c620b7c25076303cc"
+        "sha256": "a260f0e8d698ac142b38e33ef4d4ed0a21ccee96b179514bcb01bf81c5dce00f"
       },
       {
         "path": "dist/cli.js",
-        "sha256": "7afd2be99a3b9581b6fd8bfae58df6c608db346f741263c219d2140a5e8300ce"
+        "sha256": "b8a9c6d50cea7eda1065d76adb83e7c853ed9d82db72e7b24f952598e9dbd9d9"
       },
       {
         "path": "dist/cli.js.map",
-        "sha256": "481e6ddd256869585b3450ebe901057398a30bb8292e6f93f80a18d5c89ad0c0"
+        "sha256": "4af214e9233bd8f37ab92b95b90fcf05bd46752ecdc0d9491484ee8a7e55c539"
       },
       {
         "path": "dist/index.d.ts",
@@ -69,7 +69,7 @@
       },
       {
         "path": "package.json",
-        "sha256": "5a2d203ef20d2b6179595627b4fa1856fd7e17a31b19690324f589487874f9e0"
+        "sha256": "fa591b644f5abda81022a2cfe37996d739a2290ac46e09dcb958faa4e12be9f6"
       },
       {
         "path": "src/bin.ts",
@@ -77,7 +77,7 @@
       },
       {
         "path": "src/cli.ts",
-        "sha256": "1aba996c4e5dd717a496074baa83778e8f2e04927689fc2cfc315033b8982b38"
+        "sha256": "c9847974744f5bfd383866eb1832e97cb856e73d6f65cad19abfb91f22998cae"
       },
       {
         "path": "src/index.ts",
@@ -85,7 +85,7 @@
       },
       {
         "path": "test/cli.test.ts",
-        "sha256": "e63d24934506b3d6c6ec7f67072273ed9c9dabb86e8a24a7838819217ca6035d"
+        "sha256": "c66bdd2fbbe2e0b622e3bc4e0e4521e865cc8088e581bd4b4862c1c550307900"
       },
       {
         "path": "test/epoch-replay-cli.test.ts",
@@ -189,7 +189,11 @@
       },
       {
         "path": "test/mutation-registry.json",
-        "sha256": "36276fa51f9e5301ddb317687d0dbc839641b86f47f203e5d392bab31f4f178e"
+        "sha256": "3dd056f9d05712e45173b0911fc5900f0f52f8deba506d57c0e2b8281eb36a74"
+      },
+      {
+        "path": "test/statusline-panel.test.ts",
+        "sha256": "b09b42c4ece1a83e5d3f3765629b0756a8f30a7122f3fc30363f93f092a44c0d"
       },
       {
         "path": "test/workflow-init-lint-clean.test.ts",
@@ -213,5 +217,5 @@
       }
     ]
   },
-  "signature": "YV90oAIqb+16MFtctEUA4hH5x/O8BbGdAGh+eQ4HWJSxDwiRG3NxBDbDXFlUBvWKxwT/ttmcgKgaEE1ZHeIyDg=="
+  "signature": "nT7OzOloD2DCFR2ZYd4uWJ6isGyyfLiYk7v8hUKp4f0OTP0fTpsVvbDYJF9VvxASNVqwOGaQ7F6WQVu3NrkmBQ=="
 }

package/README.md

@@ -1303,6 +1303,38 @@ distills new learnings. It's **opt-in** and **non-clobbering**: `--install` merg
 existing `statusLine` config rather than overwriting it, and nothing changes until you run it.
 Modeled on the Agentic QE statusline pattern (e.g. AQE's `🎓 12 patterns`).
 
+#### Live run segment — `dz statusline --fa-record`
+
+A long-running pipeline can PREPEND its own segment to that line, so the bar shows what is in
+flight rather than only the standing pattern count. The `/feature-adr` pipeline records its
+Pattern-memory state at each step; a generated `loop-designer` loop records its current step on
+every trace flush:
+
+```bash
+# the /feature-adr pipeline — reports the learning loop it is actually running
+dz statusline --fa-record --slug add-user-auth --step "Step 8 QE" --recalled 7 --stored 2 --mode full
+
+# a generated loop — same file, different producer, so it says so
+dz statusline --fa-record --slug my-loop --step build --kind loop
+```
+
+```
+📐 feature-adr Step 8 QE · 🎓 224 pool · ↑7 used · +2 new · ↻0 reinforced · 🎓 dz: 224 patterns · 🧠 3 sources
+🔁 loop build · 🎓 dz: 224 patterns · 🧠 3 sources
+```
+
+`--kind <feature-adr|loop>` names the PRODUCER and defaults to `feature-adr`; an unrecognised value
+exits 1 rather than silently weakening panel arbitration. It is load-bearing in two places:
+
+- **the label**: a loop renders `🔁 loop <step>` and shows **no** learning counters, because a loop
+  never populates them — a `↑0 used` there would be a false statement about the Pattern-memory loop
+  rather than a measurement of it;
+- **the arbitration**: each producer writes its own per-slug slot under
+  `.dz/feature-adr/learning-state/`, and a fresh `feature-adr` state outranks any `loop` state, so a
+  loop running alongside a live pipeline can no longer blank that pipeline's counters. Slots are
+  discovered newest-first, nothing older than 30 minutes is surfaced, and the write path prunes at
+  24 h. Use `--project <dir>` to pin the panel to a specific project root.
+
 ### Usage estimate (`dz usage`)
 
 `dz usage` prints a READONLY, never-throw ESTIMATE of Claude SESSION and WEEKLY token usage,
@@ -3190,7 +3222,7 @@ npx @dzhechkov/p-replicator init
 
 ## Status
 
-`v0.4.1` — published on npm. Also available as [Claude Plugin](#claude-plugin). Part of [DZ Harness Hub](https://github.com/djd1m/dz-harness-hub).
+`v0.4.2` — published on npm. Also available as [Claude Plugin](#claude-plugin). Part of [DZ Harness Hub](https://github.com/djd1m/dz-harness-hub).
 
 ## Claude Plugin
 

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkbH,2EAA2E;AAC3E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KACvD;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AA2xQ9E,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoK5E"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkbH,2EAA2E;AAC3E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KACvD;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAyyQ9E,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoK5E"}

package/dist/cli.js

@@ -90,7 +90,7 @@ Usage:
   dz brain expand <kuId> [--source <slug>] [--json]                    (full-content lookup for a citation kuId; --json emits the full KU object)
   dz brain init  [--project <dir>] [--k <N>]                           (wire the grounding hook into .claude/settings.json — opt-in)
   dz statusline [--json] [--install] [--project <dir>]                 (live self-learning panel for Claude Code's status bar; reads the CC JSON payload from STDIN)
-  dz statusline --fa-record --slug <s> --step "<label>" [--recalled <n>] [--stored <n>] [--mode <m>]   (feature-adr: record live per-run learning state → 📐 panel segment)
+  dz statusline --fa-record --slug <s> --step "<label>" [--kind <feature-adr|loop>] [--recalled <n>] [--stored <n>] [--mode <m>]   (feature-adr: record live per-run learning state → 📐 panel segment)
   dz usage [--json] [--project <dir>] | dz usage --calibrate --session <pct> --weekly <pct> [--model fable=<pct>] [--project <dir>]  (ESTIMATE Claude usage from fixed reset windows; optional per-model weekly binding; exit 0 ALWAYS; pct=null when limits unconfigured)
   dz usage --by-stage [--run <runId> | --slug <slug>] [--epsilon <0..1>] [--write <file.jsonl>] [--json]   (per-stage cost ledger for ONE feature-adr run + the reconciliation invariant: accounted + unaccounted = run total; verdict BALANCED | DEFECT | INSUFFICIENT_DATA; local transcript ESTIMATES — catches ATTRIBUTION errors, not pricing errors)
   dz claim-check [paths...] [--json] [--fail-on high|medium|none] [--project <dir>]  (enforce the Integrity Rule: flag untagged/overstated accuracy claims; default scan = root README.md + every discovered package's README.md + features/*/08_qe_report.md + docs/**/*.md (historical feature artifacts are NOT scanned — pass paths explicitly); exit 1 only at/above --fail-on, default high)
@@ -1212,11 +1212,13 @@ function cmdStatuslineInstall(options, cwd, write) {
 /**
  * `dz statusline --fa-record` — the entry point the `/feature-adr` pipeline calls at Steps 0/8/9 to
  * record its LIVE learning state (Pattern memory loop: pool / recalled / stored). Unlike the render
- * path this WRITES `.dz/feature-adr/learning-state.json` (via harness-core's best-effort
- * `writeFeatureAdrState`, which itself computes `pool` from the learned-pattern count).
+ * path this WRITES a per-slug `.dz/feature-adr/learning-state/*.json` slot (via harness-core's
+ * best-effort `writeFeatureAdrState`, which itself computes `pool` from the learned-pattern count).
  *
  * GUARD (feature-adr flag discipline): `--slug` and `--step` are required; a missing one exits 1
  * with a copy-paste example. `--recalled`/`--stored` default to 0 and reject non-numeric input.
+ * `--kind <feature-adr|loop>` identifies the producer, defaults to `feature-adr`, and rejects any
+ * other value rather than silently weakening panel arbitration.
  */
 function cmdStatuslineFaRecord(options, cwd, write) {
     const slug = (options.get('slug') ?? '').trim();
@@ -1248,10 +1250,16 @@ function cmdStatuslineFaRecord(options, cwd, write) {
     const reinforced = parseCount('reinforced');
     if (reinforced === undefined)
         return 1;
+    const kindRaw = options.get('kind') ?? 'feature-adr';
+    if (kindRaw !== 'feature-adr' && kindRaw !== 'loop') {
+        write(`dz statusline --fa-record: --kind must be feature-adr or loop (got "${kindRaw}")`);
+        write('  Example: dz statusline --fa-record --slug add-user-auth --step "Step 0" --kind feature-adr --recalled 5 --stored 2');
+        return 1;
+    }
     const mode = options.get('mode');
     const projectRoot = resolve(cwd, options.get('project') ?? '.');
     const state = writeFeatureAdrState(projectRoot, {
-        slug, step, recalled, stored,
+        kind: kindRaw, slug, step, recalled, stored,
         ...(reinforced > 0 ? { reinforced } : {}),
         ...(mode !== undefined && mode.trim() !== '' ? { mode: mode.trim() } : {}),
     });
@@ -1294,7 +1302,13 @@ function cmdStatusline(options, flags, cwd, write, readStdin) {
         // Live /feature-adr run in flight → PREPEND the pipeline learning segment to the base dz line.
         const fa = data.featureAdr;
         if (fa !== undefined) {
-            line = `📐 feature-adr ${fa.step} · 🎓 ${fa.pool} pool · ↑${fa.recalled} used · +${fa.stored} new · ↻${fa.reinforced ?? 0} reinforced · ${line}`;
+            // The producer marker reached data and arbitration in a previous round but not this label, so the bar asserted a pipeline that was not running.
+            if (fa.kind === 'loop') {
+                line = `🔁 loop ${fa.step} · ${line}`;
+            }
+            else {
+                line = `📐 feature-adr ${fa.step} · 🎓 ${fa.pool} pool · ↑${fa.recalled} used · +${fa.stored} new · ↻${fa.reinforced ?? 0} reinforced · ${line}`;
+            }
         }
         write(line);
         return 0;