gaslighting-engine 0.3.0 → 0.4.0

package/dist/core/skillRegistry.js

@@ -0,0 +1,62 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+export function createSharedSkill(root, name, description) {
+    const normalized = normalizeSkillName(name);
+    const path = join(root, ".agents", "skills", normalized, "SKILL.md");
+    writeText(path, `---
+name: ${normalized}
+description: ${description || `Shared Gaslighting-engine skill for ${normalized}.`}
+---
+
+# ${normalized}
+
+Use this skill when the project requires the ${normalized} workflow.
+
+## Rules
+
+- Preserve full requested scope.
+- Do not fake completion.
+- Record assumptions, missing information, decisions, and operational risk.
+- If work is incomplete, say it is incomplete.
+`);
+    return path;
+}
+export function installSharedSkill(root, name, runtime) {
+    const normalized = normalizeSkillName(name);
+    const source = join(root, ".agents", "skills", normalized, "SKILL.md");
+    if (!existsSync(source))
+        createSharedSkill(root, normalized);
+    const content = readFileSync(source, "utf8");
+    if (runtime === "codex") {
+        const target = join(root, ".codex", "skills", normalized, "SKILL.md");
+        writeText(target, content);
+        return target;
+    }
+    if (runtime === "claude") {
+        const target = join(root, ".claude", "skills", normalized, "SKILL.md");
+        writeText(target, content);
+        return target;
+    }
+    const target = join(root, ".agents", "exports", runtime, "skills", normalized, "SKILL.md");
+    writeText(target, content);
+    return target;
+}
+export function doctorSkills(root) {
+    return [
+        {
+            ok: existsSync(join(root, ".agents", "skills")),
+            message: ".agents/skills exists as shared skill source.",
+        },
+        {
+            ok: existsSync(join(root, ".codex", "skills")),
+            message: ".codex/skills exists as Codex export target.",
+        },
+    ];
+}
+function normalizeSkillName(name) {
+    return name.toLowerCase().replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "") || "gaslighting-skill";
+}
+function writeText(path, content) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, content, "utf8");
+}

package/dist/desktop/main.js

@@ -0,0 +1,186 @@
+import { app, BrowserWindow, dialog, ipcMain } from "electron";
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { platform } from "node:os";
+import { analyze } from "../core/analyze.js";
+import { pageList, projectPurpose } from "../core/content.js";
+import { generateCodexInstallDocs, generateDocs } from "../core/generateDocs.js";
+import { inspectProjectCare } from "../core/projectCare.js";
+import { detectAgentRuntimes, getAgentRuntimeAdapter, listAgentRuntimeAdapters } from "../agent-runtimes/registry.js";
+import { getMissionLoopStatus, resumeMissionLoop, startMissionLoop, stopMissionLoop } from "../core/missionLoop.js";
+import { doctorMcp, installMcpServer, listInstalledMcpServers, searchMcpServers } from "../core/mcpRegistry.js";
+import { createSharedSkill, doctorSkills, installSharedSkill } from "../core/skillRegistry.js";
+import { writeDocs } from "../utils/file.js";
+import { packageVersion } from "../version.js";
+const initialRoot = resolve(process.env.GASLIGHTING_DESKTOP_ROOT || process.cwd());
+const initialRequest = process.env.GASLIGHTING_DESKTOP_REQUEST || "";
+let currentRoot = initialRoot;
+let currentRequest = initialRequest || "Build a practical MVP without shrinking scope.";
+let mainWindow;
+async function createWindow() {
+    mainWindow = new BrowserWindow({
+        width: 1440,
+        height: 940,
+        minWidth: 1120,
+        minHeight: 760,
+        title: "Gaslighting Mission Control",
+        backgroundColor: "#f5f5f3",
+        webPreferences: {
+            preload: join(app.getAppPath(), "dist", "desktop", "preload.js"),
+            contextIsolation: true,
+            nodeIntegration: false,
+        },
+    });
+    if (process.env.GASLIGHTING_DESKTOP_DEV) {
+        await mainWindow.loadURL("http://127.0.0.1:5173");
+    }
+    else {
+        await mainWindow.loadFile(join(app.getAppPath(), "desktop-dist", "index.html"));
+    }
+}
+app.whenReady().then(createWindow);
+app.on("window-all-closed", () => {
+    if (process.platform !== "darwin")
+        app.quit();
+});
+app.on("activate", () => {
+    if (BrowserWindow.getAllWindows().length === 0)
+        void createWindow();
+});
+ipcMain.handle("project:select", async () => {
+    const result = await dialog.showOpenDialog({ properties: ["openDirectory", "createDirectory"] });
+    if (!result.canceled && result.filePaths[0])
+        currentRoot = result.filePaths[0];
+    return buildDesktopState();
+});
+ipcMain.handle("mission:state", () => buildDesktopState());
+ipcMain.handle("mission:generate", (_event, input) => {
+    updateCurrent(input);
+    const generateInput = toGenerateInput(input);
+    writeDocs(currentRoot, generateDocs(generateInput, currentRoot).docs, true, false);
+    writeDocs(currentRoot, generateCodexInstallDocs(), true, false);
+    return buildDesktopState(input);
+});
+ipcMain.handle("agent:start", async (event, input) => {
+    updateCurrent(input);
+    const runtime = input.runtime ?? "codex";
+    const adapter = getAgentRuntimeAdapter(runtime);
+    const spawnInput = adapter.buildSpawn({
+        root: currentRoot,
+        request: currentRequest,
+        runtime,
+        model: input.model,
+        permissionMode: input.permissionMode ?? "auto_review",
+        loopMode: input.loopMode ?? "off",
+        extraArgs: input.extraArgs,
+    });
+    event.sender.send("terminal:data", `\r\n$ ${adapter.buildCommand({ root: currentRoot, request: currentRequest, runtime, model: input.model, permissionMode: input.permissionMode ?? "auto_review", loopMode: input.loopMode ?? "off", extraArgs: input.extraArgs })}\r\n`);
+    await startTerminalProcess(event.sender, spawnInput.file, spawnInput.args, currentRoot);
+    return { ok: true, message: `${adapter.label} started.` };
+});
+ipcMain.handle("loop:start", (_event, input) => {
+    updateCurrent(input);
+    startMissionLoop({ root: currentRoot, request: currentRequest, runtime: input.runtime, permissionMode: input.permissionMode });
+    return buildDesktopState(input);
+});
+ipcMain.handle("loop:resume", (_event, input) => {
+    updateCurrent(input);
+    resumeMissionLoop({
+        root: currentRoot,
+        runtime: input.runtime,
+        permissionMode: input.permissionMode,
+        approve: input.approve,
+        maxIterations: input.maxIterations ?? 1,
+        extraArgs: input.extraArgs,
+    });
+    return buildDesktopState(input);
+});
+ipcMain.handle("loop:stop", () => {
+    stopMissionLoop(currentRoot);
+    return buildDesktopState();
+});
+ipcMain.handle("mcp:search", (_event, query) => searchMcpServers(query));
+ipcMain.handle("mcp:install", (_event, input) => {
+    const result = installMcpServer(currentRoot, input.name, input.runtime ?? "codex");
+    return { result, state: buildDesktopState() };
+});
+ipcMain.handle("mcp:list", () => listInstalledMcpServers(currentRoot));
+ipcMain.handle("mcp:doctor", () => doctorMcp(currentRoot));
+ipcMain.handle("skill:create", (_event, input) => {
+    const path = createSharedSkill(currentRoot, input.name, input.description);
+    return { path, state: buildDesktopState() };
+});
+ipcMain.handle("skill:install", (_event, input) => {
+    const path = installSharedSkill(currentRoot, input.name, input.runtime ?? "codex");
+    return { path, state: buildDesktopState() };
+});
+ipcMain.handle("skill:doctor", () => doctorSkills(currentRoot));
+function buildDesktopState(input = {}) {
+    const generateInput = toGenerateInput(input);
+    const analysis = analyze(generateInput);
+    const docs = [
+        "AGENTS.md",
+        ".gaslighting/INDEX.md",
+        ".gaslighting/mission/PROJECT_PURPOSE.md",
+        ".gaslighting/product/PRD.md",
+        ".gaslighting/loops/current-session.json",
+        ".agents/config.json",
+        ".codex/skills/gaslighting/SKILL.md",
+    ];
+    return {
+        version: packageVersion,
+        root: currentRoot,
+        request: currentRequest,
+        analysis,
+        purpose: projectPurpose(analysis.projectType),
+        pages: pageList(analysis.projectType),
+        care: inspectProjectCare(currentRoot),
+        runtimes: detectAgentRuntimes(),
+        modelsByRuntime: Object.fromEntries(listAgentRuntimeAdapters().map((adapter) => [adapter.id, adapter.listModels()])),
+        loop: getMissionLoopStatus(currentRoot),
+        mcp: listInstalledMcpServers(currentRoot),
+        skills: doctorSkills(currentRoot),
+        docsPresent: Object.fromEntries(docs.map((doc) => [doc, existsSync(join(currentRoot, doc))])),
+    };
+}
+function updateCurrent(input) {
+    if (input.root)
+        currentRoot = resolve(input.root);
+    if (input.request)
+        currentRequest = input.request;
+}
+function toGenerateInput(input) {
+    return {
+        rawUserRequest: input.request || currentRequest,
+        runtime: input.runtime ?? "codex",
+        permissionMode: input.permissionMode ?? "auto_review",
+        loopMode: input.loopMode ?? "off",
+        mode: "hardcore",
+        fullScope: true,
+        noTodo: true,
+        noShortcut: true,
+        force: true,
+    };
+}
+async function startTerminalProcess(sender, file, args, cwd) {
+    try {
+        const pty = await import("node-pty");
+        const command = platform() === "win32" ? "cmd.exe" : file;
+        const ptyArgs = platform() === "win32" ? ["/d", "/s", "/c", file, ...args] : args;
+        const terminal = pty.spawn(command, ptyArgs, { cwd, cols: 120, rows: 32, name: "xterm-color" });
+        terminal.onData((data) => sender.send("terminal:data", data));
+        terminal.onExit((event) => sender.send("terminal:data", `\r\n[process exited ${event.exitCode}]\r\n`));
+        return;
+    }
+    catch {
+        const child = platform() === "win32"
+            ? spawn("cmd.exe", ["/d", "/s", "/c", file, ...args], { cwd })
+            : spawn(file, args, { cwd });
+        child.stdout?.on("data", (chunk) => sender.send("terminal:data", chunk.toString()));
+        child.stderr?.on("data", (chunk) => sender.send("terminal:data", chunk.toString()));
+        child.on("exit", (code) => sender.send("terminal:data", `\r\n[process exited ${code ?? 0}]\r\n`));
+    }
+}
+export const __filename = fileURLToPath(import.meta.url);

package/dist/desktop/preload.js

@@ -0,0 +1,22 @@
+import { contextBridge, ipcRenderer } from "electron";
+contextBridge.exposeInMainWorld("gaslighting", {
+    selectProject: () => ipcRenderer.invoke("project:select"),
+    getState: () => ipcRenderer.invoke("mission:state"),
+    generate: (input) => ipcRenderer.invoke("mission:generate", input),
+    startAgent: (input) => ipcRenderer.invoke("agent:start", input),
+    loopStart: (input) => ipcRenderer.invoke("loop:start", input),
+    loopResume: (input) => ipcRenderer.invoke("loop:resume", input),
+    loopStop: () => ipcRenderer.invoke("loop:stop"),
+    mcpSearch: (query) => ipcRenderer.invoke("mcp:search", query),
+    mcpInstall: (input) => ipcRenderer.invoke("mcp:install", input),
+    mcpList: () => ipcRenderer.invoke("mcp:list"),
+    mcpDoctor: () => ipcRenderer.invoke("mcp:doctor"),
+    skillCreate: (input) => ipcRenderer.invoke("skill:create", input),
+    skillInstall: (input) => ipcRenderer.invoke("skill:install", input),
+    skillDoctor: () => ipcRenderer.invoke("skill:doctor"),
+    onTerminalData: (callback) => {
+        const listener = (_event, data) => callback(data);
+        ipcRenderer.on("terminal:data", listener);
+        return () => ipcRenderer.removeListener("terminal:data", listener);
+    },
+});

package/dist/utils/logger.js

@@ -31,5 +31,5 @@ export function printSummary(analysis, modeLines, results, care) {
             console.log(`- WARN ${warning.label}: ${warning.message} Next: ${warning.action}`);
     }
     console.log('\nNext:\nOpen Codex and say:\n');
-    console.log('"Read AGENTS.md, .gaslighting/GASLIGHTING.md, .gaslighting/PRD.md, .gaslighting/STACK_POLICY.md, .gaslighting/MISSING_INFO.md, .gaslighting/ASSUMPTIONS.md, .gaslighting/DECISION_LOG.md, .gaslighting/MEMORY.md, .gaslighting/AGENT_RUNTIME.md, and .gaslighting/PROJECT_CARE.md. Implement the MVP without shrinking scope, without TODO escape, and without fake completion."');
+    console.log('"Read AGENTS.md, .gaslighting/INDEX.md, .gaslighting/mission/PROJECT_PURPOSE.md, .gaslighting/mission/EXECUTION_RULES.md, .gaslighting/product/PRD.md, .gaslighting/features/core-scope/TASKS.md, .gaslighting/operations/PROJECT_CARE.md, and .gaslighting/GASLIGHTING.md. Implement the MVP without shrinking scope, without TODO escape, and without fake completion."');
 }

package/dist/version.js

@@ -1,2 +1,2 @@
 export const packageName = "gaslighting-engine";
-export const packageVersion = "0.3.0";
+export const packageVersion = "0.4.0";

package/docs/codex-usage.md

@@ -48,12 +48,28 @@ This is the recommended update flow. It overwrites the local Codex skill and pro
 
 ## Generate Discipline Docs
 
-Generate documents and open Mission Control:
+Open the desktop Mission Control app:
+
+```bash
+npx gaslighting-engine@latest desktop "I want to build a hospital website."
+```
+
+The desktop app lets you generate the structured `.gaslighting/` docs, review project care warnings, choose runtime and permission mode, install MCP/skills, and start the agent from one surface.
+
+Generate documents and open the legacy browser cockpit:
 
 ```bash
 npx gaslighting-engine@latest start "I want to build a hospital website."
 ```
 
+`Start Codex` continues in the same terminal by default. Use `--new-terminal` only when you intentionally want a separate terminal window.
+
+Custom Codex flags:
+
+```bash
+npx gaslighting-engine@latest start "I want to build a hospital website." --codex-args="--search --dangerously-bypass-approvals-and-sandbox"
+```
+
 Open the GUI for an existing Gaslighting project:
 
 ```bash
@@ -69,10 +85,27 @@ npx gaslighting-engine@latest run "I want to build a hospital website."
 Then ask Codex:
 
 ```txt
-Read AGENTS.md, .gaslighting/GASLIGHTING.md, .gaslighting/PRD.md, .gaslighting/STACK_POLICY.md, .gaslighting/MISSING_INFO.md, .gaslighting/ASSUMPTIONS.md, .gaslighting/DECISION_LOG.md, .gaslighting/MEMORY.md, .gaslighting/AGENT_RUNTIME.md, and .gaslighting/PROJECT_CARE.md.
+Read AGENTS.md and .gaslighting/INDEX.md first. Then read the mission, product, operations, decisions, tasks, memory, and verification files referenced by the index.
 Implement the MVP without shrinking scope, without TODO escape, and without fake completion.
 ```
 
-Codex should treat root `AGENTS.md` as the project guidance pointer and `.gaslighting/GASLIGHTING.md` as the anti-escape contract.
+Codex should treat root `AGENTS.md` as the project guidance pointer and `.gaslighting/mission/GASLIGHTING.md` as the anti-escape contract.
 
 The CLI also generates Codex Skill files, prompt fallback files, `.gaslighting/CODEX_GASLIGHTING.md`, `.gaslighting/AGENT_RUNTIME.md`, and `.gaslighting/PROJECT_CARE.md` so the workflow still works when a specific Codex surface does not expose a custom slash entry.
+
+## Runtime, Permissions, And Loop
+
+Check runtime availability:
+
+```bash
+npx gaslighting-engine@latest agent list
+```
+
+Start a task loop only when you want long-running task-by-task execution:
+
+```bash
+npx gaslighting-engine@latest loop start "Build the hospital homepage"
+npx gaslighting-engine@latest loop resume
+```
+
+Default permission mode is `auto_review`: normal work proceeds, but publish, deploy, push, MCP install, secret/env changes, DB migration, and domain/DNS changes require explicit approval.

package/examples/ecommerce/.agents/config.json

@@ -0,0 +1,10 @@
+{
+  "sourceOfTruth": true,
+  "defaultRuntime": "codex",
+  "permissionMode": "auto_review",
+  "exports": [
+    ".codex"
+  ],
+  "skillRoot": ".agents/skills",
+  "mcpRoot": ".agents/mcp"
+}

package/examples/ecommerce/.agents/mcp/manifest.json

@@ -0,0 +1,5 @@
+{
+  "servers": [],
+  "installedAt": null,
+  "source": ".agents/mcp"
+}

package/examples/ecommerce/.agents/runtimes/claude.json

@@ -0,0 +1,6 @@
+{
+  "id": "claude",
+  "enabled": false,
+  "supportsMcp": true,
+  "supportsSkills": true
+}

package/examples/ecommerce/.agents/runtimes/codex.json

@@ -0,0 +1,6 @@
+{
+  "id": "codex",
+  "enabled": true,
+  "supportsMcp": true,
+  "supportsSkills": true
+}

package/examples/ecommerce/.agents/runtimes/kimi.json

@@ -0,0 +1,6 @@
+{
+  "id": "kimi",
+  "enabled": false,
+  "supportsMcp": true,
+  "supportsSkills": true
+}

package/examples/ecommerce/.agents/runtimes/local.json

@@ -0,0 +1,6 @@
+{
+  "id": "local",
+  "enabled": false,
+  "supportsMcp": false,
+  "supportsSkills": false
+}

package/examples/ecommerce/.agents/runtimes/openai_compatible.json

@@ -0,0 +1,6 @@
+{
+  "id": "openai_compatible",
+  "enabled": false,
+  "supportsMcp": false,
+  "supportsSkills": false
+}

package/examples/ecommerce/.agents/runtimes/opencode.json

@@ -0,0 +1,6 @@
+{
+  "id": "opencode",
+  "enabled": false,
+  "supportsMcp": true,
+  "supportsSkills": false
+}

package/examples/ecommerce/.agents/runtimes/qwen.json

@@ -0,0 +1,6 @@
+{
+  "id": "qwen",
+  "enabled": false,
+  "supportsMcp": true,
+  "supportsSkills": false
+}

package/examples/ecommerce/.codex/prompts/gaslighting.md

@@ -2,16 +2,16 @@
 
 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.
 

package/examples/ecommerce/.gaslighting/AGENTS.md

@@ -4,15 +4,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
 

package/examples/ecommerce/.gaslighting/AGENT_RUNTIME.md

@@ -8,7 +8,7 @@ It is the runtime loop.
 
 ## Mission
 
-- Original request: Build an ecommerce MVP with product catalog, cart, checkout, and admin orders.
+- Original request: Build an ecommerce MVP.
 - Project type: ecommerce
 - Classification confidence: high
 - Runtime stance: Codex-first, full-scope, no fake completion.

package/examples/ecommerce/.gaslighting/CODEX_PROMPT.md

@@ -6,16 +6,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.
 

package/examples/ecommerce/.gaslighting/DECISION_LOG.md

@@ -8,7 +8,7 @@ Date: 2026-05-23
 
 Generate strict Gaslighting-engine project-control documents for the request:
 
-> Build an ecommerce MVP with product catalog, cart, checkout, and admin orders.
+> Build an ecommerce MVP.
 
 ### Reason
 

package/examples/ecommerce/.gaslighting/GASLIGHTING.md

@@ -121,7 +121,7 @@ Project type: `ecommerce`
 
 Original request:
 
-> Build an ecommerce MVP with product catalog, cart, checkout, and admin orders.
+> Build an ecommerce MVP.
 
 The purpose is:
 
@@ -142,7 +142,7 @@ The purpose is:
 
 ## 3. Confirmed Information
 
-- The user requested: Build an ecommerce MVP with product catalog, cart, checkout, and admin orders.
+- The user requested: Build an ecommerce MVP.
 - Classified project type: ecommerce
 - Classification confidence: high
 - No stack hints were provided. Use the default practical web stack unless the user later changes it.

package/examples/ecommerce/.gaslighting/INDEX.md

@@ -0,0 +1,39 @@
+# Gaslighting-engine Index
+
+This is the structured source of truth for the project discipline layer.
+
+## Mission
+
+- Original request: Build an ecommerce MVP.
+- Project type: ecommerce
+- Classification confidence: high
+- Default runtime: codex
+- Loop mode: off
+- Permission mode: auto_review
+
+## Read Order For Agents
+
+1. `mission/PROJECT_PURPOSE.md`
+2. `mission/EXECUTION_RULES.md`
+3. `mission/COMPLETION_STANDARD.md`
+4. `product/PRD.md`
+5. `product/PAGE_MAP.md`
+6. `features/core-scope/TASKS.md`
+7. `operations/PROJECT_CARE.md`
+8. `loops/current-session.json`
+
+## Pages
+
+- Home
+- Product List
+- Product Detail
+- Cart
+- Checkout
+- Order Complete
+- My Orders
+- Admin Products
+- Admin Orders
+
+## Compatibility Files
+
+Older agents may still read the root compatibility markdown files in `.gaslighting/`. Those files remain generated for backward compatibility, but this index is the preferred entrypoint.

package/examples/ecommerce/.gaslighting/MEMORY.md

@@ -10,7 +10,7 @@ Keep required rules in root `AGENTS.md`, `.gaslighting/GASLIGHTING.md`, and chec
 
 ## Stable Project Facts
 
-- Original request: Build an ecommerce MVP with product catalog, cart, checkout, and admin orders.
+- Original request: Build an ecommerce MVP.
 - Project type: ecommerce
 - Classification confidence: high
 - Stack hints: none

package/examples/ecommerce/.gaslighting/PRD.md

@@ -4,7 +4,7 @@
 
 Build an MVP for this request:
 
-> Build an ecommerce MVP with product catalog, cart, checkout, and admin orders.
+> Build an ecommerce MVP.
 
 Classified project type: `ecommerce`
 

package/examples/ecommerce/.gaslighting/PROJECT_CARE.md

@@ -11,7 +11,7 @@ The agent must treat this project as mission-critical. If something can put deli
 ## Project Snapshot
 
 - Date: 2026-05-23
-- Original request: Build an ecommerce MVP with product catalog, cart, checkout, and admin orders.
+- Original request: Build an ecommerce MVP.
 - Project type: ecommerce
 - Classification confidence: high
 - Project purpose:

package/examples/ecommerce/.gaslighting/checkpoints/latest.md

@@ -0,0 +1,7 @@
+# Latest Checkpoint
+
+No loop iteration has completed yet.
+
+Original request:
+
+> Build an ecommerce MVP.

package/examples/ecommerce/.gaslighting/config.json

@@ -0,0 +1,7 @@
+{
+  "defaultRuntime": "codex",
+  "loopMode": "off",
+  "permissionMode": "auto_review",
+  "skillSource": ".agents",
+  "documentLayout": "structured"
+}

package/examples/ecommerce/.gaslighting/decisions/ADR-0001-stack.md

@@ -0,0 +1,11 @@
+# ADR-0001: Stack Policy
+
+Date: 2026-05-23
+
+## Decision
+
+No stack hints were provided. Use the default practical web stack unless the user later changes it.
+
+## Consequence
+
+The agent must avoid over-engineering and choose technology that serves the project purpose.

package/examples/ecommerce/.gaslighting/decisions/ADR-0002-agent-runtime.md

@@ -0,0 +1,11 @@
+# ADR-0002: Agent Runtime
+
+Date: 2026-05-23
+
+## Decision
+
+Default runtime is `codex`.
+
+Loop mode defaults to `off`.
+
+Permission mode defaults to `auto_review`.

package/examples/ecommerce/.gaslighting/features/core-scope/DECISIONS.md

@@ -0,0 +1,5 @@
+# Feature Decisions
+
+- Project type initialized as `ecommerce`.
+- Deterministic template generation is used instead of an LLM API.
+- Scope preservation is mandatory.