@twelvehart/orcats 0.0.0-seed.0 → 0.2.3

package/dist/tools/linear.d.ts.map

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

package/dist/tools/process.d.ts

@@ -0,0 +1,40 @@
+import { type Result } from "neverthrow";
+import { type RuntimeError } from "../model/index.ts";
+export interface QuietProcResult {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number | null;
+    readonly durationMs: number;
+}
+export interface QuietProcOptions {
+    readonly cwd?: string;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+export interface VerificationCommand {
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly timeoutMs?: number;
+}
+export type VerificationCommandResult = {
+    readonly type: "success";
+    readonly command: string;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: 0;
+    readonly durationMs: number;
+} | {
+    readonly type: "failed";
+    readonly command: string;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number | null;
+    readonly durationMs: number;
+};
+export interface CommandTool {
+    run(command: VerificationCommand): Promise<VerificationCommandResult>;
+}
+export declare function runQuiet(command: string, args?: readonly string[], options?: QuietProcOptions): Promise<Result<QuietProcResult, RuntimeError>>;
+export declare function createCommandTool(defaultCwd?: string): CommandTool;
+//# sourceMappingURL=process.d.ts.map

package/dist/tools/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/tools/process.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,yBAAyB,GACjC;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEN,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACvE;AAED,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CA0DhD;AAED,wBAAgB,iBAAiB,CAAC,UAAU,SAAgB,GAAG,WAAW,CA6CzE"}

package/dist/tools/terminal.d.ts

@@ -0,0 +1,23 @@
+import type { OrcaEvent } from "../model/index.ts";
+import type { RunReporter } from "../run-output/index.ts";
+export interface TerminalTool {
+    emit(event: OrcaEvent): void;
+    lines(): readonly string[];
+    status(status: StatusBarState, options?: StatusBarOptions): string;
+}
+export interface StatusBarState {
+    readonly label: string;
+    readonly current: number;
+    readonly total: number;
+}
+export interface StatusBarOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly isTTY?: boolean;
+}
+export interface TerminalToolOptions {
+    readonly reporter?: RunReporter;
+}
+export declare function createTerminalTool(options?: TerminalToolOptions): TerminalTool;
+export declare function renderOrcaEvent(event: OrcaEvent): string;
+export declare function renderStatusBar(status: StatusBarState, options?: StatusBarOptions): string;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/tools/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/tools/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,KAAK,IAAI,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;CACpE;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CACjC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAwBlF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAiBxD;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAUR"}

package/package.json

@@ -1,14 +1,94 @@
 {
   "name": "@twelvehart/orcats",
-  "version": "0.0.0-seed.0",
-  "description": "Seed package for CI trusted publishing setup.",
-  "main": "index.js",
+  "version": "0.2.3",
+  "description": "TypeScript-native reimagining of Orca: deterministic coding-agent flows with author-time type feedback.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "Ahmad Ragab",
+  "homepage": "https://github.com/ASRagab/orca-ts#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ASRagab/orca-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ASRagab/orca-ts/issues"
+  },
+  "bin": {
+    "orcats": "bin/orcats"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "bin/orcats",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "src/**/*.ts",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./src/index.ts"
+    },
+    "./loop": {
+      "types": "./dist/loop/index.d.ts",
+      "default": "./src/loop/index.ts"
+    },
+    "./model": {
+      "types": "./dist/model/index.d.ts",
+      "default": "./src/model/index.ts"
+    },
+    "./testing": {
+      "types": "./dist/test-utils/index.d.ts",
+      "default": "./src/test-utils/index.ts"
+    },
+    "./package.json": {
+      "default": "./package.json"
+    }
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "bun build src/cli/main.ts --target bun --outfile dist/orcats",
+    "build:binary": "bun build src/cli/main.ts --compile --outfile dist/orcats",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:release": "bun run scripts/build-release-binaries.ts",
+    "lint": "bun run docs:site:prepare && eslint .",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "docs:site:dev": "cd website && bun run dev",
+    "docs:site:prepare": "cd website && bun install --frozen-lockfile && bunx astro sync",
+    "docs:site:build": "cd website && bun install --frozen-lockfile && bun run build",
+    "docs:site:preview": "cd website && bun run preview",
+    "docs:check": "bun run scripts/check-doc-links.ts",
+    "docs:symbols": "bun run scripts/check-doc-symbols.ts",
+    "docs:signatures": "bun run scripts/check-doc-signatures.ts",
+    "check:facade-gate": "bun run scripts/check-facade-gate.ts",
+    "test:integration:real": "ORCA_REAL_BACKEND_SMOKE=1 bun test tests/integration/real-backend-smoke.test.ts",
+    "validate:fixtures": "bun run scripts/validate-fixtures.ts && bun run scripts/validate-adr-matrix.ts",
+    "validate:release": "bun run scripts/validate-release.ts",
+    "validate:package": "bun run build:types && bun run scripts/validate-package-artifact.ts",
+    "smoke:package": "bun run scripts/smoke-package.ts",
+    "smoke:binary": "bun run scripts/smoke-binary.ts",
+    "verify": "bun run lint && bun run typecheck && bun test && bun run docs:site:build && bun run docs:check && bun run docs:symbols && bun run validate:fixtures && bun run validate:release && bun run build:types && bun run docs:signatures && bun run check:facade-gate && bun run smoke:binary"
+  },
+  "dependencies": {
+    "effect": "^3.21.2",
+    "neverthrow": "^8.2.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/bun": "^1.3.3",
+    "eslint": "^9.39.1",
+    "eslint-plugin-boundaries": "^6.0.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.4"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "type": "commonjs",
-  "private": false
+  "engines": {
+    "bun": ">=1.3.0"
+  }
 }

package/src/backends/acp-client.ts

@@ -0,0 +1,324 @@
+import { spawn } from "node:child_process";
+import { BoundedAsyncQueue } from "../conversation/index.ts";
+import { collectText, splitLines } from "./subprocess-run.ts";
+
+export type AcpId = number | string;
+
+export interface AcpErrorPayload {
+  readonly code: number;
+  readonly message: string;
+  readonly data?: unknown;
+}
+
+export interface AcpRequestMessage {
+  readonly jsonrpc: "2.0";
+  readonly id: AcpId;
+  readonly method: string;
+  readonly params?: unknown;
+}
+
+export interface AcpNotificationMessage {
+  readonly jsonrpc: "2.0";
+  readonly method: string;
+  readonly params?: unknown;
+}
+
+export interface AcpResponseMessage {
+  readonly jsonrpc: "2.0";
+  readonly id: AcpId;
+  readonly result?: unknown;
+  readonly error?: AcpErrorPayload;
+}
+
+export type AcpIncomingMessage = AcpRequestMessage | AcpNotificationMessage;
+
+export interface AcpProcess {
+  readonly stdout: AsyncIterable<string | Uint8Array>;
+  readonly stderr?: AsyncIterable<string | Uint8Array>;
+  readonly exit: Promise<number | null>;
+  write(data: string): void;
+  endStdin(): void;
+  kill(signal?: NodeJS.Signals): void;
+}
+
+export interface AcpSpawnOptions {
+  readonly cwd?: string;
+  readonly env?: NodeJS.ProcessEnv;
+}
+
+export type AcpProcessSpawner = (
+  command: string,
+  args: readonly string[],
+  options: AcpSpawnOptions
+) => AcpProcess;
+
+export type AcpRequestHandler = (message: AcpRequestMessage) => unknown;
+
+interface Deferred<T> {
+  readonly promise: Promise<T>;
+  resolve(value: T | PromiseLike<T>): void;
+  reject(reason?: unknown): void;
+}
+
+export interface AcpClientOptions {
+  readonly command: string;
+  readonly args?: readonly string[];
+  readonly cwd?: string;
+  readonly env?: NodeJS.ProcessEnv;
+  readonly capacity?: number;
+  readonly requestTimeoutMs?: number;
+  readonly spawnProcess?: AcpProcessSpawner;
+  readonly handleRequest?: AcpRequestHandler;
+  readonly onIncomingMessage?: () => void;
+}
+
+export class AcpClient {
+  readonly process: AcpProcess;
+  private readonly queue: BoundedAsyncQueue<AcpIncomingMessage>;
+  private readonly pending = new Map<
+    AcpId,
+    {
+      readonly resolve: (value: unknown) => void;
+      readonly reject: (reason: unknown) => void;
+      readonly timer: ReturnType<typeof setTimeout>;
+    }
+  >();
+  private readonly closedState: Deferred<void> = Promise.withResolvers();
+  private nextId = 0;
+  private closed = false;
+
+  readonly stderr: Promise<string>;
+  readonly done: Promise<void>;
+
+  constructor(private readonly options: AcpClientOptions) {
+    const spawnProcess = options.spawnProcess ?? spawnAcpProcess;
+    this.process = spawnProcess(options.command, options.args ?? [], {
+      ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+      ...(options.env === undefined ? {} : { env: options.env })
+    });
+    this.queue = new BoundedAsyncQueue(options.capacity ?? 256);
+    this.stderr = collectText(this.process.stderr);
+    this.done = this.closedState.promise;
+    queueMicrotask(() => {
+      void this.readLoop();
+    });
+  }
+
+  messages(): AsyncIterable<AcpIncomingMessage> {
+    return this.queue;
+  }
+
+  async request<T = unknown>(method: string, params: unknown = {}): Promise<T> {
+    if (this.closed) {
+      throw new Error("ACP client is closed");
+    }
+    const id = this.nextId;
+    this.nextId += 1;
+    const message: AcpRequestMessage = { jsonrpc: "2.0", id, method, params };
+    const timeoutMs = this.options.requestTimeoutMs ?? 30_000;
+    const response = new Promise<T>((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pending.delete(id);
+        reject(new Error(`ACP request ${method} timed out after ${String(timeoutMs)}ms`));
+      }, timeoutMs);
+      this.pending.set(id, {
+        resolve: (value) => {
+          resolve(value as T);
+        },
+        reject,
+        timer
+      });
+    });
+    this.write(message);
+    return await response;
+  }
+
+  notify(method: string, params: unknown = {}): void {
+    if (this.closed) {
+      return;
+    }
+    this.write({ jsonrpc: "2.0", method, params });
+  }
+
+  close(signal: NodeJS.Signals = "SIGTERM", force = false): void {
+    if (this.closed) {
+      if (force) {
+        this.process.kill(signal);
+      }
+      return;
+    }
+    this.closed = true;
+    this.process.endStdin();
+    this.process.kill(signal);
+    for (const entry of this.pending.values()) {
+      clearTimeout(entry.timer);
+      entry.reject(new Error("ACP client closed"));
+    }
+    this.pending.clear();
+  }
+
+  private async readLoop(): Promise<void> {
+    try {
+      for await (const line of splitLines(this.process.stdout)) {
+        if (line.trim().length === 0) {
+          continue;
+        }
+        await this.route(parseAcpMessage(line));
+      }
+      const exitCode = await this.process.exit;
+      if (!this.closed && exitCode !== 0) {
+        throw new Error(`ACP process exited with code ${String(exitCode ?? "unknown")}`);
+      }
+      this.finish();
+    } catch (error) {
+      this.fail(error);
+    }
+  }
+
+  private async route(message: AcpResponseMessage | AcpIncomingMessage): Promise<void> {
+    this.options.onIncomingMessage?.();
+    if (isResponse(message)) {
+      const entry = this.pending.get(message.id);
+      if (!entry) {
+        return;
+      }
+      clearTimeout(entry.timer);
+      this.pending.delete(message.id);
+      if (message.error) {
+        entry.reject(new Error(`${message.error.message} (${String(message.error.code)})`));
+        return;
+      }
+      entry.resolve(message.result);
+      return;
+    }
+
+    if (isRequest(message)) {
+      await this.respondToRequest(message);
+      return;
+    }
+
+    await this.queue.push(message);
+  }
+
+  private async respondToRequest(message: AcpRequestMessage): Promise<void> {
+    try {
+      const result = await this.options.handleRequest?.(message);
+      this.write({ jsonrpc: "2.0", id: message.id, result: result ?? {} });
+    } catch (error) {
+      this.write({
+        jsonrpc: "2.0",
+        id: message.id,
+        error: { code: -32000, message: errorMessage(error) }
+      });
+    }
+  }
+
+  private finish(): void {
+    if (this.closed) {
+      this.queue.close();
+      this.closedState.resolve();
+      return;
+    }
+    this.closed = true;
+    this.queue.close();
+    for (const entry of this.pending.values()) {
+      clearTimeout(entry.timer);
+      entry.reject(new Error("ACP process exited"));
+    }
+    this.pending.clear();
+    this.closedState.resolve();
+  }
+
+  private fail(error: unknown): void {
+    if (this.closed) {
+      this.queue.close();
+      this.closedState.reject(error);
+      return;
+    }
+    this.closed = true;
+    this.queue.close();
+    for (const entry of this.pending.values()) {
+      clearTimeout(entry.timer);
+      entry.reject(error);
+    }
+    this.pending.clear();
+    this.closedState.reject(error);
+  }
+
+  private write(message: AcpRequestMessage | AcpNotificationMessage | AcpResponseMessage): void {
+    this.process.write(`${JSON.stringify(message)}\n`);
+  }
+}
+
+export function createAcpClient(options: AcpClientOptions): AcpClient {
+  return new AcpClient(options);
+}
+
+export function spawnAcpProcess(
+  command: string,
+  args: readonly string[],
+  options: AcpSpawnOptions
+): AcpProcess {
+  const child = spawn(command, [...args], {
+    cwd: options.cwd,
+    env: options.env,
+    stdio: ["pipe", "pipe", "pipe"]
+  });
+
+  const exit = Promise.withResolvers<number | null>();
+  child.on("error", exit.reject);
+  child.on("close", exit.resolve);
+
+  return {
+    stdout: child.stdout,
+    stderr: child.stderr,
+    exit: exit.promise,
+    write(data: string) {
+      child.stdin.write(data);
+    },
+    endStdin() {
+      child.stdin.end();
+    },
+    kill(signal?: NodeJS.Signals) {
+      child.kill(signal);
+    }
+  };
+}
+
+function parseAcpMessage(line: string): AcpResponseMessage | AcpIncomingMessage {
+  let value: unknown;
+  try {
+    value = JSON.parse(line) as unknown;
+  } catch (error) {
+    throw new Error(`invalid ACP JSON-RPC message: ${errorMessage(error)}`);
+  }
+  if (!isObject(value) || value.jsonrpc !== "2.0") {
+    throw new Error("invalid ACP JSON-RPC message");
+  }
+  if ("method" in value && typeof value.method === "string") {
+    if ("id" in value) {
+      return value as unknown as AcpRequestMessage;
+    }
+    return value as unknown as AcpNotificationMessage;
+  }
+  if ("id" in value && ("result" in value || "error" in value)) {
+    return value as unknown as AcpResponseMessage;
+  }
+  throw new Error("invalid ACP JSON-RPC message");
+}
+
+function isResponse(message: AcpResponseMessage | AcpIncomingMessage): message is AcpResponseMessage {
+  return "id" in message && ("result" in message || "error" in message) && !("method" in message);
+}
+
+function isRequest(message: AcpResponseMessage | AcpIncomingMessage): message is AcpRequestMessage {
+  return "id" in message && "method" in message;
+}
+
+function isObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null;
+}
+
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}