@appsforgood/next-supabase-kit 0.1.4 → 0.1.5

package/dist/index.js

@@ -146,7 +146,7 @@ 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.5";
 var DEFAULT_CONFIG = {
   stack: "next-supabase",
   projectType: "saas",
@@ -185,6 +185,7 @@ var ROOT_DOCS = [
   "STYLE_GUIDE.md",
   "SECURITY.md",
   "TESTING.md",
+  "LOOP_CODING.md",
   "DEPLOYMENT.md",
   "UPGRADE.md"
 ];
@@ -629,6 +630,15 @@ 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 +652,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) => {
@@ -1735,7 +1765,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"];
@@ -5518,14 +5549,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">
@@ -5699,6 +5737,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 +5772,291 @@ function renderSetupWizardHtmlWithContext(cwd) {
   return renderSetupWizardHtml({ ...boot, stackSignals: [...new Set(stackSignals)] });
 }
 
+// src/studio/agentic-level.ts
+import { existsSync as existsSync21, readFileSync as readFileSync20 } from "fs";
+import { join as join23 } from "path";
+var CACHE_TTL_MS = 3e4;
+var cache = /* @__PURE__ */ new Map();
+function isMaintainerSourceRepo(cwd) {
+  return existsSync21(join23(cwd, "package.json")) && existsSync21(join23(cwd, "src")) && existsSync21(join23(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(join23(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(join23(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 = join23(cwd, name);
+  if (!existsSync21(path)) return false;
+  const lower = readFileSync20(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(join23(cwd, "AGENTS.md")),
+      existsSync21(join23(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(join23(cwd, "ASSISTANT_ADAPTERS.md")),
+      existsSync21(join23(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(join23(cwd, ".agent-kit/agent-roster.json")),
+      existsSync21(join23(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(join23(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 = join23(cwd, "package.json");
+    let releaseCheck = false;
+    if (existsSync21(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync20(pkgPath, "utf8"));
+        releaseCheck = Boolean(pkg.scripts?.["release:check"]) && existsSync21(join23(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(join23(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(join23(cwd, ".github/workflows/agent-kit-audit.yml"));
+    const testingEval = existsSync21(join23(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 +6100,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,6 +6108,10 @@ 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),
@@ -5794,6 +6122,7 @@ function buildStatePayload(cwd) {
     hasSupabase: viewModel.hasSupabase,
     onboarding,
     progress,
+    agenticLevel,
     designDraft,
     messagingDraft,
     draftUpdatedAt: draft.updatedAt,
@@ -5855,8 +6184,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 +6200,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 +6255,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 +6320,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 +6380,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 join24 } from "path";
 var DEFAULT_PORT2 = 9331;
 var DEFAULT_HOST2 = "127.0.0.1";
 var sseClients = /* @__PURE__ */ new Set();
@@ -6078,7 +6422,7 @@ function stopWatcher() {
   }
 }
 function watchSessionEvents(cwd, sessionId) {
-  const eventsPath2 = join23(cwd, COUNCIL_SESSIONS_DIR, sessionId, "events.jsonl");
+  const eventsPath2 = join24(cwd, COUNCIL_SESSIONS_DIR, sessionId, "events.jsonl");
   if (watchedEventsPath === eventsPath2 && activeWatcher) return;
   stopWatcher();
   watchedEventsPath = eventsPath2;
@@ -6234,8 +6578,8 @@ 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 readFileSync21 } from "fs";
+import { extname, join as join25 } from "path";
 function parseCheckpointMarkdown(content) {
   const payload = { notes: [], decisions: [], handoffs: [], outputs: [] };
   const sections = content.split(/^## /m).slice(1);
@@ -6291,7 +6635,7 @@ function parseCheckpointMarkdown(content) {
   return payload;
 }
 function parseCheckpointFile(filePath) {
-  const content = readFileSync20(filePath, "utf8");
+  const content = readFileSync21(filePath, "utf8");
   const ext = extname(filePath).toLowerCase();
   if (ext === ".json") {
     const parsed = JSON.parse(content);
@@ -6367,8 +6711,8 @@ 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 = join25(cwd, filePath);
+  if (!existsSync22(absolute)) throw new Error(`Checkpoint file not found: ${filePath}`);
   return applySessionCheckpoint(cwd, parseCheckpointFile(absolute));
 }