codex-orchestrator 0.1.0

package/dist/src/setup/project-config.js

@@ -0,0 +1,124 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { forbiddenRuntimeKeys } from '../config/constants.js';
+import { validateConfig } from '../config/schema.js';
+export const defaultLabels = {
+    auto: label('agent:auto', '0E8A16', 'Scoped autonomous Codex implementation'),
+    planAuto: label('agent:plan-auto', '5319E7', 'Autonomous Codex planning and issue-tree execution'),
+    running: label('agent:running', '1D76DB', 'Codex orchestration is currently running'),
+    blocked: label('agent:blocked', 'B60205', 'Codex orchestration is blocked and needs maintainer input'),
+    manual: label('agent:manual', 'BFDADC', 'Issue is reserved for manual work'),
+    review: label('agent:review', 'FBCA04', 'Codex work is ready for human review'),
+    child: label('agent:child', 'C2E0C6', 'Child issue owned by an autonomous parent issue tree'),
+};
+export function buildProjectConfig(input) {
+    return {
+        version: 1,
+        github: {
+            owner: input.owner,
+            repo: input.repo,
+            prepareLabels: input.prepareLabels,
+            labels: defaultLabels,
+        },
+        runner: {
+            workspaceRoot: '.codex-orchestrator/workspaces',
+            maxParallelChildren: 3,
+            stateDir: '.codex-orchestrator/state',
+        },
+        codex: {
+            adapter: 'codex-cli',
+            command: 'codex',
+            args: [
+                'exec',
+                '--cd',
+                '${worktreePath}',
+                '--sandbox',
+                'workspace-write',
+                '--add-dir',
+                '${stateDir}',
+                '--ignore-user-config',
+                '--output-last-message',
+                '${reportPath}',
+                '-',
+            ],
+            promptFileEnv: 'CODEX_ORCHESTRATOR_PROMPT_FILE',
+            reportFileEnv: 'CODEX_ORCHESTRATOR_REPORT_FILE',
+        },
+        project: {
+            configDir: '.codex-orchestrator',
+            promptsDir: '.codex-orchestrator/prompts',
+        },
+        workflows: input.workflows,
+        checks: {
+            typecheck: 'npm run typecheck',
+            test: 'npm test',
+        },
+        deny: {
+            secretFiles: ['.env', '.env.*'],
+            destructiveDbOrCache: true,
+            productionDeployOrRelease: true,
+            additionalPathGlobs: [],
+        },
+        branches: {
+            base: 'main',
+            scopedIssue: 'codex/issue-${issueNumber}',
+            issueTree: 'codex/tree-${parentIssueNumber}',
+        },
+        pullRequests: {
+            scopedIssueTitle: 'Codex: issue #${issueNumber}',
+            issueTreeTitle: 'Codex: parent issue #${parentIssueNumber}',
+        },
+        issueClassification: {
+            promotionCriteria: [
+                'api-contract',
+                'dto-or-schema',
+                'persistence',
+                'auth-or-permissions',
+                'billing',
+                'background-job',
+                'shared-state',
+                'multi-service',
+                'three-or-more-runtime-files',
+            ],
+            clarificationGate: 'block-and-comment',
+        },
+    };
+}
+export async function readExistingConfig(configPath) {
+    try {
+        const content = await readFile(configPath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return undefined;
+        }
+        throw error;
+    }
+}
+export function assertNoRuntimeState(value) {
+    if (!value) {
+        return;
+    }
+    const forbiddenKey = forbiddenRuntimeKeys.find((key) => key in value);
+    if (forbiddenKey) {
+        throw new Error(`${forbiddenKey} is runtime state and must not be committed config`);
+    }
+}
+export async function writeProjectConfig(targetRoot, config) {
+    const configPath = projectConfigPath(targetRoot);
+    const validation = validateConfig(config);
+    if (!validation.ok) {
+        throw new Error(`Generated config is invalid: ${validation.errors.join('; ')}`);
+    }
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, 'utf8');
+    return configPath;
+}
+export function projectConfigPath(targetRoot) {
+    return join(targetRoot, '.codex-orchestrator', 'config.json');
+}
+function label(name, color, description) {
+    return { name, color, description };
+}
+//# sourceMappingURL=project-config.js.map

package/dist/src/setup/project-config.js.map

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

package/dist/src/setup/setup-command.d.ts

@@ -0,0 +1,22 @@
+import type { CodexOrchestratorConfig } from '../config/schema.js';
+import type { GitHubLabelAdapter, LabelPlan } from './labels.js';
+export interface SetupCommandOptions {
+    targetRoot: string;
+    githubOwner?: string;
+    githubRepo?: string;
+    dryRun?: boolean;
+    prepareLabels?: boolean;
+    skillsRoot?: string;
+    replacePackageSkills?: boolean;
+    labelAdapter?: GitHubLabelAdapter;
+}
+export interface SetupCommandResult {
+    config: CodexOrchestratorConfig;
+    configPath: string;
+    dryRun: boolean;
+    labelPlan: LabelPlan;
+    promptFiles: string[];
+    output: string;
+}
+export declare function runSetupCommand(options: SetupCommandOptions): Promise<SetupCommandResult>;
+//# sourceMappingURL=setup-command.d.ts.map

package/dist/src/setup/setup-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-command.d.ts","sourceRoot":"","sources":["../../../src/setup/setup-command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAGnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAWjE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,uBAAuB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+C/F"}

package/dist/src/setup/setup-command.js

@@ -0,0 +1,104 @@
+import { cp, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { validateConfig } from '../config/schema.js';
+import { GhCliLabelAdapter } from './github-label-adapter.js';
+import { planLabels } from './labels.js';
+import { assertNoRuntimeState, buildProjectConfig, projectConfigPath, readExistingConfig, writeProjectConfig, } from './project-config.js';
+import { defaultSkillsRoot, resolveWorkflowConfigs, workflowDefinitions } from './workflows.js';
+export async function runSetupCommand(options) {
+    const dryRun = options.dryRun ?? false;
+    const configPath = projectConfigPath(options.targetRoot);
+    const existingConfig = await readExistingConfig(configPath);
+    assertNoRuntimeState(existingConfig);
+    const owner = options.githubOwner ?? readExistingString(existingConfig, 'github', 'owner');
+    const repo = options.githubRepo ?? readExistingString(existingConfig, 'github', 'repo');
+    if (!owner || !repo) {
+        throw new Error('setup requires --github-owner and --github-repo unless existing config provides them');
+    }
+    const prepareLabels = options.prepareLabels ? 'create-missing' : 'report-only';
+    const workflows = await resolveWorkflowConfigs(options.skillsRoot ?? defaultSkillsRoot());
+    const config = buildProjectConfig({
+        owner,
+        repo,
+        prepareLabels,
+        workflows,
+    });
+    const validation = validateConfig(config);
+    if (!validation.ok) {
+        throw new Error(`Generated config is invalid: ${validation.errors.join('; ')}`);
+    }
+    const adapter = options.labelAdapter ?? new GhCliLabelAdapter(owner, repo);
+    const labelPlan = await planLabels(adapter, config.github.labels, prepareLabels, dryRun);
+    const promptFiles = workflowDefinitions.map((definition) => join(options.targetRoot, definition.promptPath));
+    if (!dryRun) {
+        await writeProjectConfig(options.targetRoot, config);
+        await copyPromptFiles(options.targetRoot, options.replacePackageSkills ?? false);
+    }
+    const output = formatSetupOutput(configPath, labelPlan, config, promptFiles, dryRun);
+    return {
+        config,
+        configPath,
+        dryRun,
+        labelPlan,
+        promptFiles,
+        output,
+    };
+}
+function formatSetupOutput(configPath, labelPlan, config, promptFiles, dryRun) {
+    const workflowLines = Object.entries(config.workflows)
+        .map(([id, workflow]) => `  - ${id}: ${workflow.source}`)
+        .join('\n');
+    const missingLabels = labelPlan.missing.map((label) => label.name).join(', ') || 'none';
+    const promptSummary = promptFiles.map((file) => `  - ${file}`).join('\n');
+    return [
+        `config: ${configPath}`,
+        `mode: ${dryRun ? 'dry-run' : 'write'}`,
+        `labels: ${labelPlan.policy}`,
+        `missing labels: ${missingLabels}`,
+        'workflows:',
+        workflowLines,
+        'prompts:',
+        promptSummary,
+        `checks: ${Object.keys(config.checks).join(', ')}`,
+        `codex command: ${config.codex.command} ${config.codex.args.join(' ')}`,
+        `branches: base ${config.branches.base}, ${config.branches.scopedIssue}, ${config.branches.issueTree}`,
+        `pull requests: ${config.pullRequests.scopedIssueTitle}, ${config.pullRequests.issueTreeTitle}`,
+        'Codex will not be launched',
+        'setup will not commit or open a pull request',
+    ].join('\n');
+}
+async function copyPromptFiles(targetRoot, replacePackageSkills) {
+    await copyPrompt('setup-skill.md', join(targetRoot, '.codex-orchestrator', 'prompts', 'setup-skill.md'), replacePackageSkills);
+    for (const definition of workflowDefinitions) {
+        const sourceName = definition.promptPath.replace('.codex-orchestrator/prompts/workflows/', '');
+        await copyPrompt(join('workflows', sourceName), join(targetRoot, definition.promptPath), replacePackageSkills);
+    }
+}
+async function copyPrompt(relativePromptPath, destination, replacePackageSkills) {
+    await mkdir(dirname(destination), { recursive: true });
+    const source = new URL(`../../../prompts/${relativePromptPath}`, import.meta.url);
+    if (replacePackageSkills) {
+        await cp(source, destination, { force: true });
+        return;
+    }
+    try {
+        await readFile(destination, 'utf8');
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            const content = await readFile(source, 'utf8');
+            await writeFile(destination, content, 'utf8');
+            return;
+        }
+        throw error;
+    }
+}
+function readExistingString(config, section, key) {
+    const sectionValue = config?.[section];
+    if (typeof sectionValue !== 'object' || sectionValue === null || Array.isArray(sectionValue)) {
+        return undefined;
+    }
+    const value = sectionValue[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=setup-command.js.map

package/dist/src/setup/setup-command.js.map

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

package/dist/src/setup/workflows.d.ts

@@ -0,0 +1,11 @@
+import type { WorkflowConfig, WorkflowId } from '../config/schema.js';
+export interface WorkflowDefinition {
+    id: WorkflowId;
+    skillName: string;
+    promptPath: string;
+}
+export declare const workflowDefinitions: readonly WorkflowDefinition[];
+export type WorkflowConfigMap = Record<WorkflowId, WorkflowConfig>;
+export declare function defaultSkillsRoot(env?: NodeJS.ProcessEnv): string;
+export declare function resolveWorkflowConfigs(skillsRoot: string): Promise<WorkflowConfigMap>;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/src/setup/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../src/setup/workflows.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,UAAU,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,kBAAkB,EAuBnD,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAEnE,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE9E;AAED,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuB3F"}

package/dist/src/setup/workflows.js

@@ -0,0 +1,60 @@
+import { access } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const workflowDefinitions = [
+    { id: 'prd', skillName: 'to-prd', promptPath: '.codex-orchestrator/prompts/workflows/prd.md' },
+    {
+        id: 'issueBreakdown',
+        skillName: 'to-issues',
+        promptPath: '.codex-orchestrator/prompts/workflows/issue-breakdown.md',
+    },
+    {
+        id: 'breakdownReview',
+        skillName: 'issue-breakdown-review',
+        promptPath: '.codex-orchestrator/prompts/workflows/breakdown-review.md',
+    },
+    { id: 'triage', skillName: 'triage', promptPath: '.codex-orchestrator/prompts/workflows/triage.md' },
+    {
+        id: 'scopedImplementation',
+        skillName: 'spec-implementer',
+        promptPath: '.codex-orchestrator/prompts/workflows/scoped-implementation.md',
+    },
+    {
+        id: 'issueTreeOrchestration',
+        skillName: 'issue-orchestrator',
+        promptPath: '.codex-orchestrator/prompts/workflows/issue-tree-orchestration.md',
+    },
+];
+export function defaultSkillsRoot(env = process.env) {
+    return env.CODEX_HOME ? join(env.CODEX_HOME, 'skills') : join(homedir(), '.codex', 'skills');
+}
+export async function resolveWorkflowConfigs(skillsRoot) {
+    const entries = await Promise.all(workflowDefinitions.map(async (definition) => {
+        const skillPath = join(skillsRoot, definition.skillName, 'SKILL.md');
+        const exists = await pathExists(skillPath);
+        const config = exists
+            ? {
+                skillName: definition.skillName,
+                source: 'existing-skill',
+                skillPath,
+                promptPath: definition.promptPath,
+            }
+            : {
+                skillName: definition.skillName,
+                source: 'package-owned-prompt-fallback',
+                promptPath: definition.promptPath,
+            };
+        return [definition.id, config];
+    }));
+    return Object.fromEntries(entries);
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=workflows.js.map

package/dist/src/setup/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../../src/setup/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAUjC,MAAM,CAAC,MAAM,mBAAmB,GAAkC;IAChE,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,8CAA8C,EAAE;IAC9F;QACE,EAAE,EAAE,gBAAgB;QACpB,SAAS,EAAE,WAAW;QACtB,UAAU,EAAE,0DAA0D;KACvE;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,SAAS,EAAE,wBAAwB;QACnC,UAAU,EAAE,2DAA2D;KACxE;IACD,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,iDAAiD,EAAE;IACpG;QACE,EAAE,EAAE,sBAAsB;QAC1B,SAAS,EAAE,kBAAkB;QAC7B,UAAU,EAAE,gEAAgE;KAC7E;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,SAAS,EAAE,oBAAoB;QAC/B,UAAU,EAAE,mEAAmE;KAChF;CACO,CAAC;AAIX,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACpE,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAAkB;IAC7D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAmB,MAAM;YACnC,CAAC,CAAC;gBACE,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,MAAM,EAAE,gBAAgB;gBACxB,SAAS;gBACT,UAAU,EAAE,UAAU,CAAC,UAAU;aAClC;YACH,CAAC,CAAC;gBACE,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,MAAM,EAAE,+BAA+B;gBACvC,UAAU,EAAE,UAAU,CAAC,UAAU;aAClC,CAAC;QAEN,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,CAAU,CAAC;IAC1C,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAsB,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "codex-orchestrator",
+  "version": "0.1.0",
+  "description": "Reusable GitHub Issues runner for Codex.",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./config/schema": {
+      "types": "./dist/src/config/schema.d.ts",
+      "import": "./dist/src/config/schema.js"
+    }
+  },
+  "bin": {
+    "codex-orchestrator": "dist/src/cli.js"
+  },
+  "files": [
+    "dist/src",
+    "prompts",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SergiiMytakii/codex-orchestrator.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test \"dist/test/**/*.test.js\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/prompts/setup-skill.md

@@ -0,0 +1,11 @@
+# Codex Orchestrator Setup
+
+Use this prompt to help a maintainer install `codex-orchestrator` in a repository.
+
+1. Confirm the GitHub owner, repository name, and target repository path.
+2. Run `codex-orchestrator setup --target <path> --github-owner <owner> --github-repo <repo> --dry-run`.
+3. Review the generated config plan, label report, workflow sources, and checks.
+4. Run setup without `--dry-run` only after the maintainer agrees.
+5. Use `--prepare-labels` only when the maintainer wants missing GitHub labels created.
+6. Do not launch Codex implementation from setup.
+7. Do not commit, push, or open a pull request from setup.

package/prompts/workflows/breakdown-review.md

@@ -0,0 +1,4 @@
+# Breakdown Review Workflow Fallback
+
+Review child issues for scope control, dependencies, acceptance criteria, and orchestration risk.
+Return required fixes before implementation starts.

package/prompts/workflows/issue-breakdown.md

@@ -0,0 +1,4 @@
+# Issue Breakdown Workflow Fallback
+
+Break an approved PRD into independently reviewable implementation issues.
+Keep slices vertical, dependency-aware, and ready for agent execution.

package/prompts/workflows/issue-tree-orchestration.md

@@ -0,0 +1,4 @@
+# Issue Tree Orchestration Workflow Fallback
+
+Coordinate a parent issue tree through dependency-aware child waves.
+Do not start blocked issues or overlapping write scopes.

package/prompts/workflows/prd.md

@@ -0,0 +1,4 @@
+# PRD Workflow Fallback
+
+Turn the parent issue and repository context into a clear product requirements document.
+Record open questions instead of inventing product decisions.

package/prompts/workflows/scoped-implementation.md

@@ -0,0 +1,4 @@
+# Scoped Implementation Workflow Fallback
+
+Implement one scoped issue from GitHub context and repository instructions.
+Use tests where possible and report validation, skipped checks, and risks.

package/prompts/workflows/triage.md

@@ -0,0 +1,4 @@
+# Triage Workflow Fallback
+
+Classify issues for agent readiness, blockers, required validation, and human-in-the-loop needs.
+Do not mark underspecified work as ready.