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

package/commonjs/src/webapi/create-api.js

@@ -1,265 +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 WEBAPI_PROJECT_DIR () {
-        return _const1.WEBAPI_PROJECT_DIR;
-    },
-    get WEBAPI_RELEASE_ENTRY () {
-        return _const1.WEBAPI_RELEASE_ENTRY;
-    },
-    get scaffoldApi () {
-        return scaffoldApi;
-    }
-});
-const _nodefs = require("node:fs");
-const _nodepath = require("node:path");
-const _composemodel = require("../models/compose.model.js");
-const _configyamlmodel = require("../models/config-yaml.model.js");
-const _const = require("../models/const.js");
-const _devcontainermodel = require("../models/dev-container.model.js");
-const _dockerimagemodel = require("../models/docker-image.model.js");
-const _envfilemodel = require("../models/env-file.model.js");
-const _gitignoremodel = require("../models/gitignore.model.js");
-const _launchjsonmodel = require("../models/launch-json.model.js");
-const _packagejsonmodel = require("../models/package-json.model.js");
-const _projectmodel = require("../models/project.model.js");
-const _tsconfigmodel = require("../models/tsconfig.model.js");
-const _vitestconfigmodel = require("../models/vitest-config.model.js");
-const _vscodesettingsmodel = require("../models/vscode-settings.model.js");
-const _scaffoldservice = require("../services/scaffold.service.js");
-const _apiname = require("./api-name.js");
-const _const1 = require("./const.js");
-const _hostscripts = require("./devcontainer/host-scripts.js");
-const _authfeature = require("./features/auth.feature.js");
-const _databasefeature = require("./features/database.feature.js");
-const _finalizefeature = require("./features/finalize.feature.js");
-const _postmanfeature = require("./features/postman.feature.js");
-const _apipackagejsonmodel = require("./models/api-package-json.model.js");
-const _controllersourcefilemodel = require("./models/controller-source-file.model.js");
-const _githubcimodel = require("./models/github-ci.model.js");
-const _mainsourcefilemodel = require("./models/main-source-file.model.js");
-const _productiondockerfilemodel = require("./models/production-dockerfile.model.js");
-const _samplefilesmodel = require("./models/sample-files.model.js");
-const _webapiimagemodel = require("./models/webapi-image.model.js");
-const features = [
-    _databasefeature.DatabaseFeature,
-    _authfeature.AuthFeature,
-    _postmanfeature.PostmanFeature,
-    _finalizefeature.FinalizeFeature
-];
-async function scaffoldApi(cliOptions) {
-    const targetDir = (0, _nodepath.resolve)(cliOptions.d ?? ".");
-    const projectName = cliOptions.projectName?.trim() || process.env.DECOHERE_PROJECT_NAME?.trim() || (0, _nodepath.basename)(targetDir);
-    const names = (0, _apiname.parseApiNames)(cliOptions.names);
-    const workspace = cliOptions.add ? createAddWorkspace(targetDir, projectName, names) : createWorkspace(targetDir, projectName, names);
-    await _scaffoldservice.ScaffoldService.scaffold(workspace, {
-        ...cliOptions,
-        names
-    }, features);
-}
-function createWorkspace(targetDir, projectName, apiNames) {
-    const monoRepo = new _projectmodel.MonoRepoScaffold();
-    monoRepo.targetDir = targetDir;
-    monoRepo.setName(projectName);
-    const name = monoRepo.name;
-    // Project-named root so Cursor Agents (and other tools) label the workspace by name.
-    const workspaceRoot = `/${name}`;
-    const compose = new _composemodel.DockerCompose().setProjectName(name).addHeaderComment("Merge .cursor/mcp.json in the service command. postStartCommand runs after Cursor's first MCP snapshot.").addNetwork(name, {
-        name: `samples-${name}`
-    }).addService("devcontainer", {
-        build: ".",
-        volumes: [
-            // Repo bind in Compose (survives CLI recreates; Cursor-only mounts do not).
-            `..:${workspaceRoot}`,
-            // Workspace-local (created by initialize.sh as the host user).
-            // Do NOT bind ${HOME}/.npm/... — Docker creates missing host paths as root.
-            "./npm-auth:/home/node/.npm-config",
-            "./gh-auth:/home/node/.config/gh",
-            `webapi-node-modules:${workspaceRoot}/node_modules`,
-            // Named volume (not a Cursor-only mount) so CLI recreates keep Up-arrow history.
-            `${_dockerimagemodel.commandHistory.volumeName}:${_dockerimagemodel.commandHistory.dir}`
-        ],
-        env_file: [
-            "./gh.env"
-        ],
-        environment: {
-            NPM_CONFIG_USERCONFIG: "/home/node/.npm-config/.npmrc"
-        },
-        command: `'bash -c "CODEBASE_RAG_WORKSPACE=${workspaceRoot} node --experimental-strip-types ${workspaceRoot}/.devcontainer/codebase-rag-mcp.ts merge || true && exec sleep infinity"'`,
-        networks: [
-            name
-        ]
-    }).addVolume("webapi-node-modules").addVolume(_dockerimagemodel.commandHistory.volumeName);
-    const installCmd = "bash .devcontainer/post-create.sh";
-    const devContainer = new _devcontainermodel.DevContainer().setWorkspaceFolder(workspaceRoot).addExtension("biomejs.biome", "vitest.explorer").setInitializeCommand("bash .devcontainer/initialize.sh").setPostCreateCommand(installCmd).setUpdateContentCommand(installCmd).setPostStartCommand("bash .devcontainer/post-start.sh").useCompose();
-    forwardApiPorts(devContainer, apiNames, 0);
-    // Workspace-level models (repo root)
-    monoRepo.addModel(compose);
-    monoRepo.addModel(devContainer);
-    const appDevImage = new _webapiimagemodel.WebapiDevContainer();
-    appDevImage.addLayer((0, _dockerimagemodel.withWorkspaceNodeModulesOwnership)({
-        workspaceDir: workspaceRoot
-    }));
-    monoRepo.addModel(appDevImage);
-    monoRepo.addModel(new _productiondockerfilemodel.WebapiProductionDockerfile(apiNames));
-    monoRepo.addModel(new _githubcimodel.GithubCiWorkflows());
-    monoRepo.addModel(new _vscodesettingsmodel.VSCodeSettings(name));
-    monoRepo.addModel(new _launchjsonmodel.LaunchJson(apiNames));
-    monoRepo.addModel(new _tsconfigmodel.TsConfig());
-    monoRepo.addModel(new _vitestconfigmodel.VitestConfig());
-    monoRepo.addModel(new _packagejsonmodel.PackageJson(`${name}.api`, {
-        apiNames,
-        workspaceName: name
-    }));
-    monoRepo.addModel(new _configyamlmodel.ConfigYaml(_const.WELL_KNOWN_FILES.CONFIG_YAML, "config/config.yaml", ""));
-    monoRepo.addModel(new _configyamlmodel.ConfigYaml(_const.WELL_KNOWN_FILES.CONFIG_DEV_YAML, "config/config.dev.yaml", ""));
-    monoRepo.addModel(new _gitignoremodel.Gitignore());
-    monoRepo.addModel(new _envfilemodel.EnvFile());
-    monoRepo.addFile(new _hostscripts.DevContainerHostScripts());
-    // Biome formatter/linter config
-    monoRepo.addFile({
-        files: ()=>[
-                {
-                    filePath: "biome.json",
-                    content: JSON.stringify({
-                        $schema: "https://biomejs.dev/schemas/2.0.0/schema.json",
-                        files: {
-                            includes: [
-                                "**/*.ts",
-                                "**/*.js",
-                                "**/*.json",
-                                "**/*.yml",
-                                "**/*.yaml"
-                            ]
-                        },
-                        assist: {
-                            actions: {
-                                source: {
-                                    organizeImports: "on"
-                                }
-                            }
-                        },
-                        vcs: {
-                            enabled: true,
-                            clientKind: "git",
-                            useIgnoreFile: true
-                        },
-                        formatter: {
-                            enabled: true,
-                            formatWithErrors: true,
-                            indentStyle: "tab",
-                            lineWidth: 95
-                        },
-                        javascript: {
-                            parser: {
-                                unsafeParameterDecoratorsEnabled: true
-                            }
-                        },
-                        linter: {
-                            rules: {
-                                style: {
-                                    useConsistentMemberAccessibility: {
-                                        level: "error",
-                                        options: {
-                                            accessibility: "explicit"
-                                        }
-                                    }
-                                }
-                            }
-                        },
-                        overrides: [
-                            {
-                                includes: [
-                                    "**/*.json"
-                                ],
-                                formatter: {
-                                    indentStyle: "space",
-                                    indentWidth: 2
-                                }
-                            }
-                        ]
-                    }, null, 2)
-                }
-            ]
-    });
-    for (const apiName of apiNames){
-        addApiProject(monoRepo, name, apiName);
-    }
-    return monoRepo;
-}
-function createAddWorkspace(targetDir, projectName, apiNames) {
-    if (!(0, _apiname.isDecohereWorkspace)(targetDir)) {
-        throw new _apiname.CreateCliError(`Not a Decohere workspace: ${targetDir}. Scaffold one first with \`npx @decohere/create webapi\`.`);
-    }
-    const existing = (0, _apiname.listExistingApiNames)(targetDir);
-    for (const apiName of apiNames){
-        if (existing.includes(apiName)) {
-            throw new _apiname.CreateCliError(`API "${apiName}" already exists at ${(0, _const1.webapiProjectDir)(apiName)}.`);
-        }
-    }
-    const monoRepo = new _projectmodel.MonoRepoScaffold();
-    monoRepo.targetDir = targetDir;
-    monoRepo.setName(projectName);
-    const name = monoRepo.name;
-    const pkg = _packagejsonmodel.PackageJson.fromFile((0, _nodepath.join)(targetDir, "package.json"));
-    monoRepo.addModel(pkg);
-    monoRepo.addModel((0, _nodefs.existsSync)((0, _nodepath.join)(targetDir, ".env")) ? _envfilemodel.EnvFile.fromFile((0, _nodepath.join)(targetDir, ".env")) : new _envfilemodel.EnvFile());
-    monoRepo.addModel((0, _nodefs.existsSync)((0, _nodepath.join)(targetDir, "config/config.yaml")) ? _configyamlmodel.ConfigYaml.fromFile(_const.WELL_KNOWN_FILES.CONFIG_YAML, "config/config.yaml", (0, _nodepath.join)(targetDir, "config/config.yaml")) : new _configyamlmodel.ConfigYaml(_const.WELL_KNOWN_FILES.CONFIG_YAML, "config/config.yaml", ""));
-    monoRepo.addModel((0, _nodefs.existsSync)((0, _nodepath.join)(targetDir, "config/config.dev.yaml")) ? _configyamlmodel.ConfigYaml.fromFile(_const.WELL_KNOWN_FILES.CONFIG_DEV_YAML, "config/config.dev.yaml", (0, _nodepath.join)(targetDir, "config/config.dev.yaml")) : new _configyamlmodel.ConfigYaml(_const.WELL_KNOWN_FILES.CONFIG_DEV_YAML, "config/config.dev.yaml", ""));
-    // Load the workspace files features merge into, so e.g. --database on a workspace
-    // created without one adds the Postgres service instead of only the db:* scripts.
-    const compose = loadIfExists(targetDir, ".devcontainer/docker-compose.yml", (path)=>_composemodel.DockerCompose.fromFile(path));
-    if (compose) monoRepo.addModel(compose);
-    const devContainer = loadIfExists(targetDir, ".devcontainer/devcontainer.json", (path)=>_devcontainermodel.DevContainer.fromFile(path));
-    if (devContainer) {
-        forwardApiPorts(devContainer, apiNames, existing.length);
-        monoRepo.addModel(devContainer);
-    }
-    const devImage = loadIfExists(targetDir, ".devcontainer/Dockerfile", (path)=>_dockerimagemodel.DockerfileModel.fromFile(path, ".devcontainer/Dockerfile"));
-    if (devImage) monoRepo.addModel(devImage);
-    const gitignore = loadIfExists(targetDir, ".gitignore", (path)=>_gitignoremodel.Gitignore.fromFile(path));
-    if (gitignore) monoRepo.addModel(gitignore);
-    if (!pkg.hasScript("package")) {
-        pkg.addScript("package", "pnpm run build && forge package");
-    }
-    for (const [offset, apiName] of apiNames.entries()){
-        const port = (0, _const1.webapiPort)(existing.length + offset);
-        pkg.addScript(`start:${apiName}`, `node ${(0, _const1.webapiReleaseEntry)(apiName)}`);
-        pkg.addScript(`package:${apiName}`, (0, _packagejsonmodel.packageScript)(name, apiName));
-        pkg.addScript(`dev:${apiName}`, `PORT=${port} flux serve --env-file-if-exists .env --project ${(0, _const1.webapiPackageName)(name, apiName)}`);
-        addApiProject(monoRepo, name, apiName);
-    }
-    monoRepo.addModel(new _productiondockerfilemodel.WebapiProductionDockerfile(apiNames));
-    return monoRepo;
-}
-function addApiProject(monoRepo, workspaceName, apiName) {
-    const apiProject = new _projectmodel.ProjectScaffold((0, _const1.webapiProjectDir)(apiName));
-    apiProject.addModel(new _apipackagejsonmodel.ApiPackageJson(workspaceName, apiName));
-    apiProject.addModel(new _mainsourcefilemodel.MainSourceFile(`${workspaceName}.${apiName}`));
-    apiProject.addModel(new _controllersourcefilemodel.ControllerSourceFile());
-    apiProject.addFile(new _samplefilesmodel.SampleConfigModel());
-    apiProject.addFile(new _samplefilesmodel.SampleServiceModel());
-    monoRepo.addProject(apiProject);
-}
-function forwardApiPorts(devContainer, apiNames, firstIndex) {
-    for (const [offset, apiName] of apiNames.entries()){
-        const port = (0, _const1.webapiPort)(firstIndex + offset);
-        devContainer.forwardPort(port);
-        devContainer.setPortAttributes(port, {
-            label: apiName === _const1.DEFAULT_WEBAPI_NAME ? "API" : apiName,
-            requireLocalPort: true
-        });
-    }
-}
-function loadIfExists(targetDir, relativePath, load) {
-    const absolutePath = (0, _nodepath.join)(targetDir, relativePath);
-    return (0, _nodefs.existsSync)(absolutePath) ? load(absolutePath) : undefined;
-}

package/commonjs/src/webapi/devcontainer/codebase-rag-mcp.js

@@ -1,164 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "codebaseRagMcp", {
-    enumerable: true,
-    get: function() {
-        return codebaseRagMcp;
-    }
-});
-const _nodefs = require("node:fs");
-const _nodepath = require("node:path");
-const _nodeurl = require("node:url");
-function isRecord(value) {
-    return value != null && typeof value === "object" && !Array.isArray(value);
-}
-function loadDotenv(path, env) {
-    let raw;
-    try {
-        raw = (0, _nodefs.readFileSync)(path, "utf8");
-    } catch  {
-        return;
-    }
-    for (const line of raw.split(/\r?\n/)){
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith("#") || !trimmed.includes("=")) continue;
-        const eq = trimmed.indexOf("=");
-        const key = trimmed.slice(0, eq).trim();
-        const value = trimmed.slice(eq + 1).trim().replace(/^["']|["']$/g, "");
-        if (key && env[key] === undefined) env[key] = value;
-    }
-}
-function seedFromMcpJson(raw) {
-    let data;
-    try {
-        data = JSON.parse(raw);
-    } catch  {
-        return null;
-    }
-    if (!isRecord(data)) return null;
-    const servers = data.mcpServers;
-    if (!isRecord(servers)) return null;
-    const server = servers["codebase-rag"];
-    if (!isRecord(server)) return null;
-    const url = typeof server.url === "string" ? server.url.trim() : "";
-    const headers = isRecord(server.headers) ? server.headers : {};
-    const auth = typeof headers.Authorization === "string" ? headers.Authorization.trim() : "";
-    const token = auth.toLowerCase().startsWith("bearer ") ? auth.slice(7).trim() : "";
-    if (!url.startsWith("http") || token.length === 0) return null;
-    return {
-        url,
-        token
-    };
-}
-function mergeIntoMcpJson(input) {
-    const { mcpPath, url, token, hostRoot } = input;
-    if (!url || !token) {
-        return {
-            skipped: "no URL/token"
-        };
-    }
-    const xRoot = hostRoot || "${workspaceFolder}";
-    (0, _nodefs.mkdirSync)((0, _nodepath.dirname)(mcpPath), {
-        recursive: true
-    });
-    let data = {
-        mcpServers: {}
-    };
-    try {
-        if ((0, _nodefs.statSync)(mcpPath).size > 0) {
-            const loaded = JSON.parse((0, _nodefs.readFileSync)(mcpPath, "utf8"));
-            if (isRecord(loaded)) data = loaded;
-        }
-    } catch (err) {
-        const code = isRecord(err) && typeof err.code === "string" ? err.code : "";
-        if (code !== "ENOENT") {
-            console.log("codebase-rag MCP: existing mcp.json is invalid JSON; replacing rag entry only after backup");
-            (0, _nodefs.renameSync)(mcpPath, `${mcpPath}.bak`);
-        }
-    }
-    const servers = isRecord(data.mcpServers) ? data.mcpServers : {};
-    data.mcpServers = servers;
-    servers["codebase-rag"] = {
-        url,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            "X-Codebase-Root": xRoot
-        }
-    };
-    (0, _nodefs.writeFileSync)(mcpPath, `${JSON.stringify(data, null, 2)}\n`, "utf8");
-    try {
-        (0, _nodefs.chmodSync)(mcpPath, 0o600);
-    } catch  {
-    // memfs and some hosts omit chmod
-    }
-    return {
-        path: mcpPath,
-        root: xRoot
-    };
-}
-function workspaceRoot(env = process.env) {
-    const fromEnv = env.CODEBASE_RAG_WORKSPACE?.trim();
-    if (fromEnv) return fromEnv;
-    // Scaffolded copy lives at <repo>/.devcontainer/codebase-rag-mcp.ts
-    return (0, _nodepath.dirname)((0, _nodepath.dirname)((0, _nodeurl.fileURLToPath)(require("url").pathToFileURL(__filename).toString())));
-}
-function mergeFromEnv(env = process.env) {
-    const root = workspaceRoot(env);
-    const cursorDir = (0, _nodepath.join)(root, ".cursor");
-    loadDotenv((0, _nodepath.join)(cursorDir, "codebase-rag.env"), env);
-    const url = (env.CODEBASE_RAG_MCP_URL ?? "").trim();
-    const token = (env.CODEBASE_RAG_MCP_TOKEN ?? "").trim();
-    const hostRoot = (env.CODEBASE_RAG_MCP_ROOT ?? "").trim() || root;
-    const result = mergeIntoMcpJson({
-        mcpPath: (0, _nodepath.join)(cursorDir, "mcp.json"),
-        url,
-        token,
-        hostRoot
-    });
-    if (result.skipped != null) {
-        console.log(`codebase-rag MCP: skipped (${result.skipped})`);
-        return 0;
-    }
-    console.log(`codebase-rag MCP: wrote ${result.path} url=${url} root=${result.root}`);
-    return 0;
-}
-function seedPrint(mcpPath) {
-    let raw;
-    try {
-        raw = (0, _nodefs.readFileSync)(mcpPath, "utf8");
-    } catch  {
-        return 1;
-    }
-    const creds = seedFromMcpJson(raw);
-    if (creds == null) return 1;
-    console.log(creds.url);
-    console.log(creds.token);
-    return 0;
-}
-function main(argv = process.argv.slice(2)) {
-    const command = argv[0] ?? "merge";
-    if (command === "seed-print") {
-        const mcpPath = argv[1];
-        if (mcpPath == null || mcpPath.length === 0) return 1;
-        return seedPrint(mcpPath);
-    }
-    if (command === "merge") {
-        return mergeFromEnv();
-    }
-    console.error(`codebase-rag MCP: unknown command ${command}`);
-    return 1;
-}
-const invoked = (process.argv[1] ?? "").replaceAll("\\", "/");
-if (invoked.endsWith("/codebase-rag-mcp.ts") || invoked.endsWith("/codebase-rag-mcp.js")) {
-    process.exit(main());
-}
-const codebaseRagMcp = {
-    loadDotenv,
-    seedFromMcpJson,
-    mergeIntoMcpJson,
-    mergeFromEnv,
-    seedPrint,
-    main
-};

package/commonjs/src/webapi/devcontainer/codebase-rag-mcp.ts

@@ -1,182 +0,0 @@
-import {
-	chmodSync,
-	mkdirSync,
-	readFileSync,
-	renameSync,
-	statSync,
-	writeFileSync,
-} from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-export type CodebaseRagCredentials = {
-	url: string;
-	token: string;
-};
-
-export type McpJson = {
-	mcpServers?: Record<string, unknown>;
-	[key: string]: unknown;
-};
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-	return value != null && typeof value === "object" && !Array.isArray(value);
-}
-
-function loadDotenv(path: string, env: NodeJS.ProcessEnv): void {
-	let raw: string;
-	try {
-		raw = readFileSync(path, "utf8");
-	} catch {
-		return;
-	}
-	for (const line of raw.split(/\r?\n/)) {
-		const trimmed = line.trim();
-		if (!trimmed || trimmed.startsWith("#") || !trimmed.includes("=")) continue;
-		const eq = trimmed.indexOf("=");
-		const key = trimmed.slice(0, eq).trim();
-		const value = trimmed
-			.slice(eq + 1)
-			.trim()
-			.replace(/^["']|["']$/g, "");
-		if (key && env[key] === undefined) env[key] = value;
-	}
-}
-
-function seedFromMcpJson(raw: string): CodebaseRagCredentials | null {
-	let data: unknown;
-	try {
-		data = JSON.parse(raw);
-	} catch {
-		return null;
-	}
-	if (!isRecord(data)) return null;
-	const servers = data.mcpServers;
-	if (!isRecord(servers)) return null;
-	const server = servers["codebase-rag"];
-	if (!isRecord(server)) return null;
-	const url = typeof server.url === "string" ? server.url.trim() : "";
-	const headers = isRecord(server.headers) ? server.headers : {};
-	const auth = typeof headers.Authorization === "string" ? headers.Authorization.trim() : "";
-	const token = auth.toLowerCase().startsWith("bearer ") ? auth.slice(7).trim() : "";
-	if (!url.startsWith("http") || token.length === 0) return null;
-	return { url, token };
-}
-
-function mergeIntoMcpJson(input: {
-	mcpPath: string;
-	url: string;
-	token: string;
-	hostRoot: string;
-}): { skipped?: string; path?: string; root?: string } {
-	const { mcpPath, url, token, hostRoot } = input;
-	if (!url || !token) {
-		return { skipped: "no URL/token" };
-	}
-
-	const xRoot = hostRoot || "${workspaceFolder}";
-	mkdirSync(dirname(mcpPath), { recursive: true });
-
-	let data: McpJson = { mcpServers: {} };
-	try {
-		if (statSync(mcpPath).size > 0) {
-			const loaded: unknown = JSON.parse(readFileSync(mcpPath, "utf8"));
-			if (isRecord(loaded)) data = loaded as McpJson;
-		}
-	} catch (err) {
-		const code = isRecord(err) && typeof err.code === "string" ? err.code : "";
-		if (code !== "ENOENT") {
-			console.log(
-				"codebase-rag MCP: existing mcp.json is invalid JSON; replacing rag entry only after backup",
-			);
-			renameSync(mcpPath, `${mcpPath}.bak`);
-		}
-	}
-
-	const servers = isRecord(data.mcpServers) ? data.mcpServers : {};
-	data.mcpServers = servers;
-	servers["codebase-rag"] = {
-		url,
-		headers: {
-			Authorization: `Bearer ${token}`,
-			"X-Codebase-Root": xRoot,
-		},
-	};
-	writeFileSync(mcpPath, `${JSON.stringify(data, null, 2)}\n`, "utf8");
-	try {
-		chmodSync(mcpPath, 0o600);
-	} catch {
-		// memfs and some hosts omit chmod
-	}
-	return { path: mcpPath, root: xRoot };
-}
-
-function workspaceRoot(env: NodeJS.ProcessEnv = process.env): string {
-	const fromEnv = env.CODEBASE_RAG_WORKSPACE?.trim();
-	if (fromEnv) return fromEnv;
-	// Scaffolded copy lives at <repo>/.devcontainer/codebase-rag-mcp.ts
-	return dirname(dirname(fileURLToPath(import.meta.url)));
-}
-
-function mergeFromEnv(env: NodeJS.ProcessEnv = process.env): number {
-	const root = workspaceRoot(env);
-	const cursorDir = join(root, ".cursor");
-	loadDotenv(join(cursorDir, "codebase-rag.env"), env);
-	const url = (env.CODEBASE_RAG_MCP_URL ?? "").trim();
-	const token = (env.CODEBASE_RAG_MCP_TOKEN ?? "").trim();
-	const hostRoot = (env.CODEBASE_RAG_MCP_ROOT ?? "").trim() || root;
-	const result = mergeIntoMcpJson({
-		mcpPath: join(cursorDir, "mcp.json"),
-		url,
-		token,
-		hostRoot,
-	});
-	if (result.skipped != null) {
-		console.log(`codebase-rag MCP: skipped (${result.skipped})`);
-		return 0;
-	}
-	console.log(`codebase-rag MCP: wrote ${result.path} url=${url} root=${result.root}`);
-	return 0;
-}
-
-function seedPrint(mcpPath: string): number {
-	let raw: string;
-	try {
-		raw = readFileSync(mcpPath, "utf8");
-	} catch {
-		return 1;
-	}
-	const creds = seedFromMcpJson(raw);
-	if (creds == null) return 1;
-	console.log(creds.url);
-	console.log(creds.token);
-	return 0;
-}
-
-function main(argv = process.argv.slice(2)): number {
-	const command = argv[0] ?? "merge";
-	if (command === "seed-print") {
-		const mcpPath = argv[1];
-		if (mcpPath == null || mcpPath.length === 0) return 1;
-		return seedPrint(mcpPath);
-	}
-	if (command === "merge") {
-		return mergeFromEnv();
-	}
-	console.error(`codebase-rag MCP: unknown command ${command}`);
-	return 1;
-}
-
-const invoked = (process.argv[1] ?? "").replaceAll("\\", "/");
-if (invoked.endsWith("/codebase-rag-mcp.ts") || invoked.endsWith("/codebase-rag-mcp.js")) {
-	process.exit(main());
-}
-
-export const codebaseRagMcp = {
-	loadDotenv,
-	seedFromMcpJson,
-	mergeIntoMcpJson,
-	mergeFromEnv,
-	seedPrint,
-	main,
-};

package/commonjs/src/webapi/devcontainer/host-scripts.js

@@ -1,50 +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 DevContainerHostScripts () {
-        return DevContainerHostScripts;
-    },
-    get codebaseRagMcpSourcePath () {
-        return codebaseRagMcpSourcePath;
-    },
-    get devcontainerTemplatePath () {
-        return devcontainerTemplatePath;
-    }
-});
-const _nodefs = require("node:fs");
-const _nodeurl = require("node:url");
-const TEMPLATE_FILES = [
-    "initialize.sh",
-    "post-create.sh",
-    "post-start.sh",
-    "tty-prompt.sh",
-    "codebase-rag.env.example"
-];
-function devcontainerTemplatePath(name) {
-    return (0, _nodeurl.fileURLToPath)(new URL(`./templates/${name}`, require("url").pathToFileURL(__filename).toString()));
-}
-function codebaseRagMcpSourcePath() {
-    return (0, _nodeurl.fileURLToPath)(new URL("./codebase-rag-mcp.ts", require("url").pathToFileURL(__filename).toString()));
-}
-class DevContainerHostScripts {
-    files() {
-        return [
-            ...TEMPLATE_FILES.map((name)=>({
-                    filePath: `.devcontainer/${name}`,
-                    content: (0, _nodefs.readFileSync)(devcontainerTemplatePath(name), "utf8")
-                })),
-            {
-                filePath: ".devcontainer/codebase-rag-mcp.ts",
-                content: (0, _nodefs.readFileSync)(codebaseRagMcpSourcePath(), "utf8")
-            }
-        ];
-    }
-}

package/commonjs/src/webapi/devcontainer/templates/codebase-rag.env.example

@@ -1,3 +0,0 @@
-# Optional. Written to .cursor/codebase-rag.env by initialize.sh (gitignored).
-# CODEBASE_RAG_MCP_URL=https://rag.example.com/mcp
-# CODEBASE_RAG_MCP_TOKEN=