@dzhechkov/harness-cli 0.3.214 → 0.3.215

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +21 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1260,6 +1260,27 @@ When using `--memory agentdb`, the following algorithms automatically tune searc
1260
1260
 
1261
1261
  The bandit automatically selects the best algorithm for your usage pattern — no manual tuning needed.
1262
1262
 
1263
+ ### SAFLA delta — rank lessons by payoff *slope*, not just level
1264
+
1265
+ Ported from rUv's SAFLA (`safla/core/delta_evaluation.py`). Normal memory ranks a learned lesson by a
1266
+ **level** — how often it's been used, how recently, its reward. That can't tell a lesson that was hammered
1267
+ early and is now dead from one quietly proving itself lately. SAFLA delta measures the **slope**: the
1268
+ *change* in a lesson's payoff over time, computed from its reinforce history in `.dz/sessions.jsonl` (a
1269
+ weighted sum of four deltas — performance, efficiency, stability, capability).
1270
+
1271
+ Two surfaces:
1272
+
1273
+ - **`dz consolidate`** prints a SAFLA-delta section — which lessons are **rising** (`↑`, still paying off)
1274
+ and which are **stale** (`↓`, slope ≤ 0). Stale lessons are shown as *prune candidates for review*, never
1275
+ auto-deleted (a stale-but-valid lesson is not noise). Works out of the box.
1276
+ - **Opt-in recall re-rank.** Set `deltaRerank` in `.dz/config.json` to let the slope nudge recall ranking —
1277
+ rising lessons up, stale ones down — as a **bounded** ± term (it never overrides lexical/vector
1278
+ relevance). **Off by default** (byte-identical to the reinforce-only re-rank until you enable it):
1279
+
1280
+ ```json
1281
+ { "memory": { "learning": { "deltaRerank": true } } }
1282
+ ```
1283
+
1263
1284
  ### How to enable AgentDB
1264
1285
 
1265
1286
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dzhechkov/harness-cli",
3
- "version": "0.3.214",
3
+ "version": "0.3.215",
4
4
  "description": "The dz CLI — install AI skills for Claude Code, Codex, OpenCode, Hermes, OpenClaude, GitHub Copilot. 35 commands, 13 presets, 6 platform targets.",
5
5
  "type": "module",
6
6
  "license": "MIT",