@appsforgood/next-supabase-kit 0.1.4 → 0.1.6

package/dist/index.js

@@ -1,23 +1,17 @@
 #!/usr/bin/env node
 
 // src/cli/index.ts
+import { existsSync as existsSync23, readFileSync as readFileSync24, writeFileSync as writeFileSync2 } from "fs";
+import { join as join27 } from "path";
 import { Command } from "commander";
 
 // src/install/add-skill.ts
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
 import { join as join3 } from "path";
 
 // src/utils/fs.ts
 import { createHash } from "crypto";
-import {
-  cpSync,
-  existsSync,
-  lstatSync,
-  mkdirSync,
-  readFileSync,
-  readdirSync,
-  writeFileSync
-} from "fs";
+import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "fs";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "path";
 function ensureDir(path) {
   mkdirSync(path, { recursive: true });
@@ -133,20 +127,30 @@ function addSkill(cwd, skillName, options = {}) {
     const available = listSkills().join(", ");
     throw new Error(`Unknown skill "${skillName}". Available skills: ${available}`);
   }
-  const result = copyTextWithConflict(sourcePath, cwd, join3(".agent-kit", "skills", normalized), {
+  const targetRelativePath = join3(".agent-kit", "skills", normalized);
+  if (options.dryRun) {
+    const existing = readTextIfExists(join3(cwd, targetRelativePath));
+    const sourceContent = readFileSync2(sourcePath, "utf8");
+    let action;
+    if (existing === null) action = "created";
+    else if (sha256(existing) === sha256(sourceContent)) action = "unchanged";
+    else action = options.force ? "overwritten" : "conflict";
+    return { action, target: targetRelativePath, dryRun: true };
+  }
+  const result = copyTextWithConflict(sourcePath, cwd, targetRelativePath, {
     force: Boolean(options.force),
     conflictRoot: join3(cwd, ".agent-kit", "conflicts")
   });
-  return `${result.action}: ${result.target}`;
+  return { ...result, dryRun: false };
 }
 
 // src/install/adapter-validate.ts
-import { existsSync as existsSync12, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync10 } from "fs";
 import { join as join12, normalize } from "path";
 
 // src/config/defaults.ts
 var PACKAGE_NAME = "@appsforgood/next-supabase-kit";
-var PACKAGE_VERSION = "0.1.4";
+var PACKAGE_VERSION = "0.1.6";
 var DEFAULT_CONFIG = {
   stack: "next-supabase",
   projectType: "saas",
@@ -185,6 +189,7 @@ var ROOT_DOCS = [
   "STYLE_GUIDE.md",
   "SECURITY.md",
   "TESTING.md",
+  "LOOP_CODING.md",
   "DEPLOYMENT.md",
   "UPGRADE.md"
 ];
@@ -263,7 +268,7 @@ var CI_TEMPLATE_FILES = [
 ];
 
 // src/studio/shared.ts
-import { appendFileSync, existsSync as existsSync4, readFileSync as readFileSync2 } from "fs";
+import { appendFileSync, existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
 import { basename as basename2, dirname as dirname3, join as join4 } from "path";
 var AGENT_KIT_DIR = ".agent-kit";
 var CONTEXT_JSON = ".agent-kit/project-context.json";
@@ -314,7 +319,7 @@ function ensureStudioDirs(cwd) {
 function readJsonFile(cwd, relativePath) {
   const path = resolveInside(cwd, relativePath);
   if (!existsSync4(path)) return null;
-  return JSON.parse(readFileSync2(path, "utf8"));
+  return JSON.parse(readFileSync3(path, "utf8"));
 }
 function writeJsonFile(cwd, relativePath, value) {
   writeText(resolveInside(cwd, relativePath), `${JSON.stringify(value, null, 2)}
@@ -329,7 +334,7 @@ function appendJsonLine(cwd, relativePath, value) {
 function readJsonLines(cwd, relativePath) {
   const text = readTextIfExists(resolveInside(cwd, relativePath));
   if (!text) return [];
-  return text.split(/\r?\n/).filter((line) => line.trim().length > 0).map((line) => JSON.parse(line));
+  return text.split(/\r?\n/).filter((line2) => line2.trim().length > 0).map((line2) => JSON.parse(line2));
 }
 function writeTextFile(cwd, relativePath, content) {
   writeText(resolveInside(cwd, relativePath), content);
@@ -359,7 +364,7 @@ function unique(values) {
 }
 
 // src/install/audit.ts
-import { existsSync as existsSync11, readFileSync as readFileSync8, statSync } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync9, statSync } from "fs";
 import { join as join11 } from "path";
 
 // src/config/contracts.ts
@@ -629,6 +634,8 @@ var SessionEventContract = z.object({
     context2.addIssue({ code: z.ZodIssueCode.custom, message: "required output events require outputName and outputStatus", path: ["outputName"] });
   }
 });
+var AgenticLevelCore = z.union([z.literal(3), z.literal(4), z.literal(5), z.literal(6)]);
+var AgenticLevelTarget = z.union([z.literal(3), z.literal(4), z.literal(5), z.literal(6), z.literal(7), z.literal(8)]);
 var OnboardingStateContract = z.object({
   schemaVersion: z.literal(1),
   depth: z.enum(["quick", "standard", "complete", "undecided"]),
@@ -642,7 +649,27 @@ var OnboardingStateContract = z.object({
   wizardVersion: z.string(),
   ideSurface: z.enum(["cursor", "copilot", "claude", "codex", "other"]).optional(),
   ideVerifiedAt: z.string().datetime().optional(),
-  visualQaTier: z.enum(["baseline", "strong", "mature"]).optional()
+  visualQaTier: z.enum(["baseline", "strong", "mature"]).optional(),
+  targetAgenticLevel: AgenticLevelTarget.optional(),
+  lastAgenticLevel: AgenticLevelCore.optional(),
+  lastAgenticComputedAt: z.string().datetime().optional()
+}).strict();
+var AgenticLevelSignalContract = z.object({
+  id: z.string().min(1),
+  level: AgenticLevelCore,
+  label: z.string().min(1),
+  pass: z.boolean(),
+  evidence: z.string().min(1),
+  remediation: z.string().min(1)
+}).strict();
+var AgenticLevelContract = z.object({
+  currentLevel: AgenticLevelCore,
+  targetLevel: AgenticLevelTarget,
+  maintainerProfile: z.boolean(),
+  computedAt: z.string().datetime(),
+  maintainerNote: z.string().optional(),
+  signals: z.array(AgenticLevelSignalContract),
+  climbSteps: z.array(AgenticLevelSignalContract)
 }).strict();
 function formatContractIssues(error) {
   return error.issues.map((issue) => {
@@ -656,12 +683,12 @@ import { existsSync as existsSync6 } from "fs";
 import { join as join6 } from "path";
 
 // src/studio/context.ts
-import { existsSync as existsSync5, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
 import { join as join5 } from "path";
 function readPackageJson(cwd) {
   const path = join5(cwd, "package.json");
   if (!existsSync5(path)) return null;
-  return JSON.parse(readFileSync3(path, "utf8"));
+  return JSON.parse(readFileSync4(path, "utf8"));
 }
 function detectPackageManager(cwd) {
   if (existsSync5(join5(cwd, "pnpm-lock.yaml"))) return "pnpm";
@@ -680,7 +707,7 @@ function detectFromDependencies(packageJson, names) {
 function readEnvExampleKeys(cwd) {
   const envText = readTextIfExists(join5(cwd, ".env.example")) ?? "";
   return unique(
-    envText.split(/\r?\n/).map((line) => line.trim()).filter((line) => line && !line.startsWith("#") && line.includes("=")).map((line) => line.split("=")[0]?.trim() ?? "").filter(Boolean)
+    envText.split(/\r?\n/).map((line2) => line2.trim()).filter((line2) => line2 && !line2.startsWith("#") && line2.includes("=")).map((line2) => line2.split("=")[0]?.trim() ?? "").filter(Boolean)
   );
 }
 function inferOpenQuestions(context2) {
@@ -1114,19 +1141,19 @@ function onboardingStateExists(cwd) {
 }
 
 // src/install/install.ts
-import { existsSync as existsSync10, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync10, readFileSync as readFileSync8 } from "fs";
 import { join as join10 } from "path";
 
 // src/install/ide-activate.ts
-import { existsSync as existsSync9, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync7 } from "fs";
 import { join as join9 } from "path";
 
 // src/install/roster-adapters.ts
-import { existsSync as existsSync8, readFileSync as readFileSync5, readdirSync as readdirSync2 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync6, readdirSync as readdirSync2 } from "fs";
 import { join as join8 } from "path";
 
 // src/studio/wizard/roster.ts
-import { existsSync as existsSync7, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync5 } from "fs";
 import { join as join7 } from "path";
 var AGENT_ROSTER_JSON = ".agent-kit/agent-roster.json";
 var FALLBACK_SUMMARIES = {
@@ -1146,7 +1173,7 @@ function readPurposeFromAgentFile(cwd, relPath) {
   if (!relPath) return null;
   const path = join7(cwd, relPath);
   if (!existsSync7(path)) return null;
-  const text = readFileSync4(path, "utf8");
+  const text = readFileSync5(path, "utf8");
   const match = text.match(/## Purpose\s*\n+\s*([^\n#]+)/);
   return match?.[1]?.trim() ?? null;
 }
@@ -1186,20 +1213,18 @@ function buildAgentWizardSteps(cwd) {
       depth: depths,
       optional: true
     },
-    ...agents.map(
-      (agent) => ({
-        id: `brief-${agent.id}`,
-        section: "team",
-        title: `Brief ${agent.name}`,
-        why: `${agent.roleSummary} What should they know about this project that is not obvious from the repo?`,
-        fields: [`agentBrief_${agent.id}`],
-        agentId: agent.id,
-        agentName: agent.name,
-        roleSummary: agent.roleSummary,
-        depth: depths,
-        optional: true
-      })
-    )
+    ...agents.map((agent) => ({
+      id: `brief-${agent.id}`,
+      section: "team",
+      title: `Brief ${agent.name}`,
+      why: `${agent.roleSummary} What should they know about this project that is not obvious from the repo?`,
+      fields: [`agentBrief_${agent.id}`],
+      agentId: agent.id,
+      agentName: agent.name,
+      roleSummary: agent.roleSummary,
+      depth: depths,
+      optional: true
+    }))
   ];
 }
 function agentBriefFieldName(agentId) {
@@ -1208,8 +1233,8 @@ function agentBriefFieldName(agentId) {
 
 // src/install/assistant-adapters-table.ts
 function extractAssistantAdapterRow(adaptersDoc, toolLabel) {
-  for (const line of adaptersDoc.split("\n")) {
-    const trimmed = line.trim();
+  for (const line2 of adaptersDoc.split("\n")) {
+    const trimmed = line2.trim();
     if (!trimmed.startsWith("|")) continue;
     const cells = trimmed.split("|").map((cell) => cell.trim()).filter((cell) => cell.length > 0);
     if (cells[0] === toolLabel) return trimmed;
@@ -1284,7 +1309,7 @@ Record meaningful decisions, risks, handoffs, human corrections, artifacts, evid
 function writeGeneratedAgentFile(cwd, relativePath, content, force, result) {
   const targetPath = join8(cwd, relativePath);
   if (!force && existsSync8(targetPath)) {
-    const existing = readFileSync5(targetPath, "utf8");
+    const existing = readFileSync6(targetPath, "utf8");
     if (existing === content) {
       result.unchanged.push(relativePath);
       return;
@@ -1333,7 +1358,7 @@ function loadAgentReasoningEffortMap(cwd) {
   const map = /* @__PURE__ */ new Map();
   if (!existsSync8(path)) return map;
   try {
-    const parsed = JSON.parse(readFileSync5(path, "utf8"));
+    const parsed = JSON.parse(readFileSync6(path, "utf8"));
     const profileEffort = /* @__PURE__ */ new Map();
     for (const profile of parsed.profiles ?? []) {
       if (profile.id && profile.reasoningEffort) {
@@ -1417,7 +1442,7 @@ function generateCursorSkillsFromKit(cwd, force, result) {
   if (!existsSync8(skillsRoot)) return;
   for (const file of readdirSync2(skillsRoot).filter((name) => name.endsWith(".md"))) {
     const skillId = file.replace(/\.md$/, "");
-    const kitMarkdown = readFileSync5(join8(skillsRoot, file), "utf8");
+    const kitMarkdown = readFileSync6(join8(skillsRoot, file), "utf8");
     const relativePath = `.cursor/skills/${skillId}/SKILL.md`;
     writeGeneratedAgentFile(cwd, relativePath, kitSkillToCursorSkill(skillId, kitMarkdown), force, result);
   }
@@ -1464,27 +1489,13 @@ function installAntigravityAdapter(cwd, packageRoot, force, result) {
   for (const file of ANTIGRAVITY_PLUGIN_FILES) {
     copyAdapterFile(cwd, packageRoot, file.source, file.target, force, result);
   }
-  copyDirectoryAsConflicts(
-    cwd,
-    packageRoot,
-    ANTIGRAVITY_COMMANDS_SOURCE_DIR,
-    ANTIGRAVITY_COMMANDS_TARGET_DIR,
-    force,
-    result
-  );
-  copyDirectoryAsConflicts(
-    cwd,
-    packageRoot,
-    RUNTIME_SKILLS_SOURCE_DIR,
-    ANTIGRAVITY_RUNTIME_SKILLS_TARGET_DIR,
-    force,
-    result
-  );
+  copyDirectoryAsConflicts(cwd, packageRoot, ANTIGRAVITY_COMMANDS_SOURCE_DIR, ANTIGRAVITY_COMMANDS_TARGET_DIR, force, result);
+  copyDirectoryAsConflicts(cwd, packageRoot, RUNTIME_SKILLS_SOURCE_DIR, ANTIGRAVITY_RUNTIME_SKILLS_TARGET_DIR, force, result);
 }
 function updateAssistantAdaptersTable(cwd, activated) {
   const path = join9(cwd, "ASSISTANT_ADAPTERS.md");
   if (!existsSync9(path)) return;
-  let content = readFileSync6(path, "utf8");
+  let content = readFileSync7(path, "utf8");
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   if (activated.has("cursor") && content.includes("| Cursor |")) {
     content = content.replace(
@@ -1595,7 +1606,7 @@ function initProject(options) {
   const templateHashes = {};
   for (const doc of ROOT_DOCS) {
     const templatePath = join10(templateRoot, doc);
-    templateHashes[doc] = sha256(readFileSync7(templatePath, "utf8"));
+    templateHashes[doc] = sha256(readFileSync8(templatePath, "utf8"));
     const copyResult = copyTextWithConflict(templatePath, cwd, doc, {
       force: Boolean(options.force),
       conflictRoot: join10(cwd, ".agent-kit", "conflicts")
@@ -1685,7 +1696,7 @@ function initProject(options) {
 function readManifest(cwd) {
   const manifestPath = join10(cwd, ".agent-kit", "manifest.json");
   if (!existsSync10(manifestPath)) return null;
-  return JSON.parse(readFileSync7(manifestPath, "utf8"));
+  return JSON.parse(readFileSync8(manifestPath, "utf8"));
 }
 
 // src/install/audit.ts
@@ -1715,6 +1726,7 @@ var REQUIRED_SKILL_IDS = [
   "frontend-distinctiveness-benchmark",
   "frontend-product-quality-rubric",
   "frontend-design-system",
+  "ui-improvement-harness",
   "visual-regression-qa",
   "positioning-messaging",
   "conversion-copywriting",
@@ -1735,7 +1747,8 @@ var REQUIRED_SCHEMA_FILES = [
   "correction-rules.schema.json",
   "session-event.schema.json",
   "studio-session.schema.json",
-  "onboarding-state.schema.json"
+  "onboarding-state.schema.json",
+  "agentic-level.schema.json"
 ];
 var COUNCIL_SESSION_DIR = ".agent-kit/council-sessions";
 var READINESS_ORDER = ["needs-setup", "baseline-setup", "needs-improvement", "best-practice-candidate"];
@@ -1755,13 +1768,13 @@ function includesAll(text, values) {
 }
 function readDoc(cwd, file) {
   const path = join11(cwd, file);
-  return existsSync11(path) ? readFileSync8(path, "utf8") : "";
+  return existsSync11(path) ? readFileSync9(path, "utf8") : "";
 }
 function isPackageRepository(cwd) {
   const packagePath = join11(cwd, "package.json");
   if (!existsSync11(packagePath)) return false;
   try {
-    const packageJson = JSON.parse(readFileSync8(packagePath, "utf8"));
+    const packageJson = JSON.parse(readFileSync9(packagePath, "utf8"));
     return packageJson.name === "@appsforgood/next-supabase-kit" && existsSync11(join11(cwd, "src", "cli", "index.ts")) && existsSync11(join11(cwd, "templates", "next-supabase")) && existsSync11(join11(cwd, "rosters", "next-supabase-default-council.json"));
   } catch {
     return false;
@@ -1771,7 +1784,7 @@ function readOverrides(cwd) {
   const path = join11(cwd, ".agent-kit", "overrides.json");
   if (!existsSync11(path)) return {};
   try {
-    const parsed = JSON.parse(readFileSync8(path, "utf8"));
+    const parsed = JSON.parse(readFileSync9(path, "utf8"));
     const templates = parsed.templates ?? {};
     return Object.fromEntries(
       Object.entries(templates).map(([file, override]) => [
@@ -1785,7 +1798,7 @@ function readOverrides(cwd) {
 }
 function readTemplate(stack, file) {
   const path = join11(findPackageRoot(), "templates", stack, file);
-  return existsSync11(path) ? readFileSync8(path, "utf8") : null;
+  return existsSync11(path) ? readFileSync9(path, "utf8") : null;
 }
 function asStringArray(value) {
   if (!Array.isArray(value)) return [];
@@ -1807,7 +1820,7 @@ function addAgentRosterFindings(cwd, findings, rosterRelativePath = DEFAULT_AGEN
   }
   let roster;
   try {
-    const parsed = JSON.parse(readFileSync8(rosterPath, "utf8"));
+    const parsed = JSON.parse(readFileSync9(rosterPath, "utf8"));
     if (!isRecord(parsed)) throw new Error("Roster must be a JSON object.");
     const contractResult = AgentRosterContract.safeParse(parsed);
     if (!contractResult.success) {
@@ -2002,7 +2015,7 @@ function addCouncilSessionRecordFindings(cwd, findings) {
   for (const sessionFile of sessionFiles) {
     const displayPath = `${COUNCIL_SESSION_DIR}/${sessionFile}`;
     try {
-      const parsed = JSON.parse(readFileSync8(join11(sessionsRoot, sessionFile), "utf8"));
+      const parsed = JSON.parse(readFileSync9(join11(sessionsRoot, sessionFile), "utf8"));
       const contractResult = CouncilSessionContract.safeParse(parsed);
       if (!contractResult.success) {
         invalidCount += 1;
@@ -2044,7 +2057,7 @@ function addSchemaFindings(cwd, findings, schemaRootRelativePath = ".agent-kit/s
       continue;
     }
     try {
-      const parsed = JSON.parse(readFileSync8(schemaPath, "utf8"));
+      const parsed = JSON.parse(readFileSync9(schemaPath, "utf8"));
       if (!isRecord(parsed) || typeof parsed.$schema !== "string" || !isRecord(parsed.properties)) {
         throw new Error("Schema file is missing JSON Schema metadata.");
       }
@@ -2074,7 +2087,7 @@ function addAgentStudioFindings(cwd, findings) {
     });
   } else {
     try {
-      const parsed = JSON.parse(readFileSync8(contextPath, "utf8"));
+      const parsed = JSON.parse(readFileSync9(contextPath, "utf8"));
       const result = ProjectContextContract.safeParse(parsed);
       if (!result.success) {
         findings.push({
@@ -2151,7 +2164,7 @@ function addAgentStudioFindings(cwd, findings) {
     const path = join11(cwd, relativePath);
     if (!existsSync11(path)) continue;
     try {
-      const parsed = JSON.parse(readFileSync8(path, "utf8"));
+      const parsed = JSON.parse(readFileSync9(path, "utf8"));
       const result = CorrectionRulesContract.safeParse(parsed);
       if (!result.success) {
         findings.push({
@@ -2178,7 +2191,7 @@ function addAgentStudioFindings(cwd, findings) {
   }
   const studioExportPath = join11(cwd, STUDIO_EXPORT_HTML);
   if (existsSync11(studioExportPath)) {
-    const exportHtml = readFileSync8(studioExportPath, "utf8");
+    const exportHtml = readFileSync9(studioExportPath, "utf8");
     if (containsLikelySecret(exportHtml)) {
       findings.push({
         level: "fail",
@@ -2211,12 +2224,10 @@ function addAgentStudioFindings(cwd, findings) {
     const sessionDir2 = sessionFile.replace(/[\\/]session\.json$/, "");
     const normalizedSessionDir = sessionDir2.replace(/\\/g, "/");
     const eventsRelative = `${COUNCIL_SESSION_DIR}/${normalizedSessionDir}/events.jsonl`;
-    const indexRelative = `${COUNCIL_SESSION_DIR}/${normalizedSessionDir}/index.md`;
-    const transcriptRelative = `${COUNCIL_SESSION_DIR}/${normalizedSessionDir}/transcript.md`;
     const sessionDirPath = join11(sessionsRoot, sessionDir2);
     let sessionResult = null;
     try {
-      sessionResult = StudioSessionContract.safeParse(JSON.parse(readFileSync8(join11(sessionDirPath, "session.json"), "utf8")));
+      sessionResult = StudioSessionContract.safeParse(JSON.parse(readFileSync9(join11(sessionDirPath, "session.json"), "utf8")));
       if (!sessionResult.success) {
         findings.push({
           level: "fail",
@@ -2245,7 +2256,7 @@ function addAgentStudioFindings(cwd, findings) {
       });
       continue;
     }
-    const eventText = readFileSync8(eventsPath2, "utf8");
+    const eventText = readFileSync9(eventsPath2, "utf8");
     if (containsLikelySecret(eventText)) {
       findings.push({
         level: "fail",
@@ -2254,12 +2265,12 @@ function addAgentStudioFindings(cwd, findings) {
         remediation: "Redact tokens, database URLs, env values, and private customer data from session logs."
       });
     }
-    const eventLines = eventText.split(/\r?\n/).filter((line) => line.trim().length > 0);
+    const eventLines = eventText.split(/\r?\n/).filter((line2) => line2.trim().length > 0);
     let validEvents = 0;
     let verificationCount = 0;
-    for (const [index, line] of eventLines.entries()) {
+    for (const [index, line2] of eventLines.entries()) {
       try {
-        const result = SessionEventContract.safeParse(JSON.parse(line));
+        const result = SessionEventContract.safeParse(JSON.parse(line2));
         if (!result.success) {
           findings.push({
             level: "fail",
@@ -2288,8 +2299,8 @@ function addAgentStudioFindings(cwd, findings) {
         remediation: "Run agent-kit session render so humans can inspect the current agent transcript and handoffs."
       });
     } else {
-      const indexText = readFileSync8(join11(sessionDirPath, "index.md"), "utf8");
-      const transcriptText = readFileSync8(join11(sessionDirPath, "transcript.md"), "utf8");
+      const indexText = readFileSync9(join11(sessionDirPath, "index.md"), "utf8");
+      const transcriptText = readFileSync9(join11(sessionDirPath, "transcript.md"), "utf8");
       if (containsLikelySecret(indexText) || containsLikelySecret(transcriptText)) {
         findings.push({
           level: "fail",
@@ -2446,7 +2457,7 @@ function addModelRoutingFindings(cwd, findings, routingRelativePath = DEFAULT_MO
   }
   let routing;
   try {
-    routing = JSON.parse(readFileSync8(routingPath, "utf8"));
+    routing = JSON.parse(readFileSync9(routingPath, "utf8"));
   } catch {
     findings.push({
       level: "warn",
@@ -2508,7 +2519,7 @@ function addTemplateHashFindings(cwd, findings) {
     if (!existsSync11(targetPath)) continue;
     const currentTemplate = readTemplate(manifest.stack, doc);
     if (!currentTemplate) continue;
-    const targetHash = sha256(readFileSync8(targetPath, "utf8"));
+    const targetHash = sha256(readFileSync9(targetPath, "utf8"));
     const currentTemplateHash = sha256(currentTemplate);
     const installedTemplateHash = manifest.templateHashes?.[doc];
     const override = overrides[doc];
@@ -2735,14 +2746,7 @@ function addUpgradeFindings(cwd, findings) {
     });
   }
 }
-var STARTER_EVIDENCE_PATTERNS = [
-  /\bTBD\b/i,
-  /replace with real/i,
-  /example_table/i,
-  /describe the product/i,
-  /document required/i,
-  /pass\/fail\/skipped/i
-];
+var STARTER_EVIDENCE_PATTERNS = [/\bTBD\b/i, /replace with real/i, /example_table/i, /describe the product/i, /document required/i, /pass\/fail\/skipped/i];
 var EVIDENCE_DOCS = [
   "COUNCIL.md",
   "SPEC.md",
@@ -2913,7 +2917,7 @@ function readPackageJson2(cwd) {
   const path = join11(cwd, "package.json");
   if (!existsSync11(path)) return null;
   try {
-    return JSON.parse(readFileSync8(path, "utf8"));
+    return JSON.parse(readFileSync9(path, "utf8"));
   } catch {
     return null;
   }
@@ -2939,7 +2943,7 @@ function addProjectRealityFindings(cwd, findings, options = {}) {
       });
     } else {
       const rlsFiles = sqlFiles.filter((file) => {
-        const content = readFileSync8(join11(migrationsDir, file), "utf8");
+        const content = readFileSync9(join11(migrationsDir, file), "utf8");
         return /enable\s+row\s+level\s+security/i.test(content);
       });
       if (rlsFiles.length === 0) {
@@ -2989,7 +2993,7 @@ function addProjectRealityFindings(cwd, findings, options = {}) {
     return /\.(ts|tsx|js|jsx|env|json)$/.test(file);
   });
   const secretHits = trackedSourceFiles.map((file) => {
-    const content = readFileSync8(join11(cwd, file), "utf8");
+    const content = readFileSync9(join11(cwd, file), "utf8");
     return containsLikelySecretForAudit(file, content) ? file : null;
   }).filter((file) => file !== null).slice(0, 5);
   if (secretHits.length > 0) {
@@ -3064,7 +3068,25 @@ function createAuditReport(cwd) {
 }
 
 // src/install/adapter-validate.ts
-var REQUIRED_COMMANDS = ["setup", "audit", "plan", "handoff", "frontend", "security", "copy", "ship", "upgrade"];
+var REQUIRED_COMMANDS = [
+  "setup",
+  "audit",
+  "plan",
+  "handoff",
+  "frontend",
+  "ui-audit",
+  "ui-polish",
+  "layout-cleanup",
+  "responsive-cleanup",
+  "accessibility-pass",
+  "distinctiveness-pass",
+  "screenshot-critique",
+  "browser-qa",
+  "security",
+  "copy",
+  "ship",
+  "upgrade"
+];
 var REQUIRED_SOURCE_REFERENCES = ["AGENTS.md", ".agent-kit/agent-roster.json", "QUALITY_GATES.md"];
 function summary(findings) {
   return {
@@ -3078,7 +3100,7 @@ function report(target, findings) {
 }
 function readJson(path) {
   try {
-    return JSON.parse(readFileSync9(path, "utf8"));
+    return JSON.parse(readFileSync10(path, "utf8"));
   } catch {
     return null;
   }
@@ -3139,11 +3161,11 @@ function validateAntigravityCommands(layout, findings) {
         level: "fail",
         area: "commands",
         message: `Missing Antigravity command ${relativePath}.`,
-        remediation: "Restore the full native command set: setup, audit, plan, handoff, frontend, security, copy, ship, and upgrade."
+        remediation: "Restore the full native command set, including frontend and UI improvement commands."
       });
       continue;
     }
-    const text = readFileSync9(path, "utf8");
+    const text = readFileSync10(path, "utf8");
     addSecretFinding(relativePath, text, findings);
     const name = commandField(text, "name");
     const description = commandField(text, "description");
@@ -3232,10 +3254,11 @@ function validateAntigravityPlugin(layout, findings) {
   for (const entry of [...commands, ...skills]) {
     const path = typeof entry.path === "string" ? entry.path : "";
     if (!path || !isSafeRelativePath(path)) {
+      const entryName = typeof entry.name === "string" ? entry.name : "unknown";
       findings.push({
         level: "fail",
         area: "manifest",
-        message: `plugin.json has an unsafe or missing relative path for ${String(entry.name ?? "unknown")}.`,
+        message: `plugin.json has an unsafe or missing relative path for ${entryName}.`,
         remediation: "Use relative paths that stay inside the plugin/runtime skill bundle."
       });
       continue;
@@ -3250,7 +3273,7 @@ function validateAntigravityPlugin(layout, findings) {
       });
     }
   }
-  const pluginText = readFileSync9(pluginPath, "utf8");
+  const pluginText = readFileSync10(pluginPath, "utf8");
   addSecretFinding("plugin.json", pluginText, findings);
   if (Array.isArray(plugin.sourceOfTruth) && plugin.sourceOfTruth.includes("AGENTS.md") && plugin.sourceOfTruth.includes(".agent-kit/agent-roster.json")) {
     findings.push({
@@ -3283,7 +3306,7 @@ function validateRuntimeSkills(cwd, layout, findings) {
       });
       continue;
     }
-    const text = readFileSync9(runtimePath, "utf8");
+    const text = readFileSync10(runtimePath, "utf8");
     addSecretFinding(`${skillName}/SKILL.md`, text, findings);
     if (!/^---\nname: .+\ndescription: .+\n---/m.test(text)) {
       findings.push({
@@ -3332,7 +3355,7 @@ function validateAntigravity(cwd) {
       }
     ]);
   }
-  const adapterDoc = existsSync12(layout.adapterDocPath) ? readFileSync9(layout.adapterDocPath, "utf8") : "";
+  const adapterDoc = existsSync12(layout.adapterDocPath) ? readFileSync10(layout.adapterDocPath, "utf8") : "";
   if (!adapterDoc) {
     findings.push({
       level: "fail",
@@ -3408,7 +3431,7 @@ function validateBasicAdapter(cwd, target) {
         });
         continue;
       }
-      const text = readFileSync9(path, "utf8");
+      const text = readFileSync10(path, "utf8");
       addSecretFinding(relativePath, text, findings);
       if (!text.includes("AGENTS.md") && !text.includes("MODEL_ROUTING.md")) {
         findings.push({
@@ -3433,7 +3456,7 @@ function validateBasicAdapter(cwd, target) {
 }
 function readAssistantAdaptersDoc(cwd) {
   const path = join12(cwd, "ASSISTANT_ADAPTERS.md");
-  return existsSync12(path) ? readFileSync9(path, "utf8") : "";
+  return existsSync12(path) ? readFileSync10(path, "utf8") : "";
 }
 function adaptersRowIsActive(doc, toolLabel) {
   return assistantAdapterRowIsActive(doc, toolLabel);
@@ -3451,7 +3474,7 @@ function validateInstalledIdeAdapter(cwd, target) {
         remediation: "Run agent-kit init or agent-kit init --activate cursor."
       });
     } else {
-      addSecretFinding(".cursor/rules/cursor-agent-kit.mdc", readFileSync9(rulesPath, "utf8"), findings);
+      addSecretFinding(".cursor/rules/cursor-agent-kit.mdc", readFileSync10(rulesPath, "utf8"), findings);
     }
     const plannerAgent = join12(cwd, ".cursor/agents/planner.md");
     if (existsSync12(plannerAgent)) {
@@ -3554,7 +3577,7 @@ function validatePackage(cwd) {
   findings.push(...validateAntigravity(cwd).findings);
   for (const doc of ["README.md", "DOCS.md", "SPEC.md", "DECISIONS.md", "QUALITY_GATES.md", "TESTING.md", "UPGRADE.md"]) {
     const path = join12(cwd, doc);
-    const text = existsSync12(path) ? readFileSync9(path, "utf8") : "";
+    const text = existsSync12(path) ? readFileSync10(path, "utf8") : "";
     const lower = text.toLowerCase();
     if (!lower.includes("antigravity") && !lower.includes("runtime command") && !lower.includes("runtime adapter")) {
       findings.push({
@@ -3606,12 +3629,12 @@ function validatePackage(cwd) {
 }
 
 // src/install/diff.ts
-import { existsSync as existsSync13, readFileSync as readFileSync10 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync11 } from "fs";
 import { join as join13 } from "path";
 function statusForTextFile(target, template) {
   if (!existsSync13(target)) return "missing";
-  const targetHash = sha256(readFileSync10(target, "utf8"));
-  const templateHash = sha256(readFileSync10(template, "utf8"));
+  const targetHash = sha256(readFileSync11(target, "utf8"));
+  const templateHash = sha256(readFileSync11(template, "utf8"));
   return targetHash === templateHash ? "unchanged" : "changed";
 }
 function diffProject(cwd, stack = "next-supabase") {
@@ -3680,10 +3703,176 @@ function diffProject(cwd, stack = "next-supabase") {
   return result;
 }
 
+// src/install/update.ts
+import { existsSync as existsSync14, readFileSync as readFileSync12 } from "fs";
+import { join as join14, relative as relative2 } from "path";
+function planFileUpdate(cwd, input) {
+  const sourceContent = readFileSync12(input.sourcePath, "utf8");
+  const sourceHash = sha256(sourceContent);
+  const targetPath = resolveInside(cwd, input.target);
+  if (!existsSync14(targetPath)) {
+    return { target: input.target, action: "created", reason: "File is missing locally.", sourceContent };
+  }
+  const localHash = sha256(readFileSync12(targetPath, "utf8"));
+  if (localHash === sourceHash) {
+    return { target: input.target, action: "unchanged", reason: "File already matches the current template.", sourceContent };
+  }
+  if (input.installedHash && localHash === input.installedHash) {
+    return { target: input.target, action: "updated", reason: "File was unmodified since install; applied the newer template.", sourceContent };
+  }
+  if (input.force) {
+    return { target: input.target, action: "overwritten", reason: "Local changes overwritten because --force was used.", sourceContent };
+  }
+  if (input.installedHash && input.installedHash === sourceHash) {
+    return { target: input.target, action: "kept-local", reason: "File is locally customized and the template has not changed.", sourceContent };
+  }
+  return {
+    target: input.target,
+    action: "conflict",
+    reason: "File is locally customized and the bundled template changed; review the conflict copy.",
+    sourceContent
+  };
+}
+function writeConflictCopy(cwd, target, content) {
+  const conflictRoot = join14(cwd, ".agent-kit", "conflicts");
+  const safeName = `${Date.now()}-${target.replace(/[^a-zA-Z0-9_.-]/g, "_")}`;
+  const conflictPath = join14(conflictRoot, safeName);
+  writeText(conflictPath, content);
+  return relative2(cwd, conflictPath).replace(/\\/g, "/");
+}
+function updateProject(options) {
+  const cwd = options.cwd;
+  const force = Boolean(options.force);
+  const dryRun = Boolean(options.dryRun);
+  const manifest = readManifest(cwd);
+  if (!manifest) {
+    if (dryRun) {
+      throw new Error("No .agent-kit/manifest.json found. Run agent-kit init first (or run update without --dry-run to install).");
+    }
+    const initResult = initProject({ cwd, force });
+    const files2 = [
+      ...initResult.copied.map((target) => ({ target, action: "created", reason: "Installed by init fallback." })),
+      ...initResult.unchanged.map((target) => ({ target, action: "unchanged", reason: "Already matched the template." })),
+      ...initResult.overwritten.map((target) => ({ target, action: "overwritten", reason: "Overwritten by init --force fallback." })),
+      ...initResult.conflicts.map((entry) => {
+        const [target, conflictPath] = entry.split(" -> ");
+        return {
+          target: target ?? entry,
+          action: "conflict",
+          reason: "Local file differed from the template during init fallback.",
+          ...conflictPath ? { conflictPath } : {}
+        };
+      })
+    ];
+    return {
+      dryRun,
+      files: files2,
+      libraryFoldersRefreshed: [...LIBRARY_FOLDERS],
+      manifestPath: ".agent-kit/manifest.json",
+      summary: summarize(files2)
+    };
+  }
+  const packageRoot = findPackageRoot();
+  const stack = manifest.stack ?? "next-supabase";
+  const templateRoot = join14(packageRoot, "templates", stack);
+  if (!existsSync14(templateRoot)) {
+    throw new Error(`Unsupported stack profile in manifest: ${stack}`);
+  }
+  const files = [];
+  const templateHashes = {};
+  const plans = [];
+  for (const doc of ROOT_DOCS) {
+    const sourcePath = join14(templateRoot, doc);
+    templateHashes[doc] = sha256(readFileSync12(sourcePath, "utf8"));
+    plans.push(
+      planFileUpdate(cwd, {
+        target: doc,
+        sourcePath,
+        installedHash: manifest.templateHashes?.[doc],
+        force
+      })
+    );
+  }
+  for (const adapter2 of CURSOR_ADAPTER_FILES) {
+    plans.push(
+      planFileUpdate(cwd, {
+        target: adapter2.target,
+        sourcePath: join14(packageRoot, adapter2.source),
+        installedHash: void 0,
+        force
+      })
+    );
+  }
+  plans.push(
+    planFileUpdate(cwd, {
+      target: DEFAULT_AGENT_ROSTER_TARGET,
+      sourcePath: join14(packageRoot, DEFAULT_AGENT_ROSTER_SOURCE),
+      installedHash: void 0,
+      force
+    }),
+    planFileUpdate(cwd, {
+      target: DEFAULT_MODEL_ROUTING_TARGET,
+      sourcePath: join14(packageRoot, DEFAULT_MODEL_ROUTING_SOURCE),
+      installedHash: void 0,
+      force
+    })
+  );
+  for (const plan of plans) {
+    const { sourceContent, ...fileResult } = plan;
+    if (!dryRun) {
+      if (plan.action === "created" || plan.action === "updated" || plan.action === "overwritten") {
+        writeText(resolveInside(cwd, plan.target), sourceContent);
+      } else if (plan.action === "conflict") {
+        fileResult.conflictPath = writeConflictCopy(cwd, plan.target, sourceContent);
+      }
+    }
+    files.push(fileResult);
+  }
+  if (!dryRun) {
+    ensureDir(join14(cwd, ".agent-kit"));
+    for (const folder of LIBRARY_FOLDERS) {
+      copyDirectory(join14(packageRoot, folder), join14(cwd, ".agent-kit", folder));
+    }
+    const updatedManifest = {
+      packageName: PACKAGE_NAME,
+      packageVersion: PACKAGE_VERSION,
+      stack,
+      installedAt: manifest.installedAt,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      docs: [...ROOT_DOCS],
+      libraryFolders: [...LIBRARY_FOLDERS],
+      agentRoster: DEFAULT_AGENT_ROSTER_TARGET,
+      modelRouting: DEFAULT_MODEL_ROUTING_TARGET,
+      templateHashes
+    };
+    writeText(join14(cwd, ".agent-kit", "manifest.json"), `${JSON.stringify(updatedManifest, null, 2)}
+`);
+  }
+  return {
+    dryRun,
+    files,
+    libraryFoldersRefreshed: [...LIBRARY_FOLDERS],
+    manifestPath: ".agent-kit/manifest.json",
+    summary: summarize(files)
+  };
+}
+function summarize(files) {
+  const summary2 = {
+    created: 0,
+    updated: 0,
+    unchanged: 0,
+    "kept-local": 0,
+    conflict: 0,
+    overwritten: 0
+  };
+  for (const file of files) summary2[file.action] += 1;
+  return summary2;
+}
+
 // src/research/discover.ts
 import { Octokit } from "@octokit/rest";
-import { readFileSync as readFileSync11 } from "fs";
-import { join as join14 } from "path";
+import { readFileSync as readFileSync13 } from "fs";
+import { join as join15 } from "path";
 
 // src/research/config.ts
 import { z as z2 } from "zod";
@@ -3708,8 +3897,8 @@ var researchConfigSchema = z2.object({
 // src/research/discover.ts
 async function discoverRepos(options) {
   const packageRoot = findPackageRoot();
-  const configPath = join14(packageRoot, "research", "scan-config.json");
-  const config = researchConfigSchema.parse(JSON.parse(readFileSync11(configPath, "utf8")));
+  const configPath = join15(packageRoot, "research", "scan-config.json");
+  const config = researchConfigSchema.parse(JSON.parse(readFileSync13(configPath, "utf8")));
   const token = options.token ?? process.env.GITHUB_TOKEN;
   if (!token) {
     throw new Error("GITHUB_TOKEN is required for GitHub API research discovery.");
@@ -3770,20 +3959,20 @@ async function discoverRepos(options) {
     }
   }
   const candidates = [...deduped.values()].slice(0, maxRepos);
-  const output = options.output ?? join14(options.cwd, "research", "repo-candidates.json");
+  const output = options.output ?? join15(options.cwd, "research", "repo-candidates.json");
   writeText(output, `${JSON.stringify(candidates, null, 2)}
 `);
   return candidates;
 }
 
 // src/research/scan.ts
-import { existsSync as existsSync16, mkdirSync as mkdirSync2, readFileSync as readFileSync13, rmSync } from "fs";
-import { join as join16 } from "path";
+import { existsSync as existsSync16, mkdirSync as mkdirSync2, readFileSync as readFileSync15, rmSync } from "fs";
+import { join as join17 } from "path";
 import { simpleGit } from "simple-git";
 
 // src/research/analyze.ts
-import { existsSync as existsSync15, readFileSync as readFileSync12 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync15, readFileSync as readFileSync14 } from "fs";
+import { join as join16 } from "path";
 function normalizeRelativePath(file) {
   return file.replace(/\\/g, "/");
 }
@@ -3791,8 +3980,8 @@ function hasFile(files, matcher) {
   return files.some((file) => matcher.test(normalizeRelativePath(file)));
 }
 function fileText(root, file) {
-  const path = join15(root, file);
-  return existsSync15(path) ? readFileSync12(path, "utf8") : "";
+  const path = join16(root, file);
+  return existsSync15(path) ? readFileSync14(path, "utf8") : "";
 }
 function textIncludes(root, files, matcher, terms) {
   const lowerTerms = terms.map((term) => term.toLowerCase());
@@ -3923,24 +4112,24 @@ ${finding.impactOnKit.map((item) => `- ${item}`).join("\n")}
 `;
 }
 async function scanRepos(options) {
-  const candidatesPath = options.candidatesPath ?? join16(options.cwd, "research", "repo-candidates.json");
+  const candidatesPath = options.candidatesPath ?? join17(options.cwd, "research", "repo-candidates.json");
   if (!existsSync16(candidatesPath)) {
     throw new Error(`Candidates file not found: ${candidatesPath}`);
   }
-  const candidates = JSON.parse(readFileSync13(candidatesPath, "utf8"));
-  const workdir = options.workdir ?? join16(options.cwd, "research", "workdir");
+  const candidates = JSON.parse(readFileSync15(candidatesPath, "utf8"));
+  const workdir = options.workdir ?? join17(options.cwd, "research", "workdir");
   mkdirSync2(workdir, { recursive: true });
-  mkdirSync2(join16(options.cwd, "research", "findings"), { recursive: true });
+  mkdirSync2(join17(options.cwd, "research", "findings"), { recursive: true });
   const findings = [];
   const git = simpleGit();
   for (const candidate of candidates) {
     const repoSlug = candidate.fullName.replace("/", "__");
-    const repoPath = join16(workdir, repoSlug);
+    const repoPath = join17(workdir, repoSlug);
     if (existsSync16(repoPath)) rmSync(repoPath, { recursive: true, force: true });
     await git.raw(["clone", "--depth", "1", candidate.htmlUrl, repoPath]);
     const finding = analyzeRepository(candidate, repoPath);
     findings.push(finding);
-    writeText(join16(options.cwd, "research", "findings", `${repoSlug}.md`), findingToMarkdown(finding));
+    writeText(join17(options.cwd, "research", "findings", `${repoSlug}.md`), findingToMarkdown(finding));
     if (!options.keepClones) {
       rmSync(repoPath, { recursive: true, force: true });
     }
@@ -3949,8 +4138,8 @@ async function scanRepos(options) {
 }
 
 // src/research/summarize.ts
-import { existsSync as existsSync17, readFileSync as readFileSync14, readdirSync as readdirSync3 } from "fs";
-import { join as join17 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync16, readdirSync as readdirSync3 } from "fs";
+import { join as join18 } from "path";
 var SUMMARY_TARGETS = {
   "nextjs-patterns": {
     title: "Next.js Patterns",
@@ -4012,7 +4201,7 @@ function sectionBullets(text, start, end) {
   const afterStart = text.slice(startIndex + start.length);
   const endIndex = afterStart.indexOf(end);
   const section = endIndex === -1 ? afterStart : afterStart.slice(0, endIndex);
-  return section.split("\n").map((line) => line.trim()).filter((line) => line.startsWith("- ") && !line.includes("None detected")).map((line) => line.slice(2));
+  return section.split("\n").map((line2) => line2.trim()).filter((line2) => line2.startsWith("- ") && !line2.includes("None detected")).map((line2) => line2.slice(2));
 }
 function parseFinding(file, text) {
   const fullName = text.match(/^# Repo Finding: (.+)$/m)?.[1];
@@ -4053,12 +4242,12 @@ function renderRepoList(findings, scoreKeys) {
   return findings.slice().sort((a, b) => scoreFor(b, scoreKeys) - scoreFor(a, scoreKeys) || b.totalScore - a.totalScore || b.stars - a.stars).slice(0, 12).map((finding) => `- ${finding.fullName} (${finding.category}) - focus score ${scoreFor(finding, scoreKeys)}, total ${finding.totalScore}/${maxTotalScore}`).join("\n");
 }
 function summarizeFindings(cwd) {
-  const findingsDir = join17(cwd, "research", "findings");
+  const findingsDir = join18(cwd, "research", "findings");
   if (!existsSync17(findingsDir)) {
     throw new Error("No research/findings directory exists. Run agent-kit research scan first.");
   }
   const findingFiles = readdirSync3(findingsDir).filter((file) => file.endsWith(".md"));
-  const findings = findingFiles.map((file) => parseFinding(file, readFileSync14(join17(findingsDir, file), "utf8"))).filter((finding) => finding !== null);
+  const findings = findingFiles.map((file) => parseFinding(file, readFileSync16(join18(findingsDir, file), "utf8"))).filter((finding) => finding !== null);
   const categoryCounts = countBy(findings.map((finding) => finding.category));
   const outputs = [];
   const overview = `# Research Scan Overview
@@ -4077,13 +4266,13 @@ ${countBy(findings.flatMap((finding) => finding.strongPractices)).slice(0, 12).m
 ## Most Repeated Gaps
 ${countBy(findings.flatMap((finding) => finding.weakPractices)).slice(0, 12).map(([practice, count]) => `- ${practice} (${count})`).join("\n")}
 `;
-  const overviewPath = join17(cwd, "research", "summaries", "scan-overview.md");
+  const overviewPath = join18(cwd, "research", "summaries", "scan-overview.md");
   writeText(overviewPath, overview);
   outputs.push(overviewPath);
   for (const [target, config] of Object.entries(SUMMARY_TARGETS)) {
     const categories = config.categories;
     const scopedFindings = findings.filter((finding) => categories.includes(finding.category));
-    const path = join17(cwd, "research", "summaries", `${target}.md`);
+    const path = join18(cwd, "research", "summaries", `${target}.md`);
     const summary2 = `# ${config.title}
 
 Generated from ${scopedFindings.length} relevant repository findings.
@@ -4124,12 +4313,19 @@ Review the generated research summaries, then convert repeated best practices in
 
 Do not copy source code from scanned repositories. Adopt only generalized practices with clear rationale.
 `;
-  const path = join17(cwd, "research", "proposed-updates.md");
+  const path = join18(cwd, "research", "proposed-updates.md");
   writeText(path, output);
   return path;
 }
 
 // src/studio/corrections.ts
+var VALID_CORRECTION_SCOPES = ["session", "project", "agent", "upstream-proposal"];
+function parseCorrectionScope(scope) {
+  if (typeof scope === "string" && VALID_CORRECTION_SCOPES.includes(scope)) {
+    return scope;
+  }
+  throw new Error(`Invalid correction scope: expected one of ${VALID_CORRECTION_SCOPES.join(", ")}`);
+}
 function fileForScope(scope) {
   if (scope === "agent") return AGENT_RULES_JSON;
   if (scope === "upstream-proposal") return UPSTREAM_PROPOSALS_JSON;
@@ -4153,14 +4349,15 @@ function ensureCorrectionFiles(cwd) {
   }
 }
 function addCorrection(cwd, options) {
+  const scope = parseCorrectionScope(options.scope);
   ensureCorrectionFiles(cwd);
-  const targetPath = fileForScope(options.scope);
+  const targetPath = fileForScope(scope);
   const rules = readCorrectionRules(cwd, targetPath);
   const id = options.id ?? safeSlug(options.text).slice(0, 48);
   const rule = {
     id,
-    scope: options.scope,
-    status: options.scope === "upstream-proposal" ? "proposed" : "active",
+    scope,
+    status: scope === "upstream-proposal" ? "proposed" : "active",
     text: redactSensitive(options.text),
     ...options.agentId ? { agentId: options.agentId, appliesToAgents: [options.agentId] } : {},
     ...options.sourceSessionId ? { sourceSessionId: options.sourceSessionId } : {},
@@ -4233,8 +4430,8 @@ function proposeCorrectionUpstream(cwd, id) {
 }
 
 // src/studio/session.ts
-import { existsSync as existsSync18, readFileSync as readFileSync15, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
-import { join as join18 } from "path";
+import { existsSync as existsSync18, readFileSync as readFileSync17, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
+import { join as join19 } from "path";
 function sessionDir(sessionId) {
   return `${COUNCIL_SESSIONS_DIR}/${safeSlug(sessionId)}`;
 }
@@ -4291,9 +4488,9 @@ function startSession(cwd, options) {
   return { sessionId, sessionPath: sessionDir(sessionId) };
 }
 function listSessions(cwd) {
-  const root = join18(cwd, COUNCIL_SESSIONS_DIR);
+  const root = join19(cwd, COUNCIL_SESSIONS_DIR);
   if (!existsSync18(root)) return [];
-  return readdirSync4(root).filter((entry) => entry !== "active").map((entry) => join18(root, entry, "session.json")).filter((path) => existsSync18(path) && statSync2(path).isFile()).map((path) => StudioSessionContract.parse(JSON.parse(readFileSync15(path, "utf8")))).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  return readdirSync4(root).filter((entry) => entry !== "active").map((entry) => join19(root, entry, "session.json")).filter((path) => existsSync18(path) && statSync2(path).isFile()).map((path) => StudioSessionContract.parse(JSON.parse(readFileSync17(path, "utf8")))).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
 }
 function getActiveSessionId(cwd) {
   const active = readTextFile(cwd, ACTIVE_SESSION_FILE)?.trim();
@@ -4550,8 +4747,8 @@ function renderSessionTranscript(session2, events) {
   }
   const sections = [...byAgent.entries()].map(([agentId, agentEvents]) => {
     const rows = agentEvents.map((event) => {
-      const detail = event.text ?? event.decision ?? event.command ?? event.artifactPath ?? (event.outputName ? `${event.outputName}: ${event.outputStatus ?? ""}` : void 0) ?? event.status ?? "";
-      return `- ${event.createdAt} \`${event.type}\`: ${escapeMarkdownText(detail)}`;
+      const detail2 = event.text ?? event.decision ?? event.command ?? event.artifactPath ?? (event.outputName ? `${event.outputName}: ${event.outputStatus ?? ""}` : void 0) ?? event.status ?? "";
+      return `- ${event.createdAt} \`${event.type}\`: ${escapeMarkdownText(detail2)}`;
     });
     return `## ${escapeMarkdownText(agentId)}
 
@@ -4714,7 +4911,9 @@ function renderCorrections(data) {
   return `<table>
     <thead><tr><th>Scope</th><th>Agent</th><th>Correction</th></tr></thead>
     <tbody>
-      ${rules.map((rule) => `<tr><td>${escapeHtml(rule.scope)}</td><td>${escapeHtml(rule.agentId ?? rule.appliesToAgents?.join(", ") ?? "all")}</td><td>${escapeHtml(rule.text)}</td></tr>`).join("\n")}
+      ${rules.map(
+    (rule) => `<tr><td>${escapeHtml(rule.scope)}</td><td>${escapeHtml(rule.agentId ?? rule.appliesToAgents?.join(", ") ?? "all")}</td><td>${escapeHtml(rule.text)}</td></tr>`
+  ).join("\n")}
     </tbody>
   </table>`;
 }
@@ -4763,13 +4962,16 @@ function renderAgentStreams(item) {
     const agent = event.agentId ?? event.fromAgentId ?? "session";
     byAgent.set(agent, [...byAgent.get(agent) ?? [], event]);
   }
-  return [...byAgent.entries()].map(([agent, events]) => `<details class="agent-stream"><summary>${escapeHtml(agent)} (${events.length})</summary><div class="stream-body">${renderEventList(events)}</div></details>`).join("\n");
+  return [...byAgent.entries()].map(
+    ([agent, events]) => `<details class="agent-stream"><summary>${escapeHtml(agent)} (${events.length})</summary><div class="stream-body">${renderEventList(events)}</div></details>`
+  ).join("\n");
 }
 function renderEventList(events) {
   return `<ol class="event-list">${events.map((event) => `<li><time>${escapeHtml(event.createdAt)}</time> <code>${escapeHtml(event.type)}</code>: ${escapeHtml(eventDetail(event))}</li>`).join("\n")}</ol>`;
 }
 function eventDetail(event) {
-  if (event.type === "handoff") return `${event.fromAgentId ?? "unknown"} -> ${event.toAgentId ?? "unknown"}: ${event.decision ?? ""} Risk: ${event.risk ?? ""}`;
+  if (event.type === "handoff")
+    return `${event.fromAgentId ?? "unknown"} -> ${event.toAgentId ?? "unknown"}: ${event.decision ?? ""} Risk: ${event.risk ?? ""}`;
   if (event.type === "required_output_updated") return `${event.outputName ?? "output"}: ${event.outputStatus ?? "unknown"}`;
   return event.text ?? event.decision ?? event.command ?? event.artifactPath ?? event.status ?? "";
 }
@@ -4840,28 +5042,6 @@ function openBrowser(url) {
 
 // src/studio/setup-init.ts
 import { createInterface } from "readline";
-function formatInitSummary(result) {
-  const lines = [
-    `${PACKAGE_NAME} v${PACKAGE_VERSION} installed.`,
-    "",
-    `Created/updated: ${result.copied.length} file(s)`,
-    `Unchanged: ${result.unchanged.length} file(s)`
-  ];
-  if (result.conflicts.length > 0) {
-    lines.push(`Conflicts to review: ${result.conflicts.length} \u2192 see .agent-kit/conflicts/`);
-  }
-  if (result.contextPath) {
-    lines.push(`Project context: ${result.contextPath}`);
-  }
-  if (result.activation?.activated.length) {
-    lines.push(`IDE activation: ${result.activation.activated.join(", ")}`);
-  }
-  if ([...result.copied, ...result.unchanged].some((path) => path.includes("agent-kit-audit.yml"))) {
-    lines.push("CI template: .github/workflows/agent-kit-audit.yml");
-  }
-  lines.push("", "Next: teach agents about your project with the setup wizard (~5 min).", "  agent-kit setup --open");
-  return lines.join("\n");
-}
 async function promptStartSetup(defaultYes = true) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
   const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -4883,7 +5063,7 @@ import { createServer } from "http";
 // src/studio/setup-form.ts
 var RECOMMENDED_SUPABASE_AUTH = "Supabase Auth with server-set session cookies via @supabase/ssr. Authorization is enforced in Postgres RLS for private tables, not only in UI code. Service-role keys stay server-only. Document how privileged admin or operator roles are granted and verified before changing auth boundaries.";
 function splitLines(value) {
-  return value.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+  return value.split(/\r?\n/).map((line2) => line2.trim()).filter(Boolean);
 }
 function uniqueStrings(values) {
   return [...new Set(values.filter(Boolean))];
@@ -4937,10 +5117,7 @@ function applySetupFormAnswers(cwd, payload) {
     qualityTarget: payload.qualityTarget,
     owners,
     lastReviewedAt: nowIso(),
-    evidence: uniqueEvidence2([
-      ...base.evidence,
-      { source: "agent-kit setup wizard", note: "Project context updated through the local web setup wizard." }
-    ])
+    evidence: uniqueEvidence2([...base.evidence, { source: "agent-kit setup wizard", note: "Project context updated through the local web setup wizard." }])
   };
   return writeProjectContext(cwd, updated);
 }
@@ -4991,8 +5168,8 @@ function parseSetupFormPayload(raw) {
 }
 
 // src/studio/wizard/checklist.ts
-import { existsSync as existsSync19, readFileSync as readFileSync16 } from "fs";
-import { join as join19 } from "path";
+import { existsSync as existsSync19, readFileSync as readFileSync18 } from "fs";
+import { join as join20 } from "path";
 var IDE_PATHS = {
   cursor: ".cursor/agents/planner.md",
   copilot: ".github/copilot-instructions.md",
@@ -5013,12 +5190,12 @@ function saveIdeChecklist(cwd, ideSurface) {
 function detectIdeRulePresent(cwd, ideSurface) {
   const rel = IDE_PATHS[ideSurface];
   if (ideSurface === "cursor") {
-    return existsSync19(join19(cwd, rel)) || existsSync19(join19(cwd, ".cursor/rules/cursor-agent-kit.mdc"));
+    return existsSync19(join20(cwd, rel)) || existsSync19(join20(cwd, ".cursor/rules/cursor-agent-kit.mdc"));
   }
   if (rel.endsWith("/")) {
-    return existsSync19(join19(cwd, rel));
+    return existsSync19(join20(cwd, rel));
   }
-  return existsSync19(join19(cwd, rel));
+  return existsSync19(join20(cwd, rel));
 }
 var VISUAL_QA_MARKER = "## Visual QA Tier";
 var VISUAL_QA_BLOCKS = {
@@ -5046,11 +5223,11 @@ This project uses the **Mature** visual QA tier.
 };
 function writeVisualQaTier(cwd, tier) {
   const path = "TESTING.md";
-  const fullPath = join19(cwd, path);
+  const fullPath = join20(cwd, path);
   if (!existsSync19(fullPath)) {
     return { updated: false, path, reason: "TESTING.md not found in project root." };
   }
-  const current = readFileSync16(fullPath, "utf8");
+  const current = readFileSync18(fullPath, "utf8");
   if (current.includes(VISUAL_QA_MARKER)) {
     return {
       updated: false,
@@ -5226,8 +5403,8 @@ function extractSetupFormFromWizardForm(form) {
 }
 
 // src/studio/wizard/drafts.ts
-import { existsSync as existsSync20, readFileSync as readFileSync17 } from "fs";
-import { join as join20 } from "path";
+import { existsSync as existsSync20, readFileSync as readFileSync19 } from "fs";
+import { join as join21 } from "path";
 var DESIGN_DRAFT_JSON = ".agent-kit/onboarding/design-draft.json";
 var MESSAGING_DRAFT_JSON = ".agent-kit/onboarding/messaging-draft.json";
 function loadDesignDraft(cwd) {
@@ -5272,11 +5449,11 @@ function previewMessagingMarkdown(draft) {
 `;
 }
 function appendSectionToDoc(cwd, doc, sectionMarkdown) {
-  const fullPath = join20(cwd, doc);
+  const fullPath = join21(cwd, doc);
   if (!existsSync20(fullPath)) {
     return { target: doc, action: "missing" };
   }
-  const current = readFileSync17(fullPath, "utf8");
+  const current = readFileSync19(fullPath, "utf8");
   if (current.includes("(wizard draft)")) {
     return { target: doc, action: "conflict", conflictPath: `.agent-kit/conflicts/wizard-${doc}` };
   }
@@ -5315,8 +5492,8 @@ function applyDrafts(cwd) {
 }
 
 // src/studio/office/render.ts
-import { readFileSync as readFileSync18 } from "fs";
-import { join as join21 } from "path";
+import { readFileSync as readFileSync20 } from "fs";
+import { join as join22 } from "path";
 
 // src/studio/office/map.ts
 var MAP_WIDTH = 28;
@@ -5434,28 +5611,16 @@ function buildOfficeStations(agents) {
 }
 
 // src/studio/office/render.ts
-var PRODUCT_CATEGORIES = [
-  "content-app",
-  "saas",
-  "admin",
-  "marketplace",
-  "tool",
-  "ecommerce",
-  "portfolio",
-  "education",
-  "community",
-  "ai-workflow",
-  "other"
-];
+var PRODUCT_CATEGORIES = ["content-app", "saas", "admin", "marketplace", "tool", "ecommerce", "portfolio", "education", "community", "ai-workflow", "other"];
 var TENANT_MODELS = ["single-user", "team", "tenant", "marketplace", "admin", "public-content"];
 function readOfficeAsset(name) {
   const root = findPackageRoot();
-  const distPath = join21(root, "dist", "studio", "office", "assets", name);
-  const srcPath = join21(root, "src", "studio", "office", "assets", name);
+  const distPath = join22(root, "dist", "studio", "office", "assets", name);
+  const srcPath = join22(root, "src", "studio", "office", "assets", name);
   try {
-    return readFileSync18(distPath, "utf8");
+    return readFileSync20(distPath, "utf8");
   } catch {
-    return readFileSync18(srcPath, "utf8");
+    return readFileSync20(srcPath, "utf8");
   }
 }
 function buildOfficeBootConfig(cwd, viewModel) {
@@ -5481,24 +5646,22 @@ function renderSetupOfficeHtml(boot) {
 function renderOfficeHtml(boot, mode) {
   const css = readOfficeAsset("office.css");
   const js = readOfficeAsset("office.js");
-  const bootJson = JSON.stringify(
-    {
-      ...boot ?? {
-        mapWidth: MAP_WIDTH,
-        mapHeight: MAP_HEIGHT,
-        tileSize: TILE_SIZE,
-        scale: CANVAS_SCALE,
-        stations: [],
-        agents: [],
-        categories: PRODUCT_CATEGORIES,
-        tenantModels: TENANT_MODELS,
-        ideSurfaces: [],
-        hasSupabase: false,
-        stackSignals: []
-      },
-      mode
-    }
-  ).replace(/</g, "\\u003c");
+  const bootJson = JSON.stringify({
+    ...boot ?? {
+      mapWidth: MAP_WIDTH,
+      mapHeight: MAP_HEIGHT,
+      tileSize: TILE_SIZE,
+      scale: CANVAS_SCALE,
+      stations: [],
+      agents: [],
+      categories: PRODUCT_CATEGORIES,
+      tenantModels: TENANT_MODELS,
+      ideSurfaces: [],
+      hasSupabase: false,
+      stackSignals: []
+    },
+    mode
+  }).replace(/</g, "\\u003c");
   const isStudio = mode === "studio";
   const title = isStudio ? "Agent Kit \u2014 Live Studio" : "Agent Kit \u2014 Setup Office";
   const dataView = isStudio ? "studio-v1" : "office-v1";
@@ -5518,14 +5681,21 @@ function renderOfficeHtml(boot, mode) {
     </div>
     <div class="header-actions">
       <span class="progress-pill" id="progress-pill">${isStudio ? "Live" : "0% ready"}</span>
+      ${isStudio ? "" : '<span class="level-pill" id="level-pill" aria-live="polite">L3 \u2192 L5</span>'}
       ${isStudio ? '<span class="session-pill" id="session-pill">No session</span>' : '<a class="btn secondary" href="/wizard">Form view</a>'}
       ${isStudio ? "" : '<button type="button" class="btn primary" id="review-btn">Review &amp; save</button>'}
     </div>
   </header>
+  ${isStudio ? "" : '<div class="iceberg-strip" id="iceberg-strip" aria-label="Agentic engineering levels L3 through L8"></div>'}
   <main class="office-main${isStudio ? " studio-layout" : ""}">
     <aside class="station-list${isStudio ? " hidden" : ""}" aria-label="Setup stations">
       <h2>Stations</h2>
       <p class="hint">Keyboard-friendly list \u2014 same actions as the office floor.</p>
+      <div class="climb-panel" id="climb-panel" hidden>
+        <h3>Climb checklist</h3>
+        <ol id="climb-list"></ol>
+        <button type="button" class="btn secondary climb-refresh" id="climb-refresh">Refresh level</button>
+      </div>
       <ul id="station-list"></ul>
     </aside>
     <div class="canvas-wrap">
@@ -5622,30 +5792,18 @@ function allAgentBriefsComplete(form, agentIds) {
 }
 
 // src/studio/wizard/render.ts
-import { readFileSync as readFileSync19 } from "fs";
-import { join as join22 } from "path";
-var PRODUCT_CATEGORIES2 = [
-  "content-app",
-  "saas",
-  "admin",
-  "marketplace",
-  "tool",
-  "ecommerce",
-  "portfolio",
-  "education",
-  "community",
-  "ai-workflow",
-  "other"
-];
+import { readFileSync as readFileSync21 } from "fs";
+import { join as join23 } from "path";
+var PRODUCT_CATEGORIES2 = ["content-app", "saas", "admin", "marketplace", "tool", "ecommerce", "portfolio", "education", "community", "ai-workflow", "other"];
 var TENANT_MODELS2 = ["single-user", "team", "tenant", "marketplace", "admin", "public-content"];
 function readWizardAsset(name) {
   const root = findPackageRoot();
-  const distPath = join22(root, "dist", "studio", "wizard", "assets", name);
-  const srcPath = join22(root, "src", "studio", "wizard", "assets", name);
+  const distPath = join23(root, "dist", "studio", "wizard", "assets", name);
+  const srcPath = join23(root, "src", "studio", "wizard", "assets", name);
   try {
-    return readFileSync19(distPath, "utf8");
+    return readFileSync21(distPath, "utf8");
   } catch {
-    return readFileSync19(srcPath, "utf8");
+    return readFileSync21(srcPath, "utf8");
   }
 }
 function mergeWizardSteps(cwd) {
@@ -5699,6 +5857,7 @@ function renderSetupWizardHtml(boot) {
         <div>
           <div style="font-weight:600;color:#f8fafc">Setup progress</div>
           <div style="font-size:13px;color:#94a3b8">Save anytime \u2014 resume with agent-kit setup</div>
+          <div class="wizard-level-pill" id="wizard-level-pill" hidden aria-live="polite">L3 \u2192 L5</div>
         </div>
       </div>
       <ul class="section-nav" id="section-nav"></ul>
@@ -5733,6 +5892,272 @@ function renderSetupWizardHtmlWithContext(cwd) {
   return renderSetupWizardHtml({ ...boot, stackSignals: [...new Set(stackSignals)] });
 }
 
+// src/studio/agentic-level.ts
+import { existsSync as existsSync21, readFileSync as readFileSync22 } from "fs";
+import { join as join24 } from "path";
+var CACHE_TTL_MS = 3e4;
+var cache = /* @__PURE__ */ new Map();
+function isMaintainerSourceRepo(cwd) {
+  return existsSync21(join24(cwd, "package.json")) && existsSync21(join24(cwd, "src")) && existsSync21(join24(cwd, "templates"));
+}
+function signal(id, level, label, pass, evidence, remediation) {
+  return { id, level, label, pass, evidence, remediation };
+}
+function detectIdePresent(cwd) {
+  const onboarding = loadOnboardingState(cwd);
+  if (onboarding.ideSurface && detectIdeRulePresent(cwd, onboarding.ideSurface)) {
+    return { pass: true, evidence: `${onboarding.ideSurface} adapter configured` };
+  }
+  const surfaces = ["cursor", "copilot", "claude", "codex"];
+  for (const surface of surfaces) {
+    if (detectIdeRulePresent(cwd, surface)) {
+      return { pass: true, evidence: `${surface} adapter files detected` };
+    }
+  }
+  if (existsSync21(join24(cwd, ".cursor/rules/cursor-agent-kit.mdc"))) {
+    return { pass: true, evidence: "Cursor council rules from init" };
+  }
+  return { pass: false, evidence: "No IDE adapter rules or subagents detected" };
+}
+function detectTierBSubagents(cwd) {
+  const paths = [".cursor/agents/planner.md", ".codex/agents/planner.toml", ".claude/agents/planner.md", ".github/copilot-instructions.md"];
+  const found = paths.filter((rel) => existsSync21(join24(cwd, rel)));
+  if (found.length > 0) {
+    return { pass: true, evidence: `Specialist surface: ${found[0]}` };
+  }
+  return { pass: false, evidence: "No council subagents or Copilot instructions installed" };
+}
+function readDocSnippet(cwd, name, needles) {
+  const path = join24(cwd, name);
+  if (!existsSync21(path)) return false;
+  const lower = readFileSync22(path, "utf8").toLowerCase();
+  return needles.every((needle) => lower.includes(needle.toLowerCase()));
+}
+function adapterTargetForIde(ide) {
+  if (ide === "cursor" || ide === "codex" || ide === "claude" || ide === "copilot") return ide;
+  return null;
+}
+function buildSignals(cwd, maintainerProfile) {
+  const signals = [];
+  const ide = detectIdePresent(cwd);
+  signals.push(
+    signal(
+      "l3-ide",
+      3,
+      "AI-native IDE or adapter rules",
+      ide.pass,
+      ide.evidence,
+      "Run agent-kit init and complete the IDE station, or agent-kit init --activate cursor|codex"
+    )
+  );
+  const context2 = scanProjectContext(cwd);
+  const openQuestions = context2.openQuestions.length;
+  const contextReady = Boolean(context2.productSummary.trim()) && Boolean(context2.primaryAudience.trim()) && Boolean(context2.authModel.trim()) && context2.primaryWorkflows.length > 0 && openQuestions === 0;
+  signals.push(
+    signal(
+      "l4-agents-md",
+      4,
+      "Council contract (AGENTS.md)",
+      existsSync21(join24(cwd, "AGENTS.md")),
+      existsSync21(join24(cwd, "AGENTS.md")) ? "AGENTS.md installed" : "AGENTS.md missing",
+      "Run agent-kit init --stack next-supabase"
+    )
+  );
+  signals.push(
+    signal(
+      "l4-adapters-doc",
+      4,
+      "Assistant activation doc",
+      existsSync21(join24(cwd, "ASSISTANT_ADAPTERS.md")),
+      existsSync21(join24(cwd, "ASSISTANT_ADAPTERS.md")) ? "ASSISTANT_ADAPTERS.md installed" : "ASSISTANT_ADAPTERS.md missing",
+      "Run agent-kit init or agent-kit update"
+    )
+  );
+  signals.push(
+    signal(
+      "l4-roster",
+      4,
+      "Machine-readable council roster",
+      existsSync21(join24(cwd, ".agent-kit/agent-roster.json")),
+      existsSync21(join24(cwd, ".agent-kit/agent-roster.json")) ? ".agent-kit/agent-roster.json present" : "Roster missing",
+      "Run agent-kit init or agent-kit update"
+    )
+  );
+  signals.push(
+    signal(
+      "l4-project-context",
+      4,
+      "Project context without open questions",
+      contextReady,
+      contextReady ? "Core project context fields complete" : openQuestions > 0 ? `${openQuestions} open question(s) remain` : "Fill product, audience, auth, and workflows in setup",
+      "Complete setup wizard or edit .agent-kit/project-context.json"
+    )
+  );
+  const tierB = detectTierBSubagents(cwd);
+  signals.push(
+    signal("l5-subagents", 5, "Tier-B specialist activation", tierB.pass, tierB.evidence, "Run agent-kit init --activate cursor|codex|claude|copilot")
+  );
+  const loopCoding = existsSync21(join24(cwd, "LOOP_CODING.md"));
+  signals.push(
+    signal(
+      "l6-loop-coding",
+      6,
+      "Loop coding playbook",
+      loopCoding,
+      loopCoding ? "LOOP_CODING.md installed" : "LOOP_CODING.md missing",
+      "Run agent-kit update or agent-kit init on a current kit version"
+    )
+  );
+  let auditPass = false;
+  let auditEvidence = "Audit not run";
+  try {
+    const audit = createAuditReport(cwd);
+    auditPass = audit.summary.fail === 0 && audit.readiness.level !== "needs-setup";
+    auditEvidence = `${audit.summary.pass} pass / ${audit.summary.warn} warn / ${audit.summary.fail} fail \xB7 ${audit.readiness.level}`;
+  } catch (error) {
+    auditEvidence = error instanceof Error ? error.message : String(error);
+  }
+  signals.push(
+    signal(
+      "l6-audit-gate",
+      6,
+      "Audit gate at baseline-setup or better",
+      auditPass,
+      auditEvidence,
+      "Run agent-kit audit --min-readiness baseline-setup and fix failures"
+    )
+  );
+  if (maintainerProfile) {
+    const pkgPath = join24(cwd, "package.json");
+    let releaseCheck = false;
+    if (existsSync21(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync22(pkgPath, "utf8"));
+        releaseCheck = Boolean(pkg.scripts?.["release:check"]) && existsSync21(join24(cwd, "scripts/release-check.mjs"));
+      } catch {
+        releaseCheck = false;
+      }
+    }
+    signals.push(
+      signal(
+        "l6-maintainer-release-check",
+        6,
+        "Maintainer release-check gate",
+        releaseCheck,
+        releaseCheck ? "npm run release:check wired in package.json" : "release:check script missing",
+        "Use npm run release:check before merge; see MAINTAINER_RELEASE.md"
+      )
+    );
+    const maintainerDocs = existsSync21(join24(cwd, "MAINTAINER_RELEASE.md")) || readDocSnippet(cwd, "DOCS.md", ["maintainer dogfood", "dogfood:init"]);
+    signals.push(
+      signal(
+        "l6-maintainer-docs",
+        6,
+        "Maintainer dogfood and release evidence docs",
+        maintainerDocs,
+        maintainerDocs ? "Maintainer climb docs present" : "Add MAINTAINER_RELEASE.md / DOCS maintainer section",
+        "Read MAINTAINER_RELEASE.md and run npm run dogfood:init locally"
+      )
+    );
+  } else {
+    const onboarding = loadOnboardingState(cwd);
+    const adapterTarget = adapterTargetForIde(onboarding.ideSurface);
+    let adapterPass = false;
+    let adapterEvidence = "No IDE surface selected for validation";
+    if (adapterTarget) {
+      const report2 = validateAdapter(cwd, adapterTarget);
+      adapterPass = report2.summary.fail === 0;
+      adapterEvidence = `${adapterTarget}: ${report2.summary.pass} pass / ${report2.summary.warn} warn / ${report2.summary.fail} fail`;
+    } else if (tierB.pass) {
+      const report2 = validateAdapter(cwd, "cursor");
+      adapterPass = report2.summary.fail === 0;
+      adapterEvidence = `cursor (detected): ${report2.summary.pass} pass / ${report2.summary.fail} fail`;
+    }
+    signals.push(
+      signal("l6-adapter-validate", 6, "Adapter validate for active IDE", adapterPass, adapterEvidence, "Run agent-kit adapter validate cursor|codex|all")
+    );
+    const ciWorkflow = existsSync21(join24(cwd, ".github/workflows/agent-kit-audit.yml"));
+    const testingEval = existsSync21(join24(cwd, "TESTING.md")) && readDocSnippet(cwd, "TESTING.md", ["agent-kit audit", "eval"]);
+    const evalLoop = ciWorkflow || testingEval;
+    signals.push(
+      signal(
+        "l6-eval-loop",
+        6,
+        "Eval-driven loop documented in CI or TESTING.md",
+        evalLoop,
+        ciWorkflow ? ".github/workflows/agent-kit-audit.yml present" : testingEval ? "TESTING.md documents eval/audit loop" : "No CI audit workflow or TESTING eval section",
+        "Enable agent-kit-audit.yml or add eval loop section to TESTING.md (see LOOP_CODING.md)"
+      )
+    );
+  }
+  return signals;
+}
+function computeCurrentLevel(signals) {
+  let current = 3;
+  for (const level of [3, 4, 5, 6]) {
+    const tier = signals.filter((item) => item.level === level);
+    if (tier.length === 0) continue;
+    if (tier.every((item) => item.pass)) {
+      current = level;
+    } else {
+      break;
+    }
+  }
+  return current;
+}
+function defaultTargetLevel(maintainerProfile) {
+  return maintainerProfile ? 6 : 5;
+}
+function resolveTargetLevel(cwd, maintainerProfile) {
+  const onboarding = loadOnboardingState(cwd);
+  const raw = onboarding.targetAgenticLevel;
+  if (raw && raw >= 3 && raw <= 8) return raw;
+  return defaultTargetLevel(maintainerProfile);
+}
+function computeAgenticLevel(cwd, options = {}) {
+  const cacheKey = cwd;
+  const cached = cache.get(cacheKey);
+  if (!options.forceRefresh && cached && Date.now() - cached.at < CACHE_TTL_MS) {
+    return cached.report;
+  }
+  const maintainerProfile = isMaintainerSourceRepo(cwd);
+  const signals = buildSignals(cwd, maintainerProfile);
+  const currentLevel = computeCurrentLevel(signals);
+  const targetLevel = resolveTargetLevel(cwd, maintainerProfile);
+  const climbSteps = signals.filter((item) => !item.pass && item.level <= Math.min(targetLevel, 6)).slice(0, 5);
+  const report2 = AgenticLevelContract.parse({
+    currentLevel,
+    targetLevel,
+    maintainerProfile,
+    computedAt: nowIso(),
+    maintainerNote: maintainerProfile ? "Kit source repo \u2014 run npm run dogfood:init locally; overlay is gitignored." : void 0,
+    signals,
+    climbSteps
+  });
+  cache.set(cacheKey, { at: Date.now(), report: report2 });
+  saveOnboardingState(cwd, {
+    lastAgenticLevel: currentLevel,
+    lastAgenticComputedAt: report2.computedAt
+  });
+  return report2;
+}
+function summarizeAdapterValidation(cwd, ideSurface) {
+  const target = adapterTargetForIde(ideSurface);
+  if (!target) {
+    return { pass: 0, warn: 0, fail: 0, target: null };
+  }
+  const report2 = validateAdapter(cwd, target);
+  return {
+    pass: report2.summary.pass,
+    warn: report2.summary.warn,
+    fail: report2.summary.fail,
+    target
+  };
+}
+function invalidateAgenticLevelCache(cwd) {
+  cache.delete(cwd);
+}
+
 // src/studio/setup-server.ts
 var DEFAULT_PORT = 9321;
 var DEFAULT_HOST = "127.0.0.1";
@@ -5776,7 +6201,7 @@ function sendHtml(response, html) {
   });
   response.end(html);
 }
-function buildStatePayload(cwd) {
+function buildStatePayload(cwd, options = {}) {
   ensureProjectContextForSetup(cwd);
   const viewModel = getSetupFormViewModel(cwd);
   const onboarding = loadOnboardingState(cwd);
@@ -5784,16 +6209,16 @@ function buildStatePayload(cwd) {
   const designDraft = loadDesignDraft(cwd);
   const messagingDraft = loadMessagingDraft(cwd);
   const draft = loadWizardDraft(cwd);
+  const agenticLevel = computeAgenticLevel(cwd, options.forceAgenticRefresh ? { forceRefresh: true } : {});
   return {
     projectName: viewModel.projectName,
     form: buildWizardFormState(cwd),
-    hasExistingContext: Boolean(
-      viewModel.form.productSummary.trim() || viewModel.form.primaryAudience.trim() || viewModel.form.valueProposition.trim()
-    ),
+    hasExistingContext: Boolean(viewModel.form.productSummary.trim() || viewModel.form.primaryAudience.trim() || viewModel.form.valueProposition.trim()),
     openQuestions: viewModel.openQuestions,
     hasSupabase: viewModel.hasSupabase,
     onboarding,
     progress,
+    agenticLevel,
     designDraft,
     messagingDraft,
     draftUpdatedAt: draft.updatedAt,
@@ -5855,8 +6280,10 @@ async function handleRequest(cwd, request, response) {
       if (body.currentSection) patch.currentSection = String(body.currentSection);
       if (typeof body.currentStep === "number") patch.currentStep = body.currentStep;
       if (Array.isArray(body.completedSections)) patch.completedSections = body.completedSections;
+      if (typeof body.targetAgenticLevel === "number") patch.targetAgenticLevel = body.targetAgenticLevel;
       if (Object.keys(patch).length > 0) saveOnboardingState(cwd, patch);
-      sendJson(response, 200, buildStatePayload(cwd));
+      invalidateAgenticLevelCache(cwd);
+      sendJson(response, 200, buildStatePayload(cwd, { forceAgenticRefresh: true }));
     } catch (error) {
       sendJson(response, 400, { error: error instanceof Error ? error.message : String(error) });
     }
@@ -5869,8 +6296,9 @@ async function handleRequest(cwd, request, response) {
       const result = applySetupFormAnswers(cwd, payload);
       saveAgentBriefs(cwd, extractAgentBriefsFromForm(raw));
       markQuickPathComplete(cwd);
+      invalidateAgenticLevelCache(cwd);
       sendJson(response, 200, {
-        ...buildStatePayload(cwd),
+        ...buildStatePayload(cwd, { forceAgenticRefresh: true }),
         saved: true,
         contextPath: result.contextPath,
         markdownPath: result.markdownPath,
@@ -5923,7 +6351,14 @@ async function handleRequest(cwd, request, response) {
       }
       const result = saveIdeChecklist(cwd, body.ideSurface);
       markSectionComplete(cwd, "ide");
-      sendJson(response, 200, { ...result, activation, ...buildStatePayload(cwd) });
+      invalidateAgenticLevelCache(cwd);
+      const adapterValidation = summarizeAdapterValidation(cwd, body.ideSurface);
+      sendJson(response, 200, {
+        ...result,
+        activation,
+        adapterValidation,
+        ...buildStatePayload(cwd, { forceAgenticRefresh: true })
+      });
     } catch (error) {
       sendJson(response, 400, { error: error instanceof Error ? error.message : String(error) });
     }
@@ -5981,6 +6416,11 @@ async function handleRequest(cwd, request, response) {
     }
     return;
   }
+  if (request.method === "POST" && url.pathname === "/api/agentic-level/refresh") {
+    invalidateAgenticLevelCache(cwd);
+    sendJson(response, 200, buildStatePayload(cwd, { forceAgenticRefresh: true }));
+    return;
+  }
   sendJson(response, 404, { error: "Not found." });
 }
 function listen(server, host, port) {
@@ -6036,7 +6476,7 @@ async function startSetupServer(options) {
 // src/studio/studio-server.ts
 import { watch } from "fs";
 import { createServer as createServer2 } from "http";
-import { join as join23 } from "path";
+import { join as join25 } from "path";
 var DEFAULT_PORT2 = 9331;
 var DEFAULT_HOST2 = "127.0.0.1";
 var sseClients = /* @__PURE__ */ new Set();
@@ -6078,7 +6518,7 @@ function stopWatcher() {
   }
 }
 function watchSessionEvents(cwd, sessionId) {
-  const eventsPath2 = join23(cwd, COUNCIL_SESSIONS_DIR, sessionId, "events.jsonl");
+  const eventsPath2 = join25(cwd, COUNCIL_SESSIONS_DIR, sessionId, "events.jsonl");
   if (watchedEventsPath === eventsPath2 && activeWatcher) return;
   stopWatcher();
   watchedEventsPath = eventsPath2;
@@ -6100,7 +6540,7 @@ function safeSessionId(raw) {
   if (!/^[a-z0-9-]+$/i.test(raw)) return null;
   return raw;
 }
-async function handleRequest2(cwd, request, response) {
+function handleRequest2(cwd, request, response) {
   const url = new URL(request.url ?? "/", "http://127.0.0.1");
   if (request.method === "GET" && (url.pathname === "/" || url.pathname === "/office")) {
     sendHtml2(response, renderLiveStudioHtmlWithContext(cwd));
@@ -6195,9 +6635,11 @@ async function startStudioServer(options) {
   const requestedPort = options.port ?? DEFAULT_PORT2;
   ensureStudioDirs(options.cwd);
   const server = createServer2((request, response) => {
-    handleRequest2(options.cwd, request, response).catch((error) => {
+    try {
+      handleRequest2(options.cwd, request, response);
+    } catch (error) {
       sendJson2(response, 500, { error: error instanceof Error ? error.message : String(error) });
-    });
+    }
   });
   let port = requestedPort;
   let portFallback = false;
@@ -6234,33 +6676,33 @@ async function startStudioServer(options) {
 }
 
 // src/studio/session-checkpoint.ts
-import { existsSync as existsSync21, readFileSync as readFileSync20 } from "fs";
-import { extname, join as join24 } from "path";
+import { existsSync as existsSync22, readFileSync as readFileSync23 } from "fs";
+import { extname, join as join26 } from "path";
 function parseCheckpointMarkdown(content) {
   const payload = { notes: [], decisions: [], handoffs: [], outputs: [] };
   const sections = content.split(/^## /m).slice(1);
   for (const section of sections) {
     const [headingLine, ...bodyLines] = section.split("\n");
     if (!headingLine) continue;
-    const heading = headingLine.trim().toLowerCase();
-    const lines = bodyLines.map((line) => line.trim()).filter(Boolean);
-    if (heading === "notes") {
-      for (const line of lines) {
-        const match = line.match(/^-?\s*@(\S+):\s*(.+)$/);
+    const heading2 = headingLine.trim().toLowerCase();
+    const lines = bodyLines.map((line2) => line2.trim()).filter(Boolean);
+    if (heading2 === "notes") {
+      for (const line2 of lines) {
+        const match = line2.match(/^-?\s*@(\S+):\s*(.+)$/);
         if (match?.[1] && match[2]) payload.notes?.push({ agent: match[1], text: match[2] });
       }
     }
-    if (heading === "decisions") {
-      for (const line of lines) {
-        const match = line.match(/^-?\s*@(\S+):\s*(.+?)(?:\s+\(risk:\s*(.+)\))?$/i);
+    if (heading2 === "decisions") {
+      for (const line2 of lines) {
+        const match = line2.match(/^-?\s*@(\S+):\s*(.+?)(?:\s+\(risk:\s*(.+)\))?$/i);
         if (match?.[1] && match[2]) {
           payload.decisions?.push({ agent: match[1], text: match[2], ...match[3] ? { risk: match[3] } : {} });
         }
       }
     }
-    if (heading === "handoffs") {
-      for (const line of lines) {
-        const match = line.match(/^-?\s*(\S+)\s*->\s*(\S+):\s*(.+?)\s+\|\s*risk:\s*(.+)$/i);
+    if (heading2 === "handoffs") {
+      for (const line2 of lines) {
+        const match = line2.match(/^-?\s*(\S+)\s*->\s*(\S+):\s*(.+?)\s+\|\s*risk:\s*(.+)$/i);
         if (match?.[1] && match?.[2] && match?.[3] && match?.[4]) {
           payload.handoffs?.push({
             fromAgentId: match[1],
@@ -6271,9 +6713,9 @@ function parseCheckpointMarkdown(content) {
         }
       }
     }
-    if (heading === "outputs") {
-      for (const line of lines) {
-        const match = line.match(/^-?\s*(.+?):\s*(missing|partial|complete|not-applicable)(?:\s+\|\s*(.+))?$/i);
+    if (heading2 === "outputs") {
+      for (const line2 of lines) {
+        const match = line2.match(/^-?\s*(.+?):\s*(missing|partial|complete|not-applicable)(?:\s+\|\s*(.+))?$/i);
         if (match?.[1] && match?.[2]) {
           payload.outputs?.push({
             name: match[1].trim(),
@@ -6283,15 +6725,15 @@ function parseCheckpointMarkdown(content) {
         }
       }
     }
-    if (heading === "options") {
-      if (lines.some((line) => /render:\s*true/i.test(line))) payload.render = true;
-      if (lines.some((line) => /close:\s*true/i.test(line))) payload.close = true;
+    if (heading2 === "options") {
+      if (lines.some((line2) => /render:\s*true/i.test(line2))) payload.render = true;
+      if (lines.some((line2) => /close:\s*true/i.test(line2))) payload.close = true;
     }
   }
   return payload;
 }
 function parseCheckpointFile(filePath) {
-  const content = readFileSync20(filePath, "utf8");
+  const content = readFileSync23(filePath, "utf8");
   const ext = extname(filePath).toLowerCase();
   if (ext === ".json") {
     const parsed = JSON.parse(content);
@@ -6367,11 +6809,55 @@ function applySessionCheckpoint(cwd, payload) {
   };
 }
 function checkpointSessionFromFile(cwd, filePath) {
-  const absolute = join24(cwd, filePath);
-  if (!existsSync21(absolute)) throw new Error(`Checkpoint file not found: ${filePath}`);
+  const absolute = join26(cwd, filePath);
+  if (!existsSync22(absolute)) throw new Error(`Checkpoint file not found: ${filePath}`);
   return applySessionCheckpoint(cwd, parseCheckpointFile(absolute));
 }
 
+// src/cli/output.ts
+import pc from "picocolors";
+var colorEnabled = process.env.NO_COLOR === void 0 && process.stdout.isTTY === true;
+function paint(painter, text) {
+  return colorEnabled ? painter(text) : text;
+}
+var style = {
+  heading: (text) => paint(pc.cyan, text),
+  pass: (text) => paint(pc.green, text),
+  warn: (text) => paint(pc.yellow, text),
+  fail: (text) => paint(pc.red, text),
+  dim: (text) => paint(pc.dim, text),
+  bold: (text) => paint(pc.bold, text)
+};
+function levelLabel(level) {
+  const label = level.toUpperCase().padEnd(4);
+  if (level === "pass") return style.pass(label);
+  if (level === "warn") return style.warn(label);
+  return style.fail(label);
+}
+function printJson(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
+function heading(text) {
+  console.log(style.heading(text));
+}
+function line(text = "") {
+  console.log(text);
+}
+function detail(text) {
+  console.log(style.dim(`  ${text}`));
+}
+function listItem(text) {
+  console.log(`- ${text}`);
+}
+function fileGroup(label, files) {
+  if (files.length === 0) return;
+  console.log(`${style.bold(label)} (${files.length})`);
+  for (const file of files) console.log(`  ${file}`);
+}
+function fail(message) {
+  console.error(style.fail(`error: ${message}`));
+}
+
 // src/cli/index.ts
 var program = new Command();
 var requiredOutputStatuses = ["missing", "partial", "complete", "not-applicable"];
@@ -6379,6 +6865,37 @@ function isRequiredOutputStatus(value) {
   return requiredOutputStatuses.includes(value);
 }
 program.name("agent-kit").description("Next.js + Supabase agent, skill, docs, design, and research kit.").version(PACKAGE_VERSION);
+async function runGuidedContextPrompts(cwd) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return;
+  const clack = await import("@clack/prompts");
+  clack.intro("agent-kit guided setup");
+  const questions = [
+    { key: "productSummary", message: "What does this product do, in one concrete paragraph?" },
+    { key: "primaryAudience", message: "Who is the primary user or buyer?" },
+    { key: "authModel", message: "What authentication model should agents preserve?" },
+    { key: "tenantModel", message: "Is this single-user, team, tenant, marketplace, admin, or public content?" }
+  ];
+  const answers = {};
+  for (const question of questions) {
+    const answer = await clack.text({ message: question.message, placeholder: "Leave empty to answer later" });
+    if (clack.isCancel(answer)) {
+      clack.cancel("Guided setup cancelled. Context files were still created; answer later with agent-kit context ask.");
+      return;
+    }
+    if (typeof answer === "string" && answer.trim()) answers[question.key] = answer.trim();
+  }
+  if (Object.keys(answers).length > 0) {
+    const contextPath = join27(cwd, ".agent-kit", "project-context.json");
+    if (existsSync23(contextPath)) {
+      const context2 = JSON.parse(readFileSync24(contextPath, "utf8"));
+      Object.assign(context2, answers);
+      writeFileSync2(contextPath, `${JSON.stringify(context2, null, 2)}
+`);
+      renderProjectContext(cwd);
+    }
+  }
+  clack.outro("Project context saved. Run agent-kit audit next.");
+}
 async function runSetupServer(options) {
   const handle = await startSetupServer({
     cwd: process.cwd(),
@@ -6386,35 +6903,73 @@ async function runSetupServer(options) {
     host: options.host
   });
   if (handle.portFallback) {
-    console.warn(
-      `Port ${handle.requestedPort} is in use \u2014 an old setup server may still be running. Kill it and restart to load the latest Agent Office.`
-    );
+    console.warn(`Port ${handle.requestedPort} is in use \u2014 an old setup server may still be running. Kill it and restart to load the latest Agent Office.`);
     console.warn(`Using fallback port ${handle.port} instead.`);
   }
   console.log(`Agent Kit v${PACKAGE_VERSION} \u2014 ${handle.defaultView} view at ${handle.url}/`);
   console.log(`Pixel office (default): ${handle.url}/  |  Form fallback: ${handle.url}/wizard`);
   console.log("Pick Quick, Standard, or Complete on first visit. Press Ctrl+C to stop.");
-  if (options.open) openBrowser(`${handle.url}/`);
+  if (options.open) void openBrowser(`${handle.url}/`);
   await new Promise((resolve3) => {
     const shutdown = () => {
-      handle.close().finally(resolve3);
+      void handle.close().finally(resolve3);
     };
     process.once("SIGINT", shutdown);
     process.once("SIGTERM", shutdown);
   });
 }
-program.command("init").description("Install agent-kit docs and library files into a project.").option("--stack <stack>", "Stack profile to install.", "next-supabase").option("--force", "Overwrite existing docs instead of writing conflicts.").option("--activate <targets...>", "Promote IDE/runtime adapters: cursor, claude, codex, copilot, antigravity, or all.").option("--guided", "Deprecated alias for default project context scan (always runs on init).").option("--json", "Print machine-readable JSON output.").option("--setup", "Start the setup wizard after install.").option("--no-setup", "Skip the post-install setup wizard prompt.").option("--open", "Open the setup wizard in your default browser.").action(async (options) => {
+program.command("init").description("Install agent-kit docs and library files into a project.").option("--stack <stack>", "Stack profile to install.", "next-supabase").option("--force", "Overwrite existing docs instead of writing conflicts.").option("--activate <targets...>", "Promote IDE/runtime adapters: cursor, claude, codex, copilot, antigravity, or all.").option("--guided", "Also create local project context files (interactive on a terminal, scan-based otherwise).").option("--dry-run", "Preview what init would create or conflict on without writing files.").option("--json", "Print machine-readable JSON output.").option("--setup", "Start the setup wizard after install.").option("--no-setup", "Skip the post-install setup wizard prompt.").option("--open", "Open the setup wizard in your default browser.").action(async (options) => {
   const cwd = process.cwd();
+  if (options.dryRun) {
+    const preview = diffProject(cwd, options.stack);
+    if (options.json) {
+      printJson({ dryRun: true, preview: preview.preview, missing: preview.missing, changed: preview.changed, unchanged: preview.unchanged });
+      return;
+    }
+    heading("agent-kit init --dry-run");
+    fileGroup("Would create", preview.preview.wouldCreate);
+    fileGroup("Would write conflicts for", preview.preview.wouldWriteConflicts);
+    fileGroup("Already up to date", preview.unchanged);
+    line();
+    line(`Run ${style.bold("agent-kit init")} to apply.`);
+    return;
+  }
   const result = initProject({
     cwd,
     stack: options.stack,
     force: Boolean(options.force),
     ...options.activate ? { activate: options.activate } : {}
   });
+  const context2 = options.guided ? initProjectContext(cwd) : null;
   if (options.json) {
-    console.log(JSON.stringify(result, null, 2));
+    printJson(context2 ? { install: result, context: context2 } : result);
   } else {
-    console.log(formatInitSummary(result));
+    heading(`agent-kit ${PACKAGE_VERSION} installed (stack: ${options.stack})`);
+    fileGroup("Created", result.copied);
+    fileGroup("Unchanged", result.unchanged);
+    fileGroup("Overwritten", result.overwritten);
+    if (result.conflicts.length > 0) {
+      fileGroup("Conflicts (local file kept, template saved for review)", result.conflicts);
+      detail("Review .agent-kit/conflicts/ before adopting template changes.");
+    }
+    line();
+    line(`Manifest: ${result.manifestPath}`);
+  }
+  if (options.guided && context2) {
+    if (!options.json) {
+      line();
+      heading("Project context");
+      line(`Context: ${context2.contextPath}`);
+      if (context2.openQuestions.length > 0) {
+        line("Open questions:");
+        for (const question of context2.openQuestions) listItem(question);
+      }
+    }
+    await runGuidedContextPrompts(cwd);
+  }
+  if (!options.json) {
+    line();
+    line(`Next: run ${style.bold("agent-kit audit")} to check readiness.`);
   }
   const shouldPrompt = !options.noSetup && !options.json;
   const startWizard = Boolean(options.setup) || shouldPrompt && await promptStartSetup(true);
@@ -6427,26 +6982,26 @@ program.command("audit").description("Audit an existing project for agent-kit co
   let minimumReadiness;
   if (options.minReadiness) {
     if (!isAuditReadinessLevel(options.minReadiness)) {
-      console.error(`Invalid --min-readiness value "${options.minReadiness}". Expected one of: ${READINESS_ORDER.join(", ")}.`);
+      fail(`Invalid --min-readiness value "${options.minReadiness}". Expected one of: ${READINESS_ORDER.join(", ")}.`);
       process.exitCode = 1;
       return;
     }
     minimumReadiness = options.minReadiness;
   }
   if (options.json) {
-    console.log(JSON.stringify(report2, null, 2));
+    printJson(report2);
   } else {
-    console.log(`READINESS ${report2.readiness.level}: ${report2.readiness.summary}`);
-    console.log(`SUMMARY pass=${report2.summary.pass} warn=${report2.summary.warn} fail=${report2.summary.fail}`);
+    const readinessStyle = report2.summary.fail > 0 ? style.fail : report2.summary.warn > 0 ? style.warn : style.pass;
+    line(`${style.bold("READINESS")} ${readinessStyle(report2.readiness.level)}: ${report2.readiness.summary}`);
+    line(`${style.bold("SUMMARY")} pass=${report2.summary.pass} warn=${report2.summary.warn} fail=${report2.summary.fail}`);
     if (report2.readiness.nextActions.length > 0) {
-      console.log("NEXT ACTIONS");
-      for (const action of report2.readiness.nextActions) console.log(`- ${action}`);
+      line(style.bold("NEXT ACTIONS"));
+      for (const action of report2.readiness.nextActions) listItem(action);
     }
-    console.log("");
+    line();
     for (const finding of report2.findings) {
-      const prefix = finding.level.toUpperCase().padEnd(4);
-      console.log(`${prefix} ${finding.area}: ${finding.message}`);
-      if (finding.remediation) console.log(`     remediation: ${finding.remediation}`);
+      line(`${levelLabel(finding.level)} ${finding.area}: ${finding.message}`);
+      if (finding.remediation) detail(`remediation: ${finding.remediation}`);
     }
   }
   if (report2.summary.fail > 0) {
@@ -6457,32 +7012,88 @@ program.command("audit").description("Audit an existing project for agent-kit co
     process.exitCode = 1;
   }
 });
-program.command("diff").description("Compare project docs against bundled templates.").action(() => {
-  console.log(JSON.stringify(diffProject(process.cwd()), null, 2));
+program.command("diff").description("Compare project docs against bundled templates.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = diffProject(process.cwd());
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  heading("agent-kit diff");
+  fileGroup("Missing (update would create)", result.missing);
+  fileGroup("Changed locally (update would write conflicts)", result.changed);
+  fileGroup("Unchanged", result.unchanged);
+  line();
+  line(`Agent roster: ${result.agentRoster}`);
+  line(`Model routing: ${result.modelRouting}`);
+  if (result.libraryFolders.missing.length > 0) {
+    line(`Missing library folders: ${result.libraryFolders.missing.join(", ")}`);
+  }
+  line();
+  line(`Next: run ${style.bold("agent-kit update --dry-run")} to preview the exact per-file plan.`);
 });
-program.command("update").description("Update installed templates, preserving local conflicts by default.").option("--force", "Overwrite local docs.").action((options) => {
-  const result = initProject({ cwd: process.cwd(), force: Boolean(options.force) });
-  console.log(JSON.stringify(result, null, 2));
+program.command("update").description("Update installed templates: pristine docs are refreshed, local edits are preserved, and template conflicts are written for review.").option("--force", "Overwrite locally customized docs with the current templates.").option("--dry-run", "Report what would change without writing any files.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = updateProject({ cwd: process.cwd(), force: Boolean(options.force), dryRun: Boolean(options.dryRun) });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  heading(result.dryRun ? "agent-kit update --dry-run" : "agent-kit update");
+  const byAction = (action) => result.files.filter((file) => file.action === action).map((file) => file.target);
+  fileGroup(result.dryRun ? "Would create" : "Created", byAction("created"));
+  fileGroup(result.dryRun ? "Would update (pristine)" : "Updated (pristine)", byAction("updated"));
+  fileGroup("Kept local customizations", byAction("kept-local"));
+  fileGroup(result.dryRun ? "Would overwrite" : "Overwritten", byAction("overwritten"));
+  const conflicts = result.files.filter((file) => file.action === "conflict");
+  if (conflicts.length > 0) {
+    line(`${style.bold("Conflicts")} (${conflicts.length})`);
+    for (const file of conflicts) {
+      line(`  ${file.target}${file.conflictPath ? ` -> ${file.conflictPath}` : ""}`);
+    }
+    detail("Local files were kept. Review the conflict copies before adopting template changes.");
+  }
+  detail(`unchanged: ${result.summary.unchanged} file(s) already match the current templates`);
+  if (!result.dryRun) {
+    line();
+    line(`Library folders refreshed: ${result.libraryFoldersRefreshed.length}`);
+    line(`Manifest: ${result.manifestPath}`);
+  }
 });
 var addCommand = program.command("add").description("Add one agent-kit asset.");
-addCommand.command("skill <name>").description("Add a single skill into .agent-kit/skills.").option("--force", "Overwrite existing skill.").action((name, options) => {
-  console.log(addSkill(process.cwd(), name, { force: Boolean(options.force) }));
+addCommand.command("skill <name>").description("Add a single skill into .agent-kit/skills.").option("--force", "Overwrite existing skill.").option("--dry-run", "Report what would happen without writing.").option("--json", "Print machine-readable JSON output.").action((name, options) => {
+  const result = addSkill(process.cwd(), name, { force: Boolean(options.force), dryRun: Boolean(options.dryRun) });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  line(`${result.action}: ${result.target}${result.conflictPath ? ` -> ${result.conflictPath}` : ""}`);
+  if (options.dryRun) detail("dry run: no files were written");
 });
-program.command("doctor").description("Validate local CLI runtime prerequisites.").action(() => {
+program.command("doctor").description("Validate local CLI runtime prerequisites.").option("--json", "Print machine-readable JSON output.").action((options) => {
   const cwd = process.cwd();
-  console.log("agent-kit doctor");
-  console.log(`node: ${process.version}`);
-  console.log(`available skills: ${listSkills().length}`);
-  if (onboardingStateExists(cwd)) {
-    const progress = getSetupProgress(cwd);
-    console.log(`setup progress: ${progress.percent}% (depth: ${progress.depth})`);
-    if (!progress.quickComplete) {
-      console.log("tip: run agent-kit setup --open to finish project context onboarding.");
+  const report2 = {
+    version: PACKAGE_VERSION,
+    node: process.version,
+    availableSkills: listSkills().length,
+    setupProgress: onboardingStateExists(cwd) ? getSetupProgress(cwd) : null,
+    status: "ok"
+  };
+  if (options.json) {
+    printJson(report2);
+    return;
+  }
+  heading("agent-kit doctor");
+  line(`version: ${report2.version}`);
+  line(`node: ${report2.node}`);
+  line(`available skills: ${report2.availableSkills}`);
+  if (report2.setupProgress) {
+    line(`setup progress: ${report2.setupProgress.percent}% (depth: ${report2.setupProgress.depth})`);
+    if (!report2.setupProgress.quickComplete) {
+      detail("run agent-kit setup --open to finish project context onboarding.");
     }
   } else {
-    console.log("tip: run agent-kit init then agent-kit setup to onboard this project.");
+    detail("run agent-kit init then agent-kit setup to onboard this project.");
   }
-  console.log("status: ok");
+  line(`status: ${style.pass(report2.status)}`);
 });
 function printValidationReport(report2, json) {
   if (json) {
@@ -6515,8 +7126,19 @@ packageCommand.command("validate").description("Validate package assets, runtime
   printValidationReport(report2, Boolean(options.json));
   if (report2.summary.fail > 0) process.exitCode = 1;
 });
-program.command("onboard").description("Create or refresh local project context files for installed agents.").option("--refresh", "Refresh inferred context from the current project state.").action(() => {
-  console.log(JSON.stringify(initProjectContext(process.cwd()), null, 2));
+program.command("onboard").description("Create or refresh local project context files for installed agents.").option("--refresh", "Refresh inferred context from the current project state.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = initProjectContext(process.cwd());
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  heading("agent-kit onboard");
+  line(`Context: ${result.contextPath}`);
+  line(`Markdown: ${result.markdownPath}`);
+  if (result.openQuestions.length > 0) {
+    line("Open questions:");
+    for (const question of result.openQuestions) listItem(question);
+  }
 });
 program.command("setup").description("Start the local Agent Office setup view for project context.").option("--port <number>", "Port to listen on.", (value) => Number.parseInt(value, 10), 9321).option("--host <host>", "Host to bind.", "127.0.0.1").option("--open", "Open the wizard in your default browser.").option("--status", "Print setup progress and exit.").action(async (options) => {
   const cwd = process.cwd();
@@ -6529,140 +7151,194 @@ program.command("setup").description("Start the local Agent Office setup view fo
   await runSetupServer({ port: options.port, host: options.host, open: Boolean(options.open) });
 });
 var context = program.command("context").description("Manage local project context for Agent Studio.");
-context.command("init").description("Create project context from a local scan.").action(() => {
-  console.log(JSON.stringify(initProjectContext(process.cwd()), null, 2));
+context.command("init").description("Create project context from a local scan.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = initProjectContext(process.cwd());
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  line(`Context written: ${result.contextPath}`);
+  if (result.openQuestions.length > 0) {
+    line("Open questions:");
+    for (const question of result.openQuestions) listItem(question);
+  }
 });
 context.command("scan").description("Print inferred project context without writing it.").action(() => {
-  console.log(JSON.stringify(scanProjectContext(process.cwd()), null, 2));
+  printJson(scanProjectContext(process.cwd()));
 });
 context.command("ask").description("Print unanswered high-value project context questions.").action(() => {
   const result = initProjectContext(process.cwd());
   if (result.openQuestions.length === 0) {
-    console.log("No open project-context questions.");
+    line("No open project-context questions.");
     return;
   }
-  console.log("Answer these in the web setup wizard with: agent-kit setup --open");
-  console.log("Check progress with: agent-kit setup --status");
-  for (const question of result.openQuestions) console.log(`- ${question}`);
+  line("Answer these in the web setup wizard with: agent-kit setup --open");
+  detail("Check progress with: agent-kit setup --status");
+  for (const question of result.openQuestions) listItem(question);
 });
-context.command("render").description("Render .agent-kit/project-context.md from project-context.json.").action(() => {
-  console.log(JSON.stringify(renderProjectContext(process.cwd()), null, 2));
+context.command("render").description("Render .agent-kit/project-context.md from project-context.json.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = renderProjectContext(process.cwd());
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  line(`Rendered: ${result.markdownPath}`);
 });
-context.command("validate").description("Validate .agent-kit/project-context.json.").action(() => {
-  console.log(JSON.stringify(validateProjectContext(process.cwd()), null, 2));
+context.command("validate").description("Validate .agent-kit/project-context.json.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = validateProjectContext(process.cwd());
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  line(`Valid: ${result.contextPath}`);
+  if (result.openQuestions.length > 0) {
+    line("Open questions:");
+    for (const question of result.openQuestions) listItem(question);
+  }
 });
 context.command("show").description("Print rendered project context markdown.").action(() => {
   console.log(readTextFile(process.cwd(), ".agent-kit/project-context.md") ?? "");
 });
 var session = program.command("session").description("Record and render local Agent Studio council sessions.");
-session.command("start <title...>").description("Start a local council session.").option("--workflow <workflow>", "Workflow id.", "planning").option("--request <request>", "Original user request.").action((titleParts, options) => {
+session.command("start <title...>").description("Start a local council session.").option("--workflow <workflow>", "Workflow id.", "planning").option("--request <request>", "Original user request.").option("--json", "Print machine-readable JSON output.").action((titleParts, options) => {
   const title = titleParts.join(" ");
-  console.log(
-    JSON.stringify(
-      startSession(process.cwd(), {
-        title,
-        workflowId: options.workflow,
-        ...options.request ? { request: options.request } : {}
-      }),
-      null,
-      2
-    )
-  );
+  const result = startSession(process.cwd(), {
+    title,
+    workflowId: options.workflow,
+    ...options.request ? { request: options.request } : {}
+  });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  line(`Session started: ${result.sessionId}`);
+  line(`Path: ${result.sessionPath}`);
 });
-session.command("list").description("List local council sessions.").action(() => {
-  console.log(JSON.stringify(listSessions(process.cwd()), null, 2));
+session.command("list").description("List local council sessions.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const sessions = listSessions(process.cwd());
+  if (options.json) {
+    printJson(sessions);
+    return;
+  }
+  if (sessions.length === 0) {
+    line("No sessions yet. Start one with agent-kit session start <title>.");
+    return;
+  }
+  for (const item of sessions) {
+    line(`${item.sessionId} [${item.status}] ${item.title}`);
+  }
 });
 session.command("active").description("Print the active council session id.").action(() => {
   console.log(getActiveSessionId(process.cwd()));
 });
-session.command("note <text...>").description("Record a visible agent message.").requiredOption("--agent <agent>", "Agent id.").action((textParts, options) => {
-  console.log(JSON.stringify(recordNote(process.cwd(), options.agent, textParts.join(" ")), null, 2));
+session.command("note <text...>").description("Record a visible agent message.").requiredOption("--agent <agent>", "Agent id.").option("--json", "Print machine-readable JSON output.").action((textParts, options) => {
+  const result = recordNote(process.cwd(), options.agent, textParts.join(" "));
+  if (options.json) printJson(result);
+  else line(`Recorded note from ${options.agent}.`);
 });
-session.command("decision <text...>").description("Record an agent decision.").requiredOption("--agent <agent>", "Agent id.").option("--risk <risk>", "Risk associated with the decision.").action((textParts, options) => {
-  console.log(JSON.stringify(recordDecision(process.cwd(), options.agent, textParts.join(" "), options.risk), null, 2));
+session.command("decision <text...>").description("Record an agent decision.").requiredOption("--agent <agent>", "Agent id.").option("--risk <risk>", "Risk associated with the decision.").option("--json", "Print machine-readable JSON output.").action((textParts, options) => {
+  const result = recordDecision(process.cwd(), options.agent, textParts.join(" "), options.risk);
+  if (options.json) printJson(result);
+  else line(`Recorded decision from ${options.agent}.`);
 });
-session.command("handoff").description("Record an agent handoff.").requiredOption("--from <agent>", "Source agent id.").requiredOption("--to <agent>", "Target agent id.").requiredOption("--decision <decision>", "Decision being handed off.").requiredOption("--risk <risk>", "Risk that remains.").option("--evidence <evidence...>", "Evidence paths or notes.").action((options) => {
-  console.log(
-    JSON.stringify(
-      recordHandoff(process.cwd(), {
-        fromAgentId: options.from,
-        toAgentId: options.to,
-        decision: options.decision,
-        risk: options.risk,
-        ...options.evidence ? { evidence: options.evidence } : {}
-      }),
-      null,
-      2
-    )
-  );
+session.command("handoff").description("Record an agent handoff.").requiredOption("--from <agent>", "Source agent id.").requiredOption("--to <agent>", "Target agent id.").requiredOption("--decision <decision>", "Decision being handed off.").requiredOption("--risk <risk>", "Risk that remains.").option("--evidence <evidence...>", "Evidence paths or notes.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = recordHandoff(process.cwd(), {
+    fromAgentId: options.from,
+    toAgentId: options.to,
+    decision: options.decision,
+    risk: options.risk,
+    ...options.evidence ? { evidence: options.evidence } : {}
+  });
+  if (options.json) printJson(result);
+  else line(`Recorded handoff ${options.from} -> ${options.to}.`);
 });
-session.command("correct <text...>").description("Record a human correction and optionally promote it to durable rules.").option("--agent <agent>", "Agent id.").option("--scope <scope>", "Correction scope: session, project, agent, upstream-proposal.", "session").action((textParts, options) => {
-  console.log(
-    JSON.stringify(
-      recordCorrection(process.cwd(), {
-        ...options.agent ? { agentId: options.agent } : {},
-        scope: options.scope,
-        text: textParts.join(" ")
-      }),
-      null,
-      2
-    )
-  );
+session.command("correct <text...>").description("Record a human correction and optionally promote it to durable rules.").option("--agent <agent>", "Agent id.").option("--scope <scope>", "Correction scope: session, project, agent, upstream-proposal.", "session").option("--json", "Print machine-readable JSON output.").action((textParts, options) => {
+  const result = recordCorrection(process.cwd(), {
+    ...options.agent ? { agentId: options.agent } : {},
+    scope: options.scope,
+    text: textParts.join(" ")
+  });
+  if (options.json) printJson(result);
+  else line(`Recorded ${options.scope}-scoped correction.`);
 });
-session.command("artifact").description("Record a changed or relevant artifact path.").requiredOption("--file <file>", "Artifact file path.").option("--note <note>", "Artifact note.").action((options) => {
-  console.log(JSON.stringify(recordArtifact(process.cwd(), options.file, options.note), null, 2));
+session.command("artifact").description("Record a changed or relevant artifact path.").requiredOption("--file <file>", "Artifact file path.").option("--note <note>", "Artifact note.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = recordArtifact(process.cwd(), options.file, options.note);
+  if (options.json) printJson(result);
+  else line(`Recorded artifact ${options.file}.`);
 });
-session.command("verify").description("Record verification evidence.").requiredOption("--command <command>", "Command or review performed.").requiredOption("--result <result>", "pass, fail, or skipped.").option("--notes <notes>", "Verification notes.").action((options) => {
-  console.log(JSON.stringify(recordVerification(process.cwd(), options.command, options.result, options.notes), null, 2));
+session.command("verify").description("Record verification evidence.").requiredOption("--command <command>", "Command or review performed.").requiredOption("--result <result>", "pass, fail, or skipped.").option("--notes <notes>", "Verification notes.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = recordVerification(process.cwd(), options.command, options.result, options.notes);
+  if (options.json) printJson(result);
+  else line(`Recorded verification (${options.result}): ${options.command}`);
 });
-session.command("output <name...>").description("Mark a required session output status.").requiredOption("--status <status>", "missing, partial, complete, or not-applicable.").option("--evidence <evidence>", "Evidence path, command, or note.").action((nameParts, options) => {
+session.command("output <name...>").description("Mark a required session output status.").requiredOption("--status <status>", "missing, partial, complete, or not-applicable.").option("--evidence <evidence>", "Evidence path, command, or note.").option("--json", "Print machine-readable JSON output.").action((nameParts, options) => {
   if (!isRequiredOutputStatus(options.status)) {
-    console.error(`Invalid --status value "${options.status}". Expected one of: ${requiredOutputStatuses.join(", ")}.`);
+    fail(`Invalid --status value "${options.status}". Expected one of: ${requiredOutputStatuses.join(", ")}.`);
     process.exitCode = 1;
     return;
   }
-  console.log(JSON.stringify(recordRequiredOutput(process.cwd(), nameParts.join(" "), options.status, options.evidence), null, 2));
+  const result = recordRequiredOutput(process.cwd(), nameParts.join(" "), options.status, options.evidence);
+  if (options.json) printJson(result);
+  else line(`Marked "${nameParts.join(" ")}" as ${options.status}.`);
 });
-session.command("render").description("Render active session Markdown files.").action(() => {
-  console.log(JSON.stringify(renderActiveSession(process.cwd()), null, 2));
+session.command("render").description("Render active session Markdown files.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = renderActiveSession(process.cwd());
+  if (options.json) printJson(result);
+  else line(`Rendered session ${result.sessionId} at ${result.sessionPath}.`);
 });
 session.command("checkpoint").description("Apply a batch of session events from a JSON or Markdown checkpoint file.").requiredOption("--file <file>", "Checkpoint file (.json or .md) relative to the project root.").action((options) => {
   console.log(JSON.stringify(checkpointSessionFromFile(process.cwd(), options.file), null, 2));
 });
-session.command("close").description("Close the active session.").option("--status <status>", "planned, in-progress, blocked, or complete.", "complete").action((options) => {
-  console.log(JSON.stringify(closeSession(process.cwd(), options.status), null, 2));
+session.command("close").description("Close the active session.").option("--status <status>", "planned, in-progress, blocked, or complete.", "complete").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = closeSession(process.cwd(), options.status);
+  if (options.json) printJson(result);
+  else line(`Closed session ${result.sessionId} with status ${options.status}.`);
 });
 var correction = program.command("correction").description("Manage durable Agent Studio correction rules.");
-correction.command("list").description("List correction rules.").action(() => {
-  console.log(JSON.stringify(listCorrections(process.cwd()), null, 2));
+correction.command("list").description("List correction rules.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const corrections = listCorrections(process.cwd());
+  if (options.json) {
+    printJson(corrections);
+    return;
+  }
+  const rules = [...corrections.project, ...corrections.agent, ...corrections.upstream];
+  if (rules.length === 0) {
+    line("No correction rules yet. Add one with agent-kit correction add <text>.");
+    return;
+  }
+  for (const rule of rules) {
+    line(`${rule.id} [${rule.status}] (${rule.scope}) ${rule.text}`);
+  }
 });
-correction.command("add <text...>").description("Add a durable correction rule.").option("--scope <scope>", "Correction scope: project, agent, or upstream-proposal.", "project").option("--agent <agent>", "Agent id for agent-scoped corrections.").action((textParts, options) => {
-  console.log(
-    JSON.stringify(
-      addCorrection(process.cwd(), {
-        scope: options.scope,
-        ...options.agent ? { agentId: options.agent } : {},
-        text: textParts.join(" ")
-      }),
-      null,
-      2
-    )
-  );
+correction.command("add <text...>").description("Add a durable correction rule.").option("--scope <scope>", "Correction scope: project, agent, or upstream-proposal.", "project").option("--agent <agent>", "Agent id for agent-scoped corrections.").option("--json", "Print machine-readable JSON output.").action((textParts, options) => {
+  const result = addCorrection(process.cwd(), {
+    scope: options.scope,
+    ...options.agent ? { agentId: options.agent } : {},
+    text: textParts.join(" ")
+  });
+  if (options.json) printJson(result);
+  else line(`Added ${options.scope}-scoped correction ${result.id}.`);
 });
-correction.command("apply [id]").description("Mark a correction rule active and reviewed.").option("--id <id>", "Correction id.").action((idArgument, options) => {
+correction.command("apply [id]").description("Mark a correction rule active and reviewed.").option("--id <id>", "Correction id.").option("--json", "Print machine-readable JSON output.").action((idArgument, options) => {
   const id = idArgument ?? options.id;
   if (!id) {
-    console.error("Missing correction id. Use agent-kit correction apply <id> or --id <id>.");
+    fail("Missing correction id. Use agent-kit correction apply <id> or --id <id>.");
     process.exitCode = 1;
     return;
   }
-  console.log(JSON.stringify(applyCorrection(process.cwd(), id), null, 2));
+  const result = applyCorrection(process.cwd(), id);
+  if (options.json) printJson(result);
+  else line(`Applied correction ${id}.`);
 });
-correction.command("retire <id>").description("Retire a correction rule.").requiredOption("--reason <reason>", "Reason for retirement.").action((id, options) => {
-  console.log(JSON.stringify(retireCorrection(process.cwd(), id, options.reason), null, 2));
+correction.command("retire <id>").description("Retire a correction rule.").requiredOption("--reason <reason>", "Reason for retirement.").option("--json", "Print machine-readable JSON output.").action((id, options) => {
+  const result = retireCorrection(process.cwd(), id, options.reason);
+  if (options.json) printJson(result);
+  else line(`Retired correction ${id}: ${options.reason}`);
 });
-correction.command("propose-upstream <id>").description("Create an upstream proposal from a project or agent correction.").action((id) => {
-  console.log(JSON.stringify(proposeCorrectionUpstream(process.cwd(), id), null, 2));
+correction.command("propose-upstream <id>").description("Create an upstream proposal from a project or agent correction.").option("--json", "Print machine-readable JSON output.").action((id, options) => {
+  const result = proposeCorrectionUpstream(process.cwd(), id);
+  if (options.json) printJson(result);
+  else line(`Created upstream proposal from correction ${id}.`);
 });
 var studio = program.command("studio").description("Export and serve local Agent Studio views.");
 async function runStudioServer(options) {
@@ -6672,16 +7348,14 @@ async function runStudioServer(options) {
     host: options.host
   });
   if (handle.portFallback) {
-    console.warn(
-      `Port ${handle.requestedPort} is in use \u2014 using fallback port ${handle.port}. Kill the old process to avoid confusion.`
-    );
+    console.warn(`Port ${handle.requestedPort} is in use \u2014 using fallback port ${handle.port}. Kill the old process to avoid confusion.`);
   }
   console.log(`Agent Kit v${PACKAGE_VERSION} \u2014 live studio at ${handle.url}/`);
   console.log("SSE: GET /api/events/stream  |  Press Ctrl+C to stop.");
-  if (options.open) openBrowser(`${handle.url}/`);
+  if (options.open) void openBrowser(`${handle.url}/`);
   await new Promise((resolve3) => {
     const shutdown = () => {
-      handle.close().finally(resolve3);
+      void handle.close().finally(resolve3);
     };
     process.once("SIGINT", shutdown);
     process.once("SIGTERM", shutdown);
@@ -6690,8 +7364,13 @@ async function runStudioServer(options) {
 studio.command("serve").description("Start localhost live Agent Studio viewer with SSE session events.").option("--port <number>", "Port to listen on.", (value) => Number.parseInt(value, 10), 9331).option("--host <host>", "Host to bind.", "127.0.0.1").option("--open", "Open the studio in your default browser.").action(async (options) => {
   await runStudioServer(options);
 });
-studio.command("export").description("Generate a self-contained static Agent Studio HTML file.").action(() => {
-  console.log(JSON.stringify(exportStaticStudio(process.cwd()), null, 2));
+studio.command("export").description("Generate a self-contained static Agent Studio HTML file.").option("--json", "Print machine-readable JSON output.").action((options) => {
+  const result = exportStaticStudio(process.cwd());
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  line(`Exported ${result.sessionCount} session(s) to ${result.studioPath}.`);
 });
 var research = program.command("research").description("Research high-quality open-source repositories.");
 research.command("discover").description("Discover GitHub repo candidates using configured queries.").option("--limit <number>", "Maximum repositories to write.", (value) => Number.parseInt(value, 10)).action(async (options) => {
@@ -6713,7 +7392,7 @@ research.command("propose-updates").description("Create a research-to-template u
   console.log(proposeUpdates(process.cwd()));
 });
 program.parseAsync(process.argv).catch((error) => {
-  console.error(error instanceof Error ? error.message : String(error));
+  fail(error instanceof Error ? error.message : String(error));
   process.exitCode = 1;
 });
 //# sourceMappingURL=index.js.map