psyclaw 0.25.2 → 0.26.0

package/dist/src/updates/update.d.ts

@@ -0,0 +1,43 @@
+import { type RegistryClient } from "./registry.js";
+/** A single side-effecting step for the injected executor to run. */
+export interface PiUpdateStep {
+    command: string;
+    cwd: string;
+}
+export type PiUpdateExecutor = (step: PiUpdateStep) => Promise<{
+    exitCode: number;
+}>;
+export type PiUpdateReason = "already-up-to-date" | "update-applied" | "update-failed" | "update-skipped";
+export interface PiUpdateReceipt {
+    schemaVersion: "psyclaw/pi-update/v1";
+    ok: boolean;
+    executed: boolean;
+    reasonCode: PiUpdateReason;
+    reason?: string;
+    packageName: string;
+    before?: string;
+    after?: string;
+    latest?: string;
+    note?: string;
+    command?: string;
+    exitCode?: number;
+    startedAt: string;
+    finishedAt: string;
+}
+export interface UpdateBundledPiOptions {
+    registry: RegistryClient;
+    /** Explicit psyclaw package root (tests); defaults to walking up from here. */
+    packageRoot?: string;
+    force?: boolean;
+    now?: () => string;
+    /** When omitted, the call is a dry run and never mutates the workspace. */
+    executor?: PiUpdateExecutor;
+}
+/**
+ * Update the bundled Pi runtime by re-pinning both `@earendil-works/pi-*`
+ * packages to the latest official release. This is the write-side counterpart
+ * to `checkUpdates`: it is `--yes`/executor-gated, refuses non-semver versions,
+ * and always returns a structured receipt. Without an executor it is a pure
+ * plan (no workspace mutation).
+ */
+export declare function updateBundledPi(options: UpdateBundledPiOptions): Promise<PiUpdateReceipt>;

package/dist/src/updates/update.js

@@ -0,0 +1,128 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { PI_AI, PI_CODING_AGENT, resolvePsyClawManifest } from "./manifest.js";
+import { compareSemver } from "./status.js";
+/** Reject anything that is not a plain, installable semver (guards the spawn). */
+const SEMVER_PATTERN = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
+function isSafeVersion(version) {
+    return SEMVER_PATTERN.test(version);
+}
+async function packageManagerAt(root) {
+    const candidates = [
+        ["pnpm", "pnpm-lock.yaml"],
+        ["npm", "package-lock.json"],
+    ];
+    for (const [manager, file] of candidates) {
+        try {
+            await access(join(root, file));
+            return manager;
+        }
+        catch {
+            // keep looking
+        }
+    }
+    // A globally installed npm package is not shipped with its lockfile. npm is
+    // still able to update this package's pinned runtime dependencies in place.
+    return "npm";
+}
+function buildCommand(manager, version) {
+    const spec = `${PI_AI}@${version} ${PI_CODING_AGENT}@${version}`;
+    return manager === "pnpm" ? `pnpm add --save-exact ${spec}` : `npm install --save-exact ${spec}`;
+}
+/**
+ * Update the bundled Pi runtime by re-pinning both `@earendil-works/pi-*`
+ * packages to the latest official release. This is the write-side counterpart
+ * to `checkUpdates`: it is `--yes`/executor-gated, refuses non-semver versions,
+ * and always returns a structured receipt. Without an executor it is a pure
+ * plan (no workspace mutation).
+ */
+export async function updateBundledPi(options) {
+    const now = options.now ?? (() => new Date().toISOString());
+    const startedAt = now();
+    const finish = (receipt) => ({
+        schemaVersion: "psyclaw/pi-update/v1",
+        startedAt,
+        finishedAt: now(),
+        ...receipt,
+    });
+    const manifest = await resolvePsyClawManifest(options.packageRoot);
+    if (manifest === undefined) {
+        return finish({
+            ok: false,
+            executed: false,
+            reasonCode: "update-skipped",
+            reason: "psyclaw package.json not found",
+            packageName: PI_CODING_AGENT,
+        });
+    }
+    let latest;
+    try {
+        latest = await options.registry.latestPiRelease();
+    }
+    catch {
+        latest = undefined;
+    }
+    const before = manifest.piVersion;
+    const base = {
+        packageName: PI_CODING_AGENT,
+        ...(before === undefined ? {} : { before }),
+    };
+    if (latest === undefined) {
+        return finish({ ok: false, executed: false, reasonCode: "update-skipped", reason: "latest Pi release unavailable", ...base });
+    }
+    if (!isSafeVersion(latest.version)) {
+        return finish({
+            ok: false,
+            executed: false,
+            reasonCode: "update-skipped",
+            reason: `refusing unsafe Pi version: ${latest.version}`,
+            latest: latest.version,
+            ...base,
+        });
+    }
+    const latestVersion = latest.version;
+    const comparison = before === undefined ? null : compareSemver(before, latestVersion);
+    const needsUpdate = options.force === true || comparison === null || comparison < 0;
+    const withLatest = {
+        ...base,
+        latest: latestVersion,
+        ...(latest.note === undefined ? {} : { note: latest.note }),
+    };
+    if (!needsUpdate) {
+        return finish({ ok: true, executed: false, reasonCode: "already-up-to-date", after: latestVersion, ...withLatest });
+    }
+    const manager = await packageManagerAt(manifest.root);
+    if (manager === undefined) {
+        return finish({
+            ok: false,
+            executed: false,
+            reasonCode: "update-skipped",
+            reason: "no pnpm-lock.yaml or package-lock.json found in the psyclaw package root",
+            ...withLatest,
+        });
+    }
+    const command = buildCommand(manager, latestVersion);
+    if (options.executor === undefined) {
+        return finish({
+            ok: true,
+            executed: false,
+            reasonCode: "update-skipped",
+            reason: "dry run: re-run with --yes to apply",
+            command,
+            after: latestVersion,
+            ...withLatest,
+        });
+    }
+    const { exitCode } = await options.executor({ command, cwd: manifest.root });
+    const ok = Number.isInteger(exitCode) && exitCode === 0;
+    return finish({
+        ok,
+        executed: true,
+        reasonCode: ok ? "update-applied" : "update-failed",
+        command,
+        exitCode,
+        ...(ok ? { after: latestVersion } : {}),
+        ...withLatest,
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/src/updates/update.js.map

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

package/dist/src/wizard.d.ts

@@ -0,0 +1,7 @@
+export type WizardStep = "welcome" | "provider" | "model" | "confirm" | "done";
+export interface WizardResult {
+    completed: boolean;
+    provider?: string;
+    modelId?: string;
+}
+export declare function runWizard(): Promise<WizardResult>;

package/dist/src/wizard.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Box, Text, render, useInput } from "ink";
+import { PROVIDER_PRESETS, setupProviders } from "./setup.js";
+import { PSYCLAW_ACCENT, PSYCLAW_ERROR, PSYCLAW_OK, PSYCLAW_VERSION } from "./branding.js";
+function Banner() {
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { gap: 1, alignItems: "center", children: [_jsx(Text, { color: PSYCLAW_ACCENT, bold: true, children: "\u03C8 PsyClaw" }), _jsxs(Text, { color: "black", backgroundColor: PSYCLAW_ACCENT, bold: true, children: [" v", PSYCLAW_VERSION, " "] }), _jsx(Text, { dimColor: true, children: "\u793E\u79D1\u79D1\u7814\u667A\u80FD\u4F53 \u00B7 \u9996\u6B21\u914D\u7F6E\u5411\u5BFC" })] }), _jsx(Text, { dimColor: true, children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" })] }));
+}
+function Hint({ children }) {
+    return (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["\uD83D\uDCA1 ", children] }) }));
+}
+function Selectable({ lines, selected }) {
+    return (_jsx(Box, { flexDirection: "column", marginY: 1, children: lines.map((line, index) => {
+            const isSelected = index === selected;
+            return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: isSelected ? PSYCLAW_ACCENT : "gray", bold: isSelected, children: isSelected ? "❯" : " " }), isSelected ? (_jsx(Text, { bold: true, color: PSYCLAW_ACCENT, children: line })) : (_jsx(Text, { children: line }))] }, line));
+        }) }));
+}
+function Wizard({ onDone }) {
+    const [step, setStep] = useState("welcome");
+    const [providerIndex, setProviderIndex] = useState(0);
+    const [modelIndex, setModelIndex] = useState(0);
+    const provider = PROVIDER_PRESETS[providerIndex];
+    const model = provider?.models[modelIndex];
+    const apiKeyEnv = provider?.apiKeyEnv ?? "";
+    const keyConfigured = process.env[apiKeyEnv] !== undefined && process.env[apiKeyEnv] !== "";
+    const writeConfig = async () => {
+        if (!provider)
+            return;
+        await setupProviders({ providers: [provider.id] });
+        setStep("done");
+    };
+    useInput((input, key) => {
+        if (input === "q" && step !== "done") {
+            onDone({ completed: false });
+            return;
+        }
+        switch (step) {
+            case "welcome":
+                if (key.return)
+                    setStep("provider");
+                break;
+            case "provider":
+                if (key.upArrow)
+                    setProviderIndex((value) => Math.max(0, value - 1));
+                if (key.downArrow)
+                    setProviderIndex((value) => Math.min(PROVIDER_PRESETS.length - 1, value + 1));
+                if (key.return) {
+                    setModelIndex(0);
+                    setStep("model");
+                }
+                break;
+            case "model":
+                if (key.upArrow)
+                    setModelIndex((value) => Math.max(0, value - 1));
+                if (key.downArrow)
+                    setModelIndex((value) => Math.min((provider?.models.length ?? 1) - 1, value + 1));
+                if (key.return)
+                    setStep("confirm");
+                break;
+            case "confirm":
+                if (key.return)
+                    void writeConfig();
+                if (key.escape)
+                    setStep("provider");
+                break;
+            case "done":
+                if (key.return || input === "q") {
+                    onDone({
+                        completed: true,
+                        ...(provider?.id === undefined ? {} : { provider: provider.id }),
+                        ...(model?.id === undefined ? {} : { modelId: model.id }),
+                    });
+                }
+                break;
+        }
+    });
+    const providerLines = PROVIDER_PRESETS.map((preset) => `${preset.name.padEnd(20)} (环境变量: $${preset.apiKeyEnv})`);
+    const modelLines = provider ? provider.models.map((entry) => `${entry.name.padEnd(26)} [${entry.id}]`) : [];
+    return (_jsxs(Box, { borderStyle: "round", borderColor: PSYCLAW_ACCENT, paddingX: 2, paddingY: 1, flexDirection: "column", children: [_jsx(Banner, {}), step === "welcome" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "\u6B22\u8FCE\u4F7F\u7528 PsyClaw\uFF01" }), _jsx(Text, { dimColor: true, children: "\u9996\u6B21\u8FD0\u884C\u9700\u914D\u7F6E\u4E00\u4E2A\u6A21\u578B\u63D0\u4F9B\u5546\uFF08API Key \u7531\u672C\u5730\u73AF\u5883\u53D8\u91CF\u5B89\u5168\u7BA1\u7406\uFF0C\u7EDD\u4E0D\u4E0A\u62A5\uFF09\u3002" }), _jsx(Hint, { children: "[Enter] \u5F00\u59CB\u914D\u7F6E  \u00B7  [Q] \u9000\u51FA" })] })), step === "provider" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, color: PSYCLAW_ACCENT, children: "[1/3] \u9009\u62E9\u6A21\u578B\u63D0\u4F9B\u5546 (Provider)" }), _jsx(Selectable, { lines: providerLines, selected: providerIndex }), _jsx(Hint, { children: "[\u2191/\u2193] \u79FB\u52A8\u5149\u6807  \u00B7  [Enter] \u786E\u8BA4\u9009\u62E9  \u00B7  [Q] \u9000\u51FA" })] })), step === "model" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, color: PSYCLAW_ACCENT, children: ["[2/3] \u9009\u62E9\u9ED8\u8BA4\u6A21\u578B (", provider?.name, ")"] }), _jsx(Selectable, { lines: modelLines, selected: modelIndex }), _jsx(Hint, { children: "[\u2191/\u2193] \u79FB\u52A8\u5149\u6807  \u00B7  [Enter] \u786E\u8BA4\u9009\u62E9  \u00B7  [Q] \u9000\u51FA" })] })), step === "confirm" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, color: PSYCLAW_ACCENT, children: "[3/3] \u786E\u8BA4\u914D\u7F6E\u5E76\u5199\u5165" }), _jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsxs(Text, { children: ["\u2022 \u63D0\u4F9B\u5546: ", _jsx(Text, { color: PSYCLAW_ACCENT, bold: true, children: provider?.name })] }), _jsxs(Text, { children: ["\u2022 \u6A21  \u578B: ", _jsx(Text, { color: PSYCLAW_ACCENT, bold: true, children: model?.name }), " ", _jsxs(Text, { dimColor: true, children: ["(", model?.id, ")"] })] }), _jsxs(Text, { color: keyConfigured ? PSYCLAW_OK : PSYCLAW_ERROR, bold: true, children: ["\u2022 API Key: ", keyConfigured ? `✔ 已就绪 ($${apiKeyEnv})` : `✗ 未检测到 $${apiKeyEnv}（请先在环境设置）`] })] }), _jsx(Hint, { children: "[Enter] \u4FDD\u5B58\u5E76\u542F\u52A8\u5BF9\u8BDD  \u00B7  [Esc] \u8FD4\u56DE\u4E0A\u4E00\u6B65  \u00B7  [Q] \u9000\u51FA" })] })), step === "done" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: PSYCLAW_OK, bold: true, children: "\u2714 \u914D\u7F6E\u5DF2\u6210\u529F\u5199\u5165 models.json \u4E0E\u73AF\u5883\u7F13\u5B58\uFF01" }), _jsx(Text, { dimColor: true, children: "\u9A6C\u4E0A\u542F\u52A8 PsyClaw \u667A\u80FD\u7814\u7A76\u52A9\u624B\u2026" }), _jsx(Hint, { children: "[Enter] \u7ACB\u5373\u8FDB\u5165\u5BF9\u8BDD  \u00B7  [Q] \u9000\u51FA" })] }))] }));
+}
+export function runWizard() {
+    return new Promise((resolve) => {
+        let instance;
+        instance = render(_jsx(Wizard, { onDone: (result) => {
+                instance.unmount();
+                resolve(result);
+            } }), { stdout: process.stdout, exitOnCtrlC: false });
+    });
+}
+//# sourceMappingURL=wizard.js.map

package/dist/src/wizard.js.map

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

package/dist/src/workflows/analysis-delegation.d.ts

@@ -0,0 +1,3 @@
+import { type WorkflowResult, type WorkflowSpec } from "./spec.js";
+export declare const analysisDelegationSpec: WorkflowSpec;
+export declare function runAnalysisDelegation(root: string): Promise<WorkflowResult>;

package/dist/src/workflows/analysis-delegation.js

@@ -0,0 +1,96 @@
+import { checkEvidenceSufficiency } from "../core/evidence-policy.js";
+import { loadLedger, readProject } from "../research/ledger.js";
+import { allParadigms, finalizeWorkflow } from "./spec.js";
+import { ANALYSIS_HOOKS_VERSION, analysisHookDigest, loadUserAnalysisHooks } from "../analysis/hooks.js";
+import { checkPreRegistration, readPreRegistration } from "../analysis/pre-registration.js";
+import { allocateProjectVersion } from "../project/versions.js";
+export const analysisDelegationSpec = {
+    id: "analysis-delegation",
+    version: "1.0.0",
+    description: "Plan an external statistical analysis without computing anything in core.",
+    paradigms: allParadigms,
+    steps: [
+        { id: "select", role: "analyst", effect: "read", description: "select result claims to delegate" },
+        { id: "contract", role: "analyst", effect: "read", description: "write input/output/environment contract" },
+        { id: "write", role: "writer", effect: "write", description: "write the delegation plan" },
+    ],
+    requiredArtifacts: ["analysis-plan.md", "delegation.json"],
+};
+export async function runAnalysisDelegation(root) {
+    const project = await readProject(root);
+    const ledger = await loadLedger(root);
+    const gates = checkEvidenceSufficiency({ ...ledger, paradigm: project.paradigm });
+    // Confirmatory analysis is gated on a pre-registered plan.
+    gates.push(...checkPreRegistration(await readPreRegistration(root), project.paradigm));
+    const version = await allocateProjectVersion(root, "analysis-plan", `analysis-delegation:${Date.now()}`);
+    const userHooks = await loadUserAnalysisHooks(root);
+    const resultClaims = ledger.claims.filter((claim) => claim.kind === "result");
+    if (resultClaims.length === 0) {
+        gates.push({ gateId: "analysis:no-result-claims", ok: false, severity: "block", reason: "no result claims to delegate" });
+    }
+    const delegation = {
+        schemaVersion: "psyclaw/delegation/v1",
+        paradigm: project.paradigm,
+        version,
+        note: "psyclaw plans and verifies delegated analysis; it never computes statistics in core.",
+        safety: {
+            hooks: ANALYSIS_HOOKS_VERSION,
+            hookDigest: analysisHookDigest(),
+            userHooks: userHooks.map((hook) => ({ id: hook.id, event: hook.event, severity: hook.severity })),
+            immutableInputs: ["data/raw", "declared input paths"],
+            requiredChecks: ["beforeAnalysis", "validateAnalysisPlan", "beforeWrite", "afterAnalysis"],
+            policy: ["never overwrite or recode data/raw", "never report p-values without effect sizes and uncertainty intervals", "never turn correlation or significance into causality", "record script, environment, input hashes, missing-data and multiplicity handling"],
+        },
+        tasks: resultClaims.map((claim) => ({
+            claimId: claim.id,
+            claim: claim.text,
+            inputRefs: claim.evidenceIds,
+            contract: {
+                entrypoint: `analysis/scripts/run_${claim.id}.py`,
+                script: `analysis/scripts/run_${claim.id}.py`,
+                moduleLayout: {
+                    load: `analysis/scripts/${claim.id}/01_load.py`,
+                    prepare: `analysis/scripts/${claim.id}/02_prepare.py`,
+                    analyze: `analysis/scripts/${claim.id}/03_analyze.py`,
+                    validate: `analysis/scripts/${claim.id}/04_validate.py`,
+                    export: `analysis/scripts/${claim.id}/05_export.py`,
+                    reviewDocument: `analysis/scripts/${claim.id}/README.md`,
+                },
+                environment: { python: ">=3.12", execution: "external-and-approved" },
+                inputDigestRefs: claim.evidenceIds,
+                outputSchema: "psyclaw/analysis-result/v1",
+                requiredArtifact: `analysis/results/${claim.id}.result.json`,
+                moduleBoundary: "The entrypoint may orchestrate modules only; data loading, preparation, analysis, validation, and export stay separately reviewable.",
+            },
+        })),
+    };
+    const markdown = [
+        `# Analysis Delegation Plan ${version}`,
+        "",
+        `Paradigm: ${project.paradigm}`,
+        "",
+        ...delegation.tasks.map((task) => [
+            `## ${task.claimId}`,
+            "",
+            `Claim: ${task.claim}`,
+            "",
+            `- Entrypoint: \`${task.contract.entrypoint}\``,
+            `- Modules: load → prepare → analyze → validate → export`,
+            `- Review document: \`${task.contract.moduleLayout.reviewDocument}\``,
+            `- Environment: \`${task.contract.environment.python}\``,
+            `- Required artifact: \`${task.contract.requiredArtifact}\``,
+            "",
+        ]).flat(),
+    ].join("\n");
+    return finalizeWorkflow(root, analysisDelegationSpec, {
+        gates,
+        outputs: [
+            { path: "analysis-plan.md", contents: markdown },
+            { path: "delegation.json", contents: `${JSON.stringify(delegation, null, 2)}\n` },
+            { path: `analysis-plan-${version}.md`, contents: markdown },
+            { path: `delegation-${version}.json`, contents: `${JSON.stringify(delegation, null, 2)}\n` },
+        ],
+        completed: ["result claims selected", "delegation contracts written"],
+    });
+}
+//# sourceMappingURL=analysis-delegation.js.map

package/dist/src/workflows/analysis-delegation.js.map

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

package/dist/src/workflows/expert-review-runner.d.ts

@@ -0,0 +1,29 @@
+import { type WorkflowResult, type WorkflowSpec } from "./spec.js";
+export declare const expertReviewWorkflowSpec: WorkflowSpec;
+export declare const expertReviewSpec: WorkflowSpec;
+export interface ReviewerRole {
+    id: "methodologist" | "evidence-auditor" | "integrity-ethicist" | "editor";
+    label: string;
+    remit: string;
+}
+export declare const DEFAULT_REVIEWER_ROLES: readonly ReviewerRole[];
+export interface ReviewApproval {
+    approved: boolean;
+    actor: string;
+    reason: string;
+    at?: string;
+}
+export interface ExpertReviewOptions {
+    approval?: ReviewApproval;
+    roles?: readonly ReviewerRole[];
+}
+export interface ExpertReviewSuggestion {
+    id: string;
+    role: ReviewerRole["id"];
+    priority: "block" | "warn";
+    target?: string;
+    suggestion: string;
+    rationale: string;
+    status: "proposed";
+}
+export declare function runExpertReview(root: string, options?: ExpertReviewOptions): Promise<WorkflowResult>;

package/dist/src/workflows/expert-review-runner.js

@@ -0,0 +1,35 @@
+import { randomUUID } from "node:crypto";
+import { appendJsonl } from "../project/jsonl.js";
+import { projectPaths } from "../project/paths.js";
+import { allocateProjectVersion } from "../project/versions.js";
+import { checkEvidenceSufficiency } from "../core/evidence-policy.js";
+import { loadLedger, readProject } from "../research/ledger.js";
+import { allParadigms, finalizeWorkflow } from "./spec.js";
+export const expertReviewWorkflowSpec = { id: "expert-review", version: "1.0.0", description: "Run four independent review roles and produce evidence-grounded recommendations for human approval.", paradigms: allParadigms, steps: [{ id: "evidence", role: "verifier", effect: "read", description: "load and check the evidence ledger" }, { id: "method", role: "analyst", effect: "read", description: "review methods and claims" }, { id: "ethics", role: "critic", effect: "read", description: "review integrity, uncertainty, and ethics" }, { id: "editorial", role: "writer", effect: "read", description: "propose clarity and reporting revisions" }], requiredArtifacts: ["expert-review.md", "review-result.json", "review-suggestions.json"] };
+export const expertReviewSpec = expertReviewWorkflowSpec;
+export const DEFAULT_REVIEWER_ROLES = [{ id: "methodologist", label: "Methodologist", remit: "methods, design, and conclusion boundaries" }, { id: "evidence-auditor", label: "Evidence auditor", remit: "claim, source, locator, and conflict coverage" }, { id: "integrity-ethicist", label: "Integrity and ethics reviewer", remit: "uncertainty, ethics, privacy, and reporting risks" }, { id: "editor", label: "Academic editor", remit: "clarity, structure, and transparent revision suggestions" }];
+export async function runExpertReview(root, options = {}) {
+    const project = await readProject(root);
+    const ledger = await loadLedger(root);
+    const gates = checkEvidenceSufficiency({ ...ledger, paradigm: project.paradigm });
+    const version = await allocateProjectVersion(root, "manuscript-revision", `expert-review:${Date.now()}`);
+    const approval = options.approval;
+    if (!approval?.approved)
+        gates.push({ gateId: "expert-review:human-approval", ok: false, severity: "block", reason: "human approval is required before adopting review recommendations" });
+    const suggestions = [];
+    for (const claim of ledger.claims) {
+        const gate = gates.find((item) => item.claimIds?.includes(claim.id));
+        if (claim.status === "supported" && gate && !gate.ok)
+            suggestions.push({ id: `suggestion_${randomUUID().replaceAll("-", "")}`, role: "evidence-auditor", priority: "block", target: claim.id, suggestion: "downgrade or substantiate this claim", rationale: "the evidence gate does not pass", status: "proposed" });
+        if (claim.kind !== "result" && /\b(?:causes?|leads? to|proves?|established)\b/i.test(claim.text))
+            suggestions.push({ id: `suggestion_${randomUUID().replaceAll("-", "")}`, role: "methodologist", priority: "warn", target: claim.id, suggestion: "replace causal or confirmatory wording with evidence-qualified language", rationale: "the claim is not a verified result artifact", status: "proposed" });
+    }
+    if (suggestions.length === 0)
+        suggestions.push({ id: `suggestion_${randomUUID().replaceAll("-", "")}`, role: "editor", priority: "warn", suggestion: "retain the current text and document the human review decision", rationale: "no automatic revision is performed by this workflow", status: "proposed" });
+    const result = { schemaVersion: "psyclaw/expert-review/v1", version, workflowVersion: expertReviewWorkflowSpec.version, roles: options.roles ?? DEFAULT_REVIEWER_ROLES, approval: approval ? { ...approval, at: approval.at ?? new Date().toISOString() } : { status: "pending" }, suggestions, findingCount: suggestions.length };
+    const markdown = [`# Expert Review ${version}`, "", `Research goal: ${project.goal}`, "", "Recommendations are proposals only; this workflow never edits manuscript text.", "", "## Recommendations", "", ...suggestions.map((item) => `- [${item.priority}] ${item.role}: ${item.suggestion}${item.target ? ` (${item.target})` : ""}`), ""].join("\n");
+    const receipt = { schemaVersion: "psyclaw/review-receipt/v1", runId: `review:${version}`, workflow: expertReviewWorkflowSpec.id, version, approval: approval?.approved ? "approved" : "pending", actor: approval?.actor ?? null, idempotencyKey: `expert-review:${version}`, createdAt: new Date().toISOString() };
+    await appendJsonl(projectPaths(root).audit, { schemaVersion: "psyclaw/audit/v1", action: "expert-review", workflow: expertReviewWorkflowSpec.id, version, approval: receipt.approval, actor: receipt.actor, receipt: receipt.schemaVersion, at: receipt.createdAt });
+    return finalizeWorkflow(root, expertReviewWorkflowSpec, { gates, outputs: [{ path: "expert-review.md", contents: markdown }, { path: "review-result.json", contents: `${JSON.stringify(result, null, 2)}\n` }, { path: "review-suggestions.json", contents: `${JSON.stringify({ schemaVersion: "psyclaw/review-suggestions/v1", version, suggestions }, null, 2)}\n` }, { path: `expert-review-${version}.md`, contents: markdown }, { path: `review-receipt-${version}.json`, contents: `${JSON.stringify(receipt, null, 2)}\n` }], completed: ["four reviewer roles evaluated the ledger", "standardized review result produced", "revision suggestions recorded without editing source text"] });
+}
+//# sourceMappingURL=expert-review-runner.js.map

package/dist/src/workflows/expert-review-runner.js.map

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

package/dist/src/workflows/expert-review.d.ts

@@ -0,0 +1,140 @@
+import { Type } from "typebox";
+/** The smallest independent panel used for a bounded manuscript review. */
+export type ExpertReviewRole = "methodologist" | "evidence-critic" | "writing-editor" | "devil-advocate" | "ethics-reviewer" | "reproducibility-reviewer";
+export type ExpertReviewSeverity = "block" | "major" | "minor" | "note";
+export type ExpertReviewDisposition = "accept" | "revise" | "reject" | "uncertain";
+export interface ExpertReviewFinding {
+    id: string;
+    severity: ExpertReviewSeverity;
+    rule: string;
+    message: string;
+    /** A finding must point to an input, claim, or artifact when one exists. */
+    refs: string[];
+    disposition: ExpertReviewDisposition;
+}
+export interface ExpertReviewOpinion {
+    schemaVersion: "psyclaw/expert-review-opinion/v1";
+    runId: string;
+    taskId: string;
+    dispatchId: string;
+    expertId: string;
+    role: ExpertReviewRole;
+    outcome: "complete" | "blocked" | "uncertain";
+    summary: string;
+    findings: ExpertReviewFinding[];
+    /** Empty is valid only when the expert explicitly reports no findings. */
+    evidenceRefs: string[];
+}
+export interface ExpertReviewContract {
+    schemaVersion: "psyclaw/expert-review/v1";
+    runId: string;
+    subject: {
+        kind: "manuscript" | "artifact" | "workflow";
+        ref: string;
+    };
+    inputRefs: string[];
+    experts: {
+        expertId: string;
+        role: ExpertReviewRole;
+        taskId: string;
+    }[];
+    requiredRoles: ExpertReviewRole[];
+    minOpinions: number;
+    independent: true;
+    output: {
+        artifactPath: string;
+        verdictPath: string;
+    };
+}
+export interface ExpertReviewResult {
+    schemaVersion: "psyclaw/expert-review-result/v1";
+    runId: string;
+    verdict: "pass" | "blocked" | "uncertain";
+    opinions: ExpertReviewOpinion[];
+    findings: ExpertReviewFinding[];
+    unresolvedRoles: ExpertReviewRole[];
+    /** Aggregation is a report only; it never upgrades an unsupported finding. */
+    blockReasons: string[];
+}
+export declare const ExpertReviewOpinionSchema: Type.TObject<{
+    schemaVersion: Type.TLiteral<"psyclaw/expert-review-opinion/v1">;
+    runId: Type.TString;
+    taskId: Type.TString;
+    dispatchId: Type.TString;
+    expertId: Type.TString;
+    role: Type.TUnion<[Type.TLiteral<"methodologist">, Type.TLiteral<"evidence-critic">, Type.TLiteral<"writing-editor">, Type.TLiteral<"devil-advocate">, Type.TLiteral<"ethics-reviewer">, Type.TLiteral<"reproducibility-reviewer">]>;
+    outcome: Type.TUnion<[Type.TLiteral<"complete">, Type.TLiteral<"blocked">, Type.TLiteral<"uncertain">]>;
+    summary: Type.TString;
+    findings: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        severity: Type.TUnion<[Type.TLiteral<"block">, Type.TLiteral<"major">, Type.TLiteral<"minor">, Type.TLiteral<"note">]>;
+        rule: Type.TString;
+        message: Type.TString;
+        refs: Type.TArray<Type.TString>;
+        disposition: Type.TUnion<[Type.TLiteral<"accept">, Type.TLiteral<"revise">, Type.TLiteral<"reject">, Type.TLiteral<"uncertain">]>;
+    }>>;
+    evidenceRefs: Type.TArray<Type.TString>;
+}>;
+export declare const ExpertReviewContractSchema: Type.TObject<{
+    schemaVersion: Type.TLiteral<"psyclaw/expert-review/v1">;
+    runId: Type.TString;
+    subject: Type.TObject<{
+        kind: Type.TUnion<[Type.TLiteral<"manuscript">, Type.TLiteral<"artifact">, Type.TLiteral<"workflow">]>;
+        ref: Type.TString;
+    }>;
+    inputRefs: Type.TArray<Type.TString>;
+    experts: Type.TArray<Type.TObject<{
+        expertId: Type.TString;
+        role: Type.TUnion<[Type.TLiteral<"methodologist">, Type.TLiteral<"evidence-critic">, Type.TLiteral<"writing-editor">, Type.TLiteral<"devil-advocate">, Type.TLiteral<"ethics-reviewer">, Type.TLiteral<"reproducibility-reviewer">]>;
+        taskId: Type.TString;
+    }>>;
+    requiredRoles: Type.TArray<Type.TUnion<[Type.TLiteral<"methodologist">, Type.TLiteral<"evidence-critic">, Type.TLiteral<"writing-editor">, Type.TLiteral<"devil-advocate">, Type.TLiteral<"ethics-reviewer">, Type.TLiteral<"reproducibility-reviewer">]>>;
+    minOpinions: Type.TInteger;
+    independent: Type.TLiteral<true>;
+    output: Type.TObject<{
+        artifactPath: Type.TString;
+        verdictPath: Type.TString;
+    }>;
+}>;
+export declare const ExpertReviewResultSchema: Type.TObject<{
+    schemaVersion: Type.TLiteral<"psyclaw/expert-review-result/v1">;
+    runId: Type.TString;
+    verdict: Type.TUnion<[Type.TLiteral<"pass">, Type.TLiteral<"blocked">, Type.TLiteral<"uncertain">]>;
+    opinions: Type.TArray<Type.TObject<{
+        schemaVersion: Type.TLiteral<"psyclaw/expert-review-opinion/v1">;
+        runId: Type.TString;
+        taskId: Type.TString;
+        dispatchId: Type.TString;
+        expertId: Type.TString;
+        role: Type.TUnion<[Type.TLiteral<"methodologist">, Type.TLiteral<"evidence-critic">, Type.TLiteral<"writing-editor">, Type.TLiteral<"devil-advocate">, Type.TLiteral<"ethics-reviewer">, Type.TLiteral<"reproducibility-reviewer">]>;
+        outcome: Type.TUnion<[Type.TLiteral<"complete">, Type.TLiteral<"blocked">, Type.TLiteral<"uncertain">]>;
+        summary: Type.TString;
+        findings: Type.TArray<Type.TObject<{
+            id: Type.TString;
+            severity: Type.TUnion<[Type.TLiteral<"block">, Type.TLiteral<"major">, Type.TLiteral<"minor">, Type.TLiteral<"note">]>;
+            rule: Type.TString;
+            message: Type.TString;
+            refs: Type.TArray<Type.TString>;
+            disposition: Type.TUnion<[Type.TLiteral<"accept">, Type.TLiteral<"revise">, Type.TLiteral<"reject">, Type.TLiteral<"uncertain">]>;
+        }>>;
+        evidenceRefs: Type.TArray<Type.TString>;
+    }>>;
+    findings: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        severity: Type.TUnion<[Type.TLiteral<"block">, Type.TLiteral<"major">, Type.TLiteral<"minor">, Type.TLiteral<"note">]>;
+        rule: Type.TString;
+        message: Type.TString;
+        refs: Type.TArray<Type.TString>;
+        disposition: Type.TUnion<[Type.TLiteral<"accept">, Type.TLiteral<"revise">, Type.TLiteral<"reject">, Type.TLiteral<"uncertain">]>;
+    }>>;
+    unresolvedRoles: Type.TArray<Type.TUnion<[Type.TLiteral<"methodologist">, Type.TLiteral<"evidence-critic">, Type.TLiteral<"writing-editor">, Type.TLiteral<"devil-advocate">, Type.TLiteral<"ethics-reviewer">, Type.TLiteral<"reproducibility-reviewer">]>>;
+    blockReasons: Type.TArray<Type.TString>;
+}>;
+export declare function validateExpertReviewContract(value: unknown): ExpertReviewContract;
+export declare function validateExpertReviewOpinion(value: unknown): ExpertReviewOpinion;
+export declare function validateExpertReviewResult(value: unknown): ExpertReviewResult;
+/**
+ * Deterministically combines independent opinions. It does not infer a
+ * finding from a vote and never upgrades an uncertain or blocked opinion.
+ */
+export declare function aggregateExpertReview(contractValue: unknown, opinionValues: readonly unknown[]): ExpertReviewResult;