gaslighting-engine 0.3.0 → 0.4.0

package/dist/commands/cockpit.js

@@ -3,8 +3,9 @@ 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 { getDefaultCodexArgs, launchCodex } from "../core/codexRuntime.js";
+import { buildCodexCommand, getDefaultCodexArgs, launchCodexInCurrentTerminal, launchCodexInNewTerminal } from "../core/codexRuntime.js";
 import { pageList, projectPurpose } from "../core/content.js";
 import { generateCodexInstallDocs, generateDocs, generateProjectCareDoc } from "../core/generateDocs.js";
 import { renderCockpitHtml } from "../core/cockpitHtml.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,10 +41,18 @@ 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);
-    const result = launchCodex({ root, request: rawUserRequest, codexArgs: options.codexArgs });
-    printBanner("CODEX RUN");
-    console.log(result.message);
-    console.log(result.command);
+    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 })
+        : 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);
 }
 async function openCockpit(rawUserRequest, options) {
     const root = resolve(options.path ?? process.cwd());
@@ -66,8 +81,32 @@ async function openCockpit(rawUserRequest, options) {
                 currentRequest = String(body.request || currentRequest);
                 currentInput = makeInput(currentRequest, options);
                 writeDocs(root, generateDocs(currentInput, root).docs, true, false);
-                const result = launchCodex({ root, request: currentRequest, codexArgs: options.codexArgs });
-                return sendJson(response, { ...result });
+                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(() => {
+                    server.close(() => {
+                        console.log("\nMission Control is handing off to Codex in this terminal.\n");
+                        launchCodexInCurrentTerminal({ root, request: currentRequest, codexArgs: options.codexArgs });
+                    });
+                }, 250);
+                return;
             }
             if (request.method === "POST" && request.url === "/api/connect-github") {
                 const body = await readJson(request);
@@ -108,7 +147,19 @@ 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) {
+    return {
+        ok: true,
+        command: buildCodexCommand({ root, request, codexArgs: options.codexArgs }),
+        message: "Mission Control will close and Codex will continue in the same terminal that launched it.",
     };
 }
 function makeInput(rawUserRequest, options) {
@@ -121,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/cockpitHtml.js

@@ -424,7 +424,7 @@ export function renderCockpitHtml() {
           <div class="action-card"><div><strong>Refresh Docs</strong><br /><span>Regenerate .gaslighting and root AGENTS.md from the current request.</span></div><button id="generateBtn">Generate</button></div>
           <div class="action-card"><div><strong>Connect GitHub</strong><br /><span>Initialize Git if needed and connect origin without blocking implementation.</span></div><button id="githubBtn">Connect</button></div>
           <div class="action-card"><div><strong>Doctor</strong><br /><span>Check discipline documents and operational care state.</span></div><button id="doctorBtn">Check</button></div>
-          <div class="action-card"><div><strong>Start Codex</strong><br /><span>Launch Codex with the Gaslighting contract already loaded.</span></div><button class="primary" id="startCardBtn">Start</button></div>
+          <div class="action-card"><div><strong>Start Codex</strong><br /><span>Close the cockpit server and continue Codex in this same terminal.</span></div><button class="primary" id="startCardBtn">Start</button></div>
         </div>
       </footer>
     </main>
@@ -436,6 +436,7 @@ export function renderCockpitHtml() {
       </div>
       <div class="side-panel">
         <h3>Runtime</h3>
+        <div class="status-row"><span class="badge">T</span><div><strong>Launch mode</strong><small id="launchMode">-</small></div></div>
         <div class="status-row"><span class="badge">C</span><div><strong>Codex args</strong><small id="codexArgs">-</small></div></div>
         <div class="status-row"><span class="badge warn">M</span><div><strong>Model strategy</strong><small>Codex-first now. Multi-model slots can be added later.</small></div></div>
       </div>
@@ -507,6 +508,7 @@ export function renderCockpitHtml() {
       el('confidence').textContent = state.analysis.confidence;
       el('stackHints').textContent = state.analysis.detectedStackHints.length ? state.analysis.detectedStackHints.join(', ') : 'default web stack';
       el('codexArgs').textContent = state.codexArgs;
+      el('launchMode').textContent = state.launchMode === 'new_terminal' ? 'New terminal window' : 'Same terminal handoff';
 
       var warningCount = state.care.checks.filter(function (check) { return !check.ok; }).length;
       var score = Math.max(0, Math.round(((state.care.checks.length - warningCount) / Math.max(1, state.care.checks.length)) * 100));
@@ -563,7 +565,7 @@ export function renderCockpitHtml() {
         headers: { 'content-type': 'application/json' },
         body: JSON.stringify({ request: el('requestInput').value })
       });
-      log(data.message + '\\n\\n' + data.command);
+      log(data.message + '\\n\\n' + data.command + '\\n\\nThe original terminal will continue as Codex.');
     }
     async function connectGithub() {
       var githubUrl = el('githubInput').value.trim();

package/dist/core/codexRuntime.js

@@ -1,63 +1,75 @@
 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) {
-    const args = splitCommandArgs(input.codexArgs || getDefaultCodexArgs());
-    return ["codex", ...args, "-C", quoteArg(input.root), quoteArg(buildCodexPrompt(input.request))].join(" ");
+    return buildCodexCommandParts(input).command;
 }
-export function launchCodex(input) {
-    const args = splitCommandArgs(input.codexArgs || getDefaultCodexArgs());
-    const prompt = buildCodexPrompt(input.request);
-    const command = buildCodexCommand(input);
+export function launchCodexInCurrentTerminal(input) {
+    const parts = buildCodexCommandParts(input);
+    try {
+        const child = platform() === "win32"
+            ? spawn("cmd.exe", ["/d", "/s", "/c", "codex", ...parts.args, "-C", input.root, parts.prompt], {
+                cwd: input.root,
+                stdio: "inherit",
+            })
+            : spawn("codex", [...parts.args, "-C", input.root, parts.prompt], {
+                cwd: input.root,
+                stdio: "inherit",
+            });
+        child.on("exit", (code) => {
+            process.exit(code ?? 0);
+        });
+        child.on("error", (error) => {
+            console.error(`Could not start Codex: ${error.message}`);
+            console.error(parts.command);
+            process.exit(1);
+        });
+        return { ok: true, command: parts.command, message: "Mission Control handed off to Codex in this terminal." };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown Codex launch failure.";
+        return { ok: false, command: parts.command, message };
+    }
+}
+export function launchCodexInNewTerminal(input) {
+    const parts = buildCodexCommandParts(input);
     try {
         if (platform() === "win32") {
-            const child = spawn("cmd.exe", ["/c", "start", "Gaslighting Codex", "/D", input.root, "codex", ...args, "-C", input.root, prompt], {
+            const child = spawn("cmd.exe", ["/c", "start", "Gaslighting Codex", "/D", input.root, "codex", ...parts.args, "-C", input.root, parts.prompt], {
                 cwd: input.root,
                 detached: true,
                 stdio: "ignore",
             });
             child.unref();
-            return { ok: true, command, message: "Started Codex in a new terminal window." };
+            return { ok: true, command: parts.command, message: "Started Codex in a new terminal window." };
         }
         if (platform() === "darwin") {
-            const script = `tell application "Terminal" to do script ${JSON.stringify(`cd ${quoteShell(input.root)} && ${command}`)}`;
+            const script = `tell application "Terminal" to do script ${JSON.stringify(`cd ${quoteShell(input.root)} && ${parts.command}`)}`;
             const child = spawn("osascript", ["-e", script], { detached: true, stdio: "ignore" });
             child.unref();
-            return { ok: true, command, message: "Started Codex in Terminal." };
+            return { ok: true, command: parts.command, message: "Started Codex in Terminal." };
         }
-        const child = spawn("sh", ["-lc", `cd ${quoteShell(input.root)} && ${command}`], { detached: true, stdio: "ignore" });
+        const child = spawn("sh", ["-lc", `cd ${quoteShell(input.root)} && ${parts.command}`], { detached: true, stdio: "ignore" });
         child.unref();
-        return { ok: true, command, message: "Started Codex in the background. If no terminal appears, copy the command and run it manually." };
+        return { ok: true, command: parts.command, message: "Started Codex in the background. If no terminal appears, copy the command and run it manually." };
     }
     catch (error) {
         const message = error instanceof Error ? error.message : "Unknown Codex launch failure.";
-        return { ok: false, command, message };
+        return { ok: false, command: parts.command, message };
     }
 }
+function buildCodexCommandParts(input) {
+    const args = splitCommandArgs(input.codexArgs || getDefaultCodexArgs());
+    const prompt = buildCodexPrompt(input.request);
+    return { args, prompt, command: ["codex", ...args, "-C", quoteArg(input.root), quoteArg(prompt)].join(" ") };
+}
 export function splitCommandArgs(input) {
     const args = [];
     const pattern = /"([^"]*)"|'([^']*)'|(\S+)/g;

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.