yet-another-agentic-workflow 0.2.0

package/dist/parser.d.ts

@@ -0,0 +1,6 @@
+import type { ValidationResult } from "./types.js";
+export type DefinitionFormat = "yaml" | "json";
+export declare function parseProjectDefinition(source: string, format?: DefinitionFormat): unknown;
+export declare function validateProjectDefinition(value: unknown): ValidationResult;
+export declare function parseAndValidateProjectDefinition(source: string, format?: DefinitionFormat): ValidationResult;
+export declare function loadAndValidateProjectDefinition(filePath: string): Promise<ValidationResult>;

package/dist/parser.js

@@ -0,0 +1,166 @@
+import { readFile } from "node:fs/promises";
+import { extname } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { validateAgainstSchema } from "./schema.js";
+function inferFormat(filePath) {
+    return filePath && extname(filePath).toLowerCase() === ".json" ? "json" : "yaml";
+}
+export function parseProjectDefinition(source, format = "yaml") {
+    return format === "json" ? JSON.parse(source) : parseYaml(source);
+}
+function duplicateNameIssues(definition) {
+    const issues = [];
+    const collections = [
+        ["skills", definition.skills],
+        ["agents", definition.agents],
+        ["hooks", definition.hooks],
+        ["evals", definition.evals],
+        ["workflows", definition.workflows],
+        ["context", definition.context],
+        ["state", definition.state]
+    ];
+    for (const [collectionName, values] of collections) {
+        const seen = new Set();
+        values.forEach((value, index) => {
+            if (seen.has(value.name)) {
+                issues.push({
+                    path: `$.${collectionName}[${index}].name`,
+                    message: `duplicate ${collectionName} name '${value.name}'`,
+                    keyword: "semantic"
+                });
+            }
+            seen.add(value.name);
+        });
+    }
+    return issues;
+}
+function referenceIssues(definition) {
+    const issues = [];
+    const names = {
+        skill: new Set(definition.skills.map(({ name }) => name)),
+        agent: new Set(definition.agents.map(({ name }) => name)),
+        hook: new Set(definition.hooks.map(({ name }) => name)),
+        eval: new Set(definition.evals.map(({ name }) => name)),
+        workflow: new Set(definition.workflows.map(({ name }) => name)),
+        context: new Set(definition.context.map(({ name }) => name)),
+        state: new Set(definition.state.map(({ name }) => name))
+    };
+    definition.skills.forEach((skill, skillIndex) => {
+        for (const [dependencyIndex, dependency] of (skill.dependencies ?? []).entries()) {
+            if (!names.skill.has(dependency)) {
+                issues.push({
+                    path: `$.skills[${skillIndex}].dependencies[${dependencyIndex}]`,
+                    message: `unknown skill '${dependency}'`,
+                    keyword: "semantic"
+                });
+            }
+        }
+    });
+    definition.agents.forEach((agent, agentIndex) => {
+        for (const [skillIndex, skill] of (agent.skills ?? []).entries()) {
+            if (!names.skill.has(skill)) {
+                issues.push({
+                    path: `$.agents[${agentIndex}].skills[${skillIndex}]`,
+                    message: `unknown skill '${skill}'`,
+                    keyword: "semantic"
+                });
+            }
+        }
+        for (const [contextIndex, context] of (agent.context ?? []).entries()) {
+            if (!names.context.has(context)) {
+                issues.push({
+                    path: `$.agents[${agentIndex}].context[${contextIndex}]`,
+                    message: `unknown context '${context}'`,
+                    keyword: "semantic"
+                });
+            }
+        }
+    });
+    definition.workflows.forEach((workflow, workflowIndex) => {
+        const stepIds = new Set();
+        workflow.steps.forEach((step, stepIndex) => {
+            if (stepIds.has(step.id)) {
+                issues.push({
+                    path: `$.workflows[${workflowIndex}].steps[${stepIndex}].id`,
+                    message: `duplicate workflow step id '${step.id}'`,
+                    keyword: "semantic"
+                });
+            }
+            stepIds.add(step.id);
+        });
+        workflow.steps.forEach((step, stepIndex) => {
+            const [kind, name] = step.uses.split(":", 2);
+            if (!names[kind].has(name)) {
+                issues.push({
+                    path: `$.workflows[${workflowIndex}].steps[${stepIndex}].uses`,
+                    message: `unknown ${kind} '${name}'`,
+                    keyword: "semantic"
+                });
+            }
+            for (const [needIndex, need] of (step.needs ?? []).entries()) {
+                if (!stepIds.has(need)) {
+                    issues.push({
+                        path: `$.workflows[${workflowIndex}].steps[${stepIndex}].needs[${needIndex}]`,
+                        message: `unknown workflow step '${need}'`,
+                        keyword: "semantic"
+                    });
+                }
+                else if (need === step.id) {
+                    issues.push({
+                        path: `$.workflows[${workflowIndex}].steps[${stepIndex}].needs[${needIndex}]`,
+                        message: "a workflow step cannot depend on itself",
+                        keyword: "semantic"
+                    });
+                }
+            }
+        });
+    });
+    return issues;
+}
+export function validateProjectDefinition(value) {
+    const schemaIssues = validateAgainstSchema(value);
+    if (schemaIssues.length > 0) {
+        return { ok: false, issues: schemaIssues };
+    }
+    const definition = value;
+    const issues = [...duplicateNameIssues(definition), ...referenceIssues(definition)];
+    return issues.length === 0
+        ? { ok: true, value: definition, issues: [] }
+        : { ok: false, issues };
+}
+export function parseAndValidateProjectDefinition(source, format = "yaml") {
+    try {
+        return validateProjectDefinition(parseProjectDefinition(source, format));
+    }
+    catch (error) {
+        return {
+            ok: false,
+            issues: [
+                {
+                    path: "$",
+                    message: error instanceof Error ? error.message : String(error),
+                    keyword: "parse"
+                }
+            ]
+        };
+    }
+}
+export async function loadAndValidateProjectDefinition(filePath) {
+    try {
+        const source = await readFile(filePath, "utf8");
+        return parseAndValidateProjectDefinition(source, inferFormat(filePath));
+    }
+    catch (error) {
+        return {
+            ok: false,
+            issues: [
+                {
+                    path: filePath,
+                    message: error instanceof Error ? error.message : String(error),
+                    keyword: "parse"
+                }
+            ]
+        };
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/persistence.d.ts

@@ -0,0 +1,83 @@
+import type { FeatureInvocation } from "./feature.js";
+import type { IndependentReviews, ReviewAxis, ReviewSubmission } from "./review.js";
+export type WorkflowStatus = "active" | "completed";
+export interface PersistedSlice {
+    id: string;
+    title: string;
+    status: "pending" | "in-progress" | "completed";
+    acceptanceCriteria?: string[];
+}
+export interface VerificationRecord {
+    command: string;
+    output: string;
+    exitCode: number;
+    recordedAt: string;
+}
+export interface DecisionRecord {
+    decision: string;
+    rationale?: string;
+    recordedAt: string;
+}
+export interface HandoffRecord {
+    summary: string;
+    next: string | null;
+    updatedAt: string;
+}
+export interface WorkflowState {
+    version: 1;
+    workflow: string;
+    runId: string | null;
+    status: WorkflowStatus;
+    task: {
+        request: string;
+        startedAt: string;
+        updatedAt: string;
+    };
+    spec: string | null;
+    slices: PersistedSlice[];
+    dependencies: Record<string, string[]>;
+    progress: {
+        current: string | null;
+        completed: string[];
+        remaining: string[];
+    };
+    verification: VerificationRecord[];
+    reviews: IndependentReviews;
+    decisions: DecisionRecord[];
+    handoff: HandoffRecord | null;
+}
+export interface CheckpointUpdate {
+    spec?: string | null;
+    slices?: PersistedSlice[];
+    dependencies?: Record<string, string[]>;
+    verification?: Array<Omit<VerificationRecord, "recordedAt"> & {
+        recordedAt?: string;
+    }>;
+    reviews?: ReviewSubmission[];
+    decisions?: Array<Omit<DecisionRecord, "recordedAt"> & {
+        recordedAt?: string;
+    }>;
+    handoff?: Omit<HandoffRecord, "updatedAt"> & {
+        updatedAt?: string;
+    } | null;
+}
+export interface PersistedFeatureInvocation extends FeatureInvocation {
+    statePath: string;
+    state: WorkflowState;
+    resumed: boolean;
+}
+export declare class PersistenceError extends Error {
+    constructor(message: string);
+}
+export declare function loadWorkflowState(projectDirectory?: string): Promise<{
+    path: string;
+    state: WorkflowState;
+}>;
+/** Start the official workflow and atomically persist all resumable fields. */
+export declare function startFeatureWorkflow(request: string, projectDirectory?: string): Promise<PersistedFeatureInvocation>;
+/** Rebuild an invocation from durable state without relying on conversation history. */
+export declare function resumeFeatureWorkflow(projectDirectory?: string): Promise<PersistedFeatureInvocation>;
+/** Merge durable stage outputs and advance the workflow checkpoint atomically. */
+export declare function checkpointFeatureWorkflow(completedStage: string, update?: CheckpointUpdate, projectDirectory?: string): Promise<WorkflowState>;
+/** Record one independent reviewer result through its axis-specific checkpoint. */
+export declare function submitIndependentReview(axis: ReviewAxis, report: ReviewSubmission, projectDirectory?: string): Promise<WorkflowState>;

package/dist/persistence.js

@@ -0,0 +1,279 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { createFeatureInvocation } from "./feature.js";
+import { loadAndValidateProjectDefinition } from "./parser.js";
+import { finishWorkflowRun, recordWorkflowRunEvent, startWorkflowRun } from "./observability.js";
+import { assertIndependentReviewGate, createReviewRecord, ReviewError } from "./review.js";
+export class PersistenceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PersistenceError";
+    }
+}
+function now() {
+    return new Date().toISOString();
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function strings(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function validateState(value, path) {
+    if (!isRecord(value) || value.version !== 1 || typeof value.workflow !== "string") {
+        throw new PersistenceError(`${path} is not a YAAW workflow state file`);
+    }
+    if (value.status !== "active" && value.status !== "completed") {
+        throw new PersistenceError(`${path}: status must be 'active' or 'completed'`);
+    }
+    const task = value.task;
+    const progress = value.progress;
+    if (!isRecord(task) || typeof task.request !== "string" || typeof task.startedAt !== "string" || typeof task.updatedAt !== "string") {
+        throw new PersistenceError(`${path}: task is invalid`);
+    }
+    if (!isRecord(progress) || (progress.current !== null && typeof progress.current !== "string") || !strings(progress.completed) || !strings(progress.remaining)) {
+        throw new PersistenceError(`${path}: progress is invalid`);
+    }
+    const reviews = value.reviews === undefined
+        ? { spec: null, standards: null }
+        : value.reviews;
+    if (!(value.spec === null || typeof value.spec === "string") || !Array.isArray(value.slices) || !isRecord(value.dependencies) || !Array.isArray(value.verification) || !isRecord(reviews) || !(reviews.spec === null || isRecord(reviews.spec)) || !(reviews.standards === null || isRecord(reviews.standards)) || !Array.isArray(value.decisions) || !(value.handoff === null || isRecord(value.handoff))) {
+        throw new PersistenceError(`${path}: durable workflow fields are invalid`);
+    }
+    const runId = value.runId === undefined ? null : value.runId;
+    if (!(runId === null || typeof runId === "string")) {
+        throw new PersistenceError(`${path}: runId must be a string or null`);
+    }
+    return { ...value, runId, reviews };
+}
+async function statePathFor(root) {
+    const configPath = join(root, ".yaaw", "yaaw.yaml");
+    const validation = await loadAndValidateProjectDefinition(configPath);
+    if (!validation.ok) {
+        const details = validation.issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ");
+        throw new PersistenceError(`${configPath} is invalid: ${details}`);
+    }
+    const state = validation.value.state.find(({ name }) => name === "workflow") ?? validation.value.state[0];
+    if (!state)
+        throw new PersistenceError("the project does not define durable workflow state");
+    return resolve(root, state.path);
+}
+async function writeState(path, state) {
+    await mkdir(dirname(path), { recursive: true });
+    const temporary = `${path}.${process.pid}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+    await rename(temporary, path);
+}
+export async function loadWorkflowState(projectDirectory = ".") {
+    const root = resolve(projectDirectory);
+    const path = await statePathFor(root);
+    let source;
+    try {
+        source = await readFile(path, "utf8");
+    }
+    catch (error) {
+        const code = isRecord(error) ? error.code : undefined;
+        if (code === "ENOENT")
+            throw new PersistenceError(`no interrupted workflow exists at ${path}; start one with 'yaaw feature <request>'`);
+        throw error;
+    }
+    try {
+        return { path, state: validateState(JSON.parse(source), path) };
+    }
+    catch (error) {
+        if (error instanceof PersistenceError)
+            throw error;
+        throw new PersistenceError(`${path} contains invalid JSON`);
+    }
+}
+function initialState(invocation, timestamp, runId) {
+    return {
+        version: 1,
+        workflow: invocation.workflow,
+        runId,
+        status: "active",
+        task: { request: invocation.request, startedAt: timestamp, updatedAt: timestamp },
+        spec: null,
+        slices: [],
+        dependencies: Object.fromEntries(invocation.stages.map((stage) => [stage.id, [...stage.needs]])),
+        progress: {
+            current: invocation.order[0] ?? null,
+            completed: [],
+            remaining: [...invocation.order]
+        },
+        verification: [],
+        reviews: { spec: null, standards: null },
+        decisions: [],
+        handoff: null
+    };
+}
+/** Start the official workflow and atomically persist all resumable fields. */
+export async function startFeatureWorkflow(request, projectDirectory = ".") {
+    const root = resolve(projectDirectory);
+    const invocation = await createFeatureInvocation(request, root);
+    const statePath = await statePathFor(root);
+    const timestamp = now();
+    const run = await startWorkflowRun(invocation.workflow, request, root, { timestamp });
+    const state = initialState(invocation, timestamp, run.runId);
+    await writeState(statePath, state);
+    return { ...invocation, statePath, state, resumed: false };
+}
+function resumePrompt(invocation, state, stages) {
+    const persisted = JSON.stringify({
+        task: state.task,
+        spec: state.spec,
+        slices: state.slices,
+        dependencies: state.dependencies,
+        progress: state.progress,
+        verification: state.verification,
+        reviews: state.reviews,
+        decisions: state.decisions,
+        handoff: state.handoff
+    }, null, 2);
+    const stageText = stages.map((stage) => `## ${stage.id} (${stage.uses})\n\n${stage.instructions}`).join("\n\n");
+    return [
+        "# YAAW resumed feature workflow",
+        "",
+        `Request: ${invocation.request}`,
+        "",
+        "Continue from the durable record below. Preserve completed work, begin at progress.current, and execute only remaining stages. Update the state after every completed stage.",
+        "",
+        "## Durable record",
+        "",
+        "```json",
+        persisted,
+        "```",
+        "",
+        "## Remaining work",
+        "",
+        stageText || "No stages remain. The workflow is complete."
+    ].join("\n");
+}
+/** Rebuild an invocation from durable state without relying on conversation history. */
+export async function resumeFeatureWorkflow(projectDirectory = ".") {
+    const root = resolve(projectDirectory);
+    const { path, state } = await loadWorkflowState(root);
+    const invocation = await createFeatureInvocation(state.task.request, root);
+    if (state.workflow !== invocation.workflow) {
+        throw new PersistenceError(`state workflow '${state.workflow}' does not match '${invocation.workflow}'`);
+    }
+    const known = new Set(invocation.order);
+    if (state.progress.completed.some((stage) => !known.has(stage)) || state.progress.remaining.some((stage) => !known.has(stage))) {
+        throw new PersistenceError(`${path}: progress references a stage not present in the current workflow`);
+    }
+    const remainingSet = new Set(state.progress.remaining);
+    const stages = invocation.stages.filter(({ id }) => remainingSet.has(id));
+    return {
+        ...invocation,
+        order: stages.map(({ id }) => id),
+        parallelGroups: invocation.parallelGroups
+            .map((group) => group.filter((id) => remainingSet.has(id)))
+            .filter((group) => group.length > 1),
+        stages,
+        prompt: resumePrompt(invocation, state, stages),
+        statePath: path,
+        state,
+        resumed: true
+    };
+}
+/** Merge durable stage outputs and advance the workflow checkpoint atomically. */
+export async function checkpointFeatureWorkflow(completedStage, update = {}, projectDirectory = ".") {
+    const root = resolve(projectDirectory);
+    const { path, state } = await loadWorkflowState(root);
+    const invocation = await createFeatureInvocation(state.task.request, root);
+    if (!invocation.order.includes(completedStage))
+        throw new PersistenceError(`unknown workflow stage '${completedStage}'`);
+    const completed = new Set(state.progress.completed);
+    const retry = completed.has(completedStage);
+    const stage = invocation.stages.find(({ id }) => id === completedStage);
+    const unmet = stage.needs.filter((need) => !completed.has(need));
+    if (unmet.length)
+        throw new PersistenceError(`stage '${completedStage}' is blocked by: ${unmet.join(", ")}`);
+    completed.add(completedStage);
+    const completedInOrder = invocation.order.filter((id) => completed.has(id));
+    const remaining = invocation.order.filter((id) => !completed.has(id));
+    const timestamp = now();
+    const verification = update.verification?.map((record) => ({ ...record, recordedAt: record.recordedAt ?? timestamp }));
+    const reviewRecords = update.reviews?.map((report) => {
+        const axis = report.axis;
+        if (axis !== "spec" && axis !== "standards")
+            throw new ReviewError("review axis must be spec or standards");
+        return createReviewRecord(axis, report, timestamp);
+    });
+    const expectedAxis = completedStage === "review-spec"
+        ? "spec"
+        : completedStage === "review-standards"
+            ? "standards"
+            : null;
+    if (expectedAxis && !reviewRecords?.some(({ axis }) => axis === expectedAxis)) {
+        throw new PersistenceError(`stage '${completedStage}' requires a ${expectedAxis} review report`);
+    }
+    if (reviewRecords?.some(({ axis }) => expectedAxis !== axis)) {
+        throw new PersistenceError(`stage '${completedStage}' cannot record another review axis`);
+    }
+    const reviews = { ...state.reviews };
+    for (const review of reviewRecords ?? [])
+        reviews[review.axis] = review;
+    if (completedStage === "complete") {
+        if (state.verification.at(-1)?.exitCode !== 0) {
+            throw new PersistenceError("completion blocked: successful verification evidence is missing");
+        }
+        assertIndependentReviewGate(reviews);
+    }
+    const decisions = update.decisions?.map((record) => ({ ...record, recordedAt: record.recordedAt ?? timestamp }));
+    const next = {
+        ...state,
+        status: remaining.length ? "active" : "completed",
+        task: { ...state.task, updatedAt: timestamp },
+        spec: update.spec === undefined ? state.spec : update.spec,
+        slices: update.slices ?? state.slices,
+        dependencies: update.dependencies ?? state.dependencies,
+        progress: { current: remaining[0] ?? null, completed: completedInOrder, remaining },
+        verification: verification ? [...state.verification, ...verification] : state.verification,
+        reviews,
+        decisions: decisions ? [...state.decisions, ...decisions] : state.decisions,
+        handoff: update.handoff === undefined
+            ? state.handoff
+            : update.handoff === null
+                ? null
+                : { ...update.handoff, updatedAt: update.handoff.updatedAt ?? timestamp }
+    };
+    await writeState(path, next);
+    if (state.runId) {
+        if (retry) {
+            const previousAttempts = state.verification.filter(({ command }) => update.verification?.some((candidate) => candidate.command === command)).length;
+            await recordWorkflowRunEvent(state.runId, "retry", {
+                target: completedStage,
+                attempt: Math.max(2, previousAttempts + 1),
+                reason: `stage '${completedStage}' was checkpointed again`
+            }, root);
+        }
+        const [kind, name] = stage.uses.split(":", 2);
+        if (kind === "agent" && name) {
+            await recordWorkflowRunEvent(state.runId, "agent_invocation", {
+                agent: name,
+                stage: completedStage
+            }, root);
+        }
+        for (const failure of verification?.filter(({ exitCode }) => exitCode !== 0) ?? []) {
+            await recordWorkflowRunEvent(state.runId, "verification_failure", {
+                command: failure.command,
+                output: failure.output,
+                exitCode: failure.exitCode,
+                stage: completedStage
+            }, root);
+        }
+        if (!remaining.length) {
+            await finishWorkflowRun(state.runId, {
+                status: "completed",
+                summary: `Workflow '${state.workflow}' completed successfully.`
+            }, root);
+        }
+    }
+    return next;
+}
+/** Record one independent reviewer result through its axis-specific checkpoint. */
+export async function submitIndependentReview(axis, report, projectDirectory = ".") {
+    return checkpointFeatureWorkflow(axis === "spec" ? "review-spec" : "review-standards", { reviews: [{ ...report, axis }] }, projectDirectory);
+}
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

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

package/dist/providers.d.ts

@@ -0,0 +1,14 @@
+export type ProviderId = "claude" | "codex";
+export interface ProviderDefinition {
+    id: ProviderId;
+    displayName: string;
+    instructionFile: string;
+    skillsDirectory: string;
+    capabilities: {
+        skills: boolean;
+        instructions: boolean;
+    };
+}
+export declare const providerRegistry: ReadonlyMap<ProviderId, ProviderDefinition>;
+export declare function listProviders(): ProviderDefinition[];
+export declare function getProvider(id: string): ProviderDefinition;

package/dist/providers.js

@@ -0,0 +1,27 @@
+const definitions = [
+    {
+        id: "claude",
+        displayName: "Claude Code",
+        instructionFile: "CLAUDE.md",
+        skillsDirectory: ".claude/skills",
+        capabilities: { skills: true, instructions: true }
+    },
+    {
+        id: "codex",
+        displayName: "OpenAI Codex",
+        instructionFile: "AGENTS.md",
+        skillsDirectory: ".agents/skills",
+        capabilities: { skills: true, instructions: true }
+    }
+];
+export const providerRegistry = new Map(definitions.map((definition) => [definition.id, definition]));
+export function listProviders() {
+    return [...providerRegistry.values()];
+}
+export function getProvider(id) {
+    const provider = providerRegistry.get(id);
+    if (!provider)
+        throw new Error(`Unsupported provider: ${id}`);
+    return provider;
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,GAAyB;IACxC;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,aAAa;QAC1B,eAAe,EAAE,WAAW;QAC5B,eAAe,EAAE,gBAAgB;QACjC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;KACnD;IACD;QACE,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,cAAc;QAC3B,eAAe,EAAE,WAAW;QAC5B,eAAe,EAAE,gBAAgB;QACjC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;KACnD;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAgD,IAAI,GAAG,CAClF,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAC7D,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAgB,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IAC9D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/review.d.ts

@@ -0,0 +1,29 @@
+export type ReviewAxis = "spec" | "standards";
+export type ReviewVerdict = "PASS" | "FAIL";
+export interface ReviewFinding {
+    code: string;
+    message: string;
+    evidence: string;
+}
+export interface ReviewSubmission {
+    axis?: ReviewAxis;
+    verdict: ReviewVerdict;
+    summary: string;
+    findings: ReviewFinding[];
+}
+export interface ReviewRecord extends ReviewSubmission {
+    axis: ReviewAxis;
+    reviewer: "spec-reviewer" | "standards-reviewer";
+    recordedAt: string;
+}
+export interface IndependentReviews {
+    spec: ReviewRecord | null;
+    standards: ReviewRecord | null;
+}
+export declare class ReviewError extends Error {
+    constructor(message: string);
+}
+/** Validate one axis-scoped report without consulting the other reviewer. */
+export declare function createReviewRecord(axis: ReviewAxis, value: unknown, recordedAt?: string): ReviewRecord;
+/** Enforce the join gate and preserve axis-specific failure reasons. */
+export declare function assertIndependentReviewGate(reviews: IndependentReviews): void;