gaslighting-engine 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/.agents/prompts/gaslighting.md +4 -1
  2. package/.agents/skills/gaslighting/SKILL.md +12 -1
  3. package/.codex/prompts/gaslighting.md +4 -1
  4. package/.codex/skills/gaslighting/SKILL.md +12 -1
  5. package/README.md +46 -3
  6. package/dist/cli.js +48 -1
  7. package/dist/commands/cockpit.js +174 -0
  8. package/dist/commands/codexInstall.js +3 -2
  9. package/dist/commands/doctor.js +1 -0
  10. package/dist/commands/upgrade.js +27 -0
  11. package/dist/core/cockpitHtml.js +596 -0
  12. package/dist/core/codexRuntime.js +74 -0
  13. package/dist/core/generateDocs.js +5 -3
  14. package/dist/core/generateOtherMarkdown.js +84 -4
  15. package/dist/index.js +1 -1
  16. package/dist/utils/logger.js +1 -1
  17. package/dist/utils/updateCheck.js +1 -2
  18. package/dist/version.js +1 -1
  19. package/docs/codex-usage.md +24 -4
  20. package/docs/examples.md +4 -0
  21. package/examples/ecommerce/.codex/prompts/gaslighting.md +4 -1
  22. package/examples/ecommerce/.codex/skills/gaslighting/SKILL.md +12 -1
  23. package/examples/ecommerce/.gaslighting/AGENTS.md +3 -1
  24. package/examples/ecommerce/.gaslighting/AGENT_RUNTIME.md +54 -0
  25. package/examples/ecommerce/.gaslighting/CODEX_PROMPT.md +8 -1
  26. package/examples/ecommerce/AGENTS.md +3 -2
  27. package/examples/hospital-homepage/.codex/prompts/gaslighting.md +4 -1
  28. package/examples/hospital-homepage/.codex/skills/gaslighting/SKILL.md +12 -1
  29. package/examples/hospital-homepage/.gaslighting/AGENTS.md +3 -1
  30. package/examples/hospital-homepage/.gaslighting/AGENT_RUNTIME.md +54 -0
  31. package/examples/hospital-homepage/.gaslighting/CODEX_PROMPT.md +8 -1
  32. package/examples/hospital-homepage/AGENTS.md +3 -2
  33. package/examples/landing-page/.codex/prompts/gaslighting.md +4 -1
  34. package/examples/landing-page/.codex/skills/gaslighting/SKILL.md +12 -1
  35. package/examples/landing-page/.gaslighting/AGENTS.md +3 -1
  36. package/examples/landing-page/.gaslighting/AGENT_RUNTIME.md +54 -0
  37. package/examples/landing-page/.gaslighting/CODEX_PROMPT.md +8 -1
  38. package/examples/landing-page/AGENTS.md +3 -2
  39. package/package.json +1 -1
@@ -0,0 +1,54 @@
1
+ # AGENT_RUNTIME.md
2
+
3
+ This file defines how Codex must operate after Gaslighting-engine prepares the project.
4
+
5
+ It is not a suggestion file.
6
+
7
+ It is the runtime loop.
8
+
9
+ ## Mission
10
+
11
+ - Original request: Build a landing page for a new service that captures leads.
12
+ - Project type: landing_page
13
+ - Classification confidence: high
14
+ - Runtime stance: Codex-first, full-scope, no fake completion.
15
+
16
+ ## Required Loop
17
+
18
+ 1. Read the control files before implementation.
19
+ 2. Restate the project purpose in one short paragraph.
20
+ 3. Convert the PRD into a concrete task checklist.
21
+ 4. Implement the checklist systematically.
22
+ 5. Use scripts or structured data for repetitive work.
23
+ 6. Verify the result with build, tests, lint, browser checks, or direct inspection as appropriate.
24
+ 7. Update `.gaslighting/DECISION_LOG.md` when a product or technical decision changes.
25
+ 8. Update `.gaslighting/MISSING_INFO.md` when missing information is discovered or resolved.
26
+ 9. Update `.gaslighting/MEMORY.md` when stable project facts are learned.
27
+ 10. Update `.gaslighting/PROJECT_CARE.md` when GitHub, domain, deployment, env, analytics, email, or launch ownership changes.
28
+
29
+ ## Agent Rules
30
+
31
+ - Do not ask the user for non-blocking information before starting work.
32
+ - Do make a reasonable temporary assumption, document it, and continue.
33
+ - Do not create only the visible surface and ignore operational details.
34
+ - Do not stop at a plan when implementation was requested.
35
+ - Do not call a scaffold complete.
36
+ - Do not call TODO comments implementation.
37
+ - Do not call examples full coverage.
38
+ - Do not hide risk behind confident wording.
39
+ - Do not over-engineer to look sophisticated.
40
+ - Do not under-deliver because the work is repetitive.
41
+
42
+ ## Codex Execution Contract
43
+
44
+ Before claiming completion, Codex must be able to answer:
45
+
46
+ - What exact requested scope was completed?
47
+ - What exact files changed?
48
+ - What verification was run?
49
+ - What assumptions are still active?
50
+ - What missing information remains?
51
+ - What care risks remain?
52
+ - Is anything incomplete?
53
+
54
+ If anything is incomplete, use the failure declaration protocol in `.gaslighting/GASLIGHTING.md`.
@@ -14,7 +14,8 @@ Read the following files before doing any work:
14
14
  6. `.gaslighting/DECISION_LOG.md`
15
15
  7. `AGENTS.md`
16
16
  8. `.gaslighting/MEMORY.md`
17
- 9. `.gaslighting/PROJECT_CARE.md`
17
+ 9. `.gaslighting/AGENT_RUNTIME.md`
18
+ 10. `.gaslighting/PROJECT_CARE.md`
18
19
 
19
20
  Then implement the project MVP.
20
21
 
@@ -32,4 +33,10 @@ Rules:
32
33
 
33
34
  Before claiming completion, perform the self-audit in `.gaslighting/GASLIGHTING.md`.
34
35
 
36
+ To refresh the Codex skill files later, run:
37
+
38
+ ```bash
39
+ npx gaslighting-engine@latest upgrade
40
+ ```
41
+
35
42
  Proceed.
@@ -13,8 +13,9 @@ Before doing any work, read these files in order:
13
13
  5. `.gaslighting/ASSUMPTIONS.md`
14
14
  6. `.gaslighting/DECISION_LOG.md`
15
15
  7. `.gaslighting/MEMORY.md`
16
- 8. `.gaslighting/PROJECT_CARE.md`
17
- 9. `.gaslighting/AGENTS.md`
16
+ 8. `.gaslighting/AGENT_RUNTIME.md`
17
+ 9. `.gaslighting/PROJECT_CARE.md`
18
+ 10. `.gaslighting/AGENTS.md`
18
19
 
19
20
  Do not reduce scope.
20
21
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gaslighting-engine",
3
- "version": "0.2.1",
3
+ "version": "0.3.0",
4
4
  "description": "LUDGI Gaslighting-engine: a hardcore project-discipline generator for AI coding agents.",
5
5
  "type": "module",
6
6
  "license": "MIT",