hzl-cli 1.24.1 → 1.25.0

package/README.md

@@ -467,8 +467,8 @@ hzl task complete <parent-id>            # If all done, complete parent
 
 That snippet is intentionally concise. The goal is clear triggers and structure, not ceremony.
 
-<!-- START docs/snippets/agent-skills-install.md -->
-<!-- ⚠️ DO NOT EDIT - Auto-generated from docs/snippets/agent-skills-install.md -->
+<!-- START snippets/AGENT-SKILLS-INSTALL.md -->
+<!-- ⚠️ DO NOT EDIT - Auto-generated from snippets/AGENT-SKILLS-INSTALL.md -->
 ### Claude Code skill (optional)
 
 HZL includes a Claude Code skill that helps agents work effectively with HZL.
@@ -507,7 +507,7 @@ Codex will download the skill and ask whether to add HZL guidance user-wide or p
 **Option B: Manual install**
 
 Follow the steps in [`.codex/INSTALL.md`](https://github.com/tmchow/hzl/blob/main/.codex/INSTALL.md) yourself.
-<!-- END docs/snippets/agent-skills-install.md -->
+<!-- END snippets/AGENT-SKILLS-INSTALL.md -->
 
 ---
 

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

@@ -0,0 +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.";
+//# sourceMappingURL=guide-content.d.ts.map

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

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

package/dist/commands/guide-content.js

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

package/dist/commands/guide-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-content.js","sourceRoot":"","sources":["../../src/commands/guide-content.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,yDAAyD;AAEzD,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFA+FoD,CAAC"}

package/dist/commands/guide.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createGuideCommand(): Command;
+//# sourceMappingURL=guide.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/commands/guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,kBAAkB,IAAI,OAAO,CAM5C"}

package/dist/commands/guide.js

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+import { GUIDE_CONTENT } from './guide-content.js';
+export function createGuideCommand() {
+    return new Command('guide')
+        .description('Output HZL workflow documentation for AI agents')
+        .action(() => {
+        console.log(GUIDE_CONTENT);
+    });
+}
+//# sourceMappingURL=guide.js.map

package/dist/commands/guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../src/commands/guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;SACxB,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/guide.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=guide.test.d.ts.map

package/dist/commands/guide.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.test.d.ts","sourceRoot":"","sources":["../../src/commands/guide.test.ts"],"names":[],"mappings":""}

package/dist/commands/guide.test.js

@@ -0,0 +1,26 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createGuideCommand } from './guide.js';
+import { GUIDE_CONTENT } from './guide-content.js';
+describe('guide command', () => {
+    let consoleSpy;
+    beforeEach(() => {
+        consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        consoleSpy.mockRestore();
+    });
+    it('should output the guide content', async () => {
+        const command = createGuideCommand();
+        await command.parseAsync([], { from: 'user' });
+        expect(consoleSpy).toHaveBeenCalledWith(GUIDE_CONTENT);
+    });
+    it('should have guide content from HZL-GUIDE.md', () => {
+        // Verify the content includes expected sections
+        expect(GUIDE_CONTENT).toContain('HZL task ledger');
+        expect(GUIDE_CONTENT).toContain('Use HZL when:');
+        expect(GUIDE_CONTENT).toContain('Skip HZL when:');
+        expect(GUIDE_CONTENT).toContain('hzl project list');
+        expect(GUIDE_CONTENT).toContain('hzl task');
+    });
+});
+//# sourceMappingURL=guide.test.js.map

package/dist/commands/guide.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.test.js","sourceRoot":"","sources":["../../src/commands/guide.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,UAAuC,CAAC;IAE5C,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/C,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,gDAAgD;QAChD,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACjD,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAClD,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QACpD,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjF,wBAAgB,aAAa,IAAI,OAAO,CA0BvC;AAED,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE;AAED,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,GACX,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjF,wBAAgB,aAAa,IAAI,OAAO,CA2BvC;AAED,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE;AAED,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,GACX,CAAC"}

package/dist/index.js

@@ -17,6 +17,7 @@ import { createDoctorCommand } from './commands/doctor.js';
 import { createLockCommand } from './commands/lock.js';
 import { createSampleProjectCommand } from './commands/sample-project.js';
 import { createServeCommand } from './commands/serve.js';
+import { createGuideCommand } from './commands/guide.js';
 import { CLIError, ExitCode } from './errors.js';
 import { resolveDbPaths, readConfig } from './config.js';
 import { formatOutput, printSuccess, printError, printTable } from './output.js';
@@ -42,6 +43,7 @@ export function createProgram() {
     program.addCommand(createDoctorCommand());
     program.addCommand(createLockCommand());
     program.addCommand(createServeCommand());
+    program.addCommand(createGuideCommand());
     return program;
 }
 export async function run(argv = process.argv) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hzl-cli",
-  "version": "1.24.1",
+  "version": "1.25.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.24.1",
-    "hzl-web": "1.24.1"
+    "hzl-core": "1.25.0",
+    "hzl-web": "1.25.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
@@ -71,7 +71,9 @@
     "vitest": "^4.0.18"
   },
   "scripts": {
+    "prebuild": "node ../../scripts/generate-guide-content.js",
     "build": "tsc -b",
+    "pretest": "node ../../scripts/generate-guide-content.js",
     "test": "vitest run",
     "test:watch": "vitest"
   }