swallowkit 2.0.0-alpha.2 → 2.0.0-alpha.4

package/dist/utils/python-uv.js

@@ -33,16 +33,22 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SWALLOWKIT_PYTHON_VERSION = void 0;
+exports.DEFAULT_AZURE_PYTHON_VERSION = void 0;
 exports.getPythonProjectRoot = getPythonProjectRoot;
 exports.getProjectLocalUvPaths = getProjectLocalUvPaths;
-exports.buildProjectLocalUvEnv = buildProjectLocalUvEnv;
 exports.buildProjectLocalUvInstallerEnv = buildProjectLocalUvInstallerEnv;
 exports.getProjectLocalUvInstallerCommand = getProjectLocalUvInstallerCommand;
 exports.buildUvVenvArgs = buildUvVenvArgs;
+exports.getVirtualEnvPythonPath = getVirtualEnvPythonPath;
+exports.ensureUvVirtualEnvironment = ensureUvVirtualEnvironment;
 exports.buildUvPipInstallArgs = buildUvPipInstallArgs;
+exports.buildPythonCodegenInstallEnv = buildPythonCodegenInstallEnv;
 const path = __importStar(require("path"));
-exports.SWALLOWKIT_PYTHON_VERSION = "3.11";
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+exports.DEFAULT_AZURE_PYTHON_VERSION = "3.14";
 function getPythonProjectRoot(functionsDir) {
     return path.dirname(functionsDir);
 }
@@ -51,39 +57,28 @@ function getProjectLocalUvPaths(projectRoot) {
     const localUvInstallDir = path.join(stateDir, "bin");
     return {
         stateDir,
-        cacheDir: path.join(stateDir, "cache"),
-        pythonInstallDir: path.join(stateDir, "python"),
-        toolDir: path.join(stateDir, "tools"),
-        toolBinDir: path.join(stateDir, "tools", "bin"),
         localUvInstallDir,
         localUvExecutable: process.platform === "win32"
             ? path.join(localUvInstallDir, "uv.exe")
             : path.join(localUvInstallDir, "uv"),
     };
 }
-function buildProjectLocalUvEnv(baseEnv, projectRoot) {
+function buildProjectLocalUvInstallerEnv(baseEnv, projectRoot) {
     const uvPaths = getProjectLocalUvPaths(projectRoot);
     const env = {
         ...baseEnv,
-        UV_CACHE_DIR: uvPaths.cacheDir,
-        UV_PYTHON_INSTALL_DIR: uvPaths.pythonInstallDir,
-        UV_TOOL_DIR: uvPaths.toolDir,
-        UV_TOOL_BIN_DIR: uvPaths.toolBinDir,
-        UV_PYTHON_PREFERENCE: "only-managed",
+        UV_UNMANAGED_INSTALL: uvPaths.localUvInstallDir,
+        UV_NO_MODIFY_PATH: "1",
     };
+    // Windows PowerShell must discover its own modules, not inherit PowerShell 7's.
     if (process.platform === "win32") {
-        env.UV_PYTHON_NO_REGISTRY = "true";
+        for (const key of Object.keys(env)) {
+            if (key.toLowerCase() === "psmodulepath")
+                delete env[key];
+        }
     }
     return env;
 }
-function buildProjectLocalUvInstallerEnv(baseEnv, projectRoot) {
-    const uvPaths = getProjectLocalUvPaths(projectRoot);
-    return {
-        ...buildProjectLocalUvEnv(baseEnv, projectRoot),
-        UV_UNMANAGED_INSTALL: uvPaths.localUvInstallDir,
-        UV_NO_MODIFY_PATH: "1",
-    };
-}
 function getProjectLocalUvInstallerCommand() {
     if (process.platform === "win32") {
         return {
@@ -102,10 +97,41 @@ function getProjectLocalUvInstallerCommand() {
         args: ["-c", "curl -LsSf https://astral.sh/uv/install.sh | sh"],
     };
 }
-function buildUvVenvArgs(venvDir, pythonVersion = exports.SWALLOWKIT_PYTHON_VERSION) {
-    return ["venv", venvDir, "--python", pythonVersion];
+function buildUvVenvArgs(venvDir) {
+    return ["venv", venvDir];
+}
+function getVirtualEnvPythonPath(venvDir) {
+    return process.platform === "win32"
+        ? path.join(venvDir, "Scripts", "python.exe")
+        : path.join(venvDir, "bin", "python");
+}
+async function ensureUvVirtualEnvironment(uvCommand, venvDir, cwd, env) {
+    const pythonExecutable = getVirtualEnvPythonPath(venvDir);
+    if (!fs.existsSync(venvDir)) {
+        const { stdout, stderr } = await execFileAsync(uvCommand, buildUvVenvArgs(venvDir), { cwd, env });
+        if (env.SWALLOWKIT_MACHINE_OUTPUT !== "1") {
+            if (stdout)
+                process.stdout.write(stdout);
+            if (stderr)
+                process.stderr.write(stderr);
+        }
+    }
+    try {
+        await execFileAsync(pythonExecutable, ["--version"], { cwd, env });
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new Error(`Cannot execute Python at ${pythonExecutable}: ${reason}\n` +
+            "The virtual environment was preserved. Check the interpreter and OS application-control policy. " +
+            "To switch Python, explicitly recreate this environment with uv and a trusted interpreter; SwallowKit will not clear it automatically.");
+    }
+    return pythonExecutable;
 }
 function buildUvPipInstallArgs(pythonExecutable, requirementsPath) {
     return ["pip", "install", "--python", pythonExecutable, "-r", requirementsPath];
 }
+function buildPythonCodegenInstallEnv(env) {
+    // Codegen reads JSON; PyYAML's optional accelerator must not require a C compiler.
+    return { ...env, PYYAML_FORCE_LIBYAML: env.PYYAML_FORCE_LIBYAML ?? "0" };
+}
 //# sourceMappingURL=python-uv.js.map

package/dist/utils/python-uv.js.map

@@ -1 +1 @@
-{"version":3,"file":"python-uv.js","sourceRoot":"","sources":["../../src/utils/python-uv.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"python-uv.js","sourceRoot":"","sources":["../../src/utils/python-uv.ts"],"names":[],"mappings":"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"}

package/dist/utils/react-dev.d.ts

@@ -0,0 +1,4 @@
+export declare const REACT_DEV_WATCH_DIRECTORIES: string[];
+export declare function buildReactDevWatchIgnoredSource(rootExpression: string): string;
+export declare function buildReactDevConfigSource(): string;
+//# sourceMappingURL=react-dev.d.ts.map

package/dist/utils/react-dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-dev.d.ts","sourceRoot":"","sources":["../../src/utils/react-dev.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,UAMvC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAkBlD"}

package/dist/utils/react-dev.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REACT_DEV_WATCH_DIRECTORIES = void 0;
+exports.buildReactDevWatchIgnoredSource = buildReactDevWatchIgnoredSource;
+exports.buildReactDevConfigSource = buildReactDevConfigSource;
+exports.REACT_DEV_WATCH_DIRECTORIES = [
+    "functions",
+    "bff",
+    ".uv",
+    ".swallowkit",
+    "shared/dist",
+];
+function buildReactDevWatchIgnoredSource(rootExpression) {
+    return `${JSON.stringify(exports.REACT_DEV_WATCH_DIRECTORIES)}.map(directory => \`\${${rootExpression}.replace(/\\\\/g, '/').replace(/\\/$/, '')}/\${directory}/**\`)`;
+}
+function buildReactDevConfigSource() {
+    return `import { defineConfig, loadConfigFromFile, mergeConfig } from 'vite';
+
+export default defineConfig(async env => {
+  const loaded = await loadConfigFromFile(env, undefined, process.cwd());
+  const config = loaded?.config ?? {};
+  if (config.server?.watch === null) return config;
+  return mergeConfig(config, {
+    plugins: [{
+      name: 'swallowkit-dev-watch-boundaries',
+      configResolved(resolved) {
+        resolved.configFileDependencies.push(...(loaded?.dependencies ?? []));
+      },
+    }],
+    server: { watch: { ignored: ${buildReactDevWatchIgnoredSource("process.cwd()")} } },
+  });
+});
+`;
+}
+//# sourceMappingURL=react-dev.js.map

package/dist/utils/react-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-dev.js","sourceRoot":"","sources":["../../src/utils/react-dev.ts"],"names":[],"mappings":";;;AAQA,0EAEC;AAED,8DAkBC;AA9BY,QAAA,2BAA2B,GAAG;IACzC,WAAW;IACX,KAAK;IACL,KAAK;IACL,aAAa;IACb,aAAa;CACd,CAAC;AAEF,SAAgB,+BAA+B,CAAC,cAAsB;IACpE,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,mCAA2B,CAAC,0BAA0B,cAAc,iEAAiE,CAAC;AACjK,CAAC;AAED,SAAgB,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;kCAayB,+BAA+B,CAAC,eAAe,CAAC;;;CAGjF,CAAC;AACF,CAAC"}

package/dist/utils/semver.d.ts

@@ -0,0 +1,14 @@
+export interface ParsedSemver {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: Array<string | number>;
+}
+export declare function parseSemver(value: string | null | undefined): ParsedSemver | null;
+export declare function isPrerelease(value: string): boolean;
+/**
+ * Compares versions by SemVer 2.0 precedence. Build metadata is ignored.
+ * Returns null when either value is not a valid version.
+ */
+export declare function compareSemver(left: string, right: string): number | null;
+//# sourceMappingURL=semver.d.ts.map

package/dist/utils/semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../../src/utils/semver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACpC;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAWjF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BxE"}

package/dist/utils/semver.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSemver = parseSemver;
+exports.isPrerelease = isPrerelease;
+exports.compareSemver = compareSemver;
+const SEMVER_PATTERN = /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+function parseSemver(value) {
+    const match = typeof value === "string" ? SEMVER_PATTERN.exec(value.trim()) : null;
+    if (!match)
+        return null;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease: match[4]
+            ? match[4].split(".").map((identifier) => (/^\d+$/.test(identifier) ? Number(identifier) : identifier))
+            : [],
+    };
+}
+function isPrerelease(value) {
+    return (parseSemver(value)?.prerelease.length ?? 0) > 0;
+}
+/**
+ * Compares versions by SemVer 2.0 precedence. Build metadata is ignored.
+ * Returns null when either value is not a valid version.
+ */
+function compareSemver(left, right) {
+    const a = parseSemver(left);
+    const b = parseSemver(right);
+    if (!a || !b)
+        return null;
+    for (const key of ["major", "minor", "patch"]) {
+        if (a[key] !== b[key])
+            return a[key] < b[key] ? -1 : 1;
+    }
+    if (a.prerelease.length === 0 || b.prerelease.length === 0) {
+        if (a.prerelease.length === b.prerelease.length)
+            return 0;
+        return a.prerelease.length === 0 ? 1 : -1;
+    }
+    const length = Math.max(a.prerelease.length, b.prerelease.length);
+    for (let index = 0; index < length; index++) {
+        const leftId = a.prerelease[index];
+        const rightId = b.prerelease[index];
+        if (leftId === undefined)
+            return -1;
+        if (rightId === undefined)
+            return 1;
+        if (leftId === rightId)
+            continue;
+        if (typeof leftId === "number" && typeof rightId === "number")
+            return leftId < rightId ? -1 : 1;
+        if (typeof leftId === "number")
+            return -1;
+        if (typeof rightId === "number")
+            return 1;
+        return leftId < rightId ? -1 : 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=semver.js.map

package/dist/utils/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../src/utils/semver.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swallowkit",
-  "version": "2.0.0-alpha.2",
+  "version": "2.0.0-alpha.4",
   "description": "Type-safe schema-driven development toolkit for Next.js and React applications on Azure",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/__tests__/__snapshots__/boundaries.test.ts.snap

@@ -0,0 +1,154 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`inspect boundaries convention rules matches the csharp backend 1`] = `
+[
+  {
+    "description": "SwallowKit metadata (manifest, artifact ledger, plan state). Managed by tooling only.",
+    "editPolicy": "never-hand-edit",
+    "pattern": ".swallowkit/",
+    "zone": "deterministic",
+  },
+  {
+    "description": "Zod model schemas — the single source of truth. AI/developers author these freely; deterministic generation derives everything else from them.",
+    "editPolicy": "free-edit",
+    "pattern": "shared/models/",
+    "zone": "ai-authored",
+  },
+  {
+    "description": "Infrastructure migration ledger with baseline checksums. Updated by scaffold, \`swallowkit migrations add-model\`, and \`swallowkit create-migration\`.",
+    "editPolicy": "never-hand-edit",
+    "pattern": "infra/migrations/manifest.json",
+    "zone": "deterministic",
+  },
+  {
+    "description": "Versioned Bicep migrations. Edit a migration only before it is provisioned; never change an applied migration — add a new one with \`swallowkit create-migration <slug>\`.",
+    "editPolicy": "free-edit",
+    "pattern": "infra/migrations/",
+    "zone": "ai-authored",
+  },
+  {
+    "description": "Baseline infrastructure (main.bicep and modules) whose checksums are recorded in infra/migrations/manifest.json. Hand edits block scaffold with baseline-drift; add resources through a new migration instead.",
+    "editPolicy": "never-hand-edit",
+    "pattern": "infra/",
+    "zone": "deterministic",
+  },
+  {
+    "description": "SwallowKit appends model exports; other exports may be added freely.",
+    "editPolicy": "edit-outside-markers",
+    "pattern": "shared/index.ts",
+    "zone": "shared",
+  },
+  {
+    "description": "Any path not recorded in the artifact ledger is AI/developer-authored. Business logic, custom pages, custom Functions, and tests belong here.",
+    "editPolicy": "free-edit",
+    "pattern": "*",
+    "zone": "ai-authored",
+  },
+]
+`;
+
+exports[`inspect boundaries convention rules matches the python backend 1`] = `
+[
+  {
+    "description": "SwallowKit metadata (manifest, artifact ledger, plan state). Managed by tooling only.",
+    "editPolicy": "never-hand-edit",
+    "pattern": ".swallowkit/",
+    "zone": "deterministic",
+  },
+  {
+    "description": "Zod model schemas — the single source of truth. AI/developers author these freely; deterministic generation derives everything else from them.",
+    "editPolicy": "free-edit",
+    "pattern": "shared/models/",
+    "zone": "ai-authored",
+  },
+  {
+    "description": "Infrastructure migration ledger with baseline checksums. Updated by scaffold, \`swallowkit migrations add-model\`, and \`swallowkit create-migration\`.",
+    "editPolicy": "never-hand-edit",
+    "pattern": "infra/migrations/manifest.json",
+    "zone": "deterministic",
+  },
+  {
+    "description": "Versioned Bicep migrations. Edit a migration only before it is provisioned; never change an applied migration — add a new one with \`swallowkit create-migration <slug>\`.",
+    "editPolicy": "free-edit",
+    "pattern": "infra/migrations/",
+    "zone": "ai-authored",
+  },
+  {
+    "description": "Baseline infrastructure (main.bicep and modules) whose checksums are recorded in infra/migrations/manifest.json. Hand edits block scaffold with baseline-drift; add resources through a new migration instead.",
+    "editPolicy": "never-hand-edit",
+    "pattern": "infra/",
+    "zone": "deterministic",
+  },
+  {
+    "description": "SwallowKit appends model exports; other exports may be added freely.",
+    "editPolicy": "edit-outside-markers",
+    "pattern": "shared/index.ts",
+    "zone": "shared",
+  },
+  {
+    "description": "SwallowKit appends blueprint registrations under its marker; other edits are free.",
+    "editPolicy": "edit-outside-markers",
+    "pattern": "functions/function_app.py",
+    "zone": "shared",
+  },
+  {
+    "description": "SwallowKit appends connector driver requirements when connector models are scaffolded; keep those lines and edit other requirements freely.",
+    "editPolicy": "free-edit",
+    "pattern": "functions/requirements.txt",
+    "zone": "shared",
+  },
+  {
+    "description": "Any path not recorded in the artifact ledger is AI/developer-authored. Business logic, custom pages, custom Functions, and tests belong here.",
+    "editPolicy": "free-edit",
+    "pattern": "*",
+    "zone": "ai-authored",
+  },
+]
+`;
+
+exports[`inspect boundaries convention rules matches the typescript backend 1`] = `
+[
+  {
+    "description": "SwallowKit metadata (manifest, artifact ledger, plan state). Managed by tooling only.",
+    "editPolicy": "never-hand-edit",
+    "pattern": ".swallowkit/",
+    "zone": "deterministic",
+  },
+  {
+    "description": "Zod model schemas — the single source of truth. AI/developers author these freely; deterministic generation derives everything else from them.",
+    "editPolicy": "free-edit",
+    "pattern": "shared/models/",
+    "zone": "ai-authored",
+  },
+  {
+    "description": "Infrastructure migration ledger with baseline checksums. Updated by scaffold, \`swallowkit migrations add-model\`, and \`swallowkit create-migration\`.",
+    "editPolicy": "never-hand-edit",
+    "pattern": "infra/migrations/manifest.json",
+    "zone": "deterministic",
+  },
+  {
+    "description": "Versioned Bicep migrations. Edit a migration only before it is provisioned; never change an applied migration — add a new one with \`swallowkit create-migration <slug>\`.",
+    "editPolicy": "free-edit",
+    "pattern": "infra/migrations/",
+    "zone": "ai-authored",
+  },
+  {
+    "description": "Baseline infrastructure (main.bicep and modules) whose checksums are recorded in infra/migrations/manifest.json. Hand edits block scaffold with baseline-drift; add resources through a new migration instead.",
+    "editPolicy": "never-hand-edit",
+    "pattern": "infra/",
+    "zone": "deterministic",
+  },
+  {
+    "description": "SwallowKit appends model exports; other exports may be added freely.",
+    "editPolicy": "edit-outside-markers",
+    "pattern": "shared/index.ts",
+    "zone": "shared",
+  },
+  {
+    "description": "Any path not recorded in the artifact ledger is AI/developer-authored. Business logic, custom pages, custom Functions, and tests belong here.",
+    "editPolicy": "free-edit",
+    "pattern": "*",
+    "zone": "ai-authored",
+  },
+]
+`;

package/src/__tests__/agent-loop-phase34.test.ts

@@ -17,6 +17,7 @@ import { inspectInfra } from "../core/project/infra";
 import { loadCustomVerifyChecks, compactVerifyResult, runVerify, VerifyResult } from "../core/verify";
 import { buildAgentSkills, buildWorkflowDocs, writeAgentSkills, writeWorkflowDocs } from "../core/project/workflows";
 import { applyProvisionOperation, planProvisionOperation } from "../core/operations/provision-operations";
+import { resetAzCliInvocationCache, setAzCliInvocationForTesting } from "../utils/azure-cli";
 import { createCustomMigration, initializeLegacyMigrations } from "../core/operations/migration-generator";
 import { createMigrationManifest, encodeMigrationState, getMigrationTagKey, saveMigrationManifest } from "../core/project/migrations";
 
@@ -126,9 +127,12 @@ describe("agent loop phase 3/4", () => {
     tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "swallowkit-p34-"));
     process.chdir(tempDir);
     (childProcess.spawnSync as unknown as any).mockReturnValue({ status: 1, stdout: "", stderr: "" });
+    // Platform-independent az invocation; the Windows wrapper resolution is covered in azure-cli.test.ts.
+    setAzCliInvocationForTesting({ command: "az", prefixArgs: [], source: "az" });
   });
 
   afterEach(() => {
+    resetAzCliInvocationCache();
     process.chdir(originalCwd);
     fs.rmSync(tempDir, { recursive: true, force: true });
     jest.clearAllMocks();
@@ -269,6 +273,7 @@ describe("agent loop phase 3/4", () => {
     createProjectFixture(tempDir);
     writeFile(path.join(tempDir, "infra", "main.bicep"), SAMPLE_MAIN_BICEP);
     writeFile(path.join(tempDir, "infra", "main.parameters.json"), "{}\n");
+    setAzCliInvocationForTesting(null);
 
     const plan = await runMachine([
       "node", "swallowkit", "machine", "plan", "provision",
@@ -508,6 +513,30 @@ describe("agent loop phase 3/4", () => {
     );
   });
 
+  it.each<[string, string[]]>([
+    ["pnpm", ["exec", "next", "typegen"]],
+    ["npm", ["exec", "--", "next", "typegen"]],
+  ])("generates Next.js route types with %s before typechecking", async (packageManager, typegenArgs) => {
+    writeFile(
+      path.join(tempDir, "package.json"),
+      JSON.stringify({ name: "sample-app", devEngines: { packageManager: { name: packageManager, version: ">=10", onFail: "error" } } })
+    );
+    writeFile(path.join(tempDir, "tsconfig.json"), JSON.stringify({ compilerOptions: { noEmit: true } }));
+    writeFile(path.join(tempDir, "next.config.ts"), "export default {};\n");
+    writeFile(path.join(tempDir, "node_modules", "next", "package.json"), JSON.stringify({ name: "next", version: "16.0.0" }));
+    const spawnSyncMock = childProcess.spawnSync as unknown as ReturnType<typeof jest.fn>;
+    spawnSyncMock.mockReset();
+    spawnSyncMock
+      .mockReturnValueOnce({ status: 1, stdout: "", stderr: "typegen failed" })
+      .mockReturnValueOnce({ status: 2, stdout: "app/layout.tsx: Cannot find name 'LayoutProps'.", stderr: "" });
+
+    const result = await runVerify(["typecheck"], tempDir);
+
+    expect(spawnSyncMock.mock.calls[0].slice(0, 2)).toEqual([packageManager, typegenArgs]);
+    expect(result.checks[0].status).toBe("fail");
+    expect(result.checks[0].evidence.logTail?.[0]).toMatch(/^next typegen did not complete \(exit 1\)/);
+  });
+
   it("uses the existing typecheck script when present", async () => {
     writeFile(
       path.join(tempDir, "package.json"),

package/src/__tests__/auth.test.ts

@@ -300,6 +300,15 @@ describe("generateLoginPage", () => {
     expect(code).toContain("handleSubmit");
     expect(code).toContain("/api/auth/login");
   });
+
+  it("keeps the shared form legible with either global color scheme", () => {
+    const code = generateLoginPage();
+    expect(code).toContain("bg-gray-50 dark:bg-gray-900");
+    expect(code).toContain("bg-white dark:bg-gray-800");
+    expect(code).toContain("text-gray-900 dark:text-gray-100");
+    expect(code).toContain("dark:border-gray-600");
+    expect(code).toContain("dark:text-red-300");
+  });
 });
 
 describe("generateAuthContext", () => {