codex-genesis-harness 0.1.0 → 0.1.4

package/bin/genesis-harness.js

@@ -3,15 +3,41 @@
 
 const fs = require("fs");
 const path = require("path");
-const { spawnSync } = require("child_process");
-
-const packageRoot = path.resolve(__dirname, "..");
-const skillName = "project-genesis-harness";
-const sourceDir = path.join(packageRoot, ".codex", "skills", skillName);
-const codexHome = process.env.CODEX_HOME || path.join(process.env.HOME || "", ".codex");
-const agentsHome = process.env.GENESIS_HARNESS_HOME || path.join(process.env.HOME || "", ".agents");
-const legacyTargetDir = path.join(codexHome, "skills", skillName);
-const agentsTargetDir = path.join(agentsHome, "skills", skillName);
+const { spawnSync } = require("child_process");
+
+const packageRoot = path.resolve(__dirname, "..");
+const skillNames = [
+  "genesis-harness",
+  "genesis-new-design",
+  "genesis-upgrade-design",
+  "genesis-architecture",
+  "genesis-planning",
+  "genesis-codebase-map",
+  "genesis-design-spec",
+  "genesis-api-contract",
+  "ui-ux-test-skill",
+  "genesis-harness-engineering",
+  "genesis-ai-provider",
+  "genesis-pipeline-orchestration",
+  "genesis-research",
+  "genesis-docs",
+  "genesis-release",
+  "genesis-api-sync",
+  "genesis-debug-guide",
+  "genesis-docs-automation",
+  "genesis-spec-propagation",
+  "genesis-release-orchestration",
+  "genesis-performance-profiling",
+  "genesis-observability-automation",
+  "genesis-research-first",
+  "spec-impact-engine"
+];
+const legacySkillNames = ["project-genesis-harness"];
+const sourceRoot = path.join(packageRoot, ".codex", "skills");
+const codexHome = process.env.CODEX_HOME || path.join(process.env.HOME || "", ".codex");
+const agentsHome = process.env.GENESIS_HARNESS_HOME || path.join(process.env.HOME || "", ".agents");
+const legacySkillsRoot = path.join(codexHome, "skills");
+const agentsSkillsRoot = path.join(agentsHome, "skills");
 
 function usage(exitCode = 0) {
   const text = `
@@ -37,12 +63,14 @@ function fail(message) {
   process.exit(1);
 }
 
-function ensureSource() {
-  const skillFile = path.join(sourceDir, "SKILL.md");
-  if (!fs.existsSync(skillFile)) {
-    fail(`missing packaged skill at ${skillFile}`);
-  }
-}
+function ensureSource() {
+  for (const skillName of skillNames) {
+    const skillFile = path.join(sourceRoot, skillName, "SKILL.md");
+    if (!fs.existsSync(skillFile)) {
+      fail(`missing packaged skill at ${skillFile}`);
+    }
+  }
+}
 
 function parseTarget(args, fallback = "both") {
   let target = fallback;
@@ -58,55 +86,78 @@ function parseTarget(args, fallback = "both") {
   return target;
 }
 
-function targetDirs(target) {
-  if (target === "agents") return [agentsTargetDir];
-  if (target === "legacy") return [legacyTargetDir];
-  return [agentsTargetDir, legacyTargetDir];
-}
-
-function copySkill({ quiet = false, target = "both" } = {}) {
-  ensureSource();
-  for (const dir of targetDirs(target)) {
-    fs.mkdirSync(path.dirname(dir), { recursive: true });
-
-    if (fs.existsSync(dir)) {
-      const backupDir = `${dir}.backup.${timestamp()}`;
-      fs.renameSync(dir, backupDir);
-      if (!quiet) console.log(`Existing skill backed up to: ${backupDir}`);
-    }
-
-    fs.cpSync(sourceDir, dir, { recursive: true });
-    chmodScripts(path.join(dir, "scripts"));
-
-    if (!quiet) console.log(`Installed ${skillName} to: ${dir}`);
-  }
-
-  if (!quiet) console.log(`Restart Codex, then invoke: Use $${skillName}`);
-}
-
-function uninstallSkill(target = "both") {
-  for (const dir of targetDirs(target)) {
-    if (!fs.existsSync(dir)) {
-      console.log(`Skill is not installed at: ${dir}`);
-      continue;
-    }
-    fs.rmSync(dir, { recursive: true, force: true });
-    console.log(`Removed: ${dir}`);
-  }
-}
-
-function verifySkill(target = "both") {
-  const verifyScript = path.join(packageRoot, "scripts", "verify.sh");
-  if (!fs.existsSync(verifyScript)) fail(`missing verify script at ${verifyScript}`);
-
-  for (const verifyTarget of targetDirs(target)) {
-    const result = spawnSync("bash", [verifyScript, verifyTarget], {
-      stdio: "inherit",
-      env: process.env
-    });
-    if (result.status) process.exit(result.status);
-  }
-}
+function targetRoots(target) {
+  if (target === "agents") return [agentsSkillsRoot];
+  if (target === "legacy") return [legacySkillsRoot];
+  return [agentsSkillsRoot, legacySkillsRoot];
+}
+
+function copySkills({ quiet = false, target = "both" } = {}) {
+  ensureSource();
+  for (const root of targetRoots(target)) {
+    fs.mkdirSync(root, { recursive: true });
+    for (const skillName of skillNames) {
+      const sourceDir = path.join(sourceRoot, skillName);
+      const dir = path.join(root, skillName);
+
+      if (fs.existsSync(dir)) {
+        const backupDir = `${dir}.backup.${timestamp()}`;
+        fs.renameSync(dir, backupDir);
+        if (!quiet) console.log(`Existing skill backed up to: ${backupDir}`);
+      }
+
+      fs.cpSync(sourceDir, dir, { recursive: true });
+      chmodScripts(path.join(dir, "scripts"));
+
+      if (!quiet) console.log(`Installed ${skillName} to: ${dir}`);
+    }
+  }
+
+  if (!quiet) console.log("Restart Codex, then invoke: Use $genesis-harness");
+}
+
+function uninstallSkills(target = "both") {
+  for (const root of targetRoots(target)) {
+    for (const skillName of [...skillNames, ...legacySkillNames]) {
+      const dir = path.join(root, skillName);
+      if (!fs.existsSync(dir)) {
+        console.log(`Skill is not installed at: ${dir}`);
+        continue;
+      }
+      fs.rmSync(dir, { recursive: true, force: true });
+      console.log(`Removed: ${dir}`);
+    }
+  }
+}
+
+function verifySkill(target = "both") {
+  const verifyScript = path.join(packageRoot, "scripts", "verify.sh");
+  if (!fs.existsSync(verifyScript)) fail(`missing verify script at ${verifyScript}`);
+  const bash = resolveBash();
+
+  for (const root of targetRoots(target)) {
+    for (const skillName of skillNames) {
+      const result = spawnSync(bash, [verifyScript, path.join(root, skillName)], {
+        stdio: "inherit",
+        env: process.env
+      });
+      if (result.status) process.exit(result.status);
+    }
+  }
+}
+
+function resolveBash() {
+  if (process.platform === "win32") {
+    const candidates = [
+      "C:\\Program Files\\Git\\bin\\bash.exe",
+      "C:\\Program Files\\Git\\usr\\bin\\bash.exe"
+    ];
+    for (const candidate of candidates) {
+      if (fs.existsSync(candidate)) return candidate;
+    }
+  }
+  return "bash";
+}
 
 function chmodScripts(dir) {
   if (!fs.existsSync(dir)) return;
@@ -135,25 +186,28 @@ const command = process.argv[2] || "help";
 const args = process.argv.slice(3);
 
 switch (command) {
-  case "install":
-    copySkill({ target: parseTarget(args, "both") });
-    break;
+  case "install":
+    copySkills({ target: parseTarget(args, "both") });
+    break;
   case "postinstall":
     if (process.env.GENESIS_HARNESS_SKIP_POSTINSTALL === "1") {
       process.exit(0);
     }
-    copySkill({ quiet: true, target: "both" });
-    break;
-  case "verify":
-    verifySkill(parseTarget(args, "both"));
-    break;
-  case "uninstall":
-    uninstallSkill(parseTarget(args, "both"));
-    break;
-  case "path":
-    console.log(agentsTargetDir);
-    console.log(legacyTargetDir);
-    break;
+    copySkills({ quiet: true, target: "both" });
+    break;
+  case "verify":
+    verifySkill(parseTarget(args, "both"));
+    break;
+  case "uninstall":
+    uninstallSkills(parseTarget(args, "both"));
+    break;
+  case "path":
+    for (const root of [agentsSkillsRoot, legacySkillsRoot]) {
+      for (const skillName of skillNames) {
+        console.log(path.join(root, skillName));
+      }
+    }
+    break;
   case "help":
   case "--help":
   case "-h":

package/contracts/agents/CharacterBibleAgent/error.json

@@ -0,0 +1 @@
+{"error":"invalid_character_input","message":"CharacterBibleAgent input failed validation.","retryable":false}

package/contracts/agents/CharacterBibleAgent/example.json

@@ -0,0 +1 @@
+{"input":{"storySummary":"A traveler returns home.","characters":["Traveler"]},"expected":{"characters":[{"name":"Traveler"}]}}

package/contracts/agents/CharacterBibleAgent/request.json

@@ -0,0 +1 @@
+{"agent":"CharacterBibleAgent","input":{"storySummary":"Example summary","characters":[]}}

package/contracts/agents/CharacterBibleAgent/response.json

@@ -0,0 +1 @@
+{"agent":"CharacterBibleAgent","output":{"characters":[],"continuityRules":[]}}

package/contracts/agents/CharacterBibleAgent/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"CharacterBibleAgent"},"input":{"type":"object"}}}

package/contracts/agents/ImageGenerationAgent/error.json

@@ -0,0 +1 @@
+{"error":"image_provider_failed","message":"Image provider failed or returned invalid output.","retryable":true}

package/contracts/agents/ImageGenerationAgent/example.json

@@ -0,0 +1 @@
+{"input":{"prompts":[{"prompt":"quiet room"}],"provider":"mock"},"expected":{"images":[{"status":"created"}]}}

package/contracts/agents/ImageGenerationAgent/request.json

@@ -0,0 +1 @@
+{"agent":"ImageGenerationAgent","input":{"prompts":[],"provider":"mock"}}

package/contracts/agents/ImageGenerationAgent/response.json

@@ -0,0 +1 @@
+{"agent":"ImageGenerationAgent","output":{"images":[],"providerMetadata":{}}}

package/contracts/agents/ImageGenerationAgent/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"ImageGenerationAgent"},"input":{"type":"object"}}}

package/contracts/agents/PipelineOrchestrator/error.json

@@ -0,0 +1 @@
+{"error":"pipeline_orchestration_failed","message":"PipelineOrchestrator could not complete or resume the workflow.","retryable":true}

package/contracts/agents/PipelineOrchestrator/example.json

@@ -0,0 +1 @@
+{"input":{"projectId":"demo","phase":"start"},"expected":{"state":"completed"}}

package/contracts/agents/PipelineOrchestrator/request.json

@@ -0,0 +1 @@
+{"agent":"PipelineOrchestrator","input":{"projectId":"example","phase":"start"}}

package/contracts/agents/PipelineOrchestrator/response.json

@@ -0,0 +1 @@
+{"agent":"PipelineOrchestrator","output":{"state":"completed","steps":[]}}

package/contracts/agents/PipelineOrchestrator/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"PipelineOrchestrator"},"input":{"type":"object"}}}

package/contracts/agents/PromptGenerationAgent/error.json

@@ -0,0 +1 @@
+{"error":"invalid_prompt_input","message":"PromptGenerationAgent input failed validation.","retryable":false}

package/contracts/agents/PromptGenerationAgent/example.json

@@ -0,0 +1 @@
+{"input":{"scenePlan":[{"scene":"Return"}],"styleGuide":{"tone":"quiet"}},"expected":{"prompts":[{"scene":"Return"}]}}

package/contracts/agents/PromptGenerationAgent/request.json

@@ -0,0 +1 @@
+{"agent":"PromptGenerationAgent","input":{"scenePlan":[],"styleGuide":{}}}

package/contracts/agents/PromptGenerationAgent/response.json

@@ -0,0 +1 @@
+{"agent":"PromptGenerationAgent","output":{"prompts":[],"negativePrompts":[]}}

package/contracts/agents/PromptGenerationAgent/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"PromptGenerationAgent"},"input":{"type":"object"}}}

package/contracts/agents/RenderAgent/error.json

@@ -0,0 +1 @@
+{"error":"render_failed","message":"RenderAgent failed to produce a valid artifact.","retryable":true}

package/contracts/agents/RenderAgent/example.json

@@ -0,0 +1 @@
+{"input":{"scenePlan":[],"images":[],"audio":[],"subtitles":[]},"expected":{"video":{"status":"created"}}}

package/contracts/agents/RenderAgent/request.json

@@ -0,0 +1 @@
+{"agent":"RenderAgent","input":{"scenePlan":[],"images":[],"audio":[],"subtitles":[]}}

package/contracts/agents/RenderAgent/response.json

@@ -0,0 +1 @@
+{"agent":"RenderAgent","output":{"video":{"status":"created"},"metadata":{}}}

package/contracts/agents/RenderAgent/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"RenderAgent"},"input":{"type":"object"}}}

package/contracts/agents/ScenePlanningAgent/error.json

@@ -0,0 +1 @@
+{"error":"invalid_scene_plan_input","message":"ScenePlanningAgent input failed validation.","retryable":false}

package/contracts/agents/ScenePlanningAgent/example.json

@@ -0,0 +1 @@
+{"input":{"screenplay":[{"title":"Return"}],"constraints":["low-cost"]},"expected":{"scenePlan":[{"scene":"Return"}]}}

package/contracts/agents/ScenePlanningAgent/request.json

@@ -0,0 +1 @@
+{"agent":"ScenePlanningAgent","input":{"screenplay":[],"constraints":[]}}

package/contracts/agents/ScenePlanningAgent/response.json

@@ -0,0 +1 @@
+{"agent":"ScenePlanningAgent","output":{"scenePlan":[],"dependencies":[]}}

package/contracts/agents/ScenePlanningAgent/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"ScenePlanningAgent"},"input":{"type":"object"}}}

package/contracts/agents/ScreenplayAgent/error.json

@@ -0,0 +1 @@
+{"error":"invalid_screenplay_input","message":"ScreenplayAgent input failed validation.","retryable":false}

package/contracts/agents/ScreenplayAgent/example.json

@@ -0,0 +1 @@
+{"input":{"storySummary":"A traveler returns home.","characterBible":[]},"expected":{"scenes":[{"title":"Return"}]}}

package/contracts/agents/ScreenplayAgent/request.json

@@ -0,0 +1 @@
+{"agent":"ScreenplayAgent","input":{"storySummary":"Example summary","characterBible":[]}}

package/contracts/agents/ScreenplayAgent/response.json

@@ -0,0 +1 @@
+{"agent":"ScreenplayAgent","output":{"scenes":[],"dialogue":[]}}

package/contracts/agents/ScreenplayAgent/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"ScreenplayAgent"},"input":{"type":"object"}}}

package/contracts/agents/StoryAnalysisAgent/error.json

@@ -0,0 +1 @@
+{"error":"invalid_story_input","message":"StoryAnalysisAgent input failed validation.","retryable":false}

package/contracts/agents/StoryAnalysisAgent/example.json

@@ -0,0 +1 @@
+{"input":{"storyText":"A traveler returns home.","constraints":["short"]},"expected":{"summary":"A traveler returns home.","themes":["return"]}}

package/contracts/agents/StoryAnalysisAgent/request.json

@@ -0,0 +1 @@
+{"agent":"StoryAnalysisAgent","input":{"storyText":"Example story text","constraints":[]}}

package/contracts/agents/StoryAnalysisAgent/response.json

@@ -0,0 +1 @@
+{"agent":"StoryAnalysisAgent","output":{"summary":"Example summary","themes":[],"characters":[]}}

package/contracts/agents/StoryAnalysisAgent/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"StoryAnalysisAgent"},"input":{"type":"object"}}}

package/contracts/agents/SubtitleGenerationAgent/error.json

@@ -0,0 +1 @@
+{"error":"invalid_subtitle_input","message":"SubtitleGenerationAgent input failed validation.","retryable":false}

package/contracts/agents/SubtitleGenerationAgent/example.json

@@ -0,0 +1 @@
+{"input":{"script":[{"text":"Welcome home."}],"timings":[{"start":0,"end":1}]},"expected":{"subtitles":[{"text":"Welcome home."}]}}

package/contracts/agents/SubtitleGenerationAgent/request.json

@@ -0,0 +1 @@
+{"agent":"SubtitleGenerationAgent","input":{"script":[],"timings":[]}}

package/contracts/agents/SubtitleGenerationAgent/response.json

@@ -0,0 +1 @@
+{"agent":"SubtitleGenerationAgent","output":{"subtitles":[]}}

package/contracts/agents/SubtitleGenerationAgent/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"SubtitleGenerationAgent"},"input":{"type":"object"}}}

package/contracts/agents/VoiceGenerationAgent/error.json

@@ -0,0 +1 @@
+{"error":"voice_provider_failed","message":"Voice provider failed or returned invalid output.","retryable":true}

package/contracts/agents/VoiceGenerationAgent/example.json

@@ -0,0 +1 @@
+{"input":{"script":[{"text":"Welcome home."}],"voice":"mock"},"expected":{"audio":[{"status":"created"}]}}

package/contracts/agents/VoiceGenerationAgent/request.json

@@ -0,0 +1 @@
+{"agent":"VoiceGenerationAgent","input":{"script":[],"voice":"mock"}}

package/contracts/agents/VoiceGenerationAgent/response.json

@@ -0,0 +1 @@
+{"agent":"VoiceGenerationAgent","output":{"audio":[],"timings":[]}}

package/contracts/agents/VoiceGenerationAgent/schema.json

@@ -0,0 +1 @@
+{"type":"object","required":["agent","input"],"properties":{"agent":{"const":"VoiceGenerationAgent"},"input":{"type":"object"}}}

package/contracts/api/README.md

@@ -0,0 +1,4 @@
+# API Contracts
+
+Create one folder per endpoint. Each endpoint contract must include `request.json`, `response.json`, `schema.json`, `example.json`, and `error.json`.
+

package/contracts/api/endpoint-template/error.json

@@ -0,0 +1,7 @@
+{
+  "status": 400,
+  "body": {
+    "error": "validation_error",
+    "message": "Request body failed contract validation."
+  }
+}

package/contracts/api/endpoint-template/example.json

@@ -0,0 +1,11 @@
+{
+  "request": {
+    "method": "POST",
+    "path": "/api/example",
+    "body": { "id": "demo-001" }
+  },
+  "expectedResponse": {
+    "status": 200,
+    "body": { "ok": true }
+  }
+}

package/contracts/api/endpoint-template/request.json

@@ -0,0 +1,7 @@
+{
+  "method": "POST",
+  "path": "/api/example",
+  "body": {
+    "id": "example-id"
+  }
+}

package/contracts/api/endpoint-template/response.json

@@ -0,0 +1,6 @@
+{
+  "status": 200,
+  "body": {
+    "ok": true
+  }
+}

package/contracts/api/endpoint-template/schema.json

@@ -0,0 +1,9 @@
+{
+  "type": "object",
+  "required": ["method", "path", "body"],
+  "properties": {
+    "method": { "type": "string" },
+    "path": { "type": "string" },
+    "body": { "type": "object" }
+  }
+}

package/contracts/events/README.md

@@ -0,0 +1,4 @@
+# Event Contracts
+
+Define event name, payload schema, producer, consumer, retry behavior, and dead-letter behavior before implementing event code.
+

package/contracts/events/event-template/error.json

@@ -0,0 +1,4 @@
+{
+  "error": "event_validation_failed",
+  "retryable": false
+}

package/contracts/events/event-template/example.json

@@ -0,0 +1,6 @@
+{
+  "event": "example.created",
+  "payload": {
+    "id": "demo-001"
+  }
+}

package/contracts/events/event-template/request.json

@@ -0,0 +1,6 @@
+{
+  "event": "example.created",
+  "payload": {
+    "id": "example-id"
+  }
+}

package/contracts/events/event-template/response.json

@@ -0,0 +1,3 @@
+{
+  "acknowledged": true
+}

package/contracts/events/event-template/schema.json

@@ -0,0 +1,8 @@
+{
+  "type": "object",
+  "required": ["event", "payload"],
+  "properties": {
+    "event": { "type": "string" },
+    "payload": { "type": "object" }
+  }
+}

package/contracts/ui/README.md

@@ -0,0 +1,4 @@
+# UI Contracts
+
+Define route, required data, user actions, states, validation errors, accessibility expectations, and API synchronization requirements before UI implementation.
+

package/contracts/ui/screen-template/error.json

@@ -0,0 +1,4 @@
+{
+  "state": "error",
+  "visibleText": ["Unable to load data"]
+}

package/contracts/ui/screen-template/example.json

@@ -0,0 +1,7 @@
+{
+  "route": "/example",
+  "state": "empty",
+  "expected": {
+    "visibleText": ["No records yet"]
+  }
+}

package/contracts/ui/screen-template/request.json

@@ -0,0 +1,4 @@
+{
+  "route": "/example",
+  "state": "default"
+}

package/contracts/ui/screen-template/response.json

@@ -0,0 +1,4 @@
+{
+  "renders": true,
+  "visibleText": ["Example"]
+}

package/contracts/ui/screen-template/schema.json

@@ -0,0 +1,8 @@
+{
+  "type": "object",
+  "required": ["route", "state"],
+  "properties": {
+    "route": { "type": "string" },
+    "state": { "type": "string" }
+  }
+}

package/fixtures/agents/agent-fixture-template.md

@@ -0,0 +1,14 @@
+# Agent Fixture Template
+
+## Input
+
+Provide the exact agent input JSON.
+
+## Expected Output
+
+Provide the exact expected JSON output or schema-constrained shape.
+
+## Validation Notes
+
+Validate schema, error recovery, retry behavior, and persistence.
+

package/fixtures/api/api-fixture-template.md

@@ -0,0 +1,14 @@
+# API Fixture Template
+
+## Input
+
+Describe request method, path, headers, body, and auth state.
+
+## Expected Output
+
+Describe response status, body, headers, and persistence side effects.
+
+## Validation Notes
+
+List schema, negative, not-found, and snapshot assertions.
+

package/fixtures/images/image-fixture-template.md

@@ -0,0 +1,14 @@
+# Image Fixture Template
+
+## Input
+
+Prompt, size, style constraints, seed policy, and provider options.
+
+## Expected Output
+
+Image artifact metadata and validation rules.
+
+## Validation Notes
+
+Check provider failures, unsafe prompts, invalid JSON, and persistence.
+

package/fixtures/pipeline/pipeline-fixture-template.md

@@ -0,0 +1,14 @@
+# Pipeline Fixture Template
+
+## Input
+
+List pipeline phase inputs and initial state.
+
+## Expected Output
+
+List phase outputs, state transitions, logs, and persisted artifacts.
+
+## Validation Notes
+
+Check resumability, idempotency, retries, and failure recovery.
+