@moreih29/nexus-core 0.12.0 → 0.14.0

package/dist/hooks/session-init.js

@@ -0,0 +1,21 @@
+// assets/hooks/session-init/handler.ts
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join, basename } from "node:path";
+var handler = async (input) => {
+  if (input.hook_event_name !== "SessionStart")
+    return;
+  const safeSid = basename(input.session_id);
+  if (!safeSid || safeSid.startsWith(".") || safeSid.includes("/")) {
+    process.stderr.write(`[session-init] invalid session_id: ${input.session_id}
+`);
+    return;
+  }
+  const sessionDir = join(input.cwd, ".nexus/state", safeSid);
+  mkdirSync(sessionDir, { recursive: true });
+  writeFileSync(join(sessionDir, "agent-tracker.json"), "[]");
+  writeFileSync(join(sessionDir, "tool-log.jsonl"), "");
+};
+var handler_default = handler;
+export {
+  handler_default as default
+};

package/dist/manifests/claude-hooks.json

@@ -0,0 +1,52 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/session-init.js",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/prompt-router.js",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/agent-finalize.js",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/agent-bootstrap.js",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/dist/manifests/codex-hooks.json

@@ -0,0 +1,28 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/session-init.js",
+        "timeout": 10
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/prompt-router.js",
+        "timeout": 10
+      }
+    ],
+    "SubagentStop": [
+      {
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/agent-finalize.js",
+        "timeout": 10
+      }
+    ],
+    "SubagentStart": [
+      {
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/agent-bootstrap.js",
+        "timeout": 10
+      }
+    ]
+  }
+}

package/dist/manifests/opencode-manifest.json

@@ -0,0 +1,44 @@
+{
+  "hooks": [
+    {
+      "name": "session-init",
+      "events": [
+        "SessionStart"
+      ],
+      "matcher": "*",
+      "handlerPath": "../assets/hooks/session-init/handler.js",
+      "priority": 0,
+      "timeout": 10
+    },
+    {
+      "name": "prompt-router",
+      "events": [
+        "UserPromptSubmit"
+      ],
+      "matcher": "*",
+      "handlerPath": "../assets/hooks/prompt-router/handler.js",
+      "priority": 0,
+      "timeout": 10
+    },
+    {
+      "name": "agent-finalize",
+      "events": [
+        "SubagentStop"
+      ],
+      "matcher": "*",
+      "handlerPath": "../assets/hooks/agent-finalize/handler.js",
+      "priority": 0,
+      "timeout": 10
+    },
+    {
+      "name": "agent-bootstrap",
+      "events": [
+        "SubagentStart"
+      ],
+      "matcher": "*",
+      "handlerPath": "../assets/hooks/agent-bootstrap/handler.js",
+      "priority": 0,
+      "timeout": 10
+    }
+  ]
+}

package/dist/manifests/portability-report.json

@@ -0,0 +1,87 @@
+{
+  "post-tool-telemetry": {
+    "tier": "experimental",
+    "registered_in": [],
+    "excluded_from": [
+      {
+        "harness": "claude",
+        "missing": [
+          "event.post_tool_use.bash_parsed"
+        ],
+        "reason": "Codex-specific capability: the nexus wrapper parses Bash commands to derive equivalent nexus tool_name values"
+      },
+      {
+        "harness": "codex",
+        "missing": [
+          "event.post_tool_use.read",
+          "event.post_tool_use.edit"
+        ],
+        "reason": "Codex has no independent Read tool; file reads use shell (cat/head/tail); Codex: apply_patch does not emit PostToolUse — same constraint as event.pre_tool_use.edit"
+      },
+      {
+        "harness": "opencode",
+        "missing": [
+          "event.post_tool_use.bash_parsed"
+        ],
+        "reason": "Codex-specific capability: the nexus wrapper parses Bash commands to derive equivalent nexus tool_name values"
+      }
+    ],
+    "capabilities_required": [
+      "event.post_tool_use.read",
+      "event.post_tool_use.edit",
+      "event.post_tool_use.bash_parsed"
+    ]
+  },
+  "session-init": {
+    "tier": "core",
+    "registered_in": [
+      "claude",
+      "codex",
+      "opencode"
+    ],
+    "excluded_from": [],
+    "capabilities_required": [
+      "event.session_start"
+    ]
+  },
+  "prompt-router": {
+    "tier": "core",
+    "registered_in": [
+      "claude",
+      "codex",
+      "opencode"
+    ],
+    "excluded_from": [],
+    "capabilities_required": [
+      "event.user_prompt_submit",
+      "output.additional_context.user_prompt",
+      "output.decision_block"
+    ]
+  },
+  "agent-finalize": {
+    "tier": "core",
+    "registered_in": [
+      "claude",
+      "codex",
+      "opencode"
+    ],
+    "excluded_from": [],
+    "capabilities_required": [
+      "event.subagent_stop",
+      "output.additional_context.subagent_stop"
+    ]
+  },
+  "agent-bootstrap": {
+    "tier": "core",
+    "registered_in": [
+      "claude",
+      "codex",
+      "opencode"
+    ],
+    "excluded_from": [],
+    "capabilities_required": [
+      "event.subagent_start",
+      "output.additional_context.session_start"
+    ]
+  }
+}

package/dist/scripts/build-agents.d.ts

@@ -0,0 +1,157 @@
+/**
+ * scripts/build-agents.ts
+ *
+ * Build pipeline for nexus agents and skills.
+ *
+ * Inputs:
+ *   assets/agents/<n>/body.md  × 9 agents
+ *   assets/skills/<n>/body.md  × 4 skills
+ *   assets/capability-matrix.yml
+ *   assets/tools/tool-name-map.yml (invocations section)
+ *
+ * Outputs per harness:
+ *   dist/claude/
+ *     .claude-plugin/plugin.json       (Template — skip if exists, --force to overwrite)
+ *     .claude-plugin/marketplace.json  (Template — skip if exists, --force to overwrite)
+ *     agents/<n>.md × N
+ *     skills/<n>/SKILL.md × 4
+ *     settings.json                    (Managed — primary agent injection, omitted if no primary)
+ *
+ *   dist/opencode/
+ *     package.json                     (Template — skip if exists)
+ *     opencode.json.fragment           (Managed — always overwrite)
+ *     src/index.ts                     (Managed — always overwrite)
+ *     src/agents/<n>.ts × N           (Managed — always overwrite, mode:primary gets mode field)
+ *     .opencode/skills/<n>/SKILL.md × 4  (Managed)
+ *
+ *   dist/codex/
+ *     plugin/.codex-plugin/plugin.json (Managed)
+ *     plugin/skills/<n>/SKILL.md × 4  (Managed)
+ *     agents/<n>.toml × N             (Managed)
+ *     prompts/<n>.md × N              (Managed)
+ *     install/config.fragment.toml    (Managed)
+ *     install/AGENTS.fragment.md      (Managed — primary agents only, omitted if none)
+ *
+ * Overwrite policy:
+ *   Managed paths — always overwrite (unless --dry-run)
+ *   Template paths — skip if file exists (overwrite only with --force)
+ *
+ * CLI flags:
+ *   --harness=claude|opencode|codex   (default: all)
+ *   --target=<dir>                    (default: dist/)
+ *   --dry-run                         print affected files, no writes
+ *   --force                           force Template file overwrite
+ *   --strict                          error if Managed output has untracked modifications
+ *   --only=<agent|skill name>         restrict to a single asset
+ */
+import type { InvocationsMap, Harness } from "../src/shared/invocations.js";
+export declare const ROOT: string;
+export declare const AGENTS_DIR: string;
+export declare const SKILLS_DIR: string;
+export declare const CAPABILITY_MATRIX_PATH: string;
+export declare const TOOL_NAME_MAP_PATH: string;
+export interface AgentFrontmatter {
+    name: string;
+    description: string;
+    task?: string;
+    alias_ko?: string;
+    category: "how" | "do" | "check" | "lead";
+    mode?: "primary" | "subagent" | "all";
+    resume_tier?: "persistent" | "bounded" | "ephemeral";
+    model_tier: "high" | "standard" | "low";
+    capabilities: string[];
+    id: string;
+    summary?: string;
+    triggers?: string[];
+    manual_only?: boolean;
+    harness_docs_refs?: string[];
+}
+export interface AssetEntry {
+    type: "agent" | "skill";
+    name: string;
+    frontmatter: AgentFrontmatter;
+    body: string;
+    bodyPath: string;
+}
+export interface CapabilityMatrixEntry {
+    claude?: {
+        disallowedTools?: string[];
+    };
+    opencode?: {
+        permission?: Record<string, string>;
+    };
+    codex?: {
+        sandbox_mode?: string | null;
+        disabled_tools?: string[];
+    };
+}
+export interface CapabilityMatrix {
+    capabilities: Record<string, CapabilityMatrixEntry>;
+    model_tier: Record<string, {
+        claude: string;
+        codex: string;
+        opencode: string | null;
+    }>;
+}
+export interface ToolNameMapInvocations {
+    invocations: InvocationsMap;
+}
+export interface BuildOptions {
+    harnesses: Harness[];
+    targetDir: string;
+    dryRun: boolean;
+    force: boolean;
+    strict: boolean;
+    only?: string;
+}
+/**
+ * Split a body.md file into frontmatter object and body text.
+ * Throws on YAML parse failure.
+ */
+export declare function parseFrontmatter(raw: string, filePath: string): {
+    fm: AgentFrontmatter;
+    body: string;
+};
+/**
+ * Load all agents and skills from assets/, whitelisting only body.md.
+ */
+export declare function loadAssets(opts?: {
+    only?: string;
+}): AssetEntry[];
+export declare function loadCapabilityMatrix(): CapabilityMatrix;
+export declare function loadInvocations(): InvocationsMap;
+/**
+ * Collect all Claude disallowedTools for an agent based on its capabilities[].
+ */
+export declare function resolveClaudeDisallowedTools(capabilities: string[], capMatrix: CapabilityMatrix): string[];
+/**
+ * Collect merged OpenCode permission block for an agent.
+ */
+export declare function resolveOpencodePermissions(capabilities: string[], capMatrix: CapabilityMatrix): Record<string, string>;
+/**
+ * Resolve codex sandbox_mode and disabled_tools for an agent.
+ * sandbox_mode: take the most restrictive non-null value ("read-only" wins).
+ */
+export declare function resolveCodexConfig(capabilities: string[], capMatrix: CapabilityMatrix): {
+    sandbox_mode: string | null;
+    disabled_tools: string[];
+};
+/**
+ * Resolve model slug for a given model_tier and harness.
+ */
+export declare function resolveModel(modelTier: string, harness: Harness, capMatrix: CapabilityMatrix): string | null;
+/**
+ * Write a file according to the managed/template overwrite policy.
+ *
+ * Managed: always overwrite (unless --dry-run)
+ * Template: skip if exists (overwrite only with --force)
+ * --dry-run: record path, no write
+ * --strict: error if Managed path has untracked git modifications
+ */
+export declare function applyOverwritePolicy(filePath: string, content: string, isManaged: boolean, opts: BuildOptions): void;
+export declare function buildForClaude(assets: AssetEntry[], capMatrix: CapabilityMatrix, invocations: InvocationsMap, opts: BuildOptions): void;
+export declare function buildForOpencode(assets: AssetEntry[], capMatrix: CapabilityMatrix, invocations: InvocationsMap, opts: BuildOptions): void;
+export declare function buildForCodex(assets: AssetEntry[], capMatrix: CapabilityMatrix, invocations: InvocationsMap, opts: BuildOptions): void;
+export declare function parseArgs(argv: string[]): BuildOptions;
+export declare function buildAgents(opts: BuildOptions): Promise<void>;
+//# sourceMappingURL=build-agents.d.ts.map

package/dist/scripts/build-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-agents.d.ts","sourceRoot":"","sources":["../../scripts/build-agents.ts"],"names":[],"mappings":"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"}