codex-genesis-harness 0.1.4 → 0.1.6

package/bin/genesis-harness.js

@@ -1,8 +1,8 @@
-#!/usr/bin/env node
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
 const { spawnSync } = require("child_process");
 
 const packageRoot = path.resolve(__dirname, "..");
@@ -12,6 +12,7 @@ const skillNames = [
   "genesis-upgrade-design",
   "genesis-architecture",
   "genesis-planning",
+  "genesis-mvp-planning",
   "genesis-codebase-map",
   "genesis-design-spec",
   "genesis-api-contract",
@@ -38,31 +39,31 @@ const codexHome = process.env.CODEX_HOME || path.join(process.env.HOME || "", ".
 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 = `
-Project Genesis Harness
-
-Usage:
-  genesis-harness install [--target agents|legacy|both]
-  genesis-harness verify [--target agents|legacy|both]
-  genesis-harness uninstall [--target agents|legacy|both]
-  genesis-harness path
-
-Environment:
-  CODEX_HOME=/custom/.codex  Override Codex home
-  GENESIS_HARNESS_HOME=/custom/.agents  Override modern skills home
-  GENESIS_HARNESS_SKIP_POSTINSTALL=1  Skip npm postinstall auto-install
-`;
-  console.log(text.trim());
-  process.exit(exitCode);
-}
-
-function fail(message) {
-  console.error(`genesis-harness: ${message}`);
-  process.exit(1);
-}
-
+
+function usage(exitCode = 0) {
+  const text = `
+Project Genesis Harness
+
+Usage:
+  genesis-harness install [--target agents|legacy|both]
+  genesis-harness verify [--target agents|legacy|both]
+  genesis-harness uninstall [--target agents|legacy|both]
+  genesis-harness path
+
+Environment:
+  CODEX_HOME=/custom/.codex  Override Codex home
+  GENESIS_HARNESS_HOME=/custom/.agents  Override modern skills home
+  GENESIS_HARNESS_SKIP_POSTINSTALL=1  Skip npm postinstall auto-install
+`;
+  console.log(text.trim());
+  process.exit(exitCode);
+}
+
+function fail(message) {
+  console.error(`genesis-harness: ${message}`);
+  process.exit(1);
+}
+
 function ensureSource() {
   for (const skillName of skillNames) {
     const skillFile = path.join(sourceRoot, skillName, "SKILL.md");
@@ -71,21 +72,21 @@ function ensureSource() {
     }
   }
 }
-
-function parseTarget(args, fallback = "both") {
-  let target = fallback;
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === "--target") {
-      target = args[i + 1];
-      i++;
-      continue;
-    }
-    usage(2);
-  }
-  if (!["agents", "legacy", "both"].includes(target)) usage(2);
-  return target;
-}
-
+
+function parseTarget(args, fallback = "both") {
+  let target = fallback;
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--target") {
+      target = args[i + 1];
+      i++;
+      continue;
+    }
+    usage(2);
+  }
+  if (!["agents", "legacy", "both"].includes(target)) usage(2);
+  return target;
+}
+
 function targetRoots(target) {
   if (target === "agents") return [agentsSkillsRoot];
   if (target === "legacy") return [legacySkillsRoot];
@@ -101,7 +102,9 @@ function copySkills({ quiet = false, target = "both" } = {}) {
       const dir = path.join(root, skillName);
 
       if (fs.existsSync(dir)) {
-        const backupDir = `${dir}.backup.${timestamp()}`;
+        const backupParent = path.join(root, "..", "backups");
+        fs.mkdirSync(backupParent, { recursive: true });
+        const backupDir = path.join(backupParent, `${skillName}.backup.${timestamp()}`);
         fs.renameSync(dir, backupDir);
         if (!quiet) console.log(`Existing skill backed up to: ${backupDir}`);
       }
@@ -129,7 +132,7 @@ function uninstallSkills(target = "both") {
     }
   }
 }
-
+
 function verifySkill(target = "both") {
   const verifyScript = path.join(packageRoot, "scripts", "verify.sh");
   if (!fs.existsSync(verifyScript)) fail(`missing verify script at ${verifyScript}`);
@@ -158,41 +161,41 @@ function resolveBash() {
   }
   return "bash";
 }
-
-function chmodScripts(dir) {
-  if (!fs.existsSync(dir)) return;
-  for (const entry of fs.readdirSync(dir)) {
-    const file = path.join(dir, entry);
-    if (entry.endsWith(".sh") && fs.statSync(file).isFile()) {
-      fs.chmodSync(file, 0o755);
-    }
-  }
-}
-
-function timestamp() {
-  const date = new Date();
-  const pad = (value) => String(value).padStart(2, "0");
-  return [
-    date.getFullYear(),
-    pad(date.getMonth() + 1),
-    pad(date.getDate()),
-    pad(date.getHours()),
-    pad(date.getMinutes()),
-    pad(date.getSeconds())
-  ].join("");
-}
-
-const command = process.argv[2] || "help";
-const args = process.argv.slice(3);
-
-switch (command) {
+
+function chmodScripts(dir) {
+  if (!fs.existsSync(dir)) return;
+  for (const entry of fs.readdirSync(dir)) {
+    const file = path.join(dir, entry);
+    if (entry.endsWith(".sh") && fs.statSync(file).isFile()) {
+      fs.chmodSync(file, 0o755);
+    }
+  }
+}
+
+function timestamp() {
+  const date = new Date();
+  const pad = (value) => String(value).padStart(2, "0");
+  return [
+    date.getFullYear(),
+    pad(date.getMonth() + 1),
+    pad(date.getDate()),
+    pad(date.getHours()),
+    pad(date.getMinutes()),
+    pad(date.getSeconds())
+  ].join("");
+}
+
+const command = process.argv[2] || "help";
+const args = process.argv.slice(3);
+
+switch (command) {
   case "install":
     copySkills({ target: parseTarget(args, "both") });
     break;
-  case "postinstall":
-    if (process.env.GENESIS_HARNESS_SKIP_POSTINSTALL === "1") {
-      process.exit(0);
-    }
+  case "postinstall":
+    if (process.env.GENESIS_HARNESS_SKIP_POSTINSTALL === "1") {
+      process.exit(0);
+    }
     copySkills({ quiet: true, target: "both" });
     break;
   case "verify":
@@ -208,11 +211,11 @@ switch (command) {
       }
     }
     break;
-  case "help":
-  case "--help":
-  case "-h":
-    usage(0);
-    break;
-  default:
-    usage(2);
-}
+  case "help":
+  case "--help":
+  case "-h":
+    usage(0);
+    break;
+  default:
+    usage(2);
+}

package/package.json

@@ -1,43 +1,68 @@
-{
-  "name": "codex-genesis-harness",
-  "version": "0.1.4",
-  "description": "Install and manage the Project Genesis Harness Codex skill.",
-  "license": "MIT",
-  "bin": {
-    "genesis-harness": "bin/genesis-harness.js"
-  },
-  "scripts": {
-    "postinstall": "node bin/genesis-harness.js postinstall",
-    "verify": "bash scripts/verify.sh",
-    "eval": "bash scripts/run-evals.sh",
-    "pack:check": "npm pack --dry-run"
-  },
-  "files": [
-    ".codex-plugin",
-    ".codex/skills",
-    ".codebase",
-    "contracts",
-    "fixtures",
-    "tests",
-    "playwright",
-    "observability",
-    "bin",
-    "scripts",
-    "README.md",
-    "LICENSE",
-    "VERSION"
-  ],
-  "keywords": [
-    "codex",
-    "codex-skill",
-    "planning",
-    "project-management",
-    "engineering-harness"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "codex-genesis-harness",
+  "version": "0.1.6",
+  "description": "Hệ thống quản trị (Harness) dành cho AI Agent (Codex) với cơ chế FSM State Persistence, Validation Gates và Test-First Workflow. Đảm bảo agent không bị trôi context.",
+  "license": "MIT",
+  "bin": {
+    "genesis-harness": "bin/genesis-harness.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/genesis-harness.js postinstall",
+    "verify": "bash scripts/verify.sh",
+    "eval": "bash scripts/run-evals.sh",
+    "pack:check": "npm pack --dry-run",
+    "spec:sync": "node scripts/spec_visual_sync.js",
+    "test:gen": "node scripts/test_generator.js",
+    "sentinel": "node scripts/prompt_sentinel.js",
+    "integrity": "node scripts/contract_integrity_gate.js",
+    "telemetry": "node scripts/healing_telemetry.js"
+  },
+  "files": [
+    ".codex-plugin",
+    ".codex/skills",
+    ".codebase",
+    "contracts",
+    "fixtures",
+    "tests",
+    "playwright",
+    "observability",
+    "bin",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    "VERSION",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "codex",
+    "ai-agent",
+    "autonomous-agent",
+    "harness-engineering",
+    "llm-workflow",
+    "project-management",
+    "state-machine",
+    "fsm",
+    "codex-plugin",
+    "developer-tools",
+    "validation-gates"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Genesis Codex Team",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tuanpham09/codex-genesis-harness.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tuanpham09/codex-genesis-harness/issues"
+  },
+  "homepage": "https://github.com/tuanpham09/codex-genesis-harness#readme",
+  "funding": {
+    "type": "momo",
+    "url": "tel:0865814259"
+  }
+}