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

package/tests/seed-devcontainer-templates.ts

@@ -0,0 +1,40 @@
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { vol } from "memfs";
+import { vi } from "vitest";
+import {
+	codebaseRagMcpSourcePath,
+	devcontainerTemplatePath,
+} from "../src/webapi/devcontainer/host-scripts.js";
+
+const realFs = await vi.importActual<typeof import("node:fs")>("node:fs");
+
+const TEMPLATE_NAMES = [
+	"initialize.sh",
+	"post-create.sh",
+	"post-start.sh",
+	"tty-prompt.sh",
+	"codebase-rag.env.example",
+] as const;
+
+/** Copy Dev Container templates into memfs so scaffold can read them after `resetMemfs`. */
+export function seedDevcontainerTemplates(): void {
+	const files = [
+		...TEMPLATE_NAMES.map((name) => ({
+			mem: devcontainerTemplatePath(name),
+			disk: fileURLToPath(
+				new URL(`../src/webapi/devcontainer/templates/${name}`, import.meta.url),
+			),
+		})),
+		{
+			mem: codebaseRagMcpSourcePath(),
+			disk: fileURLToPath(
+				new URL("../src/webapi/devcontainer/codebase-rag-mcp.ts", import.meta.url),
+			),
+		},
+	];
+	for (const { mem, disk } of files) {
+		vol.mkdirSync(dirname(mem), { recursive: true });
+		vol.writeFileSync(mem, realFs.readFileSync(disk, "utf8"));
+	}
+}

package/tests/webapi/devcontainer/codebase-rag-mcp.spec.ts

@@ -0,0 +1,96 @@
+import { resetMemfs } from "@decohere/nexus/testing";
+import { vol } from "memfs";
+import { beforeEach, describe, expect, it } from "vitest";
+import { codebaseRagMcp } from "../../../src/webapi/devcontainer/codebase-rag-mcp.js";
+
+const HOST_MCP = JSON.stringify({
+	mcpServers: {
+		other: { command: "echo" },
+		"codebase-rag": {
+			url: "https://rag.example.com/mcp",
+			headers: { Authorization: "Bearer secret-token" },
+		},
+	},
+});
+
+describe("codebaseRagMcp", () => {
+	beforeEach(() => {
+		resetMemfs();
+	});
+	it("reads HTTP URL and bearer token from host mcp.json", () => {
+		expect(codebaseRagMcp.seedFromMcpJson(HOST_MCP)).toEqual({
+			url: "https://rag.example.com/mcp",
+			token: "secret-token",
+		});
+	});
+
+	it("returns null when codebase-rag is missing or incomplete", () => {
+		expect(codebaseRagMcp.seedFromMcpJson("{}")).toBeNull();
+		expect(
+			codebaseRagMcp.seedFromMcpJson(
+				JSON.stringify({ mcpServers: { "codebase-rag": { url: "https://x/mcp" } } }),
+			),
+		).toBeNull();
+	});
+
+	it("merges codebase-rag into mcp.json without dropping other servers", () => {
+		vol.fromJSON({
+			"/tmp/cursor/mcp.json": JSON.stringify({ mcpServers: { keep: { url: "stdio" } } }),
+		});
+
+		const result = codebaseRagMcp.mergeIntoMcpJson({
+			mcpPath: "/tmp/cursor/mcp.json",
+			url: "https://rag.example.com/mcp",
+			token: "secret-token",
+			hostRoot: "/host/repo",
+		});
+
+		expect(result.path).toBe("/tmp/cursor/mcp.json");
+		const written = JSON.parse(vol.readFileSync("/tmp/cursor/mcp.json", "utf8") as string) as {
+			mcpServers: Record<string, { url?: string; headers?: Record<string, string> }>;
+		};
+		expect(written.mcpServers.keep).toEqual({ url: "stdio" });
+		expect(written.mcpServers["codebase-rag"]).toEqual({
+			url: "https://rag.example.com/mcp",
+			headers: {
+				Authorization: "Bearer secret-token",
+				"X-Codebase-Root": "/host/repo",
+			},
+		});
+	});
+
+	it("seed-print writes url and token on separate lines", () => {
+		vol.fromJSON({ "/tmp/host-mcp.json": HOST_MCP });
+		const lines: string[] = [];
+		const original = console.log;
+		console.log = (msg?: unknown) => {
+			lines.push(String(msg));
+		};
+		try {
+			expect(codebaseRagMcp.main(["seed-print", "/tmp/host-mcp.json"])).toBe(0);
+		} finally {
+			console.log = original;
+		}
+		expect(lines).toEqual(["https://rag.example.com/mcp", "secret-token"]);
+	});
+
+	it("mergeFromEnv reads and writes under the workspace .cursor directory", () => {
+		vol.fromJSON({
+			"/repo/.cursor/codebase-rag.env":
+				"CODEBASE_RAG_MCP_URL=https://rag.example.com/mcp\nCODEBASE_RAG_MCP_TOKEN=secret-token\n",
+		});
+
+		expect(
+			codebaseRagMcp.mergeFromEnv({
+				CODEBASE_RAG_WORKSPACE: "/repo",
+			}),
+		).toBe(0);
+
+		const written = JSON.parse(
+			vol.readFileSync("/repo/.cursor/mcp.json", "utf8") as string,
+		) as {
+			mcpServers: Record<string, { url?: string }>;
+		};
+		expect(written.mcpServers["codebase-rag"]?.url).toBe("https://rag.example.com/mcp");
+	});
+});

package/LICENSE

@@ -1,15 +0,0 @@
-ISC License
-
-Copyright (c) 2025-2026 Typesmiths
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/commonjs/src/add-api.action.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "AddApiAction", {
-    enumerable: true,
-    get: function() {
-        return AddApiAction;
-    }
-});
-const _decorators = require("@decohere/crucible/decorators");
-const _cli = require("@decohere/devkit/cli");
-const _clioptions = require("./webapi/cli-options.js");
-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;
-}
-class AddApiAction {
-    async run(options) {
-        const name = options.apiName;
-        if (name == null || name === "") {
-            return _cli.ActionResponse.Error("api", "API name is required");
-        }
-        await (0, _clioptions.runScaffoldApi)((0, _clioptions.toApiOptions)(undefined, options, {
-            names: [
-                name
-            ],
-            add: true
-        }));
-        return _cli.ActionResponse.Success("api");
-    }
-}
-AddApiAction = _ts_decorate([
-    (0, _decorators.injectable)()
-], AddApiAction);

package/commonjs/src/add-api.command.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "AddApiCommand", {
-    enumerable: true,
-    get: function() {
-        return AddApiCommand;
-    }
-});
-const _cli = require("@decohere/devkit/cli");
-const _addapiaction = require("./add-api.action.js");
-const _clioptions = require("./webapi/cli-options.js");
-class AddApiCommand extends _cli.DecohereCommand {
-    get actions() {
-        return [
-            _addapiaction.AddApiAction
-        ];
-    }
-    constructor(name){
-        super(name);
-        this.description("Add an API to an existing Decohere workspace");
-        this.argument("<name>", "API name under projects/");
-        this.option("-d <directory>", "Workspace directory (default: current directory)", ".");
-        (0, _clioptions.addWebapiFeatureOptions)(this);
-    }
-    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("apiName", first);
-            }
-            return fn(opts, cmd);
-        });
-    }
-}

package/commonjs/src/add.command.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "AddCommand", {
-    enumerable: true,
-    get: function() {
-        return AddCommand;
-    }
-});
-const _cli = require("@decohere/devkit/cli");
-class AddCommand extends _cli.DecohereCommand {
-    constructor(commands, handler){
-        super(AddCommand);
-        this.description("Add to an existing Decohere workspace");
-        this.exitOverride();
-        this.registerSubcommand(commands, handler);
-    }
-    run(_actions, _options) {
-        return this.help();
-    }
-}

package/commonjs/src/add.module.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "AddModule", {
-    enumerable: true,
-    get: function() {
-        return AddModule;
-    }
-});
-const _cli = require("@decohere/devkit/cli");
-const _addcommand = require("./add.command.js");
-const _addapiaction = require("./add-api.action.js");
-const _addapicommand = require("./add-api.command.js");
-class AddModule extends _cli.ModuleManifest {
-    id = "add";
-    command = _addcommand.AddCommand;
-    commands = {
-        api: _addapicommand.AddApiCommand
-    };
-    actions = {
-        api: _addapiaction.AddApiAction
-    };
-}

package/commonjs/src/auth0-configure.action.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Auth0ConfigureAction", {
-    enumerable: true,
-    get: function() {
-        return Auth0ConfigureAction;
-    }
-});
-const _decorators = require("@decohere/crucible/decorators");
-const _cli = require("@decohere/devkit/cli");
-const _auth0commands = require("./webapi/auth0-commands.js");
-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;
-}
-class Auth0ConfigureAction {
-    async run(options) {
-        (0, _auth0commands.runAuth0Configure)(typeof options.d === "string" ? options.d : ".");
-        return _cli.ActionResponse.Success("configure");
-    }
-}
-Auth0ConfigureAction = _ts_decorate([
-    (0, _decorators.injectable)()
-], Auth0ConfigureAction);

package/commonjs/src/auth0-configure.command.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Auth0ConfigureCommand", {
-    enumerable: true,
-    get: function() {
-        return Auth0ConfigureCommand;
-    }
-});
-const _cli = require("@decohere/devkit/cli");
-const _auth0configureaction = require("./auth0-configure.action.js");
-class Auth0ConfigureCommand extends _cli.DecohereCommand {
-    get actions() {
-        return [
-            _auth0configureaction.Auth0ConfigureAction
-        ];
-    }
-    constructor(name){
-        super(name);
-        this.description("Update Auth0 API permissions and Postman SPA from @Authorize in this workspace");
-        this.option("-d <directory>", "Workspace directory (default: current directory)", ".");
-    }
-}

package/commonjs/src/auth0-login.action.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Auth0LoginAction", {
-    enumerable: true,
-    get: function() {
-        return Auth0LoginAction;
-    }
-});
-const _decorators = require("@decohere/crucible/decorators");
-const _cli = require("@decohere/devkit/cli");
-const _auth0commands = require("./webapi/auth0-commands.js");
-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;
-}
-class Auth0LoginAction {
-    async run() {
-        (0, _auth0commands.runAuth0Login)();
-        return _cli.ActionResponse.Success("login");
-    }
-}
-Auth0LoginAction = _ts_decorate([
-    (0, _decorators.injectable)()
-], Auth0LoginAction);

package/commonjs/src/auth0-login.command.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Auth0LoginCommand", {
-    enumerable: true,
-    get: function() {
-        return Auth0LoginCommand;
-    }
-});
-const _cli = require("@decohere/devkit/cli");
-const _auth0loginaction = require("./auth0-login.action.js");
-class Auth0LoginCommand extends _cli.DecohereCommand {
-    get actions() {
-        return [
-            _auth0loginaction.Auth0LoginAction
-        ];
-    }
-    constructor(name){
-        super(name);
-        this.description("Authenticate the Auth0 CLI (device URL; tokens persist on the host)");
-    }
-}

package/commonjs/src/auth0.command.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Auth0Command", {
-    enumerable: true,
-    get: function() {
-        return Auth0Command;
-    }
-});
-const _cli = require("@decohere/devkit/cli");
-class Auth0Command extends _cli.DecohereCommand {
-    constructor(commands, handler){
-        super(Auth0Command);
-        this.description("Log in to Auth0 and update a scaffolded client");
-        this.exitOverride();
-        this.registerSubcommand(commands, handler);
-    }
-    run(_actions, _options) {
-        return this.help();
-    }
-}

package/commonjs/src/auth0.module.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Auth0Module", {
-    enumerable: true,
-    get: function() {
-        return Auth0Module;
-    }
-});
-const _cli = require("@decohere/devkit/cli");
-const _auth0command = require("./auth0.command.js");
-const _auth0configureaction = require("./auth0-configure.action.js");
-const _auth0configurecommand = require("./auth0-configure.command.js");
-const _auth0loginaction = require("./auth0-login.action.js");
-const _auth0logincommand = require("./auth0-login.command.js");
-class Auth0Module extends _cli.ModuleManifest {
-    id = "auth0";
-    command = _auth0command.Auth0Command;
-    commands = {
-        login: _auth0logincommand.Auth0LoginCommand,
-        configure: _auth0configurecommand.Auth0ConfigureCommand
-    };
-    actions = {
-        login: _auth0loginaction.Auth0LoginAction,
-        configure: _auth0configureaction.Auth0ConfigureAction
-    };
-}

package/commonjs/src/cli.js

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _program = require("./program.js");
-// Exit as soon as the command is done, without waiting for handles it left open.
-process.exit(await (0, _program.runCli)());

package/commonjs/src/create.command.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "CreateCommand", {
-    enumerable: true,
-    get: function() {
-        return CreateCommand;
-    }
-});
-const _cli = require("@decohere/devkit/cli");
-class CreateCommand extends _cli.DecohereCommand {
-    constructor(commands, handler){
-        super(CreateCommand);
-        this.description("Create a new Decohere workspace");
-        this.exitOverride();
-        this.registerSubcommand(commands, handler);
-    }
-    run(_actions, _options) {
-        return this.help();
-    }
-}

package/commonjs/src/create.module.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "CreateModule", {
-    enumerable: true,
-    get: function() {
-        return CreateModule;
-    }
-});
-const _cli = require("@decohere/devkit/cli");
-const _createcommand = require("./create.command.js");
-const _webapiaction = require("./webapi.action.js");
-const _webapicommand = require("./webapi.command.js");
-class CreateModule extends _cli.ModuleManifest {
-    id = "create";
-    command = _createcommand.CreateCommand;
-    commands = {
-        webapi: _webapicommand.WebapiCommand
-    };
-    actions = {
-        webapi: _webapiaction.WebapiAction
-    };
-}

package/commonjs/src/domain/prompt.js

@@ -1,62 +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 ask () {
-        return ask;
-    },
-    get closePrompt () {
-        return closePrompt;
-    },
-    get pick () {
-        return pick;
-    }
-});
-const _nodereadline = require("node:readline");
-// readline/promises rl.question() has a race condition with piped (non-TTY) stdin
-// in Node ≥ 22: after the first line is read, stdin emits 'end', readline closes,
-// and all subsequent question() calls resolve to "".
-// Fix: use the async-iterator API, which buffers all lines before the close event fires.
-let _rl = null;
-let _lines = null;
-function getLines() {
-    if (_lines == null) {
-        _rl = (0, _nodereadline.createInterface)({
-            input: process.stdin,
-            terminal: false
-        });
-        _lines = _rl[Symbol.asyncIterator]();
-    }
-    return _lines;
-}
-function closePrompt() {
-    _rl?.close();
-    _rl = null;
-    _lines = null;
-}
-async function readLine(prompt) {
-    process.stdout.write(prompt);
-    const { value, done } = await getLines().next();
-    return done ? "" : value.trim();
-}
-async function ask(question, fallback = "") {
-    const answer = await readLine(question);
-    return answer || fallback;
-}
-async function pick(label, items, display) {
-    console.log(label.trimEnd());
-    for (const [i, item] of items.entries()){
-        console.log(`    ${i + 1}. ${display(item)}`);
-    }
-    const answer = await readLine("  > ");
-    const idx = Number.parseInt(answer, 10);
-    if (Number.isNaN(idx) || idx < 1 || idx > items.length) return null;
-    return items[idx - 1];
-}

package/commonjs/src/index.js

@@ -1,48 +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 AddApiAction () {
-        return _addapiaction.AddApiAction;
-    },
-    get AddModule () {
-        return _addmodule.AddModule;
-    },
-    get Auth0ConfigureAction () {
-        return _auth0configureaction.Auth0ConfigureAction;
-    },
-    get Auth0LoginAction () {
-        return _auth0loginaction.Auth0LoginAction;
-    },
-    get Auth0Module () {
-        return _auth0module.Auth0Module;
-    },
-    get CreateModule () {
-        return _createmodule.CreateModule;
-    },
-    get WebapiAction () {
-        return _webapiaction.WebapiAction;
-    },
-    get runCli () {
-        return _program.runCli;
-    },
-    get scaffoldApi () {
-        return _createapi.scaffoldApi;
-    }
-});
-const _addmodule = require("./add.module.js");
-const _addapiaction = require("./add-api.action.js");
-const _auth0module = require("./auth0.module.js");
-const _auth0configureaction = require("./auth0-configure.action.js");
-const _auth0loginaction = require("./auth0-login.action.js");
-const _createmodule = require("./create.module.js");
-const _program = require("./program.js");
-const _createapi = require("./webapi/create-api.js");
-const _webapiaction = require("./webapi.action.js");