@fitlab-ai/agent-infra 0.9.3 → 0.9.5

package/dist/lib/process-data/sources.js

@@ -0,0 +1,345 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createGitHubClient } from '../platform/github-client.js';
+import { enumerateAllTaskDirs } from '../task/resolve-ref.js';
+import { captureText, inspectPrivacy, redactExcerpt } from './privacy.js';
+import { canonicalJsonBytes, sha256 } from './store.js';
+function endpointForPage(endpoint, page, perPage) {
+    const parsed = new URL(endpoint, 'https://api.github.invalid/');
+    if (parsed.searchParams.has('page') || parsed.searchParams.has('per_page')) {
+        throw new Error('endpoint must not predefine page or per_page');
+    }
+    parsed.searchParams.set('per_page', String(perPage));
+    parsed.searchParams.set('page', String(page));
+    return `${parsed.pathname.replace(/^\//, '')}${parsed.search}`;
+}
+function fetchRestCollection(options) {
+    const perPage = options.perPage ?? 100;
+    if (!Number.isInteger(perPage) || perPage < 1 || perPage > 100) {
+        return { ok: false, error: { code: 'PAGINATION_INVALID', message: 'perPage must be between 1 and 100' } };
+    }
+    let pageIndex = 1;
+    let previousHash = null;
+    const identities = new Set();
+    const items = [];
+    const pages = [];
+    while (true) {
+        let url;
+        try {
+            url = endpointForPage(options.endpoint, pageIndex, perPage);
+        }
+        catch (error) {
+            return { ok: false, error: { code: 'PAGINATION_INVALID', message: String(error) } };
+        }
+        const response = options.client.json(['api', url]);
+        if (!response.ok)
+            return { ok: false, error: response.error };
+        if (!Array.isArray(response.value) || response.value.length > perPage) {
+            return {
+                ok: false,
+                error: { code: 'INVALID_PLATFORM_RESPONSE', message: `GitHub page ${pageIndex} is not a valid array page` }
+            };
+        }
+        let selected;
+        try {
+            selected = response.value.map((entry) => options.select ? options.select(entry) : entry);
+        }
+        catch (error) {
+            return { ok: false, error: { code: 'INVALID_PLATFORM_RESPONSE', message: String(error) } };
+        }
+        let bytes;
+        try {
+            bytes = canonicalJsonBytes(selected);
+        }
+        catch (error) {
+            return { ok: false, error: { code: 'INVALID_PLATFORM_RESPONSE', message: String(error) } };
+        }
+        const canonicalSha256 = sha256(bytes);
+        if (previousHash === canonicalSha256 && response.value.length > 0) {
+            return {
+                ok: false,
+                error: { code: 'PAGINATION_UNSTABLE', message: `GitHub page ${pageIndex} repeats the previous page` }
+            };
+        }
+        for (const entry of selected) {
+            const identity = options.identify(entry);
+            if (!identity || identities.has(identity)) {
+                return {
+                    ok: false,
+                    error: { code: 'PAGINATION_UNSTABLE', message: `duplicate or empty identity on page ${pageIndex}` }
+                };
+            }
+            identities.add(identity);
+            items.push(entry);
+        }
+        pages.push({ evidence: { index: pageIndex, itemCount: response.value.length, canonicalSha256 }, bytes });
+        previousHash = canonicalSha256;
+        if (response.value.length < perPage)
+            break;
+        pageIndex += 1;
+    }
+    const evidence = {
+        endpoint: options.endpoint,
+        requestCount: pages.length,
+        dataPageCount: pages.filter((page) => page.evidence.itemCount > 0).length,
+        itemCount: items.length,
+        termination: 'short-page',
+        pages: pages.map((page) => page.evidence)
+    };
+    return {
+        ok: true,
+        value: {
+            items,
+            evidence,
+            pageObjects: pages.map((page) => ({
+                sourceKind: 'github-rest',
+                sourceIdentity: `${options.endpoint}#page=${page.evidence.index}`,
+                sha256: page.evidence.canonicalSha256,
+                bytes: page.bytes.length,
+                content: page.bytes.toString('utf8'),
+                disposition: { state: 'included' }
+            }))
+        }
+    };
+}
+function relativeIdentity(repoRoot, filePath) {
+    const relative = path.relative(repoRoot, filePath);
+    if (!relative || relative.startsWith('..') || path.isAbsolute(relative))
+        throw new Error(`path escapes repository: ${filePath}`);
+    return relative.split(path.sep).join('/');
+}
+function readStableFile(repoRoot, filePath, sourceKind) {
+    const before = fs.lstatSync(filePath);
+    if (!before.isFile() || before.isSymbolicLink())
+        throw new Error(`unsafe source file: ${filePath}`);
+    const content = fs.readFileSync(filePath, 'utf8');
+    const after = fs.lstatSync(filePath);
+    if (before.dev !== after.dev || before.ino !== after.ino || before.size !== after.size || before.mtimeMs !== after.mtimeMs) {
+        throw new Error(`source changed while reading: ${filePath}`);
+    }
+    return captureText(sourceKind, relativeIdentity(repoRoot, filePath), content);
+}
+function listFiles(directory) {
+    if (!fs.existsSync(directory))
+        return [];
+    const output = [];
+    const walk = (current) => {
+        for (const entry of fs.readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+            const candidate = path.join(current, entry.name);
+            if (entry.isSymbolicLink())
+                throw new Error(`symlink source is not allowed: ${candidate}`);
+            if (entry.isDirectory())
+                walk(candidate);
+            else if (entry.isFile())
+                output.push(candidate);
+        }
+    };
+    walk(directory);
+    return output;
+}
+function structuredReceipt(repoRoot, filePath) {
+    const raw = readStableFile(repoRoot, filePath, 'structured-telemetry');
+    if (!raw.content)
+        return raw;
+    try {
+        const parsed = JSON.parse(raw.content);
+        const fields = ['client', 'model', 'reasoning', 'stage', 'toolCategory', 'time', 'status', 'retry', 'error', 'fallback'];
+        const selected = Object.fromEntries(fields.filter((field) => parsed[field] !== undefined).map((field) => [field, jsonClone(parsed[field])]));
+        selected.sourceSha256 = raw.sha256;
+        return captureText('structured-telemetry', raw.sourceIdentity, canonicalJsonBytes(selected).toString('utf8'));
+    }
+    catch {
+        return { ...raw, content: undefined, disposition: { state: 'unavailable', reason: 'invalid receipt JSON' } };
+    }
+}
+function unavailableLog(repoRoot, filePath, includeExcerpts) {
+    const raw = readStableFile(repoRoot, filePath, 'local-file');
+    if (raw.disposition?.state === 'excluded-sensitive')
+        return raw;
+    const recognizedBody = /\/(?:sessions?|tools?)(?:\/|[-_])/i.test(raw.sourceIdentity);
+    if (includeExcerpts && recognizedBody && raw.content) {
+        const excerpt = redactExcerpt(raw.content);
+        if (excerpt !== null)
+            return captureText('local-file', `${raw.sourceIdentity}#excerpt`, excerpt);
+    }
+    return {
+        sourceKind: 'local-file',
+        sourceIdentity: raw.sourceIdentity,
+        sha256: raw.sha256,
+        bytes: raw.bytes,
+        disposition: { state: 'unavailable', reason: recognizedBody ? 'body-excerpts-disabled' : 'unknown-log-format' }
+    };
+}
+function collectLocalObjects(repoRoot, options = {}) {
+    try {
+        const objects = [];
+        for (const task of enumerateAllTaskDirs(repoRoot)) {
+            for (const filePath of listFiles(task.taskDir)) {
+                if (!/\.(?:md|json)$/i.test(filePath))
+                    continue;
+                objects.push(readStableFile(repoRoot, filePath, 'local-file'));
+            }
+        }
+        const logsRoot = path.join(repoRoot, '.agents', 'workspace', 'logs');
+        for (const filePath of listFiles(logsRoot)) {
+            if (!/\.(?:md|json)$/i.test(filePath))
+                continue;
+            const identity = relativeIdentity(repoRoot, filePath);
+            if (/\/entropy-check\/.*\.md$/i.test(identity)) {
+                objects.push(readStableFile(repoRoot, filePath, 'operational-report'));
+            }
+            else if (/\/(?:delegation|orchestration)(?:\/|[-_]).*\.json$/i.test(identity)) {
+                objects.push(structuredReceipt(repoRoot, filePath));
+            }
+            else {
+                objects.push(unavailableLog(repoRoot, filePath, options.includeExcerpts === true));
+            }
+        }
+        return { ok: true, value: objects.sort((a, b) => a.sourceIdentity.localeCompare(b.sourceIdentity)) };
+    }
+    catch (error) {
+        return { ok: false, error: { code: 'LOCAL_SOURCE_UNSTABLE', message: error instanceof Error ? error.message : String(error) } };
+    }
+}
+function githubIdentity(item) {
+    if (!item || typeof item !== 'object')
+        return '';
+    const record = item;
+    for (const key of ['id', 'node_id', 'sha', 'number']) {
+        if (typeof record[key] === 'string' || typeof record[key] === 'number')
+            return `${key}:${String(record[key])}`;
+    }
+    return '';
+}
+function jsonClone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function projectFields(value, fields) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const record = value;
+    return Object.fromEntries(fields.filter((field) => record[field] !== undefined).map((field) => [field, jsonClone(record[field])]));
+}
+function projectSensitiveText(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const disposition = inspectPrivacy(value);
+    return disposition.state === 'included'
+        ? value
+        : { state: 'unavailable', reason: 'privacy-excluded', ruleId: disposition.ruleId, sha256: sha256(value) };
+}
+function projectGitHubItem(item) {
+    if (!item || typeof item !== 'object' || Array.isArray(item))
+        throw new Error('GitHub item must be an object');
+    const source = item;
+    const output = {};
+    const scalarFields = [
+        'id', 'node_id', 'number', 'html_url', 'url', 'state', 'title', 'created_at', 'updated_at', 'closed_at',
+        'merged_at', 'review_state', 'commit_id', 'sha', 'merge_commit_sha', 'milestone'
+    ];
+    for (const field of scalarFields) {
+        if (source[field] !== undefined)
+            output[field] = jsonClone(source[field]);
+    }
+    for (const field of ['user', 'head', 'base', 'author', 'committer']) {
+        const projected = projectFields(source[field], ['id', 'login', 'sha', 'ref']);
+        if (projected)
+            output[field] = projected;
+    }
+    for (const field of ['labels', 'assignees']) {
+        if (Array.isArray(source[field]))
+            output[field] = jsonClone(source[field]);
+    }
+    for (const field of ['body', 'message']) {
+        const projected = projectSensitiveText(source[field]);
+        if (projected !== undefined)
+            output[field] = projected;
+    }
+    if (Array.isArray(source.parents)) {
+        output.parents = source.parents.flatMap((parent) => {
+            const projected = projectFields(parent, ['sha']);
+            return projected ? [projected] : [];
+        });
+    }
+    const commit = projectFields(source.commit, []);
+    if (commit) {
+        const sourceCommit = source.commit;
+        const projectedCommit = {};
+        const message = projectSensitiveText(sourceCommit.message);
+        if (message !== undefined)
+            projectedCommit.message = message;
+        const tree = projectFields(sourceCommit.tree, ['sha']);
+        if (tree)
+            projectedCommit.tree = tree;
+        for (const field of ['author', 'committer']) {
+            const actor = projectFields(sourceCommit[field], ['name', 'email', 'date']);
+            if (actor)
+                projectedCommit[field] = actor;
+        }
+        output.commit = projectedCommit;
+    }
+    return output;
+}
+function collectGitHubObjects(repoRoot, client = createGitHubClient()) {
+    const repoResult = client.json(['repo', 'view', '--json', 'nameWithOwner'], { cwd: repoRoot });
+    if (!repoResult.ok)
+        return { ok: false, error: repoResult.error };
+    const repository = repoResult.value.nameWithOwner;
+    if (!repository || !/^[^/]+\/[^/]+$/.test(repository)) {
+        return { ok: false, error: { code: 'INVALID_PLATFORM_RESPONSE', message: 'GitHub repository identity is missing' } };
+    }
+    const objects = [];
+    const evidence = [];
+    const captureEndpoint = (endpoint) => {
+        const result = fetchRestCollection({
+            client,
+            endpoint,
+            identify: githubIdentity,
+            select: (item) => projectGitHubItem(item)
+        });
+        if (!result.ok)
+            return result;
+        objects.push(...result.value.pageObjects);
+        evidence.push(result.value.evidence);
+        return result;
+    };
+    const issues = captureEndpoint(`repos/${repository}/issues?state=all&sort=created&direction=asc`);
+    if (!issues.ok)
+        return issues;
+    const pulls = captureEndpoint(`repos/${repository}/pulls?state=all&sort=created&direction=asc`);
+    if (!pulls.ok)
+        return pulls;
+    for (const issue of issues.value.items) {
+        const number = issue.number;
+        if (typeof number !== 'number')
+            return { ok: false, error: { code: 'INVALID_PLATFORM_RESPONSE', message: 'Issue number is missing' } };
+        const comments = captureEndpoint(`repos/${repository}/issues/${number}/comments`);
+        if (!comments.ok)
+            return comments;
+    }
+    for (const pull of pulls.value.items) {
+        const record = pull;
+        const number = record.number;
+        const head = record.head;
+        const headSha = head?.sha;
+        if (typeof number !== 'number' || typeof headSha !== 'string') {
+            return { ok: false, error: { code: 'INVALID_PLATFORM_RESPONSE', message: 'Pull request identity or head SHA is missing' } };
+        }
+        for (const suffix of ['comments', 'reviews', 'commits']) {
+            const nested = captureEndpoint(`repos/${repository}/pulls/${number}/${suffix}`);
+            if (!nested.ok)
+                return nested;
+        }
+        const current = client.json(['api', `repos/${repository}/pulls/${number}`]);
+        if (!current.ok)
+            return { ok: false, error: current.error };
+        const projected = projectGitHubItem(current.value);
+        const currentHead = projected.head;
+        if (currentHead?.sha !== headSha) {
+            return { ok: false, error: { code: 'SOURCE_DRIFT', message: `Pull request ${number} head changed during capture` } };
+        }
+    }
+    return { ok: true, value: { repository, objects, endpoints: evidence } };
+}
+export { collectGitHubObjects, collectLocalObjects, fetchRestCollection, projectGitHubItem };
+//# sourceMappingURL=sources.js.map

package/dist/lib/process-data/store.js

@@ -0,0 +1,282 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+function sha256(bytes) {
+    return crypto.createHash('sha256').update(bytes).digest('hex');
+}
+function compareCodePoints(left, right) {
+    const a = Array.from(left, (char) => char.codePointAt(0));
+    const b = Array.from(right, (char) => char.codePointAt(0));
+    for (let index = 0; index < Math.min(a.length, b.length); index += 1) {
+        if (a[index] !== b[index])
+            return a[index] - b[index];
+    }
+    return a.length - b.length;
+}
+function canonicalString(value, seen) {
+    if (value === null || typeof value === 'boolean' || typeof value === 'string') {
+        return JSON.stringify(value);
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            throw new Error('canonical JSON accepts only finite JSON values');
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        if (seen.has(value))
+            throw new Error('canonical JSON accepts only acyclic JSON values');
+        seen.add(value);
+        const output = `[${value.map((entry) => canonicalString(entry, seen)).join(',')}]`;
+        seen.delete(value);
+        return output;
+    }
+    if (typeof value === 'object') {
+        if (seen.has(value))
+            throw new Error('canonical JSON accepts only acyclic JSON values');
+        seen.add(value);
+        const record = value;
+        const fields = Object.keys(record)
+            .sort(compareCodePoints)
+            .map((key) => `${JSON.stringify(key)}:${canonicalString(record[key], seen)}`);
+        seen.delete(value);
+        return `{${fields.join(',')}}`;
+    }
+    throw new Error('canonical JSON accepts only JSON values');
+}
+function canonicalJsonBytes(value) {
+    return Buffer.from(canonicalString(value, new Set()), 'utf8');
+}
+function ensurePrivateDirectory(directory) {
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    if (process.platform !== 'win32')
+        fs.chmodSync(directory, 0o700);
+}
+function writeExclusive(filePath, bytes) {
+    ensurePrivateDirectory(path.dirname(filePath));
+    try {
+        const fd = fs.openSync(filePath, 'wx', 0o600);
+        try {
+            fs.writeFileSync(fd, bytes);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        return true;
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST')
+            throw error;
+        return false;
+    }
+}
+function createObjectStore(root) {
+    const objectRoot = path.join(root, 'objects', 'sha256');
+    ensurePrivateDirectory(objectRoot);
+    return {
+        pathFor(digest) {
+            if (!/^[a-f0-9]{64}$/.test(digest))
+                throw new Error(`invalid SHA-256: ${digest}`);
+            return path.join(objectRoot, digest.slice(0, 2), digest);
+        },
+        put(bytes) {
+            const digest = sha256(bytes);
+            const objectPath = path.join(objectRoot, digest.slice(0, 2), digest);
+            const created = writeExclusive(objectPath, bytes);
+            const stored = fs.readFileSync(objectPath);
+            if (sha256(stored) !== digest)
+                throw new Error(`CAS hash mismatch for ${digest}`);
+            return { sha256: digest, path: objectPath, created };
+        }
+    };
+}
+function dispositionCounts(objects) {
+    const counts = { included: 0, 'excluded-sensitive': 0, unavailable: 0 };
+    for (const object of objects)
+        counts[object.disposition?.state ?? 'included'] += 1;
+    return counts;
+}
+function jsonLine(value) {
+    return `${canonicalJsonBytes(value).toString('utf8')}\n`;
+}
+function writePrivateFile(filePath, content) {
+    fs.writeFileSync(filePath, content, { mode: 0o600, flag: 'wx' });
+    if (process.platform !== 'win32')
+        fs.chmodSync(filePath, 0o600);
+}
+function manifestDigest(manifest) {
+    return sha256(canonicalJsonBytes(manifest));
+}
+function publishSnapshot(root, input) {
+    ensurePrivateDirectory(root);
+    ensurePrivateDirectory(path.join(root, 'repairs'));
+    const date = new Date(input.observedTo);
+    if (!Number.isFinite(date.getTime()))
+        throw new Error('observedTo must be an ISO timestamp');
+    const identity = {
+        scope: input.scope,
+        repository: input.repository,
+        observedFrom: input.observedFrom,
+        observedTo: input.observedTo,
+        objects: input.objects,
+        endpoints: input.endpoints,
+        excerptsEnabled: input.excerptsEnabled,
+        dispositionCounts: dispositionCounts(input.objects),
+        recordCount: input.records.length,
+        findingCount: input.quality.length,
+        repairCount: input.repairs.length
+    };
+    const identityDigest = sha256(canonicalJsonBytes(identity));
+    const stamp = input.observedTo.replace(/[-:]/g, '').replace(/\.\d{3}Z$/, 'Z');
+    const snapshotId = `${stamp}-${identityDigest.slice(0, 12)}`;
+    const partialManifest = {
+        schema: 'raw-manifest/v1',
+        snapshotId,
+        ...identity,
+        privacyPolicyVersion: 'process-data-privacy/v1'
+    };
+    const manifest = { ...partialManifest, manifestSha256: manifestDigest(partialManifest) };
+    const stagingRoot = path.join(root, '.staging');
+    ensurePrivateDirectory(stagingRoot);
+    const staging = fs.mkdtempSync(path.join(stagingRoot, `${snapshotId}-`));
+    if (process.platform !== 'win32')
+        fs.chmodSync(staging, 0o700);
+    try {
+        writePrivateFile(path.join(staging, 'manifest.json'), jsonLine(manifest));
+        writePrivateFile(path.join(staging, 'normalized.jsonl'), input.records.map((record) => jsonLine({ schema: 'normalized/v1', ...record })).join(''));
+        writePrivateFile(path.join(staging, 'quality.json'), jsonLine({ schema: 'quality/v1', findings: input.quality }));
+        writePrivateFile(path.join(staging, 'repair-manifest.jsonl'), input.repairs.map((repair) => jsonLine({ schema: 'repair/v1', ...repair })).join(''));
+        const destination = path.join(root, 'snapshots', String(date.getUTCFullYear()), String(date.getUTCMonth() + 1).padStart(2, '0'), String(date.getUTCDate()).padStart(2, '0'), snapshotId);
+        ensurePrivateDirectory(path.dirname(destination));
+        if (fs.existsSync(destination)) {
+            const existing = fs.readFileSync(path.join(destination, 'manifest.json'), 'utf8');
+            if (existing !== jsonLine(manifest))
+                throw new Error(`snapshot collision: ${snapshotId}`);
+            fs.rmSync(staging, { recursive: true, force: true });
+            return { snapshotId, path: destination, created: false };
+        }
+        fs.renameSync(staging, destination);
+        return { snapshotId, path: destination, created: true };
+    }
+    catch (error) {
+        fs.rmSync(staging, { recursive: true, force: true });
+        throw error;
+    }
+}
+function findSnapshot(root, snapshotId) {
+    const snapshotRoot = path.join(root, 'snapshots');
+    if (!fs.existsSync(snapshotRoot))
+        return null;
+    const stack = [snapshotRoot];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const candidate = path.join(current, entry.name);
+            if (entry.name === snapshotId && fs.existsSync(path.join(candidate, 'manifest.json')))
+                return candidate;
+            stack.push(candidate);
+        }
+    }
+    return null;
+}
+function verifySnapshot(root, snapshotId) {
+    const snapshotPath = findSnapshot(root, snapshotId);
+    if (!snapshotPath)
+        return { ok: false, snapshotId, snapshotPath: null, errors: ['snapshot not found'] };
+    const errors = [];
+    const checkMode = (target, expected, label) => {
+        if (process.platform === 'win32' || !fs.existsSync(target))
+            return;
+        const actual = fs.statSync(target).mode & 0o777;
+        if (actual !== expected)
+            errors.push(`${label} permission mismatch: expected ${expected.toString(8)}, got ${actual.toString(8)}`);
+    };
+    checkMode(snapshotPath, 0o700, 'snapshot directory');
+    for (const file of ['manifest.json', 'normalized.jsonl', 'quality.json', 'repair-manifest.jsonl']) {
+        checkMode(path.join(snapshotPath, file), 0o600, file);
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(fs.readFileSync(path.join(snapshotPath, 'manifest.json'), 'utf8'));
+    }
+    catch {
+        return { ok: false, snapshotId, snapshotPath, errors: ['manifest is invalid JSON'] };
+    }
+    if (manifest.schema !== 'raw-manifest/v1')
+        errors.push(`unsupported manifest schema: ${manifest.schema}`);
+    if (manifest.snapshotId !== snapshotId)
+        errors.push('snapshot identity mismatch');
+    if (typeof manifest.excerptsEnabled !== 'boolean')
+        errors.push('manifest excerpts opt-in is invalid');
+    if (!manifest.dispositionCounts || canonicalJsonBytes(manifest.dispositionCounts).toString('utf8') !== canonicalJsonBytes(dispositionCounts(manifest.objects)).toString('utf8')) {
+        errors.push('manifest disposition counts mismatch');
+    }
+    const { manifestSha256, ...partial } = manifest;
+    if (manifestDigest(partial) !== manifestSha256)
+        errors.push('manifest hash mismatch');
+    const store = createObjectStore(root);
+    try {
+        const lines = fs.readFileSync(path.join(snapshotPath, 'normalized.jsonl'), 'utf8').split('\n').filter(Boolean);
+        const ids = new Set();
+        for (const line of lines) {
+            const record = JSON.parse(line);
+            if (record.schema !== 'normalized/v1' || typeof record.recordId !== 'string') {
+                errors.push('normalized record schema is invalid');
+                continue;
+            }
+            if (ids.has(record.recordId))
+                errors.push(`duplicate normalized record: ${record.recordId}`);
+            ids.add(record.recordId);
+        }
+        if (lines.length !== manifest.recordCount)
+            errors.push('normalized record count mismatch');
+        const quality = JSON.parse(fs.readFileSync(path.join(snapshotPath, 'quality.json'), 'utf8'));
+        if (quality.schema !== 'quality/v1' || !Array.isArray(quality.findings))
+            errors.push('quality schema is invalid');
+        else if (quality.findings.length !== manifest.findingCount)
+            errors.push('quality finding count mismatch');
+        const repairLines = fs.readFileSync(path.join(snapshotPath, 'repair-manifest.jsonl'), 'utf8').split('\n').filter(Boolean);
+        for (const line of repairLines) {
+            const repair = JSON.parse(line);
+            if (repair.schema !== 'repair/v1' || typeof repair.repairId !== 'string')
+                errors.push('repair manifest schema is invalid');
+        }
+        if (repairLines.length !== manifest.repairCount)
+            errors.push('repair manifest count mismatch');
+    }
+    catch {
+        errors.push('snapshot derived files are missing or invalid');
+    }
+    for (const object of manifest.objects) {
+        if (object.disposition?.state && object.disposition.state !== 'included')
+            continue;
+        try {
+            const objectPath = store.pathFor(object.sha256);
+            checkMode(path.dirname(objectPath), 0o700, `object directory ${object.sha256.slice(0, 2)}`);
+            checkMode(objectPath, 0o600, `object ${object.sourceIdentity}`);
+            const bytes = fs.readFileSync(objectPath);
+            if (sha256(bytes) !== object.sha256)
+                errors.push(`object hash mismatch: ${object.sourceIdentity}`);
+            if (bytes.length !== object.bytes)
+                errors.push(`object byte count mismatch: ${object.sourceIdentity}`);
+        }
+        catch {
+            errors.push(`object missing: ${object.sourceIdentity}`);
+        }
+    }
+    for (const page of manifest.endpoints.flatMap((endpoint) => endpoint.pages)) {
+        try {
+            if (sha256(fs.readFileSync(store.pathFor(page.canonicalSha256))) !== page.canonicalSha256) {
+                errors.push(`page hash mismatch: ${page.index}`);
+            }
+        }
+        catch {
+            errors.push(`page object missing: ${page.canonicalSha256}`);
+        }
+    }
+    return { ok: errors.length === 0, snapshotId, snapshotPath, errors, manifest };
+}
+export { canonicalJsonBytes, createObjectStore, findSnapshot, publishSnapshot, sha256, verifySnapshot };
+//# sourceMappingURL=store.js.map

package/dist/lib/process-data/types.js

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

package/dist/lib/run/index.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { loadServerConfig } from '../server/config.js';
-import { resolveTaskBranch } from '../sandbox/task-resolver.js';
+import { resolveSandboxTarget } from '../sandbox/workspace-identity.js';
 import { createRunId, runInSandbox } from '../sandbox/capture.js';
 import { loadShortIdByTaskId, normalizeShortIdInput } from '../task/short-id.js';
 import { buildTuiCommand, renderPrompt, selectTui } from './tui.js';
@@ -101,7 +101,6 @@ function resolveActiveTaskIdentity(taskRef, repoRoot) {
     let resolvedTaskRef = taskRef;
     if (TASK_ID_RE.test(taskRef)) {
         taskId = taskRef;
-        resolvedTaskRef = loadShortIdByTaskId(repoRoot).get(taskId) ?? taskRef;
     }
     else {
         const normalized = normalizeShortIdInput(taskRef, { shortIdLength: readShortIdLength(repoRoot) });
@@ -165,7 +164,8 @@ export async function runSkill(args, options = {}) {
         return result.exitCode ?? (result.signal ? 1 : 0);
     }
     const repoRoot = options.repoRoot ?? config?.repoRoot ?? process.cwd();
-    const branch = resolveTaskBranch(parsed.taskRef, repoRoot);
+    const target = resolveSandboxTarget(parsed.taskRef, repoRoot);
+    const branch = target.branch;
     const identity = resolveActiveTaskIdentity(parsed.taskRef, repoRoot);
     const runId = identity ? createRunId() : undefined;
     const writeStdout = options.writeStdout ?? ((chunk) => process.stdout.write(chunk));
@@ -175,6 +175,7 @@ export async function runSkill(args, options = {}) {
     const result = await runSandbox({
         taskRef: parsed.taskRef,
         branch,
+        workspace: target.workspace,
         command,
         runId,
         recreate: parsed.recreate