tcsetup 1.2.0 → 1.3.1

package/README.md

@@ -1,6 +1,6 @@
 # tcsetup
 
-Bootstrap a new project with the full TC toolchain in one command.
+Bootstrap and update a project with the full TC toolchain in one command.
 
 ## What it installs
 
@@ -9,21 +9,43 @@ Bootstrap a new project with the full TC toolchain in one command.
 | 1 | [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) | `npx bmad-method install` |
 | 2 | [Spec Kit](https://github.com/github/spec-kit) | `specify init --here --ai claude` |
 | 3 | [Agreement System](https://github.com/tcanaud/agreement-system) | `npx agreement-system init --yes` |
-| 4 | [Mermaid Workbench](https://github.com/tcanaud/mermaid-workbench) | `npx mermaid-workbench init` |
+| 4 | [ADR System](https://github.com/tcanaud/adr-system) | `npx adr-system init --yes` |
+| 5 | [Mermaid Workbench](https://github.com/tcanaud/mermaid-workbench) | `npx mermaid-workbench init` |
+| 6 | [Feature Lifecycle](https://github.com/tcanaud/feature-lifecycle) | `npx feature-lifecycle init --yes` |
 
 ## Usage
 
+### Init (onboard a new project)
+
 ```bash
 npx tcsetup
+# or explicitly:
+npx tcsetup init
+```
+
+### Update (refresh an existing project)
+
+```bash
+npx tcsetup update
+```
+
+Detects which tools are installed (by marker directories), updates their npm packages to latest, runs each tool's update command to refresh commands/templates, and refreshes tcsetup's own Claude Code command files. User data is never touched.
+
+### Help
+
+```bash
+npx tcsetup help
 ```
 
-### Skip specific steps
+### Skip specific steps (init only)
 
 ```bash
 npx tcsetup --skip-bmad
 npx tcsetup --skip-speckit
 npx tcsetup --skip-agreements
+npx tcsetup --skip-adr
 npx tcsetup --skip-mermaid
+npx tcsetup --skip-lifecycle
 ```
 
 Multiple flags can be combined:

package/bin/cli.js

@@ -1,24 +1,28 @@
 #!/usr/bin/env node
 
-import { execSync } from "node:child_process";
-import { argv } from "node:process";
-import { readFileSync, mkdirSync, copyFileSync, existsSync } from "node:fs";
+import { argv, exit } from "node:process";
+import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
+import { install } from "../src/installer.js";
+import { update } from "../src/updater.js";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const { version } = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
 
-const flags = argv.slice(2);
+const command = argv[2];
+const flags = argv.slice(3);
 
 const HELP = `
-tcsetup — Bootstrap a project with the full TC toolchain.
+tcsetup v${version} — Bootstrap and update the TC toolchain.
 
 Usage:
-  npx tcsetup              Run all setup steps
+  npx tcsetup              Run all setup steps (same as init)
+  npx tcsetup init         Install the full TC toolchain
+  npx tcsetup update       Update all installed TC tools to latest
   npx tcsetup help         Show this help message
 
-Options:
+Options (init):
   --skip-bmad              Skip BMAD Method install
   --skip-speckit           Skip Spec Kit init
   --skip-agreements        Skip Agreement System init
@@ -27,84 +31,28 @@ Options:
   --skip-lifecycle         Skip Feature Lifecycle Tracker init
 `;
 
-if (flags.includes("help") || flags.includes("--help") || flags.includes("-h")) {
-  console.log(HELP);
-  process.exit(0);
-}
-
-const steps = [
-  {
-    name: "BMAD Method",
-    flag: "--skip-bmad",
-    cmd: "npx bmad-method install",
-  },
-  {
-    name: "Spec Kit",
-    flag: "--skip-speckit",
-    cmd: "specify init --here --ai claude",
-  },
-  {
-    name: "Agreement System",
-    flag: "--skip-agreements",
-    cmd: "npx agreement-system init --yes",
-  },
-  {
-    name: "ADR System",
-    flag: "--skip-adr",
-    cmd: "npx adr-system init --yes",
-  },
-  {
-    name: "Mermaid Workbench",
-    flag: "--skip-mermaid",
-    cmd: "npx mermaid-workbench init",
-  },
-  {
-    name: "Feature Lifecycle Tracker",
-    flag: "--skip-lifecycle",
-    cmd: "npx feature-lifecycle init --yes",
-  },
-];
-
-console.log(`\n  tcsetup v${version}\n`);
-
-let current = 0;
-const total = steps.filter((s) => !flags.includes(s.flag)).length;
-
-for (const step of steps) {
-  if (flags.includes(step.flag)) {
-    console.log(`  [skip] ${step.name} (${step.flag})\n`);
-    continue;
-  }
-
-  current++;
-  console.log(`  [${current}/${total}] ${step.name}`);
-  console.log(`  > ${step.cmd}\n`);
-
-  try {
-    execSync(step.cmd, { stdio: "inherit" });
-    console.log();
-  } catch (err) {
-    console.error(`\n  ⚠ ${step.name} failed (exit code ${err.status}).`);
-    console.error(`  Continuing with remaining steps...\n`);
-  }
-}
-
-// ── Install Claude Code commands ──────────────────────
-const commandsSource = join(__dirname, "..", "commands");
-const commandsDest = join(process.cwd(), ".claude", "commands");
-
-if (existsSync(commandsSource)) {
-  const commandFiles = ["tcsetup.onboard.md", "feature.workflow.md"];
-  mkdirSync(commandsDest, { recursive: true });
-  for (const file of commandFiles) {
-    const src = join(commandsSource, file);
-    const dest = join(commandsDest, file);
-    if (existsSync(src)) {
-      copyFileSync(src, dest);
-      console.log(`  [cmd] Installed .claude/commands/${file}`);
+switch (command) {
+  case "init":
+    install(flags);
+    break;
+  case "update":
+    update(flags);
+    break;
+  case "help":
+  case "--help":
+  case "-h":
+    console.log(HELP);
+    break;
+  case undefined:
+    install([]);
+    break;
+  default:
+    // Flags without subcommand (e.g., npx tcsetup --skip-bmad) → treat as init
+    if (command.startsWith("-")) {
+      install(argv.slice(2));
+    } else {
+      console.error(`  Unknown command: ${command}\n`);
+      console.log(HELP);
+      exit(1);
     }
-  }
-  console.log();
 }
-
-console.log("  Done! Project setup complete.\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tcsetup",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "type": "module",
   "description": "Bootstrap a new project with BMAD, Spec Kit, Agreement System, and Mermaid Workbench in one command.",
   "bin": {
@@ -22,6 +22,7 @@
   },
   "files": [
     "bin/",
+    "src/",
     "commands/"
   ],
   "engines": {

package/src/installer.js

@@ -0,0 +1,86 @@
+import { execSync } from "node:child_process";
+import { readFileSync, mkdirSync, copyFileSync, existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const { version } = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
+
+const steps = [
+  {
+    name: "BMAD Method",
+    flag: "--skip-bmad",
+    cmd: "npx bmad-method install",
+  },
+  {
+    name: "Spec Kit",
+    flag: "--skip-speckit",
+    cmd: "specify init --here --ai claude",
+  },
+  {
+    name: "Agreement System",
+    flag: "--skip-agreements",
+    cmd: "npx agreement-system init --yes",
+  },
+  {
+    name: "ADR System",
+    flag: "--skip-adr",
+    cmd: "npx adr-system init --yes",
+  },
+  {
+    name: "Mermaid Workbench",
+    flag: "--skip-mermaid",
+    cmd: "npx mermaid-workbench init",
+  },
+  {
+    name: "Feature Lifecycle Tracker",
+    flag: "--skip-lifecycle",
+    cmd: "npx feature-lifecycle init --yes",
+  },
+];
+
+export function install(flags = []) {
+  console.log(`\n  tcsetup v${version}\n`);
+
+  let current = 0;
+  const total = steps.filter((s) => !flags.includes(s.flag)).length;
+
+  for (const step of steps) {
+    if (flags.includes(step.flag)) {
+      console.log(`  [skip] ${step.name} (${step.flag})\n`);
+      continue;
+    }
+
+    current++;
+    console.log(`  [${current}/${total}] ${step.name}`);
+    console.log(`  > ${step.cmd}\n`);
+
+    try {
+      execSync(step.cmd, { stdio: "inherit" });
+      console.log();
+    } catch (err) {
+      console.error(`\n  ⚠ ${step.name} failed (exit code ${err.status}).`);
+      console.error(`  Continuing with remaining steps...\n`);
+    }
+  }
+
+  // ── Install Claude Code commands ──────────────────────
+  const commandsSource = join(__dirname, "..", "commands");
+  const commandsDest = join(process.cwd(), ".claude", "commands");
+
+  if (existsSync(commandsSource)) {
+    const commandFiles = ["tcsetup.onboard.md", "feature.workflow.md"];
+    mkdirSync(commandsDest, { recursive: true });
+    for (const file of commandFiles) {
+      const src = join(commandsSource, file);
+      const dest = join(commandsDest, file);
+      if (existsSync(src)) {
+        copyFileSync(src, dest);
+        console.log(`  [cmd] Installed .claude/commands/${file}`);
+      }
+    }
+    console.log();
+  }
+
+  console.log("  Done! Project setup complete.\n");
+}

package/src/updater.js

@@ -0,0 +1,116 @@
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, copyFileSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const { version } = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
+
+const TOOLS = [
+  {
+    name: "ADR System",
+    marker: ".adr",
+    pkg: "adr-system",
+    cmd: "npx adr-system update",
+  },
+  {
+    name: "Agreement System",
+    marker: ".agreements",
+    pkg: "agreement-system",
+    cmd: "npx agreement-system update",
+  },
+  {
+    name: "Feature Lifecycle",
+    marker: ".features",
+    pkg: "feature-lifecycle",
+    cmd: "npx feature-lifecycle update",
+  },
+  {
+    name: "Mermaid Workbench",
+    marker: ["_bmad/modules/mermaid-workbench", ".bmad/modules/mermaid-workbench"],
+    pkg: "mermaid-workbench",
+    cmd: "npx mermaid-workbench init",
+  },
+];
+
+const COMMAND_FILES = ["tcsetup.onboard.md", "feature.workflow.md"];
+
+function isInstalled(marker, projectRoot) {
+  if (Array.isArray(marker)) {
+    return marker.some((m) => existsSync(join(projectRoot, m)));
+  }
+  return existsSync(join(projectRoot, marker));
+}
+
+export function update(flags = []) {
+  const projectRoot = process.cwd();
+
+  console.log(`\n  tcsetup update v${version}\n`);
+
+  // ── Detect installed tools ────────────────────────────
+  console.log("  Detecting installed tools...\n");
+
+  const detected = TOOLS.filter((tool) => isInstalled(tool.marker, projectRoot));
+
+  if (detected.length === 0) {
+    console.log("  No TC tools detected. Run `npx tcsetup` to onboard first.\n");
+    return;
+  }
+
+  for (const tool of detected) {
+    console.log(`    ✓ ${tool.name}`);
+  }
+  console.log();
+
+  // ── Update npm packages ───────────────────────────────
+  const pkgs = detected.map((t) => `${t.pkg}@latest`).join(" ");
+  console.log(`  [1/3] Updating npm packages...`);
+  console.log(`  > npm install ${pkgs}\n`);
+
+  try {
+    execSync(`npm install ${pkgs}`, { stdio: "inherit" });
+    console.log();
+  } catch (err) {
+    console.error(`\n  ⚠ npm install failed (exit code ${err.status}).`);
+    console.error(`  Continuing with sub-tool updates...\n`);
+  }
+
+  // ── Call sub-tool updates ─────────────────────────────
+  console.log(`  [2/3] Running sub-tool updates...\n`);
+
+  for (const tool of detected) {
+    console.log(`  > ${tool.cmd}`);
+    try {
+      execSync(tool.cmd, { stdio: "inherit" });
+      console.log();
+    } catch (err) {
+      console.error(`\n  ⚠ ${tool.name} update failed (exit code ${err.status}).`);
+      console.error(`  Continuing with remaining tools...\n`);
+    }
+  }
+
+  // ── Refresh tcsetup commands ──────────────────────────
+  console.log(`  [3/3] Refreshing tcsetup commands...\n`);
+
+  const commandsSource = join(__dirname, "..", "commands");
+  const commandsDest = join(projectRoot, ".claude", "commands");
+
+  mkdirSync(commandsDest, { recursive: true });
+
+  for (const file of COMMAND_FILES) {
+    const src = join(commandsSource, file);
+    const dest = join(commandsDest, file);
+    if (existsSync(src)) {
+      copyFileSync(src, dest);
+      console.log(`    update .claude/commands/${file}`);
+    }
+  }
+  console.log();
+
+  // ── Summary ───────────────────────────────────────────
+  console.log(`  Done! Updated ${detected.length} tool${detected.length === 1 ? "" : "s"}:`);
+  for (const tool of detected) {
+    console.log(`    - ${tool.name}`);
+  }
+  console.log();
+}