hzl-cli 1.34.1 → 2.1.0

package/README.md

@@ -2,9 +2,15 @@
 
 <img src="./assets/hzl.png" alt="HZL mascot" width="320" />
 
-## The Missing Task Layer for OpenClaw
+## Shared Task Ledger for OpenClaw
 
-Coordinate many agents through shared, durable task state with built-in human visibility.
+HZL is a durable shared task ledger for OpenClaw and other multi-agent systems.
+
+Each agent wake is a fresh session. HZL preserves continuity across those wakes so agents can:
+- resume in-progress work safely,
+- hand off with durable context,
+- coordinate through shared project pools,
+- and recover from stalled sessions.
 
 ## Install
 
@@ -23,13 +29,32 @@ brew install hzl
 hzl init
 ```
 
+## Stateless Agent Loop (Quick Example)
+
+```bash
+# 1) Session start: resume existing work or claim next
+hzl workflow run start --agent clara --project writing
+
+# 2) Record durable progress while working
+hzl task checkpoint <task-id> "Draft complete, revising CTA section"
+
+# 3) Handoff to a project pool (unassigned follow-on)
+hzl workflow run handoff \
+  --from <task-id> \
+  --title "Schedule approved copy" \
+  --project marketing
+
+# 4) Host runtime drains completion hooks on a schedule
+hzl hook drain
+```
+
 ## Documentation
 
 - [Get Started](https://www.hzl-tasks.com/getting-started/)
-- [OpenClaw Setup](https://www.hzl-tasks.com/getting-started/openclaw/)
+- [Workflows](https://www.hzl-tasks.com/workflows/)
+- [Installation & OpenClaw Setup](https://www.hzl-tasks.com/getting-started/installation/)
 - [CLI Reference](https://www.hzl-tasks.com/reference/cli/)
 - [Concepts](https://www.hzl-tasks.com/concepts/)
-- [Workflows](https://www.hzl-tasks.com/workflows/)
 
 Local preview:
 

package/dist/commands/dep/index.d.ts

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

package/dist/commands/dep/index.d.ts.map

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

package/dist/commands/dep/index.js

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+import { createDepListCommand } from './list.js';
+export function createDepCommand() {
+    const command = new Command('dep').description('Dependency commands');
+    command.addCommand(createDepListCommand());
+    return command;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/dep/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/dep/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IACtE,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/dep/list.d.ts

@@ -0,0 +1,38 @@
+import { Command } from 'commander';
+import { TaskStatus } from 'hzl-core/events/types.js';
+import { type Services } from '../../db.js';
+export interface DependencyListItem {
+    from_task_id: string;
+    to_task_id: string;
+    from_title: string | null;
+    to_title: string | null;
+    from_project: string | null;
+    to_project: string | null;
+    from_agent: string | null;
+    to_agent: string | null;
+    from_status: TaskStatus | null;
+    to_status: TaskStatus | null;
+    cross_project: boolean;
+    blocking: boolean;
+    missing_from: boolean;
+    missing_to: boolean;
+}
+export interface DepListResult {
+    dependencies: DependencyListItem[];
+    total: number;
+}
+export interface DepListOptions {
+    services: Services;
+    project?: string;
+    fromProject?: string;
+    toProject?: string;
+    agent?: string;
+    fromAgent?: string;
+    toAgent?: string;
+    blockingOnly?: boolean;
+    crossProjectOnly?: boolean;
+    json: boolean;
+}
+export declare function runDepList(options: DepListOptions): DepListResult;
+export declare function createDepListCommand(): Command;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/dep/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/dep/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKnE,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,EAAE,OAAO,CAAC;CACf;AAsFD,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAuFjE;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAkC9C"}

package/dist/commands/dep/list.js

@@ -0,0 +1,156 @@
+import { Command } from 'commander';
+import { TaskStatus } from 'hzl-core/events/types.js';
+import { resolveDbPaths } from '../../config.js';
+import { initializeDb, closeDb } from '../../db.js';
+import { handleError } from '../../errors.js';
+import { createShortId } from '../../short-id.js';
+import { GlobalOptionsSchema } from '../../types.js';
+function escapeMd(value) {
+    return value.replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+function formatTaskCell(shortId, taskId, title, project) {
+    const resolvedTitle = title ?? '[missing task]';
+    const resolvedProject = project ?? 'missing';
+    return `[${shortId(taskId)}] ${resolvedTitle} (${resolvedProject})`;
+}
+function toDependencyItem(row) {
+    const missingFrom = row.from_project === null;
+    const missingTo = row.to_project === null;
+    const crossProject = row.from_project !== null &&
+        row.to_project !== null &&
+        row.from_project !== row.to_project;
+    const fromCanBeBlocked = row.from_status === TaskStatus.Ready ||
+        row.from_status === TaskStatus.InProgress ||
+        row.from_status === TaskStatus.Blocked;
+    const toIsDone = row.to_status === TaskStatus.Done;
+    const blocking = fromCanBeBlocked && !toIsDone;
+    return {
+        ...row,
+        cross_project: crossProject,
+        blocking,
+        missing_from: missingFrom,
+        missing_to: missingTo,
+    };
+}
+function printMarkdown(items) {
+    if (items.length === 0) {
+        console.log('No dependencies found');
+        return;
+    }
+    const shortId = createShortId(items.flatMap((item) => [item.from_task_id, item.to_task_id]));
+    console.log('| From | To | Blocking | Cross-Project | Agents |');
+    console.log('| --- | --- | --- | --- | --- |');
+    for (const item of items) {
+        const fromCell = escapeMd(formatTaskCell(shortId, item.from_task_id, item.from_title, item.from_project));
+        const toCell = escapeMd(formatTaskCell(shortId, item.to_task_id, item.to_title, item.to_project));
+        const agents = escapeMd(`${item.from_agent ?? 'unassigned'} -> ${item.to_agent ?? 'unassigned'}`);
+        console.log(`| ${fromCell} | ${toCell} | ${item.blocking ? 'yes' : 'no'} | ${item.cross_project ? 'yes' : 'no'} | ${agents} |`);
+    }
+}
+export function runDepList(options) {
+    const { services, project, fromProject, toProject, agent, fromAgent, toAgent, blockingOnly, crossProjectOnly, json, } = options;
+    const where = [];
+    const params = [];
+    if (project) {
+        where.push('(ft.project = ? OR tt.project = ?)');
+        params.push(project, project);
+    }
+    if (fromProject) {
+        where.push('ft.project = ?');
+        params.push(fromProject);
+    }
+    if (toProject) {
+        where.push('tt.project = ?');
+        params.push(toProject);
+    }
+    if (agent) {
+        where.push('(ft.agent = ? OR tt.agent = ?)');
+        params.push(agent, agent);
+    }
+    if (fromAgent) {
+        where.push('ft.agent = ?');
+        params.push(fromAgent);
+    }
+    if (toAgent) {
+        where.push('tt.agent = ?');
+        params.push(toAgent);
+    }
+    if (blockingOnly) {
+        where.push("ft.status IN ('ready', 'in_progress', 'blocked')");
+        where.push("(tt.task_id IS NULL OR tt.status != 'done')");
+    }
+    if (crossProjectOnly) {
+        where.push('ft.project IS NOT NULL');
+        where.push('tt.project IS NOT NULL');
+        where.push('ft.project != tt.project');
+    }
+    const whereClause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+    const rows = services.cacheDb.prepare(`
+    SELECT
+      d.task_id AS from_task_id,
+      d.depends_on_id AS to_task_id,
+      ft.title AS from_title,
+      tt.title AS to_title,
+      ft.project AS from_project,
+      tt.project AS to_project,
+      ft.agent AS from_agent,
+      tt.agent AS to_agent,
+      ft.status AS from_status,
+      tt.status AS to_status
+    FROM task_dependencies d
+    LEFT JOIN tasks_current ft ON ft.task_id = d.task_id
+    LEFT JOIN tasks_current tt ON tt.task_id = d.depends_on_id
+    ${whereClause}
+    ORDER BY COALESCE(ft.project, ''), COALESCE(tt.project, ''), d.task_id, d.depends_on_id
+  `).all(...params);
+    const dependencies = rows.map(toDependencyItem);
+    const result = {
+        dependencies,
+        total: dependencies.length,
+    };
+    if (json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        printMarkdown(dependencies);
+    }
+    return result;
+}
+export function createDepListCommand() {
+    return new Command('list')
+        .description('List dependency edges')
+        .option('-P, --project <project>', 'Filter edges where either side is in this project')
+        .option('--from-project <project>', 'Filter by dependent task project')
+        .option('--to-project <project>', 'Filter by dependency task project')
+        .option('--agent <agent>', 'Filter edges where either side is assigned to this agent')
+        .option('--from-agent <agent>', 'Filter by dependent task agent')
+        .option('--to-agent <agent>', 'Filter by dependency task agent')
+        .option('--blocking-only', 'Show only currently blocking dependencies', false)
+        .option('--cross-project-only', 'Show only cross-project dependencies', false)
+        .action(function (opts) {
+        const globalOpts = GlobalOptionsSchema.parse(this.optsWithGlobals());
+        const { eventsDbPath, cacheDbPath } = resolveDbPaths(globalOpts.db);
+        const services = initializeDb({ eventsDbPath, cacheDbPath });
+        try {
+            runDepList({
+                services,
+                project: opts.project,
+                fromProject: opts.fromProject,
+                toProject: opts.toProject,
+                agent: opts.agent,
+                fromAgent: opts.fromAgent,
+                toAgent: opts.toAgent,
+                blockingOnly: opts.blockingOnly,
+                crossProjectOnly: opts.crossProjectOnly,
+                json: globalOpts.json ?? false,
+            });
+        }
+        catch (error) {
+            handleError(error, globalOpts.json);
+        }
+        finally {
+            closeDb(services);
+        }
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/dep/list.js.map

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

package/dist/commands/dep/list.test.d.ts

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

package/dist/commands/dep/list.test.d.ts.map

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

package/dist/commands/dep/list.test.js

@@ -0,0 +1,171 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { TaskStatus } from 'hzl-core/events/types.js';
+import { initializeDbFromPath, closeDb } from '../../db.js';
+import { runDepList } from './list.js';
+describe('runDepList', () => {
+    let tempDir;
+    let dbPath;
+    let services;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'hzl-dep-list-test-'));
+        dbPath = path.join(tempDir, 'test.db');
+        services = initializeDbFromPath(dbPath);
+    });
+    afterEach(() => {
+        closeDb(services);
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    it('lists dependency edges and marks missing targets safely', () => {
+        const dep = services.taskService.createTask({ title: 'Dep', project: 'inbox' });
+        const dependent = services.taskService.createTask({
+            title: 'Dependent',
+            project: 'inbox',
+            depends_on: [dep.task_id],
+        });
+        services.taskService.setStatus(dependent.task_id, TaskStatus.Ready);
+        services.taskService.createTask({
+            title: 'Orphan edge',
+            project: 'inbox',
+            depends_on: ['missing-task-id'],
+        });
+        const result = runDepList({ services, json: false });
+        expect(result.total).toBe(2);
+        const existing = result.dependencies.find((d) => d.to_task_id === dep.task_id);
+        expect(existing?.missing_to).toBe(false);
+        const missing = result.dependencies.find((d) => d.to_task_id === 'missing-task-id');
+        expect(missing?.missing_to).toBe(true);
+        expect(missing?.blocking).toBe(false); // source task still backlog
+    });
+    it('filters by project for either side of edge', () => {
+        services.projectService.createProject('alpha');
+        services.projectService.createProject('beta');
+        const depAlpha = services.taskService.createTask({ title: 'Dep Alpha', project: 'alpha' });
+        services.taskService.createTask({
+            title: 'From Beta',
+            project: 'beta',
+            depends_on: [depAlpha.task_id],
+        });
+        const resultAlpha = runDepList({ services, project: 'alpha', json: false });
+        const resultBeta = runDepList({ services, project: 'beta', json: false });
+        expect(resultAlpha.total).toBe(1);
+        expect(resultBeta.total).toBe(1);
+    });
+    it('filters by from-project and to-project', () => {
+        services.projectService.createProject('alpha');
+        services.projectService.createProject('beta');
+        const depAlpha = services.taskService.createTask({ title: 'Dep Alpha', project: 'alpha' });
+        services.taskService.createTask({
+            title: 'From Beta',
+            project: 'beta',
+            depends_on: [depAlpha.task_id],
+        });
+        const depBeta = services.taskService.createTask({ title: 'Dep Beta', project: 'beta' });
+        services.taskService.createTask({
+            title: 'From Beta 2',
+            project: 'beta',
+            depends_on: [depBeta.task_id],
+        });
+        const result = runDepList({
+            services,
+            fromProject: 'beta',
+            toProject: 'alpha',
+            json: false,
+        });
+        expect(result.total).toBe(1);
+        expect(result.dependencies[0].from_project).toBe('beta');
+        expect(result.dependencies[0].to_project).toBe('alpha');
+    });
+    it('filters by agent, from-agent, and to-agent', () => {
+        const toMatch = services.taskService.createTask({
+            title: 'Dep Match',
+            project: 'inbox',
+            agent: 'to-agent',
+        });
+        const toOther = services.taskService.createTask({
+            title: 'Dep Other',
+            project: 'inbox',
+            agent: 'to-other',
+        });
+        const fromMatch = services.taskService.createTask({
+            title: 'From Match',
+            project: 'inbox',
+            depends_on: [toMatch.task_id],
+            agent: 'from-agent',
+        });
+        const fromOther = services.taskService.createTask({
+            title: 'From Other',
+            project: 'inbox',
+            depends_on: [toOther.task_id],
+            agent: 'from-other',
+        });
+        const fromAgent = runDepList({ services, fromAgent: 'from-agent', json: false });
+        const toAgent = runDepList({ services, toAgent: 'to-agent', json: false });
+        const eitherFrom = runDepList({ services, agent: 'from-agent', json: false });
+        const eitherTo = runDepList({ services, agent: 'to-agent', json: false });
+        expect(fromAgent.total).toBe(1);
+        expect(toAgent.total).toBe(1);
+        expect(eitherFrom.total).toBe(1);
+        expect(eitherTo.total).toBe(1);
+    });
+    it('supports blocking-only filter', () => {
+        const blocker = services.taskService.createTask({ title: 'Blocker', project: 'inbox' });
+        const blocked = services.taskService.createTask({
+            title: 'Blocked',
+            project: 'inbox',
+            depends_on: [blocker.task_id],
+        });
+        services.taskService.setStatus(blocked.task_id, TaskStatus.Ready);
+        const doneDep = services.taskService.createTask({ title: 'Done dep', project: 'inbox' });
+        services.taskService.setStatus(doneDep.task_id, TaskStatus.Ready);
+        services.taskService.claimTask(doneDep.task_id);
+        services.taskService.completeTask(doneDep.task_id);
+        const unblocked = services.taskService.createTask({
+            title: 'Unblocked',
+            project: 'inbox',
+            depends_on: [doneDep.task_id],
+        });
+        services.taskService.setStatus(unblocked.task_id, TaskStatus.Ready);
+        const orphan = services.taskService.createTask({
+            title: 'Orphan',
+            project: 'inbox',
+            depends_on: ['missing-for-blocking'],
+        });
+        services.taskService.setStatus(orphan.task_id, TaskStatus.Ready);
+        const pausedParent = services.taskService.createTask({
+            title: 'Paused Parent',
+            project: 'inbox',
+            depends_on: [blocker.task_id],
+        });
+        services.taskService.setStatus(pausedParent.task_id, TaskStatus.Blocked);
+        const result = runDepList({ services, blockingOnly: true, json: false });
+        const edgePairs = result.dependencies.map((d) => `${d.from_task_id}->${d.to_task_id}`).sort();
+        expect(edgePairs).toEqual([
+            `${blocked.task_id}->${blocker.task_id}`,
+            `${orphan.task_id}->missing-for-blocking`,
+            `${pausedParent.task_id}->${blocker.task_id}`,
+        ].sort());
+    });
+    it('supports cross-project-only filter', () => {
+        services.projectService.createProject('alpha');
+        services.projectService.createProject('beta');
+        const depAlpha = services.taskService.createTask({ title: 'Dep Alpha', project: 'alpha' });
+        services.taskService.createTask({
+            title: 'From Beta',
+            project: 'beta',
+            depends_on: [depAlpha.task_id],
+        });
+        const depBeta = services.taskService.createTask({ title: 'Dep Beta', project: 'beta' });
+        services.taskService.createTask({
+            title: 'From Beta 2',
+            project: 'beta',
+            depends_on: [depBeta.task_id],
+        });
+        const result = runDepList({ services, crossProjectOnly: true, json: false });
+        expect(result.total).toBe(1);
+        expect(result.dependencies[0].cross_project).toBe(true);
+    });
+});
+//# sourceMappingURL=list.test.js.map

package/dist/commands/dep/list.test.js.map

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

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

@@ -1,2 +1,2 @@
-export declare const GUIDE_CONTENT = "### HZL task ledger (agent instructions)\n\nUse this guide to operate HZL as the shared task ledger for agents on one machine/OpenClaw instance.\n\n**Use HZL when:**\n- Work has multiple steps or may not finish this session\n- You need durable ownership, progress, or handoff state\n- One agent needs help from another agent\n- You need visibility/auditability for ongoing agent work\n\n**Skip HZL when:**\n- The work is tiny and can be completed immediately\n- A one-off answer does not need durable tracking\n\n**Rule of thumb:** If work could span sessions or involve multiple agents, use HZL.\n\n---\n\n**Primary orientation:**\n- HZL is agent-first: agents create, claim, hand off, and complete tasks.\n- Humans typically steer and observe; they can also create/update tasks when needed.\n- Projects are optional scopes. Use `inbox` when you do not need scoping.\n\n**Structure:**\n- **Project (optional)** = shared scope/domain (e.g., `research`, `writing`, `api-service`).\n- **Task** = unit of work.\n- **Subtask** = breakdown (`--parent <id>`), max depth 1.\n- **Agent** = ownership identity (`--agent`).\n\n---\n\n**Setup / scope selection:**\n```bash\nhzl project list                  # Check existing scopes\nhzl project create research       # Optional: create scope only if useful\n```\n\n**Create work:**\n```bash\n# Unscoped/global queue (inbox)\nhzl task add \"Triage failing tests\" -s ready\n\n# Scoped queue\nhzl task add \"Summarize benchmark paper\" -P research -s ready\n\n# Delegate directly to another agent\nhzl task add \"Draft release notes\" -P writing -s ready --agent writer-1 --author main-agent\n```\n\n**Claim work:**\n```bash\n# Replace <agent-name> with this agent's identity (for example: lobster, clara, researcher-1)\n\n# Let HZL pick next eligible task\nhzl task claim --next --agent <agent-name>\nhzl task claim --next -P research --agent <agent-name>\n\n# Claim specific task by ID (after reasoning over candidates)\nhzl task claim <id> --agent <agent-name>\n```\n\n**Inspect candidate work:**\n```bash\nhzl task list --available --view summary\nhzl task list -P research --available --view summary\nhzl task list --agent-pattern 'writer*' --view summary\n```\n\n**Record progress / blockers:**\n```bash\nhzl task checkpoint <id> \"completed first pass, next: validate edge cases\"\nhzl task progress <id> 60\nhzl task block <id> --comment \"Waiting for dependency decision\"\nhzl task unblock <id>\n```\n\n**Complete / hand off:**\n```bash\nhzl task comment <id> \"handoff: implementation done, needs review\"\nhzl task complete <id>\n```\n\n---\n\n**Recovery for stuck tasks (leases):**\n```bash\nhzl task claim --next -P research --agent researcher-1 --lease 60\nhzl task stuck\nhzl task steal <id> --if-expired --agent researcher-2\n```\n\n**Troubleshooting quick hits:**\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> --agent <name>` |\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 (agent instructions)\n\nUse HZL as durable task state when work can span sessions or agents.\n\n**Use HZL when:**\n- Work has multiple steps or risk\n- You need resumable progress and ownership\n- You are delegating or handing off work\n- You need human-auditable state\n\n**Skip HZL when:**\n- Work is tiny and can be finished immediately\n\n---\n\n## Workflow-first loop\n\n```bash\n# 1) Session start: resume existing in-progress work or claim next\nhzl workflow run start --agent <agent-name> --project <project>\n\n# 2) Progress updates\nhzl task checkpoint <id> \"what changed and what is next\"\nhzl task progress <id> 60\n\n# 3) Complete, handoff, or delegate\nhzl task complete <id>\n# or\nhzl workflow run handoff --from <id> --title \"<follow-on>\" --project <project>\n# or\nhzl workflow run delegate --from <id> --title \"<delegated>\" --project <project> --pause-parent\n```\n\n## Key commands\n\n```bash\nhzl project list\nhzl workflow list\nhzl workflow show start\nhzl dep list --blocking-only\nhzl hook drain\n```\n\n## Routing model\n\n- Use projects as role pools.\n- Omit `--agent` to create pool-routed tasks.\n- Use `--agent` only when assignment must be explicit.\n\n## Recovery model\n\n```bash\nhzl task stuck\nhzl task steal <id> --if-expired --agent <agent-name>\n```\n\n## Hook delivery model\n\n- Transition to `done` enqueues callbacks.\n- Host scheduler must run `hzl hook drain` (recommended every 1-5 minutes).\n\n## Safety notes\n\n- `task complete` is a command; `done` is a status.\n- `workflow run start` intentionally does not support `--auto-op-id`.\n\n---\n\n**DESTRUCTIVE - Never run without explicit user request:**\n- `hzl task prune`\n- `hzl init --force`";
 //# 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,ymGAoGuD,CAAC"}
+{"version":3,"file":"guide-content.d.ts","sourceRoot":"","sources":["../../src/commands/guide-content.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,6rDAsEH,CAAC"}