@decohere/scaffold 0.0.1-dev.18 → 0.0.1-dev.80

package/es6/src/webapi/workspace-readme.js

@@ -0,0 +1,89 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { WELL_KNOWN_FILES } from "../models/const.js";
+import { apiNameFromProjectDir, listExistingApiNames } from "./api-name.js";
+/** Pure renderer — keep feature sections short and copy-paste ready. */ export function renderWorkspaceReadme(input) {
+    const { projectName, apiNames, hasPostgres, hasAuth0, hasPostman } = input;
+    const apis = apiNames.length > 0 ? apiNames : [
+        "api"
+    ];
+    const lines = [
+        `# ${projectName}`,
+        "",
+        "Decohere web API workspace. Scaffolded with [`@decohere/create`](https://www.npmjs.com/package/@decohere/create).",
+        "",
+        "## Get started",
+        "",
+        "1. Open this folder in VS Code / Cursor.",
+        "2. **Reopen in Container** (or rebuild the Dev Container).",
+        "   Host `initialize.sh` and container `post-start.sh` ask y/N (TTY only) before npm auth or codebase RAG MCP.",
+        "   Skip or decline; missing TTY skips. RAG credentials land in `.cursor/` (gitignored).",
+        "3. Install dependencies if needed:",
+        "",
+        "```bash",
+        "pnpm install",
+        "```",
+        "",
+        "## Develop",
+        "",
+        "```bash",
+        "pnpm dev              # Flux HMR (first API)",
+        "pnpm start            # run the compiled first API",
+        "pnpm run build        # forge release build"
+    ];
+    for (const name of apis){
+        lines.push(`pnpm run dev:${name}     # HMR for ${name}`);
+        lines.push(`pnpm run start:${name}   # production entry for ${name}`);
+    }
+    lines.push("```", "");
+    lines.push("## Logging", "", "In development, Scribe uses pino-pretty and rolling files under `logs/` (gitignored).", "When `NODE_ENV=production`, the process writes structured JSON to stdout and does not rotate files.", "Ship and retain those streams outside the app (platform logs, a sidecar, or a log agent) so shipping can change without rebuilding.", "", "Override roll path and rotation without changing app code:", "`SCRIBE_LOG_FILE`, `SCRIBE_LOG_SIZE`, `SCRIBE_LOG_FREQUENCY`, `SCRIBE_LOG_KEEP`.", "", 'Opt into in-process pretty or roll in production only with `{ when: "always" }` on `scribe.withPinoPretty` / `scribe.withPinoRoll`.', "");
+    if (hasPostgres) {
+        lines.push("## Database", "", "Postgres runs via Dev Container Compose:", "", "```bash", "pnpm db:up", "pnpm db:down", "pnpm db:reset", "```", "");
+    }
+    lines.push("## Deploy", "", "PaaS hosts (`docker build` from the repo root) use the scaffolded `Dockerfile`.", "The runtime image installs production dependencies only (`pnpm install --prod`);", "Forge, TypeScript, Biome, and Vitest stay in the build stage.", "", "```bash", `docker build -t ${projectName} .`, "```", "", "Extra APIs: `docker build -f Dockerfile.<name> .`", "");
+    lines.push("## Add another API", "", "```bash", "decohere add api <name>", "```", "", "Example: `decohere add api billing`", "");
+    if (hasAuth0) {
+        lines.push("## Auth0", "", "JWT auth is wired from `.env` (`AUTH0_ISSUER_BASE_URL`, `AUTH0_AUDIENCE`).", "Set those values (or re-run scaffold with `--auth auth0`) before calling protected routes.", "");
+    }
+    if (hasPostman) {
+        lines.push("## Postman", "", "Open this **project root** in Postman Local View (Files → Open folder), not the `postman/` subfolder.", "Select the Local environment, then Authorization → Get New Access Token when Auth0 is enabled.", "");
+    }
+    lines.push("## More", "", "- Package docs: https://www.npmjs.com/package/@decohere/create", "- After `decohere add api`, this README is refreshed so scripts and APIs stay accurate.", "");
+    return `${lines.join("\n")}`;
+}
+export function resolveWorkspaceReadmeInput(workspace, options) {
+    const newNames = workspace.getProjects().map((project)=>apiNameFromProjectDir(project.dir));
+    const apiNames = options.add ? mergeApiNames(listExistingApiNames(workspace.targetDir), newNames) : newNames;
+    const pkg = workspace.getModel(WELL_KNOWN_FILES.PACKAGE_JSON);
+    const env = workspace.getModel(WELL_KNOWN_FILES.ENV_FILE);
+    const hasPostgres = options.databaseProvider === "postgres/typeorm" || Boolean(pkg?.hasScript("db:up"));
+    const hasAuth0 = options.authProvider === "auth0" || Boolean(env?.hasEntry("AUTH0_ISSUER_BASE_URL"));
+    const hasPostman = options.postmanProvider === "local" || options.postmanProvider === "api" || existsSync(join(workspace.targetDir, "postman")) || existsSync(join(workspace.targetDir, ".postman"));
+    return {
+        projectName: workspace.name,
+        apiNames,
+        hasPostgres,
+        hasAuth0,
+        hasPostman
+    };
+}
+export function writeWorkspaceReadme(workspace, options) {
+    const content = renderWorkspaceReadme(resolveWorkspaceReadmeInput(workspace, options));
+    workspace.addFile({
+        files: ()=>[
+                {
+                    filePath: "README.md",
+                    content
+                }
+            ]
+    });
+}
+function mergeApiNames(existing, added) {
+    const seen = new Set(existing);
+    return [
+        ...existing,
+        ...added.filter((name)=>!seen.has(name))
+    ];
+}
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL3NjYWZmb2xkL3NyYy93ZWJhcGkvd29ya3NwYWNlLXJlYWRtZS50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBleGlzdHNTeW5jIH0gZnJvbSBcIm5vZGU6ZnNcIjtcbmltcG9ydCB7IGpvaW4gfSBmcm9tIFwibm9kZTpwYXRoXCI7XG5pbXBvcnQgeyBXRUxMX0tOT1dOX0ZJTEVTIH0gZnJvbSBcIi4uL21vZGVscy9jb25zdC5qc1wiO1xuaW1wb3J0IHR5cGUgeyBFbnZGaWxlIH0gZnJvbSBcIi4uL21vZGVscy9lbnYtZmlsZS5tb2RlbC5qc1wiO1xuaW1wb3J0IHR5cGUgeyBQYWNrYWdlSnNvbiB9IGZyb20gXCIuLi9tb2RlbHMvcGFja2FnZS1qc29uLm1vZGVsLmpzXCI7XG5pbXBvcnQgdHlwZSB7IFdvcmtzcGFjZVNjYWZmb2xkIH0gZnJvbSBcIi4uL21vZGVscy9wcm9qZWN0Lm1vZGVsLmpzXCI7XG5pbXBvcnQgeyBhcGlOYW1lRnJvbVByb2plY3REaXIsIGxpc3RFeGlzdGluZ0FwaU5hbWVzIH0gZnJvbSBcIi4vYXBpLW5hbWUuanNcIjtcblxuZXhwb3J0IHR5cGUgV29ya3NwYWNlUmVhZG1lT3B0aW9ucyA9IHtcblx0YWRkPzogYm9vbGVhbjtcblx0ZGF0YWJhc2VQcm92aWRlcj86IFwibm9uZVwiIHwgXCJwb3N0Z3Jlcy90eXBlb3JtXCI7XG5cdGF1dGhQcm92aWRlcj86IFwiYXV0aDBcIiB8IFwibm9uZVwiO1xuXHRwb3N0bWFuUHJvdmlkZXI/OiBcImFwaVwiIHwgXCJsb2NhbFwiIHwgXCJub25lXCI7XG59O1xuXG5leHBvcnQgdHlwZSBXb3Jrc3BhY2VSZWFkbWVJbnB1dCA9IHtcblx0cHJvamVjdE5hbWU6IHN0cmluZztcblx0YXBpTmFtZXM6IHJlYWRvbmx5IHN0cmluZ1tdO1xuXHRoYXNQb3N0Z3JlczogYm9vbGVhbjtcblx0aGFzQXV0aDA6IGJvb2xlYW47XG5cdGhhc1Bvc3RtYW46IGJvb2xlYW47XG59O1xuXG4vKiogUHVyZSByZW5kZXJlciDigJQga2VlcCBmZWF0dXJlIHNlY3Rpb25zIHNob3J0IGFuZCBjb3B5LXBhc3RlIHJlYWR5LiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlbmRlcldvcmtzcGFjZVJlYWRtZShpbnB1dDogV29ya3NwYWNlUmVhZG1lSW5wdXQpOiBzdHJpbmcge1xuXHRjb25zdCB7IHByb2plY3ROYW1lLCBhcGlOYW1lcywgaGFzUG9zdGdyZXMsIGhhc0F1dGgwLCBoYXNQb3N0bWFuIH0gPSBpbnB1dDtcblx0Y29uc3QgYXBpcyA9IGFwaU5hbWVzLmxlbmd0aCA+IDAgPyBhcGlOYW1lcyA6IFtcImFwaVwiXTtcblx0Y29uc3QgbGluZXM6IHN0cmluZ1tdID0gW1xuXHRcdGAjICR7cHJvamVjdE5hbWV9YCxcblx0XHRcIlwiLFxuXHRcdFwiRGVjb2hlcmUgd2ViIEFQSSB3b3Jrc3BhY2UuIFNjYWZmb2xkZWQgd2l0aCBbYEBkZWNvaGVyZS9jcmVhdGVgXShodHRwczovL3d3dy5ucG1qcy5jb20vcGFja2FnZS9AZGVjb2hlcmUvY3JlYXRlKS5cIixcblx0XHRcIlwiLFxuXHRcdFwiIyMgR2V0IHN0YXJ0ZWRcIixcblx0XHRcIlwiLFxuXHRcdFwiMS4gT3BlbiB0aGlzIGZvbGRlciBpbiBWUyBDb2RlIC8gQ3Vyc29yLlwiLFxuXHRcdFwiMi4gKipSZW9wZW4gaW4gQ29udGFpbmVyKiogKG9yIHJlYnVpbGQgdGhlIERldiBDb250YWluZXIpLlwiLFxuXHRcdFwiICAgSG9zdCBgaW5pdGlhbGl6ZS5zaGAgYW5kIGNvbnRhaW5lciBgcG9zdC1zdGFydC5zaGAgYXNrIHkvTiAoVFRZIG9ubHkpIGJlZm9yZSBucG0gYXV0aCBvciBjb2RlYmFzZSBSQUcgTUNQLlwiLFxuXHRcdFwiICAgU2tpcCBvciBkZWNsaW5lOyBtaXNzaW5nIFRUWSBza2lwcy4gUkFHIGNyZWRlbnRpYWxzIGxhbmQgaW4gYC5jdXJzb3IvYCAoZ2l0aWdub3JlZCkuXCIsXG5cdFx0XCIzLiBJbnN0YWxsIGRlcGVuZGVuY2llcyBpZiBuZWVkZWQ6XCIsXG5cdFx0XCJcIixcblx0XHRcImBgYGJhc2hcIixcblx0XHRcInBucG0gaW5zdGFsbFwiLFxuXHRcdFwiYGBgXCIsXG5cdFx0XCJcIixcblx0XHRcIiMjIERldmVsb3BcIixcblx0XHRcIlwiLFxuXHRcdFwiYGBgYmFzaFwiLFxuXHRcdFwicG5wbSBkZXYgICAgICAgICAgICAgICMgRmx1eCBITVIgKGZpcnN0IEFQSSlcIixcblx0XHRcInBucG0gc3RhcnQgICAgICAgICAgICAjIHJ1biB0aGUgY29tcGlsZWQgZmlyc3QgQVBJXCIsXG5cdFx0XCJwbnBtIHJ1biBidWlsZCAgICAgICAgIyBmb3JnZSByZWxlYXNlIGJ1aWxkXCIsXG5cdF07XG5cblx0Zm9yIChjb25zdCBuYW1lIG9mIGFwaXMpIHtcblx0XHRsaW5lcy5wdXNoKGBwbnBtIHJ1biBkZXY6JHtuYW1lfSAgICAgIyBITVIgZm9yICR7bmFtZX1gKTtcblx0XHRsaW5lcy5wdXNoKGBwbnBtIHJ1biBzdGFydDoke25hbWV9ICAgIyBwcm9kdWN0aW9uIGVudHJ5IGZvciAke25hbWV9YCk7XG5cdH1cblxuXHRsaW5lcy5wdXNoKFwiYGBgXCIsIFwiXCIpO1xuXG5cdGxpbmVzLnB1c2goXG5cdFx0XCIjIyBMb2dnaW5nXCIsXG5cdFx0XCJcIixcblx0XHRcIkluIGRldmVsb3BtZW50LCBTY3JpYmUgdXNlcyBwaW5vLXByZXR0eSBhbmQgcm9sbGluZyBmaWxlcyB1bmRlciBgbG9ncy9gIChnaXRpZ25vcmVkKS5cIixcblx0XHRcIldoZW4gYE5PREVfRU5WPXByb2R1Y3Rpb25gLCB0aGUgcHJvY2VzcyB3cml0ZXMgc3RydWN0dXJlZCBKU09OIHRvIHN0ZG91dCBhbmQgZG9lcyBub3Qgcm90YXRlIGZpbGVzLlwiLFxuXHRcdFwiU2hpcCBhbmQgcmV0YWluIHRob3NlIHN0cmVhbXMgb3V0c2lkZSB0aGUgYXBwIChwbGF0Zm9ybSBsb2dzLCBhIHNpZGVjYXIsIG9yIGEgbG9nIGFnZW50KSBzbyBzaGlwcGluZyBjYW4gY2hhbmdlIHdpdGhvdXQgcmVidWlsZGluZy5cIixcblx0XHRcIlwiLFxuXHRcdFwiT3ZlcnJpZGUgcm9sbCBwYXRoIGFuZCByb3RhdGlvbiB3aXRob3V0IGNoYW5naW5nIGFwcCBjb2RlOlwiLFxuXHRcdFwiYFNDUklCRV9MT0dfRklMRWAsIGBTQ1JJQkVfTE9HX1NJWkVgLCBgU0NSSUJFX0xPR19GUkVRVUVOQ1lgLCBgU0NSSUJFX0xPR19LRUVQYC5cIixcblx0XHRcIlwiLFxuXHRcdCdPcHQgaW50byBpbi1wcm9jZXNzIHByZXR0eSBvciByb2xsIGluIHByb2R1Y3Rpb24gb25seSB3aXRoIGB7IHdoZW46IFwiYWx3YXlzXCIgfWAgb24gYHNjcmliZS53aXRoUGlub1ByZXR0eWAgLyBgc2NyaWJlLndpdGhQaW5vUm9sbGAuJyxcblx0XHRcIlwiLFxuXHQpO1xuXG5cdGlmIChoYXNQb3N0Z3Jlcykge1xuXHRcdGxpbmVzLnB1c2goXG5cdFx0XHRcIiMjIERhdGFiYXNlXCIsXG5cdFx0XHRcIlwiLFxuXHRcdFx0XCJQb3N0Z3JlcyBydW5zIHZpYSBEZXYgQ29udGFpbmVyIENvbXBvc2U6XCIsXG5cdFx0XHRcIlwiLFxuXHRcdFx0XCJgYGBiYXNoXCIsXG5cdFx0XHRcInBucG0gZGI6dXBcIixcblx0XHRcdFwicG5wbSBkYjpkb3duXCIsXG5cdFx0XHRcInBucG0gZGI6cmVzZXRcIixcblx0XHRcdFwiYGBgXCIsXG5cdFx0XHRcIlwiLFxuXHRcdCk7XG5cdH1cblxuXHRsaW5lcy5wdXNoKFxuXHRcdFwiIyMgRGVwbG95XCIsXG5cdFx0XCJcIixcblx0XHRcIlBhYVMgaG9zdHMgKGBkb2NrZXIgYnVpbGRgIGZyb20gdGhlIHJlcG8gcm9vdCkgdXNlIHRoZSBzY2FmZm9sZGVkIGBEb2NrZXJmaWxlYC5cIixcblx0XHRcIlRoZSBydW50aW1lIGltYWdlIGluc3RhbGxzIHByb2R1Y3Rpb24gZGVwZW5kZW5jaWVzIG9ubHkgKGBwbnBtIGluc3RhbGwgLS1wcm9kYCk7XCIsXG5cdFx0XCJGb3JnZSwgVHlwZVNjcmlwdCwgQmlvbWUsIGFuZCBWaXRlc3Qgc3RheSBpbiB0aGUgYnVpbGQgc3RhZ2UuXCIsXG5cdFx0XCJcIixcblx0XHRcImBgYGJhc2hcIixcblx0XHRgZG9ja2VyIGJ1aWxkIC10ICR7cHJvamVjdE5hbWV9IC5gLFxuXHRcdFwiYGBgXCIsXG5cdFx0XCJcIixcblx0XHRcIkV4dHJhIEFQSXM6IGBkb2NrZXIgYnVpbGQgLWYgRG9ja2VyZmlsZS48bmFtZT4gLmBcIixcblx0XHRcIlwiLFxuXHQpO1xuXG5cdGxpbmVzLnB1c2goXG5cdFx0XCIjIyBBZGQgYW5vdGhlciBBUElcIixcblx0XHRcIlwiLFxuXHRcdFwiYGBgYmFzaFwiLFxuXHRcdFwiZGVjb2hlcmUgYWRkIGFwaSA8bmFtZT5cIixcblx0XHRcImBgYFwiLFxuXHRcdFwiXCIsXG5cdFx0XCJFeGFtcGxlOiBgZGVjb2hlcmUgYWRkIGFwaSBiaWxsaW5nYFwiLFxuXHRcdFwiXCIsXG5cdCk7XG5cblx0aWYgKGhhc0F1dGgwKSB7XG5cdFx0bGluZXMucHVzaChcblx0XHRcdFwiIyMgQXV0aDBcIixcblx0XHRcdFwiXCIsXG5cdFx0XHRcIkpXVCBhdXRoIGlzIHdpcmVkIGZyb20gYC5lbnZgIChgQVVUSDBfSVNTVUVSX0JBU0VfVVJMYCwgYEFVVEgwX0FVRElFTkNFYCkuXCIsXG5cdFx0XHRcIlNldCB0aG9zZSB2YWx1ZXMgKG9yIHJlLXJ1biBzY2FmZm9sZCB3aXRoIGAtLWF1dGggYXV0aDBgKSBiZWZvcmUgY2FsbGluZyBwcm90ZWN0ZWQgcm91dGVzLlwiLFxuXHRcdFx0XCJcIixcblx0XHQpO1xuXHR9XG5cblx0aWYgKGhhc1Bvc3RtYW4pIHtcblx0XHRsaW5lcy5wdXNoKFxuXHRcdFx0XCIjIyBQb3N0bWFuXCIsXG5cdFx0XHRcIlwiLFxuXHRcdFx0XCJPcGVuIHRoaXMgKipwcm9qZWN0IHJvb3QqKiBpbiBQb3N0bWFuIExvY2FsIFZpZXcgKEZpbGVzIOKGkiBPcGVuIGZvbGRlciksIG5vdCB0aGUgYHBvc3RtYW4vYCBzdWJmb2xkZXIuXCIsXG5cdFx0XHRcIlNlbGVjdCB0aGUgTG9jYWwgZW52aXJvbm1lbnQsIHRoZW4gQXV0aG9yaXphdGlvbiDihpIgR2V0IE5ldyBBY2Nlc3MgVG9rZW4gd2hlbiBBdXRoMCBpcyBlbmFibGVkLlwiLFxuXHRcdFx0XCJcIixcblx0XHQpO1xuXHR9XG5cblx0bGluZXMucHVzaChcblx0XHRcIiMjIE1vcmVcIixcblx0XHRcIlwiLFxuXHRcdFwiLSBQYWNrYWdlIGRvY3M6IGh0dHBzOi8vd3d3Lm5wbWpzLmNvbS9wYWNrYWdlL0BkZWNvaGVyZS9jcmVhdGVcIixcblx0XHRcIi0gQWZ0ZXIgYGRlY29oZXJlIGFkZCBhcGlgLCB0aGlzIFJFQURNRSBpcyByZWZyZXNoZWQgc28gc2NyaXB0cyBhbmQgQVBJcyBzdGF5IGFjY3VyYXRlLlwiLFxuXHRcdFwiXCIsXG5cdCk7XG5cblx0cmV0dXJuIGAke2xpbmVzLmpvaW4oXCJcXG5cIil9YDtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHJlc29sdmVXb3Jrc3BhY2VSZWFkbWVJbnB1dChcblx0d29ya3NwYWNlOiBXb3Jrc3BhY2VTY2FmZm9sZCxcblx0b3B0aW9uczogV29ya3NwYWNlUmVhZG1lT3B0aW9ucyxcbik6IFdvcmtzcGFjZVJlYWRtZUlucHV0IHtcblx0Y29uc3QgbmV3TmFtZXMgPSB3b3Jrc3BhY2Vcblx0XHQuZ2V0UHJvamVjdHMoKVxuXHRcdC5tYXAoKHByb2plY3QpID0+IGFwaU5hbWVGcm9tUHJvamVjdERpcihwcm9qZWN0LmRpcikpO1xuXHRjb25zdCBhcGlOYW1lcyA9IG9wdGlvbnMuYWRkXG5cdFx0PyBtZXJnZUFwaU5hbWVzKGxpc3RFeGlzdGluZ0FwaU5hbWVzKHdvcmtzcGFjZS50YXJnZXREaXIpLCBuZXdOYW1lcylcblx0XHQ6IG5ld05hbWVzO1xuXG5cdGNvbnN0IHBrZyA9IHdvcmtzcGFjZS5nZXRNb2RlbDxQYWNrYWdlSnNvbj4oV0VMTF9LTk9XTl9GSUxFUy5QQUNLQUdFX0pTT04pO1xuXHRjb25zdCBlbnYgPSB3b3Jrc3BhY2UuZ2V0TW9kZWw8RW52RmlsZT4oV0VMTF9LTk9XTl9GSUxFUy5FTlZfRklMRSk7XG5cblx0Y29uc3QgaGFzUG9zdGdyZXMgPVxuXHRcdG9wdGlvbnMuZGF0YWJhc2VQcm92aWRlciA9PT0gXCJwb3N0Z3Jlcy90eXBlb3JtXCIgfHwgQm9vbGVhbihwa2c/Lmhhc1NjcmlwdChcImRiOnVwXCIpKTtcblx0Y29uc3QgaGFzQXV0aDAgPVxuXHRcdG9wdGlvbnMuYXV0aFByb3ZpZGVyID09PSBcImF1dGgwXCIgfHwgQm9vbGVhbihlbnY/Lmhhc0VudHJ5KFwiQVVUSDBfSVNTVUVSX0JBU0VfVVJMXCIpKTtcblx0Y29uc3QgaGFzUG9zdG1hbiA9XG5cdFx0b3B0aW9ucy5wb3N0bWFuUHJvdmlkZXIgPT09IFwibG9jYWxcIiB8fFxuXHRcdG9wdGlvbnMucG9zdG1hblByb3ZpZGVyID09PSBcImFwaVwiIHx8XG5cdFx0ZXhpc3RzU3luYyhqb2luKHdvcmtzcGFjZS50YXJnZXREaXIsIFwicG9zdG1hblwiKSkgfHxcblx0XHRleGlzdHNTeW5jKGpvaW4od29ya3NwYWNlLnRhcmdldERpciwgXCIucG9zdG1hblwiKSk7XG5cblx0cmV0dXJuIHtcblx0XHRwcm9qZWN0TmFtZTogd29ya3NwYWNlLm5hbWUsXG5cdFx0YXBpTmFtZXMsXG5cdFx0aGFzUG9zdGdyZXMsXG5cdFx0aGFzQXV0aDAsXG5cdFx0aGFzUG9zdG1hbixcblx0fTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHdyaXRlV29ya3NwYWNlUmVhZG1lKFxuXHR3b3Jrc3BhY2U6IFdvcmtzcGFjZVNjYWZmb2xkLFxuXHRvcHRpb25zOiBXb3Jrc3BhY2VSZWFkbWVPcHRpb25zLFxuKTogdm9pZCB7XG5cdGNvbnN0IGNvbnRlbnQgPSByZW5kZXJXb3Jrc3BhY2VSZWFkbWUocmVzb2x2ZVdvcmtzcGFjZVJlYWRtZUlucHV0KHdvcmtzcGFjZSwgb3B0aW9ucykpO1xuXHR3b3Jrc3BhY2UuYWRkRmlsZSh7XG5cdFx0ZmlsZXM6ICgpID0+IFt7IGZpbGVQYXRoOiBcIlJFQURNRS5tZFwiLCBjb250ZW50IH1dLFxuXHR9KTtcbn1cblxuZnVuY3Rpb24gbWVyZ2VBcGlOYW1lcyhleGlzdGluZzogcmVhZG9ubHkgc3RyaW5nW10sIGFkZGVkOiByZWFkb25seSBzdHJpbmdbXSk6IHN0cmluZ1tdIHtcblx0Y29uc3Qgc2VlbiA9IG5ldyBTZXQoZXhpc3RpbmcpO1xuXHRyZXR1cm4gWy4uLmV4aXN0aW5nLCAuLi5hZGRlZC5maWx0ZXIoKG5hbWUpID0+ICFzZWVuLmhhcyhuYW1lKSldO1xufVxuIl0sIm5hbWVzIjpbImV4aXN0c1N5bmMiLCJqb2luIiwiV0VMTF9LTk9XTl9GSUxFUyIsImFwaU5hbWVGcm9tUHJvamVjdERpciIsImxpc3RFeGlzdGluZ0FwaU5hbWVzIiwicmVuZGVyV29ya3NwYWNlUmVhZG1lIiwiaW5wdXQiLCJwcm9qZWN0TmFtZSIsImFwaU5hbWVzIiwiaGFzUG9zdGdyZXMiLCJoYXNBdXRoMCIsImhhc1Bvc3RtYW4iLCJhcGlzIiwibGVuZ3RoIiwibGluZXMiLCJuYW1lIiwicHVzaCIsInJlc29sdmVXb3Jrc3BhY2VSZWFkbWVJbnB1dCIsIndvcmtzcGFjZSIsIm9wdGlvbnMiLCJuZXdOYW1lcyIsImdldFByb2plY3RzIiwibWFwIiwicHJvamVjdCIsImRpciIsImFkZCIsIm1lcmdlQXBpTmFtZXMiLCJ0YXJnZXREaXIiLCJwa2ciLCJnZXRNb2RlbCIsIlBBQ0tBR0VfSlNPTiIsImVudiIsIkVOVl9GSUxFIiwiZGF0YWJhc2VQcm92aWRlciIsIkJvb2xlYW4iLCJoYXNTY3JpcHQiLCJhdXRoUHJvdmlkZXIiLCJoYXNFbnRyeSIsInBvc3RtYW5Qcm92aWRlciIsIndyaXRlV29ya3NwYWNlUmVhZG1lIiwiY29udGVudCIsImFkZEZpbGUiLCJmaWxlcyIsImZpbGVQYXRoIiwiZXhpc3RpbmciLCJhZGRlZCIsInNlZW4iLCJTZXQiLCJmaWx0ZXIiLCJoYXMiXSwibWFwcGluZ3MiOiJBQUFBLFNBQVNBLFVBQVUsUUFBUSxVQUFV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

package/es6/src/webapi.action.js

@@ -0,0 +1,20 @@
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+import { injectable } from "@decohere/crucible/decorators";
+import { ActionResponse } from "@decohere/nexus/cli";
+import { runScaffoldApi, toApiOptions } from "./webapi/cli-options.js";
+export class WebapiAction {
+    async run(options) {
+        await runScaffoldApi(toApiOptions(options.directory, options));
+        return ActionResponse.Success("webapi");
+    }
+}
+WebapiAction = _ts_decorate([
+    injectable()
+], WebapiAction);
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL3NjYWZmb2xkL3NyYy93ZWJhcGkuYWN0aW9uLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IGluamVjdGFibGUgfSBmcm9tIFwiQGRlY29oZXJlL2NydWNpYmxlL2RlY29yYXRvcnNcIjtcbmltcG9ydCB7IHR5cGUgQWN0aW9uLCBBY3Rpb25SZXNwb25zZSB9IGZyb20gXCJAZGVjb2hlcmUvbmV4dXMvY2xpXCI7XG5pbXBvcnQgeyBydW5TY2FmZm9sZEFwaSwgdG9BcGlPcHRpb25zIH0gZnJvbSBcIi4vd2ViYXBpL2NsaS1vcHRpb25zLmpzXCI7XG5cbmV4cG9ydCB0eXBlIFdlYmFwaU9wdGlvbnMgPSB7XG5cdGRpcmVjdG9yeT86IHN0cmluZztcblx0ZD86IHN0cmluZztcblx0bmFtZT86IHN0cmluZyB8IHN0cmluZ1tdO1xuXHRkYXRhYmFzZT86IHN0cmluZztcblx0YXV0aD86IHN0cmluZztcblx0cG9zdG1hbj86IHN0cmluZztcblx0eWVzPzogYm9vbGVhbjtcblx0aW5zdGFsbD86IHN0cmluZztcbn07XG5cbkBpbmplY3RhYmxlKClcbmV4cG9ydCBjbGFzcyBXZWJhcGlBY3Rpb24gaW1wbGVtZW50cyBBY3Rpb248V2ViYXBpT3B0aW9ucz4ge1xuXHRwdWJsaWMgYXN5bmMgcnVuKG9wdGlvbnM6IFdlYmFwaU9wdGlvbnMpOiBQcm9taXNlPEFjdGlvblJlc3BvbnNlPiB7XG5cdFx0YXdhaXQgcnVuU2NhZmZvbGRBcGkodG9BcGlPcHRpb25zKG9wdGlvbnMuZGlyZWN0b3J5LCBvcHRpb25zKSk7XG5cdFx0cmV0dXJuIEFjdGlvblJlc3BvbnNlLlN1Y2Nlc3MoXCJ3ZWJhcGlcIik7XG5cdH1cbn1cbiJdLCJuYW1lcyI6WyJpbmplY3RhYmxlIiwiQWN0aW9uUmVzcG9uc2UiLCJydW5TY2FmZm9sZEFwaSIsInRvQXBpT3B0aW9ucyIsIldlYmFwaUFjdGlvbiIsInJ1biIsIm9wdGlvbnMiLCJkaXJlY3RvcnkiLCJTdWNjZXNzIl0sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSxTQUFTQSxVQUFVLFFBQVEsZ0NBQWdDO0FBQzNELFNBQXNCQyxjQUFjLFFBQVEsc0JBQXNCO0FBQ2xFLFNBQVNDLGNBQWMsRUFBRUMsWUFBWSxRQUFRLDBCQUEwQjtBQWN2RSxPQUFPLE1BQU1DO0lBQ1osTUFBYUMsSUFBSUMsT0FBc0IsRUFBMkI7UUFDakUsTUFBTUosZUFBZUMsYUFBYUcsUUFBUUMsU0FBUyxFQUFFRDtRQUNyRCxPQUFPTCxlQUFlTyxPQUFPLENBQUM7SUFDL0I7QUFDRCJ9

package/es6/src/webapi.command.js

@@ -0,0 +1,35 @@
+import { DecohereCommand } from "@decohere/nexus/cli";
+import { addWebapiFeatureOptions, collectName } from "./webapi/cli-options.js";
+import { WebapiAction } from "./webapi.action.js";
+export class WebapiCommand extends DecohereCommand {
+    get actions() {
+        return [
+            WebapiAction
+        ];
+    }
+    constructor(name){
+        super(name);
+        this.description("Scaffold a Cortex web API workspace");
+        this.argument("[directory]", "Target directory (default: -d or current directory)");
+        this.option("-d <directory>", "Target directory (default: current directory)", ".");
+        this.option("--name <slug>", "API name under projects/ (repeatable; default: api)", collectName, []);
+        addWebapiFeatureOptions(this);
+    }
+    /**
+	 * Commander passes positional args before options when `[directory]` is declared.
+	 * ModuleFactory expects `(opts, cmd)` — stash the directory on the command.
+	 */ action(fn) {
+        return super.action((...args)=>{
+            const cmd = args.at(-1);
+            const first = args[0];
+            const hasPositional = typeof first === "string" || first === undefined;
+            const opts = hasPositional ? args[1] : args[0];
+            if (typeof first === "string" && first !== "") {
+                cmd.setOptionValue("directory", first);
+            }
+            return fn(opts, cmd);
+        });
+    }
+}
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL3NjYWZmb2xkL3NyYy93ZWJhcGkuY29tbWFuZC50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBEZWNvaGVyZUNvbW1hbmQgfSBmcm9tIFwiQGRlY29oZXJlL25leHVzL2NsaVwiO1xuaW1wb3J0IHR5cGUgeyBPcHRpb25WYWx1ZXMgfSBmcm9tIFwiY29tbWFuZGVyXCI7XG5pbXBvcnQgeyBhZGRXZWJhcGlGZWF0dXJlT3B0aW9ucywgY29sbGVjdE5hbWUgfSBmcm9tIFwiLi93ZWJhcGkvY2xpLW9wdGlvbnMuanNcIjtcbmltcG9ydCB7IFdlYmFwaUFjdGlvbiB9IGZyb20gXCIuL3dlYmFwaS5hY3Rpb24uanNcIjtcblxuZXhwb3J0IGNsYXNzIFdlYmFwaUNvbW1hbmQgZXh0ZW5kcyBEZWNvaGVyZUNvbW1hbmQge1xuXHRwdWJsaWMgb3ZlcnJpZGUgZ2V0IGFjdGlvbnMoKSB7XG5cdFx0cmV0dXJuIFtXZWJhcGlBY3Rpb25dO1xuXHR9XG5cblx0cHVibGljIGNvbnN0cnVjdG9yKG5hbWU6IHN0cmluZykge1xuXHRcdHN1cGVyKG5hbWUpO1xuXHRcdHRoaXMuZGVzY3JpcHRpb24oXCJTY2FmZm9sZCBhIENvcnRleCB3ZWIgQVBJIHdvcmtzcGFjZVwiKTtcblx0XHR0aGlzLmFyZ3VtZW50KFwiW2RpcmVjdG9yeV1cIiwgXCJUYXJnZXQgZGlyZWN0b3J5IChkZWZhdWx0OiAtZCBvciBjdXJyZW50IGRpcmVjdG9yeSlcIik7XG5cdFx0dGhpcy5vcHRpb24oXCItZCA8ZGlyZWN0b3J5PlwiLCBcIlRhcmdldCBkaXJlY3RvcnkgKGRlZmF1bHQ6IGN1cnJlbnQgZGlyZWN0b3J5KVwiLCBcIi5cIik7XG5cdFx0dGhpcy5vcHRpb24oXG5cdFx0XHRcIi0tbmFtZSA8c2x1Zz5cIixcblx0XHRcdFwiQVBJIG5hbWUgdW5kZXIgcHJvamVjdHMvIChyZXBlYXRhYmxlOyBkZWZhdWx0OiBhcGkpXCIsXG5cdFx0XHRjb2xsZWN0TmFtZSxcblx0XHRcdFtdIGFzIHN0cmluZ1tdLFxuXHRcdCk7XG5cdFx0YWRkV2ViYXBpRmVhdHVyZU9wdGlvbnModGhpcyk7XG5cdH1cblxuXHQvKipcblx0ICogQ29tbWFuZGVyIHBhc3NlcyBwb3NpdGlvbmFsIGFyZ3MgYmVmb3JlIG9wdGlvbnMgd2hlbiBgW2RpcmVjdG9yeV1gIGlzIGRlY2xhcmVkLlxuXHQgKiBNb2R1bGVGYWN0b3J5IGV4cGVjdHMgYChvcHRzLCBjbWQpYCDigJQgc3Rhc2ggdGhlIGRpcmVjdG9yeSBvbiB0aGUgY29tbWFuZC5cblx0ICovXG5cdHB1YmxpYyBvdmVycmlkZSBhY3Rpb24oZm46ICguLi5hcmdzOiB1bmtub3duW10pID0+IHZvaWQgfCBQcm9taXNlPHZvaWQ+KTogdGhpcyB7XG5cdFx0cmV0dXJuIHN1cGVyLmFjdGlvbigoLi4uYXJnczogdW5rbm93bltdKSA9PiB7XG5cdFx0XHRjb25zdCBjbWQgPSBhcmdzLmF0KC0xKSBhcyBEZWNvaGVyZUNvbW1hbmQ7XG5cdFx0XHRjb25zdCBmaXJzdCA9IGFyZ3NbMF07XG5cdFx0XHRjb25zdCBoYXNQb3NpdGlvbmFsID0gdHlwZW9mIGZpcnN0ID09PSBcInN0cmluZ1wiIHx8IGZpcnN0ID09PSB1bmRlZmluZWQ7XG5cdFx0XHRjb25zdCBvcHRzID0gaGFzUG9zaXRpb25hbCA/IChhcmdzWzFdIGFzIE9wdGlvblZhbHVlcykgOiAoYXJnc1swXSBhcyBPcHRpb25WYWx1ZXMpO1xuXHRcdFx0aWYgKHR5cGVvZiBmaXJzdCA9PT0gXCJzdHJpbmdcIiAmJiBmaXJzdCAhPT0gXCJcIikge1xuXHRcdFx0XHRjbWQuc2V0T3B0aW9uVmFsdWUoXCJkaXJlY3RvcnlcIiwgZmlyc3QpO1xuXHRcdFx0fVxuXHRcdFx0cmV0dXJuIGZuKG9wdHMsIGNtZCk7XG5cdFx0fSk7XG5cdH1cbn1cbiJdLCJuYW1lcyI6WyJEZWNvaGVyZUNvbW1hbmQiLCJhZGRXZWJhcGlGZWF0dXJlT3B0aW9ucyIsImNvbGxlY3ROYW1lIiwiV2ViYXBpQWN0aW9uIiwiV2ViYXBpQ29tbWFuZCIsImFjdGlvbnMiLCJuYW1lIiwiZGVzY3JpcHRpb24iLCJhcmd1bWVudCIsIm9wdGlvbiIsImFjdGlvbiIsImZuIiwiYXJncyIsImNtZCIsImF0IiwiZmlyc3QiLCJoYXNQb3NpdGlvbmFsIiwidW5kZWZpbmVkIiwib3B0cyIsInNldE9wdGlvblZhbHVlIl0sIm1hcHBpbmdzIjoiQUFBQSxTQUFTQSxlQUFlLFFBQVEsc0JBQXNCO0FBRXRELFNBQVNDLHVCQUF1QixFQUFFQyxXQUFXLFFBQVEsMEJBQTBCO0FBQy9FLFNBQVNDLFlBQVksUUFBUSxxQkFBcUI7QUFFbEQsT0FBTyxNQUFNQyxzQkFBc0JKO0lBQ2xDLElBQW9CSyxVQUFVO1FBQzdCLE9BQU87WUFBQ0Y7U0FBYTtJQUN0QjtJQUVBLFlBQW1CRyxJQUFZLENBQUU7UUFDaEMsS0FBSyxDQUFDQTtRQUNOLElBQUksQ0FBQ0MsV0FBVyxDQUFDO1FBQ2pCLElBQUksQ0FBQ0MsUUFBUSxDQUFDLGVBQWU7UUFDN0IsSUFBSSxDQUFDQyxNQUFNLENBQUMsa0JBQWtCLGlEQUFpRDtRQUMvRSxJQUFJLENBQUNBLE1BQU0sQ0FDVixpQkFDQSx1REFDQVAsYUFDQSxFQUFFO1FBRUhELHdCQUF3QixJQUFJO0lBQzdCO0lBRUE7OztFQUdDLEdBQ0QsQUFBZ0JTLE9BQU9DLEVBQWdELEVBQVE7UUFDOUUsT0FBTyxLQUFLLENBQUNELE9BQU8sQ0FBQyxHQUFHRTtZQUN2QixNQUFNQyxNQUFNRCxLQUFLRSxFQUFFLENBQUMsQ0FBQztZQUNyQixNQUFNQyxRQUFRSCxJQUFJLENBQUMsRUFBRTtZQUNyQixNQUFNSSxnQkFBZ0IsT0FBT0QsVUFBVSxZQUFZQSxVQUFVRTtZQUM3RCxNQUFNQyxPQUFPRixnQkFBaUJKLElBQUksQ0FBQyxFQUFFLEdBQXFCQSxJQUFJLENBQUMsRUFBRTtZQUNqRSxJQUFJLE9BQU9HLFVBQVUsWUFBWUEsVUFBVSxJQUFJO2dCQUM5Q0YsSUFBSU0sY0FBYyxDQUFDLGFBQWFKO1lBQ2pDO1lBQ0EsT0FBT0osR0FBR08sTUFBTUw7UUFDakI7SUFDRDtBQUNEIn0=

package/package.json

@@ -1,10 +1,6 @@
 {
   "name": "@decohere/scaffold",
-  "version": "0.0.1-dev.18",
-  "decohere": {
-    "dockerImageRepository": "ghcr.io/typesmiths/decohere/create",
-    "devcontainerImageRepository": "ghcr.io/typesmiths/decohere/devcontainer"
-  },
+  "version": "0.0.1-dev.80",
   "description": "Decohere project scaffolder (runs inside ghcr.io/typesmiths/decohere/create)",
   "keywords": [
     "decohere",
@@ -26,10 +22,14 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/crucible": "0.0.1-dev.5",
-    "@decohere/nexus": "0.0.1-dev.5",
+    "@decohere/crucible": "0.0.1-dev.80",
+    "@decohere/nexus": "0.0.1-dev.80",
     "commander": "^13.1.0",
     "openapi-to-postmanv2": "^5.0.0"
   },
-  "devDependencies": {}
+  "devDependencies": {},
+  "decohere": {
+    "dockerImageRepository": "ghcr.io/typesmiths/decohere/create",
+    "devcontainerImageRepository": "ghcr.io/typesmiths/decohere/devcontainer"
+  }
 }

package/types/src/add-api.action.d.ts

@@ -0,0 +1,13 @@
+import { type Action, ActionResponse } from "@decohere/nexus/cli";
+export type AddApiOptions = {
+    apiName?: string;
+    d?: string;
+    database?: string;
+    auth?: string;
+    postman?: string;
+    yes?: boolean;
+    install?: string;
+};
+export declare class AddApiAction implements Action<AddApiOptions> {
+    run(options: AddApiOptions): Promise<ActionResponse>;
+}

package/types/src/add-api.command.d.ts

@@ -0,0 +1,7 @@
+import { DecohereCommand } from "@decohere/nexus/cli";
+import { AddApiAction } from "./add-api.action.js";
+export declare class AddApiCommand extends DecohereCommand {
+    get actions(): (typeof AddApiAction)[];
+    constructor(name: string);
+    action(fn: (...args: unknown[]) => void | Promise<void>): this;
+}

package/types/src/add.command.d.ts

@@ -0,0 +1,6 @@
+import type { Actions } from "@decohere/nexus/cli";
+import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/nexus/cli";
+export declare class AddCommand extends DecohereCommand {
+    constructor(commands: Record<string, CommandType>, handler: CommandHandler);
+    run(_actions: Actions, _options: never): Promise<CommandResponse>;
+}

package/types/src/add.module.d.ts

@@ -0,0 +1,14 @@
+import { ModuleManifest } from "@decohere/nexus/cli";
+import { AddCommand } from "./add.command.js";
+import { AddApiAction } from "./add-api.action.js";
+import { AddApiCommand } from "./add-api.command.js";
+export declare class AddModule extends ModuleManifest {
+    readonly id = "add";
+    readonly command: typeof AddCommand;
+    readonly commands: {
+        api: typeof AddApiCommand;
+    };
+    readonly actions: {
+        api: typeof AddApiAction;
+    };
+}

package/types/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/types/src/create.command.d.ts

@@ -0,0 +1,6 @@
+import type { Actions } from "@decohere/nexus/cli";
+import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/nexus/cli";
+export declare class CreateCommand extends DecohereCommand {
+    constructor(commands: Record<string, CommandType>, handler: CommandHandler);
+    run(_actions: Actions, _options: never): Promise<CommandResponse>;
+}

package/types/src/create.module.d.ts

@@ -0,0 +1,14 @@
+import { ModuleManifest } from "@decohere/nexus/cli";
+import { CreateCommand } from "./create.command.js";
+import { WebapiAction } from "./webapi.action.js";
+import { WebapiCommand } from "./webapi.command.js";
+export declare class CreateModule extends ModuleManifest {
+    readonly id = "create";
+    readonly command: typeof CreateCommand;
+    readonly commands: {
+        webapi: typeof WebapiCommand;
+    };
+    readonly actions: {
+        webapi: typeof WebapiAction;
+    };
+}

package/types/src/domain/prompt.d.ts

@@ -0,0 +1,4 @@
+/** Release stdin so the process can exit after interactive prompts. */
+export declare function closePrompt(): void;
+export declare function ask(question: string, fallback?: string): Promise<string>;
+export declare function pick<T>(label: string, items: T[], display: (item: T) => string): Promise<T | null>;

package/types/src/models/compose.model.d.ts

@@ -0,0 +1,64 @@
+import type { KeyedModel } from "./source-file.js";
+export type ComposeNetworkRef = string | {
+    /** Network key under `networks:` on this service */
+    [networkKey: string]: {
+        aliases?: string[];
+    };
+};
+export interface ComposeHealthcheck {
+    test: string[];
+    interval?: string;
+    timeout?: string;
+    retries?: number;
+}
+export interface ComposeService {
+    build?: string;
+    image?: string;
+    container_name?: string;
+    /** Quoted in YAML (`0:0` must not parse as a number). */
+    user?: string;
+    env_file?: string[];
+    environment?: Record<string, string>;
+    ports?: string[];
+    volumes?: string[];
+    command?: string;
+    restart?: string;
+    depends_on?: string[];
+    /** Compose profiles (service only starts when profile is enabled). */
+    profiles?: string[];
+    /** Attach to compose networks (string name or map with aliases). */
+    networks?: ComposeNetworkRef[];
+    healthcheck?: ComposeHealthcheck;
+}
+export type ComposeNetwork = {
+    /** Fixed Docker network name (shareable across compose projects). */
+    name: string;
+    external?: boolean;
+};
+/**
+ * Live builder for `docker-compose.yml`.
+ *
+ * Features call `addService` / `addVolume` / `addNetwork` in their scaffold phases.
+ */
+export declare class DockerCompose implements KeyedModel {
+    readonly key: string;
+    private _projectName;
+    private readonly _headerComments;
+    private readonly _services;
+    private readonly _volumes;
+    private readonly _networks;
+    /** Compose project name (`name:` top-level) — isolates containers/volumes. */
+    setProjectName(name: string): this;
+    /** File-level `#` comments rendered above `name:` / `services:`. */
+    addHeaderComment(...lines: string[]): this;
+    addService(name: string, config: ComposeService): this;
+    files(): {
+        filePath: string;
+        content: string;
+    }[];
+    addVolume(name: string): this;
+    addNetwork(key: string, network: ComposeNetwork): this;
+    /** Append an env_file path to an existing service. */
+    addEnvFile(serviceName: string, filePath: string): this;
+    getContent(): string;
+}

package/types/src/models/config-yaml.model.d.ts

@@ -0,0 +1,27 @@
+import type { KeyedModel, SourceFile } from "./source-file.js";
+/**
+ * Builder for a YAML config file (e.g. config/config.yaml or config/config.dev.yaml).
+ *
+ * Starts with a base section passed to the constructor. Features call
+ * `addSection(yaml)` during their scaffold phase to append their own block.
+ * `files()` joins all sections with a blank line separator.
+ */
+export declare class ConfigYaml implements KeyedModel {
+    readonly key: string;
+    private readonly filePath;
+    private readonly _sections;
+    constructor(key: string, filePath: string, baseContent: string);
+    addSection(yaml: string): this;
+    /** True when a datasource with this `name:` already appears in the file. */
+    hasDataSource(name: string): boolean;
+    hasDataSources(): boolean;
+    /**
+     * Insert a `dataSources` list item. Used by `webapi add` so we do not write a
+     * second top-level `database:` key (YAML last-key-wins).
+     */
+    appendDataSource(item: string): this;
+    static fromFile(key: string, relativePath: string, absolutePath: string): ConfigYaml;
+    files(): SourceFile[];
+}
+/** Insert a YAML list item under `dataSources:`; append a new `database:` block if missing. */
+export declare function injectYamlDataSource(yaml: string, item: string): string;

package/types/src/models/const.d.ts

@@ -0,0 +1,20 @@
+export declare const WELL_KNOWN_FILES: {
+    VSCODE_SETTINGS: string;
+    LAUNCH_JSON: string;
+    DOCKER_COMPOSE: string;
+    DEVCONTAINER_JSON: string;
+    DOCKERFILE: string;
+    PRODUCTION_DOCKERFILE: string;
+    GITHUB_CI: string;
+    PACKAGE_JSON: string;
+    API_PACKAGE_JSON: string;
+    TSCONFIG: string;
+    VITEST_CONFIG: string;
+    MAIN_TS: string;
+    CONTROLLER_TS: string;
+    CONFIG_YAML: string;
+    CONFIG_DEV_YAML: string;
+    GITIGNORE: string;
+    AUTH_CONFIG: string;
+    ENV_FILE: string;
+};

package/types/src/models/dev-container.model.d.ts

@@ -0,0 +1,37 @@
+import type { KeyedModel, SourceFile } from "./source-file.js";
+/**
+ * Model for `.devcontainer/devcontainer.json`.
+ *
+ * Features call builder methods (`addExtension`, `forwardPort`, etc.) during
+ * their configure phase. `MonoRepoScaffold` calls `files()` at render time.
+ */
+export type PortAttributes = {
+    label?: string;
+    /** When true, host port must match the container port (no random remap). */
+    requireLocalPort?: boolean;
+    onAutoForward?: "notify" | "openBrowser" | "openPreview" | "silent" | "ignore";
+};
+export declare class DevContainer implements KeyedModel {
+    readonly key: string;
+    private readonly _extensions;
+    private readonly _ports;
+    private readonly _portAttributes;
+    private readonly _mounts;
+    private _postCreateCommand?;
+    private _updateContentCommand?;
+    private _postStartCommand?;
+    private _initializeCommand?;
+    private _remoteUser;
+    private _useCompose;
+    constructor();
+    addExtension(...ids: string[]): this;
+    forwardPort(...ports: number[]): this;
+    setPortAttributes(port: number, attrs: PortAttributes): this;
+    setPostCreateCommand(cmd: string): this;
+    setUpdateContentCommand(cmd: string): this;
+    setPostStartCommand(cmd: string): this;
+    setInitializeCommand(cmd: string): this;
+    setRemoteUser(user: string): this;
+    useCompose(): this;
+    files(): SourceFile[];
+}

package/types/src/models/docker-image.model.d.ts

@@ -0,0 +1,84 @@
+import type { KeyedModel, SourceFile } from "./source-file.js";
+export type LayerWriter = (dockerfile: DockerfileModel) => void;
+export declare class DockerStep {
+    readonly key: string;
+    readonly content: string;
+    readonly order: number;
+    constructor(key: string, content: string, order?: number);
+    static run(key: string, command: string, order?: number): DockerStep;
+    static raw(key: string, content: string, order?: number): DockerStep;
+    static entrypoint(key: string, value: string | readonly string[], order?: number): DockerStep;
+}
+/** Named volume + paths for interactive bash history in app Dev Containers. */
+export declare const commandHistory: {
+    readonly volumeName: "bashhistory";
+    readonly dir: "/commandhistory";
+    readonly fileName: ".bash_history";
+    readonly histFile: "/commandhistory/.bash_history";
+};
+export declare function withCommandHistory(options?: {
+    historyDir?: string;
+    historyFileName?: string;
+    username?: string;
+    order?: number;
+}): LayerWriter;
+export declare function withNodeUser(options?: {
+    username?: string;
+    includeUserInstruction?: boolean;
+    order?: number;
+}): LayerWriter;
+export declare function withPnpm(options?: {
+    version?: string;
+    usernameExpr?: string;
+    order?: number;
+}): LayerWriter;
+/**
+ * Client-only (`psql`, etc.). Escalates to root so this also works when layered on
+ * a published base image that already switched to `USER node`.
+ */
+export declare function withPostgresqlClient(options?: {
+    order?: number;
+    username?: string;
+}): LayerWriter;
+/** GitHub CLI — install before USER switches away from root. */
+export declare function withGithubCli(options?: {
+    order?: number;
+}): LayerWriter;
+export declare function withWorkspaceNodeModulesOwnership(options?: {
+    workspaceDir?: string;
+    usernameExpr?: string;
+    order?: number;
+}): LayerWriter;
+export declare function withVsCodeJsDebugBootloaderFix(options?: {
+    bashrcPath?: string;
+    order?: number;
+}): LayerWriter;
+export declare class DockerfileModel implements KeyedModel {
+    readonly key: string;
+    private readonly _steps;
+    private readonly _layerWriters;
+    private _fromImage;
+    private _layerCounter;
+    constructor(baseImage: string);
+    from(baseImage: string): this;
+    addLayer(layer: LayerWriter | string, order?: 5000): this;
+    addStep(step: DockerStep): this;
+    removeStep(key: string): this;
+    entrypoint(value: string | readonly string[], order?: 10000): this;
+    addRunStep(cmd: string): this;
+    build(): string;
+    protected registerBaseLayers(): void;
+    files(): SourceFile[];
+}
+/**
+ * Shared layers for the published `ghcr.io/typesmiths/decohere/devcontainer` image.
+ * Checked in at `projects/devcontainer/Dockerfile` — keep in sync via the unit test.
+ */
+export declare class AppDevContainerBaseImage extends DockerfileModel {
+    protected registerBaseLayers(): void;
+}
+/** Generic Dev Container image helpers (history + bootloader) without webapi defaults. */
+export declare class DevContainerImageModel extends DockerfileModel {
+    protected registerBaseLayers(): void;
+    files(): SourceFile[];
+}

package/types/src/models/env-file.model.d.ts

@@ -0,0 +1,16 @@
+import type { KeyedModel, SourceFile } from "./source-file.js";
+/**
+ * Accumulates key=value pairs and renders them as a `.env` file.
+ *
+ * Register once in the workspace; features call `addEntry` during their
+ * scaffold phase to contribute environment variables. The final file is
+ * written at render time when `workspace.scaffold()` is called.
+ */
+export declare class EnvFile implements KeyedModel {
+    readonly key: string;
+    private readonly _entries;
+    addEntry(key: string, value: string): this;
+    hasEntry(key: string): boolean;
+    static fromFile(absolutePath: string): EnvFile;
+    files(): SourceFile[];
+}

package/types/src/models/gitignore.model.d.ts

@@ -0,0 +1,7 @@
+import type { KeyedModel, SourceFile } from "./source-file.js";
+export declare class Gitignore implements KeyedModel {
+    readonly key: string;
+    private ignoreList;
+    add(...patterns: string[]): this;
+    files(): SourceFile[];
+}

package/types/src/models/launch-json.model.d.ts

@@ -0,0 +1,7 @@
+import type { KeyedModel, SourceFile } from "./source-file.js";
+export declare class LaunchJson implements KeyedModel {
+    private readonly apiNames;
+    readonly key: string;
+    constructor(apiNames?: readonly string[]);
+    files(): SourceFile[];
+}

package/types/src/models/package-json.model.d.ts

@@ -0,0 +1,35 @@
+import type { KeyedModel, SourceFile } from "./source-file.js";
+export type PackageJsonOptions = {
+    startEntry?: string;
+    /** API slugs in this workspace. Drives `start:<name>` / `dev:<name>`. */
+    apiNames?: readonly string[];
+    /** Host workspace name used in `@<workspace>/<api>` for flux `--project`. */
+    workspaceName?: string;
+};
+/**
+ * Builder for the root `package.json`.
+ *
+ * Starts with the core API dependencies. Features call `addDependency` /
+ * `addDevDependency` during their scaffold phase to inject their own deps
+ * before `files()` is called at render time.
+ */
+export declare class PackageJson implements KeyedModel {
+    private readonly name;
+    readonly key: string;
+    private _dependencies;
+    private _devDependencies;
+    private _scripts;
+    private _version;
+    private _type;
+    private _rest;
+    constructor(name: string, options?: PackageJsonOptions);
+    /** Load an existing root package.json so `webapi add` can merge scripts/deps. */
+    static fromFile(filePath: string): PackageJson;
+    addDependency(name: string, version: string): this;
+    addDevDependency(name: string, version: string): this;
+    addScript(name: string, command: string): this;
+    hasScript(name: string): boolean;
+    files(): SourceFile[];
+}
+/** Stable A→Z key order for package.json dependency maps. */
+export declare function sortStringMap(map: Record<string, string>): Record<string, string>;