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

package/commonjs/src/models/docker-image.model.js

@@ -1,277 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get AppDevContainerBaseImage () {
-        return AppDevContainerBaseImage;
-    },
-    get DevContainerImageModel () {
-        return DevContainerImageModel;
-    },
-    get DockerStep () {
-        return DockerStep;
-    },
-    get DockerfileModel () {
-        return DockerfileModel;
-    },
-    get commandHistory () {
-        return commandHistory;
-    },
-    get withCommandHistory () {
-        return withCommandHistory;
-    },
-    get withGithubCli () {
-        return withGithubCli;
-    },
-    get withNodeUser () {
-        return withNodeUser;
-    },
-    get withPnpm () {
-        return withPnpm;
-    },
-    get withPostgresqlClient () {
-        return withPostgresqlClient;
-    },
-    get withVsCodeJsDebugBootloaderFix () {
-        return withVsCodeJsDebugBootloaderFix;
-    },
-    get withWorkspaceNodeModulesOwnership () {
-        return withWorkspaceNodeModulesOwnership;
-    }
-});
-const _nodefs = require("node:fs");
-const _const = require("./const.js");
-class DockerStep {
-    key;
-    content;
-    order;
-    constructor(key, content, order = 0){
-        this.key = key;
-        this.content = content;
-        this.order = order;
-    }
-    static run(key, command, order = 0) {
-        return new DockerStep(key, `RUN ${command}`, order);
-    }
-    static raw(key, content, order = 0) {
-        return new DockerStep(key, content, order);
-    }
-    static entrypoint(key, value, order = 0) {
-        const content = typeof value === "string" ? `ENTRYPOINT ${value}` : `ENTRYPOINT ${JSON.stringify(value)}`;
-        return new DockerStep(key, content, order);
-    }
-}
-const StepOrder = {
-    base: 1_000,
-    features: 5_000,
-    user: 9_000,
-    entrypoint: 10_000
-};
-const VSCODE_BOOTLOADER_FIX_BASH_SNIPPET = `if [[ -n "\${NODE_OPTIONS:-}" && "\${NODE_OPTIONS}" == *"bootloader.js"* ]]; then
-    _bootloader_path="$(printf '%s\\n' "$NODE_OPTIONS" | sed -n 's/.*--require[= ]\\([^[:space:]]*bootloader\\.js\\).*/\\1/p')"
-    if [[ -n "\${_bootloader_path}" && ! -f "\${_bootloader_path}" ]]; then
-        _stable_bootloader="$(find /vscode/vscode-server /home/node/.vscode-server/extensions -name "bootloader.js" -path "*/ms-vscode.js-debug/*" 2>/dev/null | head -1)"
-        if [[ -n "\${_stable_bootloader}" ]]; then
-            NODE_OPTIONS="\${NODE_OPTIONS//\${_bootloader_path}/\${_stable_bootloader}}"
-        else
-            NODE_OPTIONS="$(printf '%s\\n' "$NODE_OPTIONS" | sed -E 's#(^| )--require(=| )[[:graph:]]*bootloader\\.js( |$)# #g; s#  +# #g; s#^ ##; s# $##')"
-            unset VSCODE_INSPECTOR_OPTIONS
-        fi
-        export NODE_OPTIONS
-        if [[ -z "$NODE_OPTIONS" ]]; then
-            unset NODE_OPTIONS
-        fi
-    fi
-    unset _bootloader_path _stable_bootloader
-fi`;
-const commandHistory = {
-    volumeName: "bashhistory",
-    dir: "/commandhistory",
-    fileName: ".bash_history",
-    histFile: "/commandhistory/.bash_history"
-};
-function withCommandHistory(options) {
-    const historyDir = options?.historyDir ?? commandHistory.dir;
-    const historyFileName = options?.historyFileName ?? commandHistory.fileName;
-    const username = options?.username ?? "node";
-    const order = options?.order ?? StepOrder.base;
-    const historyFile = `${historyDir}/${historyFileName}`;
-    return (dockerfile)=>{
-        dockerfile.addStep(DockerStep.run("history-dir", `mkdir -p ${historyDir} && touch ${historyFile} && chown -R ${username} ${historyDir}`, order)).addStep(DockerStep.raw("history-env", `ENV HISTFILE=${historyFile}`, order + 1)).addStep(DockerStep.raw("history-bashrc", `RUN SNIPPET="export PROMPT_COMMAND='history -a' && export HISTFILE=${historyFile}" \\\n\t&& echo "$SNIPPET" >> "/home/${username}/.bashrc"`, order + 2));
-    };
-}
-function withNodeUser(options) {
-    const username = options?.username ?? "node";
-    const includeUserInstruction = options?.includeUserInstruction ?? true;
-    const order = options?.order ?? StepOrder.features;
-    return (dockerfile)=>{
-        dockerfile.addStep(DockerStep.raw("arg-username", `ARG USERNAME=${username}`, order));
-        if (includeUserInstruction) {
-            dockerfile.addStep(DockerStep.raw("user", "USER ${USERNAME}", StepOrder.user));
-        }
-    };
-}
-function withPnpm(options) {
-    const version = options?.version ?? "10";
-    const usernameExpr = options?.usernameExpr ?? "${USERNAME}";
-    const order = options?.order ?? StepOrder.features + 100;
-    return (dockerfile)=>{
-        dockerfile.addStep(DockerStep.run("pnpm-install", `npm install --global npm@latest && npm add --global pnpm@${version}`, order)).addStep(DockerStep.run("pnpm-config", `mkdir -p /home/${usernameExpr}/.config/pnpm /home/${usernameExpr}/.pnpm-store && chown -R ${usernameExpr}:${usernameExpr} /home/${usernameExpr}/.config /home/${usernameExpr}/.pnpm-store && printf "store-dir=/home/${usernameExpr}/.pnpm-store\\n" > /home/${usernameExpr}/.config/pnpm/rc`, order + 1));
-    };
-}
-function withPostgresqlClient(options) {
-    const order = options?.order ?? StepOrder.features + 150;
-    const username = options?.username ?? "node";
-    return (dockerfile)=>{
-        dockerfile.addStep(DockerStep.raw("postgresql-client-root", "USER root", order)).addStep(DockerStep.run("postgresql-client", "apt-get update && apt-get install -y --no-install-recommends postgresql-client && rm -rf /var/lib/apt/lists/*", order + 1)).addStep(DockerStep.raw("postgresql-client-user", `USER ${username}`, order + 2));
-    };
-}
-function withGithubCli(options) {
-    const order = options?.order ?? StepOrder.features + 140;
-    return (dockerfile)=>{
-        dockerfile.addStep(DockerStep.run("github-cli", "apt-get update && apt-get install -y --no-install-recommends gh && rm -rf /var/lib/apt/lists/*", order));
-    };
-}
-function withWorkspaceNodeModulesOwnership(options) {
-    const workspaceDir = options?.workspaceDir ?? "/workspace";
-    const usernameExpr = options?.usernameExpr ?? "${USERNAME}";
-    const order = options?.order ?? StepOrder.features + 200;
-    return (dockerfile)=>{
-        dockerfile.addStep(DockerStep.raw("workspace-node-modules", `RUN mkdir -p ${workspaceDir}/node_modules && chown ${usernameExpr}:${usernameExpr} ${workspaceDir}/node_modules`, order));
-    };
-}
-function withVsCodeJsDebugBootloaderFix(options) {
-    const bashrcPath = options?.bashrcPath ?? "/home/${USERNAME}/.bashrc";
-    const order = options?.order ?? StepOrder.features + 300;
-    return (dockerfile)=>{
-        dockerfile.addStep(DockerStep.raw("vscode-bootloader-fix", [
-            "# VS Code / Cursor js-debug Auto Attach injects --require …/bootloader.js into",
-            "# NODE_OPTIONS. On a fresh Dev Container that path often does not exist yet",
-            "# (workspaceStorage file is only created after toggling Auto Attach), which crashes",
-            "# every Node command. If the injected path is missing, prefer the stable",
-            "# bootloader from the server extension install; otherwise strip the bad require.",
-            `RUN cat <<'EOF' >> "${bashrcPath}"`,
-            VSCODE_BOOTLOADER_FIX_BASH_SNIPPET,
-            "EOF"
-        ].join("\n"), order));
-    };
-}
-class DockerfileModel {
-    key = _const.WELL_KNOWN_FILES.DOCKERFILE;
-    _steps = new Map();
-    _layerWriters = [];
-    _fromImage;
-    _layerCounter = 0;
-    _existing;
-    constructor(baseImage){
-        this._fromImage = baseImage;
-        this.registerBaseLayers();
-    }
-    /**
-	 * Load an existing Dockerfile so `decohere add api` can append feature layers.
-	 * The new steps are appended as one block, unless the file already contains it.
-	 */ static fromFile(absolutePath, filePath) {
-        const dockerfile = new DockerfileModel("");
-        dockerfile._existing = {
-            content: (0, _nodefs.readFileSync)(absolutePath, "utf8"),
-            filePath
-        };
-        return dockerfile;
-    }
-    from(baseImage) {
-        this._fromImage = baseImage;
-        return this;
-    }
-    addLayer(layer, order = StepOrder.features) {
-        if (typeof layer === "string") {
-            const idx = ++this._layerCounter;
-            const key = `layer-run-${idx}`;
-            this._layerWriters.push((dockerfile)=>{
-                dockerfile.addStep(DockerStep.run(key, layer, order + idx));
-            });
-            return this;
-        }
-        this._layerWriters.push(layer);
-        return this;
-    }
-    addStep(step) {
-        this._steps.set(step.key, step);
-        return this;
-    }
-    removeStep(key) {
-        this._steps.delete(key);
-        return this;
-    }
-    entrypoint(value, order = StepOrder.entrypoint) {
-        this.addStep(DockerStep.entrypoint("entrypoint", value, order));
-        return this;
-    }
-    addRunStep(cmd) {
-        return this.addLayer(cmd);
-    }
-    build() {
-        for (const layerWriter of this._layerWriters){
-            layerWriter(this);
-        }
-        const sortedSteps = [
-            ...this._steps.values()
-        ].sort((left, right)=>{
-            if (left.order !== right.order) {
-                return left.order - right.order;
-            }
-            return left.key.localeCompare(right.key, "en");
-        });
-        if (this._existing) {
-            // All or nothing: skipping one step of a layer (e.g. its `USER root`) would break the rest.
-            const { content } = this._existing;
-            const block = sortedSteps.map((step)=>step.content).join("\n\n");
-            if (block === "" || content.includes(block)) return content;
-            return `${content.replace(/\n*$/, "\n")}\n${block}\n`;
-        }
-        const lines = [
-            `FROM ${this._fromImage}`
-        ];
-        for (const step of sortedSteps){
-            lines.push("", step.content);
-        }
-        return `${lines.join("\n")}\n`;
-    }
-    registerBaseLayers() {
-    // Generic base model intentionally has no default layers.
-    }
-    files() {
-        return [
-            {
-                filePath: this._existing?.filePath ?? "./Dockerfile",
-                content: this.build()
-            }
-        ];
-    }
-}
-class AppDevContainerBaseImage extends DockerfileModel {
-    registerBaseLayers() {
-        super.registerBaseLayers();
-        this.addLayer(withCommandHistory()).addLayer(withNodeUser()).addLayer(withPnpm()).addLayer(withGithubCli()).addLayer(withWorkspaceNodeModulesOwnership()).addLayer(withVsCodeJsDebugBootloaderFix());
-    }
-}
-class DevContainerImageModel extends DockerfileModel {
-    registerBaseLayers() {
-        super.registerBaseLayers();
-        this.addLayer(withCommandHistory()).addLayer(withVsCodeJsDebugBootloaderFix());
-    }
-    files() {
-        return [
-            {
-                filePath: ".devcontainer/Dockerfile",
-                content: this.build()
-            }
-        ];
-    }
-}

package/commonjs/src/models/env-file.model.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "EnvFile", {
-    enumerable: true,
-    get: function() {
-        return EnvFile;
-    }
-});
-const _nodefs = require("node:fs");
-const _const = require("./const.js");
-class EnvFile {
-    key = _const.WELL_KNOWN_FILES.ENV_FILE;
-    _entries = new Map();
-    addEntry(key, value) {
-        this._entries.set(key, value);
-        return this;
-    }
-    hasEntry(key) {
-        return this._entries.has(key);
-    }
-    static fromFile(absolutePath) {
-        const env = new EnvFile();
-        const raw = (0, _nodefs.readFileSync)(absolutePath, "utf8");
-        for (const line of raw.split("\n")){
-            const trimmed = line.trim();
-            if (trimmed === "" || trimmed.startsWith("#")) continue;
-            const eq = line.indexOf("=");
-            if (eq <= 0) continue;
-            env.addEntry(line.slice(0, eq).trim(), line.slice(eq + 1));
-        }
-        return env;
-    }
-    files() {
-        if (this._entries.size === 0) return [];
-        const body = [
-            ...this._entries.entries()
-        ].map(([k, v])=>`${k}=${v}`).join("\n");
-        const content = `${body}\n`;
-        return [
-            {
-                filePath: ".env",
-                content
-            }
-        ];
-    }
-}

package/commonjs/src/models/gitignore.model.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Gitignore", {
-    enumerable: true,
-    get: function() {
-        return Gitignore;
-    }
-});
-const _nodefs = require("node:fs");
-const _const = require("./const.js");
-class Gitignore {
-    key = _const.WELL_KNOWN_FILES.GITIGNORE;
-    ignoreList = [
-        "node_modules",
-        "dist",
-        ".package",
-        ".pnpm-store",
-        ".env",
-        ".devcontainer/gh.env",
-        ".cursor/codebase-rag.env",
-        ".cursor/mcp.json",
-        ".DS_Store",
-        "logs"
-    ];
-    /** Load an existing .gitignore so `decohere add api` appends instead of replacing. */ static fromFile(absolutePath) {
-        const gitignore = new Gitignore();
-        gitignore.ignoreList = (0, _nodefs.readFileSync)(absolutePath, "utf8").replace(/\n+$/, "").split("\n");
-        return gitignore;
-    }
-    add(...patterns) {
-        for (const pattern of patterns){
-            if (!this.ignoreList.includes(pattern)) {
-                this.ignoreList.push(pattern);
-            }
-        }
-        return this;
-    }
-    files() {
-        return [
-            {
-                filePath: ".gitignore",
-                content: `${this.ignoreList.join("\n")}\n`
-            }
-        ];
-    }
-}

package/commonjs/src/models/launch-json.model.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "LaunchJson", {
-    enumerable: true,
-    get: function() {
-        return LaunchJson;
-    }
-});
-const _const = require("./const.js");
-class LaunchJson {
-    apiNames;
-    key = _const.WELL_KNOWN_FILES.LAUNCH_JSON;
-    constructor(apiNames = [
-        "api"
-    ]){
-        this.apiNames = apiNames;
-    }
-    files() {
-        const configurations = [
-            {
-                name: "Build",
-                type: "node",
-                request: "launch",
-                runtimeExecutable: "pnpm",
-                runtimeArgs: [
-                    "build"
-                ],
-                console: "integratedTerminal",
-                cwd: "${workspaceFolder}"
-            }
-        ];
-        const first = this.apiNames[0] ?? "api";
-        const defaultDevArgs = first === "api" && this.apiNames.length === 1 ? [
-            "dev"
-        ] : [
-            "run",
-            `dev:${first}`
-        ];
-        configurations.push(serveConfig("Serve / Dev", defaultDevArgs));
-        for (const apiName of this.apiNames){
-            if (apiName === first && this.apiNames.length === 1 && apiName === "api") continue;
-            configurations.push(serveConfig(`Serve / Dev (${apiName})`, [
-                "run",
-                `dev:${apiName}`
-            ]));
-        }
-        return [
-            {
-                filePath: ".vscode/launch.json",
-                content: JSON.stringify({
-                    version: "0.2.0",
-                    configurations
-                }, null, 2)
-            }
-        ];
-    }
-}
-function serveConfig(name, runtimeArgs) {
-    return {
-        name,
-        type: "node",
-        request: "launch",
-        runtimeExecutable: "pnpm",
-        runtimeArgs,
-        console: "integratedTerminal",
-        cwd: "${workspaceFolder}"
-    };
-}

package/commonjs/src/models/package-json.model.js

@@ -1,156 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get PackageJson () {
-        return PackageJson;
-    },
-    get packageScript () {
-        return packageScript;
-    },
-    get sortStringMap () {
-        return sortStringMap;
-    }
-});
-const _nodefs = require("node:fs");
-const _version = require("../version.js");
-const _const = require("../webapi/const.js");
-const _const1 = require("./const.js");
-class PackageJson {
-    name;
-    key = _const1.WELL_KNOWN_FILES.PACKAGE_JSON;
-    _dependencies;
-    _devDependencies;
-    _scripts;
-    _version = "0.0.1";
-    _type = "module";
-    _rest = {};
-    constructor(name, options){
-        this.name = name;
-        const apiNames = options?.apiNames ?? [
-            _const.DEFAULT_WEBAPI_NAME
-        ];
-        const first = apiNames[0] ?? _const.DEFAULT_WEBAPI_NAME;
-        const startEntry = options?.startEntry ?? (0, _const.webapiReleaseEntry)(first);
-        const workspaceName = options?.workspaceName ?? stripApiSuffix(name);
-        const namedOrMany = apiNames.length > 1 || first !== _const.DEFAULT_WEBAPI_NAME;
-        this._scripts = {
-            build: "forge build --configuration release",
-            "build:watch": "forge build --watch",
-            // Release build, then `.package/` in every API (what its Dockerfile copies).
-            package: "pnpm run build && forge package",
-            start: `node ${startEntry}`,
-            dev: namedOrMany ? fluxDevScript(workspaceName, first, (0, _const.webapiPort)(0)) : "flux serve --env-file-if-exists .env",
-            "lint:check": "biome check .",
-            typecheck: "forge typecheck",
-            test: "vitest run --passWithNoTests"
-        };
-        for (const [index, apiName] of apiNames.entries()){
-            this._scripts[`start:${apiName}`] = `node ${(0, _const.webapiReleaseEntry)(apiName)}`;
-            this._scripts[`package:${apiName}`] = packageScript(workspaceName, apiName);
-            this._scripts[`dev:${apiName}`] = fluxDevScript(workspaceName, apiName, (0, _const.webapiPort)(index));
-        }
-        this._dependencies = {
-            "@decohere/http": _version.CREATE_VERSION,
-            "@decohere/crucible": _version.CREATE_VERSION,
-            "@decohere/core": _version.CREATE_VERSION,
-            "@decohere/config": _version.CREATE_VERSION,
-            "@decohere/scribe": _version.CREATE_VERSION,
-            "@decohere/scribe-pino": _version.CREATE_VERSION,
-            "pino-pretty": "^13.0.0",
-            "pino-roll": "^4.0.0"
-        };
-        this._devDependencies = {
-            "@decohere/forge": _version.CREATE_VERSION,
-            "@decohere/cli": _version.CREATE_VERSION,
-            typescript: "^6.0.3",
-            "@biomejs/biome": "^2.0.0",
-            vitest: "^3.2.4"
-        };
-    }
-    /** Load an existing root package.json so `webapi add` can merge scripts/deps. */ static fromFile(filePath) {
-        const raw = JSON.parse((0, _nodefs.readFileSync)(filePath, "utf8"));
-        const pkg = new PackageJson(typeof raw.name === "string" ? raw.name : "app", {
-            apiNames: []
-        });
-        pkg._version = typeof raw.version === "string" ? raw.version : "0.0.1";
-        pkg._type = typeof raw.type === "string" ? raw.type : "module";
-        pkg._scripts = {
-            ...asStringMap(raw.scripts)
-        };
-        pkg._dependencies = {
-            ...asStringMap(raw.dependencies)
-        };
-        pkg._devDependencies = {
-            ...asStringMap(raw.devDependencies)
-        };
-        const reserved = new Set([
-            "name",
-            "version",
-            "type",
-            "scripts",
-            "dependencies",
-            "devDependencies"
-        ]);
-        pkg._rest = Object.fromEntries(Object.entries(raw).filter(([key])=>!reserved.has(key)));
-        return pkg;
-    }
-    addDependency(name, version) {
-        this._dependencies[name] = version;
-        return this;
-    }
-    addDevDependency(name, version) {
-        this._devDependencies[name] = version;
-        return this;
-    }
-    addScript(name, command) {
-        this._scripts[name] = command;
-        return this;
-    }
-    hasScript(name) {
-        return typeof this._scripts[name] === "string";
-    }
-    files() {
-        return [
-            {
-                filePath: "package.json",
-                content: JSON.stringify({
-                    name: this.name,
-                    version: this._version,
-                    type: this._type,
-                    ...this._rest,
-                    scripts: this._scripts,
-                    dependencies: sortStringMap(this._dependencies),
-                    devDependencies: sortStringMap(this._devDependencies)
-                }, null, 2)
-            }
-        ];
-    }
-}
-function stripApiSuffix(name) {
-    return name.endsWith(".api") ? name.slice(0, -".api".length) : name;
-}
-function asStringMap(value) {
-    if (value == null || typeof value !== "object") return {};
-    const result = {};
-    for (const [key, entry] of Object.entries(value)){
-        if (typeof entry === "string") result[key] = entry;
-    }
-    return result;
-}
-function sortStringMap(map) {
-    return Object.fromEntries(Object.entries(map).sort(([left], [right])=>left.localeCompare(right, "en")));
-}
-function packageScript(workspaceName, apiName) {
-    return `pnpm run build && forge package ${(0, _const.webapiPackageName)(workspaceName, apiName)}`;
-}
-function fluxDevScript(workspaceName, apiName, port) {
-    return `PORT=${port} flux serve --env-file-if-exists .env --project ${(0, _const.webapiPackageName)(workspaceName, apiName)}`;
-}