@itsshadowai/refinery 0.1.0

package/dist/core/live-review.js

@@ -0,0 +1,269 @@
+import { memoryMaintenanceActions } from "./adapter.js";
+export function extractJson(raw) {
+    const fenced = raw.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    const candidate = fenced ? fenced[1] : raw;
+    const first = candidate.indexOf("{");
+    const last = candidate.lastIndexOf("}");
+    if (first < 0 || last < first)
+        throw new Error("Model response did not contain a JSON object.");
+    return JSON.parse(candidate.slice(first, last + 1));
+}
+export function redactModel(config) {
+    return {
+        provider: config.provider,
+        baseUrl: config.baseUrl,
+        modelName: config.modelName,
+        ...(config.maxTokens ? { maxTokens: config.maxTokens } : {}),
+        apiKeyPresent: Boolean(config.apiKey),
+    };
+}
+function parseAction(value, legacyValue, label) {
+    const action = value ?? legacyValue;
+    if (!memoryMaintenanceActions.includes(action)) {
+        throw new Error(`${label} has invalid action.`);
+    }
+    return action;
+}
+function optionalString(record, field) {
+    if (!(field in record))
+        return undefined;
+    const value = record[field];
+    if (value === null)
+        return null;
+    if (typeof value !== "string")
+        throw new Error(`${field} must be string or null when present.`);
+    return value;
+}
+function optionalStringArray(record, field) {
+    if (!(field in record))
+        return undefined;
+    const value = record[field];
+    if (!Array.isArray(value) || !value.every((item) => typeof item === "string")) {
+        throw new Error(`${field} must be an array of strings when present.`);
+    }
+    return value;
+}
+function parseTargetMemoryIds(value, label) {
+    if (value === null || value === undefined) {
+        return { target_memory_id: null, target_memory_ids: [] };
+    }
+    if (typeof value === "string" || typeof value === "number") {
+        return { target_memory_id: value, target_memory_ids: [value] };
+    }
+    if (Array.isArray(value)) {
+        const ids = value.filter((item) => typeof item === "string" || typeof item === "number");
+        if (ids.length !== value.length) {
+            throw new Error(`${label} target_memory_id must contain only strings or numbers when an array is used.`);
+        }
+        return { target_memory_id: ids[0] ?? null, target_memory_ids: ids };
+    }
+    throw new Error(`${label} target_memory_id must be string, number, null, or an array of strings/numbers.`);
+}
+export function parseClaimScout(raw) {
+    const parsed = extractJson(raw);
+    if (!Array.isArray(parsed.candidates))
+        throw new Error("Claim Scout output must contain candidates array.");
+    return {
+        candidates: parsed.candidates.map((candidate, index) => {
+            if (!candidate || typeof candidate !== "object")
+                throw new Error(`Candidate ${index} must be an object.`);
+            const c = candidate;
+            if (typeof c.claim !== "string" || !c.claim.trim())
+                throw new Error(`Candidate ${index} missing claim.`);
+            if (!Array.isArray(c.source_refs))
+                throw new Error(`Candidate ${index} missing source_refs array.`);
+            if (typeof c.why_future_useful !== "string" || !c.why_future_useful.trim()) {
+                throw new Error(`Candidate ${index} missing why_future_useful.`);
+            }
+            return { claim: c.claim, source_refs: c.source_refs, why_future_useful: c.why_future_useful };
+        }),
+    };
+}
+export function parseProposalEditor(raw) {
+    const parsed = extractJson(raw);
+    if (!Array.isArray(parsed.typed))
+        throw new Error("Proposal Editor output must contain typed array.");
+    return {
+        typed: parsed.typed.map((item, index) => {
+            if (!item || typeof item !== "object")
+                throw new Error(`Typed item ${index} must be an object.`);
+            const t = item;
+            if (typeof t.body !== "string" || !t.body.trim())
+                throw new Error(`Typed item ${index} missing body.`);
+            if (typeof t.memory_type !== "string" || !t.memory_type.trim())
+                throw new Error(`Typed item ${index} missing memory_type.`);
+            if (typeof t.primary_type !== "string" || !t.primary_type.trim())
+                throw new Error(`Typed item ${index} missing primary_type.`);
+            if (t.secondary_type !== null && typeof t.secondary_type !== "string") {
+                throw new Error(`Typed item ${index} secondary_type must be string or null.`);
+            }
+            if (typeof t.type_confidence !== "number" || t.type_confidence < 0 || t.type_confidence > 1) {
+                throw new Error(`Typed item ${index} type_confidence must be 0..1.`);
+            }
+            if (typeof t.type_rationale !== "string" || !t.type_rationale.trim()) {
+                throw new Error(`Typed item ${index} missing type_rationale.`);
+            }
+            if (!Array.isArray(t.ambiguities))
+                throw new Error(`Typed item ${index} missing ambiguities array.`);
+            if (t.durability !== "durable" && t.durability !== "ttl" && t.durability !== "ephemeral") {
+                throw new Error(`Typed item ${index} has invalid durability.`);
+            }
+            if (t.ttl !== null && typeof t.ttl !== "string")
+                throw new Error(`Typed item ${index} ttl must be string or null.`);
+            if (typeof t.proposed_scope !== "string" || !t.proposed_scope.trim()) {
+                throw new Error(`Typed item ${index} missing proposed_scope.`);
+            }
+            const action = parseAction(t.action, t.mutation_op, `Typed item ${index}`);
+            const record = item;
+            const target = parseTargetMemoryIds(record.target_memory_ids ?? record.target_memory_id, `Typed item ${index}`);
+            if (!Array.isArray(t.source_refs))
+                throw new Error(`Typed item ${index} missing source_refs array.`);
+            return {
+                body: t.body,
+                memory_type: t.memory_type,
+                primary_type: t.primary_type,
+                secondary_type: t.secondary_type,
+                type_confidence: t.type_confidence,
+                type_rationale: t.type_rationale,
+                ambiguities: t.ambiguities,
+                durability: t.durability,
+                ttl: t.ttl,
+                proposed_scope: t.proposed_scope,
+                action,
+                target_memory_id: target.target_memory_id,
+                ...(target.target_memory_ids.length > 1 ? { target_memory_ids: target.target_memory_ids } : {}),
+                source_refs: t.source_refs,
+            };
+        }),
+    };
+}
+export function parseDecisionSynthesizer(raw) {
+    const parsed = extractJson(raw);
+    if (!Array.isArray(parsed.proposals) || !Array.isArray(parsed.rejected)) {
+        throw new Error("Decision Synthesizer output must contain proposals and rejected arrays.");
+    }
+    return {
+        proposals: parsed.proposals.map((item, index) => {
+            if (!item || typeof item !== "object")
+                throw new Error(`Proposal ${index} must be an object.`);
+            const p = item;
+            if (typeof p.memory_type !== "string" || !p.memory_type.trim())
+                throw new Error(`Proposal ${index} missing memory_type.`);
+            if (typeof p.proposed_scope !== "string" || !p.proposed_scope.trim()) {
+                throw new Error(`Proposal ${index} missing proposed_scope.`);
+            }
+            if (typeof p.body !== "string" || !p.body.trim())
+                throw new Error(`Proposal ${index} missing body.`);
+            if (typeof p.confidence !== "number" || p.confidence < 0 || p.confidence > 1) {
+                throw new Error(`Proposal ${index} confidence must be 0..1.`);
+            }
+            if (typeof p.rationale !== "string" || !p.rationale.trim())
+                throw new Error(`Proposal ${index} missing rationale.`);
+            if (!Array.isArray(p.source_refs))
+                throw new Error(`Proposal ${index} missing source_refs array.`);
+            const action = parseAction(p.action, p.mutation_op, `Proposal ${index}`);
+            const record = item;
+            const target = parseTargetMemoryIds(record.target_memory_ids ?? record.target_memory_id, `Proposal ${index}`);
+            return {
+                memory_type: p.memory_type,
+                proposed_scope: p.proposed_scope,
+                body: p.body,
+                confidence: p.confidence,
+                rationale: p.rationale,
+                source_refs: p.source_refs,
+                action,
+                target_memory_id: target.target_memory_id,
+                ...(target.target_memory_ids.length > 1 ? { target_memory_ids: target.target_memory_ids } : {}),
+                ...(optionalString(record, "staleness_reason") !== undefined ? { staleness_reason: optionalString(record, "staleness_reason") } : {}),
+                ...(optionalString(record, "forget_reason") !== undefined ? { forget_reason: optionalString(record, "forget_reason") } : {}),
+                ...(optionalString(record, "update_reason") !== undefined ? { update_reason: optionalString(record, "update_reason") } : {}),
+                ...(optionalString(record, "conflict_reason") !== undefined ? { conflict_reason: optionalString(record, "conflict_reason") } : {}),
+                ...(optionalString(record, "scope_reason") !== undefined ? { scope_reason: optionalString(record, "scope_reason") } : {}),
+                ...(optionalString(record, "replacement_body") !== undefined ? { replacement_body: optionalString(record, "replacement_body") } : {}),
+                ...(optionalStringArray(record, "ambiguities") !== undefined ? { ambiguities: optionalStringArray(record, "ambiguities") } : {}),
+            };
+        }),
+        rejected: parsed.rejected.map((item, index) => {
+            if (!item || typeof item !== "object")
+                throw new Error(`Rejected item ${index} must be an object.`);
+            const r = item;
+            const explanation = item.rejection_rationale
+                ?? item.rationale
+                ?? item.rejection_reason
+                ?? item.type_rationale
+                ?? item.update_reason;
+            const reason = typeof r.reason === "string" && r.reason.trim()
+                ? r.reason
+                : typeof explanation === "string" && explanation.trim()
+                    ? explanation
+                    : null;
+            if (!reason)
+                throw new Error(`Rejected item ${index} missing reason.`);
+            return { body: typeof r.body === "string" ? r.body : undefined, reason };
+        }),
+    };
+}
+export function parseEvidenceFindings(raw) {
+    const parsed = extractJson(raw);
+    if (!Array.isArray(parsed.findings))
+        throw new Error("Evidence finding output must contain findings array.");
+    return {
+        findings: parsed.findings.map((item, index) => {
+            if (!item || typeof item !== "object")
+                throw new Error(`Finding ${index} must be an object.`);
+            const f = item;
+            if (typeof f.body !== "string" || !f.body.trim())
+                throw new Error(`Finding ${index} missing body.`);
+            if (!["novel", "duplicate", "refinement", "contradiction", "supersession", "too_weak"].includes(String(f.relation))) {
+                throw new Error(`Finding ${index} has invalid relation.`);
+            }
+            if (f.target_memory_id !== null && typeof f.target_memory_id !== "string" && typeof f.target_memory_id !== "number") {
+                throw new Error(`Finding ${index} target_memory_id must be string, number, or null.`);
+            }
+            if (typeof f.confidence !== "number" || f.confidence < 0 || f.confidence > 1) {
+                throw new Error(`Finding ${index} confidence must be 0..1.`);
+            }
+            if (typeof f.rationale !== "string" || !f.rationale.trim())
+                throw new Error(`Finding ${index} missing rationale.`);
+            if (!Array.isArray(f.source_refs))
+                throw new Error(`Finding ${index} missing source_refs array.`);
+            if (!Array.isArray(f.memory_refs))
+                throw new Error(`Finding ${index} missing memory_refs array.`);
+            const memoryRefs = f.memory_refs.map((memoryRef) => {
+                if (typeof memoryRef === "string" || typeof memoryRef === "number") {
+                    return { memory_id: typeof memoryRef === "number" ? `memory:${memoryRef}` : memoryRef, provenance_kind: null };
+                }
+                if (memoryRef && typeof memoryRef === "object") {
+                    const ref = memoryRef;
+                    if (typeof ref.memory_id !== "string" && typeof ref.memory_id !== "number") {
+                        throw new Error(`Finding ${index} memory_ref missing memory_id.`);
+                    }
+                    return {
+                        memory_id: typeof ref.memory_id === "number" ? `memory:${ref.memory_id}` : ref.memory_id,
+                        provenance_kind: typeof ref.provenance_kind === "string" ? ref.provenance_kind : null,
+                    };
+                }
+                throw new Error(`Finding ${index} memory_ref must be an object, string, or number.`);
+            });
+            return { ...f, memory_refs: memoryRefs };
+        }),
+    };
+}
+export function buildPrompt(args) {
+    return {
+        system: [
+            args.specialist.prompt,
+            "",
+            "Return only JSON matching this shape:",
+            args.shape,
+            args.instruction,
+            "Do not wrap the answer in prose. Do not activate, approve, or write memory.",
+        ].join("\n"),
+        user: [
+            "Process this Refinery live review payload using your specialist contract.",
+            "",
+            JSON.stringify(args.payload, null, 2),
+        ].join("\n"),
+    };
+}
+//# sourceMappingURL=live-review.js.map

package/dist/core/live-review.js.map

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

package/dist/core/model-client.d.ts

@@ -0,0 +1,19 @@
+import { type ModelConfig } from "../env.ts";
+export interface OpenRouterCallMetadata {
+    provider: "openrouter";
+    baseUrl: string;
+    modelName: string;
+    status: number;
+    responseId: string | null;
+    responseModel: string | null;
+    finishReason: string | null;
+    usage: unknown;
+}
+export declare function callOpenRouterChatWithMetadata(request: {
+    model: ModelConfig;
+    system: string;
+    user: string;
+}): Promise<{
+    content: string;
+    metadata: OpenRouterCallMetadata;
+}>;

package/dist/core/model-client.js

@@ -0,0 +1,45 @@
+import { defaultOpenRouterMaxTokens } from "../env.js";
+export async function callOpenRouterChatWithMetadata(request) {
+    if (request.model.provider !== "openrouter") {
+        throw new Error(`Unsupported model provider: ${request.model.provider}`);
+    }
+    const response = await fetch(`${request.model.baseUrl.replace(/\/$/, "")}/chat/completions`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            authorization: `Bearer ${request.model.apiKey}`,
+        },
+        body: JSON.stringify({
+            model: request.model.modelName,
+            messages: [
+                { role: "system", content: request.system },
+                { role: "user", content: request.user },
+            ],
+            temperature: 0.1,
+            max_tokens: request.model.maxTokens ?? defaultOpenRouterMaxTokens,
+        }),
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`OpenRouter request failed (${response.status}): ${body.slice(0, 500)}`);
+    }
+    const json = (await response.json());
+    const content = json.choices?.[0]?.message?.content;
+    if (typeof content !== "string" || !content.trim()) {
+        throw new Error("OpenRouter response did not include message content.");
+    }
+    return {
+        content,
+        metadata: {
+            provider: "openrouter",
+            baseUrl: request.model.baseUrl,
+            modelName: request.model.modelName,
+            status: response.status,
+            responseId: typeof json.id === "string" ? json.id : null,
+            responseModel: typeof json.model === "string" ? json.model : null,
+            finishReason: typeof json.choices?.[0]?.finish_reason === "string" ? json.choices[0].finish_reason : null,
+            usage: json.usage ?? null,
+        },
+    };
+}
+//# sourceMappingURL=model-client.js.map

package/dist/core/model-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-client.js","sourceRoot":"","sources":["../../src/core/model-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAoB,MAAM,WAAW,CAAC;AAazE,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,OAIpD;IACC,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,EAAE;QAC3F,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE;SAChD;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS;YAC9B,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE;gBAC3C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;aACxC;YACD,WAAW,EAAE,GAAG;YAChB,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,0BAA0B;SAClE,CAAC;KACH,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAKlC,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IACpD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO;QACL,OAAO;QACP,QAAQ,EAAE;YACR,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO;YAC9B,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS;YAClC,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;YACxD,aAAa,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YACjE,YAAY,EAAE,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI;YACzG,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;SAC1B;KACF,CAAC;AACJ,CAAC"}

package/dist/core/paths.d.ts

@@ -0,0 +1,16 @@
+export interface RefineryPaths {
+    home: string;
+    configDir: string;
+    credentialsDir: string;
+    runsRootDir: string;
+    projectKey: string;
+    runsDir: string;
+}
+export interface ResolveRefineryPathsOptions {
+    home?: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+}
+export declare function expandHome(p: string): string;
+export declare function projectKeyForPath(projectPath: string): string;
+export declare function resolveRefineryPaths(options?: ResolveRefineryPathsOptions): RefineryPaths;

package/dist/core/paths.js

@@ -0,0 +1,43 @@
+import crypto from "node:crypto";
+import os from "node:os";
+import path from "node:path";
+export function expandHome(p) {
+    if (p === "~")
+        return os.homedir();
+    if (p.startsWith("~/"))
+        return path.join(os.homedir(), p.slice(2));
+    return p;
+}
+function resolvePathInput(input, cwd) {
+    const expanded = expandHome(input);
+    return path.isAbsolute(expanded) ? path.resolve(expanded) : path.resolve(cwd, expanded);
+}
+export function projectKeyForPath(projectPath) {
+    const resolved = path.resolve(projectPath);
+    const escapedSep = path.sep.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const normalized = resolved.replace(new RegExp(`${escapedSep}+`, "g"), path.sep);
+    const slug = normalized
+        .replace(/^[A-Za-z]:/, "")
+        .replace(/[^A-Za-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80) || "project";
+    const hash = crypto.createHash("sha256").update(normalized).digest("hex").slice(0, 10);
+    return `${slug}-${hash}`;
+}
+export function resolveRefineryPaths(options = {}) {
+    const env = options.env ?? process.env;
+    const cwd = options.cwd ?? process.cwd();
+    const homeInput = options.home ?? env.REFINERY_HOME ?? "~/.refinery";
+    const home = resolvePathInput(homeInput, cwd);
+    const runsRootDir = path.join(home, "runs");
+    const projectKey = projectKeyForPath(cwd);
+    return {
+        home,
+        configDir: path.join(home, "config"),
+        credentialsDir: path.join(home, "credentials"),
+        runsRootDir,
+        projectKey,
+        runsDir: path.join(runsRootDir, "by-project", projectKey),
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAiB7B,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACnC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,GAAW;IAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,UAAU;SACpB,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvF,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAuC,EAAE;IAC5E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,aAAa,IAAI,aAAa,CAAC;IACrE,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;QACpC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;QAC9C,WAAW;QACX,UAAU;QACV,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/core/review.d.ts

@@ -0,0 +1,93 @@
+import { refineryReviewSchemaVersion, type MemoryProposal } from "./adapter.ts";
+import { RefineryError } from "./errors.ts";
+import { type ReviewRunMode } from "./artifacts.ts";
+import { type ReviewIntent } from "./intents.ts";
+export interface ReviewSinkOptions {
+    url: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+}
+export interface ReviewSinkResult {
+    url: string;
+    ok: boolean;
+    status: number;
+    deliveredAt: string;
+    responseText: string;
+}
+export interface ReviewRejected {
+    sourceId: string;
+    reason: string;
+}
+export interface ReviewRunResult {
+    ok: true;
+    schemaVersion: typeof refineryReviewSchemaVersion;
+    command: "review";
+    adapter: {
+        name: string;
+    };
+    scope: string;
+    dryRun: true;
+    runId: string;
+    runDir: string;
+    counts: {
+        sources: number;
+        activeMemories: number;
+        proposals: number;
+        rejected: number;
+        claims?: number;
+        challenges?: number;
+        deliberationMoves?: number;
+    };
+    proposals: MemoryProposal[];
+    rejected: ReviewRejected[];
+    metadata: ReviewRunMetadata;
+    sink?: ReviewSinkResult;
+}
+export interface ReviewRunMetadata {
+    schemaVersion: typeof refineryReviewSchemaVersion;
+    runId: string;
+    adapter: string;
+    scope: string;
+    dryRun: true;
+    mode: ReviewRunMode;
+    createdAt: string;
+    writesAttempted: false;
+    sinkUrl: string | null;
+    runtime: Record<string, unknown>;
+    specialistOrder: string[];
+    sourceLimit: number | null;
+    sourceCharLimit: number | null;
+    intent: ReviewIntent;
+    request: string | null;
+    model?: Record<string, unknown>;
+}
+export interface ReviewFailureStatus {
+    ok: false;
+    schemaVersion: typeof refineryReviewSchemaVersion;
+    command: "review";
+    status: "failed";
+    runId: string;
+    runDir: string;
+    adapter: string | null;
+    scope: string;
+    mode: ReviewRunMode;
+    failedStep: string | null;
+    rawOutputPath: string | null;
+    createdAt: string;
+    failedAt: string;
+    error: Record<string, unknown>;
+    intent?: ReviewIntent;
+    request?: string | null;
+}
+export declare function writeReviewFailureStatus(args: {
+    runDir: string;
+    runId: string;
+    adapterName?: string | null;
+    scope: string;
+    mode: ReviewRunMode;
+    createdAt: string;
+    error: RefineryError;
+    intent?: ReviewIntent;
+    request?: string | null;
+}): ReviewFailureStatus;
+export declare function deliverReviewSink(sink: ReviewSinkOptions, result: Omit<ReviewRunResult, "sink">): Promise<ReviewSinkResult>;

package/dist/core/review.js

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { refineryReviewSchemaVersion } from "./adapter.js";
+import { serializeRefineryError, RefineryError } from "./errors.js";
+import { writeReviewArtifactManifest } from "./artifacts.js";
+import {} from "./intents.js";
+const DEFAULT_SINK_TIMEOUT_MS = 10_000;
+const MAX_SINK_RESPONSE_TEXT_CHARS = 4000;
+function writeJson(filePath, value) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(value, null, 2));
+}
+export function writeReviewFailureStatus(args) {
+    const status = {
+        ok: false,
+        schemaVersion: refineryReviewSchemaVersion,
+        command: "review",
+        status: "failed",
+        runId: args.runId,
+        runDir: args.runDir,
+        adapter: args.adapterName ?? null,
+        scope: args.scope,
+        mode: args.mode,
+        failedStep: args.error.failedStep ?? null,
+        rawOutputPath: args.error.rawOutputPath ?? null,
+        createdAt: args.createdAt,
+        failedAt: new Date().toISOString(),
+        error: serializeRefineryError(args.error),
+        ...(args.intent ? { intent: args.intent } : {}),
+        ...(args.request !== undefined ? { request: args.request } : {}),
+    };
+    writeJson(path.join(args.runDir, "status.json"), status);
+    writeJson(path.join(args.runDir, "review.json"), status);
+    writeReviewArtifactManifest({
+        runDir: args.runDir,
+        runId: args.runId,
+        adapterName: args.adapterName ?? null,
+        scope: args.scope,
+        mode: args.mode,
+        status: "failed",
+        createdAt: args.createdAt,
+        failedAt: status.failedAt,
+        failedStep: status.failedStep,
+        rawOutputPath: status.rawOutputPath,
+        error: status.error,
+        intent: args.intent,
+        request: args.request,
+    });
+    return status;
+}
+export async function deliverReviewSink(sink, result) {
+    const parsedUrl = new URL(sink.url);
+    if (parsedUrl.protocol === "file:") {
+        const target = fileURLToPath(parsedUrl);
+        writeJson(target, result);
+        return {
+            url: sink.url,
+            ok: true,
+            status: 0,
+            deliveredAt: new Date().toISOString(),
+            responseText: target,
+        };
+    }
+    const timeoutMs = sink.timeoutMs ?? DEFAULT_SINK_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+        response = await fetch(sink.url, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...(sink.headers ?? {}),
+            },
+            body: JSON.stringify(result),
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        if (controller.signal.aborted) {
+            throw new RefineryError("SINK_CALLBACK_TIMEOUT", `Review sink callback timed out after ${timeoutMs}ms.`, { phase: "sink" });
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    const responseText = (await response.text()).slice(0, MAX_SINK_RESPONSE_TEXT_CHARS);
+    const sinkResult = {
+        url: sink.url,
+        ok: response.ok,
+        status: response.status,
+        deliveredAt: new Date().toISOString(),
+        responseText,
+    };
+    if (!response.ok) {
+        throw new RefineryError("SINK_CALLBACK_FAILED", `Review sink callback failed with status ${response.status}: ${responseText}`, { phase: "sink", status: response.status });
+    }
+    return sinkResult;
+}
+//# sourceMappingURL=review.js.map

package/dist/core/review.js.map

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

package/dist/core/specialists/claim-scout.d.ts

@@ -0,0 +1,2 @@
+import type { LocalSpecialist } from "./types.ts";
+export declare const claimScoutSpecialist: LocalSpecialist;