codex-genesis-harness 0.1.7 → 0.1.9

package/.codebase/state.json

@@ -1,37 +1,176 @@
 {
   "current_state": "COMPLETED",
+  "active_work": "",
+  "session_id": "2026-06-12-lifecycle-pipeline-hardening",
+  "session_started_at": "2026-06-12T16:47:17+07:00",
+  "ttfv_seconds": 180,
+  "_comment_ttfv": "Time-to-First-Verification: 180s from session start to first passing targeted lifecycle test.",
+  "latest_handoff": ".codebase/IMPLEMENTATION_HANDOFF.md",
+  "latest_recovery_point": "End-to-end lifecycle pipeline verified with project closure and audit",
+  "required_verification": [
+    "npm run verify",
+    "npm run eval",
+    "npm run pack:check",
+    "node tests/unit/feature_registry.test.js",
+    "node scripts/cold-start-check.js",
+    "node bin/genesis-harness.js docs-gate",
+    "node bin/genesis-harness.js leanctx",
+    "node tests/unit/verify_gate.test.js",
+    "node tests/unit/workflow_contracts.test.js",
+    "node tests/integration/cli-smoke.test.js",
+    "node tests/unit/state_metadata.test.js",
+    "node tests/unit/repository_hygiene.test.js",
+    "node bin/genesis-harness.js verify-gate"
+  ],
   "history": [
     {
-      "from": "INIT",
-      "to": "REQUIREMENTS_GATHERING",
-      "reason": "Started Gathering",
-      "timestamp": "2026-05-31T05:39:53.706Z"
+      "from": "IMPLEMENTATION",
+      "to": "COMPLETED",
+      "reason": "Added project feature registry routing, evidence-gated feature completion, lifecycle metrics, observability output, and repository hygiene enforcement.",
+      "timestamp": "2026-06-12T16:50:17+07:00",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
+    },
+    {
+      "from": "COMPLETED",
+      "to": "COMPLETED",
+      "reason": "Prepared README and changelog notes for the v0.1.9 release and verified package contents.",
+      "timestamp": "2026-06-11T10:25:00+07:00",
+      "session_id": "2026-06-11-release-readme-prep"
+    },
+    {
+      "from": "IMPLEMENTATION",
+      "to": "COMPLETED",
+      "reason": "Runtime pipeline now emits API/UI-specific contracts and fixtures for the first scaffolded feature slice.",
+      "timestamp": "2026-06-10T10:25:00Z",
+      "session_id": "2026-06-10-typed-first-slice-bootstrap"
+    },
+    {
+      "from": "IMPLEMENTATION",
+      "to": "COMPLETED",
+      "reason": "Runtime pipeline now auto-scaffolds the first execution-ready feature and persists the active feature checkpoint for resume.",
+      "timestamp": "2026-06-10T10:05:00Z",
+      "session_id": "2026-06-10-feature-execution-bootstrap"
+    },
+    {
+      "from": "VERIFICATION",
+      "to": "COMPLETED",
+      "reason": "Harness drift gate hardening completed with source-of-truth, handoff, state, and CLI smoke verification gates.",
+      "timestamp": "2026-06-03T08:31:59+07:00",
+      "session_id": "2026-06-03-drift-gate"
+    },
+    {
+      "from": "VERIFICATION",
+      "to": "COMPLETED",
+      "reason": "LeanCTX policy, CLI reporting, prompt sentinel thresholds, and portable npm-user command guidance added.",
+      "timestamp": "2026-06-03T09:06:31+07:00",
+      "session_id": "2026-06-03-leanctx"
+    },
+    {
+      "from": "VERIFICATION",
+      "to": "COMPLETED",
+      "reason": "LeanCTX policy auto-seeding added for install and npm postinstall without overwriting project custom policy.",
+      "timestamp": "2026-06-03T09:28:41+07:00",
+      "session_id": "2026-06-03-leanctx-seed"
+    },
+    {
+      "from": "COMPLETED",
+      "to": "IMPLEMENTATION",
+      "reason": "Started full harness evaluation and score fix: L08 feature registry, L11 observability live, L04 instruction size, L03 cold-start, L05 session boundary, L07 scope, L09 victory blocker, L12 known problems.",
+      "timestamp": "2026-06-03T02:35:00Z",
+      "session_id": "2026-06-03-full-score-fix"
+    },
+    {
+      "from": "COMPLETED",
+      "to": "IMPLEMENTATION",
+      "reason": "Implement end-to-end multi-feature project lifecycle",
+      "timestamp": "2026-06-12T10:03:52.067Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
     },
     {
-      "from": "REQUIREMENTS_GATHERING",
-      "to": "PLANNING",
-      "reason": "p",
-      "timestamp": "2026-05-31T05:51:07.765Z"
+      "from": "IMPLEMENTATION",
+      "to": "VERIFICATION",
+      "reason": "Run full lifecycle and repository verification",
+      "timestamp": "2026-06-12T10:03:52.118Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
     },
     {
-      "from": "PLANNING",
+      "from": "VERIFICATION",
       "to": "IMPLEMENTATION",
-      "reason": "i",
-      "timestamp": "2026-05-31T05:51:07.883Z"
+      "reason": "Refresh lifecycle metadata after transition script fix",
+      "timestamp": "2026-06-12T10:04:41.327Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
     },
     {
       "from": "IMPLEMENTATION",
       "to": "VERIFICATION",
-      "reason": "v",
-      "timestamp": "2026-05-31T05:51:08.001Z"
+      "reason": "Run full lifecycle and repository verification",
+      "timestamp": "2026-06-12T10:04:41.409Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
     },
     {
       "from": "VERIFICATION",
+      "to": "IMPLEMENTATION",
+      "reason": "Refresh current-state metadata contract",
+      "timestamp": "2026-06-12T10:05:21.693Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
+    },
+    {
+      "from": "IMPLEMENTATION",
+      "to": "VERIFICATION",
+      "reason": "Run full lifecycle and repository verification",
+      "timestamp": "2026-06-12T10:05:21.810Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
+    },
+    {
+      "from": "VERIFICATION",
+      "to": "RELEASE_READY",
+      "reason": "All feature and project verification gates passed",
+      "timestamp": "2026-06-12T10:05:54.545Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
+    },
+    {
+      "from": "RELEASE_READY",
+      "to": "COMPLETED",
+      "reason": "End-to-end lifecycle pipeline verified with project closure and audit",
+      "timestamp": "2026-06-12T10:06:47.807Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
+    },
+    {
+      "from": "COMPLETED",
+      "to": "IMPLEMENTATION",
+      "reason": "Refresh completed-state metadata behavior",
+      "timestamp": "2026-06-12T10:07:09.243Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
+    },
+    {
+      "from": "IMPLEMENTATION",
+      "to": "VERIFICATION",
+      "reason": "Final verification after state writer hardening",
+      "timestamp": "2026-06-12T10:07:09.342Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
+    },
+    {
+      "from": "VERIFICATION",
+      "to": "RELEASE_READY",
+      "reason": "Canonical verify-gate passed for end-to-end lifecycle",
+      "timestamp": "2026-06-12T10:07:09.466Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
+    },
+    {
+      "from": "RELEASE_READY",
       "to": "COMPLETED",
-      "reason": "testing complete transition",
-      "timestamp": "2026-05-31T05:53:47.517Z"
+      "reason": "End-to-end lifecycle pipeline verified with project closure and audit",
+      "timestamp": "2026-06-12T10:07:37.415Z",
+      "session_id": "2026-06-12-lifecycle-pipeline-hardening"
     }
   ],
-  "context": {},
-  "pending_tasks": []
+  "context": {
+    "package_version": "0.1.9",
+    "verification_owner": "scripts/run-evals.sh",
+    "context_policy": ".codebase/context-policy.json",
+    "evaluation_report": ".codebase/../artifacts/harness_evaluation_report.md"
+  },
+  "pending_tasks": [],
+  "last_updated_at": "2026-06-12T10:07:37.415Z",
+  "completed_at": "2026-06-12T10:07:37.415Z"
 }

package/.codex/skills/genesis-architecture/SKILL.md

@@ -44,3 +44,8 @@ Changing dependency direction silently, documenting intent without tests, and sc
 ## Recovery workflow
 If architecture drift is found, stop feature work, create a failing boundary test, update the contract, then repair the smallest module slice.
 
+## MCP Automation Requirements
+
+To ensure that architectural decisions are properly contextualized and persisted across the entire lifecycle of the project, you **MUST** use the following MCP server:
+1. **`@modelcontextprotocol/server-memory`**: Use this MCP tool to automatically query the Knowledge Graph for past architectural decisions, trade-offs, and boundary definitions before making any new system-wide changes. After establishing a new architecture rule, you must save it to the memory graph.
+

package/.codex/skills/genesis-debug-guide/SKILL.md

@@ -161,13 +161,13 @@ Update `.codebase` memory after meaningful changes.
    - Update documentation if behavior changed
 ```
 
-## Auto-Trigger Workflow (Post /fix-bug)
+## Auto-Trigger Workflow (Post /fix-bug or Heal Directive)
 
-When `/fix-bug` completes successfully:
+When `/fix-bug` completes successfully, or when you receive the `[AGENT_DIRECTIVE] TESTS FAILED` from `genesis-harness heal`:
 
 ```yaml
-Hook: PostToolUse → "/fix-bug completed"
-Action: Activate genesis-debug-guide
+Hook: PostToolUse → "/fix-bug completed" OR "[AGENT_DIRECTIVE] TESTS FAILED" printed to stdout.
+Action: Activate genesis-debug-guide. Do NOT stop until tests pass.
 
 1. Fix Verification (5 min):
    - Run: npm test (or equivalent)
@@ -400,6 +400,12 @@ If debugging effort exceeds 30 minutes:
    - Check GitHub issues/PRs for related bugs
 ```
 
+## MCP Automation Requirements
+
+To systematically isolate and resolve bugs, you **MUST** use the following MCP servers:
+1. **`@modelcontextprotocol/server-puppeteer`**: For any UI, E2E, or visual bug, use this MCP tool to automatically navigate to the local dev server, interact with the UI, reproduce the bug, capture the browser console logs, and take screenshots for Vision analysis.
+2. **`@modelcontextprotocol/server-memory`**: Query the Knowledge Graph to see if this bug is a known regression or if a similar issue has been resolved in the past.
+
 ## Integration with Genesis Harness
 
 **Works with**: