feat: initialize standalone agent-workflow

src/index.ts

@@ -0,0 +1,152 @@
+/**
+ * agent-workflow — Codex-hosted autonomous implementation loop.
+ *
+ * Public API exports for programmatic use.
+ */
+
+export {
+  startWorkflow,
+  reviewWorkflow,
+  decideWorkflow,
+  statusWorkflow,
+  abortWorkflow,
+  retryReviewWorkflow,
+  retryExecuteWorkflow,
+  WorkflowEngineError,
+  emitWorkflowMeta,
+} from "./workflow-engine.js";
+
+export type {
+  StartWorkflowOpts,
+  ReviewWorkflowOpts,
+  DecideWorkflowOpts,
+  StatusWorkflowOpts,
+  AbortWorkflowOpts,
+  RetryReviewWorkflowOpts,
+  RetryExecuteWorkflowOpts,
+} from "./workflow-engine.js";
+
+export {
+  WorkflowConfigError,
+  loadProjectWorkflowConfig,
+  resolveWorkflowConfig,
+  validateWorkflowPlan,
+  validateHostDecision,
+} from "./workflow-config.js";
+
+export type {
+  WorkflowCliOverrides,
+} from "./workflow-config.js";
+
+export {
+  workflowsRoot,
+  repoHash,
+  runDir,
+  lockFilePath,
+  stateFilePath,
+  eventsFilePath,
+  cycleDiffFile,
+  cycleExecLogFile,
+  cycleHostReviewFile,
+  cycleDecisionFile,
+  generateRunId,
+  writeState,
+  readState,
+  appendEvent,
+  WorkflowLockError,
+  acquireLock,
+  releaseLock,
+  readLock,
+  GitError,
+  gitRepoRoot,
+  gitHead,
+  gitIsClean,
+  gitDiffFromHead,
+  checkFilesInScope,
+  nowIso,
+  initWorkflowState,
+  findRunDir,
+} from "./workflow-state.js";
+
+export {
+  checkConvergence,
+  decisionSignatures,
+} from "./workflow-convergence.js";
+
+export type {
+  FindingSignature,
+  ConvergenceCheckResult,
+} from "./workflow-convergence.js";
+
+export {
+  createExecutorAdapter,
+  probeExecutor,
+} from "./workflow-executor.js";
+
+export type {
+  ExecutorAdapter,
+  ExecutorResult,
+  ExecutorStartOpts,
+  ExecutorResumeOpts,
+} from "./workflow-types.js";
+
+export {
+  parseWorkflowArgs,
+  workflowUsage,
+} from "./workflow-args.js";
+
+export type {
+  WorkflowSubcommand,
+  WorkflowArgs,
+  WorkflowStartArgs,
+  WorkflowReviewArgs,
+  WorkflowRetryReviewArgs,
+  WorkflowRetryExecuteArgs,
+  WorkflowDecideArgs,
+  WorkflowStatusArgs,
+  WorkflowAbortArgs,
+} from "./workflow-args.js";
+
+export type {
+  WorkflowPlanV1,
+  WorkflowState,
+  WorkflowStatus,
+  WorkflowActiveStatus,
+  WorkflowTerminalStatus,
+  WorkflowStatusOutput,
+  HostDecisionV1,
+  HostDecisionOutcome,
+  FindingDecision,
+  HostReviewBundleV1,
+  WorkflowProjectConfig,
+  ResolvedWorkflowConfig,
+  ExecutorConfig,
+  ExecutorKind,
+  ExecutorSessionHandle,
+  ReasonixSessionHandle,
+  ClaudeSessionHandle,
+  AgySessionHandle,
+  CycleRecord,
+  ScopeViolation,
+  WorkflowEvent,
+  WorkflowEventKind,
+} from "./workflow-types.js";
+
+export {
+  EXECUTOR_KINDS,
+  WORKFLOW_STATUSES,
+  WORKFLOW_ACTIVE_STATUSES,
+  WORKFLOW_TERMINAL_STATUSES,
+  HOST_DECISION_OUTCOMES,
+} from "./workflow-types.js";
+
+export {
+  spawnBufferedChild,
+  spawnStreamingChild,
+  DEFAULT_STREAM_CAPTURE_LIMIT,
+  DEFAULT_ABORT_KILL_GRACE_MS,
+} from "./child-process.js";
+
+export type {
+  ChildRunResult,
+} from "./child-process.js";