@ccdd/project 2.0.1

package/dist/src/broker/graph.js

@@ -0,0 +1,94 @@
+import { isArtifactGroup, validateArtifactDefinitions } from '../artifacts/groups.js';
+const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const identifier = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
+const statuses = new Set(['BLOCKED', 'QUEUED', 'RUNNING', 'WAITING_HUMAN', 'GREEN', 'RED', 'ERROR']);
+/** Validate only the immutable graph metadata; no payloads, providers or workspace reads. */
+export function validateGraphDefinition(value) {
+    if (!object(value) || value.version !== 1 || !object(value.artifacts) || !Array.isArray(value.critics) || !value.critics.length || value.critics.length > 32)
+        throw new Error('Invalid Artifact graph definition.');
+    validateArtifactDefinitions(value.artifacts);
+    const artifacts = value.artifacts;
+    const seen = new Set();
+    const targets = new Set();
+    const adjacency = new Map(Object.keys(artifacts).map(id => [id, new Set()]));
+    for (const critic of value.critics) {
+        if (!object(critic) || typeof critic.id !== 'string' || !identifier.test(critic.id) || seen.has(critic.id) || typeof critic.title !== 'string' || !critic.title.trim() || typeof critic.target !== 'string' || !Object.hasOwn(artifacts, critic.target) || !Array.isArray(critic.deps) || new Set(critic.deps).size !== critic.deps.length || critic.deps.some(dep => typeof dep !== 'string' || !Object.hasOwn(artifacts, dep)) || !['agent', 'human', 'runtime'].includes(String(critic.kind)))
+            throw new Error('Critics require unique IDs, one known target, and unique known deps.');
+        if (critic.deps.includes(critic.target))
+            throw new Error(`Critic ${critic.id} cannot include its target in deps; target access is already provided.`);
+        seen.add(critic.id);
+        targets.add(critic.target);
+        for (const dep of critic.deps)
+            adjacency.get(dep).add(critic.target);
+    }
+    for (const id of targets)
+        if (artifacts[id].basis)
+            throw new Error(`Basis Artifact ${id} cannot also be a Critic target.`);
+    for (const critic of value.critics) {
+        for (const dep of critic.deps)
+            if (!targets.has(dep) && !artifacts[dep].basis)
+                throw new Error(`Dependency Artifact ${dep} has no Critic. Declare basis: true if it is an accepted review basis.`);
+    }
+    const visiting = new Set(), visited = new Set();
+    const visit = (id) => {
+        if (visiting.has(id))
+            throw new Error(`Artifact dependencies must form a DAG; cycle includes ${id}.`);
+        if (visited.has(id))
+            return;
+        visiting.add(id);
+        for (const next of adjacency.get(id))
+            visit(next);
+        visiting.delete(id);
+        visited.add(id);
+    };
+    for (const id of adjacency.keys())
+        visit(id);
+}
+export function createGraphDefinition(config) {
+    validateArtifactDefinitions(config.artifacts);
+    const graph = {
+        version: 1,
+        artifacts: Object.fromEntries(Object.entries(config.artifacts).map(([id, artifact]) => [id, { ...(isArtifactGroup(artifact) ? { kind: 'group', members: [...artifact.members] } : { type: artifact.type, path: artifact.path }), ...(artifact.basis === undefined ? {} : { basis: artifact.basis }), ...(artifact.stale ? { stale: structuredClone(artifact.stale) } : {}) }])),
+        critics: config.critics.map(critic => ({ id: critic.id, title: critic.title, target: critic.target, deps: [...critic.deps], kind: critic.profile.kind })),
+    };
+    validateGraphDefinition(graph);
+    return graph;
+}
+export function prerequisiteCriticIds(request, graph) {
+    return graph.critics.filter(critic => request.deps.includes(critic.target)).map(critic => critic.id);
+}
+/** Call with requests from exactly one Run. Missing evaluations never count as passing. */
+export function projectGraph(graph, requests) {
+    validateGraphDefinition(graph);
+    const byCritic = new Map();
+    for (const request of requests) {
+        if (!graph.critics.some(critic => critic.id === request.criticId) || byCritic.has(request.criticId) || !statuses.has(request.status))
+            throw new Error('Graph requests must be unique evaluations from one Run.');
+        byCritic.set(request.criticId, request);
+    }
+    const critics = graph.critics.map(critic => {
+        const request = byCritic.get(critic.id);
+        return { id: critic.id, title: critic.title, target: critic.target, deps: [...critic.deps], kind: critic.kind, requestId: request?.id ?? null, status: request?.status ?? null, claimedBy: request?.claimedBy ?? null, blockedReason: request?.blockedReason ?? null };
+    });
+    const artifacts = Object.entries(graph.artifacts).map(([id, artifact]) => {
+        const own = critics.filter(critic => critic.target === id), included = own.filter(critic => critic.requestId !== null).length;
+        const passed = own.filter(critic => critic.status === 'GREEN').length;
+        let status = artifact.basis ? 'BASIS' : 'UNREVIEWED';
+        if (own.length) {
+            if (passed === own.length)
+                status = 'GREEN';
+            else
+                status = ['ERROR', 'RED', 'RUNNING', 'WAITING_HUMAN', 'QUEUED', 'BLOCKED'].find(candidate => own.some(critic => critic.status === candidate)) ?? 'UNREVIEWED';
+        }
+        return { id, ...(isArtifactGroup(artifact) ? { kind: 'group', members: [...artifact.members] } : { type: artifact.type, path: artifact.path }), basis: artifact.basis === true, status, criticIds: own.map(critic => critic.id), passed, total: own.length, included };
+    });
+    const edges = new Map();
+    for (const critic of critics)
+        for (const source of critic.deps) {
+            const key = `${source}/${critic.target}`, edge = edges.get(key) ?? { source, target: critic.target, criticIds: [] };
+            edge.criticIds.push(critic.id);
+            edges.set(key, edge);
+        }
+    return { artifacts, critics, edges: [...edges.values()] };
+}
+//# sourceMappingURL=graph.js.map

package/dist/src/broker/graph.js.map

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

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

@@ -0,0 +1,170 @@
+import { type GraphDefinition } from './graph.js';
+import { prepareWorkspace, reopenWorkspace, type WorkspaceDescriptor, type WorkspaceMode } from '../workspaces/index.js';
+import type { ProjectRunDefinition, ProjectSelection } from '../project/types.js';
+import type { RunStatus } from '../contracts.js';
+import type { ReviewRequest, ReviewStatus, ExecutionContext, ExecutorReadiness } from '../contracts.js';
+export interface RunRecord {
+    id: string;
+    repoId: string;
+    snapshotHash: string;
+    workspace: WorkspaceDescriptor;
+    requesterId: string;
+    scope?: {
+        kind: 'graph';
+    } | {
+        kind: 'chain';
+    } | {
+        kind: 'critic';
+        criticId: string;
+    } | {
+        kind: 'project';
+    };
+    project?: ProjectRunDefinition;
+    graph?: GraphDefinition;
+    status: RunStatus;
+    createdAt: string;
+    completedAt?: string;
+    error?: string;
+}
+export interface BrokerEvent {
+    id: number;
+    runId: string;
+    requestId: string | null;
+    createdAt: string;
+    type: string;
+    message: string;
+    data?: unknown;
+}
+export interface RunView extends RunRecord {
+    scope: NonNullable<RunRecord['scope']>;
+    owner: {
+        pid: number;
+        claimedAt: string;
+    } | null;
+    requests: ReviewRequest[];
+    events: BrokerEvent[];
+}
+export interface BrokerExecutors {
+    validateWorkspace?(repoPath: string): void | Promise<void>;
+    canExecute(request: ReviewRequest): ExecutorReadiness | Promise<ExecutorReadiness>;
+    execute(request: ReviewRequest, context: ExecutionContext & {
+        signal: AbortSignal;
+    }): Promise<unknown>;
+    notifyHuman?(request: ReviewRequest, context: {
+        signal: AbortSignal;
+    }): Promise<unknown>;
+}
+export interface BrokerOptions {
+    repoPath: string;
+    stateDir: string;
+    repoId?: string;
+    executors?: BrokerExecutors;
+    workspaceAdapter?: {
+        prepareWorkspace: typeof prepareWorkspace;
+        reopenWorkspace: typeof reopenWorkspace;
+    };
+}
+/** Read an existing store's repository identity without creating state or needing its source. */
+export declare function readStateContext(stateDir: string): {
+    repoPath: string;
+    repoId: string;
+    stateDir: string;
+};
+/** Durable broker operations. Merely opening the store never starts a worker. */
+export declare function createBroker({ repoPath, stateDir, repoId, executors, workspaceAdapter }: BrokerOptions): {
+    submitProject({ mode, requesterId, selection, recursive, force }: {
+        mode?: WorkspaceMode;
+        requesterId?: string;
+        selection: ProjectSelection;
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<RunView>;
+    submit({ mode, requesterId, reviewRequests, criticId, snapshotCommit }?: {
+        mode?: WorkspaceMode;
+        requesterId?: unknown;
+        reviewRequests?: unknown;
+        criticId?: unknown;
+        snapshotCommit?: unknown;
+    }): Promise<RunView>;
+    run: (runId: string, { signal, onStarted }?: {
+        signal?: AbortSignal;
+        onStarted?: (value: {
+            runId: string;
+            pid: number;
+        }) => void;
+    }) => Promise<(RunRecord & {
+        requests: ReviewRequest[];
+    }) | null>;
+    reconcile: (runId?: string) => void;
+    listRuns(): {
+        id: string;
+        repoId: string;
+        snapshotHash: string;
+        workspace: WorkspaceDescriptor;
+        requesterId: string;
+        project?: ProjectRunDefinition;
+        graph?: GraphDefinition;
+        status: RunStatus;
+        createdAt: string;
+        completedAt?: string;
+        error?: string;
+        scope: NonNullable<RunRecord['scope']>;
+        owner: {
+            pid: number;
+            claimedAt: string;
+        } | null;
+        events: undefined;
+        requests: {
+            repoId: string;
+            snapshotHash: string;
+            criticId: string;
+            title: string;
+            artifacts: import("../contracts.js").ArtifactReference[];
+            artifactGroups?: import("../definitions.js").ArtifactGroupReference[];
+            artifactTypes: Record<string, import("../contracts.js").ArtifactTypeDefinition>;
+            configManifest?: import("../sdk.js").ConfigManifest;
+            payload: import("../definitions.js").ReviewPayload;
+            profile: import("../definitions.js").CriticProfile;
+            target: string;
+            deps: string[];
+            validationInput?: import("../project/types.js").ValidationInput;
+            id: string;
+            runId: string;
+            workspace: WorkspaceDescriptor;
+            worktreePath: string;
+            predecessorId?: string | null;
+            status: ReviewStatus;
+            createdAt: string;
+            startedAt?: string | null;
+            completedAt?: string | null;
+            claimedBy?: string | null;
+            claimedAt?: string | null;
+            notifiedAt?: string | null;
+            errorCode?: string | null;
+            blockedReason?: string | null;
+            error?: string | null;
+            result: {
+                verdict: "GREEN" | "RED";
+                summary: string;
+            } | null;
+        }[];
+    }[];
+    getRun: (id: string) => RunView | null;
+    getRequest(id: string): ReviewRequest | null;
+    claimHuman(requestId: string, reviewerId: unknown): ReviewRequest | null;
+    executeHumanTool(requestId: string, { reviewerId, toolName, arguments: args, signal }: {
+        reviewerId: unknown;
+        toolName: string;
+        arguments?: unknown;
+        signal?: AbortSignal;
+    }): Promise<any>;
+    completeHuman(requestId: string, { reviewerId, result }: {
+        reviewerId: unknown;
+        result: unknown;
+    }): Promise<ReviewRequest | null>;
+    failRun(runId: string, error: unknown): RunView | null;
+    cancel(runId: string): RunView | null;
+    onChange(callback: () => void): () => boolean;
+    close(): Promise<void>;
+};
+export type Broker = ReturnType<typeof createBroker>;