@svenroth-ai/shipwright 0.24.1-next.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sven Roth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# `@svenroth-ai/shipwright`
+
+**One command to install _and_ update Shipwright** — the `/shipwright-*` SDLC
+plugins **and** the Command Center, first run and every run after.
+
+```bash
+npx @svenroth-ai/shipwright@latest
+```
+
+> Always include `@latest`. A bare `npx @svenroth-ai/shipwright` can silently
+> reuse a cached older copy; the tool also self-checks the registry and warns
+> you when you are behind.
+
+## What it does
+
+Running the command, in order:
+
+1. **Self-version check** — warns (never fails) if a newer version is published.
+2. **Preflight** — verifies the prerequisites the plugins actually need: the
+   `claude` CLI, `uv`, a working Python (test-run, not the Microsoft-Store
+   `python3` stub), Node >= 20.12.0, and git. A missing one is a loud,
+   actionable failure — not a dead install that _looks_ fine.
+3. **Plugins** — `claude plugin marketplace add/update svenroth-ai/shipwright`,
+   then installs/updates **every plugin read from the marketplace manifest**
+   (never a hardcoded list), then **syncs the plugin cache** so each plugin's
+   hooks (`uv run "${CLAUDE_PLUGIN_ROOT}/../../shared/…"`) actually resolve —
+   the step `claude plugin install` alone skips, which otherwise leaves every
+   hook dead at session start.
+4. **Command Center** — probes `:3847`. Free → starts the packaged server;
+   already running the **same** version → opens it (no second server); an
+   **older** version → swaps it (via a detached swapper, so it is safe to run
+   from inside the Command Center's own terminal); a **foreign** process →
+   fails loud and leaves it running (`PORT=<n>` to pick another port).
+5. **Summary** — reports exactly what happened. When plugins changed, it prints
+   the one thing it cannot do for you: **restart Claude Code** so the freshly
+   installed plugins activate in a new session.
+
+## Options
+
+| Flag | Effect |
+| --- | --- |
+| `--no-open` | do not open the browser (CI / headless) |
+| `--plugins-only` | install/update plugins, skip the Command Center |
+| `--webui-only` | boot/attach the Command Center, skip the plugin phase |
+| `--port <n>` | Command Center port (default `3847`, or `PORT` env) |
+| `--version`, `-v` | print this package's version |
+| `--help`, `-h` | help |
+
+## Notes
+
+- The bundled server + client are **built** — re-running the command **is** the
+  update. Only `@lydell/node-pty` resolves a native binary at install time.
+- Publishing is a **manual** step performed by the maintainer.
+
+MIT © svenroth.ai

package/bin/shipwright.mjs

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+/**
+ * shipwright.mjs — the ONE command.
+ *   npx @svenroth-ai/shipwright@latest
+ *
+ * Install AND update the whole system — the `/shipwright-*` plugins AND the
+ * Command Center — first run and every run after. Order:
+ *   self-version check → preflight → plugins (+ cache sync) → server → summary.
+ *
+ * Honesty rule (AC8): the summary reports ONLY what actually happened. No
+ * "plugins active" while a restart is still pending; no success line for a
+ * plugin whose install exited non-zero; the restart notice prints EXACTLY when
+ * the installed plugin set changed.
+ */
+
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { MARK } from "../lib/util.mjs";
+import { checkForStaleCopy, staleBanner } from "../lib/version-check.mjs";
+import { runPreflight, renderVerdict } from "../lib/preflight.mjs";
+import { ensurePlugins, resolveMarketplacePlugins } from "../lib/plugins.mjs";
+import { defaultRunClaude, defaultResolverSeams, defaultSnapshotInstalled } from "../lib/claude-cli.mjs";
+import { runCacheSync } from "../lib/cache-runtime.mjs";
+import { ensureServer } from "../lib/server.mjs";
+
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = path.resolve(HERE, "..");
+const SELF_VERSION = readSelfVersion();
+
+function readSelfVersion() {
+  try {
+    return JSON.parse(readFileSync(path.join(PKG_ROOT, "package.json"), "utf-8")).version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+
+export function parseArgs(argv) {
+  const a = { noOpen: false, pluginsOnly: false, webuiOnly: false, port: undefined, help: false, version: false };
+  for (let i = 0; i < argv.length; i++) {
+    const t = argv[i];
+    if (t === "--no-open") a.noOpen = true;
+    else if (t === "--plugins-only") a.pluginsOnly = true;
+    else if (t === "--webui-only") a.webuiOnly = true;
+    else if (t === "--version" || t === "-v") a.version = true;
+    else if (t === "--help" || t === "-h") a.help = true;
+    else if (t === "--port") a.port = Number(argv[++i]);
+    else if (t.startsWith("--port=")) a.port = Number(t.slice("--port=".length));
+  }
+  return a;
+}
+
+/** The effective port: `--port` wins, else `PORT` env, else 3847. May be NaN. */
+export function resolvePort(a, env = process.env) {
+  if (a.port !== undefined) return a.port;
+  return env.PORT ? Number(env.PORT) : 3847;
+}
+
+/** Reject contradictory flags + an out-of-range port (from --port OR PORT). */
+export function validateArgs(a, port) {
+  if (a.pluginsOnly && a.webuiOnly) {
+    return "--plugins-only and --webui-only are mutually exclusive";
+  }
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    return `invalid port ${JSON.stringify(port)}: must be an integer 1-65535 (--port or PORT env)`;
+  }
+  return null;
+}
+
+const HELP = `shipwright — install & update Shipwright (plugins + Command Center)
+
+Usage:
+  npx @svenroth-ai/shipwright@latest [options]
+
+Options:
+  --no-open        do not open the browser (CI / headless)
+  --plugins-only   install/update plugins, skip the Command Center
+  --webui-only     boot/attach the Command Center, skip the plugin phase
+  --port <n>       Command Center port (default 3847; or PORT env)
+  --version, -v    print this package's version
+  --help, -h       this help`;
+
+/** Run the plugin phase: preflight-gated install/update + the make-or-break cache sync. */
+async function pluginPhase(log) {
+  const pre = runPreflight();
+  log(renderVerdict(pre, MARK));
+  if (!pre.pluginPhaseOk) {
+    log(`\n${MARK.fail} Skipping the plugin phase — a hard prerequisite is missing (see above).`);
+    log(`${MARK.warn} The Command Center would launch a Claude with NO /shipwright-* commands.`);
+    return { skipped: true, exitCode: Math.max(pre.exitCode, 1) };
+  }
+  log(`\nInstalling / updating plugins from the marketplace manifest...`);
+  const seams = defaultResolverSeams();
+  const outcome = await ensurePlugins({
+    runClaude: defaultRunClaude,
+    resolvePlugins: () => resolveMarketplacePlugins(seams),
+    snapshotInstalled: () => defaultSnapshotInstalled(),
+    log,
+  });
+  log(`  marketplace ${outcome.marketplaceAction}; ${outcome.names.length} plugin(s) from ${outcome.source}`);
+
+  log(`Syncing the plugin cache (shared/, plugins/ layer, GC)...`);
+  const cache = runCacheSync({ names: outcome.names, log });
+  if (!cache.verdict.ok) {
+    log(`${MARK.fail} Plugin cache is INCOHERENT — hooks would die at session start:`);
+    for (const p of cache.verdict.problems.slice(0, 8)) log(`      - ${p}`);
+    return { skipped: false, outcome, cacheOk: false, exitCode: 1 };
+  }
+  log(`${MARK.pass} Plugin cache coherent (${cache.syncedCount} plugin(s), shared/ present).`);
+  return { skipped: false, outcome, cacheOk: true, exitCode: outcome.failures.length > 0 ? 1 : 0 };
+}
+
+export function printSummary(log, { plugin, server, port }) {
+  log(`\n========================================`);
+  log(` Shipwright`);
+  log(`========================================`);
+  if (plugin && !plugin.skipped && plugin.outcome) {
+    const o = plugin.outcome;
+    const installed = o.results.filter((r) => r.action === "install" && r.ok).map((r) => r.name);
+    const updated = o.results.filter((r) => r.action === "update" && r.ok).map((r) => r.name);
+    if (installed.length) log(` ${MARK.pass} Installed: ${installed.join(", ")}`);
+    if (updated.length) log(` ${MARK.pass} Updated:   ${updated.join(", ")}`);
+    for (const f of o.failures) log(` ${MARK.fail} FAILED:    ${f.name}@shipwright (exit ${f.code})`);
+    if (plugin.cacheOk === false) log(` ${MARK.fail} Plugin cache incoherent — hooks will not run until re-synced.`);
+    // AC5 + AC8: the restart notice prints EXACTLY when the plugin set changed.
+    if (o.pluginsChanged) {
+      log(``);
+      log(` ${MARK.warn} Restart Claude Code — freshly installed/updated plugins only`);
+      log(`      activate in a NEW session. This is the one step this tool cannot`);
+      log(`      do for you.`);
+    }
+  }
+  if (server) {
+    if (server.action === "attach") log(` ${MARK.pass} Command Center already running: ${server.url}`);
+    else if (server.action === "boot") log(` ${MARK.pass} Command Center started: ${server.url}`);
+    else if (server.action === "swap") log(` ${MARK.pass} Command Center updated to ${server.version}: ${server.url}`);
+  } else if (port) {
+    log(` ${MARK.skip} Command Center: skipped (--plugins-only).`);
+  }
+  log(`========================================`);
+}
+
+export async function main(argv = process.argv.slice(2), log = (m) => console.log(m)) {
+  const args = parseArgs(argv);
+  if (args.version) { log(SELF_VERSION); return 0; }
+  if (args.help) { log(HELP); return 0; }
+
+  const port = resolvePort(args);
+  const invalid = validateArgs(args, port);
+  if (invalid) { log(`${MARK.fail} ${invalid}`); return 2; }
+
+  // Self-version check (npx cache trap) — courtesy, never fatal.
+  const stale = await checkForStaleCopy(SELF_VERSION);
+  const banner = staleBanner(stale);
+  if (banner) log(`${MARK.warn} ${banner}\n`);
+
+  let exitCode = 0;
+  let plugin = null;
+  let server = null;
+
+  if (!args.webuiOnly) {
+    plugin = await pluginPhase(log);
+    exitCode = Math.max(exitCode, plugin.exitCode ?? 0);
+  }
+
+  if (!args.pluginsOnly) {
+    try {
+      server = await ensureServer({ port, pkgRoot: PKG_ROOT, packageVersion: SELF_VERSION, noOpen: args.noOpen, log });
+    } catch (e) {
+      log(`${MARK.fail} ${String(e?.message ?? e)}`);
+      exitCode = Math.max(exitCode, 1);
+    }
+  }
+
+  printSummary(log, { plugin, server, port: args.pluginsOnly ? port : null });
+  return exitCode;
+}
+
+// Run only when invoked as a script — importing (tests) stays side-effect free.
+if (process.argv[1] && path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url))) {
+  main().then((code) => process.exit(code)).catch((e) => {
+    console.error(`[shipwright] fatal: ${String(e?.stack ?? e)}`);
+    process.exit(1);
+  });
+}

package/client/dist/assets/EmbeddedTerminal-6GBZ9nXN.css

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) 2014 The xterm.js authors. All rights reserved.
+ * Copyright (c) 2012-2013, Christopher Jeffrey (MIT License)
+ * https://github.com/chjj/term.js
+ * @license MIT
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ * Originally forked from (with the author's permission):
+ *   Fabrice Bellard's javascript vt100 for jslinux:
+ *   http://bellard.org/jslinux/
+ *   Copyright (c) 2011 Fabrice Bellard
+ *   The original design remains. The terminal itself
+ *   has been extended to include xterm CSI codes, among
+ *   other features.
+ */.xterm{cursor:text;position:relative;user-select:none;-ms-user-select:none;-webkit-user-select:none}.xterm.focus,.xterm:focus{outline:none}.xterm .xterm-helpers{position:absolute;top:0;z-index:5}.xterm .xterm-helper-textarea{padding:0;border:0;margin:0;position:absolute;opacity:0;left:-9999em;top:0;width:0;height:0;z-index:-5;white-space:nowrap;overflow:hidden;resize:none}.xterm .composition-view{background:#000;color:#fff;display:none;position:absolute;white-space:nowrap;z-index:1}.xterm .composition-view.active{display:block}.xterm .xterm-viewport{background-color:#000;overflow-y:scroll;cursor:default;position:absolute;right:0;left:0;top:0;bottom:0}.xterm .xterm-screen{position:relative}.xterm .xterm-screen canvas{position:absolute;left:0;top:0}.xterm-char-measure-element{display:inline-block;visibility:hidden;position:absolute;top:0;left:-9999em;line-height:normal}.xterm.enable-mouse-events{cursor:default}.xterm.xterm-cursor-pointer,.xterm .xterm-cursor-pointer{cursor:pointer}.xterm.column-select.focus{cursor:crosshair}.xterm .xterm-accessibility:not(.debug),.xterm .xterm-message{position:absolute;left:0;top:0;bottom:0;right:0;z-index:10;color:transparent;pointer-events:none}.xterm .xterm-accessibility-tree:not(.debug) *::selection{color:transparent}.xterm .xterm-accessibility-tree{font-family:monospace;-webkit-user-select:text;user-select:text;white-space:pre}.xterm .xterm-accessibility-tree>div{transform-origin:left;width:fit-content}.xterm .live-region{position:absolute;left:-9999px;width:1px;height:1px;overflow:hidden}.xterm-dim{opacity:1!important}.xterm-underline-1{text-decoration:underline}.xterm-underline-2{text-decoration:double underline}.xterm-underline-3{text-decoration:wavy underline}.xterm-underline-4{text-decoration:dotted underline}.xterm-underline-5{text-decoration:dashed underline}.xterm-overline{text-decoration:overline}.xterm-overline.xterm-underline-1{text-decoration:overline underline}.xterm-overline.xterm-underline-2{text-decoration:overline double underline}.xterm-overline.xterm-underline-3{text-decoration:overline wavy underline}.xterm-overline.xterm-underline-4{text-decoration:overline dotted underline}.xterm-overline.xterm-underline-5{text-decoration:overline dashed underline}.xterm-strikethrough{text-decoration:line-through}.xterm-screen .xterm-decoration-container .xterm-decoration{z-index:6;position:absolute}.xterm-screen .xterm-decoration-container .xterm-decoration.xterm-decoration-top-layer{z-index:7}.xterm-decoration-overview-ruler{z-index:8;position:absolute;top:0;right:0;pointer-events:none}.xterm-decoration-top{z-index:2;position:relative}.xterm .xterm-scrollable-element>.scrollbar{cursor:default}.xterm .xterm-scrollable-element>.scrollbar>.scra{cursor:pointer;font-size:11px!important}.xterm .xterm-scrollable-element>.visible{opacity:1;background:#0000;transition:opacity .1s linear;z-index:11}.xterm .xterm-scrollable-element>.invisible{opacity:0;pointer-events:none}.xterm .xterm-scrollable-element>.invisible.fade{transition:opacity .8s linear}.xterm .xterm-scrollable-element>.shadow{position:absolute;display:none}.xterm .xterm-scrollable-element>.shadow.top{display:block;top:0;left:3px;height:3px;width:100%;box-shadow:var(--vscode-scrollbar-shadow, #000) 0 6px 6px -6px inset}.xterm .xterm-scrollable-element>.shadow.left{display:block;top:3px;left:0;height:100%;width:3px;box-shadow:var(--vscode-scrollbar-shadow, #000) 6px 0 6px -6px inset}.xterm .xterm-scrollable-element>.shadow.top-left-corner{display:block;top:0;left:0;height:3px;width:3px}.xterm .xterm-scrollable-element>.shadow.top.left{box-shadow:var(--vscode-scrollbar-shadow, #000) 6px 0 6px -6px inset}