@sleepy-hollow/framework 0.3.2 → 0.3.4

package/dist/cli.js

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
 import {
   resolveConfiguration
-} from "./chunk-BJONRVDG.js";
+} from "./chunk-2GNHTFCZ.js";
 import {
   createTraceabilityReport,
   selectAffectedTests
-} from "./chunk-D4U3ZY4O.js";
+} from "./chunk-RYKRRAPD.js";
 import "./chunk-BAKXP7IR.js";
 import {
   composeProjectSecurity
-} from "./chunk-DGTHFZPZ.js";
+} from "./chunk-AADQFGT4.js";
 import {
   normalizeRoutes
-} from "./chunk-CAPFDC25.js";
+} from "./chunk-QY3TSXM6.js";
 import {
   discoverRoutes,
   platform
-} from "./chunk-53TZY5YP.js";
-import "./chunk-LNJDFJGT.js";
+} from "./chunk-LPPASMRR.js";
+import "./chunk-EHBEUJIZ.js";
 import "./chunk-5WRI5ZAA.js";
 
 // cli/main.ts
@@ -1006,7 +1006,7 @@ var CreationError = class extends Error {
 };
 
 // cli/create/create.ts
-var VERSION = "0.3.2";
+var VERSION = "0.3.4";
 var NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
 function files(name) {
   return {
@@ -1090,7 +1090,33 @@ test("capture artifact is persisted", async () => { await persist(); });
         engines: { node: ">=24" },
         scripts: { check: "tsc --noEmit", test: "vitest run", verify: "npm run check && npm run test && node .sleepyhollow/verify.ts" },
         dependencies: { "@sleepy-hollow/framework": `^${FRAMEWORK_VERSION}` },
-        devDependencies: { typescript: "5.9.3", vitest: "4.1.11" }
+        devDependencies: { "@types/node": "26.2.0", typescript: "5.9.3", vitest: "4.1.11" }
+      },
+      null,
+      2
+    ) + "\n",
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2024",
+          module: "NodeNext",
+          moduleResolution: "NodeNext",
+          strict: true,
+          noEmit: true,
+          allowImportingTsExtensions: true,
+          verbatimModuleSyntax: true,
+          skipLibCheck: true,
+          types: ["node", "vitest/globals"]
+        },
+        include: [
+          ".sleepyhollow/**/*.ts",
+          "api/**/*.ts",
+          "models/**/*.ts",
+          "tests/**/*.ts",
+          "sleepyhollow.config.ts",
+          "vitest.config.ts"
+        ],
+        exclude: ["generated", "node_modules"]
       },
       null,
       2
@@ -1102,15 +1128,20 @@ export default defineConfig({ test: { globals: true, include: ["**/*_test.ts", "
     "generated/.gitkeep": "",
     "models/.gitkeep": "",
     "requirements/application.req.md": `---
-schema: sleepy-hollow-application/v0.1
+schema: sgad-application/v0.2
+id: ${name}-application
 title: ${name}
 status: draft
+risk: standard
+depends_on: []
+owners:
+  - application owner
 ---
 
 # Application requirements
 
-Use the official Sleepy Hollow skill to plan actors, behavior, data, security,
-operations, and acceptance criteria before generating endpoints.
+Use the official Sleepy Hollow skill to replace this planning placeholder with
+the complete application requirements before generating endpoints.
 `,
     "sleepyhollow.config.ts": `import { defineProject } from "./.sleepyhollow/project.ts";
 
@@ -1142,7 +1173,7 @@ async function pathExists(path) {
     throw error;
   }
 }
-var FRAMEWORK_VERSION = "0.3.2";
+var FRAMEWORK_VERSION = "0.3.4";
 async function createProject(options) {
   if (!NAME.test(options.name) || options.name.length > 64) {
     throw creationError(
@@ -1328,6 +1359,7 @@ async function startWorker(options, expectedRoutes) {
   const child = workerCommand(options, "serve").spawn();
   const stdout = readFirstLine(child.stdout);
   const stderr = readBounded(child.stderr);
+  const status = child.status;
   let timeout;
   const timer = new Promise((_, reject) => {
     timeout = setTimeout(
@@ -1356,9 +1388,34 @@ async function startWorker(options, expectedRoutes) {
     );
   }
   let stopped = false;
+  const failure3 = new Promise((_, reject) => {
+    void status.then(async (result) => {
+      if (stopped) return;
+      if (result.success) {
+        reject(new DevCommandError([{
+          code: "SH_DEV_WORKER_EXITED",
+          severity: "error",
+          summary: "The development worker exited after becoming active",
+          correction: "Inspect the worker diagnostics and retry."
+        }]));
+        return;
+      }
+      reject(await workerFailure(
+        await stderr,
+        "The development worker failed after becoming active"
+      ));
+    }, async () => {
+      if (stopped) return;
+      reject(await workerFailure(
+        await stderr,
+        "The development worker failed after becoming active"
+      ));
+    });
+  });
   return {
     url: `http://${options.hostname}:${options.port}/`,
     routeCount: expectedRoutes,
+    failure: failure3,
     async stop() {
       if (stopped) return;
       stopped = true;
@@ -1589,6 +1646,7 @@ function failure2(error, fallback) {
 }
 function changedPaths(projectRoot, paths) {
   const normalized = [];
+  const runtimeDatabaseArtifact = /^\.sleepyhollow\/[^/]+\.(?:sqlite|db)(?:-(?:wal|shm))?$/;
   for (const path of paths) {
     const absolute = isAbsolute(path) ? resolve2(path) : resolve2(projectRoot, path);
     const local = relative(projectRoot, absolute).split(sep).join("/");
@@ -1599,7 +1657,7 @@ function changedPaths(projectRoot, paths) {
         "Watch only project-contained application inputs."
       );
     }
-    if (local === ".git" || local.startsWith(".git/") || local === "generated" || local.startsWith("generated/") || local.includes("/node_modules/") || /(?:^|\/)(?:\.DS_Store|.*(?:\.swp|~))$/.test(local)) continue;
+    if (local === ".git" || local.startsWith(".git/") || local === "generated" || local.startsWith("generated/") || local.includes("/node_modules/") || runtimeDatabaseArtifact.test(local) || /(?:^|\/)(?:\.DS_Store|.*(?:\.swp|~))$/.test(local)) continue;
     normalized.push(local);
   }
   return Object.freeze([...new Set(normalized)].sort());
@@ -1614,6 +1672,21 @@ function abortReason(signal) {
   }
   return "cancelled";
 }
+async function nextChange(iterator, active) {
+  const change = iterator.next();
+  if (!active?.failure) return change;
+  return Promise.race([
+    change,
+    active.failure.then(() => {
+      throw new DevCommandError([{
+        code: "SH_DEV_WORKER_EXITED",
+        severity: "error",
+        summary: "The active development worker exited unexpectedly",
+        correction: "Inspect the worker diagnostics and retry."
+      }]);
+    })
+  ]);
+}
 async function runDevCommand(args, io, suppliedDependencies) {
   const parsed = parse2(args);
   if ("code" in parsed) {
@@ -1735,7 +1808,11 @@ ${parsed.correction}`
       return 1;
     }
     if (signal.aborted) await closeWatcher();
-    for await (const paths of watcher) {
+    const iterator = watcher[Symbol.asyncIterator]();
+    while (true) {
+      const next = await nextChange(iterator, active);
+      if (next.done) break;
+      const paths = next.value;
       if (signal.aborted) break;
       const changes = changedPaths(projectRoot, paths);
       if (!Array.isArray(changes)) {
@@ -1888,14 +1965,26 @@ function safeDiagnostic(error, intent) {
       ...typeof item.key === "string" ? { configuration: [item.key] } : {}
     }));
   }
-  if (intent === "serve" && (error instanceof platform.errors.AddrInUse || error instanceof platform.errors.PermissionDenied)) {
+  const nodeError = error;
+  const nodeCode = typeof nodeError?.code === "string" ? nodeError.code : void 0;
+  const isListenFailure = error instanceof platform.errors.AddrInUse || error instanceof platform.errors.PermissionDenied || nodeError?.syscall === "listen" || nodeCode === "EADDRINUSE" || nodeCode === "EACCES" || nodeCode === "EPERM";
+  if (intent === "serve" && isListenFailure) {
     return [{
       code: "SH_DEV_BIND_FAILED",
       severity: "error",
-      summary: "The loopback listener could not bind",
+      summary: nodeCode ? `The loopback listener failed with ${nodeCode}` : "The loopback listener could not bind",
       correction: "Choose an available port and confirm local network access."
     }];
   }
+  if (intent === "serve") {
+    const cause = error instanceof Error ? `${error.name}: ${error.message}`.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "").replace(/(?:Bearer|token|password|secret|authorization)[=: ]+\S+/gi, "$1=[redacted]").replace(/(?:[A-Za-z]:)?\/[^\s]+/g, "[path]").slice(0, 180) : void 0;
+    return [{
+      code: "SH_DEV_SERVE_FAILED",
+      severity: "error",
+      summary: cause ? `The development server failed: ${cause}` : "The development server failed",
+      correction: "Inspect the bounded server diagnostic and retry after repairing the host boundary."
+    }];
+  }
   return [{
     code: "SH_DEV_PROJECT_INVALID",
     severity: "error",
@@ -1967,20 +2056,20 @@ async function runDevWorker(args) {
   const [intent, projectRoot, hostname, rawPort] = args;
   const port = Number(rawPort);
   if (hostname !== "127.0.0.1" || !Number.isInteger(port) || port < 1 || port > 65535) return 2;
+  let server;
   try {
     const { runtime: runtime2, routeCount } = await loadRuntime(projectRoot);
     if (intent === "validate") {
       console.log(JSON.stringify({ ready: true, routeCount }));
       return 0;
     }
-    const server = platform.serve({ hostname, port }, (request) => runtime2.fetch(request));
+    server = platform.serve({ hostname, port }, (request) => runtime2.fetch(request));
+    await server.ready;
     console.log(JSON.stringify({ ready: true, routeCount }));
-    await new Promise((resolve5, reject) => {
-      server.once("close", resolve5);
-      server.once("error", reject);
-    });
+    await server.finished;
     return 0;
   } catch (error) {
+    await server?.shutdown().catch(() => void 0);
     console.error(
       JSON.stringify({
         ready: false,
@@ -2880,7 +2969,7 @@ function renderArtifacts(inventory2) {
   ];
   const manifestContent = canonicalJson({
     schema: "sleepy-hollow-generated-manifest/v1",
-    generatorVersion: "0.3.2",
+    generatorVersion: "0.3.4",
     serviceId: normalized.serviceId,
     inputDigest: digest2(input),
     artifacts: Object.fromEntries(
@@ -3154,7 +3243,7 @@ function inventoryFromRoutes(routes2, options) {
   return {
     serviceId: options.serviceId,
     title: options.title ?? options.serviceId,
-    version: options.version ?? "0.3.2",
+    version: options.version ?? "0.3.4",
     ...options.description ? { description: options.description } : {},
     operations,
     securitySchemes: options.securitySchemes ?? {}
@@ -4008,7 +4097,7 @@ var CLI_COMMANDS = [
   "generate",
   "deploy"
 ];
-var CLI_VERSION = "0.3.2";
+var CLI_VERSION = "0.3.4";
 var commandMetadata = {
   create: {
     description: "Create one deterministic Sleepy Hollow project.",
@@ -5578,7 +5667,8 @@ function declaredStatuses(schemas) {
 function authenticationOf(security2) {
   if (typeof security2 !== "object" || security2 === null) return "none";
   const declared = security2.authentication;
-  return declared === "required" ? "required" : "none";
+  if (typeof declared !== "object" || declared === null) return "none";
+  return declared.mode === "required" ? "required" : "none";
 }
 async function routes(project, artifact2) {
   const roots = project.services.length > 0 ? project.services.map((service) => ({