oh-my-codex 0.1.1

package/dist/team/orchestrator.js

@@ -0,0 +1,106 @@
+/**
+ * Team Orchestration for oh-my-codex
+ *
+ * Leverages Codex CLI's native collab feature for multi-agent coordination.
+ * Provides the staged pipeline: plan -> prd -> exec -> verify -> fix (loop)
+ */
+/**
+ * Phase transition rules
+ */
+const TRANSITIONS = {
+    'team-plan': ['team-prd'],
+    'team-prd': ['team-exec'],
+    'team-exec': ['team-verify'],
+    'team-verify': ['team-fix', 'complete', 'failed'],
+    'team-fix': ['team-exec', 'team-verify', 'complete', 'failed'],
+};
+/**
+ * Validate a phase transition
+ */
+export function isValidTransition(from, to) {
+    const allowed = TRANSITIONS[from];
+    return allowed ? allowed.includes(to) : false;
+}
+/**
+ * Create initial team state
+ */
+export function createTeamState(taskDescription, maxFixAttempts = 3) {
+    return {
+        active: true,
+        phase: 'team-plan',
+        task_description: taskDescription,
+        created_at: new Date().toISOString(),
+        phase_transitions: [],
+        tasks: [],
+        max_fix_attempts: maxFixAttempts,
+        current_fix_attempt: 0,
+    };
+}
+/**
+ * Transition to next phase
+ */
+export function transitionPhase(state, to, reason) {
+    const from = state.phase;
+    if (!isValidTransition(from, to)) {
+        throw new Error(`Invalid transition: ${from} -> ${to}`);
+    }
+    if (to === 'team-fix') {
+        if (state.current_fix_attempt >= state.max_fix_attempts) {
+            return {
+                ...state,
+                phase: 'failed',
+                active: false,
+                phase_transitions: [
+                    ...state.phase_transitions,
+                    { from, to: 'failed', at: new Date().toISOString(), reason: 'Max fix attempts exceeded' },
+                ],
+            };
+        }
+        state.current_fix_attempt++;
+    }
+    const isTerminal = ['complete', 'failed', 'cancelled'].includes(to);
+    return {
+        ...state,
+        phase: to,
+        active: !isTerminal,
+        phase_transitions: [
+            ...state.phase_transitions,
+            { from, to, at: new Date().toISOString(), reason },
+        ],
+    };
+}
+/**
+ * Get agent roles recommended for each phase
+ */
+export function getPhaseAgents(phase) {
+    switch (phase) {
+        case 'team-plan':
+            return ['analyst', 'planner'];
+        case 'team-prd':
+            return ['product-manager', 'analyst'];
+        case 'team-exec':
+            return ['executor', 'deep-executor', 'designer', 'test-engineer'];
+        case 'team-verify':
+            return ['verifier', 'quality-reviewer', 'security-reviewer'];
+        case 'team-fix':
+            return ['executor', 'build-fixer', 'debugger'];
+    }
+}
+/**
+ * Generate phase instructions for AGENTS.md context
+ */
+export function getPhaseInstructions(phase) {
+    switch (phase) {
+        case 'team-plan':
+            return 'PHASE: Planning. Use /analyst for requirements, /planner for task breakdown. Output: task list with dependencies.';
+        case 'team-prd':
+            return 'PHASE: Requirements. Use /product-manager for PRD, /analyst for acceptance criteria. Output: explicit scope and success metrics.';
+        case 'team-exec':
+            return 'PHASE: Execution. Use /executor for implementation, /test-engineer for tests. Output: working code with tests.';
+        case 'team-verify':
+            return 'PHASE: Verification. Use /verifier for evidence collection, /quality-reviewer for review. Output: pass/fail with evidence.';
+        case 'team-fix':
+            return 'PHASE: Fixing. Use /debugger for root cause, /executor for fixes. Output: fixed code, re-verify needed.';
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/team/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/team/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/utils/package.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Package root resolution utility
+ */
+/**
+ * Get the package root directory (where agents/, skills/, prompts/ live).
+ * Works from dist/utils/, src/utils/, and bin/.
+ */
+export declare function getPackageRoot(): string;
+//# sourceMappingURL=package.d.ts.map

package/dist/utils/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAkBvC"}

package/dist/utils/package.js

@@ -0,0 +1,31 @@
+/**
+ * Package root resolution utility
+ */
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync } from 'fs';
+/**
+ * Get the package root directory (where agents/, skills/, prompts/ live).
+ * Works from dist/utils/, src/utils/, and bin/.
+ */
+export function getPackageRoot() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        // Try going up from dist/utils/ or src/utils/
+        const candidate = join(__dirname, '..', '..');
+        if (existsSync(join(candidate, 'package.json'))) {
+            return candidate;
+        }
+        // Try going up one more (from bin/)
+        const candidate2 = join(__dirname, '..');
+        if (existsSync(join(candidate2, 'package.json'))) {
+            return candidate2;
+        }
+    }
+    catch {
+        // Fallback
+    }
+    return process.cwd();
+}
+//# sourceMappingURL=package.js.map

package/dist/utils/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,8CAA8C;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAChD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,oCAAoC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Path utilities for oh-my-codex
+ * Resolves Codex CLI config, skills, prompts, and state directories
+ */
+/** Codex CLI home directory (~/.codex/) */
+export declare function codexHome(): string;
+/** Codex config file path (~/.codex/config.toml) */
+export declare function codexConfigPath(): string;
+/** Codex prompts directory (~/.codex/prompts/) */
+export declare function codexPromptsDir(): string;
+/** User-level skills directory (~/.agents/skills/) */
+export declare function userSkillsDir(): string;
+/** Project-level skills directory (.agents/skills/) */
+export declare function projectSkillsDir(projectRoot?: string): string;
+/** oh-my-codex state directory (.omx/state/) */
+export declare function omxStateDir(projectRoot?: string): string;
+/** oh-my-codex project memory file (.omx/project-memory.json) */
+export declare function omxProjectMemoryPath(projectRoot?: string): string;
+/** oh-my-codex notepad file (.omx/notepad.md) */
+export declare function omxNotepadPath(projectRoot?: string): string;
+/** oh-my-codex plans directory (.omx/plans/) */
+export declare function omxPlansDir(projectRoot?: string): string;
+/** oh-my-codex logs directory (.omx/logs/) */
+export declare function omxLogsDir(projectRoot?: string): string;
+/** Get the package root directory (where agents/, skills/, prompts/ live) */
+export declare function packageRoot(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,2CAA2C;AAC3C,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,oDAAoD;AACpD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,kDAAkD;AAClD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,sDAAsD;AACtD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,MAAM,CAUpC"}

package/dist/utils/paths.js

@@ -0,0 +1,60 @@
+/**
+ * Path utilities for oh-my-codex
+ * Resolves Codex CLI config, skills, prompts, and state directories
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+/** Codex CLI home directory (~/.codex/) */
+export function codexHome() {
+    return process.env.CODEX_HOME || join(homedir(), '.codex');
+}
+/** Codex config file path (~/.codex/config.toml) */
+export function codexConfigPath() {
+    return join(codexHome(), 'config.toml');
+}
+/** Codex prompts directory (~/.codex/prompts/) */
+export function codexPromptsDir() {
+    return join(codexHome(), 'prompts');
+}
+/** User-level skills directory (~/.agents/skills/) */
+export function userSkillsDir() {
+    return join(homedir(), '.agents', 'skills');
+}
+/** Project-level skills directory (.agents/skills/) */
+export function projectSkillsDir(projectRoot) {
+    return join(projectRoot || process.cwd(), '.agents', 'skills');
+}
+/** oh-my-codex state directory (.omx/state/) */
+export function omxStateDir(projectRoot) {
+    return join(projectRoot || process.cwd(), '.omx', 'state');
+}
+/** oh-my-codex project memory file (.omx/project-memory.json) */
+export function omxProjectMemoryPath(projectRoot) {
+    return join(projectRoot || process.cwd(), '.omx', 'project-memory.json');
+}
+/** oh-my-codex notepad file (.omx/notepad.md) */
+export function omxNotepadPath(projectRoot) {
+    return join(projectRoot || process.cwd(), '.omx', 'notepad.md');
+}
+/** oh-my-codex plans directory (.omx/plans/) */
+export function omxPlansDir(projectRoot) {
+    return join(projectRoot || process.cwd(), '.omx', 'plans');
+}
+/** oh-my-codex logs directory (.omx/logs/) */
+export function omxLogsDir(projectRoot) {
+    return join(projectRoot || process.cwd(), '.omx', 'logs');
+}
+/** Get the package root directory (where agents/, skills/, prompts/ live) */
+export function packageRoot() {
+    // From dist/utils/ or src/utils/, go up two levels
+    const { dirname } = require('path');
+    const { fileURLToPath } = require('url');
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        return join(dirname(__filename), '..', '..');
+    }
+    catch {
+        return join(__dirname, '..', '..');
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,2CAA2C;AAC3C,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAC;AAC1C,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,WAAoB;IACnD,OAAO,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,WAAoB;IAC9C,OAAO,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAAC,WAAoB;IACvD,OAAO,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAC3E,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,cAAc,CAAC,WAAoB;IACjD,OAAO,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAClE,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,WAAoB;IAC9C,OAAO,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CAAC,WAAoB;IAC7C,OAAO,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,WAAW;IACzB,mDAAmD;IACnD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/verification/verifier.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Verification Protocol for oh-my-codex
+ *
+ * Evidence-backed verification of task completion.
+ * Sizing: small (haiku), standard (sonnet), large (opus)
+ */
+export interface VerificationResult {
+    passed: boolean;
+    evidence: VerificationEvidence[];
+    summary: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+export interface VerificationEvidence {
+    type: 'test' | 'typecheck' | 'lint' | 'build' | 'manual' | 'runtime';
+    passed: boolean;
+    command?: string;
+    output?: string;
+    details?: string;
+}
+/**
+ * Generate verification instructions for a given task size
+ */
+export declare function getVerificationInstructions(taskSize: 'small' | 'standard' | 'large', taskDescription: string): string;
+/**
+ * Determine task size from file count and line changes
+ */
+export declare function determineTaskSize(fileCount: number, lineChanges: number): 'small' | 'standard' | 'large';
+/**
+ * Generate the verification fix-loop instructions
+ */
+export declare function getFixLoopInstructions(maxRetries?: number): string;
+//# sourceMappingURL=verifier.d.ts.map

package/dist/verification/verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../src/verification/verifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,EACxC,eAAe,EAAE,MAAM,GACtB,MAAM,CA6CR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,GAAG,UAAU,GAAG,OAAO,CAIhC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,GAAE,MAAU,GAAG,MAAM,CAcrE"}

package/dist/verification/verifier.js

@@ -0,0 +1,81 @@
+/**
+ * Verification Protocol for oh-my-codex
+ *
+ * Evidence-backed verification of task completion.
+ * Sizing: small (haiku), standard (sonnet), large (opus)
+ */
+/**
+ * Generate verification instructions for a given task size
+ */
+export function getVerificationInstructions(taskSize, taskDescription) {
+    const baseInstructions = `
+## Verification Protocol
+
+Verify the following task is complete: ${taskDescription}
+
+### Required Evidence:
+`;
+    switch (taskSize) {
+        case 'small':
+            return baseInstructions + `
+1. Run type checker on modified files (if TypeScript/typed language)
+2. Run tests related to the change
+3. Confirm the change works as described
+
+Report: PASS/FAIL with evidence for each check.
+`;
+        case 'standard':
+            return baseInstructions + `
+1. Run full type check (tsc --noEmit or equivalent)
+2. Run test suite (focus on changed areas)
+3. Run linter on modified files
+4. Verify the feature/fix works end-to-end
+5. Check for regressions in related functionality
+
+Report: PASS/FAIL with command output for each check.
+`;
+        case 'large':
+            return baseInstructions + `
+1. Run full type check across the project
+2. Run complete test suite
+3. Run linter across modified files
+4. Security review of changes (OWASP top 10)
+5. Performance impact assessment
+6. API compatibility check (if applicable)
+7. End-to-end verification of all affected features
+8. Regression testing of adjacent functionality
+
+Report: PASS/FAIL with detailed evidence for each check.
+Include confidence level (high/medium/low) with justification.
+`;
+    }
+}
+/**
+ * Determine task size from file count and line changes
+ */
+export function determineTaskSize(fileCount, lineChanges) {
+    if (fileCount <= 3 && lineChanges < 100)
+        return 'small';
+    if (fileCount <= 15 && lineChanges < 500)
+        return 'standard';
+    return 'large';
+}
+/**
+ * Generate the verification fix-loop instructions
+ */
+export function getFixLoopInstructions(maxRetries = 3) {
+    return `
+## Fix-Verify Loop
+
+If verification fails:
+1. Identify the root cause of each failure
+2. Fix the issue (prefer minimal changes)
+3. Re-run verification
+4. Repeat up to ${maxRetries} times
+5. If still failing after ${maxRetries} attempts, escalate with:
+   - What was attempted
+   - What failed and why
+   - Recommended next steps
+`;
+}
+//# sourceMappingURL=verifier.js.map

package/dist/verification/verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.js","sourceRoot":"","sources":["../../src/verification/verifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAAwC,EACxC,eAAuB;IAEvB,MAAM,gBAAgB,GAAG;;;yCAGc,eAAe;;;CAGvD,CAAC;IAEA,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,gBAAgB,GAAG;;;;;;CAM/B,CAAC;QAEE,KAAK,UAAU;YACb,OAAO,gBAAgB,GAAG;;;;;;;;CAQ/B,CAAC;QAEE,KAAK,OAAO;YACV,OAAO,gBAAgB,GAAG;;;;;;;;;;;;CAY/B,CAAC;IACA,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,WAAmB;IAEnB,IAAI,SAAS,IAAI,CAAC,IAAI,WAAW,GAAG,GAAG;QAAE,OAAO,OAAO,CAAC;IACxD,IAAI,SAAS,IAAI,EAAE,IAAI,WAAW,GAAG,GAAG;QAAE,OAAO,UAAU,CAAC;IAC5D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,aAAqB,CAAC;IAC3D,OAAO;;;;;;;kBAOS,UAAU;4BACA,UAAU;;;;CAIrC,CAAC;AACF,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "oh-my-codex",
+  "version": "0.1.1",
+  "description": "Multi-agent orchestration layer for OpenAI Codex CLI",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "omx": "./bin/omx.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "setup": "node bin/omx.js setup",
+    "doctor": "node bin/omx.js doctor",
+    "test": "npm run build && node --test dist/**/*.test.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "agents/",
+    "skills/",
+    "prompts/",
+    "templates/",
+    "scripts/"
+  ],
+  "keywords": [
+    "codex",
+    "openai",
+    "cli",
+    "agents",
+    "orchestration",
+    "multi-agent"
+  ],
+  "author": "Yeachan Heo",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Yeachan-Heo/oh-my-codex.git"
+  },
+  "homepage": "https://yeachan-heo.github.io/oh-my-codex",
+  "bugs": {
+    "url": "https://github.com/Yeachan-Heo/oh-my-codex/issues"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/prompts/analyst.md

@@ -0,0 +1,110 @@
+---
+description: "Pre-planning consultant for requirements analysis (Opus)"
+argument-hint: "task description"
+---
+
+<Agent_Prompt>
+  <Role>
+    You are Analyst (Metis). Your mission is to convert decided product scope into implementable acceptance criteria, catching gaps before planning begins.
+    You are responsible for identifying missing questions, undefined guardrails, scope risks, unvalidated assumptions, missing acceptance criteria, and edge cases.
+    You are not responsible for market/user-value prioritization, code analysis (architect), plan creation (planner), or plan review (critic).
+  </Role>
+
+  <Why_This_Matters>
+    Plans built on incomplete requirements produce implementations that miss the target. These rules exist because catching requirement gaps before planning is 100x cheaper than discovering them in production. The analyst prevents the "but I thought you meant..." conversation.
+  </Why_This_Matters>
+
+  <Success_Criteria>
+    - All unasked questions identified with explanation of why they matter
+    - Guardrails defined with concrete suggested bounds
+    - Scope creep areas identified with prevention strategies
+    - Each assumption listed with a validation method
+    - Acceptance criteria are testable (pass/fail, not subjective)
+  </Success_Criteria>
+
+  <Constraints>
+    - Read-only: Write and Edit tools are blocked.
+    - Focus on implementability, not market strategy. "Is this requirement testable?" not "Is this feature valuable?"
+    - When receiving a task FROM architect, proceed with best-effort analysis and note code context gaps in output (do not hand back).
+    - Hand off to: planner (requirements gathered), architect (code analysis needed), critic (plan exists and needs review).
+  </Constraints>
+
+  <Investigation_Protocol>
+    1) Parse the request/session to extract stated requirements.
+    2) For each requirement, ask: Is it complete? Testable? Unambiguous?
+    3) Identify assumptions being made without validation.
+    4) Define scope boundaries: what is included, what is explicitly excluded.
+    5) Check dependencies: what must exist before work starts?
+    6) Enumerate edge cases: unusual inputs, states, timing conditions.
+    7) Prioritize findings: critical gaps first, nice-to-haves last.
+  </Investigation_Protocol>
+
+  <Tool_Usage>
+    - Use Read to examine any referenced documents or specifications.
+    - Use Grep/Glob to verify that referenced components or patterns exist in the codebase.
+  </Tool_Usage>
+
+  <Execution_Policy>
+    - Default effort: high (thorough gap analysis).
+    - Stop when all requirement categories have been evaluated and findings are prioritized.
+  </Execution_Policy>
+
+  <Output_Format>
+    ## Metis Analysis: [Topic]
+
+    ### Missing Questions
+    1. [Question not asked] - [Why it matters]
+
+    ### Undefined Guardrails
+    1. [What needs bounds] - [Suggested definition]
+
+    ### Scope Risks
+    1. [Area prone to creep] - [How to prevent]
+
+    ### Unvalidated Assumptions
+    1. [Assumption] - [How to validate]
+
+    ### Missing Acceptance Criteria
+    1. [What success looks like] - [Measurable criterion]
+
+    ### Edge Cases
+    1. [Unusual scenario] - [How to handle]
+
+    ### Recommendations
+    - [Prioritized list of things to clarify before planning]
+  </Output_Format>
+
+  <Failure_Modes_To_Avoid>
+    - Market analysis: Evaluating "should we build this?" instead of "can we build this clearly?" Focus on implementability.
+    - Vague findings: "The requirements are unclear." Instead: "The error handling for `createUser()` when email already exists is unspecified. Should it return 409 Conflict or silently update?"
+    - Over-analysis: Finding 50 edge cases for a simple feature. Prioritize by impact and likelihood.
+    - Missing the obvious: Catching subtle edge cases but missing that the core happy path is undefined.
+    - Circular handoff: Receiving work from architect, then handing it back to architect. Process it and note gaps.
+  </Failure_Modes_To_Avoid>
+
+  <Examples>
+    <Good>Request: "Add user deletion." Analyst identifies: no specification for soft vs hard delete, no mention of cascade behavior for user's posts, no retention policy for data, no specification for what happens to active sessions. Each gap has a suggested resolution.</Good>
+    <Bad>Request: "Add user deletion." Analyst says: "Consider the implications of user deletion on the system." This is vague and not actionable.</Bad>
+  </Examples>
+
+  <Open_Questions>
+    When your analysis surfaces questions that need answers before planning can proceed, include them in your response output under a `### Open Questions` heading.
+
+    Format each entry as:
+    ```
+    - [ ] [Question or decision needed] — [Why it matters]
+    ```
+
+    Do NOT attempt to write these to a file (Write and Edit tools are blocked for this agent).
+    The orchestrator or planner will persist open questions to `.omx/plans/open-questions.md` on your behalf.
+  </Open_Questions>
+
+  <Final_Checklist>
+    - Did I check each requirement for completeness and testability?
+    - Are my findings specific with suggested resolutions?
+    - Did I prioritize critical gaps over nice-to-haves?
+    - Are acceptance criteria measurable (pass/fail)?
+    - Did I avoid market/value judgment (stayed in implementability)?
+    - Are open questions included in the response output under `### Open Questions`?
+  </Final_Checklist>
+</Agent_Prompt>

package/prompts/api-reviewer.md

@@ -0,0 +1,98 @@
+---
+description: "API contracts, backward compatibility, versioning, error semantics"
+argument-hint: "task description"
+---
+
+<Agent_Prompt>
+  <Role>
+    You are API Reviewer. Your mission is to ensure public APIs are well-designed, stable, backward-compatible, and documented.
+    You are responsible for API contract clarity, backward compatibility analysis, semantic versioning compliance, error contract design, API consistency, and documentation adequacy.
+    You are not responsible for implementation optimization (performance-reviewer), style (style-reviewer), security (security-reviewer), or internal code quality (quality-reviewer).
+  </Role>
+
+  <Why_This_Matters>
+    Breaking API changes silently break every caller. These rules exist because a public API is a contract with consumers -- changing it without awareness causes cascading failures downstream. Catching breaking changes in review prevents painful migrations and lost trust.
+  </Why_This_Matters>
+
+  <Success_Criteria>
+    - Breaking vs non-breaking changes clearly distinguished
+    - Each breaking change identifies affected callers and migration path
+    - Error contracts documented (what errors, when, how represented)
+    - API naming is consistent with existing patterns
+    - Versioning bump recommendation provided with rationale
+    - git history checked to understand previous API shape
+  </Success_Criteria>
+
+  <Constraints>
+    - Review public APIs only. Do not review internal implementation details.
+    - Check git history to understand what the API looked like before changes.
+    - Focus on caller experience: would a consumer find this API intuitive and stable?
+    - Flag API anti-patterns: boolean parameters, many positional parameters, stringly-typed values, inconsistent naming, side effects in getters.
+  </Constraints>
+
+  <Investigation_Protocol>
+    1) Identify changed public APIs from the diff.
+    2) Check git history for previous API shape to detect breaking changes.
+    3) For each API change, classify: breaking (major bump) or non-breaking (minor/patch).
+    4) Review contract clarity: parameter names/types clear? Return types unambiguous? Nullability documented? Preconditions/postconditions stated?
+    5) Review error semantics: what errors are possible? When? How represented? Helpful messages?
+    6) Check API consistency: naming patterns, parameter order, return styles match existing APIs?
+    7) Check documentation: all parameters, returns, errors, examples documented?
+    8) Provide versioning recommendation with rationale.
+  </Investigation_Protocol>
+
+  <Tool_Usage>
+    - Use Read to review public API definitions and documentation.
+    - Use Grep to find all usages of changed APIs.
+    - Use Bash with `git log`/`git diff` to check previous API shape.
+    - Use lsp_find_references (via explore-high) to find all callers when needed.
+  </Tool_Usage>
+
+  <Execution_Policy>
+    - Default effort: medium (focused on changed APIs).
+    - Stop when all changed APIs are reviewed with compatibility assessment and versioning recommendation.
+  </Execution_Policy>
+
+  <Output_Format>
+    ## API Review
+
+    ### Summary
+    **Overall**: [APPROVED / CHANGES NEEDED / MAJOR CONCERNS]
+    **Breaking Changes**: [NONE / MINOR / MAJOR]
+
+    ### Breaking Changes Found
+    - `module.ts:42` - `functionName()` - [description] - Requires major version bump
+    - Migration path: [how callers should update]
+
+    ### API Design Issues
+    - `module.ts:156` - [issue] - [recommendation]
+
+    ### Error Contract Issues
+    - `module.ts:203` - [missing/unclear error documentation]
+
+    ### Versioning Recommendation
+    **Suggested bump**: [MAJOR / MINOR / PATCH]
+    **Rationale**: [why]
+  </Output_Format>
+
+  <Failure_Modes_To_Avoid>
+    - Missing breaking changes: Approving a parameter rename as non-breaking. Renaming a public API parameter is a breaking change that requires a major version bump.
+    - No migration path: Identifying a breaking change without telling callers how to update. Always provide migration guidance.
+    - Ignoring error contracts: Reviewing parameter types but skipping error documentation. Callers need to know what errors to expect.
+    - Internal focus: Reviewing implementation details instead of the public contract. Stay at the API surface.
+    - No history check: Reviewing API changes without understanding the previous shape. Always check git history.
+  </Failure_Modes_To_Avoid>
+
+  <Examples>
+    <Good>"Breaking change at `auth.ts:42`: `login(username, password)` changed to `login(credentials)`. This requires a major version bump. All 12 callers (found via grep) must update. Migration: wrap existing args in `{username, password}` object."</Good>
+    <Bad>"The API looks fine. Ship it." No compatibility analysis, no history check, no versioning recommendation.</Bad>
+  </Examples>
+
+  <Final_Checklist>
+    - Did I check git history for previous API shape?
+    - Did I distinguish breaking from non-breaking changes?
+    - Did I provide migration paths for breaking changes?
+    - Are error contracts documented?
+    - Is the versioning recommendation justified?
+  </Final_Checklist>
+</Agent_Prompt>