@fanzie/task-cli 0.1.1

package/README.md

@@ -0,0 +1,55 @@
+# @fanzie/task-cli
+
+CLI tool for managing Feature/UserStory/AC task hierarchies in Feishu Bitable.
+
+## Install
+
+```bash
+npm install -g @fanzie/task-cli
+```
+
+## Setup
+
+```bash
+fz-task-cli auth init
+```
+
+## Commands
+
+### Feature
+
+- `fz-task-cli feature add <title>` — Create a Feature
+- `fz-task-cli feature add --json '{"title":"x","priority":"P0"}'` — Create with fields
+- `fz-task-cli feature list` — List all Features
+- `fz-task-cli feature get <id>` — Get Feature detail + child Stories
+- `fz-task-cli feature update <id> --status TEST_SPEC` — Update fields
+- `fz-task-cli feature delete <id>` — Delete (no children required)
+
+### Story
+
+- `fz-task-cli story add <title> --feature <id>` — Create under Feature
+- `fz-task-cli story list [--feature <id>]` — List Stories
+- `fz-task-cli story get <id>` — Get Story + child ACs
+- `fz-task-cli story update <id> --status DOING` — Update
+- `fz-task-cli story delete <id>` — Delete (no child ACs required)
+
+### AC (Acceptance Criteria)
+
+- `fz-task-cli ac add <title> --story <id>` — Create under Story
+- `fz-task-cli ac list [--story <id>]` — List ACs
+- `fz-task-cli ac get <id>` — Get AC detail
+- `fz-task-cli ac update <id> --status TESTING` — Update
+- `fz-task-cli ac delete <id>` — Delete
+
+### Options
+
+- `--format json` — JSON output
+- `--profile <name>` — Config profile
+
+## Status Flow
+
+```
+TODO → TEST_SPEC → DOING → TESTING → VERIFIED → DONE
+         ↕           ↕        ↕          ↕
+                    BLOCKED (from any, except DONE)
+```

package/dist/cli.js

@@ -0,0 +1,598 @@
+#!/usr/bin/env node
+import { Command as e } from "commander";
+import * as t from "node:readline";
+import * as n from "node:fs";
+import * as r from "node:path";
+import * as i from "node:os";
+import * as a from "js-yaml";
+import * as o from "@larksuiteoapi/node-sdk";
+//#region src/config.ts
+var s = r.join(i.homedir(), ".config", "fz-task"), c = r.join(s, "config.yaml"), l = r.join(s, ".env");
+function u(e) {
+	let t = new URL(e), n = t.pathname.split("/").filter(Boolean), r = n.indexOf("wiki"), i = n.indexOf("base"), a = r === -1 ? i : r;
+	if (a === -1 || a + 1 >= n.length) throw Error(`Invalid bitable URL: cannot extract appToken from ${e}`);
+	let o = n[a + 1], s = t.searchParams.get("table");
+	if (!s) throw Error(`Invalid bitable URL: missing table parameter in ${e}`);
+	return {
+		appToken: o,
+		tableId: s
+	};
+}
+function d(e, t) {
+	return e.replace(/\$\{(\w+)\}/g, (e, n) => t[n] ?? e);
+}
+function f(e) {
+	let t = e ?? l, r = {};
+	if (!n.existsSync(t)) return r;
+	let i = n.readFileSync(t, "utf-8");
+	for (let e of i.split("\n")) {
+		let t = e.trim();
+		if (!t || t.startsWith("#")) continue;
+		let n = t.indexOf("=");
+		if (n === -1) continue;
+		let i = t.slice(0, n).trim();
+		r[i] = t.slice(n + 1).trim();
+	}
+	return r;
+}
+function p() {
+	let e = f(r.join(process.cwd(), ".env")), t = f(), i = {
+		...process.env,
+		...t,
+		...e
+	};
+	if (!n.existsSync(c)) return null;
+	let o = n.readFileSync(c, "utf-8"), s = a.load(o);
+	if (!s?.profiles) return null;
+	let l = {
+		profiles: {},
+		defaultProfile: s.defaultProfile ?? "default"
+	};
+	for (let [e, t] of Object.entries(s.profiles)) {
+		let n = t;
+		l.profiles[e] = {
+			auth: {
+				appId: d(n.auth?.appId ?? "", i),
+				appSecret: d(n.auth?.appSecret ?? "", i)
+			},
+			bitable: {
+				url: n.bitable?.url ?? "",
+				appToken: n.bitable?.appToken ?? "",
+				tableId: n.bitable?.tableId ?? ""
+			}
+		};
+	}
+	return l;
+}
+function m(e, t) {
+	let n = t ?? process.env.FZ_TASK_PROFILE ?? e.defaultProfile, r = e.profiles[n];
+	if (!r) throw Error(`Profile "${n}" not found. Available: ${Object.keys(e.profiles).join(", ")}`);
+	return r;
+}
+function h() {
+	n.mkdirSync(s, { recursive: !0 });
+}
+function g(e) {
+	h();
+	let t = a.dump(e);
+	n.writeFileSync(c, t, "utf-8");
+}
+function _(e, t) {
+	h();
+	let r = `FZ_TASK_APP_ID=${e}\nFZ_TASK_APP_SECRET=${t}\n`;
+	n.writeFileSync(l, r, "utf-8");
+}
+//#endregion
+//#region src/client.ts
+function v(e) {
+	let t = {};
+	return e.title !== void 0 && (t.Text = e.title), e.type !== void 0 && (t.type = e.type), e.status !== void 0 && (t.status = e.status), e.parent !== void 0 && (t.parent = e.parent), e.doc_url !== void 0 && (t.doc_url = {
+		link: e.doc_url,
+		text: e.doc_url
+	}), e.assignee !== void 0 && (t.assignee = e.assignee), e.description !== void 0 && (t.description = e.description), e.previous_status !== void 0 && (t.previous_status = e.previous_status), e.priority !== void 0 && (t.priority = e.priority), t;
+}
+function y(e) {
+	let t = e.fields, n, r = t.parent;
+	if (Array.isArray(r) && r.length > 0) {
+		let e = r[0];
+		e.record_ids?.length > 0 && (n = e.record_ids);
+	}
+	let i;
+	return typeof t.doc_url == "object" && t.doc_url !== null ? i = t.doc_url.link : typeof t.doc_url == "string" && (i = t.doc_url), {
+		record_id: e.record_id,
+		fields: {
+			title: t.Text ?? "",
+			type: t.type,
+			status: t.status,
+			parent: n,
+			priority: t.priority,
+			doc_url: i,
+			assignee: t.assignee,
+			description: t.description,
+			previous_status: t.previous_status
+		}
+	};
+}
+var b = class {
+	larkClient;
+	appToken;
+	tableId;
+	constructor(e) {
+		this.appToken = e.appToken, this.tableId = e.tableId, this.larkClient = new o.Client({
+			appId: e.appId,
+			appSecret: e.appSecret,
+			appType: o.AppType.SelfBuild,
+			domain: o.Domain.Feishu
+		});
+	}
+	async createRecord(e) {
+		let t = v(e), n = await this.larkClient.bitable.appTableRecord.create({
+			path: {
+				app_token: this.appToken,
+				table_id: this.tableId
+			},
+			data: { fields: t }
+		});
+		if (n.code !== 0) throw Error(`createRecord failed: ${n.msg}`);
+		let r = n.data?.record;
+		if (!r) throw Error("createRecord: no record in response");
+		return y(r);
+	}
+	async getRecord(e) {
+		let t = await this.larkClient.bitable.appTableRecord.get({ path: {
+			app_token: this.appToken,
+			table_id: this.tableId,
+			record_id: e
+		} });
+		if (t.code !== 0) throw Error(`getRecord failed: ${t.msg}`);
+		let n = t.data?.record;
+		if (!n) throw Error("getRecord: no record in response");
+		return y(n);
+	}
+	async listRecords(e) {
+		let t = [];
+		e?.type && t.push(`CurrentValue.[type] = "${e.type}"`), e?.status && t.push(`CurrentValue.[status] = "${e.status}"`);
+		let n = t.length > 0 ? t.length === 1 ? t[0] : `AND(${t.join(",")})` : void 0, r = [], i;
+		do {
+			let e = { page_size: 500 };
+			n && (e.filter = n), i && (e.page_token = i);
+			let t = await this.larkClient.bitable.appTableRecord.list({
+				path: {
+					app_token: this.appToken,
+					table_id: this.tableId
+				},
+				params: e
+			});
+			if (t.code !== 0) throw Error(`listRecords failed: ${t.msg}`);
+			let a = t.data?.items ?? [];
+			for (let e of a) r.push(y(e));
+			i = t.data?.has_more ? t.data.page_token : void 0;
+		} while (i);
+		return r;
+	}
+	async updateRecord(e, t) {
+		let n = v(t), r = await this.larkClient.bitable.appTableRecord.update({
+			path: {
+				app_token: this.appToken,
+				table_id: this.tableId,
+				record_id: e
+			},
+			data: { fields: n }
+		});
+		if (r.code !== 0) throw Error(`updateRecord failed: ${r.msg}`);
+		let i = r.data?.record;
+		if (!i) throw Error("updateRecord: no record in response");
+		return y(i);
+	}
+	async deleteRecord(e) {
+		let t = await this.larkClient.bitable.appTableRecord.delete({ path: {
+			app_token: this.appToken,
+			table_id: this.tableId,
+			record_id: e
+		} });
+		if (t.code !== 0) throw Error(`deleteRecord failed: ${t.msg}`);
+	}
+	async getChildren(e) {
+		return (await this.listRecords()).filter((t) => Array.isArray(t.fields.parent) && t.fields.parent.includes(e));
+	}
+};
+//#endregion
+//#region src/commands/auth.ts
+function x(e) {
+	let n = t.createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	return new Promise((t) => {
+		n.question(e, (e) => {
+			n.close(), t(e.trim());
+		});
+	});
+}
+function S(e) {
+	let t = e.command("auth").description("Authentication management");
+	t.command("status").description("Show current config and connection status").action(async () => {
+		let t = p();
+		t || (console.error("No config found. Run `fz-task-cli auth init` to set up."), process.exit(3));
+		try {
+			let n = e.opts().profile ?? t.defaultProfile, r = m(t, e.opts().profile);
+			console.log(`Profile:    ${n}`), console.log(`App ID:     ${r.auth.appId.slice(0, 6)}...${r.auth.appId.slice(-4)}`), console.log(`App Token:  ${r.bitable.appToken}`), console.log(`Table ID:   ${r.bitable.tableId}`), console.log("Status:     OK");
+		} catch (e) {
+			console.error(e.message), process.exit(3);
+		}
+	}), t.command("init").description("Interactive setup").action(async () => {
+		let e = await x("Feishu App ID: "), t = await x("Feishu App Secret: "), n = await x("Bitable URL: "), r, i;
+		try {
+			({appToken: r, tableId: i} = u(n));
+		} catch (e) {
+			console.error(`URL parsing failed: ${e.message}`), process.exit(2);
+		}
+		g({
+			profiles: { default: {
+				auth: {
+					appId: "${FZ_TASK_APP_ID}",
+					appSecret: "${FZ_TASK_APP_SECRET}"
+				},
+				bitable: {
+					url: n,
+					appToken: r,
+					tableId: i
+				}
+			} },
+			defaultProfile: "default"
+		}), _(e, t), console.log("Config written to ~/.config/fz-task/config.yaml"), console.log("Credentials written to ~/.config/fz-task/.env"), console.log(`App Token: ${r}`), console.log(`Table ID:  ${i}`), console.log("Verifying connection...");
+		try {
+			await new b({
+				appId: e,
+				appSecret: t,
+				appToken: r,
+				tableId: i
+			}).listRecords({ type: "Feature" }), console.log("Connection verified successfully!");
+		} catch (e) {
+			console.error(`Connection failed: ${e.message}`), process.exit(3);
+		}
+	});
+}
+//#endregion
+//#region src/types.ts
+var C = [
+	"TODO",
+	"TEST_SPEC",
+	"DOING",
+	"TESTING",
+	"VERIFIED",
+	"DONE"
+], w = new Map(C.map((e, t) => [e, t]));
+function T(e, t) {
+	if (e === "DONE") return !1;
+	if (t === "BLOCKED" || e === "BLOCKED") return !0;
+	let n = w.get(e), r = w.get(t);
+	return n === void 0 || r === void 0 ? !1 : r === n + 1 || r === n - 1;
+}
+function E(e) {
+	if (e === "DONE") return [];
+	if (e === "BLOCKED") return [...C];
+	let t = w.get(e);
+	if (t === void 0) return [];
+	let n = [];
+	return t > 0 && n.push(C[t - 1]), t < C.length - 1 && n.push(C[t + 1]), n.push("BLOCKED"), n;
+}
+//#endregion
+//#region src/formatter.ts
+function D(e, t, n) {
+	if (n === "json") return JSON.stringify({
+		...e,
+		children: t
+	}, null, 2);
+	let r = [];
+	if (r.push(`ID:          ${e.record_id}`), r.push(`Title:       ${e.fields.title}`), r.push(`Type:        ${e.fields.type}`), r.push(`Status:      ${e.fields.status}`), e.fields.priority && r.push(`Priority:    ${e.fields.priority}`), e.fields.assignee && r.push(`Assignee:    ${e.fields.assignee}`), e.fields.doc_url && r.push(`Doc URL:     ${e.fields.doc_url}`), e.fields.description && r.push(`Description: ${e.fields.description}`), t.length > 0) {
+		let n = e.fields.type === "Feature" ? "Stories" : "ACs";
+		r.push(""), r.push(`Children (${t.length} ${n}):`);
+		for (let e of t) r.push(`  ${e.record_id}  [${e.fields.status}]  ${e.fields.title}`);
+	}
+	return r.join("\n");
+}
+function O(e, t) {
+	if (t === "json") return JSON.stringify(e, null, 2);
+	if (e.length === 0) return "No records found.";
+	let n = [];
+	n.push("ID	Type	Status	Priority	Title"), n.push("-".repeat(80));
+	for (let t of e) n.push(`${t.record_id}\t${t.fields.type}\t${t.fields.status}\t${t.fields.priority ?? "-"}\t${t.fields.title}`);
+	return n.join("\n");
+}
+//#endregion
+//#region src/commands/feature.ts
+function k(e) {
+	let t = p();
+	t || (console.error("No config found. Run `fz-task-cli auth init` to set up."), process.exit(3));
+	let n = m(t, e.parent?.opts().profile);
+	return new b({
+		appId: n.auth.appId,
+		appSecret: n.auth.appSecret,
+		appToken: n.bitable.appToken,
+		tableId: n.bitable.tableId
+	});
+}
+function A(e) {
+	return e.parent?.opts().format ?? "table";
+}
+function j(e) {
+	let t = e.command("feature").description("Feature management commands");
+	t.command("add [title]").description("Create a new Feature").option("--json <json>", "JSON string with fields").action(async (e, n, r) => {
+		let i = k(t), a = A(t), o = {};
+		if (n.json) try {
+			o = JSON.parse(n.json);
+		} catch {
+			console.error("Invalid JSON provided."), process.exit(2);
+		}
+		e && (o.title = e), o.title || (console.error("Title is required. Provide as argument or in --json."), process.exit(2)), o.type = "Feature", o.status ||= "TODO";
+		try {
+			let e = await i.createRecord(o);
+			console.log(D(e, [], a));
+		} catch (e) {
+			console.error(`Failed to create feature: ${e.message}`), process.exit(1);
+		}
+	}), t.command("list").description("List all Features").action(async (e, n) => {
+		let r = k(t), i = A(t);
+		try {
+			let e = await r.listRecords({ type: "Feature" });
+			console.log(O(e, i));
+		} catch (e) {
+			console.error(`Failed to list features: ${e.message}`), process.exit(1);
+		}
+	}), t.command("get <id>").description("Get a Feature by ID").action(async (e, n, r) => {
+		let i = k(t), a = A(t), o;
+		try {
+			o = await i.getRecord(e);
+		} catch (e) {
+			console.error(`Record not found: ${e.message}`), process.exit(4);
+		}
+		o.fields.type !== "Feature" && (console.error(`Record ${e} is not a Feature (type: ${o.fields.type}).`), process.exit(2));
+		try {
+			let t = await i.getChildren(e);
+			console.log(D(o, t, a));
+		} catch (e) {
+			console.error(`Failed to get children: ${e.message}`), process.exit(1);
+		}
+	}), t.command("update <id>").description("Update a Feature").option("--status <status>", "New status").option("--priority <priority>", "New priority").option("--assignee <assignee>", "New assignee").option("--doc-url <url>", "New doc URL").option("--title <title>", "New title").option("--description <description>", "New description").action(async (e, n, r) => {
+		let i = k(t), a = A(t), o;
+		try {
+			o = await i.getRecord(e);
+		} catch (e) {
+			console.error(`Record not found: ${e.message}`), process.exit(4);
+		}
+		o.fields.type !== "Feature" && (console.error(`Record ${e} is not a Feature (type: ${o.fields.type}).`), process.exit(2));
+		let s = {};
+		if (n.status) {
+			let e = n.status, t = o.fields.status;
+			if (!T(t, e)) {
+				let n = E(t);
+				console.error(`Invalid status transition: ${t} -> ${e}. Allowed: ${n.join(", ")}`), process.exit(2);
+			}
+			s.status = e, e === "BLOCKED" && (s.previous_status = t), t === "BLOCKED" && (s.previous_status = void 0);
+		}
+		n.priority && (s.priority = n.priority), n.assignee && (s.assignee = n.assignee), n.docUrl && (s.doc_url = n.docUrl), n.title && (s.title = n.title), n.description && (s.description = n.description);
+		try {
+			let t = await i.updateRecord(e, s), n = await i.getChildren(e);
+			console.log(D(t, n, a));
+		} catch (e) {
+			console.error(`Failed to update feature: ${e.message}`), process.exit(1);
+		}
+	}), t.command("delete <id>").description("Delete a Feature").action(async (e, n, r) => {
+		let i = k(t), a;
+		try {
+			a = await i.getRecord(e);
+		} catch (e) {
+			console.error(`Record not found: ${e.message}`), process.exit(4);
+		}
+		a.fields.type !== "Feature" && (console.error(`Record ${e} is not a Feature (type: ${a.fields.type}).`), process.exit(2));
+		let o = await i.getChildren(e);
+		o.length > 0 && (console.error(`Cannot delete Feature ${e}: has ${o.length} child stories. Delete children first.`), process.exit(2));
+		try {
+			await i.deleteRecord(e), console.log(`Feature ${e} deleted.`);
+		} catch (e) {
+			console.error(`Failed to delete feature: ${e.message}`), process.exit(1);
+		}
+	});
+}
+//#endregion
+//#region src/commands/story.ts
+function M(e) {
+	let t = p();
+	t || (console.error("No config found. Run `fz-task-cli auth init` to set up."), process.exit(3));
+	let n = m(t, e.parent?.opts().profile);
+	return new b({
+		appId: n.auth.appId,
+		appSecret: n.auth.appSecret,
+		appToken: n.bitable.appToken,
+		tableId: n.bitable.tableId
+	});
+}
+function N(e) {
+	return e.parent?.opts().format ?? "table";
+}
+function P(e) {
+	let t = e.command("story").description("UserStory management commands");
+	t.command("add [title]").description("Create a new UserStory under a Feature").requiredOption("--feature <id>", "Parent Feature record ID").option("--json <json>", "JSON string with fields").action(async (e, n, r) => {
+		let i = M(t), a = N(t), o;
+		try {
+			o = await i.getRecord(n.feature);
+		} catch (e) {
+			console.error(`Feature not found: ${e.message}`), process.exit(4);
+		}
+		o.fields.type !== "Feature" && (console.error(`Record ${n.feature} is not a Feature (type: ${o.fields.type}).`), process.exit(2));
+		let s = {};
+		if (n.json) try {
+			s = JSON.parse(n.json);
+		} catch {
+			console.error("Invalid JSON provided."), process.exit(2);
+		}
+		e && (s.title = e), s.title || (console.error("Title is required. Provide as argument or in --json."), process.exit(2)), s.type = "UserStory", s.parent = [n.feature], s.status ||= "TODO";
+		try {
+			let e = await i.createRecord(s);
+			console.log(D(e, [], a));
+		} catch (e) {
+			console.error(`Failed to create story: ${e.message}`), process.exit(1);
+		}
+	}), t.command("list").description("List UserStories, optionally filtered by Feature").option("--feature <id>", "Parent Feature record ID to filter by").action(async (e, n) => {
+		let r = M(t), i = N(t);
+		try {
+			let t;
+			t = e.feature ? (await r.getChildren(e.feature)).filter((e) => e.fields.type === "UserStory") : await r.listRecords({ type: "UserStory" }), console.log(O(t, i));
+		} catch (e) {
+			console.error(`Failed to list stories: ${e.message}`), process.exit(1);
+		}
+	}), t.command("get <id>").description("Get a UserStory by ID").action(async (e, n, r) => {
+		let i = M(t), a = N(t), o;
+		try {
+			o = await i.getRecord(e);
+		} catch (e) {
+			console.error(`Record not found: ${e.message}`), process.exit(4);
+		}
+		o.fields.type !== "UserStory" && (console.error(`Record ${e} is not a UserStory (type: ${o.fields.type}).`), process.exit(2));
+		try {
+			let t = await i.getChildren(e);
+			console.log(D(o, t, a));
+		} catch (e) {
+			console.error(`Failed to get children: ${e.message}`), process.exit(1);
+		}
+	}), t.command("update <id>").description("Update a UserStory").option("--status <status>", "New status").option("--priority <priority>", "New priority").option("--assignee <assignee>", "New assignee").option("--doc-url <url>", "New doc URL").option("--title <title>", "New title").option("--description <description>", "New description").action(async (e, n, r) => {
+		let i = M(t), a = N(t), o;
+		try {
+			o = await i.getRecord(e);
+		} catch (e) {
+			console.error(`Record not found: ${e.message}`), process.exit(4);
+		}
+		o.fields.type !== "UserStory" && (console.error(`Record ${e} is not a UserStory (type: ${o.fields.type}).`), process.exit(2));
+		let s = {};
+		if (n.status) {
+			let e = n.status, t = o.fields.status;
+			if (!T(t, e)) {
+				let n = E(t);
+				console.error(`Invalid status transition: ${t} -> ${e}. Allowed: ${n.join(", ")}`), process.exit(2);
+			}
+			s.status = e, e === "BLOCKED" && (s.previous_status = t), t === "BLOCKED" && (s.previous_status = void 0);
+		}
+		n.priority && (s.priority = n.priority), n.assignee && (s.assignee = n.assignee), n.docUrl && (s.doc_url = n.docUrl), n.title && (s.title = n.title), n.description && (s.description = n.description);
+		try {
+			let t = await i.updateRecord(e, s), n = await i.getChildren(e);
+			console.log(D(t, n, a));
+		} catch (e) {
+			console.error(`Failed to update story: ${e.message}`), process.exit(1);
+		}
+	}), t.command("delete <id>").description("Delete a UserStory").action(async (e, n, r) => {
+		let i = M(t), a;
+		try {
+			a = await i.getRecord(e);
+		} catch (e) {
+			console.error(`Record not found: ${e.message}`), process.exit(4);
+		}
+		a.fields.type !== "UserStory" && (console.error(`Record ${e} is not a UserStory (type: ${a.fields.type}).`), process.exit(2));
+		let o = await i.getChildren(e);
+		o.length > 0 && (console.error(`Cannot delete UserStory ${e}: has ${o.length} child ACs. Delete children first.`), process.exit(2));
+		try {
+			await i.deleteRecord(e), console.log(`UserStory ${e} deleted.`);
+		} catch (e) {
+			console.error(`Failed to delete story: ${e.message}`), process.exit(1);
+		}
+	});
+}
+//#endregion
+//#region src/commands/ac.ts
+function F(e) {
+	let t = p();
+	t || (console.error("No config found. Run `fz-task-cli auth init` to set up."), process.exit(3));
+	let n = m(t, e.parent?.opts().profile);
+	return new b({
+		appId: n.auth.appId,
+		appSecret: n.auth.appSecret,
+		appToken: n.bitable.appToken,
+		tableId: n.bitable.tableId
+	});
+}
+function I(e) {
+	return e.parent?.opts().format ?? "table";
+}
+function L(e) {
+	let t = e.command("ac").description("AC (Acceptance Criteria) management commands");
+	t.command("add [title]").description("Create a new AC under a UserStory").requiredOption("--story <id>", "Parent UserStory record ID").option("--json <json>", "JSON string with fields").action(async (e, n, r) => {
+		let i = F(t), a = I(t), o;
+		try {
+			o = await i.getRecord(n.story);
+		} catch (e) {
+			console.error(`UserStory not found: ${e.message}`), process.exit(4);
+		}
+		o.fields.type !== "UserStory" && (console.error(`Record ${n.story} is not a UserStory (type: ${o.fields.type}).`), process.exit(2));
+		let s = {};
+		if (n.json) try {
+			s = JSON.parse(n.json);
+		} catch {
+			console.error("Invalid JSON provided."), process.exit(2);
+		}
+		e && (s.title = e), s.title || (console.error("Title is required. Provide as argument or in --json."), process.exit(2)), s.type = "AC", s.parent = [n.story], s.status ||= "TODO";
+		try {
+			let e = await i.createRecord(s);
+			console.log(D(e, [], a));
+		} catch (e) {
+			console.error(`Failed to create AC: ${e.message}`), process.exit(1);
+		}
+	}), t.command("list").description("List ACs, optionally filtered by UserStory").option("--story <id>", "Parent UserStory record ID to filter by").action(async (e, n) => {
+		let r = F(t), i = I(t);
+		try {
+			let t;
+			t = e.story ? (await r.getChildren(e.story)).filter((e) => e.fields.type === "AC") : await r.listRecords({ type: "AC" }), console.log(O(t, i));
+		} catch (e) {
+			console.error(`Failed to list ACs: ${e.message}`), process.exit(1);
+		}
+	}), t.command("get <id>").description("Get an AC by ID").action(async (e, n, r) => {
+		let i = F(t), a = I(t), o;
+		try {
+			o = await i.getRecord(e);
+		} catch (e) {
+			console.error(`Record not found: ${e.message}`), process.exit(4);
+		}
+		o.fields.type !== "AC" && (console.error(`Record ${e} is not an AC (type: ${o.fields.type}).`), process.exit(2)), console.log(D(o, [], a));
+	}), t.command("update <id>").description("Update an AC").option("--status <status>", "New status").option("--priority <priority>", "New priority").option("--assignee <assignee>", "New assignee").option("--doc-url <url>", "New doc URL").option("--title <title>", "New title").option("--description <description>", "New description").action(async (e, n, r) => {
+		let i = F(t), a = I(t), o;
+		try {
+			o = await i.getRecord(e);
+		} catch (e) {
+			console.error(`Record not found: ${e.message}`), process.exit(4);
+		}
+		o.fields.type !== "AC" && (console.error(`Record ${e} is not an AC (type: ${o.fields.type}).`), process.exit(2));
+		let s = {};
+		if (n.status) {
+			let e = n.status, t = o.fields.status;
+			if (!T(t, e)) {
+				let n = E(t);
+				console.error(`Invalid status transition: ${t} -> ${e}. Allowed: ${n.join(", ")}`), process.exit(2);
+			}
+			s.status = e, e === "BLOCKED" && (s.previous_status = t), t === "BLOCKED" && (s.previous_status = void 0);
+		}
+		n.priority && (s.priority = n.priority), n.assignee && (s.assignee = n.assignee), n.docUrl && (s.doc_url = n.docUrl), n.title && (s.title = n.title), n.description && (s.description = n.description);
+		try {
+			let t = await i.updateRecord(e, s);
+			console.log(D(t, [], a));
+		} catch (e) {
+			console.error(`Failed to update AC: ${e.message}`), process.exit(1);
+		}
+	}), t.command("delete <id>").description("Delete an AC").action(async (e, n, r) => {
+		let i = F(t), a;
+		try {
+			a = await i.getRecord(e);
+		} catch (e) {
+			console.error(`Record not found: ${e.message}`), process.exit(4);
+		}
+		a.fields.type !== "AC" && (console.error(`Record ${e} is not an AC (type: ${a.fields.type}).`), process.exit(2));
+		try {
+			await i.deleteRecord(e), console.log(`AC ${e} deleted.`);
+		} catch (e) {
+			console.error(`Failed to delete AC: ${e.message}`), process.exit(1);
+		}
+	});
+}
+//#endregion
+//#region src/cli.ts
+var R = new e();
+R.name("fz-task-cli").description("Feishu Bitable task management CLI").version("0.1.0").option("--profile <name>", "config profile name").option("--format <format>", "output format (json|table)", "table"), S(R), j(R), P(R), L(R), R.parse();
+//#endregion

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@fanzie/task-cli",
+  "version": "0.1.1",
+  "description": "CLI tool for managing Feature/UserStory/AC task hierarchies in Feishu Bitable",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "fz-task-cli": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "feishu",
+    "bitable",
+    "task",
+    "cli",
+    "project-management"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dannnney/fz-task-cli.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "commander": "^14.0.3",
+    "js-yaml": "^4.1.1"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.1"
+  },
+  "scripts": {
+    "dev": "node --experimental-strip-types src/cli.ts",
+    "build": "vite build",
+    "test": "bun test"
+  }
+}