@evo-dev/evodev 0.0.1-alpha

package/dist/plugins/evodev/hooks/hooks.json

@@ -0,0 +1,197 @@
+{
+  "description": "EvoDev routes Claude Code lifecycle events through evodev hook runtime for Task Contract, workflow, policy, and evidence control.",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolBatch": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PermissionDenied": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "TaskCreated": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "NODE_PATH=\"$(dirname \"$(bun pm bin -g)\")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}\" bun run \"${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts\" hook runtime --target claude",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/dist/plugins/evodev/hooks/hooks.ts

@@ -0,0 +1,217 @@
+import {
+  type CanonicalHookEventType,
+  type HookEventV1,
+  type HookInputEventType,
+  normalizeHookEvent,
+} from "@evo-dev/core";
+import { type ClaudePaths, resolveClaudePaths } from "./paths.ts";
+
+export interface ClaudeHookInstallDryRunInput {
+  homeDir: string;
+  paths?: ClaudePaths;
+}
+
+export interface ClaudeHookInstallDryRunPlan {
+  target: "claude";
+  settingsPath: string;
+  plannedWrites: Array<{
+    action: "merge-with-backup" | "create";
+    targetPath: string;
+    reason: string;
+  }>;
+  warnings: string[];
+  blockers: string[];
+}
+
+export interface ClaudeHookCommand {
+  type: "command";
+  command: string;
+  timeout?: number;
+}
+
+export interface ClaudeHookMatcherGroup {
+  matcher?: string;
+  hooks: ClaudeHookCommand[];
+}
+
+export interface ClaudeHookConfig {
+  description: string;
+  hooks: Partial<Record<CanonicalHookEventType, ClaudeHookMatcherGroup[]>>;
+}
+
+export interface CodexHookConfig {
+  hooks: Partial<Record<CanonicalHookEventType, ClaudeHookMatcherGroup[]>>;
+}
+
+export const CLAUDE_HOOK_RUNTIME_COMMAND =
+  'NODE_PATH="$(dirname "$(bun pm bin -g)")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}" bun run "${CLAUDE_PLUGIN_ROOT}/hooks/runtime.ts" hook runtime --target claude';
+export const CODEX_HOOK_RUNTIME_COMMAND =
+  'NODE_PATH="$(dirname "$(bun pm bin -g)")/install/global/node_modules${NODE_PATH:+:$NODE_PATH}" bun run "${PLUGIN_ROOT}/hooks/runtime.ts" hook runtime --target codex';
+const CLAUDE_TOOL_EVENTS = new Set<CanonicalHookEventType>([
+  "PreToolUse",
+  "PermissionRequest",
+  "PostToolUse",
+  "PostToolUseFailure",
+  "PermissionDenied",
+]);
+const CLAUDE_RUNTIME_EVENTS: CanonicalHookEventType[] = [
+  "SessionStart",
+  "UserPromptSubmit",
+  "PreToolUse",
+  "PermissionRequest",
+  "PostToolUse",
+  "PostToolUseFailure",
+  "PostToolBatch",
+  "PermissionDenied",
+  "SubagentStart",
+  "SubagentStop",
+  "TaskCreated",
+  "TaskCompleted",
+  "Stop",
+  "TeammateIdle",
+  "PreCompact",
+  "PostCompact",
+  "SessionEnd",
+];
+const CODEX_RUNTIME_EVENTS: CanonicalHookEventType[] = [
+  "SessionStart",
+  "UserPromptSubmit",
+  "PreToolUse",
+  "PermissionRequest",
+  "PostToolUse",
+  "PreCompact",
+  "PostCompact",
+  "SubagentStart",
+  "SubagentStop",
+  "Stop",
+];
+const CODEX_EVENT_MATCHERS: Partial<Record<CanonicalHookEventType, string>> = {
+  SessionStart: "startup|resume|clear|compact",
+  PreToolUse: "*",
+  PermissionRequest: "*",
+  PostToolUse: "*",
+  SubagentStart: "*",
+  SubagentStop: "*",
+  Stop: "*",
+};
+
+export function planClaudeHookInstallDryRun(
+  input: ClaudeHookInstallDryRunInput,
+): ClaudeHookInstallDryRunPlan {
+  const paths = input.paths ?? resolveClaudePaths({ homeDir: input.homeDir });
+  return {
+    target: "claude",
+    settingsPath: paths.settingsPath,
+    plannedWrites: [
+      {
+        action: "merge-with-backup",
+        targetPath: paths.settingsPath,
+        reason:
+          "dry-run only: would add disabled EvoDev user-level hooks after future confirmation; no file is written",
+      },
+    ],
+    warnings: [
+      "Hooks remain disabled by default.",
+      "Project .claude, .codex, CLAUDE.md, and AGENTS.md are never targeted by this dry-run.",
+    ],
+    blockers: [],
+  };
+}
+
+export function normalizeClaudeHookPayload(input: {
+  type: HookInputEventType;
+  payload: Record<string, unknown>;
+  receivedAt?: string;
+}): HookEventV1 {
+  return normalizeHookEvent({
+    pluginId: "claude",
+    agent: "claude-code",
+    type: input.type,
+    payload: input.payload,
+    receivedAt: input.receivedAt,
+  });
+}
+
+export function normalizeClaudeRuntimeHookPayload(input: {
+  payload: Record<string, unknown>;
+  receivedAt?: string;
+}): HookEventV1 {
+  const type = input.payload.hook_event_name ?? input.payload.hookEventName;
+  if (typeof type !== "string" || type.trim() === "") {
+    throw new Error("Claude hook payload is missing hook_event_name.");
+  }
+  return normalizeClaudeHookPayload({
+    type: type as HookInputEventType,
+    payload: input.payload,
+    receivedAt: input.receivedAt,
+  });
+}
+
+export function normalizeCodexHookPayload(input: {
+  type: HookInputEventType;
+  payload: Record<string, unknown>;
+  receivedAt?: string;
+}): HookEventV1 {
+  return normalizeHookEvent({
+    pluginId: "codex",
+    agent: "codex",
+    type: input.type,
+    payload: input.payload,
+    receivedAt: input.receivedAt,
+  });
+}
+
+export function normalizeCodexRuntimeHookPayload(input: {
+  payload: Record<string, unknown>;
+  receivedAt?: string;
+}): HookEventV1 {
+  const type =
+    input.payload.hook_event_name ??
+    input.payload.hookEventName ??
+    input.payload.event ??
+    input.payload.name;
+  if (typeof type !== "string" || type.trim() === "") {
+    throw new Error("Codex hook payload is missing hook_event_name.");
+  }
+  return normalizeCodexHookPayload({
+    type: type as HookInputEventType,
+    payload: input.payload,
+    receivedAt: input.receivedAt,
+  });
+}
+
+export function createClaudeHookConfig(
+  command: string = CLAUDE_HOOK_RUNTIME_COMMAND,
+): ClaudeHookConfig {
+  const hooks: Partial<Record<CanonicalHookEventType, ClaudeHookMatcherGroup[]>> = {};
+  for (const event of CLAUDE_RUNTIME_EVENTS) {
+    hooks[event] = [
+      {
+        ...(CLAUDE_TOOL_EVENTS.has(event) ? { matcher: "*" } : {}),
+        hooks: [{ type: "command", command, timeout: event === "SessionEnd" ? 5 : 30 }],
+      },
+    ];
+  }
+  return {
+    description:
+      "EvoDev routes Claude Code lifecycle events through evodev hook runtime for Task Contract, workflow, policy, and evidence control.",
+    hooks,
+  };
+}
+
+export function createCodexHookConfig(
+  command: string = CODEX_HOOK_RUNTIME_COMMAND,
+): CodexHookConfig {
+  const hooks: Partial<Record<CanonicalHookEventType, ClaudeHookMatcherGroup[]>> = {};
+  for (const event of CODEX_RUNTIME_EVENTS) {
+    hooks[event] = [
+      {
+        ...(CODEX_EVENT_MATCHERS[event] !== undefined
+          ? { matcher: CODEX_EVENT_MATCHERS[event] }
+          : {}),
+        hooks: [{ type: "command", command, timeout: 30 }],
+      },
+    ];
+  }
+  return { hooks };
+}

package/dist/plugins/evodev/hooks/index.ts

@@ -0,0 +1,52 @@
+export {
+  type CodexCommandResult,
+  type CodexCommandRunner,
+  type CodexPluginOptions,
+  codexPlugin,
+  createCodexPlugin,
+} from "./codex.ts";
+
+export { type ClaudeCommandResult, type ClaudeCommandRunner, detectClaudeCode } from "./detect.ts";
+export {
+  type ClaudePaths,
+  type ResolveClaudePathsOptions,
+  assertSafeClaudeAssetName,
+  resolveClaudeAgentTargetPath,
+  resolveClaudePaths,
+  resolveClaudeSkillTargetPath,
+} from "./paths.ts";
+export {
+  CLAUDE_HOOK_RUNTIME_COMMAND,
+  CODEX_HOOK_RUNTIME_COMMAND,
+  type ClaudeHookCommand,
+  type ClaudeHookConfig,
+  type ClaudeHookInstallDryRunInput,
+  type ClaudeHookInstallDryRunPlan,
+  type ClaudeHookMatcherGroup,
+  type CodexHookConfig,
+  createCodexHookConfig,
+  createClaudeHookConfig,
+  normalizeCodexHookPayload,
+  normalizeCodexRuntimeHookPayload,
+  normalizeClaudeHookPayload,
+  normalizeClaudeRuntimeHookPayload,
+  planClaudeHookInstallDryRun,
+} from "./hooks.ts";
+export {
+  type ClaudePathAccess,
+  type ClaudePathAccessResult,
+  type ClaudePluginOptions,
+  type ClaudeSyncFileSystem,
+  claudePlugin,
+  createClaudePlugin,
+} from "./plugin.ts";
+export {
+  type ClaudeAgentTransformInput,
+  type ClaudeAgentTransformResult,
+  transformClaudeAgent,
+} from "./transform-agent.ts";
+export {
+  type ClaudeSkillTransformInput,
+  type ClaudeSkillTransformResult,
+  transformClaudeSkill,
+} from "./transform-skill.ts";

package/dist/plugins/evodev/hooks/paths.ts

@@ -0,0 +1,53 @@
+export interface ClaudePaths {
+  homeDir: string;
+  claudeDir: string;
+  settingsPath: string;
+  skillsDir: string;
+  agentsDir: string;
+}
+
+export interface ResolveClaudePathsOptions {
+  homeDir: string;
+  claudeDir?: string;
+}
+
+export function resolveClaudePaths(options: ResolveClaudePathsOptions): ClaudePaths {
+  const homeDir = stripTrailingSlash(options.homeDir);
+  const claudeDir = stripTrailingSlash(options.claudeDir ?? `${homeDir}/.claude`);
+
+  return {
+    homeDir,
+    claudeDir,
+    settingsPath: `${claudeDir}/settings.json`,
+    skillsDir: `${claudeDir}/skills`,
+    agentsDir: `${claudeDir}/agents`,
+  };
+}
+
+export function resolveClaudeSkillTargetPath(skillName: string, paths: ClaudePaths): string {
+  const safeSkillName = assertSafeClaudeAssetName(skillName, "skillName");
+  return `${paths.skillsDir}/${safeSkillName}/SKILL.md`;
+}
+
+export function resolveClaudeAgentTargetPath(agentName: string, paths: ClaudePaths): string {
+  const safeAgentName = assertSafeClaudeAssetName(agentName, "agentName");
+  return `${paths.agentsDir}/${safeAgentName}.md`;
+}
+
+export function assertSafeClaudeAssetName(name: string, label = "name"): string {
+  if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name) || name === "." || name === "..") {
+    throw new Error(
+      `Invalid Claude asset ${label}: must be a single safe path segment using letters, numbers, dot, underscore, or hyphen`,
+    );
+  }
+
+  return name;
+}
+
+function stripTrailingSlash(path: string): string {
+  if (path === "/") {
+    return path;
+  }
+
+  return path.replace(/\/+$/, "");
+}