@renseiai/agentfactory 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rensei AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,125 @@
+# @renseiai/agentfactory
+
+Core orchestrator for multi-agent fleet management. Turns your issue backlog into shipped code by coordinating coding agents (Claude, Codex, Amp) through an automated pipeline.
+
+Part of the [AgentFactory](https://github.com/renseiai/agentfactory) monorepo.
+
+## Installation
+
+```bash
+npm install @renseiai/agentfactory @renseiai/agentfactory-linear
+```
+
+## Quick Start
+
+```typescript
+import { createOrchestrator } from '@renseiai/agentfactory'
+
+const orchestrator = createOrchestrator({
+  maxConcurrent: 3,
+  worktreePath: '.worktrees',
+})
+
+// Process a single issue
+await orchestrator.spawnAgentForIssue('PROJ-123')
+await orchestrator.waitForAll()
+
+// Check results
+for (const agent of orchestrator.getAgents()) {
+  console.log(`${agent.identifier}: ${agent.status}`)
+  if (agent.pullRequestUrl) console.log(`  PR: ${agent.pullRequestUrl}`)
+  if (agent.totalCostUsd) console.log(`  Cost: $${agent.totalCostUsd.toFixed(4)}`)
+}
+```
+
+## What It Does
+
+1. **Issue selection** — queries Linear for backlog issues, filters by project, selects by priority
+2. **Worktree creation** — creates isolated git worktrees per agent
+3. **Agent spawning** — delegates to providers (Claude, Codex, Amp)
+4. **Stream processing** — iterates `AgentEvent` from providers, emits activities to Linear
+5. **Crash recovery** — persists state to `.agent/` directory, resumes on restart
+6. **Inactivity timeout** — monitors idle agents and stops them
+
+## Provider Abstraction
+
+```typescript
+interface AgentProvider {
+  readonly name: 'claude' | 'codex' | 'amp'
+  spawn(config: AgentSpawnConfig): AgentHandle
+  resume(sessionId: string, config: AgentSpawnConfig): AgentHandle
+}
+
+interface AgentHandle {
+  sessionId: string | null
+  stream: AsyncIterable<AgentEvent>
+  injectMessage(text: string): Promise<void>
+  stop(): Promise<void>
+}
+```
+
+Provider resolution: `AGENT_PROVIDER_{WORKTYPE}` > `AGENT_PROVIDER_{PROJECT}` > `AGENT_PROVIDER` > `'claude'`
+
+## Configuration
+
+```typescript
+const orchestrator = createOrchestrator({
+  provider: myProvider,            // Agent provider instance
+  maxConcurrent: 3,                // Max concurrent agents
+  project: 'MyProject',           // Filter by project
+  worktreePath: '.worktrees',     // Git worktree base path
+  inactivityTimeoutMs: 300_000,   // 5 min idle timeout
+  maxSessionTimeoutMs: 7_200_000, // 2 hour hard cap
+  workTypeTimeouts: {
+    qa: { inactivityTimeoutMs: 600_000 },
+  },
+})
+```
+
+## Workflow Governor
+
+The core package includes the Workflow Governor — a central lifecycle manager that observes all issues and decides what work to dispatch.
+
+```typescript
+import {
+  WorkflowGovernor,
+  EventDrivenGovernor,
+  InMemoryEventBus,
+  InMemoryEventDeduplicator,
+  type GovernorDependencies,
+} from '@renseiai/agentfactory'
+
+// Poll-only mode (simple)
+const governor = new WorkflowGovernor(
+  { projects: ['MyProject'], scanIntervalMs: 60_000 },
+  myDependencies,
+)
+governor.start()
+
+// Event-driven mode (production)
+const eventGovernor = new EventDrivenGovernor(
+  {
+    projects: ['MyProject'],
+    eventBus: new InMemoryEventBus(),        // or RedisEventBus
+    deduplicator: new InMemoryEventDeduplicator(), // or RedisEventDeduplicator
+    pollIntervalMs: 300_000,                 // 5 min safety net
+  },
+  myDependencies,
+)
+await eventGovernor.start()
+```
+
+The governor evaluates each issue against status, active sessions, cooldowns, human overrides (HOLD/RESUME/PRIORITY), and workflow strategy to decide what action to take. See [Architecture docs](https://github.com/renseiai/agentfactory/blob/main/docs/architecture.md#workflow-governor) for details.
+
+## Related Packages
+
+| Package | Description |
+|---------|-------------|
+| [@renseiai/agentfactory-linear](https://www.npmjs.com/package/@renseiai/agentfactory-linear) | Linear issue tracker integration |
+| [@renseiai/agentfactory-server](https://www.npmjs.com/package/@renseiai/agentfactory-server) | Redis work queue, distributed workers |
+| [@renseiai/agentfactory-cli](https://www.npmjs.com/package/@renseiai/agentfactory-cli) | CLI tools |
+| [@renseiai/agentfactory-nextjs](https://www.npmjs.com/package/@renseiai/agentfactory-nextjs) | Next.js webhook server |
+
+## License
+
+MIT

package/dist/src/config/index.d.ts

@@ -0,0 +1,3 @@
+export { loadRepositoryConfig, RepositoryConfigSchema, getEffectiveAllowedProjects } from './repository-config.js';
+export type { RepositoryConfig } from './repository-config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AAClH,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/src/config/index.js

@@ -0,0 +1 @@
+export { loadRepositoryConfig, RepositoryConfigSchema, getEffectiveAllowedProjects } from './repository-config.js';

package/dist/src/config/repository-config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Repository Configuration
+ *
+ * Loads and validates the declarative .agentfactory/config.yaml file.
+ * This config controls repository-level settings such as:
+ * - Git remote validation (repository field)
+ * - Project allowlisting for the orchestrator (allowedProjects field)
+ */
+import { z } from 'zod';
+export declare const RepositoryConfigSchema: z.ZodObject<{
+    apiVersion: z.ZodString;
+    kind: z.ZodLiteral<"RepositoryConfig">;
+    repository: z.ZodOptional<z.ZodString>;
+    allowedProjects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    projectPaths: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    sharedPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    linearCli: z.ZodOptional<z.ZodString>;
+    packageManager: z.ZodOptional<z.ZodEnum<{
+        pnpm: "pnpm";
+        npm: "npm";
+        yarn: "yarn";
+        bun: "bun";
+        none: "none";
+    }>>;
+    buildCommand: z.ZodOptional<z.ZodString>;
+    testCommand: z.ZodOptional<z.ZodString>;
+    validateCommand: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RepositoryConfig = z.infer<typeof RepositoryConfigSchema>;
+/**
+ * Returns the effective list of allowed project names.
+ * When `projectPaths` is set, the keys are the allowed projects.
+ * Otherwise falls back to `allowedProjects`.
+ */
+export declare function getEffectiveAllowedProjects(config: RepositoryConfig): string[] | undefined;
+/**
+ * Load and validate .agentfactory/config.yaml from the given git root.
+ *
+ * @param gitRoot - The root directory of the git repository
+ * @returns The validated RepositoryConfig, or null if the file does not exist
+ * @throws {z.ZodError} If the file exists but fails schema validation
+ */
+export declare function loadRepositoryConfig(gitRoot: string): RepositoryConfig | null;
+//# sourceMappingURL=repository-config.d.ts.map

package/dist/src/config/repository-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-config.d.ts","sourceRoot":"","sources":["../../../src/config/repository-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AASvB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;iBA0ClC,CAAA;AAMD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAMrE;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,GAAG,SAAS,CAK1F;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQ7E"}

package/dist/src/config/repository-config.js

@@ -0,0 +1,88 @@
+/**
+ * Repository Configuration
+ *
+ * Loads and validates the declarative .agentfactory/config.yaml file.
+ * This config controls repository-level settings such as:
+ * - Git remote validation (repository field)
+ * - Project allowlisting for the orchestrator (allowedProjects field)
+ */
+import { z } from 'zod';
+import { readFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+import YAML from 'yaml';
+// ---------------------------------------------------------------------------
+// Zod Schema
+// ---------------------------------------------------------------------------
+export const RepositoryConfigSchema = z.object({
+    apiVersion: z.string(),
+    kind: z.literal('RepositoryConfig'),
+    repository: z.string().optional(),
+    allowedProjects: z.array(z.string()).optional(),
+    /** Maps Linear project names to their root directory within the repo (e.g., { Family: 'apps/family' }) */
+    projectPaths: z.record(z.string(), z.string()).optional(),
+    /** Shared directories that any project's agent may modify (e.g., ['packages/ui']) */
+    sharedPaths: z.array(z.string()).optional(),
+    /**
+     * Command to invoke the Linear CLI (default: "pnpm af-linear").
+     * For non-Node projects, set to a path or wrapper script, e.g.:
+     *   "npx -y @renseiai/agentfactory-cli af-linear"
+     *   "./tools/af-linear.sh"
+     *   "/usr/local/bin/af-linear"
+     */
+    linearCli: z.string().optional(),
+    /**
+     * Package manager used by the project (default: "pnpm").
+     * Set to "none" for non-Node projects (disables dependency linking and helper scripts).
+     * Supported values: "pnpm" | "npm" | "yarn" | "bun" | "none"
+     */
+    packageManager: z.enum(['pnpm', 'npm', 'yarn', 'bun', 'none']).optional(),
+    /**
+     * Build command override (e.g. 'cargo build', 'cmake --build build', 'make').
+     * Injected into workflow templates as {{buildCommand}}.
+     */
+    buildCommand: z.string().optional(),
+    /**
+     * Test command override (e.g. 'cargo test', 'ctest --test-dir build', 'make test').
+     * Injected into workflow templates as {{testCommand}}.
+     */
+    testCommand: z.string().optional(),
+    /**
+     * Validation command override — replaces typecheck for compiled projects
+     * (e.g. 'cargo clippy', 'go vet ./...').
+     * Injected into workflow templates as {{validateCommand}}.
+     */
+    validateCommand: z.string().optional(),
+}).refine((data) => !(data.allowedProjects && data.projectPaths), { message: 'allowedProjects and projectPaths are mutually exclusive — use one or the other' });
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns the effective list of allowed project names.
+ * When `projectPaths` is set, the keys are the allowed projects.
+ * Otherwise falls back to `allowedProjects`.
+ */
+export function getEffectiveAllowedProjects(config) {
+    if (config.projectPaths) {
+        return Object.keys(config.projectPaths);
+    }
+    return config.allowedProjects;
+}
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+/**
+ * Load and validate .agentfactory/config.yaml from the given git root.
+ *
+ * @param gitRoot - The root directory of the git repository
+ * @returns The validated RepositoryConfig, or null if the file does not exist
+ * @throws {z.ZodError} If the file exists but fails schema validation
+ */
+export function loadRepositoryConfig(gitRoot) {
+    const configPath = resolve(gitRoot, '.agentfactory', 'config.yaml');
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    const content = readFileSync(configPath, 'utf-8');
+    const parsed = YAML.parse(content);
+    return RepositoryConfigSchema.parse(parsed);
+}

package/dist/src/config/repository-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=repository-config.test.d.ts.map

package/dist/src/config/repository-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-config.test.d.ts","sourceRoot":"","sources":["../../../src/config/repository-config.test.ts"],"names":[],"mappings":""}

package/dist/src/config/repository-config.test.js

@@ -0,0 +1,249 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { existsSync, readFileSync } from 'fs';
+import { loadRepositoryConfig, RepositoryConfigSchema, getEffectiveAllowedProjects } from './repository-config.js';
+vi.mock('fs', () => ({
+    existsSync: vi.fn(),
+    readFileSync: vi.fn(),
+}));
+const mockExistsSync = vi.mocked(existsSync);
+const mockReadFileSync = vi.mocked(readFileSync);
+describe('loadRepositoryConfig', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('returns null when config file does not exist', () => {
+        mockExistsSync.mockReturnValue(false);
+        const result = loadRepositoryConfig('/some/repo');
+        expect(result).toBeNull();
+        expect(mockExistsSync).toHaveBeenCalledWith('/some/repo/.agentfactory/config.yaml');
+    });
+    it('parses valid YAML with all fields', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`apiVersion: v1
+kind: RepositoryConfig
+repository: github.com/renseiai/agentfactory
+allowedProjects:
+  - Agent
+  - Dashboard
+`);
+        const result = loadRepositoryConfig('/some/repo');
+        expect(result).toEqual({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            repository: 'github.com/renseiai/agentfactory',
+            allowedProjects: ['Agent', 'Dashboard'],
+        });
+    });
+    it('parses valid YAML with only required fields', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`apiVersion: v1
+kind: RepositoryConfig
+`);
+        const result = loadRepositoryConfig('/some/repo');
+        expect(result).toEqual({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+        });
+    });
+    it('throws on invalid schema — wrong kind', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`apiVersion: v1
+kind: WorkflowTemplate
+repository: github.com/renseiai/agentfactory
+`);
+        expect(() => loadRepositoryConfig('/some/repo')).toThrow();
+    });
+    it('throws on invalid schema — missing apiVersion', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`kind: RepositoryConfig
+repository: github.com/renseiai/agentfactory
+`);
+        expect(() => loadRepositoryConfig('/some/repo')).toThrow();
+    });
+    it('parses valid YAML with projectPaths and sharedPaths', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`apiVersion: v1
+kind: RepositoryConfig
+repository: github.com/renseiai/renseiai
+projectPaths:
+  Social: apps/social
+  Family: apps/family
+sharedPaths:
+  - packages/ui
+  - packages/lexical
+`);
+        const result = loadRepositoryConfig('/some/repo');
+        expect(result).toEqual({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            repository: 'github.com/renseiai/renseiai',
+            projectPaths: { Social: 'apps/social', Family: 'apps/family' },
+            sharedPaths: ['packages/ui', 'packages/lexical'],
+        });
+    });
+    it('throws on invalid schema — allowedProjects is not an array', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`apiVersion: v1
+kind: RepositoryConfig
+allowedProjects: NotAnArray
+`);
+        expect(() => loadRepositoryConfig('/some/repo')).toThrow();
+    });
+});
+describe('RepositoryConfigSchema', () => {
+    it('validates a complete config', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            repository: 'github.com/org/repo',
+            allowedProjects: ['ProjectA', 'ProjectB'],
+        });
+        expect(result.apiVersion).toBe('v1');
+        expect(result.kind).toBe('RepositoryConfig');
+        expect(result.repository).toBe('github.com/org/repo');
+        expect(result.allowedProjects).toEqual(['ProjectA', 'ProjectB']);
+    });
+    it('validates a minimal config with only required fields', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+        });
+        expect(result.apiVersion).toBe('v1');
+        expect(result.kind).toBe('RepositoryConfig');
+        expect(result.repository).toBeUndefined();
+        expect(result.allowedProjects).toBeUndefined();
+    });
+    it('rejects invalid kind', () => {
+        expect(() => RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'InvalidKind',
+        })).toThrow();
+    });
+    it('validates config with projectPaths only', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            repository: 'github.com/org/monorepo',
+            projectPaths: {
+                Social: 'apps/social',
+                Family: 'apps/family',
+            },
+        });
+        expect(result.projectPaths).toEqual({ Social: 'apps/social', Family: 'apps/family' });
+        expect(result.allowedProjects).toBeUndefined();
+    });
+    it('validates config with projectPaths and sharedPaths', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            projectPaths: {
+                Social: 'apps/social',
+                Family: 'apps/family',
+            },
+            sharedPaths: ['packages/ui', 'packages/lexical'],
+        });
+        expect(result.projectPaths).toEqual({ Social: 'apps/social', Family: 'apps/family' });
+        expect(result.sharedPaths).toEqual(['packages/ui', 'packages/lexical']);
+    });
+    it('rejects config with both allowedProjects and projectPaths', () => {
+        expect(() => RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            allowedProjects: ['Social'],
+            projectPaths: { Social: 'apps/social' },
+        })).toThrow(/mutually exclusive/);
+    });
+    it('validates config with build/test/validate commands', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            repository: 'github.com/org/native-project',
+            buildCommand: 'cargo build --release',
+            testCommand: 'cargo test',
+            validateCommand: 'cargo clippy -- -D warnings',
+        });
+        expect(result.buildCommand).toBe('cargo build --release');
+        expect(result.testCommand).toBe('cargo test');
+        expect(result.validateCommand).toBe('cargo clippy -- -D warnings');
+    });
+    it('allows omitting build/test/validate commands', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+        });
+        expect(result.buildCommand).toBeUndefined();
+        expect(result.testCommand).toBeUndefined();
+        expect(result.validateCommand).toBeUndefined();
+    });
+    it('validates config with build commands and non-Node settings', () => {
+        const result = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            packageManager: 'none',
+            linearCli: 'bash tools/af-linear.sh',
+            buildCommand: 'cmake --build build/',
+            testCommand: 'ctest --test-dir build/',
+        });
+        expect(result.packageManager).toBe('none');
+        expect(result.linearCli).toBe('bash tools/af-linear.sh');
+        expect(result.buildCommand).toBe('cmake --build build/');
+        expect(result.testCommand).toBe('ctest --test-dir build/');
+    });
+});
+describe('loadRepositoryConfig with build commands', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('parses config with build/test/validate commands', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(`apiVersion: v1
+kind: RepositoryConfig
+repository: github.com/org/native-project
+packageManager: none
+buildCommand: "cargo build --release"
+testCommand: "cargo test"
+validateCommand: "cargo clippy -- -D warnings"
+`);
+        const result = loadRepositoryConfig('/some/repo');
+        expect(result).toEqual({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            repository: 'github.com/org/native-project',
+            packageManager: 'none',
+            buildCommand: 'cargo build --release',
+            testCommand: 'cargo test',
+            validateCommand: 'cargo clippy -- -D warnings',
+        });
+    });
+});
+describe('getEffectiveAllowedProjects', () => {
+    it('returns keys from projectPaths when set', () => {
+        const config = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            projectPaths: { Social: 'apps/social', Family: 'apps/family' },
+        });
+        expect(getEffectiveAllowedProjects(config)).toEqual(['Social', 'Family']);
+    });
+    it('returns allowedProjects when projectPaths is not set', () => {
+        const config = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+            allowedProjects: ['Agent', 'Dashboard'],
+        });
+        expect(getEffectiveAllowedProjects(config)).toEqual(['Agent', 'Dashboard']);
+    });
+    it('returns undefined when neither is set', () => {
+        const config = RepositoryConfigSchema.parse({
+            apiVersion: 'v1',
+            kind: 'RepositoryConfig',
+        });
+        expect(getEffectiveAllowedProjects(config)).toBeUndefined();
+    });
+});

package/dist/src/deployment/deployment-checker.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Deployment Status Checker
+ *
+ * Queries GitHub commit status API for Vercel deployment state.
+ * Used to verify deployments before QA/acceptance work can proceed.
+ */
+/**
+ * Individual deployment status for a Vercel app
+ */
+export interface DeploymentStatus {
+    /** The app name (e.g., "renseiai-social") */
+    app: string;
+    /** Deployment state */
+    state: 'success' | 'pending' | 'error' | 'failure';
+    /** Status description (e.g., "Deployment has completed") */
+    description: string;
+    /** Vercel preview URL if available */
+    targetUrl: string | null;
+    /** Full context string from GitHub */
+    context: string;
+}
+/**
+ * Result of checking deployment status for a commit
+ */
+export interface DeploymentCheckResult {
+    /** Whether all deployments succeeded */
+    allSucceeded: boolean;
+    /** Whether any deployment failed */
+    anyFailed: boolean;
+    /** Whether any deployment is still pending */
+    anyPending: boolean;
+    /** Individual deployment statuses */
+    statuses: DeploymentStatus[];
+    /** The commit SHA that was checked */
+    commitSha: string;
+    /** Overall state from GitHub */
+    overallState: string;
+}
+/**
+ * Options for checking deployment status
+ */
+export interface DeploymentCheckOptions {
+    /** GitHub repository owner */
+    owner?: string;
+    /** GitHub repository name */
+    repo?: string;
+    /** Timeout for GitHub API call in milliseconds */
+    timeout?: number;
+}
+/**
+ * Get the PR number for the current branch using gh CLI
+ */
+export declare function getPRNumber(timeout?: number): Promise<number | null>;
+/**
+ * Get the head commit SHA for a PR
+ */
+export declare function getPRHeadSha(prNumber: number, options?: DeploymentCheckOptions): Promise<string | null>;
+/**
+ * Check deployment status for a specific commit SHA
+ */
+export declare function checkDeploymentStatus(commitSha: string, options?: DeploymentCheckOptions): Promise<DeploymentCheckResult>;
+/**
+ * Check deployment status for a PR number
+ * Convenience function that gets the commit SHA and checks status
+ */
+export declare function checkPRDeploymentStatus(prNumber: number, options?: DeploymentCheckOptions): Promise<DeploymentCheckResult | null>;
+/**
+ * Format deployment check result for display
+ */
+export declare function formatDeploymentStatus(result: DeploymentCheckResult): string;
+/**
+ * Format failed deployments for a comment
+ */
+export declare function formatFailedDeployments(result: DeploymentCheckResult): string;
+/**
+ * PR information found for an issue
+ */
+export interface IssuePRInfo {
+    /** PR number */
+    number: number;
+    /** Head commit SHA */
+    headSha: string;
+    /** Branch name */
+    branch: string;
+    /** PR title */
+    title: string;
+    /** PR URL */
+    url: string;
+}
+/**
+ * Find open PRs associated with a Linear issue identifier
+ * Searches for PRs with the issue identifier in the branch name or title
+ *
+ * @param issueIdentifier - The Linear issue identifier (e.g., "SUP-123")
+ * @param options - Options for the search
+ * @returns Array of matching PRs
+ */
+export declare function findPRsForIssue(issueIdentifier: string, options?: DeploymentCheckOptions): Promise<IssuePRInfo[]>;
+/**
+ * Check deployment status for an issue by finding associated PRs
+ * Returns the first PR's deployment status, or null if no PRs found
+ *
+ * @param issueIdentifier - The Linear issue identifier (e.g., "SUP-123")
+ * @param options - Options for the search and check
+ * @returns Deployment check result with PR info, or null if no PR found
+ */
+export declare function checkIssueDeploymentStatus(issueIdentifier: string, options?: DeploymentCheckOptions): Promise<(DeploymentCheckResult & {
+    pr: IssuePRInfo;
+}) | null>;
+//# sourceMappingURL=deployment-checker.d.ts.map

package/dist/src/deployment/deployment-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-checker.d.ts","sourceRoot":"","sources":["../../../src/deployment/deployment-checker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,uBAAuB;IACvB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IAClD,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAA;IACrB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAA;IAClB,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAA;IACnB,qCAAqC;IACrC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAyDD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWjF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CA+ChC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAMvC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAmD5E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAmB7E;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,aAAa;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,WAAW,EAAE,CAAC,CAsCxB;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,CAAC,qBAAqB,GAAG;IAAE,EAAE,EAAE,WAAW,CAAA;CAAE,CAAC,GAAG,IAAI,CAAC,CAe/D"}