outfitter 0.2.0 → 0.2.1

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import {
   outfitterActions
-} from "./shared/chunk-fe7djmgg.js";
+} from "./shared/chunk-f3sch043.js";
 
 // src/cli.ts
 import { buildCliCommands } from "@outfitter/cli/actions";

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   printDoctorResults,
   runDoctor,
   runInit
-} from "./shared/chunk-fe7djmgg.js";
+} from "./shared/chunk-f3sch043.js";
 export {
   runInit,
   runDoctor,

package/dist/shared/{chunk-fe7djmgg.js → chunk-f3sch043.js}

@@ -829,7 +829,7 @@ function initCommand(program) {
     return typeof flags.opts === "function" ? flags.opts() : flags;
   };
   const resolveLocal = (flags) => Boolean(flags.local || flags.workspace);
-  const withCommonOptions = (command) => command.option("-n, --name <name>", "Package name (defaults to directory name)").option("-b, --bin <name>", "Binary name (defaults to project name)").option("-f, --force", "Overwrite existing files", false).option("--local", "Use workspace:* for @outfitter dependencies", false).option("--workspace", "Alias for --local", false).option("--json", "Output as JSON", false).option("--with <blocks>", "Tooling to add (comma-separated: scaffolding, claude, biome, lefthook, bootstrap)").option("--no-tooling", "Skip tooling setup");
+  const withCommonOptions = (command) => command.option("-n, --name <name>", "Package name (defaults to directory name)").option("-b, --bin <name>", "Binary name (defaults to project name)").option("-f, --force", "Overwrite existing files", false).option("--local", "Use workspace:* for @outfitter dependencies", false).option("--workspace", "Alias for --local", false).option("--with <blocks>", "Tooling to add (comma-separated: scaffolding, claude, biome, lefthook, bootstrap)").option("--no-tooling", "Skip tooling setup").option("--json", "Output as JSON", false);
   const resolveOutputMode = (flags) => {
     if (flags.json) {
       process.env["OUTFITTER_JSON"] = "1";
@@ -924,12 +924,13 @@ function initCommand(program) {
 }
 
 // src/actions.ts
-import { output as output5 } from "@outfitter/cli/output";
+import { resolve as resolve5 } from "node:path";
+import { output as output6 } from "@outfitter/cli/output";
 import {
   createActionRegistry,
   defineAction,
-  InternalError,
-  Result as Result3
+  InternalError as InternalError2,
+  Result as Result4
 } from "@outfitter/contracts";
 import { z } from "zod";
 
@@ -1297,6 +1298,229 @@ async function printDemoResults(result) {
   }
 }
 
+// src/commands/update.ts
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
+import { join as join4, resolve as resolve4 } from "node:path";
+import { output as output5 } from "@outfitter/cli/output";
+import { createTheme as createTheme4 } from "@outfitter/cli/render";
+import { InternalError, Result as Result3 } from "@outfitter/contracts";
+function getInstalledPackages(cwd) {
+  const pkgPath = join4(cwd, "package.json");
+  if (!existsSync4(pkgPath)) {
+    return Result3.err(InternalError.create("No package.json found", { cwd }));
+  }
+  let raw;
+  try {
+    raw = readFileSync4(pkgPath, "utf-8");
+  } catch {
+    return Result3.err(InternalError.create("Failed to read package.json", { cwd }));
+  }
+  let pkg;
+  try {
+    pkg = JSON.parse(raw);
+  } catch {
+    return Result3.err(InternalError.create("Invalid JSON in package.json", { cwd }));
+  }
+  const deps = {
+    ...pkg.dependencies ?? {},
+    ...pkg.devDependencies ?? {}
+  };
+  const packages = [];
+  for (const [name, version] of Object.entries(deps)) {
+    if (!name.startsWith("@outfitter/"))
+      continue;
+    if (version.startsWith("workspace:")) {
+      const wsVersion = version.slice("workspace:".length);
+      if (wsVersion === "*" || wsVersion === "~" || wsVersion === "^") {
+        continue;
+      }
+      const wsClean = wsVersion.replace(/^[\^~>=<]+/, "");
+      try {
+        if (!Bun.semver.satisfies(wsClean, "*"))
+          continue;
+      } catch {
+        continue;
+      }
+      packages.push({ name, version: wsClean });
+      continue;
+    }
+    const cleaned = version.replace(/^[\^~>=<]+/, "");
+    try {
+      if (!Bun.semver.satisfies(cleaned, "*"))
+        continue;
+    } catch {
+      continue;
+    }
+    packages.push({ name, version: cleaned });
+  }
+  return Result3.ok(packages);
+}
+async function getLatestVersion(name) {
+  try {
+    const proc = Bun.spawn(["npm", "view", name, "version"], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    const stdout = await new Response(proc.stdout).text();
+    const exitCode = await proc.exited;
+    if (exitCode !== 0)
+      return null;
+    return stdout.trim() || null;
+  } catch {
+    return null;
+  }
+}
+var MIGRATION_DOC_PATHS = [
+  "plugins/kit/shared/migrations",
+  "node_modules/@outfitter/kit/shared/migrations"
+];
+function findMigrationDocsDir(cwd, binaryDir) {
+  for (const relative of MIGRATION_DOC_PATHS) {
+    const dir = join4(cwd, relative);
+    if (existsSync4(dir))
+      return dir;
+  }
+  let current = resolve4(cwd);
+  const root = resolve4("/");
+  while (current !== root) {
+    const parent = resolve4(current, "..");
+    if (parent === current)
+      break;
+    current = parent;
+    for (const relative of MIGRATION_DOC_PATHS) {
+      const dir = join4(current, relative);
+      if (existsSync4(dir))
+        return dir;
+    }
+  }
+  const resolvedBinaryDir = binaryDir ?? resolve4(import.meta.dir, "../../../..");
+  for (const relative of MIGRATION_DOC_PATHS) {
+    const dir = join4(resolvedBinaryDir, relative);
+    if (existsSync4(dir))
+      return dir;
+  }
+  return null;
+}
+function readMigrationDocs(migrationsDir, shortName, fromVersion, toVersion) {
+  const glob = new Bun.Glob(`outfitter-${shortName}-*.md`);
+  const versionPattern = new RegExp(`^outfitter-${shortName}-(\\d+\\.\\d+\\.\\d+)\\.md$`);
+  const docs = [];
+  for (const entry of glob.scanSync({ cwd: migrationsDir })) {
+    const match = entry.match(versionPattern);
+    if (!match?.[1])
+      continue;
+    const docVersion = match[1];
+    if (Bun.semver.order(docVersion, fromVersion) <= 0)
+      continue;
+    if (Bun.semver.order(docVersion, toVersion) > 0)
+      continue;
+    const filePath = join4(migrationsDir, entry);
+    const content = readFileSync4(filePath, "utf-8");
+    const body = content.replace(/^---\n[\s\S]*?\n---\n*/, "").trim();
+    if (body) {
+      docs.push({ version: docVersion, content: body });
+    }
+  }
+  docs.sort((a, b) => Bun.semver.order(a.version, b.version));
+  return docs.map((d) => d.content);
+}
+async function runUpdate(options) {
+  const cwd = resolve4(options.cwd);
+  const installedResult = getInstalledPackages(cwd);
+  if (installedResult.isErr())
+    return installedResult;
+  const installed = installedResult.value;
+  if (installed.length === 0) {
+    return Result3.ok({
+      packages: [],
+      total: 0,
+      updatesAvailable: 0,
+      hasBreaking: false
+    });
+  }
+  const packages = await Promise.all(installed.map(async (pkg) => {
+    const latest = await getLatestVersion(pkg.name);
+    const updateAvailable = latest !== null && Bun.semver.order(latest, pkg.version) > 0;
+    const breaking = updateAvailable && latest !== null ? getMajor(latest) > getMajor(pkg.version) : false;
+    return {
+      name: pkg.name,
+      current: pkg.version,
+      latest,
+      updateAvailable,
+      breaking
+    };
+  }));
+  const updatesAvailable = packages.filter((p) => p.updateAvailable).length;
+  const hasBreaking = packages.some((p) => p.breaking);
+  return Result3.ok({
+    packages,
+    total: packages.length,
+    updatesAvailable,
+    hasBreaking
+  });
+}
+function getMajor(version) {
+  const parts = version.split(".");
+  return Number.parseInt(parts[0] ?? "0", 10);
+}
+async function printUpdateResults(result, options) {
+  const mode = options?.mode;
+  if (mode === "json" || mode === "jsonl") {
+    await output5(result, { mode });
+    return;
+  }
+  const theme = createTheme4();
+  const lines = ["", "Outfitter Update", "", "=".repeat(60)];
+  if (result.packages.length === 0) {
+    lines.push("No @outfitter/* packages found in package.json.");
+    await output5(lines);
+    return;
+  }
+  lines.push(`  ${"Package".padEnd(28)} ${"Current".padEnd(10)} ${"Available".padEnd(10)} Migration`);
+  lines.push(`  ${"─".repeat(28)} ${"─".repeat(10)} ${"─".repeat(10)} ${"─".repeat(20)}`);
+  for (const pkg of result.packages) {
+    const name = pkg.name.padEnd(28);
+    const current = pkg.current.padEnd(10);
+    const available = (pkg.latest ?? "unknown").padEnd(10);
+    let migration;
+    if (pkg.latest === null) {
+      migration = theme.muted("lookup failed");
+    } else if (!pkg.updateAvailable) {
+      migration = theme.muted("up to date");
+    } else if (pkg.breaking) {
+      migration = theme.error("major (breaking)");
+    } else {
+      migration = theme.success("minor (no breaking)");
+    }
+    lines.push(`  ${name} ${current} ${available} ${migration}`);
+  }
+  lines.push("");
+  if (result.updatesAvailable > 0) {
+    lines.push(theme.muted("Run 'outfitter update --guide' for migration instructions."));
+  } else {
+    lines.push(theme.success("All packages are up to date."));
+  }
+  if (options?.guide && result.updatesAvailable > 0) {
+    const cwd = options.cwd ?? process.cwd();
+    const migrationsDir = findMigrationDocsDir(cwd);
+    if (migrationsDir) {
+      lines.push("", "=".repeat(60), "", "Migration Guide", "");
+      for (const pkg of result.packages) {
+        if (!(pkg.updateAvailable && pkg.latest))
+          continue;
+        const shortName = pkg.name.replace("@outfitter/", "");
+        const docs = readMigrationDocs(migrationsDir, shortName, pkg.current, pkg.latest);
+        for (const doc of docs) {
+          lines.push(doc, "", "---", "");
+        }
+      }
+    } else {
+      lines.push("", theme.muted("Migration docs not found locally. See https://github.com/outfitter-dev/outfitter for migration guides."));
+    }
+  }
+  await output5(lines);
+}
+
 // src/actions.ts
 var outputModeSchema = z.enum(["human", "json", "jsonl"]).optional();
 var initInputSchema = z.object({
@@ -1364,11 +1588,6 @@ var commonInitOptions = [
     flags: "--workspace",
     description: "Alias for --local",
     defaultValue: false
-  },
-  {
-    flags: "--json",
-    description: "Output as JSON",
-    defaultValue: false
   }
 ];
 var templateOption = {
@@ -1394,13 +1613,13 @@ function createInitAction(options) {
       const outputOptions = outputMode ? { mode: outputMode } : undefined;
       const result = await runInit(initInput);
       if (result.isErr()) {
-        return Result3.err(new InternalError({
+        return Result4.err(new InternalError2({
           message: result.error.message,
           context: { action: options.id }
         }));
       }
       await printInitResults(initInput.targetDir, result.value, outputOptions);
-      return Result3.ok({ ok: true });
+      return Result4.ok({ ok: true });
     }
   });
 }
@@ -1429,11 +1648,14 @@ var demoAction = defineAction({
         defaultValue: false
       }
     ],
-    mapInput: (context) => ({
-      section: context.args[0],
-      list: Boolean(context.flags["list"]),
-      animate: Boolean(context.flags["animate"])
-    })
+    mapInput: (context) => {
+      resolveOutputMode(context.flags);
+      return {
+        section: context.args[0],
+        list: Boolean(context.flags["list"]),
+        animate: Boolean(context.flags["animate"])
+      };
+    }
   },
   handler: async (input) => {
     const result = await runDemo(input);
@@ -1441,7 +1663,7 @@ var demoAction = defineAction({
     if (result.exitCode !== 0) {
       process.exit(result.exitCode);
     }
-    return Result3.ok(result);
+    return Result4.ok(result);
   }
 });
 var doctorAction = defineAction({
@@ -1452,13 +1674,6 @@ var doctorAction = defineAction({
   cli: {
     command: "doctor",
     description: "Validate environment and dependencies",
-    options: [
-      {
-        flags: "--json",
-        description: "Output as JSON",
-        defaultValue: false
-      }
-    ],
     mapInput: (context) => {
       const outputMode = resolveOutputMode(context.flags);
       return {
@@ -1475,7 +1690,7 @@ var doctorAction = defineAction({
     if (result.exitCode !== 0) {
       process.exit(result.exitCode);
     }
-    return Result3.ok(result);
+    return Result4.ok(result);
   }
 });
 var addInputSchema = z.object({
@@ -1504,11 +1719,6 @@ var addAction = defineAction({
         flags: "--dry-run",
         description: "Show what would be added without making changes",
         defaultValue: false
-      },
-      {
-        flags: "--json",
-        description: "Output as JSON",
-        defaultValue: false
       }
     ],
     mapInput: (context) => {
@@ -1527,13 +1737,13 @@ var addAction = defineAction({
     const outputOptions = outputMode ? { mode: outputMode } : undefined;
     const result = await runAdd(addInput);
     if (result.isErr()) {
-      return Result3.err(new InternalError({
+      return Result4.err(new InternalError2({
         message: result.error.message,
         context: { action: "add" }
       }));
     }
     await printAddResults(result.value, addInput.dryRun, outputOptions);
-    return Result3.ok(result.value);
+    return Result4.ok(result.value);
   }
 });
 var listBlocksAction = defineAction({
@@ -1545,13 +1755,6 @@ var listBlocksAction = defineAction({
     group: "add",
     command: "list",
     description: "List available blocks",
-    options: [
-      {
-        flags: "--json",
-        description: "Output as JSON",
-        defaultValue: false
-      }
-    ],
     mapInput: (context) => {
       const outputMode = resolveOutputMode(context.flags);
       return {
@@ -1562,21 +1765,72 @@ var listBlocksAction = defineAction({
   handler: async (input) => {
     const result = listBlocks();
     if (result.isErr()) {
-      return Result3.err(new InternalError({
+      return Result4.err(new InternalError2({
         message: result.error.message,
         context: { action: "add.list" }
       }));
     }
     if (input.outputMode === "json" || input.outputMode === "jsonl") {
-      await output5({ blocks: result.value }, { mode: input.outputMode });
+      await output6({ blocks: result.value }, { mode: input.outputMode });
     } else {
       const lines = [
         "Available blocks:",
         ...result.value.map((block) => `  - ${block}`)
       ];
-      await output5(lines);
+      await output6(lines);
+    }
+    return Result4.ok({ blocks: result.value });
+  }
+});
+var updateInputSchema = z.object({
+  cwd: z.string(),
+  guide: z.boolean(),
+  outputMode: outputModeSchema
+});
+var updateAction = defineAction({
+  id: "update",
+  description: "Check for @outfitter/* package updates and migration guidance",
+  surfaces: ["cli"],
+  input: updateInputSchema,
+  cli: {
+    command: "update",
+    description: "Check for @outfitter/* package updates and migration guidance",
+    options: [
+      {
+        flags: "--guide",
+        description: "Show migration instructions for available updates",
+        defaultValue: false
+      },
+      {
+        flags: "--cwd <path>",
+        description: "Working directory (defaults to current directory)"
+      }
+    ],
+    mapInput: (context) => {
+      const outputMode = resolveOutputMode(context.flags);
+      const cwd = typeof context.flags["cwd"] === "string" ? resolve5(process.cwd(), context.flags["cwd"]) : process.cwd();
+      return {
+        cwd,
+        guide: Boolean(context.flags["guide"]),
+        ...outputMode ? { outputMode } : {}
+      };
     }
-    return Result3.ok({ blocks: result.value });
+  },
+  handler: async (input) => {
+    const { outputMode, ...updateInput } = input;
+    const result = await runUpdate(updateInput);
+    if (result.isErr()) {
+      return Result4.err(new InternalError2({
+        message: result.error.message,
+        context: { action: "update" }
+      }));
+    }
+    await printUpdateResults(result.value, {
+      ...outputMode ? { mode: outputMode } : {},
+      guide: updateInput.guide,
+      cwd: updateInput.cwd
+    });
+    return Result4.ok(result.value);
   }
 });
 var outfitterActions = createActionRegistry().add(createInitAction({
@@ -1599,6 +1853,6 @@ var outfitterActions = createActionRegistry().add(createInitAction({
   description: "Scaffold a new daemon project",
   command: "daemon [directory]",
   templateOverride: "daemon"
-})).add(demoAction).add(doctorAction).add(addAction).add(listBlocksAction);
+})).add(demoAction).add(doctorAction).add(addAction).add(listBlocksAction).add(updateAction);
 
 export { runDoctor, printDoctorResults, doctorCommand, InitError, runInit, initCommand, outfitterActions };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "outfitter",
   "description": "Outfitter umbrella CLI for scaffolding and project management",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "files": [
     "dist",
@@ -10,40 +10,34 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    "./commands/demo/errors": {
+    ".": {
       "import": {
-        "types": "./dist/commands/demo/errors.d.ts",
-        "default": "./dist/commands/demo/errors.js"
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
       }
     },
     "./commands/demo": {
       "import": {
-        "types": "./dist/commands/demo.d.ts",
-        "default": "./dist/commands/demo.js"
-      }
-    },
-    "./actions": {
-      "import": {
-        "types": "./dist/actions.d.ts",
-        "default": "./dist/actions.js"
+        "types": "./dist/commands/demo/index.d.ts",
+        "default": "./dist/commands/demo/index.js"
       }
     },
-    ".": {
+    "./commands/demo/errors": {
       "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
+        "types": "./dist/commands/demo/errors.d.ts",
+        "default": "./dist/commands/demo/errors.js"
       }
     },
-    "./commands/doctor": {
+    "./actions": {
       "import": {
-        "types": "./dist/commands/doctor.d.ts",
-        "default": "./dist/commands/doctor.js"
+        "types": "./dist/actions.d.ts",
+        "default": "./dist/actions.js"
       }
     },
-    "./commands/init": {
+    "./commands/update": {
       "import": {
-        "types": "./dist/commands/init.d.ts",
-        "default": "./dist/commands/init.js"
+        "types": "./dist/commands/update.d.ts",
+        "default": "./dist/commands/update.js"
       }
     },
     "./commands/shared-deps": {
@@ -52,12 +46,24 @@
         "default": "./dist/commands/shared-deps.js"
       }
     },
+    "./commands/doctor": {
+      "import": {
+        "types": "./dist/commands/doctor.d.ts",
+        "default": "./dist/commands/doctor.js"
+      }
+    },
     "./commands/add": {
       "import": {
         "types": "./dist/commands/add.d.ts",
         "default": "./dist/commands/add.js"
       }
     },
+    "./commands/init": {
+      "import": {
+        "types": "./dist/commands/init.d.ts",
+        "default": "./dist/commands/init.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "bin": {
@@ -80,11 +86,11 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
-    "@outfitter/cli": "0.2.0",
-    "@outfitter/config": "0.2.0",
+    "@outfitter/cli": "0.3.0",
+    "@outfitter/config": "0.3.0",
     "@outfitter/contracts": "0.2.0",
-    "@outfitter/logging": "0.2.0",
-    "@outfitter/tooling": "0.2.0",
+    "@outfitter/logging": "0.3.0",
+    "@outfitter/tooling": "0.2.1",
     "commander": "^14.0.2",
     "zod": "^4.3.5"
   },