/** * validator.ac-pull — SDK tool that fetches a task's AC list plus current * binding status, so a Validator can see at a glance which ACs already have * coverage and which still need review. * * Returns the full AC roster with a derived `bindingStatus` field: * - `'satisfied'` — at least one `evidence_ac_bindings` row exists for the AC * - `'unsatisfied'` — no bindings exist for the AC * * Read-only — no auth gate. Any role may invoke (the data is non-sensitive * coverage metadata). * * @arch SDK Tool (Category B) — harness-agnostic, contracts-typed * @task T10511 * @epic T10383 (E-VALIDATOR-ROLE) * @saga T10377 (SG-IVTR-AC-BINDING) */ import type { RegisteredSdkTool } from '../task-tools/sdk-tool.js'; /** * Input envelope for the {@link validatorAcPull} SDK tool. * * @task T10511 */ export interface ValidatorAcPullInput { /** Absolute project root. */ projectRoot: string; /** Task ID to query — matches `tasks.id`. */ taskId: string; } /** * Per-AC row in the {@link ValidatorAcPullOutput.acs} array. * * @task T10511 */ export interface ValidatorAcRowView { /** Stable UUID — matches `task_acceptance_criteria.id`. */ id: string; /** Display alias — `AC`. */ alias: string; /** 1-based ordinal. */ ordinal: number; /** AC statement text. */ text: string; /** Derived: at least one binding exists OR not. */ bindingStatus: 'satisfied' | 'unsatisfied'; } /** * Output envelope for the {@link validatorAcPull} SDK tool. * * Discriminated by `ok`. On success, returns the task id and ordered AC * roster with binding status. On failure (e.g. unknown task id), returns * a structured error code + message. * * @task T10511 */ export type ValidatorAcPullOutput = { ok: true; taskId: string; acs: ValidatorAcRowView[]; } | { ok: false; code: string; message: string; }; /** * Registered SDK tool: validator.ac-pull. * * @example * ```typescript * const out = await validatorAcPull.invoke({ * projectRoot: '/mnt/projects/cleocode', * taskId: 'T1234', * }); * if (out.ok) { * for (const ac of out.acs) console.log(`${ac.alias}: ${ac.bindingStatus}`); * } * ``` * * @task T10511 */ export declare const validatorAcPull: RegisteredSdkTool>; //# sourceMappingURL=validator-ac-pull.d.ts.map