@ccdd/project 2.0.1

package/dist/src/project/identity.js

@@ -0,0 +1,87 @@
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { lstat, readdir } from 'node:fs/promises';
+import path from 'node:path';
+import { isArtifactGroup, resolveArtifactScope } from '../artifacts/groups.js';
+import { createGraphDefinition } from '../broker/graph.js';
+import { validateRelativePath } from '../broker/config.js';
+import { packageVersion } from '../runtime-paths.js';
+export function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    if (value !== null && typeof value === 'object')
+        return `{${Object.entries(value).filter(([, v]) => v !== undefined).sort(([a], [b]) => a.localeCompare(b, 'en')).map(([k, v]) => `${JSON.stringify(k)}:${canonical(v)}`).join(',')}}`;
+    return JSON.stringify(value) ?? 'null';
+}
+export const inputHash = (value) => createHash('sha256').update(canonical(value)).digest('hex');
+/** Hash declared content, including additions, removals, names and empty directories. */
+async function hashPath(root, relative, signal) {
+    validateRelativePath(relative);
+    // Check every ancestor before following a path: a file under a symlink is not scoped input.
+    let current = root;
+    for (const component of relative.split('/')) {
+        current = path.join(current, component);
+        const info = await lstat(current).catch(error => { if (error.code === 'ENOENT')
+            return null; throw error; });
+        if (!info)
+            return inputHash({ path: relative, type: 'missing' });
+        if (info.isSymbolicLink())
+            throw new Error(`Stale input must not contain symlinks: ${relative}`);
+    }
+    const entries = [];
+    const walk = async (absolute, name) => {
+        signal?.throwIfAborted();
+        const info = await lstat(absolute);
+        if (info.isSymbolicLink())
+            throw new Error(`Stale input must not contain symlinks: ${name}`);
+        if (info.isDirectory()) {
+            entries.push({ name, type: 'directory' });
+            for (const child of (await readdir(absolute)).sort())
+                await walk(path.join(absolute, child), `${name}/${child}`);
+        }
+        else if (info.isFile()) {
+            const hash = createHash('sha256');
+            for await (const bytes of createReadStream(absolute, { signal }))
+                hash.update(bytes);
+            entries.push({ name, type: 'file', executable: info.mode & 0o111, hash: hash.digest('hex') });
+        }
+        else
+            throw new Error(`Unsupported stale input: ${name}`);
+    };
+    await walk(path.join(root, relative), relative);
+    return inputHash(entries);
+}
+export async function createProjectSnapshot(config, root, snapshotHash, signal) {
+    createGraphDefinition(config);
+    const artifactHashes = {}, reusable = {};
+    const paths = new Map();
+    const fingerprintPath = (value) => { if (!paths.has(value))
+        paths.set(value, hashPath(root, value, signal)); return paths.get(value); };
+    const visit = async (id) => {
+        if (artifactHashes[id])
+            return artifactHashes[id];
+        const artifact = config.artifacts[id];
+        const extraPaths = artifact.stale?.kind === 'file-hash' ? artifact.stale.paths : undefined;
+        const fingerprints = await Promise.all((extraPaths ?? (isArtifactGroup(artifact) ? [] : [artifact.path])).slice().sort().map(async (name) => ({ path: name, hash: await fingerprintPath(name) })));
+        const members = isArtifactGroup(artifact) ? await Promise.all(artifact.members.map(async (member) => ({ id: member, hash: await visit(member) }))) : [];
+        reusable[id] = artifact.stale?.kind !== 'always' && members.every(member => reusable[member.id]);
+        return artifactHashes[id] = inputHash({ definition: artifact, fingerprints, members });
+    };
+    for (const id of Object.keys(config.artifacts))
+        await visit(id);
+    const inputs = {};
+    for (const critic of config.critics) {
+        const scope = resolveArtifactScope(config.artifacts, [critic.target, ...critic.deps]);
+        const types = Object.fromEntries([...new Set(scope.artifacts.map(a => a.type))].sort().map(type => [type, config.artifactTypes[type]]));
+        // A TS tool can close over arbitrary imported values. Keep its module snapshot in
+        // the identity rather than falsely treating identical function text as identical behavior.
+        const modules = config.configManifest?.modules;
+        const tools = config.configManifest ? Object.fromEntries(Object.keys(types).map(type => [type, config.configManifest.types[type]])) : types;
+        const criticHash = inputHash({ version: 1, executorVersion: packageVersion, critic, tools, modules, runtime: critic.profile.kind === 'runtime' ? { node: process.versions.node, platform: process.platform, arch: process.arch } : undefined });
+        const target = { id: critic.target, hash: artifactHashes[critic.target] };
+        const deps = critic.deps.slice().sort().map(id => ({ id, hash: artifactHashes[id] }));
+        inputs[critic.id] = { version: 1, key: inputHash({ criticHash, target, deps }), criticHash, target, deps, reusable: [critic.target, ...critic.deps].every(id => reusable[id]) };
+    }
+    return { version: 1, config: structuredClone(config), snapshotHash, artifactHashes, inputs };
+}
+//# sourceMappingURL=identity.js.map

package/dist/src/project/identity.js.map

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

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

@@ -0,0 +1,19 @@
+import type { ProjectSelection } from './types.js';
+export type * from './types.js';
+export { createProjectSnapshot } from './identity.js';
+export { queryProject, planProject } from './query.js';
+export { projectHistory, projectRun, projectRuns, projectRequests } from './store.js';
+export { createBroker } from '../broker/index.js';
+export { createExecutorRegistry } from '../executors/index.js';
+/** Explicit CLI query: briefly observe the current workspace without creating a store. */
+export declare function inspectProject({ repoPath, stateDir, selection, recursive, force, signal }: {
+    repoPath: string;
+    stateDir: string;
+    selection?: ProjectSelection;
+    recursive?: boolean;
+    force?: boolean;
+    signal?: AbortSignal;
+}): Promise<{
+    snapshot: import("./types.js").ProjectSnapshot;
+    plan: import("./types.js").ProjectPlan;
+}>;

package/dist/src/project/index.js

@@ -0,0 +1,26 @@
+import { readWorkspaceConfig } from '../broker/config.js';
+import { prepareWorkspace } from '../workspaces/index.js';
+import { createProjectSnapshot } from './identity.js';
+import { planProject } from './query.js';
+import { projectHistory } from './store.js';
+export { createProjectSnapshot } from './identity.js';
+export { queryProject, planProject } from './query.js';
+export { projectHistory, projectRun, projectRuns, projectRequests } from './store.js';
+export { createBroker } from '../broker/index.js';
+export { createExecutorRegistry } from '../executors/index.js';
+/** Explicit CLI query: briefly observe the current workspace without creating a store. */
+export async function inspectProject({ repoPath, stateDir, selection, recursive = false, force = false, signal }) {
+    const workspace = await prepareWorkspace({ repoPath, stateDir, mode: 'lock', signal });
+    try {
+        const { config } = await readWorkspaceConfig(workspace.descriptor.path, workspace.signal);
+        const snapshot = await createProjectSnapshot(config, workspace.descriptor.path, workspace.descriptor.hash, workspace.signal);
+        const history = projectHistory(stateDir);
+        const plan = planProject(snapshot, history, { selection, recursive, force });
+        await workspace.assertUnchanged();
+        return { snapshot, plan };
+    }
+    finally {
+        await workspace.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,MAAM,EAAoI;IAChP,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvF,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1F,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7H,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;QAClC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;YAAS,CAAC;QAAC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AACxC,CAAC"}

package/dist/src/project/query.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectSnapshot, ProjectSelection, QueryOptions, ValidationEvidence, ProjectQuery, ProjectPlan } from './types.js';
+export declare function selectedCritics(snapshot: ProjectSnapshot, selection: ProjectSelection): string[];
+export declare function includedCritics(snapshot: ProjectSnapshot, selection: ProjectSelection, recursive: boolean): string[];
+/** No stored staleState: these memo tables live for precisely one pull query. */
+export declare function queryProject(snapshot: ProjectSnapshot, history: readonly ValidationEvidence[], options?: QueryOptions): ProjectQuery;
+export declare function planProject(snapshot: ProjectSnapshot, history: readonly ValidationEvidence[], options?: QueryOptions & {
+    recursive?: boolean;
+    force?: boolean;
+}): ProjectPlan;

package/dist/src/project/query.js

@@ -0,0 +1,136 @@
+import { createGraphDefinition } from '../broker/graph.js';
+export function selectedCritics(snapshot, selection) {
+    const config = snapshot.config;
+    if (selection.kind === 'all')
+        return config.critics.map(c => c.id);
+    if (selection.kind === 'critic') {
+        if (!config.critics.some(c => c.id === selection.criticId))
+            throw new Error(`Unknown Critic: ${selection.criticId}`);
+        return [selection.criticId];
+    }
+    if (!Object.hasOwn(config.artifacts, selection.artifactId))
+        throw new Error(`Unknown Artifact: ${selection.artifactId}`);
+    return config.critics.filter(c => c.target === selection.artifactId).map(c => c.id);
+}
+export function includedCritics(snapshot, selection, recursive) {
+    const included = new Set(selectedCritics(snapshot, selection));
+    if (recursive || selection.kind === 'all') {
+        const visit = (id) => {
+            const critic = snapshot.config.critics.find(c => c.id === id);
+            for (const parent of snapshot.config.critics.filter(c => critic.deps.includes(c.target))) {
+                if (included.has(parent.id))
+                    continue;
+                included.add(parent.id);
+                visit(parent.id);
+            }
+        };
+        for (const id of [...included])
+            visit(id);
+    }
+    return snapshot.config.critics.filter(c => included.has(c.id)).map(c => c.id);
+}
+/** No stored staleState: these memo tables live for precisely one pull query. */
+export function queryProject(snapshot, history, options = {}) {
+    createGraphDefinition(snapshot.config);
+    const selection = options.selection ?? { kind: 'all' };
+    selectedCritics(snapshot, selection);
+    const byKey = new Map(), byRunKey = new Map(), byCritic = new Map();
+    // The store orders ties by insertion order. Stable sorting keeps that order here.
+    for (const evidence of [...history].sort((a, b) => a.completedAt.localeCompare(b.completedAt))) {
+        byKey.set(evidence.input.key, evidence);
+        byCritic.set(evidence.criticId, evidence);
+        if (evidence.runId === options.runId)
+            byRunKey.set(evidence.input.key, evidence);
+    }
+    const attempts = new Map(options.attempts?.map(request => [request.criticId, request]));
+    const forced = new Set(options.forceCriticIds ?? []);
+    const artifactMemo = new Map(), criticMemo = new Map();
+    const critic = (id) => {
+        if (criticMemo.has(id))
+            return criticMemo.get(id);
+        const definition = snapshot.config.critics.find(c => c.id === id);
+        const input = snapshot.inputs[id];
+        if (!input)
+            throw new Error(`Missing recorded validation input: ${id}`);
+        const found = (input.reusable && !forced.has(id) ? byKey : byRunKey).get(input.key);
+        const attempt = attempts.get(id);
+        const evidence = found && found.criticId === id && (input.reusable && !forced.has(id) || found.runId === options.runId) ? found : null;
+        const blockedBy = definition.deps.filter(dep => artifact(dep).isStale);
+        const ownPass = evidence?.verdict === 'GREEN';
+        let status, reason;
+        if (attempt && ['QUEUED', 'RUNNING', 'WAITING_HUMAN'].includes(attempt.status)) {
+            status = attempt.status;
+            reason = 'A review of this input is in progress.';
+        }
+        else if (attempt?.status === 'ERROR') {
+            status = 'ERROR';
+            reason = attempt.error ?? 'The review could not complete.';
+        }
+        else if (blockedBy.length) {
+            status = 'BLOCKED';
+            reason = `Required Artifact validation is not satisfied: ${blockedBy.map(dep => `${dep} (${artifact(dep).criticIds.filter(id => critic(id).isStale).map(id => `${id}: ${critic(id).status}`).join(', ') || 'no evaluator'})`).join('; ')}.`;
+        }
+        else if (ownPass) {
+            status = 'PASS';
+            reason = `Reusing actual PASS evidence ${evidence.requestId}.`;
+        }
+        else if (evidence?.verdict === 'RED') {
+            status = 'RED';
+            reason = evidence.summary;
+        }
+        else if (forced.has(id)) {
+            status = 'STALE';
+            reason = 'This request explicitly requires a new review.';
+        }
+        else if (!input.reusable) {
+            status = 'STALE';
+            reason = 'The always strategy requires a review in this validation request.';
+        }
+        else if (byCritic.has(id)) {
+            const previous = byCritic.get(id).input;
+            const changed = [previous.criticHash !== input.criticHash ? 'Critic conditions' : '', previous.target.hash !== input.target.hash ? `target ${input.target.id}` : '', ...input.deps.filter(dep => previous.deps.find(p => p.id === dep.id)?.hash !== dep.hash).map(dep => `dependency ${dep.id}`)].filter(Boolean);
+            status = 'STALE';
+            reason = `Validation input changed: ${changed.join(', ') || 'dependency scope'}.`;
+        }
+        else {
+            status = 'UNREVIEWED';
+            reason = 'No actual review has been recorded for this input.';
+        }
+        const value = { id, title: definition.title, target: definition.target, deps: [...definition.deps], status,
+            isStale: status !== 'PASS', needsReview: !ownPass || forced.has(id) && evidence?.runId !== options.runId,
+            canExecute: blockedBy.length === 0 && !ownPass && !attempt,
+            blockedBy, reason, input, result: evidence, requestId: attempt?.id ?? null };
+        criticMemo.set(id, value);
+        return value;
+    };
+    const artifact = (id) => {
+        if (artifactMemo.has(id))
+            return artifactMemo.get(id);
+        const definition = snapshot.config.artifacts[id];
+        const own = snapshot.config.critics.filter(c => c.target === id).map(c => critic(c.id));
+        const passed = own.filter(c => !c.isStale).length;
+        const status = definition.basis ? 'BASIS' : own.length && passed === own.length ? 'PASS' :
+            ['RUNNING', 'QUEUED', 'WAITING_HUMAN', 'ERROR', 'RED', 'BLOCKED', 'STALE', 'UNREVIEWED'].find(s => own.some(c => c.status === s)) ?? 'UNREVIEWED';
+        const value = { id, hash: snapshot.artifactHashes[id], status, isStale: status !== 'PASS' && status !== 'BASIS', criticIds: own.map(c => c.id), passed, total: own.length };
+        artifactMemo.set(id, value);
+        return value;
+    };
+    const artifacts = Object.keys(snapshot.config.artifacts).map(artifact);
+    const critics = snapshot.config.critics.map(c => critic(c.id));
+    const satisfied = selection.kind === 'artifact' ? !artifact(selection.artifactId).isStale : selection.kind === 'critic' ? !critic(selection.criticId).isStale : critics.every(c => !c.isStale);
+    return { snapshotHash: snapshot.snapshotHash, selection, satisfied, artifacts, critics };
+}
+export function planProject(snapshot, history, options = {}) {
+    const selection = options.selection ?? { kind: 'all' };
+    const selectedCriticIds = selectedCritics(snapshot, selection);
+    const includedCriticIds = includedCritics(snapshot, selection, Boolean(options.recursive));
+    const forceCriticIds = options.force ? selectedCriticIds : [];
+    const query = queryProject(snapshot, history, { ...options, selection, forceCriticIds });
+    const items = query.critics.filter(c => includedCriticIds.includes(c.id)).map(c => {
+        const action = (c.status === 'PASS' ? 'REUSE' : ['QUEUED', 'RUNNING', 'WAITING_HUMAN'].includes(c.status) ? 'ACTIVE' : c.canExecute ? 'EXECUTE' : c.requestId && ['ERROR', 'RED'].includes(c.status) ? 'FAILED' : 'WAIT');
+        return { ...c, action };
+    });
+    return { ...query, recursive: Boolean(options.recursive), force: Boolean(options.force), selectedCriticIds, includedCriticIds, items,
+        counts: { reuse: items.filter(c => c.action === 'REUSE').length, execute: items.filter(c => c.action === 'EXECUTE').length, wait: items.filter(c => c.action === 'WAIT').length, active: items.filter(c => c.action === 'ACTIVE').length, failed: items.filter(c => c.action === 'FAILED').length } };
+}
+//# sourceMappingURL=query.js.map

package/dist/src/project/query.js.map

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

package/dist/src/project/store.d.ts

@@ -0,0 +1,15 @@
+import { DatabaseSync } from 'node:sqlite';
+import type { ReviewRequest } from '../contracts.js';
+import type { RunView } from '../broker/index.js';
+import type { ValidationEvidence, ProjectPlan } from './types.js';
+export declare function readEvidence(database: DatabaseSync): ValidationEvidence[];
+/** Existing databases only; no migrations, ownership reconciliation or write connection. */
+export declare function withProjectStore<T>(stateDir: string, read: (database: DatabaseSync) => T, empty: T): T;
+export declare function projectHistory(stateDir: string): ValidationEvidence[];
+export type ProjectRunView = RunView & {
+    validation?: ProjectPlan;
+};
+export declare function storedRun(database: DatabaseSync, id: string): ProjectRunView | null;
+export declare function projectRun(stateDir: string, id: string): ProjectRunView | null;
+export declare function projectRuns(stateDir: string): ProjectRunView[];
+export declare function projectRequests(stateDir: string, runId?: string): ReviewRequest[];

package/dist/src/project/store.js

@@ -0,0 +1,47 @@
+import { DatabaseSync } from 'node:sqlite';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { planProject } from './query.js';
+export function readEvidence(database) {
+    const rows = database.prepare("SELECT data FROM requests WHERE status IN ('GREEN','RED') AND json_extract(data, '$.validationInput.version') = 1 ORDER BY json_extract(data, '$.completedAt'), rowid").all();
+    return rows.flatMap(row => {
+        const request = JSON.parse(String(row.data));
+        if (!request.validationInput || !/^[a-f0-9]{64}$/.test(request.validationInput.key) || !request.result || request.result.verdict !== request.status || !request.completedAt)
+            return [];
+        return [{ requestId: request.id, runId: request.runId, criticId: request.criticId, input: request.validationInput, completedAt: request.completedAt, verdict: request.result.verdict, summary: request.result.summary, evidence: request.result.evidence }];
+    });
+}
+/** Existing databases only; no migrations, ownership reconciliation or write connection. */
+export function withProjectStore(stateDir, read, empty) {
+    const filename = join(stateDir, 'broker.sqlite');
+    if (!existsSync(filename))
+        return empty;
+    const database = new DatabaseSync(filename, { readOnly: true });
+    try {
+        database.exec('BEGIN');
+        const result = read(database);
+        database.exec('COMMIT');
+        return result;
+    }
+    finally {
+        database.close();
+    }
+}
+export function projectHistory(stateDir) { return withProjectStore(stateDir, readEvidence, []); }
+export function storedRun(database, id) {
+    const row = database.prepare('SELECT data FROM runs WHERE id = ?').get(id);
+    if (!row)
+        return null;
+    const run = JSON.parse(String(row.data));
+    const requests = database.prepare('SELECT data FROM requests WHERE run_id = ? ORDER BY ordinal').all(id).map(row => JSON.parse(String(row.data)));
+    const events = database.prepare('SELECT * FROM (SELECT * FROM events WHERE run_id = ? ORDER BY id DESC LIMIT 500) ORDER BY id').all(id).map(event => ({ id: Number(event.id), runId: String(event.run_id), requestId: event.request_id === null ? null : String(event.request_id), createdAt: String(event.created_at), type: String(event.type), message: String(event.message) }));
+    const owner = database.prepare('SELECT pid, claimed_at FROM run_owners WHERE run_id = ?').get(id);
+    return { ...run, scope: run.scope ?? { kind: run.graph ? 'graph' : 'chain' }, requests, events, owner: owner ? { pid: Number(owner.pid), claimedAt: String(owner.claimed_at) } : null,
+        ...(run.project ? { validation: planProject(run.project.snapshot, readEvidence(database).filter(e => !run.project.evidenceRequestIds || run.project.evidenceRequestIds.includes(e.requestId)), { selection: run.project.selection, recursive: run.project.recursive, force: run.project.force, runId: id, attempts: requests }) } : {}) };
+}
+export function projectRun(stateDir, id) { return withProjectStore(stateDir, db => storedRun(db, id), null); }
+export function projectRuns(stateDir) { return withProjectStore(stateDir, db => db.prepare('SELECT id FROM runs ORDER BY created_at DESC, rowid DESC').all().map(row => storedRun(db, String(row.id))), []); }
+export function projectRequests(stateDir, runId) {
+    return withProjectStore(stateDir, db => (runId ? db.prepare('SELECT data FROM requests WHERE run_id = ? ORDER BY ordinal').all(runId) : db.prepare('SELECT data FROM requests ORDER BY created_at DESC, rowid DESC').all()).map(row => JSON.parse(String(row.data))), []);
+}
+//# sourceMappingURL=store.js.map

package/dist/src/project/store.js.map

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

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

@@ -0,0 +1,106 @@
+import type { RepoConfig, ReviewEnvelope, ReviewResult, ReviewRequest } from '../contracts.js';
+export type ProjectSelection = {
+    kind: 'all';
+} | {
+    kind: 'artifact';
+    artifactId: string;
+} | {
+    kind: 'critic';
+    criticId: string;
+};
+export interface ValidationInput {
+    version: 1;
+    key: string;
+    criticHash: string;
+    target: {
+        id: string;
+        hash: string;
+    };
+    deps: {
+        id: string;
+        hash: string;
+    }[];
+    reusable: boolean;
+}
+export interface ProjectSnapshot {
+    version: 1;
+    config: RepoConfig;
+    snapshotHash: string;
+    artifactHashes: Record<string, string>;
+    inputs: Record<string, ValidationInput>;
+}
+export interface ValidationEvidence {
+    requestId: string;
+    runId: string;
+    criticId: string;
+    input: ValidationInput;
+    completedAt: string;
+    verdict: ReviewResult['verdict'];
+    summary: string;
+    evidence: string[];
+}
+export interface ProjectRunDefinition {
+    version: 1;
+    snapshot: ProjectSnapshot;
+    selection: ProjectSelection;
+    recursive: boolean;
+    force: boolean;
+    /** Prepared definitions, not tickets or persisted stale states. */
+    templates: ReviewEnvelope[];
+    /** Original evidence consumed by a completed execution; never a cached stale flag. */
+    evidenceRequestIds?: string[];
+}
+export type ValidationStatus = 'PASS' | 'BASIS' | 'UNREVIEWED' | 'STALE' | 'RED' | 'ERROR' | 'BLOCKED' | 'QUEUED' | 'RUNNING' | 'WAITING_HUMAN';
+export interface CriticValidation {
+    id: string;
+    title: string;
+    target: string;
+    deps: string[];
+    status: ValidationStatus;
+    isStale: boolean;
+    canExecute: boolean;
+    needsReview: boolean;
+    blockedBy: string[];
+    reason: string;
+    input: ValidationInput;
+    result: ValidationEvidence | null;
+    requestId: string | null;
+}
+export interface ArtifactValidation {
+    id: string;
+    hash: string;
+    status: ValidationStatus;
+    isStale: boolean;
+    criticIds: string[];
+    passed: number;
+    total: number;
+}
+export interface ProjectQuery {
+    snapshotHash: string;
+    selection: ProjectSelection;
+    satisfied: boolean;
+    artifacts: ArtifactValidation[];
+    critics: CriticValidation[];
+}
+export interface ProjectPlan extends ProjectQuery {
+    recursive: boolean;
+    force: boolean;
+    selectedCriticIds: string[];
+    includedCriticIds: string[];
+    items: (CriticValidation & {
+        action: 'REUSE' | 'EXECUTE' | 'WAIT' | 'ACTIVE' | 'FAILED';
+    })[];
+    counts: {
+        reuse: number;
+        execute: number;
+        wait: number;
+        active: number;
+        failed: number;
+    };
+}
+export interface QueryOptions {
+    selection?: ProjectSelection;
+    forceCriticIds?: readonly string[];
+    runId?: string;
+    attempts?: readonly ReviewRequest[];
+}

package/dist/src/project/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/project/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,16 @@
+import type { ReviewEnvelope, RepoConfig } from '../contracts.js';
+/** Repo-side adapter: prepare explicit envelopes from one prepared workspace definition. */
+export declare function prepareReviewRequests({ repoPath, repoId, snapshotHash, criticId, allowLegacyTools, preparedConfig }: {
+    repoPath: string;
+    repoId?: unknown;
+    snapshotHash: unknown;
+    criticId?: unknown;
+    allowLegacyTools?: boolean;
+    preparedConfig?: RepoConfig;
+}): Promise<ReviewEnvelope[]>;
+/** Reopen the declared observation scope of a stored review, including historical snapshots.
+ * This is never used for admission, scheduling or inferring a legacy target. */
+export declare function readStoredArtifactScope({ repoPath, criticId }: {
+    repoPath: string;
+    criticId: string;
+}): Promise<Pick<ReviewEnvelope, 'artifacts' | 'artifactGroups' | 'artifactTypes' | 'profile'>>;

package/dist/src/requester/index.js

@@ -0,0 +1,96 @@
+import { readFile, lstat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { readWorkspaceConfig, validateRelativePath } from '../broker/config.js';
+import { assertArtifactAudience } from '../artifacts/types.js';
+import { createArtifactViewer, createArtifactTools } from '../artifacts/index.js';
+import { createHumanArtifactTools } from '../artifacts/human.js';
+import { describeReviewTools } from '../tools/runner.js';
+import { resolveArtifactScope } from '../artifacts/groups.js';
+/** Repo-side adapter: prepare explicit envelopes from one prepared workspace definition. */
+export async function prepareReviewRequests({ repoPath, repoId = 'demo', snapshotHash, criticId, allowLegacyTools = false, preparedConfig }) {
+    if (typeof repoId !== 'string' || !repoId.trim() || repoId.length > 200)
+        throw new Error('A registered repoId is required (maximum 200 characters).');
+    if (typeof snapshotHash !== 'string' || !/^[a-f0-9]{64}$/.test(snapshotHash))
+        throw new Error('snapshotHash must be a full workspace SHA-256 content hash.');
+    if (criticId !== undefined && (typeof criticId !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(criticId))) {
+        throw new Error('criticId must be a non-empty safe Critic identifier.');
+    }
+    const snapshot = preparedConfig ? { config: preparedConfig } : await readWorkspaceConfig(repoPath);
+    const critics = criticId === undefined ? snapshot.config.critics : snapshot.config.critics.filter(critic => critic.id === criticId);
+    if (!critics.length)
+        throw new Error(`Unknown Critic in the requested snapshot: ${criticId}`);
+    const requests = critics.map(critic => structuredClone({
+        repoId,
+        snapshotHash,
+        criticId: critic.id,
+        title: critic.title,
+        ...resolveArtifactScope(snapshot.config.artifacts, [critic.target, ...critic.deps]),
+        artifactTypes: snapshot.config.artifactTypes,
+        ...(snapshot.config.configManifest ? { configManifest: snapshot.config.configManifest } : {}),
+        payload: critic.payload,
+        profile: critic.profile,
+        target: critic.target,
+        deps: critic.deps,
+    }));
+    for (const request of requests) {
+        if (request.profile.kind === 'runtime')
+            continue;
+        if (request.configManifest) {
+            const tools = describeReviewTools({ artifacts: request.artifacts, configManifest: request.configManifest, audience: request.profile.kind });
+            for (const artifact of request.artifacts) {
+                const info = await lstat(join(repoPath, artifact.path));
+                if (!tools.some(tool => tool.artifactId === artifact.id && (!tool.metadata?.artifactKind || tool.metadata.artifactKind === 'any' || tool.metadata.artifactKind === 'file' && info.isFile() || tool.metadata.artifactKind === 'directory' && info.isDirectory())))
+                    throw Object.assign(new Error(`Artifact ${artifact.id} has no usable ${request.profile.kind} tools.`), { code: 'ARTIFACT_TOOLS_UNAVAILABLE' });
+            }
+            continue;
+        }
+        assertArtifactAudience(request, { allowLegacy: allowLegacyTools });
+        const tools = request.profile.kind === 'human'
+            ? (await createHumanArtifactTools({ worktreePath: repoPath, artifacts: request.artifacts, artifactTypes: request.artifactTypes, allowLegacy: allowLegacyTools })).tools
+            : createArtifactTools(await createArtifactViewer({ worktreePath: repoPath, artifacts: request.artifacts, artifactTypes: request.artifactTypes })).tools;
+        for (const artifact of request.artifacts) {
+            if (!tools.some(tool => 'artifactId' in tool ? tool.artifactId === artifact.id : tool.name === `read_${artifact.id}` || tool.name === `list_${artifact.id}`)) {
+                throw new Error(`Artifact ${artifact.id} has no usable ${request.profile.kind} tools for its file or directory shape.`);
+            }
+        }
+    }
+    return requests;
+}
+/** Reopen the declared observation scope of a stored review, including historical snapshots.
+ * This is never used for admission, scheduling or inferring a legacy target. */
+export async function readStoredArtifactScope({ repoPath, criticId }) {
+    const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+    const raw = JSON.parse(await readFile(join(repoPath, 'ccdd.config.json'), 'utf8'));
+    if (!object(raw) || !object(raw.artifacts) || !object(raw.artifactTypes) || !Array.isArray(raw.critics))
+        throw new Error('Invalid stored Artifact configuration.');
+    const matches = raw.critics.filter(critic => object(critic) && critic.id === criticId);
+    if (matches.length !== 1 || !object(matches[0]))
+        throw new Error('Unknown stored Critic.');
+    const critic = matches[0];
+    if (!object(critic.profile) || !['agent', 'runtime', 'human'].includes(String(critic.profile.kind)))
+        throw new Error('Invalid stored Critic profile.');
+    const legacy = !Object.hasOwn(critic, 'target') && Object.hasOwn(critic, 'dependsOn');
+    let ids;
+    if (legacy)
+        ids = critic.artifacts;
+    else {
+        const { config } = await readWorkspaceConfig(repoPath);
+        const definition = config.critics.find(item => item.id === criticId);
+        const scope = { ...resolveArtifactScope(config.artifacts, [definition.target, ...definition.deps]), artifactTypes: config.artifactTypes, profile: definition.profile };
+        await createArtifactViewer({ worktreePath: repoPath, artifacts: scope.artifacts, artifactTypes: scope.artifactTypes });
+        return scope;
+    }
+    if (!Array.isArray(ids) || !ids.length || new Set(ids).size !== ids.length || ids.some(id => typeof id !== 'string' || !Object.hasOwn(raw.artifacts, id)))
+        throw new Error('Invalid stored Artifact references.');
+    const definitions = raw.artifacts;
+    const artifacts = ids.map(id => {
+        const artifact = definitions[id];
+        if (!/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(id) || !object(artifact) || typeof artifact.type !== 'string' || !Object.hasOwn(raw.artifactTypes, artifact.type))
+            throw new Error('Invalid stored Artifact definition.');
+        return { id, type: artifact.type, path: validateRelativePath(artifact.path) };
+    });
+    const scope = { artifacts, artifactTypes: raw.artifactTypes, profile: critic.profile };
+    await createArtifactViewer({ worktreePath: repoPath, artifacts: scope.artifacts, artifactTypes: scope.artifactTypes });
+    return scope;
+}
+//# sourceMappingURL=index.js.map