@jamesaphoenix/tx-cli 0.4.3

package/dist/help.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Output formatters for JSON/text CLI output
+ */
+import type { TaskWithDeps, LearningWithScore, ContextResult } from "@jamesaphoenix/tx-types";
+export declare function toJson(data: unknown): string;
+export declare function formatTaskWithDeps(t: TaskWithDeps): string;
+export declare function formatTaskLine(t: TaskWithDeps): string;
+export declare function formatReadyTaskLine(t: TaskWithDeps): string;
+export declare function formatContextMarkdown(result: ContextResult): string;
+export declare function formatLearningSearchResult(r: LearningWithScore): string;
+export declare function truncate(str: string, maxLen: number): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAS7F,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAE5C;AAID,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAiB1D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAGtD;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAG3D;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAsBnE;AAID,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAIvE;AAID,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/output.js

@@ -0,0 +1,76 @@
+/**
+ * Output formatters for JSON/text CLI output
+ */
+// --- JSON serializer (handles Date objects) ---
+function jsonReplacer(_key, value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    return value;
+}
+export function toJson(data) {
+    return JSON.stringify(data, jsonReplacer, 2);
+}
+// --- Task formatters ---
+export function formatTaskWithDeps(t) {
+    const lines = [
+        `Task: ${t.id}`,
+        `  Title: ${t.title}`,
+        `  Status: ${t.status}`,
+        `  Score: ${t.score}`,
+        `  Ready: ${t.isReady ? "yes" : "no"}`,
+    ];
+    if (t.description)
+        lines.push(`  Description: ${t.description}`);
+    if (t.parentId)
+        lines.push(`  Parent: ${t.parentId}`);
+    lines.push(`  Blocked by: ${t.blockedBy.length > 0 ? t.blockedBy.join(", ") : "(none)"}`);
+    lines.push(`  Blocks: ${t.blocks.length > 0 ? t.blocks.join(", ") : "(none)"}`);
+    lines.push(`  Children: ${t.children.length > 0 ? t.children.join(", ") : "(none)"}`);
+    lines.push(`  Created: ${t.createdAt.toISOString()}`);
+    lines.push(`  Updated: ${t.updatedAt.toISOString()}`);
+    if (t.completedAt)
+        lines.push(`  Completed: ${t.completedAt.toISOString()}`);
+    return lines.join("\n");
+}
+export function formatTaskLine(t) {
+    const readyMark = t.isReady ? "+" : " ";
+    return `  ${readyMark} ${t.id} [${t.status}] [${t.score}] ${t.title}`;
+}
+export function formatReadyTaskLine(t) {
+    const blocksInfo = t.blocks.length > 0 ? ` (unblocks ${t.blocks.length})` : "";
+    return `  ${t.id} [${t.score}] ${t.title}${blocksInfo}`;
+}
+// --- Context formatter ---
+export function formatContextMarkdown(result) {
+    const lines = [
+        `## Contextual Learnings for ${result.taskId}`,
+        ``,
+        `Task: ${result.taskTitle}`,
+        ``,
+        `### Relevant Learnings`,
+        ``
+    ];
+    if (result.learnings.length === 0) {
+        lines.push("_No relevant learnings found._");
+    }
+    else {
+        for (const l of result.learnings) {
+            const score = (l.relevanceScore * 100).toFixed(0);
+            const category = l.category ? ` [${l.category}]` : "";
+            lines.push(`- **${score}%**${category} ${l.content}`);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+// --- Learning formatters ---
+export function formatLearningSearchResult(r) {
+    const score = (r.relevanceScore * 100).toFixed(0);
+    const category = r.category ? ` [${r.category}]` : "";
+    return `  #${r.id} (${score}%)${category} ${r.content}`;
+}
+// --- Helpers ---
+export function truncate(str, maxLen) {
+    return str.length > maxLen ? str.slice(0, maxLen) + "..." : str;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/utils/parse.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared CLI flag parsing utilities.
+ *
+ * Centralizes numeric flag validation to prevent parseInt/parseFloat NaN bugs.
+ */
+import type { TaskId } from "@jamesaphoenix/tx-types";
+export type Flags = Record<string, string | boolean>;
+/**
+ * Get a string flag value from parsed flags, checking multiple names.
+ * Returns undefined if no matching flag is found or if the flag is boolean.
+ */
+export declare function opt(flags: Flags, ...names: string[]): string | undefined;
+/**
+ * Check if a boolean flag is set, checking multiple names.
+ */
+export declare function flag(flags: Flags, ...names: string[]): boolean;
+/**
+ * Parse an optional integer flag from CLI flags.
+ *
+ * Returns undefined if the flag is not present.
+ * Exits with an error if the value is not a valid integer.
+ *
+ * @example
+ * const limit = parseIntOpt(flags, "limit", "limit", "n") ?? 10
+ * const score = parseIntOpt(flags, "score", "score", "s")
+ */
+export declare function parseIntOpt(flags: Flags, flagName: string, ...names: string[]): number | undefined;
+/**
+ * Parse an optional float flag from CLI flags.
+ *
+ * Returns undefined if the flag is not present.
+ * Exits with an error if the value is not a valid number.
+ *
+ * @example
+ * const minScore = parseFloatOpt(flags, "min-score", "min-score") ?? 0.3
+ */
+export declare function parseFloatOpt(flags: Flags, flagName: string, ...names: string[]): number | undefined;
+/**
+ * Validate a task ID string matches the tx-[a-z0-9]{6,12} format.
+ *
+ * Exits with a clear error if the format is invalid, preventing confusing
+ * "Task not found" errors from reaching the database layer.
+ */
+export declare function parseTaskId(id: string): TaskId;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGrD,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;AAEpD;;;GAGG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAMxE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAE9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,KAAK,EAAE,MAAM,EAAE,GACjB,MAAM,GAAG,SAAS,CASpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,KAAK,EAAE,MAAM,EAAE,GACjB,MAAM,GAAG,SAAS,CASpB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAM9C"}

package/dist/utils/parse.js

@@ -0,0 +1,79 @@
+/**
+ * Shared CLI flag parsing utilities.
+ *
+ * Centralizes numeric flag validation to prevent parseInt/parseFloat NaN bugs.
+ */
+import { isValidTaskId } from "@jamesaphoenix/tx-types";
+/**
+ * Get a string flag value from parsed flags, checking multiple names.
+ * Returns undefined if no matching flag is found or if the flag is boolean.
+ */
+export function opt(flags, ...names) {
+    for (const n of names) {
+        const v = flags[n];
+        if (typeof v === "string")
+            return v;
+    }
+    return undefined;
+}
+/**
+ * Check if a boolean flag is set, checking multiple names.
+ */
+export function flag(flags, ...names) {
+    return names.some(n => flags[n] === true);
+}
+/**
+ * Parse an optional integer flag from CLI flags.
+ *
+ * Returns undefined if the flag is not present.
+ * Exits with an error if the value is not a valid integer.
+ *
+ * @example
+ * const limit = parseIntOpt(flags, "limit", "limit", "n") ?? 10
+ * const score = parseIntOpt(flags, "score", "score", "s")
+ */
+export function parseIntOpt(flags, flagName, ...names) {
+    const val = opt(flags, ...names);
+    if (val === undefined)
+        return undefined;
+    const parsed = parseInt(val, 10);
+    if (!Number.isFinite(parsed)) {
+        console.error(`Invalid value for --${flagName}: "${val}" is not a valid finite number`);
+        process.exit(1);
+    }
+    return parsed;
+}
+/**
+ * Parse an optional float flag from CLI flags.
+ *
+ * Returns undefined if the flag is not present.
+ * Exits with an error if the value is not a valid number.
+ *
+ * @example
+ * const minScore = parseFloatOpt(flags, "min-score", "min-score") ?? 0.3
+ */
+export function parseFloatOpt(flags, flagName, ...names) {
+    const val = opt(flags, ...names);
+    if (val === undefined)
+        return undefined;
+    const parsed = parseFloat(val);
+    if (!Number.isFinite(parsed)) {
+        console.error(`Invalid value for --${flagName}: "${val}" is not a valid finite number`);
+        process.exit(1);
+    }
+    return parsed;
+}
+/**
+ * Validate a task ID string matches the tx-[a-z0-9]{6,12} format.
+ *
+ * Exits with a clear error if the format is invalid, preventing confusing
+ * "Task not found" errors from reaching the database layer.
+ */
+export function parseTaskId(id) {
+    if (!isValidTaskId(id)) {
+        console.error(`Invalid task ID: "${id}". Expected format: tx-[a-z0-9]{6,12}`);
+        process.exit(1);
+    }
+    return id;
+}
+//# sourceMappingURL=parse.js.map

package/dist/utils/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAIvD;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,KAAY,EAAE,GAAG,KAAe;IAClD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QAClB,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,KAAY,EAAE,GAAG,KAAe;IACnD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;AAC3C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,KAAY,EACZ,QAAgB,EAChB,GAAG,KAAe;IAElB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAA;IAChC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,uBAAuB,QAAQ,MAAM,GAAG,gCAAgC,CAAC,CAAA;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAY,EACZ,QAAgB,EAChB,GAAG,KAAe;IAElB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAA;IAChC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACvC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,uBAAuB,QAAQ,MAAM,GAAG,gCAAgC,CAAC,CAAA;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,uCAAuC,CAAC,CAAA;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC"}

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

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

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

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

package/dist/utils/parse.test.js

@@ -0,0 +1,140 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { opt, flag, parseIntOpt, parseFloatOpt } from "./parse.js";
+describe("opt", () => {
+    it("returns string value for matching flag", () => {
+        const flags = { limit: "10", json: true };
+        expect(opt(flags, "limit")).toBe("10");
+    });
+    it("returns undefined for boolean flag", () => {
+        const flags = { json: true };
+        expect(opt(flags, "json")).toBeUndefined();
+    });
+    it("returns undefined for missing flag", () => {
+        const flags = {};
+        expect(opt(flags, "limit")).toBeUndefined();
+    });
+    it("returns first matching flag when multiple names given", () => {
+        const flags = { n: "5" };
+        expect(opt(flags, "limit", "n")).toBe("5");
+    });
+    it("prefers earlier name in list", () => {
+        const flags = { limit: "10", n: "5" };
+        expect(opt(flags, "limit", "n")).toBe("10");
+    });
+});
+describe("flag", () => {
+    it("returns true when flag is set", () => {
+        const flags = { json: true };
+        expect(flag(flags, "json")).toBe(true);
+    });
+    it("returns false when flag is not set", () => {
+        const flags = {};
+        expect(flag(flags, "json")).toBe(false);
+    });
+    it("returns false when flag is a string value", () => {
+        const flags = { json: "true" };
+        expect(flag(flags, "json")).toBe(false);
+    });
+    it("returns true if any name matches", () => {
+        const flags = { h: true };
+        expect(flag(flags, "help", "h")).toBe(true);
+    });
+});
+describe("parseIntOpt", () => {
+    let mockExit;
+    let mockError;
+    beforeEach(() => {
+        mockExit = vi.spyOn(process, "exit").mockImplementation(() => undefined);
+        mockError = vi.spyOn(console, "error").mockImplementation(() => { });
+    });
+    it("returns undefined when flag is not present", () => {
+        const flags = {};
+        expect(parseIntOpt(flags, "limit", "limit", "n")).toBeUndefined();
+    });
+    it("returns parsed integer for valid value", () => {
+        const flags = { limit: "42" };
+        expect(parseIntOpt(flags, "limit", "limit")).toBe(42);
+    });
+    it("returns parsed integer for short alias", () => {
+        const flags = { n: "5" };
+        expect(parseIntOpt(flags, "limit", "limit", "n")).toBe(5);
+    });
+    it("exits with error for non-numeric value", () => {
+        const flags = { limit: "abc" };
+        parseIntOpt(flags, "limit", "limit");
+        expect(mockError).toHaveBeenCalledWith('Invalid value for --limit: "abc" is not a valid finite number');
+        expect(mockExit).toHaveBeenCalledWith(1);
+    });
+    it("exits with error for empty string value", () => {
+        const flags = { limit: "" };
+        parseIntOpt(flags, "limit", "limit");
+        expect(mockExit).toHaveBeenCalledWith(1);
+    });
+    it("parses negative integers", () => {
+        const flags = { score: "-5" };
+        expect(parseIntOpt(flags, "score", "score")).toBe(-5);
+    });
+    it("parses zero", () => {
+        const flags = { limit: "0" };
+        expect(parseIntOpt(flags, "limit", "limit")).toBe(0);
+    });
+    it("truncates floats to integer", () => {
+        const flags = { limit: "3.7" };
+        expect(parseIntOpt(flags, "limit", "limit")).toBe(3);
+    });
+    it("ignores boolean flags", () => {
+        const flags = { limit: true };
+        expect(parseIntOpt(flags, "limit", "limit")).toBeUndefined();
+    });
+});
+describe("parseFloatOpt", () => {
+    let mockExit;
+    let mockError;
+    beforeEach(() => {
+        mockExit = vi.spyOn(process, "exit").mockImplementation(() => undefined);
+        mockError = vi.spyOn(console, "error").mockImplementation(() => { });
+    });
+    it("returns undefined when flag is not present", () => {
+        const flags = {};
+        expect(parseFloatOpt(flags, "score", "score")).toBeUndefined();
+    });
+    it("returns parsed float for valid value", () => {
+        const flags = { score: "0.75" };
+        expect(parseFloatOpt(flags, "score", "score")).toBe(0.75);
+    });
+    it("returns parsed float for integer value", () => {
+        const flags = { "min-score": "3" };
+        expect(parseFloatOpt(flags, "min-score", "min-score")).toBe(3);
+    });
+    it("exits with error for non-numeric value", () => {
+        const flags = { score: "high" };
+        parseFloatOpt(flags, "score", "score");
+        expect(mockError).toHaveBeenCalledWith('Invalid value for --score: "high" is not a valid finite number');
+        expect(mockExit).toHaveBeenCalledWith(1);
+    });
+    it("parses negative floats", () => {
+        const flags = { score: "-0.5" };
+        expect(parseFloatOpt(flags, "score", "score")).toBe(-0.5);
+    });
+    it("parses zero", () => {
+        const flags = { score: "0" };
+        expect(parseFloatOpt(flags, "score", "score")).toBe(0);
+    });
+    it("exits with error for Infinity", () => {
+        const flags = { score: "Infinity" };
+        parseFloatOpt(flags, "score", "score");
+        expect(mockError).toHaveBeenCalledWith('Invalid value for --score: "Infinity" is not a valid finite number');
+        expect(mockExit).toHaveBeenCalledWith(1);
+    });
+    it("exits with error for -Infinity", () => {
+        const flags = { score: "-Infinity" };
+        parseFloatOpt(flags, "score", "score");
+        expect(mockError).toHaveBeenCalledWith('Invalid value for --score: "-Infinity" is not a valid finite number');
+        expect(mockExit).toHaveBeenCalledWith(1);
+    });
+    it("ignores boolean flags", () => {
+        const flags = { score: true };
+        expect(parseFloatOpt(flags, "score", "score")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=parse.test.js.map

package/dist/utils/parse.test.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const CLI_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW,EAAE,MAA+B,CAAA"}

package/dist/version.js

@@ -0,0 +1,10 @@
+/**
+ * CLI version — read from package.json at runtime so there's a single source of truth.
+ */
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dir = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(resolve(__dir, "../package.json"), "utf-8"));
+export const CLI_VERSION = pkg.version ?? "0.0.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACrD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;AAEhF,MAAM,CAAC,MAAM,WAAW,GAAW,GAAG,CAAC,OAAO,IAAI,OAAO,CAAA"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@jamesaphoenix/tx-cli",
+  "version": "0.4.3",
+  "description": "TX command line tool - task management for AI agents and humans",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "types": "./dist/cli.d.ts",
+  "bin": {
+    "tx": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "build:binary": "bun build ./src/cli.ts --compile --outfile dist/tx --minify --external @anthropic-ai/sdk --external openai --external node-llama-cpp --external @node-llama-cpp/*",
+    "build:darwin-arm64": "bun build ./src/cli.ts --compile --outfile dist/tx-darwin-arm64 --target bun-darwin-arm64 --minify --external @anthropic-ai/sdk --external openai --external node-llama-cpp --external @node-llama-cpp/*",
+    "build:darwin-x64": "bun build ./src/cli.ts --compile --outfile dist/tx-darwin-x64 --target bun-darwin-x64 --minify --external @anthropic-ai/sdk --external openai --external node-llama-cpp --external @node-llama-cpp/*",
+    "build:linux-x64": "bun build ./src/cli.ts --compile --outfile dist/tx-linux-x64 --target bun-linux-x64 --minify --external @anthropic-ai/sdk --external openai --external node-llama-cpp --external @node-llama-cpp/*",
+    "build:linux-arm64": "bun build ./src/cli.ts --compile --outfile dist/tx-linux-arm64 --target bun-linux-arm64 --minify --external @anthropic-ai/sdk --external openai --external node-llama-cpp --external @node-llama-cpp/*",
+    "build:all": "bun run build:darwin-arm64 && bun run build:darwin-x64 && bun run build:linux-x64 && bun run build:linux-arm64",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "bun vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "@jamesaphoenix/tx-core": "*",
+    "@jamesaphoenix/tx-test-utils": "*",
+    "@jamesaphoenix/tx-types": "*",
+    "effect": "^3.19.15"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.0",
+    "@types/node": "^25.2.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "tx",
+    "cli",
+    "task-management",
+    "effect-ts"
+  ]
+}