hzl-cli 1.18.5 → 1.18.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Trevin Chow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -383,25 +383,26 @@ Built-in task tracking (if available) is fine for single-session work you'll com
 - User hasn't mentioned persistence or multi-agent needs
 
 **Structure:**
-- **Project** = stable container (typically one per repo or long-running initiative). Check `hzl project list` before creating.
+- **Project** = stable container (one per repo). Check `hzl project list` before creating.
 - **Task** = top-level work item (often a feature). Use `--depends-on` to sequence separate tasks.
 - **Subtask** = breakdown of a task into parts (`--parent <id>`). Max 1 level of nesting.
 
+**⚠️ Anti-pattern: project sprawl**
+```bash
+hzl project create "query-perf"  # ❌ Feature ≠ project
+```
+Features are parent tasks, not projects:
+```bash
+hzl task add "Query perf fixes" -P myrepo      # Parent task
+hzl task add "Fix N+1" --parent <parent-id>    # Subtask
+```
+
 **Workflow:**
-1. `hzl project list` to find existing, or `hzl project create <name>`
-2. Add tasks. Use `--depends-on` for sequencing, `--parent` for breakdown, `--links` for context docs.
-3. Claim before work, checkpoint progress, complete when done.
-4. Use `--json` for scripted output.
-
-**Key commands:**
-- `hzl task add "<title>" -P <project> [--depends-on <id>] [--parent <id>] [--links <file>]`
-- `hzl task claim <id> [--author <name>] [--agent-id <id>] [--lease 30]`
-- `hzl task checkpoint <id> "<message>" [--progress <0-100>]`
-- `hzl task progress <id> <value>` (set progress without checkpoint)
-- `hzl task block <id> [--reason "<why>"]` (mark as blocked)
-- `hzl task unblock <id>` (return to in_progress)
-- `hzl task complete <id>`
-- `hzl task next --project <project>` (returns next available; never returns parent tasks)
+1. `hzl project list` — **Always check first. Reuse existing repo project.**
+2. Only create a project for a NEW repo (not a feature).
+3. For multi-step work: create parent task, then subtasks with `--parent`.
+4. Claim before work, checkpoint progress, complete when done.
+5. Use `--json` for scripted output.
 
 **⚠️ DESTRUCTIVE - Never run without explicit user request:**
 - `hzl task prune` — **PERMANENTLY DELETES** old done/archived tasks. No undo.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hzl-cli",
-  "version": "1.18.5",
+  "version": "1.18.7",
   "description": "CLI for HZL - External task ledger for coding agents and OpenClaw.",
   "type": "module",
   "bin": {
@@ -56,17 +56,12 @@
   "engines": {
     "node": ">=22.14.0"
   },
-  "scripts": {
-    "build": "tsc -b",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "dependencies": {
     "libsql": "^0.5.0",
     "commander": "^14.0.0",
-    "hzl-core": "workspace:*",
-    "hzl-web": "workspace:*",
-    "zod": "^3.23.8"
+    "zod": "^3.23.8",
+    "hzl-core": "1.18.7",
+    "hzl-web": "1.18.7"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
@@ -74,5 +69,10 @@
     "@vitest/coverage-v8": "^4.0.18",
     "typescript": "^5.3.0",
     "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}