tracerkit 1.2.0 → 1.3.0

package/README.md

@@ -30,28 +30,28 @@ Open Claude Code in any project and start using:
 /tk:verify dark-mode-support      # verify and archive
 ```
 
-### 3. Manage your installation
+### 3. CLI Reference
 
-```bash
-npx tracerkit update              # refresh to latest, skip modified files
-npx tracerkit uninstall           # remove TracerKit skills
-```
+| Command                    | Description                                    |
+| -------------------------- | ---------------------------------------------- |
+| `tracerkit init`           | Install skills to `~/.claude/skills/`          |
+| `tracerkit init <path>`    | Install skills to a specific project directory |
+| `tracerkit update`         | Refresh to latest version, skip modified files |
+| `tracerkit update --force` | Replace modified files with latest versions    |
+| `tracerkit uninstall`      | Remove TracerKit skills, keep user artifacts   |
+| `tracerkit --version`      | Print version                                  |
+
+All commands default to the home directory. Pass a path or use `--global` explicitly to target `~/`.
 
 <details>
-<summary>Install per-project instead</summary>
+<summary>Per-project usage</summary>
 
 To scope skills to a single project (team members get them via git):
 
 ```bash
 npx tracerkit init .              # install to .claude/skills/ in current dir
-npx tracerkit init /path/to/proj  # or specify a path
-```
-
-Per-project commands:
-
-```bash
-npx tracerkit update .
-npx tracerkit uninstall .
+npx tracerkit update .            # update project-scoped skills
+npx tracerkit uninstall .         # remove project-scoped skills
 ```
 
 </details>

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as e, r as t, t as n } from "./uninstall-B9BzyN-s.js";
+import { n as e, r as t, t as n } from "./uninstall-vX1WH11F.js";
 import { resolve as r } from "node:path";
 import { homedir as i } from "node:os";
 //#region src/cli.ts
@@ -12,6 +12,7 @@ var a = [
 	"  uninstall [path]  Remove TracerKit skills, keep user artifacts",
 	"",
 	"Options:",
+	"  --force           Replace modified files with latest versions",
 	"  --global          Target home directory instead of current directory",
 	"  --version, -v     Print version"
 ];
@@ -21,13 +22,13 @@ function o(e) {
 	return t ? i() : n ? r(n) : process.cwd();
 }
 function s(r) {
-	if (r.includes("--version") || r.includes("-v")) return ["tracerkit/1.2.0"];
+	if (r.includes("--version") || r.includes("-v")) return ["tracerkit/1.3.0"];
 	let i = r[0], s = r.slice(1);
 	switch (i) {
 		case "init": return t(o(s));
 		case "update": {
-			let t = e(o(s));
-			return t.push("", "Updated to tracerkit/1.2.0"), t.push("If using Claude Code, restart your session to load changes."), t;
+			let t = s.includes("--force"), n = e(o(s.filter((e) => e !== "--force")), { force: t });
+			return n.push("", "Updated to tracerkit/1.3.0"), n.push("If using Claude Code, restart your session to load changes."), n;
 		}
 		case "uninstall": return n(o(s));
 		default: return a;

package/dist/index.js

@@ -1,2 +1,2 @@
-import { i as e, n as t, r as n, t as r } from "./uninstall-B9BzyN-s.js";
+import { i as e, n as t, r as n, t as r } from "./uninstall-vX1WH11F.js";
 export { e as SKILL_NAMES, n as init, r as uninstall, t as update };

package/dist/{uninstall-B9BzyN-s.js → uninstall-vX1WH11F.js}

@@ -49,16 +49,24 @@ function g(t) {
 }
 //#endregion
 //#region src/commands/update.ts
-function _(t) {
+function _(t, n) {
 	if (!u.some((n) => e(s(t, ".claude", "skills", n)))) throw Error("TracerKit not initialized — run `tracerkit init` first");
-	let { unchanged: n, modified: r, missing: i } = h(t), a = [], o = [...n, ...i];
-	if (o.length > 0) {
-		p(t, o);
-		for (let e of n) a.push(`✓ ${e}`);
-		for (let e of i) a.push(`✓ ${e} (added)`);
+	let { unchanged: r, modified: i, missing: a } = h(t), o = [], c = n?.force ?? !1, l = [
+		...r,
+		...a,
+		...c ? i : []
+	];
+	if (l.length > 0) {
+		p(t, l);
+		for (let e of r) o.push(`✓ ${e}`);
+		for (let e of a) o.push(`✓ ${e} (added)`);
+		if (c) for (let e of i) o.push(`✓ ${e} (replaced)`);
 	}
-	for (let e of r) a.push(`⚠ ${e} (skipped — modified)`);
-	return a;
+	if (!c && i.length > 0) {
+		for (let e of i) o.push(`⚠ ${e} (skipped — modified)`);
+		o.push("", "Run `tracerkit update --force` to replace modified files with latest versions.");
+	}
+	return o;
 }
 //#endregion
 //#region src/commands/uninstall.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracerkit",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Stack-agnostic spec-driven workflow for AI coding assistants",
   "license": "MIT",
   "author": {