odd-studio 3.7.5 → 3.7.7

package/scripts/hook-definitions.js

@@ -0,0 +1,137 @@
+'use strict';
+
+export const HOOK_GROUPS = [
+  {
+    event: 'PreToolUse',
+    matcher: 'Agent',
+    gates: [
+      { name: 'brief-gate', timeout: 5, status: 'ODD brief gate...' },
+      { name: 'build-gate', timeout: 5, status: 'ODD build gate...' },
+    ],
+  },
+  {
+    event: 'PreToolUse',
+    matcher: 'Write',
+    gates: [
+      { name: 'swarm-write', timeout: 5, status: 'ODD swarm write gate...' },
+      { name: 'verify-gate', timeout: 5, status: 'ODD verification gate...' },
+      { name: 'confirm-gate', timeout: 5, status: 'ODD confirm gate...' },
+    ],
+  },
+  {
+    event: 'PreToolUse',
+    matcher: 'Edit',
+    gates: [
+      { name: 'swarm-write', timeout: 5, status: 'ODD swarm write gate...' },
+      { name: 'verify-gate', timeout: 5, status: 'ODD verification gate...' },
+      { name: 'confirm-gate', timeout: 5, status: 'ODD confirm gate...' },
+    ],
+  },
+  {
+    event: 'UserPromptSubmit',
+    matcher: null,
+    gates: [
+      { name: 'swarm-guard', timeout: 5, status: 'ODD swarm guard...' },
+    ],
+  },
+  {
+    event: 'PostToolUse',
+    matcher: 'Write',
+    gates: [
+      { name: 'plan-complete-gate', timeout: 5, status: 'ODD plan complete gate...' },
+    ],
+  },
+  {
+    event: 'PostToolUse',
+    matcher: 'Edit',
+    gates: [
+      { name: 'plan-complete-gate', timeout: 5, status: 'ODD plan complete gate...' },
+    ],
+  },
+  {
+    event: 'PostToolUse',
+    matcher: 'Bash',
+    gates: [
+      { name: 'session-save', timeout: 10, status: 'ODD session save...' },
+    ],
+  },
+  {
+    event: 'PostToolUse',
+    matcher: 'mcp__odd-flow__memory_store',
+    gates: [
+      { name: 'store-validate', timeout: 5, status: 'ODD store validate...' },
+    ],
+  },
+  {
+    event: 'PostToolUse',
+    matcher: 'mcp__odd-flow__coordination_sync',
+    gates: [
+      { name: 'sync-validate', timeout: 5, status: 'ODD sync validate...' },
+    ],
+  },
+  {
+    event: 'PostToolUse',
+    matcher: 'Write',
+    gates: [
+      { name: 'code-quality', timeout: 5, status: 'ODD code quality...' },
+      { name: 'security-quality', timeout: 5, status: 'ODD security quality...' },
+      { name: 'brief-quality', timeout: 5, status: 'ODD brief quality...' },
+      { name: 'outcome-quality', timeout: 5, status: 'ODD outcome quality...' },
+    ],
+  },
+  {
+    event: 'PostToolUse',
+    matcher: 'Edit',
+    gates: [
+      { name: 'code-quality', timeout: 5, status: 'ODD code quality...' },
+      { name: 'security-quality', timeout: 5, status: 'ODD security quality...' },
+    ],
+  },
+];
+
+export function buildClaudeHooksConfig(hookFile) {
+  const hooks = {};
+
+  for (const { event, matcher, gates } of HOOK_GROUPS) {
+    if (!hooks[event]) hooks[event] = [];
+
+    const entry = {
+      _oddStudio: true,
+      hooks: gates.map((gate) => ({
+        type: 'command',
+        command: `.claude/hooks/${hookFile} ${gate.name}`,
+        timeout: gate.timeout,
+        statusMessage: gate.status,
+      })),
+    };
+
+    if (matcher) entry.matcher = matcher;
+    hooks[event].push(entry);
+  }
+
+  return hooks;
+}
+
+export function buildCodexHooksConfig(hookFile) {
+  const hooks = {};
+
+  for (const { event, matcher, gates } of HOOK_GROUPS) {
+    if (!hooks[event]) hooks[event] = [];
+
+    const entry = {
+      hooks: gates.map((gate) => ({
+        type: 'command',
+        command: `./hooks/${hookFile} ${gate.name}`,
+      })),
+    };
+
+    if (matcher) entry.matcher = matcher;
+    hooks[event].push(entry);
+  }
+
+  return { hooks };
+}
+
+export function countHookCommands() {
+  return HOOK_GROUPS.reduce((sum, group) => sum + group.gates.length, 0);
+}

package/scripts/install-codex-commands.js

@@ -29,10 +29,10 @@ function buildMainCommand(cmd) {
     '',
     `# ${CODEX_COMMAND_PREFIX}${cmd.name}`,
     '',
-    'You are now operating as the ODD Studio coach.',
+    'You are now operating as the ODD Studio startup coach.',
     '',
     'Read this file now:',
-    `- \`${CODEX_ODD_ROOT}SKILL.md\` — the full ODD Studio coach`,
+    `- \`${CODEX_ODD_ROOT}SKILL.md\` — the ODD Studio startup coach`,
     '',
     'Then execute the startup state check exactly as documented.',
     '',
@@ -53,5 +53,13 @@ function buildSubcommand(cmd) {
 }
 
 function rewriteBody(body) {
-  return body.replace(/`\.opencode\/odd\//g, `\`${CODEX_ODD_ROOT}`);
+  return body
+    .replace(/`\.opencode\/odd\/odd-build\/SKILL\.md`/g, '`plugins/odd-studio/skills/odd-build/SKILL.md`')
+    .replace(/`\.opencode\/odd\/odd-debug\/SKILL\.md`/g, '`plugins/odd-studio/skills/odd-debug/SKILL.md`')
+    .replace(/`\.opencode\/odd\/odd-plan\/SKILL\.md`/g, '`plugins/odd-studio/skills/odd-plan/SKILL.md`')
+    .replace(/`\.opencode\/odd\/odd-swarm\/SKILL\.md`/g, '`plugins/odd-studio/skills/odd-swarm/SKILL.md`')
+    .replace(/`\.opencode\/odd\/odd-status\/SKILL\.md`/g, '`plugins/odd-studio/skills/odd-status/SKILL.md`')
+    .replace(/`\.opencode\/odd\/odd-deploy\/SKILL\.md`/g, '`plugins/odd-studio/skills/odd-deploy/SKILL.md`')
+    .replace(/`\.opencode\/odd\/odd-sync\/SKILL\.md`/g, '`plugins/odd-studio/skills/odd-sync/SKILL.md`')
+    .replace(/`\.opencode\/odd\//g, `\`${CODEX_ODD_ROOT}`);
 }

package/scripts/install-commands.js

@@ -47,13 +47,7 @@ export default async function installCommands(packageRoot, targetDir, options =
   const skillSource = path.join(packageRoot, 'skill');
   await fs.copy(skillSource, oddKnowledge, { overwrite: true });
 
-  // Rewrite the main SKILL.md path references for OpenCode
-  const mainSkill = path.join(oddKnowledge, 'SKILL.md');
-  if (fs.existsSync(mainSkill)) {
-    let content = await fs.readFile(mainSkill, 'utf8');
-    content = content.replace(/~\/\.claude\/skills\/odd\//g, '.opencode/odd/');
-    await fs.writeFile(mainSkill, content);
-  }
+  await rewriteSkillPaths(oddKnowledge);
 
   // Generate the /odd command that loads the main skill
   const oddCmd = [
@@ -63,10 +57,10 @@ export default async function installCommands(packageRoot, targetDir, options =
     '',
     '# /odd',
     '',
-    'You are now operating as the ODD Studio coach.',
+    'You are now operating as the ODD Studio startup coach.',
     '',
     'Read this file now:',
-    '- `.opencode/odd/SKILL.md` — the full ODD Studio coach',
+    '- `.opencode/odd/SKILL.md` — the ODD Studio startup coach',
     '',
     'Then execute the startup state check exactly as documented.',
     '',
@@ -76,3 +70,13 @@ export default async function installCommands(packageRoot, targetDir, options =
 
   return { destination: OC_COMMANDS, commandCount: COMMANDS.length };
 }
+
+async function rewriteSkillPaths(rootDir) {
+  const skillFiles = await fs.glob(path.join(rootDir, '**', 'SKILL.md'));
+  for (const filePath of skillFiles) {
+    let content = await fs.readFile(filePath, 'utf8');
+    content = content.replace(/~\/\.claude\/skills\/odd\//g, '.opencode/odd/');
+    content = content.replace(/\.claude\/skills\/odd\//g, '.opencode/odd/');
+    await fs.writeFile(filePath, content);
+  }
+}

package/scripts/setup-codex-plugin.js

@@ -7,6 +7,7 @@ import {
   ODD_HOOK_FILE,
 } from './assets.js';
 import installCodexCommands from './install-codex-commands.js';
+import { buildCodexHooksConfig } from './hook-definitions.js';
 
 const PLUGIN_RELATIVE_PATH = `./plugins/${CODEX_PLUGIN_NAME}`;
 const MARKETPLACE_ENTRY = {
@@ -36,6 +37,7 @@ export default async function setupCodexPlugin(packageRoot, targetDir) {
   await installCodexSkills(skillSource, pluginDest);
   await installCodexCommands(pluginDest);
   await installCodexHook(hookSource, pluginDest);
+  await installCodexHooksConfig(pluginDest);
   const marketplaceUpdated = await updateMarketplace(targetDir);
 
   return { destination: pluginDest, marketplaceUpdated };
@@ -80,6 +82,11 @@ async function installCodexHook(hookSource, pluginDest) {
   await fs.chmod(hookDest, 0o755);
 }
 
+async function installCodexHooksConfig(pluginDest) {
+  const hooksPath = path.join(pluginDest, 'hooks.json');
+  await fs.writeJson(hooksPath, buildCodexHooksConfig(ODD_HOOK_FILE), { spaces: 2 });
+}
+
 async function updateMarketplace(targetDir) {
   const marketplacePath = path.join(targetDir, '.agents', 'plugins', 'marketplace.json');
   await fs.ensureDir(path.dirname(marketplacePath));

package/scripts/setup-hooks.js

@@ -2,117 +2,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { ODD_HOOK_FILE as HOOK_FILE } from './assets.js';
-
-// All ODD Studio gates, grouped by event + matcher.
-// Each entry becomes one hooks[] item in settings.json pointing to:
-//   odd-studio.sh <gate-name>
-//
-// Two-marker system (swarm-write gate):
-//   1. .odd/.odd-flow-swarm-active  — created by *build, 24h TTL (session marker)
-//   2. .odd/.odd-flow-agent-token    — created by Task agents, 120s TTL (write token)
-//
-// The orchestrator (main conversation) can read files and coordinate,
-// but CANNOT write source code. Only Task agents can write source code,
-// and only after creating the agent token. This prevents the LLM from
-// bypassing swarm coordination by editing files directly from the main
-// conversation.
-const GATES = [
-  // ── PreToolUse ──────────────────────────────────────────────────────────
-  {
-    event: 'PreToolUse',
-    matcher: 'Agent',
-    gates: [
-      { name: 'brief-gate', timeout: 5, status: 'ODD brief gate...' },
-      { name: 'build-gate', timeout: 5, status: 'ODD build gate...' },
-    ],
-  },
-  {
-    event: 'PreToolUse',
-    matcher: 'Write',
-    gates: [
-      { name: 'swarm-write', timeout: 5, status: 'ODD swarm write gate...' },
-      { name: 'verify-gate', timeout: 5, status: 'ODD verification gate...' },
-      { name: 'confirm-gate', timeout: 5, status: 'ODD confirm gate...' },
-    ],
-  },
-  {
-    event: 'PreToolUse',
-    matcher: 'Edit',
-    gates: [
-      { name: 'swarm-write', timeout: 5, status: 'ODD swarm write gate...' },
-      { name: 'verify-gate', timeout: 5, status: 'ODD verification gate...' },
-      { name: 'confirm-gate', timeout: 5, status: 'ODD confirm gate...' },
-    ],
-  },
-  {
-    event: 'PreToolUse',
-    matcher: 'Bash',
-    gates: [
-    ],
-  },
-  // ── UserPromptSubmit ────────────────────────────────────────────────────
-  {
-    event: 'UserPromptSubmit',
-    matcher: null,
-    gates: [
-      { name: 'swarm-guard', timeout: 5, status: 'ODD swarm guard...' },
-    ],
-  },
-  // ── PostToolUse ─────────────────────────────────────────────────────────
-  {
-    event: 'PostToolUse',
-    matcher: 'Write',
-    gates: [
-      { name: 'plan-complete-gate', timeout: 5, status: 'ODD plan complete gate...' },
-    ],
-  },
-  {
-    event: 'PostToolUse',
-    matcher: 'Edit',
-    gates: [
-      { name: 'plan-complete-gate', timeout: 5, status: 'ODD plan complete gate...' },
-    ],
-  },
-  {
-    event: 'PostToolUse',
-    matcher: 'Bash',
-    gates: [
-      { name: 'session-save', timeout: 10, status: 'ODD session save...' },
-    ],
-  },
-  {
-    event: 'PostToolUse',
-    matcher: 'mcp__odd-flow__memory_store',
-    gates: [
-      { name: 'store-validate', timeout: 5, status: 'ODD store validate...' },
-    ],
-  },
-  {
-    event: 'PostToolUse',
-    matcher: 'mcp__odd-flow__coordination_sync',
-    gates: [
-      { name: 'sync-validate', timeout: 5, status: 'ODD sync validate...' },
-    ],
-  },
-  {
-    event: 'PostToolUse',
-    matcher: 'Write',
-    gates: [
-      { name: 'code-quality', timeout: 5, status: 'ODD code quality...' },
-      { name: 'security-quality', timeout: 5, status: 'ODD security quality...' },
-      { name: 'brief-quality', timeout: 5, status: 'ODD brief quality...' },
-      { name: 'outcome-quality', timeout: 5, status: 'ODD outcome quality...' },
-    ],
-  },
-  {
-    event: 'PostToolUse',
-    matcher: 'Edit',
-    gates: [
-      { name: 'code-quality', timeout: 5, status: 'ODD code quality...' },
-      { name: 'security-quality', timeout: 5, status: 'ODD security quality...' },
-    ],
-  },
-];
+import { HOOK_GROUPS, buildClaudeHooksConfig, countHookCommands } from './hook-definitions.js';
 
 export default async function setupHooks(packageRoot, targetDir, options = {}) {
   const hookSource = path.join(packageRoot, 'hooks', HOOK_FILE);
@@ -149,33 +39,19 @@ export default async function setupHooks(packageRoot, targetDir, options = {}) {
   }
 
   // Step 4: Register all gates
-  for (const group of GATES) {
-    const { event, matcher, gates } = group;
+  const oddHooks = buildClaudeHooksConfig(HOOK_FILE);
+  for (const event of Object.keys(oddHooks)) {
     if (!settings.hooks[event]) settings.hooks[event] = [];
-
-    const entry = {
-      _oddStudio: true,
-      hooks: gates.map((gate) => ({
-        type: 'command',
-        command: `.claude/hooks/${HOOK_FILE} ${gate.name}`,
-        timeout: gate.timeout,
-        statusMessage: gate.status,
-      })),
-    };
-    if (matcher) entry.matcher = matcher;
-
-    settings.hooks[event].push(entry);
+    settings.hooks[event].push(...oddHooks[event]);
   }
 
   // Step 5: Write project-local settings
   await fs.writeJson(settingsPath, settings, { spaces: 2 });
 
   // Count total gate registrations
-  const totalGates = GATES.reduce((sum, g) => sum + g.gates.length, 0);
-
   return {
     hookFile: HOOK_FILE,
-    hookCount: totalGates,
-    registrations: GATES.length,
+    hookCount: countHookCommands(),
+    registrations: HOOK_GROUPS.length,
   };
 }

package/scripts/state-schema.js

@@ -1,6 +1,6 @@
 'use strict';
 
-export const STATE_VERSION = '2.1.0';
+export const STATE_VERSION = '2.2.0';
 
 export const STATE_DEFAULTS = {
   version: STATE_VERSION,
@@ -24,6 +24,7 @@ export const STATE_DEFAULTS = {
   sessionBriefCount: 0,
   briefConfirmed: false,
   verificationConfirmed: false,
+  debugSession: false,
   swarmActive: false,
   buildPhase: null,
   currentBuildPhase: null,
@@ -32,9 +33,6 @@ export const STATE_DEFAULTS = {
   debugTarget: null,
   debugSummary: null,
   debugStartedAt: null,
-  checkpointStatus: 'unknown',
-  lastCheckpointAt: null,
-  checkpointFindings: 0,
   securityBaselineVersion: '2026-04-12',
   notes: '',
 };