hzl-cli 1.19.2 → 1.20.1

package/README.md

@@ -367,20 +367,26 @@ If your coding agent supports an instruction file (for example `CLAUDE.md`, `AGE
 <!-- START [code:md] docs/snippets/agent-policy.md -->
 <!-- ⚠️ DO NOT EDIT - Auto-generated from docs/snippets/agent-policy.md -->
 ```md
-### HZL task ledger (external task tracking for multi-session/multi-agent work)
+### HZL task ledger (external task tracking)
 
-HZL is an external task database. Use it when work outlives this session or involves other agents.
-Built-in task tracking (if available) is fine for single-session work you'll complete now.
+HZL is an external task database. Use it whenever external tracking would help clarity, handoff, or auditability.
+Multi-session or multi-agent work are common reasons to use HZL, not requirements.
+Use HZL for single-session, single-agent work when the task is non-trivial.
 
-**When to use HZL:**
-- Work spanning multiple sessions or days
-- Coordination with other agents (Claude Code ↔ Codex ↔ Gemini)
-- Delegating to sub-agents with explicit handoff
-- User explicitly asks to track work in HZL
+**Prefer using HZL when:**
+- Work may outlive this session or is likely to be paused/resumed
+- You want a durable record of decisions, progress, or ownership
+- You expect handoff or review by another agent/person
+- The user asks to track work in HZL
+- The task is non-trivial (multiple steps, ~30+ minutes, or risky changes)
 
-**When NOT to use HZL:**
-- Single-session work you'll complete in this conversation
-- User hasn't mentioned persistence or multi-agent needs
+**You can skip HZL when:**
+- The work is small, clearly scoped, and will be completed immediately
+- The user asks for a quick one-off answer or tiny change
+
+**Rule of thumb:** If you feel tempted to make a multi-step plan or there is any chance you will not finish in this session, use HZL.
+
+Example: "Investigate failing tests and fix root cause" -> use HZL because it likely involves multiple subtasks, even if you expect to finish within a session.
 
 **Structure:**
 - **Project** = stable container (one per repo). Check `hzl project list` before creating.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hzl-cli",
-  "version": "1.19.2",
+  "version": "1.20.1",
   "description": "CLI for HZL - External task ledger for coding agents and OpenClaw.",
   "type": "module",
   "bin": {
@@ -60,8 +60,8 @@
     "libsql": "^0.5.0",
     "commander": "^14.0.0",
     "zod": "^3.23.8",
-    "hzl-core": "1.19.2",
-    "hzl-web": "1.19.2"
+    "hzl-core": "1.20.1",
+    "hzl-web": "1.20.1"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",