hzl-cli 2.1.0 → 2.3.0

package/dist/output.test.js

@@ -24,6 +24,24 @@ describe('output envelopes', () => {
             },
         });
     });
+    it('creates error envelope with suggestions', () => {
+        const envelope = createErrorEnvelope('not_found', 'Task not found', undefined, [
+            'hzl task list -P demo',
+        ]);
+        expect(envelope).toEqual({
+            schema_version: SCHEMA_VERSION,
+            ok: false,
+            error: {
+                code: 'not_found',
+                message: 'Task not found',
+                suggestions: ['hzl task list -P demo'],
+            },
+        });
+    });
+    it('omits suggestions from error envelope when empty', () => {
+        const envelope = createErrorEnvelope('not_found', 'Task not found');
+        expect(envelope.error).not.toHaveProperty('suggestions');
+    });
     it('prints success envelope in json mode', () => {
         const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
         createFormatter(true).json({ hello: 'world' });

package/dist/output.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.test.js","sourceRoot":"","sources":["../src/output.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,cAAc,EAAE,cAAc;YAC9B,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,eAAe,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QAC1F,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,cAAc,EAAE,cAAc;YAC9B,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,WAAW;gBACpB,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;aAC/B;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrE,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAExC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACtB,cAAc,EAAE,cAAc;YAC9B,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;SACzB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"output.test.js","sourceRoot":"","sources":["../src/output.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,cAAc,EAAE,cAAc;YAC9B,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,eAAe,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QAC1F,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,cAAc,EAAE,cAAc;YAC9B,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,WAAW;gBACpB,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;aAC/B;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE;YAC7E,uBAAuB;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,cAAc,EAAE,cAAc;YAC9B,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,gBAAgB;gBACzB,WAAW,EAAE,CAAC,uBAAuB,CAAC;aACvC;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;QACpE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrE,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAExC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACtB,cAAc,EAAE,cAAc;YAC9B,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;SACzB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,13 @@
+import { TaskStatus } from 'hzl-core/events/types.js';
+interface IntBounds {
+    min?: number;
+    max?: number;
+}
+export declare const TASK_STATUSES: TaskStatus[];
+export declare function parseInteger(raw: string | number, fieldName: string, bounds?: IntBounds): number;
+export declare function parseOptionalInteger(raw: string | number | undefined, fieldName: string, bounds?: IntBounds): number | undefined;
+export declare function parseIntegerWithDefault(raw: string | number | undefined, fieldName: string, defaultValue: number, bounds?: IntBounds): number;
+export declare function parseEnumValue<T extends string>(raw: string | undefined, fieldName: string, allowed: readonly T[]): T | undefined;
+export declare function parseTaskStatus(raw: string | undefined, fieldName?: string): TaskStatus | undefined;
+export {};
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,UAAU,SAAS;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,aAAa,EAAgC,UAAU,EAAE,CAAC;AAevE,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,SAAc,GACrB,MAAM,CA0BR;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,SAAc,GACrB,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,SAAc,GACrB,MAAM,CAGR;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB,CAAC,GAAG,SAAS,CASf;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,SAAW,GAAG,UAAU,GAAG,SAAS,CAErG"}

package/dist/parse.js

@@ -0,0 +1,60 @@
+import { TaskStatus } from 'hzl-core/events/types.js';
+import { CLIError, ExitCode } from './errors.js';
+export const TASK_STATUSES = Object.values(TaskStatus);
+function formatRange(bounds) {
+    if (bounds.min !== undefined && bounds.max !== undefined) {
+        return `an integer between ${bounds.min} and ${bounds.max}`;
+    }
+    if (bounds.min !== undefined) {
+        return `an integer >= ${bounds.min}`;
+    }
+    if (bounds.max !== undefined) {
+        return `an integer <= ${bounds.max}`;
+    }
+    return 'an integer';
+}
+export function parseInteger(raw, fieldName, bounds = {}) {
+    let value;
+    if (typeof raw === 'number') {
+        value = raw;
+    }
+    else {
+        const trimmed = raw.trim();
+        if (!/^-?\d+$/.test(trimmed)) {
+            throw new CLIError(`${fieldName} must be an integer`, ExitCode.InvalidInput);
+        }
+        value = Number(trimmed);
+    }
+    if (!Number.isInteger(value)) {
+        throw new CLIError(`${fieldName} must be an integer`, ExitCode.InvalidInput);
+    }
+    if (bounds.min !== undefined && value < bounds.min) {
+        throw new CLIError(`${fieldName} must be ${formatRange(bounds)}`, ExitCode.InvalidInput);
+    }
+    if (bounds.max !== undefined && value > bounds.max) {
+        throw new CLIError(`${fieldName} must be ${formatRange(bounds)}`, ExitCode.InvalidInput);
+    }
+    return value;
+}
+export function parseOptionalInteger(raw, fieldName, bounds = {}) {
+    if (raw === undefined)
+        return undefined;
+    return parseInteger(raw, fieldName, bounds);
+}
+export function parseIntegerWithDefault(raw, fieldName, defaultValue, bounds = {}) {
+    if (raw === undefined)
+        return parseInteger(defaultValue, fieldName, bounds);
+    return parseInteger(raw, fieldName, bounds);
+}
+export function parseEnumValue(raw, fieldName, allowed) {
+    if (raw === undefined)
+        return undefined;
+    if (!allowed.includes(raw)) {
+        throw new CLIError(`Invalid ${fieldName}: ${raw}. Must be one of: ${allowed.join(', ')}`, ExitCode.InvalidInput);
+    }
+    return raw;
+}
+export function parseTaskStatus(raw, fieldName = 'status') {
+    return parseEnumValue(raw, fieldName, TASK_STATUSES);
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/dist/parse.test.d.ts

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

package/dist/parse.test.d.ts.map

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

package/dist/parse.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect } from 'vitest';
+import { parseEnumValue, parseInteger, parseIntegerWithDefault, parseOptionalInteger, parseTaskStatus } from './parse.js';
+import { TaskStatus } from 'hzl-core/events/types.js';
+describe('parseInteger', () => {
+    it('parses integer strings', () => {
+        expect(parseInteger('42', 'Limit')).toBe(42);
+    });
+    it('rejects non-integers', () => {
+        expect(() => parseInteger('4.2', 'Limit')).toThrow(/must be an integer/);
+        expect(() => parseInteger('abc', 'Limit')).toThrow(/must be an integer/);
+    });
+    it('applies bounds', () => {
+        expect(parseInteger('3', 'Priority', { min: 0, max: 3 })).toBe(3);
+        expect(() => parseInteger('-1', 'Priority', { min: 0, max: 3 })).toThrow(/between 0 and 3/);
+        expect(() => parseInteger('4', 'Priority', { min: 0, max: 3 })).toThrow(/between 0 and 3/);
+    });
+});
+describe('parseOptionalInteger', () => {
+    it('returns undefined for missing values', () => {
+        expect(parseOptionalInteger(undefined, 'Lease')).toBeUndefined();
+    });
+    it('parses provided values', () => {
+        expect(parseOptionalInteger('15', 'Lease', { min: 1 })).toBe(15);
+    });
+});
+describe('parseIntegerWithDefault', () => {
+    it('uses default when undefined', () => {
+        expect(parseIntegerWithDefault(undefined, 'Limit', 20, { min: 1 })).toBe(20);
+    });
+    it('uses provided value when present', () => {
+        expect(parseIntegerWithDefault('10', 'Limit', 20, { min: 1 })).toBe(10);
+    });
+});
+describe('parseEnumValue', () => {
+    it('returns undefined when value is missing', () => {
+        expect(parseEnumValue(undefined, 'mode', ['a', 'b'])).toBeUndefined();
+    });
+    it('parses allowed values', () => {
+        expect(parseEnumValue('a', 'mode', ['a', 'b'])).toBe('a');
+    });
+    it('rejects unknown values', () => {
+        expect(() => parseEnumValue('c', 'mode', ['a', 'b'])).toThrow(/Invalid mode/);
+    });
+});
+describe('parseTaskStatus', () => {
+    it('parses valid status', () => {
+        expect(parseTaskStatus(TaskStatus.Ready)).toBe(TaskStatus.Ready);
+    });
+    it('rejects invalid status', () => {
+        expect(() => parseTaskStatus('running')).toThrow(/Invalid status/);
+    });
+});
+//# sourceMappingURL=parse.test.js.map

package/dist/parse.test.js.map

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

package/dist/resolve-id.js

@@ -9,13 +9,13 @@ export function resolveId(services, idOrPrefix) {
     try {
         const resolved = services.taskService.resolveTaskId(idOrPrefix);
         if (resolved === null) {
-            throw new CLIError(`Task not found: ${idOrPrefix}`, ExitCode.NotFound);
+            throw new CLIError(`Task not found: ${idOrPrefix}`, ExitCode.NotFound, undefined, undefined, ['hzl task list']);
         }
         return resolved;
     }
     catch (e) {
         if (e instanceof AmbiguousPrefixError) {
-            throw new CLIError(e.message, ExitCode.InvalidInput);
+            throw new CLIError(e.message, ExitCode.InvalidInput, undefined, undefined, e.matches.slice(0, 5).map(m => `hzl task show ${m.task_id}`));
         }
         throw e;
     }

package/dist/resolve-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-id.js","sourceRoot":"","sources":["../src/resolve-id.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAkB,EAAE,UAAkB;IAC9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAChE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,QAAQ,CAAC,mBAAmB,UAAU,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,oBAAoB,EAAE,CAAC;YACtC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}
+{"version":3,"file":"resolve-id.js","sourceRoot":"","sources":["../src/resolve-id.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAkB,EAAE,UAAkB;IAC9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAChE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,QAAQ,CAAC,mBAAmB,UAAU,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;QAClH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,oBAAoB,EAAE,CAAC;YACtC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3I,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}

package/dist/strip-empty.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Strip top-level empty arrays and empty objects from a record.
+ * Keeps nulls, scalars, non-empty arrays, and non-empty objects.
+ * Does not recurse — only strips at the top level.
+ */
+export declare function stripEmptyCollections<T extends object>(obj: T): Partial<T>;
+//# sourceMappingURL=strip-empty.d.ts.map

package/dist/strip-empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-empty.d.ts","sourceRoot":"","sources":["../src/strip-empty.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ1E"}

package/dist/strip-empty.js

@@ -0,0 +1,17 @@
+/**
+ * Strip top-level empty arrays and empty objects from a record.
+ * Keeps nulls, scalars, non-empty arrays, and non-empty objects.
+ * Does not recurse — only strips at the top level.
+ */
+export function stripEmptyCollections(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (Array.isArray(value) && value.length === 0)
+            continue;
+        if (value !== null && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length === 0)
+            continue;
+        result[key] = value;
+    }
+    return result;
+}
+//# sourceMappingURL=strip-empty.js.map

package/dist/strip-empty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-empty.js","sourceRoot":"","sources":["../src/strip-empty.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAmB,GAAM;IAC5D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjJ,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAoB,CAAC;AAC9B,CAAC"}

package/dist/strip-empty.test.d.ts

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

package/dist/strip-empty.test.d.ts.map

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

package/dist/strip-empty.test.js

@@ -0,0 +1,26 @@
+import { describe, it, expect } from 'vitest';
+import { stripEmptyCollections } from './strip-empty.js';
+describe('stripEmptyCollections', () => {
+    it('strips empty arrays', () => {
+        expect(stripEmptyCollections({ tags: [], title: 'foo' })).toEqual({ title: 'foo' });
+    });
+    it('strips empty objects', () => {
+        expect(stripEmptyCollections({ metadata: {}, title: 'foo' })).toEqual({ title: 'foo' });
+    });
+    it('keeps non-empty arrays', () => {
+        expect(stripEmptyCollections({ tags: ['a'], title: 'foo' })).toEqual({ tags: ['a'], title: 'foo' });
+    });
+    it('keeps non-empty objects', () => {
+        expect(stripEmptyCollections({ metadata: { k: 'v' }, title: 'foo' })).toEqual({ metadata: { k: 'v' }, title: 'foo' });
+    });
+    it('keeps null values', () => {
+        expect(stripEmptyCollections({ agent: null, title: 'foo' })).toEqual({ agent: null, title: 'foo' });
+    });
+    it('keeps scalar values', () => {
+        expect(stripEmptyCollections({ priority: 0, done: false, title: '' })).toEqual({ priority: 0, done: false, title: '' });
+    });
+    it('does not recurse into nested objects', () => {
+        expect(stripEmptyCollections({ nested: { tags: [] } })).toEqual({ nested: { tags: [] } });
+    });
+});
+//# sourceMappingURL=strip-empty.test.js.map

package/dist/strip-empty.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-empty.test.js","sourceRoot":"","sources":["../src/strip-empty.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,qBAAqB,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,qBAAqB,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACxH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,qBAAqB,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1H,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hzl-cli",
-  "version": "2.1.0",
+  "version": "2.3.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": "^4.3.6",
-    "hzl-core": "2.1.0",
-    "hzl-web": "2.1.0"
+    "hzl-core": "2.3.0",
+    "hzl-web": "2.3.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
@@ -75,6 +75,8 @@
     "build": "tsc -b",
     "pretest": "node ../../scripts/generate-guide-content.js",
     "test": "vitest run",
+    "pretest:ci": "node ../../scripts/generate-guide-content.js",
+    "test:ci": "vitest run --coverage",
     "test:watch": "vitest"
   }
 }