gaslighting-engine 0.1.0 → 0.2.0

package/dist/commands/doctor.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { inspectProjectCare } from "../core/projectCare.js";
 import { printBanner } from "../utils/banner.js";
 export function runDoctor(options) {
     const root = options.path ?? process.cwd();
@@ -7,20 +8,21 @@ export function runDoctor(options) {
         const full = join(root, file);
         return existsSync(full) ? readFileSync(full, "utf8") : "";
     };
-    const gaslighting = read("GASLIGHTING.md");
+    const gaslighting = read(".gaslighting/GASLIGHTING.md") || read("GASLIGHTING.md");
     const agents = read("AGENTS.md");
     const checks = [
-        fileCheck(root, "GASLIGHTING.md"),
-        fileCheck(root, "PRD.md"),
+        fileCheck(root, ".gaslighting/GASLIGHTING.md"),
+        fileCheck(root, ".gaslighting/PRD.md"),
         fileCheck(root, "AGENTS.md"),
-        fileCheck(root, "STACK_POLICY.md"),
-        fileCheck(root, "MISSING_INFO.md"),
-        fileCheck(root, "DECISION_LOG.md"),
-        fileCheck(root, "MEMORY.md"),
-        { name: "GASLIGHTING.md contains project purpose", ok: /Project Purpose/i.test(gaslighting) },
-        { name: "GASLIGHTING.md contains no-fake-completion rules", ok: /No Fake Completion|Fake completion/i.test(gaslighting) },
-        { name: "GASLIGHTING.md contains full-scope rules", ok: /Full Scope Enforcement|full requested scope/i.test(gaslighting) },
-        { name: "AGENTS.md points to GASLIGHTING.md", ok: /GASLIGHTING\.md/.test(agents) },
+        fileCheck(root, ".gaslighting/STACK_POLICY.md"),
+        fileCheck(root, ".gaslighting/MISSING_INFO.md"),
+        fileCheck(root, ".gaslighting/DECISION_LOG.md"),
+        fileCheck(root, ".gaslighting/MEMORY.md"),
+        fileCheck(root, ".gaslighting/PROJECT_CARE.md"),
+        { 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) },
         fileCheck(root, ".codex/skills/gaslighting/SKILL.md"),
         fileCheck(root, ".codex/skills/gaslighting/agents/openai.yaml"),
         fileCheck(root, ".codex/prompts/gaslighting.md"),
@@ -28,6 +30,10 @@ export function runDoctor(options) {
     printBanner("DOCTOR");
     for (const check of checks)
         console.log(`${check.ok ? "PASS" : "FAIL"} ${check.name}`);
+    const care = inspectProjectCare(root);
+    console.log("\nCare checks:");
+    for (const check of care.checks)
+        console.log(`${check.ok ? "PASS" : "WARN"} ${check.label}: ${check.message}`);
     const failed = checks.filter((check) => !check.ok);
     if (failed.length) {
         console.log(`\n${failed.length} check(s) failed.`);

package/dist/commands/init.js

@@ -1,8 +1,10 @@
 import { generateDocs } from "../core/generateDocs.js";
 import { modeSummary } from "../core/content.js";
+import { inspectProjectCare } from "../core/projectCare.js";
 import { writeDocs } from "../utils/file.js";
 import { printSummary } from "../utils/logger.js";
 export function runInit(rawUserRequest, options) {
+    const root = options.path ?? process.cwd();
     const input = {
         rawUserRequest,
         projectType: options.type,
@@ -14,9 +16,9 @@ export function runInit(rawUserRequest, options) {
         force: options.force,
         dryRun: options.dryRun,
     };
-    const { analysis, docs } = generateDocs(input);
-    const results = writeDocs(options.path ?? process.cwd(), docs, options.force, options.dryRun);
-    printSummary(analysis, modeSummary(input), results);
+    const { analysis, docs } = generateDocs(input, root);
+    const results = writeDocs(root, docs, options.force, options.dryRun);
+    printSummary(analysis, modeSummary(input), results, inspectProjectCare(root));
     if (options.dryRun) {
         console.log("\nPreviews:");
         for (const doc of docs) {

package/dist/commands/update.js

@@ -4,14 +4,21 @@ import { printBanner } from "../utils/banner.js";
 import { isoDate } from "../utils/date.js";
 export function runUpdate(newInformation, options) {
     const root = options.path ?? process.cwd();
-    const files = ["GASLIGHTING.md", "PRD.md", "ASSUMPTIONS.md", "MISSING_INFO.md", "MEMORY.md"];
+    const files = [
+        ".gaslighting/GASLIGHTING.md",
+        ".gaslighting/PRD.md",
+        ".gaslighting/ASSUMPTIONS.md",
+        ".gaslighting/MISSING_INFO.md",
+        ".gaslighting/MEMORY.md",
+        ".gaslighting/PROJECT_CARE.md",
+    ];
     const block = `\n\n## Update: ${isoDate()}\n\nNew information:\n\n> ${newInformation}\n\nThis information supersedes conflicting assumptions. Do not silently overwrite old assumptions; treat earlier conflicts as outdated and preserve the change record in DECISION_LOG.md.\n`;
     if (options.dryRun) {
         printBanner("UPDATE DRY RUN");
         console.log("Dry run update would touch:");
         for (const file of files)
             console.log(`- ${file}`);
-        console.log("- DECISION_LOG.md");
+        console.log("- .gaslighting/DECISION_LOG.md");
         return;
     }
     for (const file of files) {
@@ -19,17 +26,17 @@ export function runUpdate(newInformation, options) {
         if (existsSync(path))
             appendFileSync(path, block, "utf8");
     }
-    const decisionPath = join(root, "DECISION_LOG.md");
+    const decisionPath = join(root, ".gaslighting/DECISION_LOG.md");
     const decision = `\n\n## Decision: Update project information\n\nDate: ${isoDate()}\n\n### Decision\n\nRecord new project information:\n\n> ${newInformation}\n\n### Reason\n\nThe project assumptions changed or became more specific.\n\n### Alternatives Considered\n\n- Ignore the new information.\n- Silently overwrite old assumptions.\n\n### Why Alternatives Were Not Chosen\n\nIgnoring or silently overwriting information breaks traceability.\n\n### Risk\n\nExisting generated documents may still contain outdated wording that needs human review.\n\n### Revisit When\n\nFurther confirmed information changes scope, stack, audience, or production constraints.\n`;
     if (existsSync(decisionPath))
         appendFileSync(decisionPath, decision, "utf8");
     else
         writeFileSync(decisionPath, `# DECISION_LOG.md${decision}`, "utf8");
-    const assumptionsPath = join(root, "ASSUMPTIONS.md");
+    const assumptionsPath = join(root, ".gaslighting/ASSUMPTIONS.md");
     if (existsSync(assumptionsPath)) {
         const current = readFileSync(assumptionsPath, "utf8");
         writeFileSync(assumptionsPath, current.replaceAll("Status: Active", "Status: Active\n\nOutdated if contradicted by the latest update"), "utf8");
     }
     printBanner("UPDATE COMPLETE");
-    console.log("Updated documents with new information and appended DECISION_LOG.md.");
+    console.log("Updated documents with new information and appended .gaslighting/DECISION_LOG.md.");
 }

package/dist/core/generateDocs.js

@@ -1,8 +1,10 @@
 import { analyze } from "./analyze.js";
 import { generateGaslightingMarkdown } from "./generateGaslightingMarkdown.js";
 import { generatePrdMarkdown } from "./generatePrdMarkdown.js";
+import { generateProjectCareMarkdown } from "./projectCare.js";
 import { generateAgentsMarkdown, generateAssumptionsMarkdown, generateCodexPromptMarkdown, generateCodexSlashPromptMarkdown, generateDecisionLogMarkdown, generateMemoryMarkdown, generateMissingInfoMarkdown, generateSkillMarkdown, generateSkillOpenAiYaml, generateSkillReferenceDocs, generateStackPolicyMarkdown, } from "./generateOtherMarkdown.js";
-export function generateDocs(input) {
+const disciplineDir = ".gaslighting";
+export function generateDocs(input, root = process.cwd()) {
     const normalized = {
         ...input,
         mode: input.mode ?? "standard",
@@ -10,15 +12,17 @@ export function generateDocs(input) {
     };
     const analysis = analyze(normalized);
     const docs = [
-        { filename: "GASLIGHTING.md", content: generateGaslightingMarkdown(normalized, analysis) },
-        { filename: "PRD.md", content: generatePrdMarkdown(normalized, analysis) },
-        { filename: "ASSUMPTIONS.md", content: generateAssumptionsMarkdown(analysis) },
-        { filename: "MISSING_INFO.md", content: generateMissingInfoMarkdown(analysis) },
-        { filename: "DECISION_LOG.md", content: generateDecisionLogMarkdown(normalized, analysis) },
-        { filename: "MEMORY.md", content: generateMemoryMarkdown(normalized, analysis) },
-        { filename: "STACK_POLICY.md", content: generateStackPolicyMarkdown(analysis) },
-        { filename: "AGENTS.md", content: generateAgentsMarkdown() },
-        { filename: "CODEX_PROMPT.md", content: generateCodexPromptMarkdown() },
+        { filename: `${disciplineDir}/GASLIGHTING.md`, content: generateGaslightingMarkdown(normalized, analysis) },
+        { filename: `${disciplineDir}/PRD.md`, content: generatePrdMarkdown(normalized, analysis) },
+        { filename: `${disciplineDir}/ASSUMPTIONS.md`, content: generateAssumptionsMarkdown(analysis) },
+        { filename: `${disciplineDir}/MISSING_INFO.md`, content: generateMissingInfoMarkdown(analysis) },
+        { filename: `${disciplineDir}/DECISION_LOG.md`, content: generateDecisionLogMarkdown(normalized, analysis) },
+        { filename: `${disciplineDir}/MEMORY.md`, content: generateMemoryMarkdown(normalized, analysis) },
+        { filename: `${disciplineDir}/STACK_POLICY.md`, content: generateStackPolicyMarkdown(analysis) },
+        { filename: `${disciplineDir}/PROJECT_CARE.md`, content: generateProjectCareMarkdown(normalized, analysis, root) },
+        { filename: `${disciplineDir}/AGENTS.md`, content: generateAgentsMarkdown() },
+        { filename: `${disciplineDir}/CODEX_PROMPT.md`, content: generateCodexPromptMarkdown() },
+        { filename: "AGENTS.md", content: generateRootAgentsMarkdown() },
         { filename: ".codex/prompts/gaslighting.md", content: generateCodexSlashPromptMarkdown() },
         { filename: ".codex/skills/gaslighting/SKILL.md", content: generateSkillMarkdown() },
         { filename: ".codex/skills/gaslighting/agents/openai.yaml", content: generateSkillOpenAiYaml() },
@@ -50,9 +54,47 @@ export function generateCodexInstallDocs() {
         ...skillDocs,
         { filename: ".codex/prompts/gaslighting.md", content: generateCodexSlashPromptMarkdown() },
         { filename: ".agents/prompts/gaslighting.md", content: generateCodexSlashPromptMarkdown() },
-        { filename: "CODEX_GASLIGHTING.md", content: generateCodexPromptMarkdown() },
+        { filename: ".gaslighting/CODEX_GASLIGHTING.md", content: generateCodexPromptMarkdown() },
     ];
 }
 export function generateOnlyAgentsDoc() {
-    return [{ filename: "AGENTS.md", content: generateAgentsMarkdown() }];
+    return [
+        { filename: `${disciplineDir}/AGENTS.md`, content: generateAgentsMarkdown() },
+        { filename: "AGENTS.md", content: generateRootAgentsMarkdown() },
+    ];
+}
+export function generateProjectCareDoc(input, root = process.cwd()) {
+    const normalized = {
+        ...input,
+        mode: input.mode ?? "standard",
+        language: input.language ?? "en",
+    };
+    const analysis = analyze(normalized);
+    return [{ filename: `${disciplineDir}/PROJECT_CARE.md`, content: generateProjectCareMarkdown(normalized, analysis, root) }];
+}
+function generateRootAgentsMarkdown() {
+    return `# AGENTS.md
+
+This repository uses Gaslighting-engine.
+
+The main discipline documents live under \`.gaslighting/\` to avoid cluttering the project root.
+
+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/PROJECT_CARE.md\`
+9. \`.gaslighting/AGENTS.md\`
+
+Do not reduce scope.
+
+Do not fake completion.
+
+If care risks are missing or unresolved, record them in \`.gaslighting/PROJECT_CARE.md\` and continue unless they truly block implementation.
+`;
 }

package/dist/core/generateOtherMarkdown.js

@@ -216,13 +216,14 @@ This repository uses Gaslighting-engine.
 
 Before doing any work, read these files in order:
 
-1. \`GASLIGHTING.md\`
-2. \`PRD.md\`
-3. \`STACK_POLICY.md\`
-4. \`MISSING_INFO.md\`
-5. \`ASSUMPTIONS.md\`
-6. \`DECISION_LOG.md\`
-7. \`MEMORY.md\`
+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/PROJECT_CARE.md\`
 
 ## Prime Directive
 
@@ -251,8 +252,9 @@ A task is complete only when:
 - The output can actually be used.
 - New assumptions are documented.
 - New technical decisions are recorded.
-- Stable project facts are recorded in \`MEMORY.md\`.
-- The result does not contradict \`GASLIGHTING.md\`.
+- Stable project facts are recorded in \`.gaslighting/MEMORY.md\`.
+- Operational risks are recorded in \`.gaslighting/PROJECT_CARE.md\`.
+- The result does not contradict \`.gaslighting/GASLIGHTING.md\`.
 
 If the task is incomplete, say it is incomplete.
 
@@ -268,7 +270,7 @@ It is inspired by agent memory systems, but it is not a vague diary.
 
 It records stable project facts, recurring workflow rules, known failure patterns, and decisions that future AI-agent sessions must not forget.
 
-Keep required rules in \`AGENTS.md\`, \`GASLIGHTING.md\`, and checked-in documents. Treat this file as a compact recall layer, not the only source of truth.
+Keep required rules in root \`AGENTS.md\`, \`.gaslighting/GASLIGHTING.md\`, and checked-in documents. Treat this file as a compact recall layer, not the only source of truth.
 
 ## Stable Project Facts
 
@@ -305,7 +307,7 @@ These are cleanup and verification rules:
 - Zero unexplained scope reductions.
 - Zero unverified success claims.
 - Every destructive cleanup must be intentional and explainable.
-- If code or files are removed, record why in \`DECISION_LOG.md\`.
+- If code or files are removed, record why in \`.gaslighting/DECISION_LOG.md\`.
 
 ## Memory Write Rules
 
@@ -323,7 +325,7 @@ ${bullets(analysis.assumptions)}
 export function generateSkillMarkdown() {
     return `---
 name: gaslighting
-description: Generate or update strict project discipline documents for Codex and AI coding agents. Use when a user asks to initialize Gaslighting, create GASLIGHTING.md/PRD.md/AGENTS.md discipline files, preserve full project scope, prevent TODO escape, prevent fake completion, or turn vague project intent into actionable control documents.
+description: Generate or update strict .gaslighting project discipline documents for Codex and AI coding agents. Use when a user asks to initialize Gaslighting, create GASLIGHTING.md/PRD.md/AGENTS.md discipline files, preserve full project scope, prevent TODO escape, prevent fake completion, track Git/GitHub/domain/deployment care risks, or turn vague project intent into actionable control documents.
 ---
 
 # Gaslighting-engine Skill
@@ -339,13 +341,14 @@ Instead:
 3. Make reasonable assumptions.
 4. Document assumptions clearly.
 5. Mark missing information clearly.
-6. Generate \`GASLIGHTING.md\`.
-7. Generate \`PRD.md\`.
-8. Generate \`ASSUMPTIONS.md\`.
-9. Generate \`MISSING_INFO.md\`.
-10. Generate \`DECISION_LOG.md\`.
-11. Generate \`STACK_POLICY.md\`.
-12. Generate or update \`AGENTS.md\`.
+6. Generate \`.gaslighting/GASLIGHTING.md\`.
+7. Generate \`.gaslighting/PRD.md\`.
+8. Generate \`.gaslighting/ASSUMPTIONS.md\`.
+9. Generate \`.gaslighting/MISSING_INFO.md\`.
+10. Generate \`.gaslighting/DECISION_LOG.md\`.
+11. Generate \`.gaslighting/STACK_POLICY.md\`.
+12. Generate or update root \`AGENTS.md\`.
+13. Generate \`.gaslighting/PROJECT_CARE.md\`.
 
 ## Hardcore Discipline Rule
 
@@ -410,6 +413,10 @@ Avoid over-engineering.
 
 Create real markdown files.
 
+Keep main project-control files in \`.gaslighting/\` and keep only the Codex pointer \`AGENTS.md\` in the repository root.
+
+Use \`.gaslighting/PROJECT_CARE.md\` to track Git/GitHub/domain/deployment/launch risks without blocking implementation.
+
 Do not only explain.
 
 Do not produce a plan without files.
@@ -439,14 +446,15 @@ Copy and paste this into Codex:
 
 Read the following files before doing any work:
 
-1. \`GASLIGHTING.md\`
-2. \`PRD.md\`
-3. \`STACK_POLICY.md\`
-4. \`MISSING_INFO.md\`
-5. \`ASSUMPTIONS.md\`
-6. \`DECISION_LOG.md\`
+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. \`AGENTS.md\`
-8. \`MEMORY.md\`
+8. \`.gaslighting/MEMORY.md\`
+9. \`.gaslighting/PROJECT_CARE.md\`
 
 Then implement the project MVP.
 
@@ -462,7 +470,7 @@ Rules:
 - Do not forget the project purpose.
 - If something is incomplete, declare it explicitly.
 
-Before claiming completion, perform the self-audit in \`GASLIGHTING.md\`.
+Before claiming completion, perform the self-audit in \`.gaslighting/GASLIGHTING.md\`.
 
 Proceed.
 `;
@@ -472,14 +480,15 @@ export function generateCodexSlashPromptMarkdown() {
 
 Read the Gaslighting-engine project-control files before doing any work:
 
-1. \`GASLIGHTING.md\`
-2. \`PRD.md\`
-3. \`STACK_POLICY.md\`
-4. \`MISSING_INFO.md\`
-5. \`ASSUMPTIONS.md\`
-6. \`DECISION_LOG.md\`
+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. \`AGENTS.md\`
-8. \`MEMORY.md\`
+8. \`.gaslighting/MEMORY.md\`
+9. \`.gaslighting/PROJECT_CARE.md\`
 
 Then execute the user's requested implementation.
 
@@ -493,11 +502,12 @@ Rules:
 - Do not call scaffolding completion.
 - Do not call placeholders implementation.
 - Do not over-engineer.
-- Record stable project facts in \`MEMORY.md\`.
-- Record product and technical decisions in \`DECISION_LOG.md\`.
+- Record stable project facts in \`.gaslighting/MEMORY.md\`.
+- Record product and technical decisions in \`.gaslighting/DECISION_LOG.md\`.
+- Record Git/GitHub/domain/deployment risks in \`.gaslighting/PROJECT_CARE.md\`.
 - If something is incomplete, declare it explicitly.
 
-Before claiming completion, perform the self-audit in \`GASLIGHTING.md\`.
+Before claiming completion, perform the self-audit in \`.gaslighting/GASLIGHTING.md\`.
 `;
 }
 export function generateSkillReferenceDocs() {

package/dist/core/projectCare.js

@@ -0,0 +1,135 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { decisionDate, projectPurpose } from "./content.js";
+export function inspectProjectCare(root) {
+    const isGitRepository = runGit(root, ["rev-parse", "--is-inside-work-tree"]) === "true";
+    const gitBranch = isGitRepository ? runGit(root, ["branch", "--show-current"]) : undefined;
+    const gitRemoteOrigin = isGitRepository ? runGit(root, ["remote", "get-url", "origin"]) : undefined;
+    const hasGitHubRemote = Boolean(gitRemoteOrigin && /github\.com[:/]/i.test(gitRemoteOrigin));
+    const hasPackageJson = existsSync(join(root, "package.json"));
+    const hasVercelConfig = existsSync(join(root, "vercel.json"));
+    const hasEnvExample = existsSync(join(root, ".env.example"));
+    const checks = [
+        {
+            label: "Git repository",
+            ok: isGitRepository,
+            status: isGitRepository ? "pass" : "warn",
+            message: isGitRepository ? `Git repository detected${gitBranch ? ` on branch ${gitBranch}` : ""}.` : "Git repository is not initialized.",
+            action: isGitRepository ? "Keep committing discipline and implementation changes." : "Ask the user for a GitHub repository URL, then run git init, git remote add origin <url>, commit, and push.",
+        },
+        {
+            label: "GitHub remote",
+            ok: hasGitHubRemote,
+            status: hasGitHubRemote ? "pass" : "warn",
+            message: hasGitHubRemote ? `GitHub remote detected: ${gitRemoteOrigin}` : gitRemoteOrigin ? `Remote exists but is not GitHub: ${gitRemoteOrigin}` : "No origin remote is configured.",
+            action: hasGitHubRemote ? "Record repository decisions in DECISION_LOG.md when remote ownership changes." : "Request the GitHub URL or recommend connecting GitHub before production work continues.",
+        },
+        {
+            label: "Project package file",
+            ok: hasPackageJson,
+            status: hasPackageJson ? "pass" : "warn",
+            message: hasPackageJson ? "package.json exists." : "package.json is missing.",
+            action: hasPackageJson ? "Keep scripts and package metadata aligned with project purpose." : "Create package.json when implementation starts, unless this is not a Node project.",
+        },
+        {
+            label: "Deployment target",
+            ok: hasVercelConfig,
+            status: hasVercelConfig ? "pass" : "warn",
+            message: hasVercelConfig ? "vercel.json exists." : "No explicit deployment config detected.",
+            action: "Confirm deployment target, production domain, preview environment, and rollback path before launch.",
+        },
+        {
+            label: "Environment template",
+            ok: hasEnvExample,
+            status: hasEnvExample ? "pass" : "warn",
+            message: hasEnvExample ? ".env.example exists." : ".env.example is missing.",
+            action: "Add .env.example before sharing the project so required secrets are visible without exposing real values.",
+        },
+    ];
+    return {
+        isGitRepository,
+        gitBranch,
+        gitRemoteOrigin,
+        hasGitHubRemote,
+        hasPackageJson,
+        hasVercelConfig,
+        hasEnvExample,
+        checks,
+    };
+}
+export function generateProjectCareMarkdown(input, analysis, root) {
+    const care = inspectProjectCare(root);
+    const purpose = projectPurpose(analysis.projectType);
+    return `# PROJECT_CARE.md
+
+This file is the project-care ledger for Gaslighting-engine.
+
+It is not a blocker wall.
+
+It is the place where the agent keeps noticing operational risk, ownership gaps, Git/GitHub status, deployment readiness, domain ownership, and missing production decisions.
+
+The agent must treat this project as mission-critical. If something can put delivery, trust, data, launch, SEO, legal compliance, or operations at risk, record it here and keep pushing it forward.
+
+## Project Snapshot
+
+- Date: ${decisionDate()}
+- Original request: ${input.rawUserRequest}
+- Project type: ${analysis.projectType}
+- Classification confidence: ${analysis.confidence}
+- Project purpose:
+${purpose.map((item) => `  - ${item}`).join("\n")}
+
+## Git And GitHub Registry
+
+| Item | Status | Next Action |
+|---|---|---|
+| Git repository | ${care.isGitRepository ? `Detected${care.gitBranch ? `, branch \`${care.gitBranch}\`` : ""}` : "Missing"} | ${care.isGitRepository ? "Commit meaningful checkpoints." : "Ask for GitHub URL, then initialize git and connect origin."} |
+| Origin remote | ${care.gitRemoteOrigin ? `\`${care.gitRemoteOrigin}\`` : "Missing"} | ${care.gitRemoteOrigin ? "Keep remote ownership recorded when it changes." : "Ask for GitHub URL or recommend GitHub connection."} |
+| GitHub remote | ${care.hasGitHubRemote ? "Detected" : "Missing or non-GitHub"} | ${care.hasGitHubRemote ? "Use GitHub as the source-of-truth remote." : "Connect GitHub before production handoff if possible."} |
+
+## Domain And Deployment Registry
+
+| Item | Current Status | Risk | Next Action |
+|---|---|---|---|
+| Production domain | Missing | Users cannot reach production reliably. | Confirm domain owner, DNS provider, and final domain. |
+| DNS provider | Missing | Launch can be delayed by DNS access issues. | Record provider, account owner, and nameserver strategy. |
+| Deployment target | ${care.hasVercelConfig ? "Vercel config detected" : "Not confirmed"} | Environment drift and launch confusion. | Confirm Vercel, Netlify, Cloudflare, or other target. |
+| Preview URL policy | Missing | Stakeholders cannot review safely. | Decide preview deployment workflow. |
+| Rollback path | Missing | Production incidents become slower to recover. | Define rollback command/provider workflow. |
+
+## Care Checklist
+
+${care.checks.map((check) => `- [${check.ok ? "x" : " "}] ${check.label}: ${check.message} Next: ${check.action}`).join("\n")}
+- [ ] Production domain confirmed.
+- [ ] DNS owner confirmed.
+- [ ] Deployment provider confirmed.
+- [ ] Analytics ownership confirmed.
+- [ ] Form/email delivery owner confirmed.
+- [ ] Privacy/legal review path confirmed.
+- [ ] Launch checklist created before production release.
+
+## Agent Care Rules
+
+- Do not stop implementation just because an operational detail is missing.
+- Do make a practical assumption, record it, and keep moving.
+- If Git is not initialized, ask for a GitHub URL and offer the exact commands.
+- If Git is initialized but no GitHub remote exists, ask for the remote URL and offer \`git remote add origin <url>\`.
+- If GitHub is connected, record the remote URL here and in \`DECISION_LOG.md\` when it changes.
+- If domain or deployment details are missing, keep warning until they are confirmed.
+- Treat missing domain, deployment, analytics, email, and privacy ownership as mission-critical launch risks, not as reasons to abandon the task.
+- Never turn care warnings into fake blockers.
+
+## Current Care Warnings
+
+${care.checks.filter((check) => !check.ok).map((check) => `- ${check.label}: ${check.message} Action: ${check.action}`).join("\n") || "- No care warnings detected right now."}
+`;
+}
+function runGit(root, args) {
+    try {
+        return execFileSync("git", args, { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/index.js

@@ -1,3 +1,5 @@
 #!/usr/bin/env node
 import { buildCli, normalizeDefaultInitArgv } from "./cli.js";
+import { notifyIfUpdateAvailable } from "./utils/updateCheck.js";
+await notifyIfUpdateAvailable(process.argv);
 buildCli().parse(normalizeDefaultInitArgv(process.argv));

package/dist/utils/logger.js

@@ -1,5 +1,5 @@
 import { printBanner } from "./banner.js";
-export function printSummary(analysis, modeLines, results) {
+export function printSummary(analysis, modeLines, results, care) {
     printBanner("DOCUMENT GENERATOR");
     console.log(`Detected project type: ${analysis.projectType}`);
     console.log(`Confidence: ${analysis.confidence}`);
@@ -22,6 +22,14 @@ export function printSummary(analysis, modeLines, results) {
                     : "";
         console.log(`- ${result.filename}${suffix}`);
     }
+    if (care) {
+        const warnings = care.checks.filter((check) => !check.ok);
+        console.log("\nCare:");
+        if (warnings.length === 0)
+            console.log("- PASS Git/GitHub and local care checks look stable.");
+        for (const warning of warnings)
+            console.log(`- WARN ${warning.label}: ${warning.message} Next: ${warning.action}`);
+    }
     console.log('\nNext:\nOpen Codex and say:\n');
-    console.log('"Read GASLIGHTING.md, PRD.md, STACK_POLICY.md, MISSING_INFO.md, ASSUMPTIONS.md, DECISION_LOG.md, MEMORY.md, and AGENTS.md. Implement the MVP without shrinking scope, without TODO escape, and without fake completion."');
+    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, and .gaslighting/PROJECT_CARE.md. Implement the MVP without shrinking scope, without TODO escape, and without fake completion."');
 }

package/dist/utils/updateCheck.js

@@ -0,0 +1,61 @@
+import { packageName, packageVersion } from "../version.js";
+const updateCheckTimeoutMs = 900;
+export async function notifyIfUpdateAvailable(argv) {
+    if (shouldSkipUpdateCheck(argv))
+        return;
+    try {
+        const latestVersion = process.env.GASLIGHTING_ENGINE_LATEST_VERSION ?? (await fetchLatestVersion());
+        if (!latestVersion || !isNewerVersion(latestVersion, packageVersion))
+            return;
+        console.error("");
+        console.error("Gaslighting-engine update available:");
+        console.error(`- current: ${packageVersion}`);
+        console.error(`- latest:  ${latestVersion}`);
+        console.error(`- update:  npm install -g ${packageName}@latest`);
+        console.error(`- npx:     npx ${packageName}@latest`);
+        console.error("");
+    }
+    catch {
+        // Update checks must never block the user's actual command.
+    }
+}
+async function fetchLatestVersion() {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), updateCheckTimeoutMs);
+    try {
+        const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`, {
+            signal: controller.signal,
+            headers: { accept: "application/json" },
+        });
+        if (!response.ok)
+            return undefined;
+        const data = (await response.json());
+        return data.version;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function shouldSkipUpdateCheck(argv) {
+    if (process.env.GASLIGHTING_ENGINE_NO_UPDATE_CHECK === "1")
+        return true;
+    if (process.env.NO_UPDATE_NOTIFIER === "1")
+        return true;
+    return argv.some((arg) => ["--help", "-h", "--version", "-V"].includes(arg));
+}
+export function isNewerVersion(candidate, current) {
+    const candidateParts = parseVersion(candidate);
+    const currentParts = parseVersion(current);
+    for (let index = 0; index < 3; index += 1) {
+        if (candidateParts[index] > currentParts[index])
+            return true;
+        if (candidateParts[index] < currentParts[index])
+            return false;
+    }
+    return false;
+}
+function parseVersion(version) {
+    const clean = version.split("-")[0] ?? version;
+    const parts = clean.split(".").map((part) => Number.parseInt(part, 10));
+    return [parts[0] || 0, parts[1] || 0, parts[2] || 0];
+}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const packageName = "gaslighting-engine";
+export const packageVersion = "0.2.0";

package/docs/codex-usage.md

@@ -16,7 +16,7 @@ This installs:
 - `.codex/skills/gaslighting/agents/openai.yaml`
 - `.agents/prompts/gaslighting.md`
 - `.codex/prompts/gaslighting.md`
-- `CODEX_GASLIGHTING.md`
+- `.gaslighting/CODEX_GASLIGHTING.md`
 
 Then use the skill in Codex:
 
@@ -49,10 +49,10 @@ gaslighting-engine "I want to build a hospital website."
 Then ask Codex:
 
 ```txt
-Read GASLIGHTING.md, PRD.md, STACK_POLICY.md, MISSING_INFO.md, ASSUMPTIONS.md, DECISION_LOG.md, MEMORY.md, and AGENTS.md.
+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, and .gaslighting/PROJECT_CARE.md.
 Implement the MVP without shrinking scope, without TODO escape, and without fake completion.
 ```
 
-Codex should treat `AGENTS.md` as project guidance and `GASLIGHTING.md` as the anti-escape contract.
+Codex should treat root `AGENTS.md` as the project guidance pointer and `.gaslighting/GASLIGHTING.md` as the anti-escape contract.
 
-The CLI also generates Codex Skill files, prompt fallback files, and `CODEX_GASLIGHTING.md` so the workflow still works when a specific Codex surface does not expose a custom slash entry.
+The CLI also generates Codex Skill files, prompt fallback files, `.gaslighting/CODEX_GASLIGHTING.md`, and `.gaslighting/PROJECT_CARE.md` so the workflow still works when a specific Codex surface does not expose a custom slash entry.

package/docs/examples.md

@@ -20,3 +20,17 @@ Published usage:
 ```bash
 npx gaslighting-engine "I want to build a hospital website."
 ```
+
+This writes discipline documents under `.gaslighting/` and keeps only the Codex pointer `AGENTS.md` in the root.
+
+Project-care refresh:
+
+```bash
+npx gaslighting-engine care "I want to build a hospital website." --force
+```
+
+Update check test:
+
+```bash
+GASLIGHTING_ENGINE_LATEST_VERSION=9.9.9 node dist/index.js doctor --path examples/hospital-homepage
+```