outfitter 0.3.3 → 0.4.0

package/dist/shared/{outfitter-6mpkh3zn.js → outfitter-qps83547.js}

@@ -1,27 +1,27 @@
 // @bun
-import {
-  printInitResults
-} from "./outfitter-n0ed012k.js";
-import {
-  isBinaryPreset,
-  parseBlocks,
-  resolvePresetFromFlags
-} from "./outfitter-2z61gp5w.js";
 import {
   executeInitPipeline
-} from "./outfitter-tavatb5p.js";
+} from "./outfitter-gna739c3.js";
 import {
   INIT_TARGET_IDS,
   TARGET_REGISTRY,
   getInitTarget
 } from "./outfitter-g3hvjshg.js";
+import {
+  printInitResults
+} from "./outfitter-ssq33ym3.js";
 import {
   deriveBinName,
   deriveProjectName,
   resolvePackageName,
   sanitizePackageName,
   validatePackageName
-} from "./outfitter-q1g58t85.js";
+} from "./outfitter-gvpwpqnc.js";
+import {
+  isBinaryPreset,
+  parseBlocks,
+  resolvePresetFromFlags
+} from "./outfitter-xg5yryp2.js";
 
 // apps/outfitter/src/commands/init.ts
 import { basename, resolve } from "path";
@@ -35,6 +35,7 @@ import {
   text
 } from "@clack/prompts";
 import { exitWithError } from "@outfitter/cli";
+import { resolveOutputMode as resolveOutputModeFromFlags } from "@outfitter/cli/query";
 import { Result } from "@outfitter/contracts";
 class InitError extends Error {
   _tag = "InitError";
@@ -83,7 +84,8 @@ async function resolveInitInput(options, presetOverride) {
       local: Boolean(options.local),
       ...blocksOverride2 ? { blocksOverride: blocksOverride2 } : {},
       ...workspaceName2 ? { workspaceName: workspaceName2 } : {},
-      ...options.bin ? { binName: options.bin } : {}
+      ...options.bin ? { binName: options.bin } : {},
+      ...options.example ? { example: options.example } : {}
     });
   }
   intro("Outfitter init");
@@ -211,7 +213,8 @@ async function resolveInitInput(options, presetOverride) {
     local: Boolean(localValue),
     ...blocksOverride ? { blocksOverride } : {},
     ...workspaceName ? { workspaceName } : {},
-    ...binName ? { binName } : {}
+    ...binName ? { binName } : {},
+    ...options.example ? { example: options.example } : {}
   });
 }
 async function runInit(options, presetOverride) {
@@ -244,12 +247,10 @@ var resolveLocal = (flags) => {
   return;
 };
 var resolveOutputMode = (flags) => {
-  if (flags.json) {
-    return "json";
-  }
-  return;
+  const { mode } = resolveOutputModeFromFlags(flags);
+  return mode === "human" ? undefined : mode;
 };
-var withCommonOptions = (command) => command.option("-n, --name <name>", "Package name (defaults to directory name)").option("-b, --bin <name>", "Binary name (defaults to project name)").option("-p, --preset <preset>", "Preset to use (minimal|cli|mcp|daemon|library|full-stack)").option("-s, --structure <mode>", "Project structure (single|workspace)").option("--workspace-name <name>", "Workspace root package name").option("-f, --force", "Overwrite existing files", false).option("--local", "Use workspace:* for @outfitter dependencies").option("--workspace", "Alias for --local").option("--with <blocks>", "Comma-separated tooling blocks to add").option("--no-tooling", "Skip default tooling blocks").option("-y, --yes", "Skip prompts and use defaults", false).option("--dry-run", "Preview changes without writing files", false).option("--skip-install", "Skip bun install", false).option("--skip-git", "Skip git init and initial commit", false).option("--skip-commit", "Skip initial commit only", false).option("--install-timeout <ms>", "bun install timeout in ms");
+var withCommonOptions = (command) => command.option("-n, --name <name>", "Package name (defaults to directory name)").option("-b, --bin <name>", "Binary name (defaults to project name)").option("-e, --example <name>", "Scaffold with a pattern-rich example (cli: todo; mcp: files)").option("-p, --preset <preset>", "Preset to use (basic|minimal|cli|mcp|daemon|library|full-stack)").option("-s, --structure <mode>", "Project structure (single|workspace)").option("--workspace-name <name>", "Workspace root package name").option("-f, --force", "Overwrite existing files", false).option("--local", "Use workspace:* for @outfitter dependencies").option("--workspace", "Alias for --local").option("--with <blocks>", "Comma-separated tooling blocks to add").option("--no-tooling", "Skip default tooling blocks").option("-y, --yes", "Skip prompts and use defaults", false).option("--dry-run", "Preview changes without writing files", false).option("--skip-install", "Skip bun install", false).option("--skip-git", "Skip git init and initial commit", false).option("--skip-commit", "Skip initial commit only", false).option("--install-timeout <ms>", "bun install timeout in ms");
 function initCommand(program) {
   const init = program.command("init").description("Create a new Outfitter project");
   const resolveFlags = (flags, command) => {
@@ -274,6 +275,7 @@ function initCommand(program) {
       force: resolvedFlags.force ?? false,
       with: resolvedFlags.with,
       noTooling: resolvedFlags.noTooling,
+      example: resolvedFlags.example,
       yes: resolvedFlags.yes,
       dryRun: Boolean(resolvedFlags.dryRun),
       skipInstall: Boolean(resolvedFlags.skipInstall),
@@ -282,7 +284,7 @@ function initCommand(program) {
       ...resolvedFlags.installTimeout !== undefined ? { installTimeout: resolvedFlags.installTimeout } : {}
     });
     if (result.isErr()) {
-      exitWithError(result.error, outputOptions);
+      exitWithError(result.error, mode);
       return;
     }
     await printInitResults(result.value, outputOptions);
@@ -302,6 +304,7 @@ function initCommand(program) {
       force: resolvedFlags.force ?? false,
       with: resolvedFlags.with,
       noTooling: resolvedFlags.noTooling,
+      example: resolvedFlags.example,
       yes: resolvedFlags.yes,
       dryRun: Boolean(resolvedFlags.dryRun),
       skipInstall: Boolean(resolvedFlags.skipInstall),
@@ -310,7 +313,7 @@ function initCommand(program) {
       ...resolvedFlags.installTimeout !== undefined ? { installTimeout: resolvedFlags.installTimeout } : {}
     }, "cli");
     if (result.isErr()) {
-      exitWithError(result.error, outputOptions);
+      exitWithError(result.error, mode);
       return;
     }
     await printInitResults(result.value, outputOptions);
@@ -330,6 +333,7 @@ function initCommand(program) {
       force: resolvedFlags.force ?? false,
       with: resolvedFlags.with,
       noTooling: resolvedFlags.noTooling,
+      example: resolvedFlags.example,
       yes: resolvedFlags.yes,
       dryRun: Boolean(resolvedFlags.dryRun),
       skipInstall: Boolean(resolvedFlags.skipInstall),
@@ -338,7 +342,7 @@ function initCommand(program) {
       ...resolvedFlags.installTimeout !== undefined ? { installTimeout: resolvedFlags.installTimeout } : {}
     }, "mcp");
     if (result.isErr()) {
-      exitWithError(result.error, outputOptions);
+      exitWithError(result.error, mode);
       return;
     }
     await printInitResults(result.value, outputOptions);
@@ -358,6 +362,7 @@ function initCommand(program) {
       force: resolvedFlags.force ?? false,
       with: resolvedFlags.with,
       noTooling: resolvedFlags.noTooling,
+      example: resolvedFlags.example,
       yes: resolvedFlags.yes,
       dryRun: Boolean(resolvedFlags.dryRun),
       skipInstall: Boolean(resolvedFlags.skipInstall),
@@ -366,7 +371,7 @@ function initCommand(program) {
       ...resolvedFlags.installTimeout !== undefined ? { installTimeout: resolvedFlags.installTimeout } : {}
     }, "daemon");
     if (result.isErr()) {
-      exitWithError(result.error, outputOptions);
+      exitWithError(result.error, mode);
       return;
     }
     await printInitResults(result.value, outputOptions);
@@ -386,6 +391,7 @@ function initCommand(program) {
       force: resolvedFlags.force ?? false,
       with: resolvedFlags.with,
       noTooling: resolvedFlags.noTooling,
+      example: resolvedFlags.example,
       yes: resolvedFlags.yes,
       dryRun: Boolean(resolvedFlags.dryRun),
       skipInstall: Boolean(resolvedFlags.skipInstall),
@@ -394,7 +400,7 @@ function initCommand(program) {
       ...resolvedFlags.installTimeout !== undefined ? { installTimeout: resolvedFlags.installTimeout } : {}
     }, "library");
     if (result.isErr()) {
-      exitWithError(result.error, outputOptions);
+      exitWithError(result.error, mode);
       return;
     }
     await printInitResults(result.value, outputOptions);
@@ -414,6 +420,7 @@ function initCommand(program) {
       force: resolvedFlags.force ?? false,
       with: resolvedFlags.with,
       noTooling: resolvedFlags.noTooling,
+      example: resolvedFlags.example,
       yes: resolvedFlags.yes,
       dryRun: Boolean(resolvedFlags.dryRun),
       skipInstall: Boolean(resolvedFlags.skipInstall),
@@ -422,7 +429,7 @@ function initCommand(program) {
       ...resolvedFlags.installTimeout !== undefined ? { installTimeout: resolvedFlags.installTimeout } : {}
     }, "full-stack");
     if (result.isErr()) {
-      exitWithError(result.error, outputOptions);
+      exitWithError(result.error, mode);
       return;
     }
     await printInitResults(result.value, outputOptions);

package/dist/shared/outfitter-qzd5djgx.js

@@ -0,0 +1,88 @@
+// @bun
+import {
+  resolveScaffoldE2EPresets
+} from "./outfitter-x0r7mfvy.js";
+import {
+  resolveScaffoldE2EProfile
+} from "./outfitter-4bs5a2n4.js";
+import {
+  DEFAULT_SCAFFOLD_E2E_RETENTION_MS
+} from "./outfitter-z6tg0swx.js";
+
+// apps/outfitter/src/scaffold-e2e/cli.ts
+function parseScaffoldE2EArgs(argv) {
+  let clean = false;
+  let keep = process.env["OUTFITTER_SCAFFOLD_E2E_KEEP"] === "1";
+  let rootDir = process.env["OUTFITTER_SCAFFOLD_E2E_ROOT"];
+  let maxAgeMs = DEFAULT_SCAFFOLD_E2E_RETENTION_MS;
+  let profile = "default";
+  const presets = [];
+  for (let index = 0;index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--clean") {
+      clean = true;
+      continue;
+    }
+    if (arg === "--ci") {
+      profile = "ci";
+      continue;
+    }
+    if (arg === "--keep") {
+      keep = true;
+      continue;
+    }
+    if (arg === "--root") {
+      const value = argv[index + 1];
+      if (!value) {
+        throw new Error("Missing value for --root");
+      }
+      rootDir = value;
+      index += 1;
+      continue;
+    }
+    if (arg === "--max-age-hours") {
+      const value = argv[index + 1];
+      if (!value) {
+        throw new Error("Missing value for --max-age-hours");
+      }
+      const hours = Number(value);
+      if (!Number.isFinite(hours) || hours < 0) {
+        throw new Error(`Invalid --max-age-hours value: ${value}`);
+      }
+      maxAgeMs = hours * 60 * 60 * 1000;
+      index += 1;
+      continue;
+    }
+    if (arg === "--preset") {
+      const value = argv[index + 1];
+      if (!value) {
+        throw new Error("Missing value for --preset");
+      }
+      presets.push(value);
+      index += 1;
+      continue;
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+  if (clean && presets.length > 0) {
+    throw new Error("--clean cannot be combined with --preset");
+  }
+  return {
+    clean,
+    keep,
+    maxAgeMs,
+    presets: presets.length > 0 ? presets : undefined,
+    profile,
+    rootDir
+  };
+}
+function resolveScaffoldE2EScriptPlan(args) {
+  const profile = resolveScaffoldE2EProfile(args.profile);
+  const presets = args.presets ? resolveScaffoldE2EPresets(args.presets) : profile.presets;
+  return {
+    profile,
+    presets
+  };
+}
+
+export { parseScaffoldE2EArgs, resolveScaffoldE2EScriptPlan };

package/dist/shared/{outfitter-hf5bj2gq.js → outfitter-sh015v8k.js}

@@ -7,7 +7,7 @@ import {
 } from "./outfitter-svts4wk2.js";
 import {
   resolveStructuredOutputMode
-} from "./outfitter-7r12fj7f.js";
+} from "./outfitter-sxf8jjjn.js";
 
 // apps/outfitter/src/commands/docs-search.ts
 import { readFile } from "fs/promises";
@@ -82,7 +82,7 @@ async function printDocsSearchResults(result, options) {
       });
       process.stdout.write(filtered);
     } else {
-      await output(result, { mode: structuredMode });
+      await output(result, structuredMode);
     }
     return;
   }
@@ -90,7 +90,7 @@ async function printDocsSearchResults(result, options) {
   const lines = [];
   if (result.total === 0) {
     lines.push(theme.muted(`No documentation entries matched "${result.query}".`));
-    await output(lines, { mode: "human" });
+    await output(lines, "human");
     return;
   }
   lines.push("");
@@ -111,7 +111,7 @@ async function printDocsSearchResults(result, options) {
     }
     lines.push("");
   }
-  await output(lines, { mode: "human" });
+  await output(lines, "human");
 }
 
 export { runDocsSearch, printDocsSearchResults };

package/dist/shared/{outfitter-ypcvwg1s.js → outfitter-srznx3hj.js}

@@ -60,7 +60,7 @@ async function writeManifest(cwd, manifest) {
     } else {
       mkdirSync(dirPath, { recursive: true });
     }
-    const content = JSON.stringify(manifest, null, "\t");
+    const content = JSON.stringify(manifest, null, 2);
     await Bun.write(path, `${content}
 `);
     return Result.ok(undefined);

package/dist/shared/{outfitter-n0ed012k.js → outfitter-ssq33ym3.js}

@@ -1,13 +1,13 @@
 // @bun
+import {
+  OperationCollector
+} from "./outfitter-1h7k8xxt.js";
 import {
   renderOperationPlan
-} from "./outfitter-ttjr95y9.js";
+} from "./outfitter-7krhbg3b.js";
 import {
   resolveStructuredOutputMode
-} from "./outfitter-7r12fj7f.js";
-import {
-  OperationCollector
-} from "./outfitter-1h7k8xxt.js";
+} from "./outfitter-sxf8jjjn.js";
 
 // apps/outfitter/src/commands/init-output.ts
 import { realpath } from "fs/promises";
@@ -29,7 +29,7 @@ async function printInitResults(result, options) {
         preset: result.preset,
         packageName: result.packageName,
         ...result.dryRunPlan
-      }, { mode: structuredMode });
+      }, structuredMode);
       return;
     }
     const collector = new OperationCollector;
@@ -49,7 +49,7 @@ async function printInitResults(result, options) {
       blocksAdded: result.blocksAdded ?? null,
       postScaffold: result.postScaffold,
       nextSteps: result.postScaffold.nextSteps
-    }, { mode: structuredMode });
+    }, structuredMode);
     return;
   }
   const lines = [
@@ -95,7 +95,7 @@ async function printInitResults(result, options) {
   for (const step of result.postScaffold.nextSteps) {
     lines.push(`  ${step}`);
   }
-  await output(lines, { mode: "human" });
+  await output(lines, "human");
 }
 
 export { printInitResults };

package/dist/shared/outfitter-sxf8jjjn.js

@@ -0,0 +1,7 @@
+// @bun
+// apps/outfitter/src/output-mode.ts
+function resolveStructuredOutputMode(mode) {
+  return mode === "json" || mode === "jsonl" ? mode : undefined;
+}
+
+export { resolveStructuredOutputMode };

package/dist/shared/{outfitter-p2wn07b7.js → outfitter-t535h0mw.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   resolveStructuredOutputMode
-} from "./outfitter-7r12fj7f.js";
+} from "./outfitter-sxf8jjjn.js";
 
 // apps/outfitter/src/commands/check-action-ceremony.ts
 import { readdirSync } from "fs";

package/dist/shared/{outfitter-znbqe5zy.d.ts → outfitter-t8dg4tg5.d.ts}

@@ -1,4 +1,4 @@
-import { CliOutputMode } from "./outfitter-a79xrm12.js";
+import { CliOutputMode } from "./outfitter-fhahf9f3.js";
 import { InternalError, Result } from "@outfitter/contracts";
 /** Validated input for the docs.list action handler. */
 interface DocsListInput {

package/dist/shared/{outfitter-ydw7x6bh.js → outfitter-t8mvabed.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   runAdd
-} from "./outfitter-3tx3adgj.js";
+} from "./outfitter-ez7qffv5.js";
 import {
   ScaffoldError
 } from "./outfitter-8y2dfx6n.js";

package/dist/shared/{outfitter-6ddf91vh.js → outfitter-t9xkn37g.js}

@@ -5,27 +5,27 @@ import {
   detectProjectStructure,
   ensureWorkspacePattern,
   validateScaffoldTargetName
-} from "./outfitter-qsd5638j.js";
+} from "./outfitter-n9jp1abt.js";
 import {
   getScaffoldTarget
 } from "./outfitter-g3hvjshg.js";
+import {
+  printScaffoldResults
+} from "./outfitter-00wxeg2g.js";
 import {
   deriveProjectName,
   executePlan,
   isPathWithin
-} from "./outfitter-q1g58t85.js";
+} from "./outfitter-gvpwpqnc.js";
 import {
-  printScaffoldResults
-} from "./outfitter-qsrx7m4w.js";
+  OperationCollector
+} from "./outfitter-1h7k8xxt.js";
 import {
   runPostScaffold
-} from "./outfitter-4s9meh3j.js";
+} from "./outfitter-4w9sc6bw.js";
 import {
   scaffoldWorkspaceRoot
-} from "./outfitter-1fy7byz5.js";
-import {
-  OperationCollector
-} from "./outfitter-1h7k8xxt.js";
+} from "./outfitter-bsjq8gkk.js";
 
 // apps/outfitter/src/commands/scaffold.ts
 import { existsSync } from "fs";
@@ -166,7 +166,6 @@ function scaffoldCommand(program) {
   program.command("scaffold <target> [name]").description("Add a capability to an existing project").option("-f, --force", "Overwrite existing files", false).option("--skip-install", "Skip bun install", false).option("--dry-run", "Preview changes without executing", false).option("--with <blocks>", "Comma-separated tooling blocks to add").option("--no-tooling", "Skip default tooling blocks").option("--local", "Use workspace:* for @outfitter dependencies").option("--install-timeout <ms>", "bun install timeout in ms").action(async (target, name, _flags, command) => {
     const resolvedFlags = command.optsWithGlobals();
     const mode = resolvedFlags.json ? "json" : undefined;
-    const outputOptions = mode ? { mode } : undefined;
     const result = await runScaffold({
       target,
       name,
@@ -180,10 +179,10 @@ function scaffoldCommand(program) {
       ...resolvedFlags.installTimeout !== undefined ? { installTimeout: resolvedFlags.installTimeout } : {}
     });
     if (result.isErr()) {
-      exitWithError(result.error, outputOptions);
+      exitWithError(result.error, mode);
       return;
     }
-    await printScaffoldResults(result.value, outputOptions);
+    await printScaffoldResults(result.value, mode ? { mode } : undefined);
   });
 }
 

package/dist/shared/{outfitter-x4cc5xsq.js → outfitter-wmgzyymq.js}

@@ -5,7 +5,7 @@ import {
 } from "./outfitter-fx1m251y.js";
 import {
   resolveStructuredOutputMode
-} from "./outfitter-7r12fj7f.js";
+} from "./outfitter-sxf8jjjn.js";
 
 // apps/outfitter/src/commands/upgrade-output.ts
 import { output } from "@outfitter/cli";
@@ -13,7 +13,7 @@ import { createTheme } from "@outfitter/tui/render";
 async function printUpgradeResults(result, options) {
   const structuredMode = resolveStructuredOutputMode(options?.mode);
   if (structuredMode) {
-    await output(result, { mode: structuredMode });
+    await output(result, structuredMode);
     return;
   }
   const theme = createTheme();
@@ -21,7 +21,7 @@ async function printUpgradeResults(result, options) {
   if (result.packages.length === 0) {
     lines.push("No @outfitter/* packages found in package.json.");
     if (!result.unknownPackages || result.unknownPackages.length === 0) {
-      await output(lines, { mode: "human" });
+      await output(lines, "human");
       return;
     }
     lines.push("");
@@ -162,7 +162,7 @@ async function printUpgradeResults(result, options) {
       lines.push("", theme.muted("Migration docs not found locally. See https://github.com/outfitter-dev/outfitter for migration guides."));
     }
   }
-  await output(lines, { mode: "human" });
+  await output(lines, "human");
 }
 
 export { printUpgradeResults };

package/dist/shared/outfitter-wna6gp2t.js

@@ -0,0 +1,56 @@
+// @bun
+import {
+  upgradeAction,
+  upgradeCodemodAction
+} from "./outfitter-0xp447gf.js";
+import {
+  createAction,
+  initAction,
+  initBasicAction,
+  initCliAction,
+  initDaemonAction,
+  initFullStackAction,
+  initLibraryAction,
+  initMcpAction
+} from "./outfitter-4t818mq5.js";
+import {
+  docsApiAction,
+  docsExportAction,
+  docsListAction,
+  docsSearchAction,
+  docsShowAction
+} from "./outfitter-zmzrsvcn.js";
+import {
+  doctorAction
+} from "./outfitter-0cspz333.js";
+import {
+  demoAction
+} from "./outfitter-93e1shd4.js";
+import {
+  checkAction,
+  checkTsdocAction
+} from "./outfitter-dna8exj2.js";
+import {
+  addAction,
+  listBlocksAction
+} from "./outfitter-247et71q.js";
+import {
+  checkActionCeremonyAction,
+  checkActionRegistryAction,
+  checkDocsSentinelAction,
+  checkPresetVersionsAction,
+  checkPublishGuardrailsAction,
+  checkSurfaceMapAction,
+  checkSurfaceMapFormatAction
+} from "./outfitter-aa5nzw14.js";
+import {
+  scaffoldAction
+} from "./outfitter-3f261xh0.js";
+
+// apps/outfitter/src/actions.ts
+import {
+  createActionRegistry
+} from "@outfitter/contracts";
+var outfitterActions = createActionRegistry().add(createAction).add(scaffoldAction).add(initAction).add(initBasicAction).add(initCliAction).add(initMcpAction).add(initDaemonAction).add(initLibraryAction).add(initFullStackAction).add(demoAction).add(doctorAction).add(addAction).add(listBlocksAction).add(checkAction).add(checkTsdocAction).add(checkPublishGuardrailsAction).add(checkPresetVersionsAction).add(checkSurfaceMapAction).add(checkSurfaceMapFormatAction).add(checkDocsSentinelAction).add(checkActionCeremonyAction).add(checkActionRegistryAction).add(upgradeAction).add(upgradeCodemodAction).add(docsListAction).add(docsShowAction).add(docsSearchAction).add(docsApiAction).add(docsExportAction);
+
+export { outfitterActions };