@ccdd/project 2.0.1

package/dist/src/artifacts/tool-check.d.ts

@@ -0,0 +1,40 @@
+import { type WorkspaceMode } from '../workspaces/index.js';
+import type { HumanToolResult } from './human.js';
+import { type ReviewToolDefinition } from '../tools/runner.js';
+import type { ToolResult } from '../tools/contracts.js';
+import { type ArtifactAudience } from './types.js';
+export interface ArtifactToolCheck {
+    artifactId?: string;
+    audience?: ArtifactAudience;
+    toolName?: string;
+    ok: boolean;
+    message: string;
+    code?: string;
+}
+export interface ArtifactToolCheckReport {
+    ok: boolean;
+    status: 'READY' | 'NOT_READY';
+    mode: WorkspaceMode;
+    checkedAt: string;
+    snapshotHash?: string;
+    workspacePath?: string;
+    checks: ArtifactToolCheck[];
+    tools: Array<ReviewToolDefinition & {
+        audience: ArtifactAudience;
+    }>;
+    result?: HumanToolResult | ToolResult;
+}
+export interface DiagnoseArtifactToolsOptions {
+    repoPath: string;
+    repoId?: string;
+    mode?: WorkspaceMode;
+    stateDir?: string;
+    artifactId?: string;
+    audience?: ArtifactAudience;
+    toolName?: string;
+    arguments?: unknown;
+    execute?: boolean;
+    signal?: AbortSignal;
+}
+/** Diagnose registered tools without creating a Broker, Run, request, alarm, Agent session or verdict. */
+export declare function diagnoseArtifactTools({ repoPath, mode, stateDir, artifactId, audience, toolName, arguments: args, execute, signal }: DiagnoseArtifactToolsOptions): Promise<ArtifactToolCheckReport>;

package/dist/src/artifacts/tool-check.js

@@ -0,0 +1,113 @@
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { localContext } from '../local.js';
+import { readWorkspaceConfig } from '../broker/config.js';
+import { prepareWorkspace } from '../workspaces/index.js';
+import { createReviewTools } from '../tools/runner.js';
+import { assertArtifactAudience } from './types.js';
+import { isArtifactGroup, resolveArtifactScope } from './groups.js';
+function safeFailure(error, aborted) {
+    const code = error && typeof error === 'object' && 'code' in error ? error.code : undefined;
+    if (aborted || code === 'ABORTED')
+        return { code: 'ABORTED', message: 'Artifact tool diagnosis was cancelled.' };
+    if (code === 'WORKSPACE_CHANGED' || code === 'WORKSPACE_CACHE_TAMPERED')
+        return { code, message: 'The workspace changed during Artifact tool diagnosis.' };
+    if (code === 'ARTIFACT_TOOLS_UNAVAILABLE')
+        return { code, message: 'A Critic references an Artifact with no tools for its reviewer kind. Register the corresponding agentTools or humanTools.' };
+    if (code === 'HUMAN_TOOL_TIMEOUT')
+        return { code, message: 'The registered Human tool exceeded its configured time limit.' };
+    if (code === 'HUMAN_TOOL_UNAVAILABLE')
+        return { code, message: 'The registered Human tool executable is unavailable.' };
+    if (code === 'HUMAN_TOOL_FAILED')
+        return { code, message: 'The registered Human tool did not finish successfully.' };
+    return { code: 'ARTIFACT_TOOL_CHECK_FAILED', message: 'Artifact tool diagnosis failed. Check the configuration, selected tool, scoped arguments and workspace access.' };
+}
+/** Diagnose registered tools without creating a Broker, Run, request, alarm, Agent session or verdict. */
+export async function diagnoseArtifactTools({ repoPath, mode = 'copy', stateDir, artifactId, audience, toolName, arguments: args, execute = false, signal }) {
+    const report = { ok: false, status: 'NOT_READY', mode, checkedAt: new Date().toISOString(), checks: [], tools: [] };
+    let workspace;
+    try {
+        if ((audience !== undefined && audience !== 'agent' && audience !== 'human') || (execute && (!artifactId || !audience || !toolName)) || (!execute && args !== undefined))
+            throw new Error('Actual tool execution requires explicit Artifact, audience and tool selection.');
+        signal?.throwIfAborted();
+        const context = await localContext({ repoPath, stateDir });
+        workspace = await prepareWorkspace({ repoPath: context.repoPath, stateDir: context.stateDir, mode, signal });
+        const worktreePath = workspace.descriptor.path;
+        report.snapshotHash = workspace.descriptor.hash;
+        // Cached copies are retained: a desktop viewer can continue reading after its launcher exits.
+        report.workspacePath = worktreePath;
+        const { config } = await readWorkspaceConfig(worktreePath);
+        const { configManifest } = config;
+        if (artifactId !== undefined && !Object.hasOwn(config.artifacts, artifactId))
+            throw new Error('Unknown selected Artifact.');
+        if (execute && artifactId !== undefined && isArtifactGroup(config.artifacts[artifactId])) {
+            report.checks.push({ artifactId, ok: false, message: 'Groups collect member tools. Select a leaf Artifact with --artifact to execute its tool.' });
+            return report;
+        }
+        const selectedScope = resolveArtifactScope(config.artifacts, artifactId === undefined ? Object.keys(config.artifacts) : [artifactId]);
+        const selected = selectedScope.artifacts;
+        if (!selected.length)
+            throw new Error('Unknown selected Artifact.');
+        if (!artifactId && !audience && !toolName) {
+            for (const critic of config.critics) {
+                try {
+                    assertArtifactAudience({ profile: critic.profile, ...resolveArtifactScope(config.artifacts, [critic.target, ...critic.deps]), artifactTypes: config.artifactTypes, configManifest });
+                }
+                catch (error) {
+                    report.checks.push({ ok: false, ...safeFailure(error, false) });
+                }
+            }
+        }
+        for (const targetAudience of audience ? [audience] : ['agent', 'human']) {
+            const registry = await createReviewTools({ worktreePath, ...selectedScope, artifactTypes: config.artifactTypes, configManifest, audience: targetAudience, runDir: join(context.stateDir, 'tool-check', randomUUID()), signal: workspace.signal });
+            try {
+                // Explicit Artifact selection makes the short operation name unambiguous; published names win.
+                const resolvedToolName = toolName === undefined || registry.tools.some(tool => tool.name === toolName) || artifactId === undefined ? toolName : `${toolName}_${artifactId}`;
+                const definitions = registry.tools.filter(tool => resolvedToolName === undefined || tool.name === resolvedToolName);
+                if (toolName !== undefined && !definitions.length) {
+                    report.checks.push({ artifactId, audience: targetAudience, toolName, ok: false, message: 'The selected tool is not registered for this Artifact and reviewer kind.' });
+                    continue;
+                }
+                report.tools.push(...definitions.map(tool => ({ ...tool, audience: targetAudience })));
+                for (const artifact of selected) {
+                    if (definitions.some(tool => tool.artifactId === artifact.id))
+                        continue;
+                    const required = audience !== undefined || config.critics.some(critic => critic.profile.kind === targetAudience && resolveArtifactScope(config.artifacts, [critic.target, ...critic.deps]).artifacts.some(leaf => leaf.id === artifact.id));
+                    report.checks.push({ artifactId: artifact.id, audience: targetAudience, ok: !required, message: `No ${targetAudience} tools are available for this Artifact. It cannot be used by a ${targetAudience} Critic.` });
+                }
+                report.checks.push(...(await registry.preflight({ toolName: resolvedToolName })).map(check => ({ ...check, audience: targetAudience })));
+                if (execute && targetAudience === audience && definitions.length === 1 && report.checks.every(check => check.ok)) {
+                    await workspace.assertUnchanged();
+                    const result = await registry.call(definitions[0].name, args ?? {});
+                    await workspace.assertUnchanged();
+                    report.result = result;
+                    report.checks.push({ artifactId, audience, toolName: definitions[0].name, ok: true, message: 'The selected registered tool completed successfully. No review result was created.' });
+                }
+            }
+            finally {
+                await registry.close();
+            }
+        }
+        await workspace.assertUnchanged();
+    }
+    catch (error) {
+        delete report.result;
+        // A mutated workspace can abort a running program before its boundary check resumes.
+        // Preserve that integrity failure instead of relabeling it as an ordinary cancellation.
+        const reason = workspace?.signal.aborted && !signal?.aborted ? workspace.signal.reason : error;
+        report.checks.push({ artifactId, audience, toolName, ok: false, ...safeFailure(reason, signal?.aborted ?? false) });
+    }
+    finally {
+        try {
+            await workspace?.close();
+        }
+        catch {
+            report.checks.push({ ok: false, code: 'WORKSPACE_CLEANUP_FAILED', message: 'Could not finish workspace observation cleanup.' });
+        }
+        report.ok = report.checks.length > 0 && report.checks.every(check => check.ok);
+        report.status = report.ok ? 'READY' : 'NOT_READY';
+        report.checkedAt = new Date().toISOString();
+    }
+    return report;
+}
+//# sourceMappingURL=tool-check.js.map

package/dist/src/artifacts/tool-check.js.map

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

package/dist/src/artifacts/types.d.ts

@@ -0,0 +1,43 @@
+import type { ConfigManifest } from '../tools/contracts.js';
+export type ArtifactOperation = 'read' | 'list';
+export type ArtifactViewerKind = 'text' | 'files';
+export type ArtifactAudience = 'agent' | 'human';
+export interface BuiltinArtifactTool {
+    description?: string;
+}
+export interface HumanCommandTool {
+    description: string;
+    command: string;
+    args: string[];
+    timeoutMs?: number;
+}
+export type HumanArtifactToolConfig = BuiltinArtifactTool | HumanCommandTool;
+export interface ArtifactTypeDefinition {
+    viewer?: ArtifactViewerKind;
+    /** Serialized marker for a type whose tools are in the recorded TS manifest. */
+    custom?: true;
+    tools?: Partial<Record<ArtifactOperation, {
+        description: string;
+    }>>;
+    agentTools?: Partial<Record<ArtifactOperation, BuiltinArtifactTool>>;
+    humanTools?: Record<string, HumanArtifactToolConfig>;
+}
+export declare function validateArtifactType(typeName: unknown, definition: unknown): ArtifactTypeDefinition;
+/** Legacy defaults are available only if neither audience was explicitly declared. */
+export declare function artifactAudienceTools(typeDefinition: ArtifactTypeDefinition, audience: ArtifactAudience, { allowLegacy }?: {
+    allowLegacy?: boolean;
+}): Record<string, HumanArtifactToolConfig>;
+export declare function assertArtifactAudience(request: {
+    profile: {
+        kind: string;
+    };
+    artifacts: readonly {
+        id: string;
+        type: string;
+    }[];
+    artifactTypes: Readonly<Record<string, unknown>>;
+    configManifest?: ConfigManifest;
+}, { allowLegacy }?: {
+    allowLegacy?: boolean;
+}): void;
+export declare function toolDescription(typeDefinition: unknown, toolName: string, artifactName: unknown, audience?: ArtifactAudience): string;

package/dist/src/artifacts/types.js

@@ -0,0 +1,97 @@
+const identifier = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
+const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const operations = { text: ['read'], files: ['list', 'read'] };
+const defaults = {
+    read: 'Read text from {artifactName} using 1-based line ranges.',
+    list: 'List files within {artifactName}.',
+};
+export function validateArtifactType(typeName, definition) {
+    if (typeof typeName === 'string' && identifier.test(typeName) && object(definition) && definition.custom === true && Object.keys(definition).length === 1)
+        return { custom: true };
+    if (typeof typeName !== 'string' || !identifier.test(typeName) || !object(definition) ||
+        (definition.viewer !== 'text' && definition.viewer !== 'files')) {
+        throw new Error(`Invalid artifact type/viewer: ${String(typeName)}`);
+    }
+    for (const key of Object.keys(definition)) {
+        if (!['viewer', 'tools', 'agentTools', 'humanTools'].includes(key))
+            throw new Error(`Unknown artifact type field: ${typeName}.${key}`);
+    }
+    for (const audience of ['tools', 'agentTools', 'humanTools']) {
+        if (!Object.hasOwn(definition, audience))
+            continue;
+        const configured = definition[audience];
+        if (!object(configured))
+            throw new Error(`Artifact type ${audience} must be an object: ${typeName}`);
+        if (Object.keys(configured).length > 32)
+            throw new Error(`Too many artifact tools: ${typeName}.${audience}`);
+        for (const [operation, tool] of Object.entries(configured)) {
+            if (!identifier.test(operation) || !object(tool))
+                throw new Error(`Invalid artifact tool: ${typeName}.${operation}`);
+            const builtin = operation === 'read' || operation === 'list';
+            if (builtin && !operations[definition.viewer].includes(operation)) {
+                throw new Error(`Unsupported artifact tool for ${definition.viewer} viewer: ${typeName}.${operation}`);
+            }
+            if (!builtin && (audience !== 'humanTools' || !Object.hasOwn(tool, 'command'))) {
+                throw new Error(`Unsupported artifact tool: ${typeName}.${operation}`);
+            }
+            if (builtin) {
+                if (Object.keys(tool).some(key => key !== 'description'))
+                    throw new Error(`Artifact builtin tool allows only description: ${typeName}.${operation}`);
+            }
+            else {
+                if (Object.keys(tool).some(key => !['description', 'command', 'args', 'timeoutMs'].includes(key)))
+                    throw new Error(`Unknown Human command field: ${typeName}.${operation}`);
+                if (typeof tool.command !== 'string' || !tool.command.trim() || tool.command.length > 4096 || /[\0\r\n{}]/.test(tool.command) || (!tool.command.startsWith('/') && /[/\\]/.test(tool.command)))
+                    throw new Error(`Human command must be an executable name or absolute path: ${typeName}.${operation}`);
+                if (!Array.isArray(tool.args) || tool.args.length > 64 || !tool.args.includes('{artifactPath}') || tool.args.some(arg => typeof arg !== 'string' || arg.length > 4096 || arg.includes('\0') || (arg !== '{artifactPath}' && /[{}]/.test(arg))))
+                    throw new Error(`Human command args must include standalone {artifactPath} and fixed string arguments: ${typeName}.${operation}`);
+                if (tool.timeoutMs !== undefined && (typeof tool.timeoutMs !== 'number' || !Number.isInteger(tool.timeoutMs) || tool.timeoutMs < 1 || tool.timeoutMs > 120_000))
+                    throw new Error(`Human command timeoutMs must be 1–120000: ${typeName}.${operation}`);
+            }
+            if (tool.description === undefined && audience !== 'tools' && builtin)
+                continue;
+            if (typeof tool.description !== 'string' || !tool.description.trim() || tool.description.length > 4000)
+                throw new Error(`Artifact tool description must contain 1–4000 characters: ${typeName}.${operation}`);
+            if (/[{}]/.test(tool.description.replaceAll('{artifactName}', '')))
+                throw new Error(`Artifact tool description supports only the {artifactName} placeholder: ${typeName}.${operation}`);
+        }
+    }
+    return definition;
+}
+/** Legacy defaults are available only if neither audience was explicitly declared. */
+export function artifactAudienceTools(typeDefinition, audience, { allowLegacy = false } = {}) {
+    const definition = validateArtifactType('artifact', typeDefinition);
+    if (Object.hasOwn(definition, 'agentTools') || Object.hasOwn(definition, 'humanTools'))
+        return structuredClone(definition[audience === 'agent' ? 'agentTools' : 'humanTools'] ?? {});
+    if (!allowLegacy)
+        return {};
+    if (definition.custom)
+        return {};
+    return Object.fromEntries(operations[definition.viewer].map(operation => [operation, { description: definition.tools?.[operation]?.description ?? defaults[operation] }]));
+}
+export function assertArtifactAudience(request, { allowLegacy = false } = {}) {
+    const audience = request.profile.kind;
+    if (audience !== 'agent' && audience !== 'human')
+        return;
+    for (const artifact of request.artifacts) {
+        if (request.configManifest) {
+            if (!Object.keys(request.configManifest.types[artifact.type]?.[audience === 'agent' ? 'agentTools' : 'humanTools'] ?? {}).length)
+                throw Object.assign(new Error(`Artifact ${artifact.id} has no ${audience} tools.`), { code: 'ARTIFACT_TOOLS_UNAVAILABLE' });
+            continue;
+        }
+        const type = validateArtifactType(artifact.type, request.artifactTypes[artifact.type]);
+        if (!Object.keys(artifactAudienceTools(type, audience, { allowLegacy })).length)
+            throw Object.assign(new Error(`Artifact ${artifact.id} has no ${audience} tools. Register ${audience}Tools on artifact type ${artifact.type}.`), { code: 'ARTIFACT_TOOLS_UNAVAILABLE' });
+    }
+}
+export function toolDescription(typeDefinition, toolName, artifactName, audience) {
+    const definition = validateArtifactType('artifact', typeDefinition);
+    if ((toolName !== 'read' && toolName !== 'list') || !definition.viewer || !operations[definition.viewer].includes(toolName)) {
+        throw new Error(`Unsupported artifact tool for ${definition.viewer} viewer: ${String(toolName)}`);
+    }
+    if (typeof artifactName !== 'string' || !artifactName)
+        throw new Error('Artifact name is required for its tool description.');
+    const template = audience ? artifactAudienceTools(definition, audience, { allowLegacy: true })[toolName]?.description ?? defaults[toolName] : definition.tools?.[toolName]?.description ?? defaults[toolName];
+    return template.replaceAll('{artifactName}', () => artifactName);
+}
+//# sourceMappingURL=types.js.map

package/dist/src/artifacts/types.js.map

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

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

@@ -0,0 +1,11 @@
+import type { RepoConfig } from '../contracts.js';
+export interface WorkspaceTreeEntry {
+    path: string;
+    type: string;
+    mode: string;
+}
+export declare function validateRelativePath(value: unknown): string;
+export declare function readWorkspaceConfig(repoPath: string, signal?: AbortSignal): Promise<{
+    config: RepoConfig;
+}>;
+export declare function validateConfig(config: unknown, tree: WorkspaceTreeEntry[]): asserts config is RepoConfig;

package/dist/src/broker/config.js

@@ -0,0 +1,141 @@
+import path from 'node:path';
+import { lstat, readFile, readdir, realpath } from 'node:fs/promises';
+import { validateArtifactType } from '../artifacts/types.js';
+import { isArtifactGroup, validateArtifactDefinitions } from '../artifacts/groups.js';
+import { createGraphDefinition } from './graph.js';
+import { openToolHost } from '../tools/host.js';
+const errorCode = (error) => error !== null && typeof error === 'object' && 'code' in error ? error.code : undefined;
+const identifier = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
+const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+export function validateRelativePath(value) {
+    if (typeof value !== 'string' || !value || value.length > 1024 ||
+        path.posix.isAbsolute(value) || path.win32.isAbsolute(value) ||
+        /[\\\x00-\x1f\x7f]/.test(value) || value.split('/').some(part => !part || part === '.' || part === '..')) {
+        throw new Error(`Artifact path must be a safe repository-relative path: ${String(value)}`);
+    }
+    return value;
+}
+export async function readWorkspaceConfig(repoPath, signal) {
+    signal?.throwIfAborted();
+    const root = await realpath(repoPath);
+    const configPath = path.join(root, 'ccdd.config.json');
+    const info = await lstat(configPath).catch(() => null);
+    const tsInfo = await lstat(path.join(root, 'ccdd.config.ts')).catch(() => null);
+    if (info && tsInfo)
+        throw new Error('Both ccdd.config.ts and ccdd.config.json exist; keep one configuration.');
+    if (!info?.isFile() && !tsInfo?.isFile())
+        throw new Error('Workspace must contain a regular ccdd.config.ts or ccdd.config.json file.');
+    let config;
+    try {
+        if (tsInfo) {
+            const host = await openToolHost(root, signal);
+            try {
+                config = host.config;
+            }
+            finally {
+                await host.close();
+            }
+        }
+        else {
+            config = JSON.parse(await readFile(configPath, 'utf8'));
+            if (object(config) && (config.configManifest !== undefined || object(config.artifactTypes) && Object.values(config.artifactTypes).some(value => object(value) && value.custom)))
+                throw new Error('Custom tools must be registered in ccdd.config.ts.');
+        }
+    }
+    catch (error) {
+        throw new Error(`Cannot read workspace configuration: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Inspect only declared Artifact roots here. The workspace engine validates the entire input tree.
+    const tree = [];
+    const visited = new Set();
+    const walk = async (relative) => {
+        signal?.throwIfAborted();
+        if (visited.has(relative))
+            return;
+        visited.add(relative);
+        const absolute = path.join(root, relative);
+        const entry = await lstat(absolute).catch(error => { if (errorCode(error) === 'ENOENT')
+            return null; throw error; });
+        if (!entry)
+            return;
+        const resolved = await realpath(absolute);
+        const sub = path.relative(root, resolved);
+        if (path.isAbsolute(sub) || sub === '..' || sub.startsWith(`..${path.sep}`))
+            throw new Error(`Artifact escapes the workspace: ${relative}`);
+        if (entry.isDirectory()) {
+            tree.push({ path: relative, type: 'tree', mode: '040000' });
+            for (const name of await readdir(absolute))
+                await walk(`${relative}/${name}`);
+        }
+        else {
+            tree.push({ path: relative, type: entry.isFile() ? 'blob' : 'unsupported', mode: entry.isSymbolicLink() ? '120000' : '100644' });
+        }
+    };
+    if (object(config) && object(config.artifacts)) {
+        validateArtifactDefinitions(config.artifacts);
+        for (const artifact of Object.values(config.artifacts)) {
+            if (!isArtifactGroup(artifact))
+                await walk(validateRelativePath(artifact.path));
+        }
+    }
+    validateConfig(config, tree);
+    return { config };
+}
+export function validateConfig(config, tree) {
+    if (!object(config) || !object(config.artifacts) || !object(config.artifactTypes) ||
+        !Array.isArray(config.critics) || config.critics.length === 0 || config.critics.length > 32) {
+        throw new Error('Config requires artifacts, artifactTypes, and 1–32 critics.');
+    }
+    for (const [type, definition] of Object.entries(config.artifactTypes)) {
+        validateArtifactType(type, definition);
+        if (object(definition) && definition.custom && (!object(config.configManifest) || !object(config.configManifest.types) || !Object.hasOwn(config.configManifest.types, type)))
+            throw new Error('Custom Artifact type requires a recorded tool manifest.');
+    }
+    validateArtifactDefinitions(config.artifacts);
+    for (const [id, artifact] of Object.entries(config.artifacts)) {
+        if (isArtifactGroup(artifact))
+            continue;
+        if (!Object.hasOwn(config.artifactTypes, artifact.type)) {
+            throw new Error(`Invalid artifact definition or unknown type: ${id}`);
+        }
+        const artifactPath = validateRelativePath(artifact.path);
+        const entries = tree.filter(entry => entry.path === artifactPath || entry.path.startsWith(`${artifactPath}/`));
+        if (entries.length === 0 || entries.some(entry => !['blob', 'tree'].includes(entry.type) || entry.mode === '120000')) {
+            throw new Error(`Artifact must contain workspace files or directories without symlinks: ${id}`);
+        }
+        if (config.artifactTypes[artifact.type].viewer === 'text' && !entries.some(entry => entry.path === artifactPath && entry.type === 'blob')) {
+            throw new Error(`Text viewer requires a file artifact: ${id}`);
+        }
+    }
+    const artifacts = config.artifacts;
+    const seen = new Set();
+    for (const critic of config.critics) {
+        if (!object(critic) || typeof critic.id !== 'string' || !identifier.test(critic.id) || seen.has(critic.id))
+            throw new Error('Critic IDs must be unique safe identifiers.');
+        seen.add(critic.id);
+        if (Object.hasOwn(critic, 'dependsOn') || Object.hasOwn(critic, 'artifacts')) {
+            throw new Error(`Critic ${critic.id}: dependsOn/artifacts have been replaced by target (one Artifact ID) and deps (Artifact ID array). Migrate the configuration explicitly; see docs/artifact-graph.md.`);
+        }
+        if (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(id => typeof id !== 'string' || !Object.hasOwn(artifacts, id))) {
+            throw new Error(`Critic ${critic.id} requires a title, a known target Artifact and unique known deps.`);
+        }
+        if (!object(critic.payload) || typeof critic.payload.instruction !== 'string' || !critic.payload.instruction.trim()) {
+            throw new Error(`Critic ${critic.id} requires a review request payload instruction.`);
+        }
+        const profile = critic.profile;
+        if (!object(profile) || typeof profile.kind !== 'string' || !['agent', 'runtime', 'human'].includes(profile.kind))
+            throw new Error(`Invalid executor profile: ${critic.id}`);
+        if (profile.kind === 'agent' && ['provider', 'model', 'reasoning'].some(key => typeof profile[key] !== 'string' || !profile[key].trim())) {
+            throw new Error(`Agent profile requires provider, model and reasoning: ${critic.id}`);
+        }
+        if (profile.kind === 'runtime' && (typeof profile.command !== 'string' || !profile.command.trim() ||
+            !Array.isArray(profile.args) || profile.args.some(arg => typeof arg !== 'string'))) {
+            throw new Error(`Runtime profile requires command and string args: ${critic.id}`);
+        }
+    }
+    createGraphDefinition(config);
+}
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,69 @@
+import type { ArtifactEntryDefinition, CriticProfile, RepoConfig, ReviewEnvelope, ReviewStatus } from '../contracts.js';
+import type { ValidationStatus } from '../project/types.js';
+export interface GraphCriticDefinition {
+    id: string;
+    title: string;
+    target: string;
+    deps: string[];
+    kind: CriticProfile['kind'];
+}
+export interface GraphDefinition {
+    version: 1;
+    artifacts: Record<string, ArtifactEntryDefinition>;
+    critics: GraphCriticDefinition[];
+}
+export type ArtifactStatus = 'BASIS' | 'UNREVIEWED' | ReviewStatus;
+export interface GraphRequest {
+    id: string;
+    criticId: string;
+    status: ReviewStatus;
+    claimedBy?: string | null;
+    blockedReason?: string | null;
+}
+interface GraphArtifactStateBase {
+    id: string;
+    basis: boolean;
+    status: ArtifactStatus;
+    criticIds: string[];
+    passed: number;
+    total: number;
+    included: number;
+    validationStatus?: ValidationStatus;
+}
+export type GraphArtifactState = GraphArtifactStateBase & ({
+    kind?: 'artifact';
+    type: string;
+    path: string;
+} | {
+    kind: 'group';
+    members: string[];
+});
+export interface GraphCriticState extends GraphCriticDefinition {
+    requestId: string | null;
+    status: ReviewStatus | null;
+    claimedBy: string | null;
+    blockedReason: string | null;
+    validationStatus?: ValidationStatus;
+    validationReason?: string;
+    reusedFrom?: {
+        requestId: string;
+        runId: string;
+        completedAt: string;
+    };
+}
+export interface GraphProjection {
+    artifacts: GraphArtifactState[];
+    critics: GraphCriticState[];
+    edges: {
+        source: string;
+        target: string;
+        criticIds: string[];
+    }[];
+}
+/** Validate only the immutable graph metadata; no payloads, providers or workspace reads. */
+export declare function validateGraphDefinition(value: unknown): asserts value is GraphDefinition;
+export declare function createGraphDefinition(config: RepoConfig): GraphDefinition;
+export declare function prerequisiteCriticIds(request: Pick<ReviewEnvelope, 'deps'>, graph: GraphDefinition): string[];
+/** Call with requests from exactly one Run. Missing evaluations never count as passing. */
+export declare function projectGraph(graph: GraphDefinition, requests: readonly GraphRequest[]): GraphProjection;
+export {};