gaslighting-engine 0.3.1 → 0.4.0

package/dist/commands/cockpit.js

@@ -3,6 +3,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { createServer } from "node:http";
 import { join, resolve } from "node:path";
 import { platform } from "node:os";
+import { detectAgentRuntimes, getAgentRuntimeAdapter } from "../agent-runtimes/registry.js";
 import { analyze } from "../core/analyze.js";
 import { buildCodexCommand, getDefaultCodexArgs, launchCodexInCurrentTerminal, launchCodexInNewTerminal } from "../core/codexRuntime.js";
 import { pageList, projectPurpose } from "../core/content.js";
@@ -22,6 +23,12 @@ const docFiles = [
     ".gaslighting/MEMORY.md",
     ".gaslighting/AGENT_RUNTIME.md",
     ".gaslighting/PROJECT_CARE.md",
+    ".gaslighting/INDEX.md",
+    ".gaslighting/mission/PROJECT_PURPOSE.md",
+    ".gaslighting/product/PAGE_MAP.md",
+    ".gaslighting/features/core-scope/TASKS.md",
+    ".gaslighting/loops/current-session.json",
+    ".agents/config.json",
 ];
 export async function runCockpit(rawUserRequest = "", options) {
     await openCockpit(rawUserRequest, { ...options, generate: Boolean(rawUserRequest) && options.generate !== false, force: options.force ?? true });
@@ -34,12 +41,16 @@ export function runCodexRun(rawUserRequest, options) {
     const input = makeInput(rawUserRequest, options);
     writeDocs(root, generateDocs(input, root).docs, options.force ?? true, false);
     writeDocs(root, generateCodexInstallDocs(), true, false);
-    printBanner("CODEX RUN");
-    console.log(options.newTerminal ? "Starting Codex in a new terminal." : "Handing this terminal over to Codex.");
-    console.log(buildCodexCommand({ root, request: rawUserRequest, codexArgs: options.codexArgs }));
-    const result = options.newTerminal
+    const runtime = options.runtime ?? "codex";
+    const adapter = getAgentRuntimeAdapter(runtime);
+    printBanner(`${adapter.label.toUpperCase()} RUN`);
+    console.log(options.newTerminal ? `Starting ${adapter.label} in a new terminal.` : `Handing this terminal over to ${adapter.label}.`);
+    console.log(adapter.buildCommand({ root, request: rawUserRequest, runtime, permissionMode: options.permissionMode ?? "auto_review", loopMode: options.loop ?? "off", extraArgs: options.codexArgs }));
+    const result = runtime === "codex" && options.newTerminal
         ? launchCodexInNewTerminal({ root, request: rawUserRequest, codexArgs: options.codexArgs })
-        : launchCodexInCurrentTerminal({ root, request: rawUserRequest, codexArgs: options.codexArgs });
+        : runtime === "codex"
+            ? launchCodexInCurrentTerminal({ root, request: rawUserRequest, codexArgs: options.codexArgs })
+            : adapter.run({ root, request: rawUserRequest, runtime, permissionMode: options.permissionMode ?? "auto_review", loopMode: options.loop ?? "off", extraArgs: options.codexArgs });
     if (!result.ok)
         console.log(result.message);
 }
@@ -70,10 +81,23 @@ async function openCockpit(rawUserRequest, options) {
                 currentRequest = String(body.request || currentRequest);
                 currentInput = makeInput(currentRequest, options);
                 writeDocs(root, generateDocs(currentInput, root).docs, true, false);
-                if (options.newTerminal) {
+                const runtime = options.runtime ?? "codex";
+                if (runtime === "codex" && options.newTerminal) {
                     const result = launchCodexInNewTerminal({ root, request: currentRequest, codexArgs: options.codexArgs });
                     return sendJson(response, { ...result });
                 }
+                if (runtime !== "codex") {
+                    const adapter = getAgentRuntimeAdapter(runtime);
+                    const result = adapter.run({
+                        root,
+                        request: currentRequest,
+                        runtime,
+                        permissionMode: options.permissionMode ?? "auto_review",
+                        loopMode: options.loop ?? "off",
+                        extraArgs: options.codexArgs,
+                    });
+                    return sendJson(response, { ...result });
+                }
                 const commandPreview = launchMessageForCurrentTerminal(root, currentRequest, options);
                 sendJson(response, commandPreview);
                 setTimeout(() => {
@@ -123,8 +147,12 @@ function buildState(root, request, input, options) {
         care: inspectProjectCare(root),
         docsPresent,
         codexArgs: options.codexArgs || getDefaultCodexArgs(),
+        runtime: options.runtime ?? "codex",
+        permissionMode: options.permissionMode ?? "auto_review",
+        loopMode: options.loop ?? "off",
         launchMode: options.newTerminal ? "new_terminal" : "current_terminal",
         codexAvailable: isCommandAvailable("codex"),
+        runtimes: detectAgentRuntimes(),
     };
 }
 function launchMessageForCurrentTerminal(root, request, options) {
@@ -144,6 +172,9 @@ function makeInput(rawUserRequest, options) {
         noTodo: true,
         noShortcut: true,
         force: options.force ?? true,
+        runtime: options.runtime ?? "codex",
+        permissionMode: options.permissionMode ?? "auto_review",
+        loopMode: options.loop ?? "off",
     };
 }
 function readExistingRequest(root) {

package/dist/commands/desktop.js

@@ -0,0 +1,37 @@
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+import { platform } from "node:os";
+import { printBanner } from "../utils/banner.js";
+export async function runDesktop(request = "", options) {
+    const root = resolve(options.path ?? process.cwd());
+    const mainPath = join(dirname(fileURLToPath(import.meta.url)), "..", "desktop", "main.js");
+    printBanner("DESKTOP");
+    if (!existsSync(mainPath)) {
+        console.log("Desktop main file is missing. Run `npm run build` first.");
+        console.log(`Expected: ${mainPath}`);
+        return;
+    }
+    const electronCommand = await resolveElectronCommand(mainPath);
+    const child = spawn(electronCommand.file, electronCommand.args, {
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            GASLIGHTING_DESKTOP_ROOT: root,
+            GASLIGHTING_DESKTOP_REQUEST: request,
+            GASLIGHTING_DESKTOP_DEV: options.dev ? "1" : "",
+        },
+    });
+    child.on("exit", (code) => process.exit(code ?? 0));
+}
+async function resolveElectronCommand(mainPath) {
+    try {
+        const { default: electronPath } = await import("electron");
+        return { file: String(electronPath), args: [mainPath] };
+    }
+    catch {
+        const npmFile = platform() === "win32" ? "npm.cmd" : "npm";
+        return { file: npmFile, args: ["exec", "--yes", "--package", "electron", "--", "electron", mainPath] };
+    }
+}

package/dist/commands/doctor.js

@@ -20,10 +20,17 @@ export function runDoctor(options) {
         fileCheck(root, ".gaslighting/MEMORY.md"),
         fileCheck(root, ".gaslighting/AGENT_RUNTIME.md"),
         fileCheck(root, ".gaslighting/PROJECT_CARE.md"),
+        fileCheck(root, ".gaslighting/INDEX.md"),
+        fileCheck(root, ".gaslighting/mission/PROJECT_PURPOSE.md"),
+        fileCheck(root, ".gaslighting/mission/EXECUTION_RULES.md"),
+        fileCheck(root, ".gaslighting/product/PAGE_MAP.md"),
+        fileCheck(root, ".gaslighting/features/core-scope/TASKS.md"),
+        fileCheck(root, ".gaslighting/loops/current-session.json"),
+        fileCheck(root, ".agents/config.json"),
         { name: ".gaslighting/GASLIGHTING.md contains project purpose", ok: /Project Purpose/i.test(gaslighting) },
         { name: ".gaslighting/GASLIGHTING.md contains no-fake-completion rules", ok: /No Fake Completion|Fake completion/i.test(gaslighting) },
         { name: ".gaslighting/GASLIGHTING.md contains full-scope rules", ok: /Full Scope Enforcement|full requested scope/i.test(gaslighting) },
-        { name: "AGENTS.md points to .gaslighting/GASLIGHTING.md", ok: /\.gaslighting\/GASLIGHTING\.md|\.gaslighting\\GASLIGHTING\.md/.test(agents) },
+        { name: "AGENTS.md points to .gaslighting/INDEX.md", ok: /\.gaslighting\/INDEX\.md|\.gaslighting\\INDEX\.md/.test(agents) },
         fileCheck(root, ".codex/skills/gaslighting/SKILL.md"),
         fileCheck(root, ".codex/skills/gaslighting/agents/openai.yaml"),
         fileCheck(root, ".codex/prompts/gaslighting.md"),

package/dist/commands/loop.js

@@ -0,0 +1,64 @@
+import { resolve } from "node:path";
+import { getMissionLoopStatus, resumeMissionLoop, startMissionLoop, stopMissionLoop } from "../core/missionLoop.js";
+import { printBanner } from "../utils/banner.js";
+export function runLoopStart(request = "Continue the current Gaslighting mission.", options) {
+    options = normalizeOptions(options);
+    const root = resolve(options.path ?? process.cwd());
+    const session = startMissionLoop({
+        root,
+        request,
+        runtime: options.runtime,
+        permissionMode: options.permissionMode,
+    });
+    printBanner("MISSION LOOP");
+    console.log(`Started: ${session.request}`);
+    console.log(`Runtime: ${session.runtime}`);
+    console.log(`Permission: ${session.permissionMode}`);
+    console.log(`Status: ${session.status}`);
+    console.log("Run `gaslighting loop resume` to execute the next iteration.");
+}
+export function runLoopResume(options) {
+    options = normalizeOptions(options);
+    const root = resolve(options.path ?? process.cwd());
+    const session = resumeMissionLoop({
+        root,
+        runtime: options.runtime,
+        permissionMode: options.permissionMode,
+        maxIterations: Number.parseInt(options.maxIterations ?? "1", 10),
+        approve: options.approve,
+        extraArgs: options.extraArgs,
+    });
+    printBanner("MISSION LOOP RESUME");
+    console.log(`Status: ${session.status}`);
+    console.log(`Task: ${session.currentTask}`);
+    console.log(`Iterations: ${session.iterations}`);
+    console.log(`Message: ${session.lastMessage ?? "-"}`);
+}
+export function runLoopStatus(options) {
+    options = normalizeOptions(options);
+    const root = resolve(options.path ?? process.cwd());
+    const session = getMissionLoopStatus(root);
+    printBanner("MISSION LOOP STATUS");
+    if (!session) {
+        console.log("No mission loop session exists.");
+        return;
+    }
+    console.log(`Status: ${session.status}`);
+    console.log(`Active: ${session.active}`);
+    console.log(`Runtime: ${session.runtime}`);
+    console.log(`Permission: ${session.permissionMode}`);
+    console.log(`Task: ${session.currentTask}`);
+    console.log(`Iterations: ${session.iterations}`);
+    console.log(`Message: ${session.lastMessage ?? "-"}`);
+}
+export function runLoopStop(options) {
+    options = normalizeOptions(options);
+    const root = resolve(options.path ?? process.cwd());
+    const session = stopMissionLoop(root);
+    printBanner("MISSION LOOP STOP");
+    console.log(`Status: ${session.status}`);
+    console.log(`Message: ${session.lastMessage ?? "-"}`);
+}
+function normalizeOptions(options) {
+    return typeof options.opts === "function" ? options.opts() : options;
+}

package/dist/commands/mcp.js

@@ -0,0 +1,43 @@
+import { resolve } from "node:path";
+import { doctorMcp, installMcpServer, listInstalledMcpServers, searchMcpServers } from "../core/mcpRegistry.js";
+import { printBanner } from "../utils/banner.js";
+export function runMcpSearch(query) {
+    printBanner("MCP SEARCH");
+    const results = searchMcpServers(query);
+    if (results.length === 0) {
+        console.log("No MCP servers matched.");
+        return;
+    }
+    for (const server of results) {
+        console.log(`${server.id}: ${server.label} - ${server.description}`);
+    }
+}
+export function runMcpInstall(name, options) {
+    options = normalizeOptions(options);
+    const root = resolve(options.path ?? process.cwd());
+    printBanner("MCP INSTALL");
+    const result = installMcpServer(root, name, options.runtime ?? "codex");
+    console.log(`${result.ok ? "PASS" : "FAIL"} ${result.message}`);
+}
+export function runMcpList(options) {
+    options = normalizeOptions(options);
+    const root = resolve(options.path ?? process.cwd());
+    printBanner("MCP LIST");
+    const installed = listInstalledMcpServers(root);
+    if (installed.length === 0) {
+        console.log("No MCP servers installed.");
+        return;
+    }
+    for (const server of installed)
+        console.log(`${server.id}: ${server.label}`);
+}
+export function runMcpDoctor(options) {
+    options = normalizeOptions(options);
+    const root = resolve(options.path ?? process.cwd());
+    printBanner("MCP DOCTOR");
+    for (const check of doctorMcp(root))
+        console.log(`${check.ok ? "PASS" : "WARN"} ${check.message}`);
+}
+function normalizeOptions(options) {
+    return typeof options.opts === "function" ? options.opts() : options;
+}

package/dist/commands/skill.js

@@ -1,10 +1,33 @@
 import { generateOnlySkillDocs } from "../core/generateDocs.js";
+import { createSharedSkill, doctorSkills, installSharedSkill } from "../core/skillRegistry.js";
 import { printBanner } from "../utils/banner.js";
 import { writeDocs } from "../utils/file.js";
 export function runSkill(options) {
+    options = normalizeOptions(options);
     const results = writeDocs(options.path ?? process.cwd(), generateOnlySkillDocs(), options.force, options.dryRun);
     printBanner("CODEX SKILL INSTALL");
     console.log("Created:");
     for (const result of results)
         console.log(`- ${result.filename}${result.status === "dry_run" ? " (dry run)" : ""}`);
 }
+export function runSkillCreate(name, options) {
+    options = normalizeOptions(options);
+    const path = createSharedSkill(options.path ?? process.cwd(), name, options.description);
+    printBanner("SKILL CREATE");
+    console.log(`Created shared skill: ${path}`);
+}
+export function runSkillInstall(name, options) {
+    options = normalizeOptions(options);
+    const path = installSharedSkill(options.path ?? process.cwd(), name, options.runtime ?? "codex");
+    printBanner("SKILL INSTALL");
+    console.log(`Installed skill export: ${path}`);
+}
+export function runSkillDoctor(options) {
+    options = normalizeOptions(options);
+    printBanner("SKILL DOCTOR");
+    for (const check of doctorSkills(options.path ?? process.cwd()))
+        console.log(`${check.ok ? "PASS" : "WARN"} ${check.message}`);
+}
+function normalizeOptions(options) {
+    return typeof options.opts === "function" ? options.opts() : options;
+}

package/dist/core/codexRuntime.js

@@ -1,29 +1,12 @@
 import { spawn } from "node:child_process";
 import { platform } from "node:os";
+import { buildAgentPrompt } from "../agent-runtimes/prompts.js";
 const defaultCodexArgs = "--search --dangerously-bypass-approvals-and-sandbox";
 export function getDefaultCodexArgs() {
     return process.env.GASLIGHTING_CODEX_ARGS || defaultCodexArgs;
 }
 export function buildCodexPrompt(request) {
-    return [
-        "Use the gaslighting skill.",
-        "",
-        "Read these files before doing any implementation:",
-        "1. AGENTS.md",
-        "2. .gaslighting/GASLIGHTING.md",
-        "3. .gaslighting/PRD.md",
-        "4. .gaslighting/STACK_POLICY.md",
-        "5. .gaslighting/MISSING_INFO.md",
-        "6. .gaslighting/ASSUMPTIONS.md",
-        "7. .gaslighting/DECISION_LOG.md",
-        "8. .gaslighting/MEMORY.md",
-        "9. .gaslighting/AGENT_RUNTIME.md",
-        "10. .gaslighting/PROJECT_CARE.md",
-        "",
-        `Project request: ${request}`,
-        "",
-        "Implement the MVP. Preserve full scope. Do not use TODOs as fake implementation. Do not deliver representative examples when full coverage is required. If something is incomplete, declare it explicitly.",
-    ].join("\n");
+    return buildAgentPrompt(request);
 }
 export function buildCodexCommand(input) {
     return buildCodexCommandParts(input).command;

package/dist/core/generateDocs.js

@@ -2,6 +2,7 @@ import { analyze } from "./analyze.js";
 import { generateGaslightingMarkdown } from "./generateGaslightingMarkdown.js";
 import { generatePrdMarkdown } from "./generatePrdMarkdown.js";
 import { generateProjectCareMarkdown } from "./projectCare.js";
+import { generateStructuredDocs } from "./generateStructuredDocs.js";
 import { generateAgentsMarkdown, generateAgentRuntimeMarkdown, generateAssumptionsMarkdown, generateCodexPromptMarkdown, generateCodexSlashPromptMarkdown, generateDecisionLogMarkdown, generateMemoryMarkdown, generateMissingInfoMarkdown, generateSkillMarkdown, generateSkillOpenAiYaml, generateSkillReferenceDocs, generateStackPolicyMarkdown, } from "./generateOtherMarkdown.js";
 const disciplineDir = ".gaslighting";
 export function generateDocs(input, root = process.cwd()) {
@@ -12,6 +13,7 @@ export function generateDocs(input, root = process.cwd()) {
     };
     const analysis = analyze(normalized);
     const docs = [
+        ...generateStructuredDocs(normalized, analysis, root),
         { filename: `${disciplineDir}/GASLIGHTING.md`, content: generateGaslightingMarkdown(normalized, analysis) },
         { filename: `${disciplineDir}/PRD.md`, content: generatePrdMarkdown(normalized, analysis) },
         { filename: `${disciplineDir}/ASSUMPTIONS.md`, content: generateAssumptionsMarkdown(analysis) },
@@ -53,6 +55,8 @@ export function generateCodexInstallDocs() {
     ];
     return [
         ...skillDocs,
+        { filename: ".agents/config.json", content: `${JSON.stringify({ sourceOfTruth: true, exports: [".codex"], skillRoot: ".agents/skills", mcpRoot: ".agents/mcp" }, null, 2)}\n` },
+        { filename: ".agents/mcp/manifest.json", content: `${JSON.stringify({ servers: [], installedAt: null, source: ".agents/mcp" }, null, 2)}\n` },
         { filename: ".codex/prompts/gaslighting.md", content: generateCodexSlashPromptMarkdown() },
         { filename: ".agents/prompts/gaslighting.md", content: generateCodexSlashPromptMarkdown() },
         { filename: ".gaslighting/CODEX_GASLIGHTING.md", content: generateCodexPromptMarkdown() },
@@ -80,18 +84,20 @@ This repository uses Gaslighting-engine.
 
 The main discipline documents live under \`.gaslighting/\` to avoid cluttering the project root.
 
+Start with \`.gaslighting/INDEX.md\`. It points to the mission, product, feature, operation, task, loop, verification, and memory documents.
+
 Before doing any work, read these files in order:
 
-1. \`.gaslighting/GASLIGHTING.md\`
-2. \`.gaslighting/PRD.md\`
-3. \`.gaslighting/STACK_POLICY.md\`
-4. \`.gaslighting/MISSING_INFO.md\`
-5. \`.gaslighting/ASSUMPTIONS.md\`
-6. \`.gaslighting/DECISION_LOG.md\`
-7. \`.gaslighting/MEMORY.md\`
-8. \`.gaslighting/AGENT_RUNTIME.md\`
-9. \`.gaslighting/PROJECT_CARE.md\`
-10. \`.gaslighting/AGENTS.md\`
+1. \`.gaslighting/INDEX.md\`
+2. \`.gaslighting/mission/PROJECT_PURPOSE.md\`
+3. \`.gaslighting/mission/EXECUTION_RULES.md\`
+4. \`.gaslighting/mission/COMPLETION_STANDARD.md\`
+5. \`.gaslighting/product/PRD.md\`
+6. \`.gaslighting/product/PAGE_MAP.md\`
+7. \`.gaslighting/features/core-scope/TASKS.md\`
+8. \`.gaslighting/operations/PROJECT_CARE.md\`
+9. \`.gaslighting/loops/current-session.json\`
+10. \`.gaslighting/GASLIGHTING.md\`
 
 Do not reduce scope.
 

package/dist/core/generateOtherMarkdown.js

@@ -216,15 +216,15 @@ This repository uses Gaslighting-engine.
 
 Before doing any work, read these files in order:
 
-1. \`.gaslighting/GASLIGHTING.md\`
-2. \`.gaslighting/PRD.md\`
-3. \`.gaslighting/STACK_POLICY.md\`
-4. \`.gaslighting/MISSING_INFO.md\`
-5. \`.gaslighting/ASSUMPTIONS.md\`
-6. \`.gaslighting/DECISION_LOG.md\`
-7. \`.gaslighting/MEMORY.md\`
-8. \`.gaslighting/AGENT_RUNTIME.md\`
-9. \`.gaslighting/PROJECT_CARE.md\`
+1. \`.gaslighting/INDEX.md\`
+2. \`.gaslighting/mission/PROJECT_PURPOSE.md\`
+3. \`.gaslighting/mission/EXECUTION_RULES.md\`
+4. \`.gaslighting/mission/COMPLETION_STANDARD.md\`
+5. \`.gaslighting/product/PRD.md\`
+6. \`.gaslighting/features/core-scope/TASKS.md\`
+7. \`.gaslighting/operations/PROJECT_CARE.md\`
+8. \`.gaslighting/loops/current-session.json\`
+9. \`.gaslighting/GASLIGHTING.md\`
 
 ## Prime Directive
 
@@ -516,16 +516,16 @@ Copy and paste this into Codex:
 
 Read the following files before doing any work:
 
-1. \`.gaslighting/GASLIGHTING.md\`
-2. \`.gaslighting/PRD.md\`
-3. \`.gaslighting/STACK_POLICY.md\`
-4. \`.gaslighting/MISSING_INFO.md\`
-5. \`.gaslighting/ASSUMPTIONS.md\`
-6. \`.gaslighting/DECISION_LOG.md\`
+1. \`.gaslighting/INDEX.md\`
+2. \`.gaslighting/mission/PROJECT_PURPOSE.md\`
+3. \`.gaslighting/mission/EXECUTION_RULES.md\`
+4. \`.gaslighting/product/PRD.md\`
+5. \`.gaslighting/features/core-scope/TASKS.md\`
+6. \`.gaslighting/operations/PROJECT_CARE.md\`
 7. \`AGENTS.md\`
-8. \`.gaslighting/MEMORY.md\`
-9. \`.gaslighting/AGENT_RUNTIME.md\`
-10. \`.gaslighting/PROJECT_CARE.md\`
+8. \`.gaslighting/GASLIGHTING.md\`
+9. \`.gaslighting/MISSING_INFO.md\`
+10. \`.gaslighting/DECISION_LOG.md\`
 
 Then implement the project MVP.
 
@@ -557,16 +557,16 @@ export function generateCodexSlashPromptMarkdown() {
 
 Read the Gaslighting-engine project-control files before doing any work:
 
-1. \`.gaslighting/GASLIGHTING.md\`
-2. \`.gaslighting/PRD.md\`
-3. \`.gaslighting/STACK_POLICY.md\`
-4. \`.gaslighting/MISSING_INFO.md\`
-5. \`.gaslighting/ASSUMPTIONS.md\`
-6. \`.gaslighting/DECISION_LOG.md\`
+1. \`.gaslighting/INDEX.md\`
+2. \`.gaslighting/mission/PROJECT_PURPOSE.md\`
+3. \`.gaslighting/mission/EXECUTION_RULES.md\`
+4. \`.gaslighting/product/PRD.md\`
+5. \`.gaslighting/features/core-scope/TASKS.md\`
+6. \`.gaslighting/operations/PROJECT_CARE.md\`
 7. \`AGENTS.md\`
-8. \`.gaslighting/MEMORY.md\`
-9. \`.gaslighting/AGENT_RUNTIME.md\`
-10. \`.gaslighting/PROJECT_CARE.md\`
+8. \`.gaslighting/GASLIGHTING.md\`
+9. \`.gaslighting/MISSING_INFO.md\`
+10. \`.gaslighting/DECISION_LOG.md\`
 
 Then execute the user's requested implementation.