@camilyos/codex-antigravity-kit 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,186 @@
+declare enum WorkflowState {
+    IDLE = "IDLE",
+    DISCOVERY = "DISCOVERY",
+    CLARIFICATION_REQUIRED = "CLARIFICATION_REQUIRED",
+    BRAINSTORMING = "BRAINSTORMING",
+    PLANNING = "PLANNING",
+    READY = "READY",
+    IMPLEMENTING = "IMPLEMENTING",
+    VERIFYING = "VERIFYING",
+    REVIEWING = "REVIEWING",
+    REPAIR_REQUIRED = "REPAIR_REQUIRED",
+    COMPLETED = "COMPLETED",
+    BLOCKED = "BLOCKED",
+    ESCALATION_REQUIRED = "ESCALATION_REQUIRED"
+}
+declare function canTransition(from: WorkflowState, to: WorkflowState): boolean;
+declare function transitionOrThrow(from: WorkflowState, to: WorkflowState): WorkflowState;
+
+type WorkerStatus = "DONE" | "BLOCKED" | "FAILED";
+interface ParsedWorkerResult {
+    status: WorkerStatus;
+    summary: string;
+}
+interface WorkerExecution {
+    ok: boolean;
+    timedOut: boolean;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+}
+interface WorkerRequest {
+    repoPath: string;
+    taskId: string;
+    prompt: string;
+    timeoutMs: number;
+}
+interface WorkerAdapter {
+    run(request: WorkerRequest): Promise<WorkerExecution>;
+}
+interface KitConfig {
+    agyCommand: string;
+    agyArgs: string[];
+    maxRepairAttempts: number;
+}
+interface WorkflowSnapshot {
+    state: WorkflowState;
+    currentPhase: string;
+    currentTask: string;
+    reviewAttempt: number;
+    repairAttempt: number;
+    nextAction: string;
+    blockingIssues: string[];
+    updatedAt: string;
+}
+
+interface ShellAgyAdapterOptions {
+    command: string;
+    baseArgs?: string[];
+}
+declare class ShellAgyAdapter implements WorkerAdapter {
+    private readonly command;
+    private readonly baseArgs;
+    constructor(options: ShellAgyAdapterOptions);
+    run(request: WorkerRequest): Promise<WorkerExecution>;
+}
+
+interface AgentDefinition {
+    id: string;
+    name: string;
+    agentFile: string;
+    skillFile: string;
+    description: string;
+    keywords: string[];
+    repoIndicators: string[];
+}
+declare const KNOWN_AGENTS: Record<string, AgentDefinition>;
+interface AgentResolution {
+    agent: AgentDefinition;
+    isExplicit: boolean;
+    confidence: number;
+    reason: string;
+    instructions: string;
+    skillInstructions: string;
+}
+interface DetectAgentOptions {
+    root: string;
+    content?: string;
+    explicitAgent?: string;
+}
+declare function detectAgent(options: DetectAgentOptions): AgentResolution;
+
+declare class RepairLoop {
+    private readonly maxAttempts;
+    constructor(maxAttempts: number);
+    canRetry(currentAttempt: number): boolean;
+    nextAttempt(currentAttempt: number): number;
+    needsEscalation(currentAttempt: number): boolean;
+}
+
+declare function parseWorkerResult(raw: string): ParsedWorkerResult;
+
+interface BrainstormOptions {
+    root: string;
+    task: string;
+    spec?: string;
+    prompt?: string;
+    agent?: string;
+}
+declare function runBrainstorm(options: BrainstormOptions): void;
+
+interface PlanOptions {
+    root: string;
+    task: string;
+    spec?: string;
+    agent?: string;
+}
+declare function runPlan(options: PlanOptions): void;
+
+interface ExecuteOptions {
+    root: string;
+    task: string;
+    plan?: string;
+    file?: string;
+    spec?: string;
+    agent?: string;
+    repairRequest?: string;
+    timeoutMs?: number;
+}
+declare function runExecute(options: ExecuteOptions): Promise<void>;
+declare function runExecuteWithAdapter(options: ExecuteOptions, adapter: WorkerAdapter): Promise<void>;
+
+interface DelegateOptions {
+    root: string;
+    task: string;
+    spec: string;
+    timeoutMs: number;
+    repairRequest?: string;
+}
+declare function runDelegate(options: DelegateOptions): Promise<void>;
+declare function runDelegateWithAdapter(options: DelegateOptions, adapter: WorkerAdapter): Promise<void>;
+
+interface DoctorOptions {
+    root: string;
+}
+declare function runDoctor(options: DoctorOptions): void;
+
+interface InitOptions {
+    root: string;
+    force: boolean;
+}
+declare function runInit(options: InitOptions): void;
+
+interface ReviewOptions {
+    root: string;
+    task: string;
+    outcome: "PASS" | "FAIL" | "BLOCKED";
+    reviewFile?: string;
+}
+declare function runReview(options: ReviewOptions): void;
+
+interface StatusOptions {
+    root: string;
+}
+declare function runStatus(options: StatusOptions): void;
+
+declare class WorkflowStore {
+    readonly root: string;
+    readonly workflowDir: string;
+    readonly tasksDir: string;
+    readonly statePath: string;
+    readonly configPath: string;
+    constructor(root: string);
+    ensureBaseStructure(): void;
+    ensureTask(taskId: string): string;
+    writeTaskFile(taskId: string, fileName: string, content: string): string;
+    readTaskFile(taskId: string, fileName: string): string;
+    hasTaskFile(taskId: string, fileName: string): boolean;
+    writeConfig(config: KitConfig): void;
+    readConfig(): KitConfig;
+    writeState(snapshot: WorkflowSnapshot): void;
+    readState(): WorkflowSnapshot;
+}
+declare function defaultState(): WorkflowSnapshot;
+
+export { type AgentDefinition, type AgentResolution, type BrainstormOptions, type DetectAgentOptions, type ExecuteOptions, KNOWN_AGENTS, type KitConfig, type ParsedWorkerResult, type PlanOptions, RepairLoop, ShellAgyAdapter, type ShellAgyAdapterOptions, type WorkerAdapter, type WorkerExecution, type WorkerRequest, type WorkerStatus, type WorkflowSnapshot, WorkflowState, WorkflowStore, canTransition, defaultState, detectAgent, parseWorkerResult, runBrainstorm, runDelegate, runDelegateWithAdapter, runDoctor, runExecute, runExecuteWithAdapter, runInit, runPlan, runReview, runStatus, transitionOrThrow };

package/dist/index.d.ts

@@ -0,0 +1,186 @@
+declare enum WorkflowState {
+    IDLE = "IDLE",
+    DISCOVERY = "DISCOVERY",
+    CLARIFICATION_REQUIRED = "CLARIFICATION_REQUIRED",
+    BRAINSTORMING = "BRAINSTORMING",
+    PLANNING = "PLANNING",
+    READY = "READY",
+    IMPLEMENTING = "IMPLEMENTING",
+    VERIFYING = "VERIFYING",
+    REVIEWING = "REVIEWING",
+    REPAIR_REQUIRED = "REPAIR_REQUIRED",
+    COMPLETED = "COMPLETED",
+    BLOCKED = "BLOCKED",
+    ESCALATION_REQUIRED = "ESCALATION_REQUIRED"
+}
+declare function canTransition(from: WorkflowState, to: WorkflowState): boolean;
+declare function transitionOrThrow(from: WorkflowState, to: WorkflowState): WorkflowState;
+
+type WorkerStatus = "DONE" | "BLOCKED" | "FAILED";
+interface ParsedWorkerResult {
+    status: WorkerStatus;
+    summary: string;
+}
+interface WorkerExecution {
+    ok: boolean;
+    timedOut: boolean;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+}
+interface WorkerRequest {
+    repoPath: string;
+    taskId: string;
+    prompt: string;
+    timeoutMs: number;
+}
+interface WorkerAdapter {
+    run(request: WorkerRequest): Promise<WorkerExecution>;
+}
+interface KitConfig {
+    agyCommand: string;
+    agyArgs: string[];
+    maxRepairAttempts: number;
+}
+interface WorkflowSnapshot {
+    state: WorkflowState;
+    currentPhase: string;
+    currentTask: string;
+    reviewAttempt: number;
+    repairAttempt: number;
+    nextAction: string;
+    blockingIssues: string[];
+    updatedAt: string;
+}
+
+interface ShellAgyAdapterOptions {
+    command: string;
+    baseArgs?: string[];
+}
+declare class ShellAgyAdapter implements WorkerAdapter {
+    private readonly command;
+    private readonly baseArgs;
+    constructor(options: ShellAgyAdapterOptions);
+    run(request: WorkerRequest): Promise<WorkerExecution>;
+}
+
+interface AgentDefinition {
+    id: string;
+    name: string;
+    agentFile: string;
+    skillFile: string;
+    description: string;
+    keywords: string[];
+    repoIndicators: string[];
+}
+declare const KNOWN_AGENTS: Record<string, AgentDefinition>;
+interface AgentResolution {
+    agent: AgentDefinition;
+    isExplicit: boolean;
+    confidence: number;
+    reason: string;
+    instructions: string;
+    skillInstructions: string;
+}
+interface DetectAgentOptions {
+    root: string;
+    content?: string;
+    explicitAgent?: string;
+}
+declare function detectAgent(options: DetectAgentOptions): AgentResolution;
+
+declare class RepairLoop {
+    private readonly maxAttempts;
+    constructor(maxAttempts: number);
+    canRetry(currentAttempt: number): boolean;
+    nextAttempt(currentAttempt: number): number;
+    needsEscalation(currentAttempt: number): boolean;
+}
+
+declare function parseWorkerResult(raw: string): ParsedWorkerResult;
+
+interface BrainstormOptions {
+    root: string;
+    task: string;
+    spec?: string;
+    prompt?: string;
+    agent?: string;
+}
+declare function runBrainstorm(options: BrainstormOptions): void;
+
+interface PlanOptions {
+    root: string;
+    task: string;
+    spec?: string;
+    agent?: string;
+}
+declare function runPlan(options: PlanOptions): void;
+
+interface ExecuteOptions {
+    root: string;
+    task: string;
+    plan?: string;
+    file?: string;
+    spec?: string;
+    agent?: string;
+    repairRequest?: string;
+    timeoutMs?: number;
+}
+declare function runExecute(options: ExecuteOptions): Promise<void>;
+declare function runExecuteWithAdapter(options: ExecuteOptions, adapter: WorkerAdapter): Promise<void>;
+
+interface DelegateOptions {
+    root: string;
+    task: string;
+    spec: string;
+    timeoutMs: number;
+    repairRequest?: string;
+}
+declare function runDelegate(options: DelegateOptions): Promise<void>;
+declare function runDelegateWithAdapter(options: DelegateOptions, adapter: WorkerAdapter): Promise<void>;
+
+interface DoctorOptions {
+    root: string;
+}
+declare function runDoctor(options: DoctorOptions): void;
+
+interface InitOptions {
+    root: string;
+    force: boolean;
+}
+declare function runInit(options: InitOptions): void;
+
+interface ReviewOptions {
+    root: string;
+    task: string;
+    outcome: "PASS" | "FAIL" | "BLOCKED";
+    reviewFile?: string;
+}
+declare function runReview(options: ReviewOptions): void;
+
+interface StatusOptions {
+    root: string;
+}
+declare function runStatus(options: StatusOptions): void;
+
+declare class WorkflowStore {
+    readonly root: string;
+    readonly workflowDir: string;
+    readonly tasksDir: string;
+    readonly statePath: string;
+    readonly configPath: string;
+    constructor(root: string);
+    ensureBaseStructure(): void;
+    ensureTask(taskId: string): string;
+    writeTaskFile(taskId: string, fileName: string, content: string): string;
+    readTaskFile(taskId: string, fileName: string): string;
+    hasTaskFile(taskId: string, fileName: string): boolean;
+    writeConfig(config: KitConfig): void;
+    readConfig(): KitConfig;
+    writeState(snapshot: WorkflowSnapshot): void;
+    readState(): WorkflowSnapshot;
+}
+declare function defaultState(): WorkflowSnapshot;
+
+export { type AgentDefinition, type AgentResolution, type BrainstormOptions, type DetectAgentOptions, type ExecuteOptions, KNOWN_AGENTS, type KitConfig, type ParsedWorkerResult, type PlanOptions, RepairLoop, ShellAgyAdapter, type ShellAgyAdapterOptions, type WorkerAdapter, type WorkerExecution, type WorkerRequest, type WorkerStatus, type WorkflowSnapshot, WorkflowState, WorkflowStore, canTransition, defaultState, detectAgent, parseWorkerResult, runBrainstorm, runDelegate, runDelegateWithAdapter, runDoctor, runExecute, runExecuteWithAdapter, runInit, runPlan, runReview, runStatus, transitionOrThrow };

package/dist/index.js

@@ -0,0 +1,44 @@
+import {
+  KNOWN_AGENTS,
+  RepairLoop,
+  ShellAgyAdapter,
+  WorkflowState,
+  WorkflowStore,
+  canTransition,
+  defaultState,
+  detectAgent,
+  parseWorkerResult,
+  runBrainstorm,
+  runDelegate,
+  runDelegateWithAdapter,
+  runDoctor,
+  runExecute,
+  runExecuteWithAdapter,
+  runInit,
+  runPlan,
+  runReview,
+  runStatus,
+  transitionOrThrow
+} from "./chunk-URIBUKLX.js";
+export {
+  KNOWN_AGENTS,
+  RepairLoop,
+  ShellAgyAdapter,
+  WorkflowState,
+  WorkflowStore,
+  canTransition,
+  defaultState,
+  detectAgent,
+  parseWorkerResult,
+  runBrainstorm,
+  runDelegate,
+  runDelegateWithAdapter,
+  runDoctor,
+  runExecute,
+  runExecuteWithAdapter,
+  runInit,
+  runPlan,
+  runReview,
+  runStatus,
+  transitionOrThrow
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@camilyos/codex-antigravity-kit",
+  "version": "0.1.0",
+  "description": "Codex brain + Antigravity worker orchestration kit with deterministic file-state workflow",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "bin": {
+    "codex-antigravity-kit": "dist/cli.cjs"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "AGENTS.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean --out-dir dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "codex",
+    "antigravity",
+    "orchestration",
+    "agent",
+    "workflow",
+    "cli"
+  ],
+  "author": "camilyos",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "commander": "^15.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.7.3",
+    "vitest": "^4.1.11"
+  }
+}