@ccdd/project 3.3.0 → 4.0.0

package/dist/src/artifacts/groups.js

@@ -1,93 +0,0 @@
-import { canonicalData } from './data.js';
-const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
-const identifier = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
-export function isArtifactGroup(value) {
-    return object(value) && value.kind === 'group';
-}
-export function isGeneratedArtifact(value) {
-    return object(value) && value.kind === 'generated';
-}
-/** Validate composition metadata without reading files or interpreting Critic dependencies. */
-export function validateArtifactDefinitions(value) {
-    if (!object(value))
-        throw new Error('Artifact definitions must be an object.');
-    for (const [id, artifact] of Object.entries(value)) {
-        if (!identifier.test(id) || !object(artifact) || (artifact.basis !== undefined && typeof artifact.basis !== 'boolean')) {
-            throw new Error(`Invalid Artifact definition: ${id}`);
-        }
-        if (artifact.stale !== undefined) {
-            const strategy = artifact.stale;
-            if (!object(strategy) || !['file-hash', 'always'].includes(String(strategy.kind)) || Object.keys(strategy).some(key => !['kind', 'paths'].includes(key)))
-                throw new Error(`Invalid stale strategy for Artifact ${id}.`);
-            if (strategy.kind === 'always' && strategy.paths !== undefined)
-                throw new Error('The always strategy does not accept paths.');
-            if (strategy.paths !== undefined && (!Array.isArray(strategy.paths) || !strategy.paths.length || new Set(strategy.paths).size !== strategy.paths.length || strategy.paths.some(p => typeof p !== 'string' || !p || p.length > 1024 || /[\\\\:*?\[\]{}\x00-\x1f\x7f]/.test(p) || p.split('/').some(part => !part || part === '.' || part === '..'))))
-                throw new Error(`Stale paths for ${id} must be unique literal repository-relative file or directory paths.`);
-        }
-        if (isArtifactGroup(artifact)) {
-            if (Object.hasOwn(artifact, 'type') || Object.hasOwn(artifact, 'path'))
-                throw new Error(`Artifact group ${id} cannot declare type or path; reference independent Artifacts in members.`);
-            if (!Array.isArray(artifact.members) || artifact.members.length === 0 || new Set(artifact.members).size !== artifact.members.length || artifact.members.some(member => typeof member !== 'string' || !identifier.test(member) || !Object.hasOwn(value, member))) {
-                throw new Error(`Artifact group ${id} requires nonempty, unique, known members.`);
-            }
-        }
-        else if (isGeneratedArtifact(artifact)) {
-            if (Object.keys(artifact).some(key => !['kind', 'type', 'source', 'params', 'basis', 'stale'].includes(key)) || typeof artifact.type !== 'string' || !identifier.test(artifact.type) || typeof artifact.source !== 'string' || !identifier.test(artifact.source) || artifact.stale && artifact.stale.kind !== 'always')
-                throw new Error(`Invalid generated Artifact definition: ${id}`);
-            if (artifact.params !== undefined)
-                canonicalData(artifact.params);
-        }
-        else if (artifact.kind !== undefined || Object.hasOwn(artifact, 'members') || typeof artifact.type !== 'string' || !artifact.type || typeof artifact.path !== 'string' || !artifact.path) {
-            throw new Error(`Invalid Artifact definition: ${id}`);
-        }
-    }
-    const definitions = value;
-    const visiting = new Set(), visited = new Set();
-    const visit = (id) => {
-        if (visiting.has(id))
-            throw new Error(`Artifact group membership must be acyclic; cycle includes ${id}.`);
-        if (visited.has(id))
-            return;
-        const artifact = definitions[id];
-        if (isArtifactGroup(artifact)) {
-            visiting.add(id);
-            for (const member of artifact.members)
-                visit(member);
-            visiting.delete(id);
-        }
-        visited.add(id);
-    };
-    for (const id of Object.keys(definitions))
-        visit(id);
-}
-/** Expand only explicitly selected entries and their members, in stable depth-first order. */
-export function resolveArtifactScope(definitions, ids, inputs) {
-    validateArtifactDefinitions(definitions);
-    const artifacts = [], artifactGroups = [];
-    const visited = new Set();
-    const visit = (id) => {
-        if (!Object.hasOwn(definitions, id))
-            throw new Error(`Unknown Artifact in review scope: ${id}`);
-        if (visited.has(id))
-            return;
-        visited.add(id);
-        const artifact = definitions[id];
-        if (isArtifactGroup(artifact)) {
-            artifactGroups.push({ id, members: [...artifact.members] });
-            for (const member of artifact.members)
-                visit(member);
-        }
-        else if (isGeneratedArtifact(artifact))
-            artifacts.push({ id, type: artifact.type, kind: 'generated', source: artifact.source, ...(inputs?.[id] ? { input: inputs[id] } : {}) });
-        else
-            artifacts.push({ id, type: artifact.type, path: artifact.path });
-    };
-    for (const id of ids)
-        visit(id);
-    return { artifacts, ...(artifactGroups.length ? { artifactGroups } : {}) };
-}
-/** Safe metadata for prompts and scope matching; captured data stays behind tools. */
-export function artifactReferenceMetadata(artifacts) {
-    return artifacts.map(artifact => artifact.kind === 'generated' ? { id: artifact.id, type: artifact.type, kind: 'generated', source: artifact.source } : { id: artifact.id, type: artifact.type, path: artifact.path });
-}
-//# sourceMappingURL=groups.js.map

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

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

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

@@ -1,38 +0,0 @@
-import { type ArtifactCallResult, type ArtifactToolDefinition, type ArtifactViewerOptions } from './index.js';
-export interface HumanToolDefinition extends Omit<ArtifactToolDefinition, 'operation' | 'annotations' | 'artifactId'> {
-    artifactId: string;
-    operation: 'read' | 'list' | 'command';
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-}
-export interface HumanLaunchResult {
-    kind: 'launch';
-    artifactId: string;
-    toolName: string;
-    launched: true;
-    message: string;
-}
-export type HumanToolResult = ArtifactCallResult | HumanLaunchResult;
-export interface HumanToolCheck {
-    toolName: string;
-    artifactId: string;
-    ok: boolean;
-    message: string;
-}
-export interface HumanArtifactTools {
-    readonly tools: HumanToolDefinition[];
-    validateArguments(name: string, args: unknown): Record<string, unknown>;
-    call(name: string, args?: unknown): Promise<HumanToolResult>;
-    preflight(options?: {
-        toolName?: string;
-    }): Promise<HumanToolCheck[]>;
-}
-export interface HumanArtifactToolsOptions extends ArtifactViewerOptions {
-    allowLegacy?: boolean;
-}
-/** Construct Human capabilities from the registered snapshot configuration; creating/listing never launches an app. */
-export declare function createHumanArtifactTools({ allowLegacy, ...options }: HumanArtifactToolsOptions): Promise<HumanArtifactTools>;

package/dist/src/artifacts/human.js

@@ -1,156 +0,0 @@
-import { constants } from 'node:fs';
-import { access, stat } from 'node:fs/promises';
-import { spawn } from 'node:child_process';
-import { delimiter, dirname, isAbsolute, join } from 'node:path';
-import { createArtifactViewer, createArtifactTools, validateToolArguments } from './index.js';
-import { artifactAudienceTools } from './types.js';
-function failure(code, message) { return Object.assign(new Error(message), { code }); }
-async function executablePath(command, signal) {
-    signal?.throwIfAborted();
-    const candidates = isAbsolute(command) ? [command] : (process.env.PATH ?? '').split(delimiter).filter(entry => isAbsolute(entry)).map(entry => join(entry, command));
-    for (const candidate of candidates) {
-        signal?.throwIfAborted();
-        try {
-            if (!(await stat(candidate)).isFile())
-                continue;
-            await access(candidate, constants.X_OK);
-            signal?.throwIfAborted();
-            return candidate;
-        }
-        catch {
-            signal?.throwIfAborted();
-        }
-    }
-    throw failure('HUMAN_TOOL_UNAVAILABLE', 'The registered Human tool executable is unavailable. Install it or update the registered type configuration.');
-}
-/** Do not forward Provider secrets as environment variables to desktop programs. */
-function desktopEnvironment() {
-    const keys = ['PATH', 'HOME', 'USER', 'LOGNAME', 'TMPDIR', 'TMP', 'TEMP', 'DISPLAY', 'WAYLAND_DISPLAY', 'XDG_RUNTIME_DIR', 'DBUS_SESSION_BUS_ADDRESS', 'LANG', 'LC_ALL', 'SYSTEMROOT', 'WINDIR'];
-    return Object.fromEntries(keys.flatMap(key => process.env[key] === undefined ? [] : [[key, process.env[key]]]));
-}
-/** Execute a trusted registered argv directly. Output and raw launch errors never leave this boundary. */
-function launch(command, args, cwd, timeoutMs, signal) {
-    return new Promise((resolve, reject) => {
-        if (signal?.aborted) {
-            reject(failure('ABORTED', 'Human tool execution was cancelled.'));
-            return;
-        }
-        const child = spawn(command, args, { cwd, env: desktopEnvironment(), shell: false, detached: process.platform !== 'win32', stdio: 'ignore', windowsHide: true });
-        let terminal = false;
-        let stopping;
-        let killTimer;
-        const kill = (sig) => { try {
-            if (process.platform !== 'win32' && child.pid)
-                process.kill(-child.pid, sig);
-            else
-                child.kill(sig);
-        }
-        catch { } };
-        const finish = (error) => {
-            if (terminal)
-                return;
-            terminal = true;
-            clearTimeout(timer);
-            clearTimeout(killTimer);
-            signal?.removeEventListener('abort', abort);
-            if (error)
-                reject(error);
-            else
-                resolve();
-        };
-        const stop = (error) => {
-            if (stopping || terminal)
-                return;
-            stopping = error;
-            kill('SIGTERM');
-            killTimer = setTimeout(() => { kill('SIGKILL'); finish(error); }, 500);
-            killTimer.unref();
-        };
-        const abort = () => stop(failure('ABORTED', 'Human tool execution was cancelled.'));
-        const timer = setTimeout(() => stop(failure('HUMAN_TOOL_TIMEOUT', `Human tool execution exceeded ${timeoutMs} ms.`)), timeoutMs);
-        timer.unref();
-        signal?.addEventListener('abort', abort, { once: true });
-        child.on('error', () => { if (stopping)
-            kill('SIGKILL'); finish(stopping ?? failure('HUMAN_TOOL_UNAVAILABLE', 'The registered Human tool could not be started.')); });
-        // The launcher may exit on SIGTERM while descendants ignore it. Kill the remaining
-        // group before clearing the escalation timer, including this early-close path.
-        child.on('close', code => { if (stopping)
-            kill('SIGKILL'); finish(stopping ?? (code === 0 ? undefined : failure('HUMAN_TOOL_FAILED', 'The registered Human tool did not finish successfully. Check the program and its registered arguments.'))); });
-        // The signal may have changed while creating the process and registering the listener.
-        if (signal?.aborted)
-            abort();
-    });
-}
-/** Construct Human capabilities from the registered snapshot configuration; creating/listing never launches an app. */
-export async function createHumanArtifactTools({ allowLegacy = false, ...options }) {
-    const viewer = await createArtifactViewer(options);
-    const builtins = createArtifactTools(viewer, { audience: 'human', allowLegacy });
-    const definitions = [];
-    const registered = new Map();
-    const insert = (definition, command) => {
-        if (registered.has(definition.name))
-            throw failure('ARTIFACT_TOOL_NAME_COLLISION', 'Registered Human tool names collide across Artifacts. Rename the tool or Artifact.');
-        definitions.push(definition);
-        registered.set(definition.name, { definition, ...(command ? { command } : {}) });
-    };
-    for (const tool of builtins.tools)
-        insert({ ...tool, artifactId: tool.artifactId, operation: tool.operation });
-    for (const artifact of viewer.listArtifacts()) {
-        const configured = artifactAudienceTools(viewer.getTypeDefinition(artifact.id), 'human', { allowLegacy });
-        for (const [key, tool] of Object.entries(configured)) {
-            if (!('command' in tool))
-                continue;
-            insert({
-                artifactId: artifact.id, operation: 'command', name: `${key}_${artifact.id}`,
-                description: tool.description.replaceAll('{artifactName}', () => artifact.id),
-                inputSchema: { type: 'object', properties: artifact.directory ? { path: { type: 'string', description: 'Optional relative path inside this Artifact. Omit to open the Artifact root.' } } : {}, additionalProperties: false },
-                annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
-            }, structuredClone(tool));
-        }
-    }
-    const entryFor = (name) => {
-        const entry = registered.get(name);
-        if (!entry)
-            throw failure('UNKNOWN_ARTIFACT_TOOL', 'Unknown registered Human artifact tool.');
-        return entry;
-    };
-    const validateArguments = (name, args) => validateToolArguments(entryFor(name).definition.inputSchema, args);
-    return {
-        get tools() { return structuredClone(definitions); },
-        validateArguments,
-        async call(name, args = {}) {
-            const { definition, command } = entryFor(name);
-            const actualArgs = structuredClone(validateArguments(name, args));
-            viewer.signal?.throwIfAborted();
-            if (!command)
-                return builtins.call(name, actualArgs);
-            const target = await viewer.resolveTarget(definition.artifactId, actualArgs.path);
-            const executable = await executablePath(command.command, viewer.signal);
-            await launch(executable, command.args.map(arg => arg === '{artifactPath}' ? target.absolutePath : arg), target.directory ? target.absolutePath : dirname(target.absolutePath), command.timeoutMs ?? 10_000, viewer.signal);
-            viewer.signal?.throwIfAborted();
-            return { kind: 'launch', artifactId: definition.artifactId, toolName: definition.name, launched: true, message: 'The registered program finished successfully. This does not confirm that a person read the Artifact or completed the review.' };
-        },
-        async preflight({ toolName } = {}) {
-            if (toolName !== undefined)
-                entryFor(toolName);
-            const checks = [];
-            for (const { definition, command } of registered.values()) {
-                if (toolName !== undefined && definition.name !== toolName)
-                    continue;
-                viewer.signal?.throwIfAborted();
-                try {
-                    await viewer.resolveTarget(definition.artifactId);
-                    if (command)
-                        await executablePath(command.command, viewer.signal);
-                    checks.push({ toolName: definition.name, artifactId: definition.artifactId, ok: true, message: command ? 'The registered executable and Artifact are available. No program was launched.' : 'The registered Viewer operation and Artifact are available.' });
-                }
-                catch {
-                    viewer.signal?.throwIfAborted();
-                    checks.push({ toolName: definition.name, artifactId: definition.artifactId, ok: false, message: 'The registered tool or Artifact is unavailable. Check the type configuration and installed program.' });
-                }
-            }
-            return checks;
-        },
-    };
-}
-//# sourceMappingURL=human.js.map

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

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

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

@@ -1,11 +0,0 @@
-import type { GeneratedArtifactDefinition, RepoConfig, ReviewEnvelope } from '../contracts.js';
-import type { ArtifactSourceContext, ArtifactSourceDefinition, ArtifactSourceMetadata, PreparedArtifactData } from '../tools/contracts.js';
-export declare function sourceMetadata(value: unknown): ArtifactSourceMetadata;
-/** One preparation binds the fingerprint and all possible observations to the same data. */
-export declare function captureArtifactData(source: ArtifactSourceDefinition, context: ArtifactSourceContext, purpose: 'inspect' | 'review'): Promise<PreparedArtifactData>;
-/** Reopening verifies serialized material without invoking source or identity callbacks. */
-export declare function assertPreparedArtifactData(input: unknown, metadata: ArtifactSourceMetadata): asserts input is PreparedArtifactData;
-export declare function preparedArtifact(config: RepoConfig, id: string, definition: GeneratedArtifactDefinition): PreparedArtifactData;
-export declare function assertGeneratedReviewInputs(request: Pick<ReviewEnvelope, 'artifacts' | 'configManifest'>): void;
-/** Only explicit current-input operations enter this preparation seam. */
-export declare function prepareArtifactInputs(config: RepoConfig, root: string, purpose: 'inspect' | 'review', signal?: AbortSignal): Promise<RepoConfig>;

package/dist/src/artifacts/sources.js

@@ -1,106 +0,0 @@
-import { isDeepStrictEqual } from 'node:util';
-import { canonicalData, dataHash } from './data.js';
-import { isGeneratedArtifact } from './groups.js';
-import { openToolHost } from '../tools/host.js';
-import { matchesToolManifest } from '../tools/manifest.js';
-const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
-const text = (value, limit = 200) => typeof value === 'string' && value.trim().length > 0 && value.length <= limit;
-export function sourceMetadata(value) {
-    if (!object(value) || Object.keys(value).some(key => !['identity', 'preparation', 'timeoutMs'].includes(key)) || !['read-only', 'explicit'].includes(String(value.preparation)))
-        throw new Error('Artifact sources require an explicit preparation policy.');
-    const identity = value.identity;
-    if (!object(identity) || Object.keys(identity).some(key => !['kind', 'namespace', 'version'].includes(key)) || !['canonical-data', 'immutable-revision', 'custom'].includes(String(identity.kind)) || !text(identity.namespace) || !text(identity.version))
-        throw new Error('Artifact identity requires a supported kind, namespace and version.');
-    if (value.timeoutMs !== undefined && (!Number.isInteger(value.timeoutMs) || Number(value.timeoutMs) < 1 || Number(value.timeoutMs) > 900000))
-        throw new Error('Artifact source timeoutMs must be 1–900000.');
-    return structuredClone(value);
-}
-/** One preparation binds the fingerprint and all possible observations to the same data. */
-export async function captureArtifactData(source, context, purpose) {
-    const metadata = sourceMetadata(source.metadata);
-    if (purpose === 'inspect' && metadata.preparation !== 'read-only')
-        throw Object.assign(new Error('This Artifact source requires explicit preparation through verification or tool diagnostics.'), { code: 'ARTIFACT_PREPARATION_REQUIRED' });
-    context.signal.throwIfAborted();
-    const result = await source.prepare(context);
-    if (!object(result) || !Object.hasOwn(result, 'data') || Object.keys(result).some(key => !['data', 'revision'].includes(key)))
-        throw new Error('Artifact preparation must return data and an optional immutable revision.');
-    const data = JSON.parse(canonicalData(result.data));
-    if (result.revision !== undefined && !text(result.revision, 4096))
-        throw new Error('An immutable revision must be a nonempty bounded string.');
-    const contentHash = dataHash(data);
-    let fingerprint = contentHash;
-    if (metadata.identity.kind === 'immutable-revision') {
-        if (!text(result.revision, 4096))
-            throw new Error('The immutable-revision strategy requires a source-scoped immutable revision.');
-        fingerprint = dataHash(result.revision);
-    }
-    else if (metadata.identity.kind === 'custom') {
-        if (!source.fingerprint)
-            throw new Error('A custom identity strategy requires fingerprint(data).');
-        const assertion = await source.fingerprint(structuredClone(data));
-        if (!text(assertion, 4096))
-            throw new Error('A custom fingerprint must be a nonempty bounded string.');
-        fingerprint = dataHash(assertion);
-    }
-    context.signal.throwIfAborted();
-    return { version: 1, identity: { ...metadata.identity, fingerprint }, contentHash, data, ...(result.revision === undefined ? {} : { revision: result.revision }) };
-}
-/** Reopening verifies serialized material without invoking source or identity callbacks. */
-export function assertPreparedArtifactData(input, metadata) {
-    const strategy = sourceMetadata(metadata).identity;
-    if (!object(input) || input.version !== 1 || Object.keys(input).some(key => !['version', 'identity', 'contentHash', 'data', 'revision'].includes(key)) || !object(input.identity))
-        throw new Error('Missing or unsupported generated Artifact snapshot.');
-    const { fingerprint, ...identity } = input.identity;
-    if (!isDeepStrictEqual(identity, strategy) || typeof fingerprint !== 'string' || !/^[a-f0-9]{64}$/.test(fingerprint) || input.contentHash !== dataHash(input.data))
-        throw new Error('Generated Artifact snapshot identity or content integrity does not match.');
-    if (input.revision !== undefined && !text(input.revision, 4096))
-        throw new Error('Invalid recorded immutable revision.');
-    if (strategy.kind === 'canonical-data' && fingerprint !== input.contentHash || strategy.kind === 'immutable-revision' && (!text(input.revision, 4096) || fingerprint !== dataHash(input.revision)))
-        throw new Error('Generated Artifact fingerprint does not match its recorded material.');
-}
-export function preparedArtifact(config, id, definition) {
-    const metadata = config.configManifest?.sources?.[definition.source];
-    if (!metadata)
-        throw new Error(`Missing registered Artifact source: ${definition.source}`);
-    const input = config.artifactInputs?.[id];
-    assertPreparedArtifactData(input, metadata);
-    return input;
-}
-export function assertGeneratedReviewInputs(request) {
-    for (const artifact of request.artifacts) {
-        if (artifact.kind !== 'generated')
-            continue;
-        const source = request.configManifest?.sources?.[artifact.source];
-        if (!source)
-            throw new Error('Missing recorded Artifact source.');
-        assertPreparedArtifactData(artifact.input, source);
-    }
-}
-/** Only explicit current-input operations enter this preparation seam. */
-export async function prepareArtifactInputs(config, root, purpose, signal) {
-    const generated = Object.entries(config.artifacts).filter((entry) => isGeneratedArtifact(entry[1]));
-    if (!generated.length)
-        return config;
-    const host = await openToolHost(root, signal);
-    try {
-        if (!config.configManifest || !matchesToolManifest(host.config, config.configManifest))
-            throw new Error('Artifact source definitions do not match the captured configuration.');
-        const artifactInputs = {};
-        for (const [id, definition] of generated) {
-            signal?.throwIfAborted();
-            const metadata = config.configManifest.sources?.[definition.source];
-            if (!metadata)
-                throw new Error(`Missing registered Artifact source: ${definition.source}`);
-            if (purpose === 'inspect' && metadata.preparation !== 'read-only')
-                throw Object.assign(new Error('This Artifact source requires explicit preparation through verification or tool diagnostics.'), { code: 'ARTIFACT_PREPARATION_REQUIRED' });
-            const input = await host.call({ action: 'prepare-artifact', artifactId: id, purpose }, metadata.timeoutMs ?? 120000);
-            assertPreparedArtifactData(input, metadata);
-            artifactInputs[id] = input;
-        }
-        return { ...config, artifactInputs };
-    }
-    finally {
-        await host.close();
-    }
-}
-//# sourceMappingURL=sources.js.map

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

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

package/dist/src/review/cli.d.ts

@@ -1,8 +0,0 @@
-type Output = {
-    write(value: string): unknown;
-};
-export declare function reviewMain(argv: string[], { stdout, stderr }?: {
-    stdout?: Output;
-    stderr?: Output;
-}): Promise<number>;
-export {};

package/dist/src/review/cli.js

@@ -1,136 +0,0 @@
-import { readFile, realpath } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { join, resolve } from 'node:path';
-import { within } from '../tools/paths.js';
-import { readStateContext } from '../broker/index.js';
-import { startReviewServer } from './server.js';
-import { claimRemoteReview, executeRemoteHumanTool, listRemoteReviews, showRemoteReview, submitRemoteHumanReview } from './client.js';
-const help = `Remote Human review
-
-  ccdd-project review serve --state-dir PATH --credentials-file PATH [--host HOST] [--port PORT]
-  ccdd-project review list --server URL --token-file PATH [--limit N] [--offset N]
-  ccdd-project review show REQUEST_ID --server URL --token-file PATH
-  ccdd-project review claim REQUEST_ID --server URL --token-file PATH [--cache-dir PATH]
-  ccdd-project review tool REQUEST_ID --tool NAME [--args JSON] --server URL --token-file PATH
-  ccdd-project review submit REQUEST_ID --result-file PATH --server URL --token-file PATH
-
-Claim reserves the request while downloading its fixed snapshot and checking the
-local environment. Failed preparation releases the reservation and keeps cached files.
-Tools run on this computer. Verdicts are submitted to the original Broker.
-Client state defaults to ~/.local/state/ccdd-reviewer; override with --cache-dir.
---timeout-ms sets each HTTP request budget (default 900000 ms), including file transfer.
-The server credentials file maps reviewer IDs to distinct random base64url tokens
-(at least 32 characters). Each client token file contains only its own token.
-Keep credential files outside reviewed projects. Use HTTPS or an authenticated
-tunnel when accessing a server across an untrusted network. The local monitor
-continues to listen only on loopback.
-`;
-function parse(argv) {
-    const options = {}, positional = [];
-    for (let index = 0; index < argv.length; index++) {
-        const arg = argv[index];
-        if (!arg.startsWith('--')) {
-            positional.push(arg);
-            continue;
-        }
-        if (Object.hasOwn(options, arg))
-            throw new Error(`Duplicate option: ${arg}`);
-        if (arg === '--help' || arg === '--json') {
-            options[arg] = 'true';
-            continue;
-        }
-        const value = argv[++index];
-        if (!value || value.startsWith('--'))
-            throw new Error(`${arg} requires a value.`);
-        options[arg] = value;
-    }
-    return { options, positional };
-}
-async function credentialFile(filename, source) {
-    const absolute = await realpath(resolve(filename));
-    if (source && within(source, absolute))
-        throw new Error('Reviewer credentials must stay outside the reviewed project.');
-    const value = await readFile(absolute, 'utf8');
-    if (Buffer.byteLength(value) > 65536)
-        throw new Error('Credential file exceeds 64 KiB.');
-    return value;
-}
-export async function reviewMain(argv, { stdout = process.stdout, stderr = process.stderr } = {}) {
-    const controller = new AbortController();
-    const interrupt = () => controller.abort(new Error('Review action cancelled.'));
-    process.once('SIGINT', interrupt);
-    process.once('SIGTERM', interrupt);
-    try {
-        const { options, positional } = parse(argv), [action, id] = positional;
-        if (!action || action === 'help' || options['--help']) {
-            stdout.write(help);
-            return 0;
-        }
-        if (!['serve', 'list', 'show', 'claim', 'tool', 'submit'].includes(action))
-            throw new Error('Use review serve, list, show, claim, tool, or submit.');
-        if (positional.length !== (['show', 'claim', 'tool', 'submit'].includes(action) ? 2 : 1))
-            throw new Error('Unexpected review command arguments.');
-        const allowed = new Set(['--json', ...(action === 'serve' ? ['--state-dir', '--credentials-file', '--host', '--port'] : ['--server', '--token-file', '--cache-dir', '--timeout-ms']),
-            ...(action === 'list' ? ['--limit', '--offset'] : []), ...(action === 'tool' ? ['--tool', '--args'] : []), ...(action === 'submit' ? ['--result-file'] : [])]);
-        for (const key of Object.keys(options))
-            if (!allowed.has(key))
-                throw new Error(`${key} is not supported by review ${action}.`);
-        const required = (key) => { if (!options[key])
-            throw new Error(`${key} is required.`); return options[key]; };
-        if (action === 'serve') {
-            const context = readStateContext(resolve(required('--state-dir')));
-            const reviewers = JSON.parse(await credentialFile(required('--credentials-file'), context.repoPath));
-            const server = await startReviewServer({ stateDir: context.stateDir, reviewers, host: options['--host'], port: options['--port'] === undefined ? undefined : Number(options['--port']) });
-            try {
-                stdout.write(JSON.stringify({ url: server.url }) + '\n');
-                if (!controller.signal.aborted)
-                    await new Promise(resolve => controller.signal.addEventListener('abort', () => resolve(), { once: true }));
-            }
-            finally {
-                await server.close();
-            }
-            return 0;
-        }
-        let phase = '';
-        const client = { server: required('--server'), token: (await credentialFile(required('--token-file'))).trim(),
-            stateDir: resolve(options['--cache-dir'] ?? join(homedir(), '.local', 'state', 'ccdd-reviewer')), signal: controller.signal,
-            timeoutMs: options['--timeout-ms'] === undefined ? undefined : Number(options['--timeout-ms']),
-            onProgress: event => {
-                if (options['--json'] || event.phase === phase)
-                    return;
-                phase = event.phase;
-                stderr.write(event.phase === 'download' ? 'Try Claim: preparing the snapshot and downloading missing files.\n' : event.phase === 'environment' ? 'Try Claim: checking the local review environment.\n' : 'Claim confirmed.\n');
-            },
-        };
-        let result;
-        if (action === 'list')
-            result = await listRemoteReviews(client, { limit: options['--limit'] === undefined ? undefined : Number(options['--limit']), offset: options['--offset'] === undefined ? undefined : Number(options['--offset']) });
-        else if (action === 'show')
-            result = await showRemoteReview(id, client);
-        else if (action === 'claim')
-            result = await claimRemoteReview(id, client);
-        else if (action === 'tool')
-            result = await executeRemoteHumanTool(id, required('--tool'), JSON.parse(options['--args'] ?? '{}'), client);
-        else {
-            const content = await readFile(resolve(required('--result-file')), 'utf8');
-            if (Buffer.byteLength(content) > 64 * 1024)
-                throw new Error('Result file exceeds 64 KiB.');
-            result = await submitRemoteHumanReview(id, JSON.parse(content), client);
-        }
-        stdout.write(JSON.stringify(result, null, 2) + '\n');
-        return 0;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        if (argv.includes('--json'))
-            stdout.write(JSON.stringify({ error: message }) + '\n');
-        else
-            stderr.write(message + '\n');
-        return 2;
-    }
-    finally {
-        process.off('SIGINT', interrupt);
-        process.off('SIGTERM', interrupt);
-    }
-}
-//# sourceMappingURL=cli.js.map

package/dist/src/review/cli.js.map

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