ai-engineering-kit 0.3.0 → 0.4.0

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { basename as basename2 } from "path";
-import { intro, outro, confirm, select, isCancel as isCancel2, cancel as cancel2, log } from "@clack/prompts";
+import { basename as basename3 } from "path";
+import { intro, outro, confirm, select as select2, isCancel as isCancel2, cancel as cancel2, note } from "@clack/prompts";
 
 // src/catalog/load.ts
 import { readdirSync, readFileSync } from "fs";
@@ -162,6 +162,31 @@ function resolveSelection(catalog, selection) {
   });
 }
 
+// src/menu/summary.ts
+import { basename } from "path";
+var labelOf = (id) => COMPONENTS.find((c) => c.id === id)?.label ?? id;
+function summarize(files, plan) {
+  const byPath = new Map(files.map((f) => [f.targetPath, f]));
+  const groups = /* @__PURE__ */ new Map();
+  const conflicts = [];
+  let written = 0;
+  for (const action of plan.actions) {
+    if (action.type === "conflict") {
+      conflicts.push(action.path);
+      continue;
+    }
+    if (action.type !== "add" && action.type !== "refresh") continue;
+    const file = byPath.get(action.path);
+    if (!file) continue;
+    written++;
+    const group = groups.get(file.component) ?? groups.set(file.component, { component: file.component, label: labelOf(file.component), count: 0, names: [] }).get(file.component);
+    group.count++;
+    if (file.component === "entry-files") group.names.push(basename(file.targetPath));
+  }
+  const ordered = COMPONENTS.map((c) => groups.get(c.id)).filter((g) => g !== void 0);
+  return { groups: ordered, conflicts, written };
+}
+
 // src/planner/planner.ts
 function planInstall(input) {
   const files = resolveSelection(input.catalog, input.selection);
@@ -338,8 +363,8 @@ On Windows, enable Developer Mode (or run as admin) and re-run, or point Claude
 }
 
 // src/menu/prompt.ts
-import { basename } from "path";
-import { multiselect, text, isCancel, cancel } from "@clack/prompts";
+import { basename as basename2 } from "path";
+import { select, multiselect, text, isCancel, cancel } from "@clack/prompts";
 
 // src/menu/menu.ts
 function componentOptions() {
@@ -351,6 +376,13 @@ function categoryOptions() {
 function agentOptions() {
   return AGENTS.map((a) => ({ value: a.id, label: a.label, hint: a.hint }));
 }
+function presetSelection(preset) {
+  return {
+    components: COMPONENTS.map((c) => c.id),
+    categories: preset === "everything" ? CATEGORIES.map((c) => c.id) : ["core-workflow"],
+    agents: AGENTS.map((a) => a.id)
+  };
+}
 function buildSelection(answers) {
   return {
     components: answers.components,
@@ -367,35 +399,31 @@ function required(value) {
   }
   return value;
 }
-var allValues = (options) => options.map((o) => o.value);
-async function pickAll(message, options) {
-  return required(
-    await multiselect({
-      message: `${message} (everything is pre-selected \u2014 toggle off what you don't want)`,
-      options,
-      initialValues: allValues(options),
-      required: true
-    })
-  );
+async function pick(message, options) {
+  return required(await multiselect({ message, options, required: true }));
+}
+async function chooseSelection() {
+  const components = await pick("Select parts to install", componentOptions());
+  const categories = components.includes("skills") ? await pick("Select skill categories", categoryOptions()) : [];
+  const agents = components.includes("entry-files") ? await pick("Select coding agents", agentOptions()) : [];
+  return buildSelection({ components, categories, agents });
 }
 async function promptForSelection(projectDir) {
-  const components = await pickAll("Which parts do you want to install?", componentOptions());
-  let categories = [];
-  if (components.includes("skills")) {
-    categories = await pickAll("Which skill categories?", categoryOptions());
-  }
-  let agents = [];
-  if (components.includes("entry-files")) {
-    agents = await pickAll("Which coding agents?", agentOptions());
-  }
-  const projectName = required(
-    await text({
-      message: "Project name",
-      defaultValue: basename(projectDir),
-      placeholder: basename(projectDir)
+  const mode = required(
+    await select({
+      message: `How do you want to set up ${basename2(projectDir)}?`,
+      options: [
+        { value: "everything", label: "Everything", hint: "all skills, docs, and workspace \u2014 Claude Code + Codex" },
+        { value: "core", label: "Core skills only", hint: "core-workflow skills, docs, and workspace \u2014 both agents" },
+        { value: "choose", label: "Choose what to install\u2026", hint: "pick components, skill categories, and agents" }
+      ]
     })
   );
-  return { selection: buildSelection({ components, categories, agents }), projectName };
+  const selection = mode === "choose" ? await chooseSelection() : presetSelection(mode);
+  const projectName = selection.components.includes("entry-files") ? required(
+    await text({ message: "Project name", defaultValue: basename2(projectDir), placeholder: basename2(projectDir) })
+  ) : basename2(projectDir);
+  return { selection, projectName };
 }
 
 // src/applier/update.ts
@@ -547,7 +575,29 @@ function planFor(projectDir, selection) {
     onDisk: readOnDiskHashes(projectDir, files),
     manifest: readManifest(projectDir)
   });
-  return { catalog, plan };
+  return { catalog, files, plan };
+}
+function formatSummary(summary) {
+  if (summary.written === 0 && summary.conflicts.length === 0) return "Everything is already up to date.";
+  const width = Math.max(0, ...summary.groups.map((g) => g.label.length));
+  const lines = summary.groups.map((g) => {
+    const detail = g.names.length > 0 ? g.names.join(", ") : String(g.count);
+    return `  ${g.label.padEnd(width)}  ${detail}`;
+  });
+  if (summary.conflicts.length > 0) {
+    lines.push("", `Conflicts \u2014 you edited these (you'll choose per file):`);
+    for (const path of summary.conflicts) lines.push(`  ${path}`);
+  }
+  return lines.join("\n");
+}
+function successOutro(verb, written, selection) {
+  if (selection.components.includes("skills")) {
+    note(
+      "Open your coding agent in this project and run a skill:\n  setup-foundations   fill in docs/foundations\n  kickoff             brainstorm an MVP",
+      "Next steps"
+    );
+  }
+  outro(`${verb} ${written} file${written === 1 ? "" : "s"}.`);
 }
 function reportConflict(error) {
   if (!(error instanceof ApplyConflictError)) return false;
@@ -567,7 +617,7 @@ function dryRun(args) {
 function init(args) {
   const projectDir = process.cwd();
   const selection = selectionFromArgs(args);
-  const projectName = parseValue(args, "--name") ?? basename2(projectDir);
+  const projectName = parseValue(args, "--name") ?? basename3(projectDir);
   try {
     const result = runInit({ projectDir, selection, projectName });
     console.log(`ai-engineering-kit ${kitVersion()} installed into ${projectDir}`);
@@ -587,7 +637,7 @@ async function runReRun(projectDir) {
   const manifest = readManifest(projectDir);
   intro(`ai-engineering-kit ${kitVersion()} \u2014 already installed`);
   const mode = bail(
-    await select({
+    await select2({
       message: "What would you like to do?",
       options: [
         { value: "update", label: "Update installed parts to latest" },
@@ -597,7 +647,7 @@ async function runReRun(projectDir) {
     })
   );
   let addParts = EMPTY_SELECTION;
-  let projectName = basename2(projectDir);
+  let projectName = basename3(projectDir);
   if (mode === "add" || mode === "both") {
     const picked = await promptForSelection(projectDir);
     addParts = picked.selection;
@@ -607,24 +657,27 @@ async function runReRun(projectDir) {
   const applicable = {
     actions: prepared.plan.actions.filter((a) => prepared.applyTypes.has(a.type))
   };
-  log.message(formatPlan(applicable));
+  const pending = applicable.actions.filter((a) => a.type !== "skip").length;
+  if (pending === 0) {
+    outro("Already up to date \u2014 nothing to do.");
+    return;
+  }
+  note(formatSummary(summarize(prepared.files, applicable)), mode === "add" ? "This will add" : "This will update");
   const resolutions = /* @__PURE__ */ new Map();
-  if (prepared.applyTypes.has("conflict")) {
-    for (const action of applicable.actions.filter((a) => a.type === "conflict")) {
-      const choice = bail(
-        await select({
-          message: `You edited ${action.path}. A newer version exists.`,
-          options: [
-            { value: "keep-mine", label: "Keep mine" },
-            { value: "overwrite", label: "Overwrite with the new version" },
-            { value: "keep-theirs", label: "Keep mine, save theirs as .new" }
-          ]
-        })
-      );
-      resolutions.set(action.path, choice);
-    }
+  const conflicts = applicable.actions.filter((a) => a.type === "conflict");
+  for (const [index, action] of conflicts.entries()) {
+    const choice = bail(
+      await select2({
+        message: `Conflict ${index + 1}/${conflicts.length}: you edited ${action.path}, and a newer version exists.`,
+        options: [
+          { value: "keep-mine", label: "Keep mine", hint: "discard the update for this file" },
+          { value: "overwrite", label: "Use the new version", hint: "replace your file" },
+          { value: "keep-theirs", label: "Keep mine + save theirs", hint: `writes ${basename3(action.path)}.new` }
+        ]
+      })
+    );
+    resolutions.set(action.path, choice);
   }
-  const pending = applicable.actions.filter((a) => a.type !== "skip").length;
   const proceed = await confirm({ message: `Apply ${pending} changes in ${projectDir}?` });
   if (isCancel2(proceed) || !proceed) {
     outro("Nothing written.");
@@ -642,24 +695,24 @@ async function runReRun(projectDir) {
     projectName,
     applyTypes: prepared.applyTypes
   });
-  outro(`Done. ${result.written.length} files written.`);
+  successOutro(mode === "add" ? "Added" : "Updated", result.written.length, prepared.selection);
 }
 async function runInteractive() {
   const projectDir = process.cwd();
   if (readManifest(projectDir)) return runReRun(projectDir);
   intro(`ai-engineering-kit ${kitVersion()}`);
   const { selection, projectName } = await promptForSelection(projectDir);
-  const { plan } = planFor(projectDir, selection);
-  log.message(formatPlan(plan));
+  const { files, plan } = planFor(projectDir, selection);
+  note(formatSummary(summarize(files, plan)), "This will add");
   const pending = plan.actions.filter((a) => a.type !== "skip").length;
-  const proceed = await confirm({ message: `Scaffold ${pending} files into ${projectDir}?` });
+  const proceed = await confirm({ message: `Install ${pending} files into ${projectDir}?` });
   if (isCancel2(proceed) || !proceed) {
     outro("Nothing written.");
     return;
   }
   try {
     const result = runInit({ projectDir, selection, projectName });
-    outro(`Installed ${result.written.length} files into ${projectDir}.`);
+    successOutro("Installed", result.written.length, selection);
   } catch (error) {
     if (!reportConflict(error)) throw error;
   }
@@ -682,7 +735,7 @@ function performReRun(projectDir, mode, addParts) {
     priorManifest: manifest,
     selection: prepared.selection,
     version: prepared.version,
-    projectName: basename2(projectDir),
+    projectName: basename3(projectDir),
     applyTypes: prepared.applyTypes
   });
   console.log(`${result.written.length} files written. Edited files were kept (use the interactive flow to resolve).`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-engineering-kit",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "An opinionated, agent-agnostic AI-development kit — disciplined skills plus a structured workspace — installed and updated through one npx command.",
   "type": "module",
   "license": "MIT",