audit-tools 0.50.19 → 0.50.21

package/dist/audit/types/conceptualAdjudication.js

@@ -0,0 +1,298 @@
+import { unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+import { FindingSchema, isFileMissingError, laneAssetsDir, readJsonFile, readOptionalJsonFile, writeJsonFile, } from "audit-tools/shared";
+const PercentageSchema = z.number().finite().min(0).max(100);
+export const ConceptualRoundContributorSchema = z
+    .object({
+    contributor_id: z.string().min(1),
+    perspective: z.string().min(1),
+    lane_id: z.string().min(1),
+    prompt_path: z.string().min(1),
+    result_path: z.string().min(1),
+})
+    .strict();
+export const ConceptualReviewRoundManifestSchema = z
+    .object({
+    schema_version: z.literal(1),
+    mode: z.literal("deep"),
+    round_id: z.string().min(1),
+    perspectives: z.array(ConceptualRoundContributorSchema).min(1),
+    judge: z
+        .object({
+        contributor_id: z.string().min(1),
+        lane_id: z.string().min(1),
+        prompt_path: z.string().min(1),
+        result_path: z.string().min(1),
+    })
+        .strict(),
+})
+    .strict();
+export const CONCEPTUAL_REVIEW_ROUND_FILENAME = "conceptual-review-round.json";
+export function conceptualReviewRoundManifestPath(artifactsDir) {
+    return join(laneAssetsDir(artifactsDir), CONCEPTUAL_REVIEW_ROUND_FILENAME);
+}
+export async function writeConceptualReviewRoundManifest(artifactsDir, manifest) {
+    await writeJsonFile(conceptualReviewRoundManifestPath(artifactsDir), ConceptualReviewRoundManifestSchema.parse(manifest));
+}
+export async function readConceptualReviewRoundManifest(artifactsDir) {
+    const value = await readOptionalJsonFile(conceptualReviewRoundManifestPath(artifactsDir));
+    return value === undefined
+        ? undefined
+        : ConceptualReviewRoundManifestSchema.parse(value);
+}
+export async function clearConceptualReviewRoundManifest(artifactsDir) {
+    try {
+        await unlink(conceptualReviewRoundManifestPath(artifactsDir));
+    }
+    catch (error) {
+        if (!isFileMissingError(error))
+            throw error;
+    }
+}
+export const ConceptualCandidateDispositionSchema = z
+    .object({
+    candidate_id: z.string().min(1),
+    contributor_id: z.string().min(1),
+    source_finding_id: z.string().min(1),
+    disposition: z.enum(["retained", "merged", "rejected"]),
+    target_final_finding_ids: z.array(z.string().min(1)),
+    modification_percent: PercentageSchema,
+    rationale: z.string().trim().min(1),
+})
+    .strict();
+export const ConceptualFinalFindingShareSchema = z
+    .object({
+    final_finding_id: z.string().min(1),
+    contributors: z
+        .array(z
+        .object({
+        contributor_id: z.string().min(1),
+        source_candidate_ids: z.array(z.string().min(1)),
+        contribution_percent: PercentageSchema,
+        rationale: z.string().trim().min(1),
+    })
+        .strict())
+        .min(1),
+})
+    .strict();
+export const ConceptualJudgeSubmissionSchema = z
+    .object({
+    round_id: z.string().min(1),
+    findings: z.array(FindingSchema),
+    candidate_dispositions: z.array(ConceptualCandidateDispositionSchema),
+    final_finding_shares: z.array(ConceptualFinalFindingShareSchema),
+})
+    .strict();
+export function conceptualCandidateId(contributorId, findingId) {
+    return `${contributorId}::${findingId}`;
+}
+function submissionFindings(value, path) {
+    const envelope = z
+        .union([
+        z.array(FindingSchema),
+        z.object({ findings: z.array(FindingSchema) }).passthrough(),
+    ])
+        .safeParse(value);
+    if (!envelope.success) {
+        throw new Error(`conceptual perspective result ${path} is not a valid findings array/envelope: ${envelope.error.message}`);
+    }
+    return Array.isArray(envelope.data)
+        ? envelope.data
+        : envelope.data.findings;
+}
+/**
+ * Read exactly the perspective result paths named by the current-round
+ * manifest. No directory scan is permitted: old round files may remain for
+ * provenance, but they are never candidates in a later adjudication.
+ */
+export async function loadConceptualPerspectiveFindings(manifestInput) {
+    const manifest = ConceptualReviewRoundManifestSchema.parse(manifestInput);
+    const out = new Map();
+    for (const contributor of manifest.perspectives) {
+        if (out.has(contributor.contributor_id)) {
+            throw new Error(`duplicate contributor ${contributor.contributor_id}`);
+        }
+        const value = await readJsonFile(contributor.result_path);
+        out.set(contributor.contributor_id, submissionFindings(value, contributor.result_path));
+    }
+    return out;
+}
+function fail(message) {
+    throw new Error(`invalid conceptual adjudication: ${message}`);
+}
+/**
+ * Apply semantic invariants a schema alone cannot express. Percentages remain
+ * judge-authored estimates; tooling verifies references, completeness, and
+ * arithmetic rather than pretending to derive semantic credit mechanically.
+ */
+export function buildConceptualReviewAdjudication(params) {
+    const manifest = ConceptualReviewRoundManifestSchema.parse(params.manifest);
+    const submission = ConceptualJudgeSubmissionSchema.parse(params.submission);
+    if (submission.round_id !== manifest.round_id) {
+        fail(`stale round ${submission.round_id}; expected current round ${manifest.round_id}`);
+    }
+    const perspectiveIds = new Set();
+    for (const contributor of manifest.perspectives) {
+        if (perspectiveIds.has(contributor.contributor_id)) {
+            fail(`duplicate contributor ${contributor.contributor_id}`);
+        }
+        perspectiveIds.add(contributor.contributor_id);
+    }
+    if (perspectiveIds.has(manifest.judge.contributor_id)) {
+        fail(`judge contributor duplicates perspective ${manifest.judge.contributor_id}`);
+    }
+    const expectedCandidates = new Map();
+    for (const contributor of manifest.perspectives) {
+        const findings = params.perspectiveFindings.get(contributor.contributor_id);
+        if (!findings) {
+            fail(`missing perspective findings for ${contributor.contributor_id}`);
+        }
+        const seenFindingIds = new Set();
+        for (const finding of findings) {
+            if (seenFindingIds.has(finding.id)) {
+                fail(`duplicate source finding ${finding.id} from contributor ${contributor.contributor_id}`);
+            }
+            seenFindingIds.add(finding.id);
+            const id = conceptualCandidateId(contributor.contributor_id, finding.id);
+            expectedCandidates.set(id, {
+                contributorId: contributor.contributor_id,
+                findingId: finding.id,
+            });
+        }
+    }
+    const finalIds = new Set(submission.findings.map((finding) => finding.id));
+    if (finalIds.size !== submission.findings.length) {
+        fail("duplicate final finding id");
+    }
+    const dispositions = new Map();
+    for (const disposition of submission.candidate_dispositions) {
+        if (dispositions.has(disposition.candidate_id)) {
+            fail(`duplicate candidate disposition ${disposition.candidate_id}`);
+        }
+        dispositions.set(disposition.candidate_id, disposition);
+        const expected = expectedCandidates.get(disposition.candidate_id);
+        if (!expected) {
+            fail(`unknown candidate ${disposition.candidate_id}`);
+        }
+        if (disposition.contributor_id !== expected.contributorId ||
+            disposition.source_finding_id !== expected.findingId ||
+            disposition.candidate_id !==
+                conceptualCandidateId(disposition.contributor_id, disposition.source_finding_id)) {
+            fail(`candidate identity mismatch ${disposition.candidate_id}`);
+        }
+        for (const finalId of disposition.target_final_finding_ids) {
+            if (!finalIds.has(finalId)) {
+                fail(`unknown final finding ${finalId}`);
+            }
+        }
+        if (disposition.disposition === "rejected" &&
+            disposition.target_final_finding_ids.length > 0) {
+            fail(`rejected candidate ${disposition.candidate_id} maps to a final finding`);
+        }
+        if (disposition.disposition !== "rejected" &&
+            disposition.target_final_finding_ids.length === 0) {
+            fail(`${disposition.disposition} candidate ${disposition.candidate_id} has no final finding`);
+        }
+    }
+    for (const expectedId of expectedCandidates.keys()) {
+        if (!dispositions.has(expectedId)) {
+            fail(`missing candidate disposition ${expectedId}`);
+        }
+    }
+    const shareByFinal = new Map();
+    const citedShareEdges = new Set();
+    for (const finalShare of submission.final_finding_shares) {
+        if (!finalIds.has(finalShare.final_finding_id)) {
+            fail(`unknown final finding ${finalShare.final_finding_id}`);
+        }
+        if (shareByFinal.has(finalShare.final_finding_id)) {
+            fail(`duplicate final finding share ${finalShare.final_finding_id}`);
+        }
+        shareByFinal.set(finalShare.final_finding_id, finalShare);
+        const seenContributors = new Set();
+        let judgeShares = 0;
+        let total = 0;
+        for (const share of finalShare.contributors) {
+            if (seenContributors.has(share.contributor_id)) {
+                fail(`duplicate contributor ${share.contributor_id} for final finding ${finalShare.final_finding_id}`);
+            }
+            seenContributors.add(share.contributor_id);
+            total += share.contribution_percent;
+            if (share.contributor_id === manifest.judge.contributor_id) {
+                judgeShares += 1;
+                if (share.source_candidate_ids.length > 0) {
+                    fail(`judge share for ${finalShare.final_finding_id} references source candidates`);
+                }
+                continue;
+            }
+            if (!perspectiveIds.has(share.contributor_id)) {
+                fail(`unknown contributor ${share.contributor_id}`);
+            }
+            if (share.source_candidate_ids.length === 0) {
+                fail(`perspective share ${share.contributor_id} for ${finalShare.final_finding_id} has no source candidate`);
+            }
+            for (const candidateId of share.source_candidate_ids) {
+                const edgeId = `${candidateId}\u0000${finalShare.final_finding_id}`;
+                if (citedShareEdges.has(edgeId)) {
+                    fail(`candidate ${candidateId} is cited more than once for final finding ${finalShare.final_finding_id}`);
+                }
+                citedShareEdges.add(edgeId);
+                const candidate = dispositions.get(candidateId);
+                if (!candidate)
+                    fail(`unknown candidate ${candidateId}`);
+                if (candidate.contributor_id !== share.contributor_id) {
+                    fail(`candidate ${candidateId} belongs to another contributor`);
+                }
+                if (!candidate.target_final_finding_ids.includes(finalShare.final_finding_id)) {
+                    fail(`candidate ${candidateId} does not target final finding ${finalShare.final_finding_id}`);
+                }
+            }
+        }
+        if (judgeShares !== 1) {
+            fail(`final finding ${finalShare.final_finding_id} requires exactly one judge share`);
+        }
+        if (Math.abs(total - 100) > Number.EPSILON) {
+            fail(`contribution shares for ${finalShare.final_finding_id} must total 100 (got ${total})`);
+        }
+    }
+    for (const finalId of finalIds) {
+        if (!shareByFinal.has(finalId)) {
+            fail(`missing final finding share ${finalId}`);
+        }
+    }
+    for (const disposition of dispositions.values()) {
+        if (disposition.disposition === "rejected")
+            continue;
+        for (const finalId of disposition.target_final_finding_ids) {
+            if (!citedShareEdges.has(`${disposition.candidate_id}\u0000${finalId}`)) {
+                fail(`${disposition.disposition} candidate ${disposition.candidate_id} is not cited by final finding ${finalId}`);
+            }
+        }
+    }
+    return {
+        schema_version: 1,
+        generated_at: params.generatedAt,
+        round_id: manifest.round_id,
+        contributors: [
+            ...manifest.perspectives.map((contributor) => ({
+                contributor_id: contributor.contributor_id,
+                role: "perspective",
+                perspective: contributor.perspective,
+                lane_id: contributor.lane_id,
+                prompt_path: contributor.prompt_path,
+                result_path: contributor.result_path,
+            })),
+            {
+                contributor_id: manifest.judge.contributor_id,
+                role: "judge",
+                lane_id: manifest.judge.lane_id,
+                prompt_path: manifest.judge.prompt_path,
+                result_path: manifest.judge.result_path,
+            },
+        ],
+        candidate_dispositions: submission.candidate_dispositions,
+        final_finding_shares: submission.final_finding_shares,
+    };
+}
+//# sourceMappingURL=conceptualAdjudication.js.map

package/dist/audit/types/conceptualAdjudication.js.map

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

package/opencode.json

@@ -8,9 +8,9 @@
     "grep": "allow",
     "edit": {
       "*": "ask",
-      ".remediate-code/**": "allow",
-      ".audit-tools/**": "allow",
       ".audit-code/**": "allow",
+      ".audit-tools/**": "allow",
+      ".remediate-code/**": "allow",
       ".audit-artifacts/**": "allow",
       "audit-report.md": "allow"
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "audit-tools",
-  "version": "0.50.19",
+  "version": "0.50.21",
   "private": false,
   "license": "ISC",
   "description": "Provider-neutral code auditing and remediation workflows for arbitrary repositories.",

package/skills/audit-code/audit-code.prompt.md

@@ -42,7 +42,17 @@ catalog, or state files unless the current prompt directs you to them.
 
 When the prompt emits semantic review items, assign them with the host's native
 subagent facilities when available. Do not send provider, model, quota,
-context-window, routing, or launch configuration to audit-tools. Write the
+context-window, routing, or launch configuration to audit-tools. Before treating
+the run as comprehensive, perform a host-side structural-capability preflight:
+confirm the host can inspect the structural graph/relationships and source
+structure required by the workload. This is a host capability check, not an
+audit-tools MCP/provider or lane-selection step. If capability is degraded but
+you proceed, record one reserved AgentReflection with task_id exactly
+`audit-capability-preflight`; use severity `high` or `critical` when material to
+claimed coverage, with concrete `tool_friction`, `ambiguities`, and `suggestions`
+details. A structurally incapable run must not be labelled comprehensive. Keep
+the conversation-first flow and loader contract; do not add provider, routing,
+model, or machine-capability fields to audit-tools. Write the
 prompt-bound result artifacts exactly where requested and let the next backend
 step validate and ingest them.