holo-codex 0.1.0

package/plugins/autonomous-pr-loop/schemas/state.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://holo-codex.local/schemas/state.schema.json",
+  "title": "AgentLoopStateSnapshot",
+  "type": "object",
+  "required": ["schemaVersion", "status"],
+  "additionalProperties": true,
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "status": { "type": "string" },
+    "gate": {
+      "type": ["object", "null"],
+      "properties": {
+        "kind": { "type": "string" },
+        "message": { "type": "string" }
+      }
+    }
+  }
+}

package/plugins/autonomous-pr-loop/schemas/worker-event.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://holo-codex.local/schemas/worker-event.schema.json",
+  "title": "WorkerEvent",
+  "type": "object",
+  "required": ["eventType"],
+  "additionalProperties": true,
+  "properties": {
+    "eventType": { "type": "string" },
+    "itemType": { "type": "string" },
+    "itemId": { "type": "string" },
+    "itemStatus": { "type": "string" },
+    "threadId": { "type": "string" },
+    "backend": { "enum": ["codex-exec", "codex-app-server"] },
+    "summary": {},
+    "usage": {},
+    "artifactIds": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/plugins/autonomous-pr-loop/schemas/worker-result.schema.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://holo-codex.local/schemas/worker-result.schema.json",
+  "title": "WorkerResult",
+  "type": "object",
+  "required": ["ok", "summary", "changedFiles", "commandsRun", "testsRun", "gitnexus", "outOfScope", "followUps"],
+  "additionalProperties": false,
+  "properties": {
+    "ok": { "type": "boolean" },
+    "summary": { "type": "string" },
+    "changedFiles": { "type": "array", "items": { "type": "string" } },
+    "commandsRun": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["command", "exitCode"],
+        "additionalProperties": false,
+        "properties": {
+          "command": { "type": "string" },
+          "exitCode": { "type": "integer" }
+        }
+      }
+    },
+    "testsRun": { "type": "array", "items": { "type": "string" } },
+    "gitnexus": {
+      "type": "object",
+      "required": ["impactRun", "detectChangesRun"],
+      "additionalProperties": false,
+      "properties": {
+        "impactRun": { "type": "boolean" },
+        "detectChangesRun": { "type": "boolean" },
+        "notes": { "type": "string" }
+      }
+    },
+    "outOfScope": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["item", "reason"],
+        "additionalProperties": false,
+        "properties": {
+          "item": { "type": "string" },
+          "reason": { "type": "string" }
+        }
+      }
+    },
+    "followUps": { "type": "array", "items": { "type": "string" } },
+    "error": {
+      "type": "object",
+      "required": ["kind", "message"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "type": "string" },
+        "message": { "type": "string" }
+      }
+    }
+  }
+}

package/plugins/autonomous-pr-loop/scripts/agent-loop.ts

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { parseCliInvocation, runAgentLoopCli } from "../core/cli.js";
+
+const args = process.argv.slice(2);
+const parsedInvocation = parseInvocation(args);
+const controller = new AbortController();
+let signalCount = 0;
+const onSignal = (): void => {
+  signalCount += 1;
+  if (signalCount > 1) {
+    process.exit(130);
+  }
+  controller.abort();
+};
+process.on("SIGINT", onSignal);
+process.on("SIGTERM", onSignal);
+
+let result = await runAgentLoopCli(args, process.cwd(), { signal: controller.signal });
+if (controller.signal.aborted && parsedInvocation?.command !== "stop") {
+  result = await runAgentLoopCli([
+    "stop",
+    "--repo",
+    parsedInvocation?.targetRepoRoot ?? process.cwd(),
+    ...(args.includes("--json") ? ["--json"] : [])
+  ], process.cwd());
+}
+if (result.stdout) {
+  process.stdout.write(result.stdout);
+}
+if (result.stderr) {
+  process.stderr.write(result.stderr);
+}
+process.exitCode = result.exitCode;
+if ((parsedInvocation?.command ?? args[0]) !== "dashboard" || args.includes("--help") || args.includes("-h")) {
+  process.exit(result.exitCode);
+}
+
+function parseInvocation(rawArgs: string[]): ReturnType<typeof parseCliInvocation> | undefined {
+  try {
+    return parseCliInvocation(rawArgs, process.cwd());
+  } catch {
+    return undefined;
+  }
+}

package/plugins/autonomous-pr-loop/skills/autonomous-pr-loop/SKILL.md

@@ -0,0 +1,26 @@
+# HOLO-Codex
+
+Use this skill when the user asks Codex to enter or continue the HOLO-Codex Human On Loop delivery workflow.
+
+## Required startup
+
+1. Read the current repository `AGENTS.md` before doing any work.
+2. Read `.agent-loop/config.json` before inferring repository state.
+3. Prefer the plugin MCP control plane when available. If MCP is unavailable, run `pnpm agent-loop status`.
+4. Read state from the configured storage. Do not use chat history as the source of truth.
+
+## Gate behavior
+
+- If status is `BLOCKED`, report the blocker and stop unless the user explicitly gives the next action.
+- If config is missing, report `needs_repo_init` and ask the user to run `pnpm agent-loop init` or provide config.
+- Do not bypass policy gates with direct shell commands.
+
+## Worker boundary
+
+- Supervisor may create branches, run checks, commit, push, and create PRs when the state machine allows it.
+- Worker agents must not commit, push, create PRs, merge, or modify protected runtime state.
+- Worker agents return implementation output for supervisor review.
+
+## Current boundary
+
+This plugin version provides the shell, config, storage, policy gates, PR lifecycle supervision, worker orchestration, Codex hooks, MCP control plane, and a local dashboard. It does not provide GitHub webhooks, a hosted service, or a permanent daemon.

package/plugins/autonomous-pr-loop/skills/autonomous-pr-loop/agents/openai.yaml

@@ -0,0 +1,6 @@
+name: autonomous-pr-loop-worker
+description: Implementation worker profile for future HOLO-Codex orchestration.
+instructions: |
+  Implement only the task assigned by the supervisor.
+  Do not commit, push, create pull requests, merge branches, or bypass gates.
+  Return a concise summary, changed files, and verification results.

package/plugins/autonomous-pr-loop/ui/index.html

@@ -0,0 +1,26 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <title>HOLO-Codex Dashboard</title>
+    <script>
+      (() => {
+        try {
+          const key = "agent-loop-dashboard-theme";
+          const stored = window.localStorage?.getItem(key);
+          const setting = stored === "light" || stored === "dark" || stored === "system" ? stored : "system";
+          const prefersDark = window.matchMedia?.("(prefers-color-scheme: dark)").matches ?? true;
+          document.documentElement.dataset.theme = setting === "system" ? (prefersDark ? "dark" : "light") : setting;
+        } catch {
+          document.documentElement.dataset.theme = "dark";
+        }
+      })();
+    </script>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/plugins/autonomous-pr-loop/ui/public/favicon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <rect x="8" y="8" width="112" height="112" rx="28" fill="#f8fafc" />
+  <path d="M111.3 52.6A49 49 0 1 1 84 19.2" fill="none" stroke="#111827" stroke-width="8" stroke-linecap="round" />
+  <circle cx="98.6" cy="29.4" r="6.5" fill="#f59e0b" />
+  <path d="M41 48L62 64L41 80" fill="none" stroke="#111827" stroke-width="8" stroke-linecap="round" stroke-linejoin="round" />
+  <path d="M70 81H91" fill="none" stroke="#111827" stroke-width="8" stroke-linecap="round" />
+</svg>