tracerkit 1.14.0 → 1.15.0

package/README.md

@@ -103,6 +103,14 @@ tracerkit config github.repo org/repo   # set target repo
 
 PRDs and plans become GitHub Issues with `tk:prd` and `tk:plan` labels. On `/tk:check` pass, issues are closed instead of archived locally. Each project can use a different backend; local is the default. See [Configuration](docs/configuration.md) for details.
 
+To migrate existing artifacts between backends:
+
+```bash
+tracerkit migrate-storage           # local→github or github→local (auto-detected)
+```
+
+Direction is inferred from the current `storage` config. All artifacts are migrated, existing duplicates are skipped, and the config is flipped to the target backend. Source artifacts are left intact as backup. For archived features migrating to GitHub, merged PRs matching the slug are linked automatically.
+
 </details>
 
 ## Skills
@@ -137,13 +145,13 @@ Without arguments, shows a feature dashboard with status and progress before ask
 
 ## Docs
 
-| Document                                         | Description                                        |
-| ------------------------------------------------ | -------------------------------------------------- |
-| [Examples](docs/examples.md)                     | Walk through end-to-end usage scenarios            |
-| [CLI Reference](docs/cli-reference.md)           | Commands: init, update, config, uninstall          |
-| [Configuration](docs/configuration.md)           | Storage backends, GitHub options, custom paths     |
-| [Metadata Lifecycle](docs/metadata-lifecycle.md) | Understand YAML frontmatter states and transitions |
-| [Comparison](docs/comparison.md)                 | Compare TracerKit to Spec Kit, Kiro, and OpenSpec  |
+| Document                                         | Description                                                |
+| ------------------------------------------------ | ---------------------------------------------------------- |
+| [Examples](docs/examples.md)                     | Walk through end-to-end usage scenarios                    |
+| [CLI Reference](docs/cli-reference.md)           | Commands: init, update, config, migrate-storage, uninstall |
+| [Configuration](docs/configuration.md)           | Storage backends, GitHub options, custom paths             |
+| [Metadata Lifecycle](docs/metadata-lifecycle.md) | Understand YAML frontmatter states and transitions         |
+| [Comparison](docs/comparison.md)                 | Compare TracerKit to Spec Kit, Kiro, and OpenSpec          |
 
 ## Contributing
 

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as e, f as t, i as n, l as r, n as i, o as a, p as o, r as s, s as c, t as l, u } from "./uninstall-C4K7aNpf.js";
+import { a as e, f as t, i as n, l as r, n as i, o as a, p as o, r as s, s as c, t as l, u } from "./uninstall-k_ZGY-Mk.js";
 import { existsSync as d, readFileSync as f, statSync as p } from "node:fs";
 import { dirname as m, join as h, resolve as g } from "node:path";
 import { fileURLToPath as _ } from "node:url";

package/dist/index.js

@@ -1,2 +1,2 @@
-import { c as e, i as t, n, o as r, r as i, t as a, u as o } from "./uninstall-C4K7aNpf.js";
+import { c as e, i as t, n, o as r, r as i, t as a, u as o } from "./uninstall-k_ZGY-Mk.js";
 export { r as COMMANDS, e as DEPRECATED_SKILLS, o as SKILL_NAMES, i as init, n as migrateStorage, a as uninstall, t as update };

package/dist/{uninstall-C4K7aNpf.js → uninstall-k_ZGY-Mk.js}

@@ -26,24 +26,24 @@ function _(t) {
 		throw Error("Invalid .tracerkit/config.json — expected valid JSON");
 	}
 	return {
-		storage: v(i.storage),
-		paths: y(i.paths),
-		github: b(i.github)
+		storage: ee(i.storage),
+		paths: v(i.paths),
+		github: y(i.github)
 	};
 }
-function v(e) {
+function ee(e) {
 	return typeof e == "string" && m.includes(e) ? e : f;
 }
-function y(e) {
-	let t = C(e) ? e : {};
+function v(e) {
+	let t = S(e) ? e : {};
 	return {
 		prds: typeof t.prds == "string" ? t.prds : h.prds,
 		plans: typeof t.plans == "string" ? t.plans : h.plans,
 		archives: typeof t.archives == "string" ? t.archives : h.archives
 	};
 }
-function b(e) {
-	let t = C(e) ? e : {}, n = C(t.labels) ? t.labels : {};
+function y(e) {
+	let t = S(e) ? e : {}, n = S(t.labels) ? t.labels : {};
 	return {
 		...typeof t.repo == "string" ? { repo: t.repo } : {},
 		labels: {
@@ -52,7 +52,7 @@ function b(e) {
 		}
 	};
 }
-function x(r, i) {
+function b(r, i) {
 	let o = c(r, ".tracerkit", "config.json");
 	t(s(o), { recursive: !0 });
 	let l = {};
@@ -61,31 +61,31 @@ function x(r, i) {
 	} catch {
 		l = {};
 	}
-	let u = S(l, i);
+	let u = x(l, i);
 	a(o, JSON.stringify(u, null, 2) + "\n");
 }
-function S(e, t) {
+function x(e, t) {
 	let n = { ...e };
-	for (let e of Object.keys(t)) C(n[e]) && C(t[e]) ? n[e] = S(n[e], t[e]) : n[e] = t[e];
+	for (let e of Object.keys(t)) S(n[e]) && S(t[e]) ? n[e] = x(n[e], t[e]) : n[e] = t[e];
 	return n;
 }
-function C(e) {
+function S(e) {
 	return typeof e == "object" && !!e && !Array.isArray(e);
 }
-var w = [
+var C = [
 	"tk:brief",
 	"tk:prd",
 	"tk:plan",
 	"tk:check"
-], T = ["tk:verify"], E = {
+], w = ["tk:verify"], T = {
 	force: "--force",
 	help: "--help",
 	version: "--version"
-}, D = [
+}, E = [
 	"brief",
 	"progress",
 	"archive"
-], O = [
+], D = [
 	{
 		name: "init",
 		args: "[path]",
@@ -111,44 +111,44 @@ var w = [
 		args: "[path]",
 		desc: "Migrate artifacts between local and GitHub storage backends"
 	}
-], k = c(s(u(import.meta.url)), "..", "skills");
-function A(e, t = "") {
+], O = c(s(u(import.meta.url)), "..", "skills");
+function k(e, t = "") {
 	let n = r(e, { withFileTypes: !0 }), i = [];
 	for (let r of n) {
 		let n = t ? `${t}/${r.name}` : r.name;
-		r.isDirectory() ? i.push(...A(c(e, r.name), n)) : i.push(n);
+		r.isDirectory() ? i.push(...k(c(e, r.name), n)) : i.push(n);
 	}
 	return i.sort();
 }
-function j(e) {
+function A(e) {
 	return `.claude/skills/tk:${e}`;
 }
-function M(e) {
+function j(e) {
 	return e.slice(18);
 }
-function N(e, t) {
+function M(e, t) {
 	let n = e;
 	return t.paths.prds !== h.prds && (n = n.replaceAll(h.prds, t.paths.prds)), t.paths.plans !== h.plans && (n = n.replaceAll(h.plans, t.paths.plans)), t.paths.archives !== h.archives && (n = n.replaceAll(h.archives, t.paths.archives)), t.github?.repo && (n = n.replaceAll("{{github.repo}}", t.github.repo)), t.github?.labels?.prd && (n = n.replaceAll("{{github.labels.prd}}", t.github.labels.prd)), t.github?.labels?.plan && (n = n.replaceAll("{{github.labels.plan}}", t.github.labels.plan)), n;
 }
-function P(e, r, i) {
-	let o = i ?? A(k).map(j);
+function N(e, r, i) {
+	let o = i ?? k(O).map(A);
 	for (let i of o) {
-		let o = c(k, M(i)), l = c(e, i);
-		t(s(l), { recursive: !0 }), a(l, N(n(o, "utf8"), r));
+		let o = c(O, j(i)), l = c(e, i);
+		t(s(l), { recursive: !0 }), a(l, M(n(o, "utf8"), r));
 	}
 	return { copied: o };
 }
-function F(e) {
+function P(e) {
 	return l("sha256").update(e).digest("hex");
 }
-function I(t, r) {
-	let i = A(k).map(j), a = [], o = [], s = [];
+function F(t, r) {
+	let i = k(O).map(A), a = [], o = [], s = [];
 	for (let l of i) {
 		let i = c(t, l);
 		if (!e(i)) s.push(l);
 		else {
-			let e = N(n(c(k, M(l)), "utf8"), r);
-			F(Buffer.from(e)) === F(n(i)) ? a.push(l) : o.push(l);
+			let e = M(n(c(O, j(l)), "utf8"), r);
+			P(Buffer.from(e)) === P(n(i)) ? a.push(l) : o.push(l);
 		}
 	}
 	return {
@@ -159,10 +159,10 @@ function I(t, r) {
 }
 //#endregion
 //#region src/commands/update.ts
-function L(t, n) {
-	if (!w.some((n) => e(c(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — run `tracerkit init` first");
-	let r = _(t), { unchanged: a, modified: o, missing: s } = I(t, r), l = [];
-	for (let n of T) {
+function I(t, n) {
+	if (!C.some((n) => e(c(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — run `tracerkit init` first");
+	let r = _(t), { unchanged: a, modified: o, missing: s } = F(t, r), l = [];
+	for (let n of w) {
 		let r = c(t, ".claude", "skills", n);
 		e(r) && (i(r, {
 			recursive: !0,
@@ -175,7 +175,7 @@ function L(t, n) {
 		...u ? o : []
 	];
 	if (d.length > 0) {
-		P(t, r, d);
+		N(t, r, d);
 		for (let e of a) l.push(`✓ ${e}`);
 		for (let e of s) l.push(`✓ ${e} (added)`);
 		if (u) for (let e of o) l.push(`✓ ${e} (replaced)`);
@@ -188,19 +188,23 @@ function L(t, n) {
 }
 //#endregion
 //#region src/commands/init.ts
-function R(t) {
-	if (w.some((n) => e(c(t, ".claude", "skills", n)))) return L(t, { force: !1 });
-	let { copied: n } = P(t, _(t));
+function te(t) {
+	if (C.some((n) => e(c(t, ".claude", "skills", n)))) return I(t, { force: !1 });
+	let { copied: n } = N(t, _(t));
 	return n.map((e) => `✓ ${e}`);
 }
 //#endregion
 //#region src/commands/migrate-storage.ts
-var z = {
+var L = {
 	created: "tk:created",
 	in_progress: "tk:in-progress",
 	done: "tk:done"
+}, R = {
+	"tk:created": "created",
+	"tk:in-progress": "in_progress",
+	"tk:done": "done"
 };
-function B(e) {
+function z(e) {
 	let t = e.match(/^---\n([\s\S]*?)---\n([\s\S]*)$/);
 	if (!t) return {
 		metadata: {},
@@ -218,32 +222,54 @@ function B(e) {
 		body: t[2]
 	};
 }
-function V(e) {
+function B(e) {
 	let t = Object.entries(e);
 	return t.length === 0 ? "<!-- tk:metadata\n-->" : `<!-- tk:metadata\n${t.map(([e, t]) => `${e}: ${t}`).join("\n")}\n-->`;
 }
+function V(e) {
+	return L[e] ?? "tk:created";
+}
 function H(e) {
-	return z[e] ?? "tk:created";
+	let t = e.match(/<!--\s*tk:metadata\n([\s\S]*?)-->\n*([\s\S]*)$/);
+	if (!t) return {
+		metadata: {},
+		body: e
+	};
+	let n = {};
+	for (let e of t[1].split("\n")) {
+		let t = e.indexOf(":");
+		if (t === -1) continue;
+		let r = e.slice(0, t).trim(), i = e.slice(t + 1).trim();
+		r && (n[r] = i);
+	}
+	return {
+		metadata: n,
+		body: t[2]
+	};
 }
 function U(e) {
+	let t = Object.entries(e);
+	return t.length === 0 ? "---\n---\n" : `---\n${t.map(([e, t]) => `${e}: ${t}`).join("\n")}\n---\n`;
+}
+function W(e) {
 	let t = e.match(/\[[^\]]+\]\s+([^:]+):/);
 	return t ? t[1].trim() : null;
 }
-function W(e) {
+function G(e) {
 	let t = e.match(/^#\s+(.+)$/m);
 	return t ? t[1].trim() : "Untitled";
 }
-function G(t, i) {
+function K(t, i) {
 	let a = [], s = c(t, i.paths.prds);
 	if (e(s)) for (let e of r(s)) {
 		if (!e.endsWith(".md")) continue;
-		let t = o(e, ".md"), { metadata: r, body: i } = B(n(c(s, e), "utf8"));
+		let t = o(e, ".md"), { metadata: r, body: i } = z(n(c(s, e), "utf8"));
 		a.push({
 			slug: t,
 			type: "prd",
 			metadata: r,
 			body: i,
-			title: W(i),
+			title: G(i),
 			archived: !1
 		});
 	}
@@ -256,7 +282,7 @@ function G(t, i) {
 			type: "plan",
 			metadata: {},
 			body: r,
-			title: W(r),
+			title: G(r),
 			archived: !1
 		});
 	}
@@ -265,7 +291,7 @@ function G(t, i) {
 		if (!t.isDirectory()) continue;
 		let r = t.name, i = c(u, r, "prd.md"), o = c(u, r, "plan.md");
 		if (e(i)) {
-			let { metadata: e, body: t } = B(n(i, "utf8"));
+			let { metadata: e, body: t } = z(n(i, "utf8"));
 			a.push({
 				slug: r,
 				type: "prd",
@@ -274,7 +300,7 @@ function G(t, i) {
 					status: "done"
 				},
 				body: t,
-				title: W(t),
+				title: G(t),
 				archived: !0
 			});
 		}
@@ -285,14 +311,14 @@ function G(t, i) {
 				type: "plan",
 				metadata: { status: "done" },
 				body: e,
-				title: W(e),
+				title: G(e),
 				archived: !0
 			});
 		}
 	}
 	return a;
 }
-function K(e) {
+function q(e) {
 	return d(`gh ${e.map((e) => `'${e.replace(/'/g, "'\\''")}'`).join(" ")}`, {
 		encoding: "utf8",
 		stdio: [
@@ -302,7 +328,7 @@ function K(e) {
 		]
 	}).trim();
 }
-function q(e, t) {
+function J(e, t) {
 	return e.github.repo ? e.github.repo : t([
 		"repo",
 		"view",
@@ -312,7 +338,7 @@ function q(e, t) {
 		".nameWithOwner"
 	]);
 }
-function J(e, t, n) {
+function Y(e, t, n) {
 	let r = n([
 		"issue",
 		"list",
@@ -323,16 +349,16 @@ function J(e, t, n) {
 		"--state",
 		"all",
 		"--json",
-		"number,title,labels,state",
+		"number,title,body,labels,state",
 		"--limit",
 		"1000"
 	]);
 	return JSON.parse(r || "[]");
 }
-function Y(e, t) {
-	return t.some((t) => U(t.title) === e);
+function X(e, t) {
+	return t.some((t) => W(t.title) === e);
 }
-function X(e, t, n) {
+function Z(e, t, n) {
 	for (let r of t) n([
 		"label",
 		"create",
@@ -342,7 +368,7 @@ function X(e, t, n) {
 		"--force"
 	]);
 }
-function Z(e, t, n) {
+function ne(e, t, n) {
 	let r = [
 		"issue",
 		"create",
@@ -357,7 +383,7 @@ function Z(e, t, n) {
 	let i = n(r).match(/\/(\d+)\s*$/);
 	return i ? parseInt(i[1], 10) : 0;
 }
-function Q(e, t, n) {
+function re(e, t, n) {
 	n([
 		"issue",
 		"close",
@@ -366,39 +392,120 @@ function Q(e, t, n) {
 		e
 	]);
 }
+function ie(e, t, n) {
+	let r = n([
+		"pr",
+		"list",
+		"--repo",
+		e,
+		"--search",
+		t,
+		"--state",
+		"merged",
+		"--json",
+		"number,title",
+		"--limit",
+		"5"
+	]);
+	return JSON.parse(r || "[]");
+}
+function ae(e, t, n, r) {
+	r([
+		"issue",
+		"comment",
+		String(t),
+		"--repo",
+		e,
+		"--body",
+		n
+	]);
+}
+function oe(e) {
+	for (let t of e) {
+		let e = R[t];
+		if (e) return e;
+	}
+	return "created";
+}
+function Q(e, n) {
+	t(s(e), { recursive: !0 }), a(e, n);
+}
 function $(e, t) {
-	let n = t?.runGh ?? K, r = _(e), i = [];
-	if (r.storage !== "local") return [`Storage is already "${r.storage}". Nothing to migrate.`];
-	let a = q(r, n), o = G(e, r);
-	if (o.length === 0) return x(e, { storage: p }), i.push("No artifacts found — nothing to migrate."), i.push(`✓ Storage switched to "${p}".`), i;
-	let s = r.github.labels?.prd ?? "tk:prd", c = r.github.labels?.plan ?? "tk:plan";
-	X(a, [
+	let n = t?.runGh ?? q, r = _(e);
+	return r.storage === "local" ? se(e, r, n) : le(e, r, n);
+}
+function se(e, t, n) {
+	let r = [], i = J(t, n), a = K(e, t);
+	if (a.length === 0) return b(e, { storage: p }), r.push("No artifacts found — nothing to migrate."), r.push(`✓ Storage switched to "${p}".`), r;
+	let o = t.github.labels?.prd ?? "tk:prd", s = t.github.labels?.plan ?? "tk:plan";
+	Z(i, [
+		o,
 		s,
-		c,
-		...[...new Set(o.map((e) => H(e.metadata.status ?? "created")))]
+		...[...new Set(a.map((e) => V(e.metadata.status ?? "created")))]
 	], n);
-	let l = J(a, s, n), u = J(a, c, n);
-	for (let e of o) {
-		let t = e.type === "prd" ? s : c, r = e.type === "prd" ? l : u;
-		if (Y(e.slug, r)) {
-			i.push(`⚠ skip ${e.type} "${e.slug}" — already exists on GitHub`);
+	let c = Y(i, o, n), l = Y(i, s, n);
+	for (let e of a) {
+		let t = e.type === "prd" ? o : s, a = e.type === "prd" ? c : l;
+		if (X(e.slug, a)) {
+			r.push(`⚠ skip ${e.type} "${e.slug}" — already exists on GitHub`);
 			continue;
 		}
-		let o = H(e.metadata.status ?? "created"), d = `${V(e.metadata)}\n\n${e.body.replace(/^\n/, "")}`, f = Z(a, {
+		let u = V(e.metadata.status ?? "created"), d = `${B(e.metadata)}\n\n${e.body.replace(/^\n/, "")}`, f = ne(i, {
 			title: `[${t}] ${e.slug}: ${e.title}`,
 			body: d,
-			labels: [t, o]
+			labels: [t, u]
 		}, n);
-		e.archived ? (Q(a, f, n), i.push(`✓ ${e.type} "${e.slug}" → issue #${f} (closed)`)) : i.push(`✓ ${e.type} "${e.slug}" → issue #${f}`);
+		e.archived ? (re(i, f, n), ce(i, e.slug, f, n), r.push(`✓ ${e.type} "${e.slug}" → issue #${f} (closed)`)) : r.push(`✓ ${e.type} "${e.slug}" → issue #${f}`);
+	}
+	return b(e, { storage: p }), r.push(`✓ Storage switched to "${p}".`), r;
+}
+function ce(e, t, n, r) {
+	let i = ie(e, t, r);
+	i.length !== 0 && ae(e, n, `Linked PR: ${i.map((e) => `#${e.number}`).join(", ")}`, r);
+}
+function le(t, n, r) {
+	let i = [], a = J(n, r), o = n.github.labels?.prd ?? "tk:prd", s = n.github.labels?.plan ?? "tk:plan", l = Y(a, o, r), u = Y(a, s, r), d = [...l.map((e) => ({
+		...e,
+		type: "prd"
+	})), ...u.map((e) => ({
+		...e,
+		type: "plan"
+	}))];
+	if (d.length === 0) return b(t, { storage: f }), i.push("No GitHub issues found — nothing to migrate."), i.push(`✓ Storage switched to "${f}".`), i;
+	for (let r of d) {
+		let a = W(r.title);
+		if (!a) continue;
+		let o = r.labels.map((e) => e.name), s = o.includes("tk:done") && r.state === "CLOSED", { metadata: l, body: u } = H(r.body ?? ""), d = l.status ?? oe(o);
+		if (s) {
+			let o = c(t, n.paths.archives, a), s = c(o, "prd.md"), f = c(o, "plan.md"), p = r.type === "prd" ? s : f;
+			if (e(p)) {
+				i.push(`⚠ skip ${r.type} "${a}" — local file already exists`);
+				continue;
+			}
+			r.type === "prd" ? Q(p, `${U({
+				...l,
+				status: d
+			})}\n${u}`) : Q(p, u), i.push(`✓ ${r.type} "${a}" → ${p} (archived)`);
+		} else {
+			let o = c(t, r.type === "prd" ? n.paths.prds : n.paths.plans, `${a}.md`);
+			if (e(o)) {
+				i.push(`⚠ skip ${r.type} "${a}" — local file already exists`);
+				continue;
+			}
+			r.type === "prd" ? Q(o, `${U({
+				...l,
+				status: d
+			})}\n${u}`) : Q(o, u), i.push(`✓ ${r.type} "${a}" → ${o}`);
+		}
 	}
-	return x(e, { storage: p }), i.push(`✓ Storage switched to "${p}".`), i;
+	return b(t, { storage: f }), i.push(`✓ Storage switched to "${f}".`), i;
 }
 //#endregion
 //#region src/commands/uninstall.ts
-function ee(t) {
-	if (!w.some((n) => e(c(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — nothing to uninstall");
+function ue(t) {
+	if (!C.some((n) => e(c(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — nothing to uninstall");
 	let n = [];
-	for (let r of w) {
+	for (let r of C) {
 		let a = c(t, ".claude", "skills", r);
 		e(a) && (i(a, {
 			recursive: !0,
@@ -408,4 +515,4 @@ function ee(t) {
 	return n;
 }
 //#endregion
-export { P as a, T as c, f as d, _ as f, L as i, E as l, $ as n, O as o, x as p, R as r, D as s, ee as t, w as u };
+export { N as a, w as c, f as d, _ as f, I as i, T as l, $ as n, D as o, b as p, te as r, E as s, ue as t, C as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracerkit",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Spec-driven workflow for Claude Code: replace ad-hoc prompts with PRD → plan → verify.",
   "license": "MIT",
   "author": {