hzl-cli 1.26.1 → 1.28.0

package/dist/commands/guide-content.d.ts

@@ -1,2 +1,2 @@
-export declare const GUIDE_CONTENT = "### HZL task ledger (external task tracking)\n\nHZL is an external task database. Use it when external tracking helps clarity, handoff, or auditability.\n\n**Use HZL when:**\n- Work has multiple steps or may not finish this session\n- You want durable record of progress or ownership\n- Handoff or review expected\n- Task is non-trivial (~30+ min or risky changes)\n\n**Skip HZL when:**\n- Small, clearly scoped work completed immediately\n- Quick one-off answer or tiny change\n\n**Rule of thumb:** If you're tempted to make a multi-step plan, use HZL.\n\n**Structure:**\n- **Project** = repo name. One per repo. Always `hzl project list` first.\n- **Task** = feature or work item.\n- **Subtask** = breakdown (`--parent <id>`). Max 1 level.\n\n**Anti-pattern: project sprawl**\n```bash\nhzl project create \"query-perf\"  # Wrong: feature is not a project\n```\nFeatures are parent tasks:\n```bash\nhzl task add \"Query perf\" -P myrepo           # Parent task\nhzl task add \"Fix N+1\" --parent <parent-id>   # Subtask\n```\n\n---\n\n**Setup:**\n```bash\nhzl project list                    # Always check first\nhzl project create <repo-name>      # Only if needed\n```\n\n**Adding work:**\n```bash\nhzl task add \"Feature X\" -P myrepo -s ready           # Ready to claim\nhzl task add \"Subtask A\" --parent <id>                # Subtask\nhzl task add \"Subtask B\" --parent <id> --depends-on <subtask-a-id>  # With dependency\n```\n\n**Task context:** Use `-d` for details, `-l` for reference docs:\n```bash\nhzl task add \"Add rate limiting\" -P myrepo -s ready \\\n  -d \"Per linked spec. Use RateLimiter from src/middleware/.\" \\\n  -l docs/rate-limit-spec.md\n```\nIf docs exist, reference them (don't duplicate\u2014avoids drift). If no docs, include enough detail to complete the task. Description supports markdown/multiline.\n\n**Working on a task:**\n```bash\nhzl task next -P myrepo                  # Next available task\nhzl task next --parent <id>              # Next subtask of parent\nhzl task next -P myrepo --claim          # Find and claim in one step\nhzl task claim <id>                      # Claim specific task\nhzl task checkpoint <id> \"milestone X\"   # Notable progress or before pausing\n```\n\n**Changing status:**\n```bash\nhzl task set-status <id> ready           # Make claimable (from backlog)\nhzl task set-status <id> backlog         # Move back to planning\n```\nStatuses: `backlog` \u2192 `ready` \u2192 `in_progress` \u2192 `done` (or `blocked`)\n\n**When blocked:**\n```bash\nhzl task block <id> --comment \"Waiting for API keys from DevOps\"\nhzl task unblock <id>                    # When resolved\n```\n\n**Finishing work:**\n```bash\nhzl task comment <id> \"Implemented X, tested Y\"  # Optional: final notes\nhzl task complete <id>\n\n# After completing a subtask, check parent:\nhzl task show <parent-id> --json         # Any subtasks left?\nhzl task complete <parent-id>            # If all done, complete parent\n```\n\n**Troubleshooting:**\n| Error | Fix |\n|-------|-----|\n| \"not claimable (status: backlog)\" | `hzl task set-status <id> ready` |\n| \"Cannot complete: status is X\" | Claim first: `hzl task claim <id>` |\n\n---\n\n**DESTRUCTIVE - Never run without explicit user request:**\n- `hzl task prune` \u2014 **PERMANENTLY DELETES** old done/archived tasks. No undo.";
+export declare const GUIDE_CONTENT = "### HZL task ledger (external task tracking)\n\nThis project uses HZL for task tracking. Use it when tracking helps clarity, handoff, or auditability.\n\n**Use HZL when:**\n- Work has multiple steps or may not finish this session\n- You want durable record of progress or ownership\n- Handoff or review expected\n- Task is non-trivial (~30+ min or risky changes)\n\n**Skip HZL when:**\n- Small, clearly scoped work completed immediately\n- Quick one-off answer or tiny change\n\n**Rule of thumb:** If you're tempted to make a multi-step plan, use HZL.\n\n**Structure:**\n- **Project** = repo name. One per repo. Always `hzl project list` first.\n- **Task** = feature or work item.\n- **Subtask** = breakdown (`--parent <id>`). Max 1 level.\n\n**Anti-pattern: project sprawl**\n```bash\nhzl project create \"query-perf\"  # Wrong: feature is not a project\n```\nFeatures are parent tasks:\n```bash\nhzl task add \"Query perf\" -P myrepo           # Parent task\nhzl task add \"Fix N+1\" --parent <parent-id>   # Subtask\n```\n\n---\n\n**Setup:**\n```bash\nhzl project list                    # Always check first\nhzl project create <repo-name>      # Only if needed\n```\n\n**Adding work:**\n```bash\nhzl task add \"Feature X\" -P myrepo -s ready           # Ready to claim\nhzl task add \"Subtask A\" --parent <id>                # Subtask\nhzl task add \"Subtask B\" --parent <id> --depends-on <subtask-a-id>  # With dependency\n```\n\n**Task context:** Use `-d` for details, `-l` for reference docs:\n```bash\nhzl task add \"Add rate limiting\" -P myrepo -s ready \\\n  -d \"Per linked spec. Use RateLimiter from src/middleware/.\" \\\n  -l docs/rate-limit-spec.md\n```\nIf docs exist, reference them (don't duplicate\u2014avoids drift). If no docs, include enough detail to complete the task. Description supports markdown/multiline.\n\n**Working on a task:**\n```bash\nhzl task next -P myrepo                  # Next available task\nhzl task next --parent <id>              # Next subtask of parent\nhzl task next -P myrepo --claim          # Find and claim in one step\nhzl task claim <id>                      # Claim specific task\nhzl task checkpoint <id> \"milestone X\"   # Notable progress or before pausing\n```\n\n**Changing status:**\n```bash\nhzl task set-status <id> ready           # Make claimable (from backlog)\nhzl task set-status <id> backlog         # Move back to planning\n```\nStatuses: `backlog` \u2192 `ready` \u2192 `in_progress` \u2192 `done` (or `blocked`)\n\n**When blocked:**\n```bash\nhzl task block <id> --comment \"Waiting for API keys from DevOps\"\nhzl task unblock <id>                    # When resolved\n```\n\n**Finishing work:**\n```bash\nhzl task comment <id> \"Implemented X, tested Y\"  # Optional: final notes\nhzl task complete <id>\n\n# After completing a subtask, check parent:\nhzl task show <parent-id> --json         # Any subtasks left?\nhzl task complete <parent-id>            # If all done, complete parent\n```\n\n**Troubleshooting:**\n| Error | Fix |\n|-------|-----|\n| \"not claimable (status: backlog)\" | `hzl task set-status <id> ready` |\n| \"Cannot complete: status is X\" | Claim first: `hzl task claim <id>` |\n\n---\n\n**DESTRUCTIVE - Never run without explicit user request:**\n- `hzl task prune` \u2014 **PERMANENTLY DELETES** old done/archived tasks. No undo.";
 //# sourceMappingURL=guide-content.d.ts.map

package/dist/commands/guide-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guide-content.d.ts","sourceRoot":"","sources":["../../src/commands/guide-content.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,2wGA+FuD,CAAC"}
+{"version":3,"file":"guide-content.d.ts","sourceRoot":"","sources":["../../src/commands/guide-content.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,ywGA+FuD,CAAC"}

package/dist/commands/guide-content.js

@@ -2,7 +2,7 @@
 // Do not edit directly - edit the source snippet instead
 export const GUIDE_CONTENT = `### HZL task ledger (external task tracking)
 
-HZL is an external task database. Use it when external tracking helps clarity, handoff, or auditability.
+This project uses HZL for task tracking. Use it when tracking helps clarity, handoff, or auditability.
 
 **Use HZL when:**
 - Work has multiple steps or may not finish this session

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hzl-cli",
-  "version": "1.26.1",
+  "version": "1.28.0",
   "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.26.1",
-    "hzl-web": "1.26.1"
+    "hzl-core": "1.28.0",
+    "hzl-web": "1.28.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",