outfitter 0.3.3 → 0.4.0

package/dist/shared/{outfitter-84chvazx.js → outfitter-hw9f0zq9.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   resolveStructuredOutputMode
-} from "./outfitter-7r12fj7f.js";
+} from "./outfitter-sxf8jjjn.js";
 
 // apps/outfitter/src/commands/check-orchestrator.ts
 import { resolve } from "path";
@@ -27,12 +27,12 @@ function normalizePaths(paths) {
   }
   return paths.map((path) => path.trim()).filter((path) => path.length > 0).toSorted();
 }
-function shouldSyncAgentScaffolding(paths) {
-  return paths.some((path) => path === ".claude/settings.json" || path.startsWith(".claude/hooks/"));
-}
 function buildCheckOrchestratorPlan(options) {
   const stagedFiles = normalizePaths(options.stagedFiles);
+  const commandProfile = options.commandProfile ?? "default";
   if (options.mode === "all" || options.mode === "ci") {
+    const typecheckCommand = commandProfile === "hook" ? ["bun", "run", "typecheck:hook"] : ["bun", "run", "typecheck", "--", "--only"];
+    const lintAndFormatCommand = commandProfile === "hook" ? ["bun", "run", "check:hook"] : ["bun", "run", "check"];
     const steps = [
       {
         id: "block-drift",
@@ -50,12 +50,12 @@ function buildCheckOrchestratorPlan(options) {
       {
         id: "typecheck",
         label: "Typecheck",
-        command: ["bun", "run", "typecheck", "--", "--only"]
+        command: typecheckCommand
       },
       {
         id: "lint-and-format",
         label: "Lint/Format checks",
-        command: ["bun", "run", "check"]
+        command: lintAndFormatCommand
       },
       {
         id: "publish-guardrails",
@@ -280,18 +280,26 @@ function buildCheckOrchestratorPlan(options) {
   }
   const hasStagedFiles = stagedFiles.length > 0;
   const tsFiles = stagedFiles.filter((f) => /\.(ts|tsx)$/.test(f));
-  const preCommitSteps = [
-    {
+  const ultraciteFiles = stagedFiles.filter((f) => /\.(js|jsx|mjs|cjs|ts|tsx|mts|cts)$/.test(f));
+  const preCommitSteps = [];
+  if (ultraciteFiles.length > 0) {
+    preCommitSteps.push({
       id: "ultracite-fix",
       label: "Ultracite fix",
-      command: hasStagedFiles ? ["bun", "x", "ultracite", "fix", ...stagedFiles] : ["bun", "x", "ultracite", "fix", "."]
-    },
-    {
-      id: "exports",
-      label: "Exports",
-      command: ["bun", "run", "check-exports"]
-    }
-  ];
+      command: ["bun", "x", "ultracite", "fix", ...ultraciteFiles]
+    });
+  } else if (!hasStagedFiles) {
+    preCommitSteps.push({
+      id: "ultracite-fix",
+      label: "Ultracite fix",
+      command: ["bun", "x", "ultracite", "fix", "."]
+    });
+  }
+  preCommitSteps.push({
+    id: "exports",
+    label: "Exports",
+    command: ["bun", "run", "check-exports"]
+  });
   if (tsFiles.length > 0) {
     preCommitSteps.splice(1, 0, {
       id: "typecheck",
@@ -305,13 +313,6 @@ function buildCheckOrchestratorPlan(options) {
       command: ["bun", "run", "typecheck", "--", "--only"]
     });
   }
-  if (shouldSyncAgentScaffolding(stagedFiles)) {
-    preCommitSteps.push({
-      id: "sync-agent-scaffolding",
-      label: "Sync agent scaffolding",
-      command: ["./scripts/sync-agent-scaffolding.sh"]
-    });
-  }
   return preCommitSteps;
 }
 function parseTreePaths(statusOutput) {
@@ -336,17 +337,19 @@ function diffTreePaths(before, after) {
   const beforeSet = new Set(before);
   return after.filter((path) => !beforeSet.has(path));
 }
-async function runStep(cwd, step) {
+async function runStep(cwd, step, options = {}) {
   const startedAt = Date.now();
   const processHandle = Bun.spawn([...step.command], {
     cwd,
     stdout: "pipe",
     stderr: "pipe"
   });
+  const stdoutTarget = options.streamOutput ? process.stdout : undefined;
+  const stderrTarget = options.streamOutput ? process.stderr : undefined;
   const [exitCode, stdout, stderr] = await Promise.all([
     processHandle.exited,
-    new Response(processHandle.stdout).text(),
-    new Response(processHandle.stderr).text()
+    readOutputStream(processHandle.stdout, stdoutTarget),
+    readOutputStream(processHandle.stderr, stderrTarget)
   ]);
   return {
     id: step.id,
@@ -358,6 +361,36 @@ async function runStep(cwd, step) {
     durationMs: Date.now() - startedAt
   };
 }
+async function readOutputStream(stream, target) {
+  if (!stream) {
+    return "";
+  }
+  const reader = stream.getReader();
+  const decoder = new TextDecoder;
+  const chunks = [];
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        break;
+      }
+      const chunk = decoder.decode(value, { stream: true });
+      if (chunk.length === 0) {
+        continue;
+      }
+      chunks.push(chunk);
+      target?.write(chunk);
+    }
+    const trailingChunk = decoder.decode();
+    if (trailingChunk.length > 0) {
+      chunks.push(trailingChunk);
+      target?.write(trailingChunk);
+    }
+    return chunks.join("");
+  } finally {
+    reader.releaseLock();
+  }
+}
 function extractSuccessAdvisory(stderr) {
   const lines = stderr.split(`
 `).map((line) => line.trim()).filter((line) => line.length > 0);
@@ -385,8 +418,14 @@ async function runCheckOrchestrator(options) {
     }
     const treeBefore = readTreePaths(cwd);
     const stepResults = [];
-    for (const step of plan) {
-      const result = await runStep(cwd, step);
+    for (const [index, step] of plan.entries()) {
+      if (options.streamOutput) {
+        process.stdout.write(`[check ${index + 1}/${plan.length}] ${step.label}
+`);
+      }
+      const result = await runStep(cwd, step, {
+        streamOutput: options.streamOutput
+      });
       stepResults.push(result);
       if (result.exitCode !== 0) {
         break;
@@ -443,11 +482,16 @@ async function printCheckOrchestratorResults(result, options = {}) {
     process.stdout.write(`  ${icon} ${step.label} ${theme.muted(`(${duration})`)}
 `);
     if (step.exitCode !== 0) {
-      const snippet = `${step.stdout}
+      if (options.liveOutput) {
+        process.stdout.write(`    ${theme.muted("Live step output shown above.")}
+`);
+      } else {
+        const snippet = `${step.stdout}
 ${step.stderr}`.trim();
-      if (snippet.length > 0) {
-        process.stdout.write(`${theme.muted(snippet)}
+        if (snippet.length > 0) {
+          process.stdout.write(`${theme.muted(snippet)}
 `);
+        }
       }
     } else {
       const advisory = extractSuccessAdvisory(step.stderr);

package/dist/shared/{outfitter-ksyvwmb5.js → outfitter-jhpcjeg1.js}

@@ -127,22 +127,22 @@ function parseEmbeddedOptions(argv) {
 async function runEmbeddedDemo(options) {
   const mode = toOutputMode(options.outputMode);
   if (options.list) {
-    await output(renderListSections(), { mode });
+    await output(renderListSections(), mode);
     return 0;
   }
   if (options.animate) {
-    await output(renderDemo("spinner"), { mode });
+    await output(renderDemo("spinner"), mode);
     return 0;
   }
   if (options.section === undefined || options.section === "all") {
-    await output(renderAllDemos(), { mode });
+    await output(renderAllDemos(), mode);
     return 0;
   }
   if (!isPrimitiveId(options.section)) {
-    await output(renderUnknownSection(options.section), { mode });
+    await output(renderUnknownSection(options.section), mode);
     return 1;
   }
-  await output(renderDemo(options.section), { mode });
+  await output(renderDemo(options.section), mode);
   return 0;
 }
 async function runEmbeddedFromArgv() {

package/dist/shared/outfitter-kc46jq69.d.ts

@@ -0,0 +1,12 @@
+import { InitPresetId } from "./outfitter-11r5ny73.js";
+type ScaffoldE2EProfileId = "default" | "ci";
+interface ScaffoldE2EProfile {
+	readonly commandTimeoutMs: number;
+	readonly id: ScaffoldE2EProfileId;
+	readonly presets: readonly InitPresetId[];
+}
+declare const DEFAULT_SCAFFOLD_E2E_PRESETS: readonly InitPresetId[];
+declare const SCAFFOLD_E2E_STEPS_PER_PRESET = 3;
+declare function resolveScaffoldE2EProfile(id?: ScaffoldE2EProfileId): ScaffoldE2EProfile;
+declare function getScaffoldE2ESuiteTimeoutBudgetMs(profile: ScaffoldE2EProfile): number;
+export { ScaffoldE2EProfileId, ScaffoldE2EProfile, DEFAULT_SCAFFOLD_E2E_PRESETS, SCAFFOLD_E2E_STEPS_PER_PRESET, resolveScaffoldE2EProfile, getScaffoldE2ESuiteTimeoutBudgetMs };

package/dist/shared/{outfitter-px5sv5gn.js → outfitter-ksg34wka.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   validatePackageName
-} from "./outfitter-q1g58t85.js";
+} from "./outfitter-gvpwpqnc.js";
 import {
   resolveStructuredOutputMode
-} from "./outfitter-7r12fj7f.js";
+} from "./outfitter-sxf8jjjn.js";
 import {
   getWorkspacePatterns,
   hasWorkspacesField
-} from "./outfitter-1fy7byz5.js";
+} from "./outfitter-bsjq8gkk.js";
 
 // apps/outfitter/src/commands/doctor.ts
 import { existsSync, readFileSync } from "fs";
@@ -255,7 +255,7 @@ function runDoctor(options) {
 async function printDoctorResults(result, options) {
   const structuredMode = resolveStructuredOutputMode(options?.mode);
   if (structuredMode) {
-    await output(result, { mode: structuredMode });
+    await output(result, structuredMode);
     return;
   }
   const theme = createTheme();
@@ -306,7 +306,7 @@ async function printDoctorResults(result, options) {
   if (result.exitCode !== 0) {
     lines.push("", theme.muted("Run 'outfitter doctor' after fixing issues to verify."));
   }
-  await output(lines, { mode: "human" });
+  await output(lines, "human");
 }
 function doctorCommand(program) {
   program.command("doctor").description("Validate environment and dependencies").action(async (_flags, command) => {

package/dist/shared/{outfitter-wrcqq29p.js → outfitter-n63ygpv3.js}

@@ -2,28 +2,29 @@
 import {
   SHARED_DEV_DEPS,
   SHARED_SCRIPTS
-} from "./outfitter-tqznjgbm.js";
-import {
-  applyResolvedDependencyVersions,
-  resolvePresetDependencyVersions
-} from "./outfitter-x39awx8g.js";
+} from "./outfitter-23159bef.js";
 import {
   getWorkspacePatterns
-} from "./outfitter-1fy7byz5.js";
+} from "./outfitter-bsjq8gkk.js";
+import {
+  serializePackageJson
+} from "./outfitter-5gaptj9b.js";
 import {
   ScaffoldError
 } from "./outfitter-8y2dfx6n.js";
+import {
+  DEPENDENCY_SECTIONS,
+  applyResolvedDependencyVersions,
+  resolvePresetDependencyVersions
+} from "./outfitter-hr4cvmjy.js";
 
 // apps/outfitter/src/engine/config.ts
 import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
 import { Result } from "@outfitter/contracts";
-var DEPENDENCY_SECTIONS = [
-  "dependencies",
-  "devDependencies",
-  "peerDependencies",
-  "optionalDependencies"
-];
+function formatUnresolvedCatalogMessage(packageJsonPath, unresolvedNames) {
+  return `Unresolved catalog placeholder(s) in ${packageJsonPath}: ` + unresolvedNames.join(", ");
+}
 function getWorkspaceMemberPackageJsonPaths(rootDir, rootPackageJson) {
   const patterns = getWorkspacePatterns(rootPackageJson["workspaces"]);
   const packageJsonPaths = new Set;
@@ -76,23 +77,31 @@ function injectSharedConfig(targetDir) {
   try {
     const content = readFileSync(packageJsonPath, "utf-8");
     const parsed = JSON.parse(content);
-    const dependencyVersions = resolvePresetDependencyVersions();
-    applyResolvedDependencyVersions(parsed, dependencyVersions);
+    const versionsResult = resolvePresetDependencyVersions();
+    if (versionsResult.isErr()) {
+      return Result.err(new ScaffoldError(`Failed to resolve dependency versions: ${versionsResult.error.message}`));
+    }
+    const dependencyVersions = versionsResult.value;
+    const unresolvedRootDeps = applyResolvedDependencyVersions(parsed, dependencyVersions);
+    if (unresolvedRootDeps.length > 0) {
+      return Result.err(new ScaffoldError(formatUnresolvedCatalogMessage(packageJsonPath, unresolvedRootDeps)));
+    }
     const existingDevDeps = parsed["devDependencies"] ?? {};
     parsed["devDependencies"] = { ...SHARED_DEV_DEPS, ...existingDevDeps };
     const existingScripts = parsed["scripts"] ?? {};
     parsed["scripts"] = { ...SHARED_SCRIPTS, ...existingScripts };
-    writeFileSync(packageJsonPath, `${JSON.stringify(parsed, null, 2)}
-`, "utf-8");
+    writeFileSync(packageJsonPath, serializePackageJson(parsed), "utf-8");
     const workspaceMembers = getWorkspaceMemberPackageJsonPaths(targetDir, parsed);
     for (const memberPackageJsonPath of workspaceMembers) {
       const memberContent = readFileSync(memberPackageJsonPath, "utf-8");
       const memberParsed = JSON.parse(memberContent);
       const before = JSON.stringify(memberParsed);
-      applyResolvedDependencyVersions(memberParsed, dependencyVersions);
+      const unresolvedMemberDeps = applyResolvedDependencyVersions(memberParsed, dependencyVersions);
+      if (unresolvedMemberDeps.length > 0) {
+        return Result.err(new ScaffoldError(formatUnresolvedCatalogMessage(memberPackageJsonPath, unresolvedMemberDeps)));
+      }
       if (JSON.stringify(memberParsed) !== before) {
-        writeFileSync(memberPackageJsonPath, `${JSON.stringify(memberParsed, null, 2)}
-`, "utf-8");
+        writeFileSync(memberPackageJsonPath, serializePackageJson(memberParsed), "utf-8");
       }
     }
     return Result.ok(undefined);
@@ -110,16 +119,14 @@ function rewriteLocalDependencies(targetDir) {
     const content = readFileSync(packageJsonPath, "utf-8");
     const parsed = JSON.parse(content);
     if (rewriteOutfitterDepsToWorkspace(parsed)) {
-      writeFileSync(packageJsonPath, `${JSON.stringify(parsed, null, 2)}
-`, "utf-8");
+      writeFileSync(packageJsonPath, serializePackageJson(parsed), "utf-8");
     }
     const workspaceMembers = getWorkspaceMemberPackageJsonPaths(targetDir, parsed);
     for (const memberPackageJsonPath of workspaceMembers) {
       const memberContent = readFileSync(memberPackageJsonPath, "utf-8");
       const memberParsed = JSON.parse(memberContent);
       if (rewriteOutfitterDepsToWorkspace(memberParsed)) {
-        writeFileSync(memberPackageJsonPath, `${JSON.stringify(memberParsed, null, 2)}
-`, "utf-8");
+        writeFileSync(memberPackageJsonPath, serializePackageJson(memberParsed), "utf-8");
       }
     }
     return Result.ok(undefined);

package/dist/shared/{outfitter-qsd5638j.js → outfitter-n9jp1abt.js}

@@ -9,10 +9,18 @@ import {
   sanitizePackageName,
   validatePackageName,
   validateProjectDirectoryName
-} from "./outfitter-q1g58t85.js";
+} from "./outfitter-gvpwpqnc.js";
 import {
-  detectWorkspaceRoot
-} from "./outfitter-1fy7byz5.js";
+  parseBlocks
+} from "./outfitter-xg5yryp2.js";
+import {
+  detectWorkspaceRoot,
+  getWorkspacePatterns,
+  hasWorkspacesField
+} from "./outfitter-bsjq8gkk.js";
+import {
+  serializePackageJson
+} from "./outfitter-5gaptj9b.js";
 
 // apps/outfitter/src/commands/scaffold-planning.ts
 import {
@@ -38,30 +46,6 @@ function readPackageJson(path) {
     return null;
   }
 }
-function hasWorkspacesField(pkg) {
-  const workspaces = pkg.workspaces;
-  if (Array.isArray(workspaces) && workspaces.length > 0) {
-    return true;
-  }
-  if (workspaces && typeof workspaces === "object" && !Array.isArray(workspaces)) {
-    const packages = workspaces.packages;
-    return Array.isArray(packages) && packages.length > 0;
-  }
-  return false;
-}
-function extractWorkspacePatterns(pkg) {
-  const workspaces = pkg.workspaces;
-  if (Array.isArray(workspaces)) {
-    return workspaces.filter((entry) => typeof entry === "string");
-  }
-  if (workspaces && typeof workspaces === "object" && !Array.isArray(workspaces)) {
-    const packages = workspaces.packages;
-    if (Array.isArray(packages)) {
-      return packages.filter((entry) => typeof entry === "string");
-    }
-  }
-  return [];
-}
 function detectProjectStructure(cwd) {
   const resolvedCwd = resolve(cwd);
   const cwdPackageJsonPath = join(resolvedCwd, "package.json");
@@ -71,7 +55,7 @@ function detectProjectStructure(cwd) {
       return Result.ok({
         kind: "workspace",
         rootDir: resolvedCwd,
-        workspacePatterns: extractWorkspacePatterns(cwdPkg)
+        workspacePatterns: getWorkspacePatterns(cwdPkg.workspaces)
       });
     }
     const wsResult2 = detectWorkspaceRoot(resolvedCwd);
@@ -84,7 +68,7 @@ function detectProjectStructure(cwd) {
         return Result.ok({
           kind: "workspace",
           rootDir: wsResult2.value,
-          workspacePatterns: extractWorkspacePatterns(rootPkg)
+          workspacePatterns: getWorkspacePatterns(rootPkg.workspaces)
         });
       }
     }
@@ -104,7 +88,7 @@ function detectProjectStructure(cwd) {
       return Result.ok({
         kind: "workspace",
         rootDir: wsResult.value,
-        workspacePatterns: extractWorkspacePatterns(rootPkg)
+        workspacePatterns: getWorkspacePatterns(rootPkg.workspaces)
       });
     }
   }
@@ -186,7 +170,7 @@ function ensureWorkspacePattern(rootDir, placement, dryRun, collector) {
     return Result.err("Failed to read workspace package.json");
   }
   const pattern = `${placement}/*`;
-  const patterns = [...extractWorkspacePatterns(pkg)];
+  const patterns = [...getWorkspacePatterns(pkg.workspaces)];
   if (patterns.includes(pattern)) {
     return Result.ok(false);
   }
@@ -211,8 +195,7 @@ function ensureWorkspacePattern(rootDir, placement, dryRun, collector) {
   } else {
     nextPkg["workspaces"] = nextPatterns;
   }
-  writeFileSync(packageJsonPath, `${JSON.stringify(nextPkg, null, 2)}
-`, "utf-8");
+  writeFileSync(packageJsonPath, serializePackageJson(nextPkg), "utf-8");
   return Result.ok(true);
 }
 function movePath(source, destination) {
@@ -324,13 +307,6 @@ function convertToWorkspace(rootDir, existingPkg, dryRun, collector) {
     }
   });
 }
-function parseBlocks(withFlag) {
-  if (!withFlag) {
-    return;
-  }
-  const blocks = withFlag.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
-  return blocks.length > 0 ? blocks : undefined;
-}
 function buildScaffoldPlan(target, rootDir, targetName, options) {
   const targetDir = join(rootDir, target.placement, targetName);
   const packageName = targetName;

package/dist/shared/{outfitter-d0kqashd.d.ts → outfitter-nhft74pe.d.ts}

@@ -1,5 +1,5 @@
-import { InitStructure } from "./outfitter-r2awqszh.js";
-import { InitPresetId } from "./outfitter-5d9wbzhh.js";
+import { InitStructure } from "./outfitter-e5x0ybqt.js";
+import { InitPresetId } from "./outfitter-11r5ny73.js";
 import { PostScaffoldResult } from "./outfitter-hcexcvxe.js";
 import { OutputMode } from "@outfitter/cli/types";
 import { Result } from "@outfitter/contracts";
@@ -13,6 +13,8 @@ interface InitOptions {
 	readonly bin?: string | undefined;
 	/** Preview changes without writing to disk. */
 	readonly dryRun?: boolean | undefined;
+	/** Example name to overlay pattern-rich scaffold files (e.g., "todo" for cli, "files" for mcp). */
+	readonly example?: string | undefined;
 	/** Overwrite existing files without prompting. */
 	readonly force: boolean;
 	/** Timeout in milliseconds for `bun install`. */

package/dist/shared/{outfitter-8kmak0wc.d.ts → outfitter-nx1sywpb.d.ts}

@@ -1,4 +1,4 @@
-import { EngineOptions, ScaffoldError, ScaffoldPlan, ScaffoldResult } from "./outfitter-cyvr4r8d.js";
+import { EngineOptions, ScaffoldError, ScaffoldPlan, ScaffoldResult } from "./outfitter-crxe5gth.js";
 import { Result } from "@outfitter/contracts";
 declare function executePlan(plan: ScaffoldPlan, options: EngineOptions): Promise<Result<ScaffoldResult, ScaffoldError>>;
 export { executePlan };

package/dist/shared/{outfitter-5r6q2749.d.ts → outfitter-pw74st5t.d.ts}

@@ -1,4 +1,4 @@
-import { TargetCategory, TargetDefinition, TargetId, TargetScope, TargetStatus } from "./outfitter-58rn1sj1.js";
+import { TargetCategory, TargetDefinition, TargetId, TargetScope, TargetStatus } from "./outfitter-gsjbcta2.js";
 import { NotFoundError, Result, ValidationError } from "@outfitter/contracts";
 declare const TARGET_REGISTRY: ReadonlyMap<TargetId, TargetDefinition>;
 declare const TARGET_IDS: readonly TargetId[];

package/dist/shared/{outfitter-h0wmtxw8.d.ts → outfitter-qka1skyw.d.ts}

@@ -1,4 +1,4 @@
-import { CliOutputMode } from "./outfitter-a79xrm12.js";
+import { CliOutputMode } from "./outfitter-fhahf9f3.js";
 import { Result } from "@outfitter/contracts";
 import { CoverageLevel, TsDocCheckResult } from "@outfitter/tooling";
 /** Validated input for the check-tsdoc action handler. */