psyclaw 0.25.2 → 0.26.0

package/dist/src/workflows/publish.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Generation-time manuscript publishing with versioning (convention:
+ * docs/文档规范.md).
+ *
+ *   paper/<name>.md                latest editable Markdown source
+ *   paper/<name>_APA7.docx         latest APA-7 DOCX export
+ *   paper/archive/<name>_v{n}.md   archived previous versions
+ *   .psyclaw/versions.jsonl          version allocation (allocateProjectVersion,
+ *                                  kind "manuscript")
+ *   .psyclaw/publish.jsonl           published-version records (idempotent by sha)
+ *
+ * Re-publishing identical content is a no-op (no new version); changed content
+ * archives the previous files and bumps the version. Both files are registered
+ * in the evidence ledger with their SHA-256 fingerprints.
+ */
+/** A published manuscript version (one record per publish). */
+export interface PublishedVersion {
+    schemaVersion: "psyclaw/publish/v1";
+    version: number;
+    name: string;
+    markdownPath: string;
+    docxPath: string | null;
+    markdownSha256: string;
+    docxSha256: string | null;
+    sourcePath: string | null;
+    publishedAt: string;
+}
+export declare function readPublishedVersions(root: string): Promise<PublishedVersion[]>;
+/** Find a black-and-white reference document (paper/apa7-bw-reference.docx or similar). */
+export declare function findReferenceDoc(root: string): Promise<string | null>;
+export interface PublishOptions {
+    /** Base file name, e.g. "论文初稿" (default). */
+    name?: string;
+    /** Manuscript source (Markdown). If omitted, the discovered manuscript is used. */
+    markdown?: string;
+    /** Export the APA-7 DOCX (default true). */
+    exportDocx?: boolean;
+}
+export interface PublishResult {
+    schemaVersion: "psyclaw/publish/v1";
+    version: number;
+    name: string;
+    markdownPath: string;
+    docxPath: string | null;
+    markdownSha256: string;
+    docxSha256: string | null;
+    evidenceIds: string[];
+    sourcePath: string | null;
+    publishedAt: string;
+}
+export declare function publishManuscript(root: string, options?: PublishOptions): Promise<PublishResult>;

package/dist/src/workflows/publish.js

@@ -0,0 +1,153 @@
+import { randomUUID } from "node:crypto";
+import { lstat, readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { markdownToDocx } from "../core/docx.js";
+import { sha256File, sha256Text } from "../core/hash.js";
+import { atomicWriteFile, appendJsonlIfMissing, readJsonl } from "../project/jsonl.js";
+import { assertSafeProjectPath, projectPaths } from "../project/paths.js";
+import { readManuscript } from "../project/manuscript.js";
+import { allocateProjectVersion } from "../project/versions.js";
+export async function readPublishedVersions(root) {
+    return readJsonl(await assertSafeProjectPath(root, ".psyclaw/publish.jsonl"));
+}
+async function archiveFile(root, sourceRel, targetRel) {
+    try {
+        const source = await assertSafeProjectPath(root, sourceRel);
+        const contents = await readFile(source, "utf8");
+        await atomicWriteFile(await assertSafeProjectPath(root, targetRel), contents);
+    }
+    catch { /* nothing to archive */ }
+}
+/** Find a black-and-white reference document (paper/apa7-bw-reference.docx or similar). */
+export async function findReferenceDoc(root) {
+    let entries = [];
+    try {
+        entries = await readdir(join(root, "paper"), { withFileTypes: true });
+    }
+    catch {
+        return null;
+    }
+    for (const entry of entries) {
+        if (!entry.isFile() || !/\.docx$/i.test(entry.name))
+            continue;
+        if (/reference|模板|template/i.test(entry.name)) {
+            const path = `paper/${entry.name}`;
+            const stat = await lstat(await assertSafeProjectPath(root, path)).catch(() => undefined);
+            if (stat?.isFile())
+                return path;
+        }
+    }
+    return null;
+}
+export async function publishManuscript(root, options = {}) {
+    const name = (options.name ?? "论文初稿").trim().replace(/\.(md|docx)$/i, "");
+    if (!name)
+        throw new Error("manuscript name is required");
+    const exportDocx = options.exportDocx ?? true;
+    const existing = await readManuscript(root);
+    const sourcePath = existing.exists ? existing.path : null;
+    const markdown = options.markdown ?? existing.markdown;
+    if (!markdown.trim()) {
+        throw new Error("没有可发布的手稿内容：请先在编辑器写入内容，或先运行工作流生成论文初稿");
+    }
+    const markdownPath = `paper/${name}.md`;
+    const markdownTarget = await assertSafeProjectPath(root, markdownPath);
+    const written = markdown.endsWith("\n") ? markdown : `${markdown}\n`;
+    const markdownSha256 = sha256Text(written);
+    const published = await readPublishedVersions(root);
+    const last = published.at(-1);
+    if (last && last.markdownSha256 === markdownSha256) {
+        // Re-publishing identical content is a no-op: no new version, no rewrite.
+        return {
+            schemaVersion: "psyclaw/publish/v1",
+            version: last.version,
+            name: last.name,
+            markdownPath: last.markdownPath,
+            docxPath: last.docxPath,
+            markdownSha256,
+            docxSha256: last.docxSha256,
+            evidenceIds: [],
+            sourcePath,
+            publishedAt: last.publishedAt,
+        };
+    }
+    // Archive the current files under the version they were last published as.
+    if (last) {
+        await archiveFile(root, markdownPath, `paper/archive/${name}_v${last.version}.md`);
+        if (last.docxPath)
+            await archiveFile(root, last.docxPath, `paper/archive/${name}_v${last.version}_APA7.docx`);
+    }
+    // Allocate the next manuscript version through the shared project allocator.
+    const runId = `publish_${randomUUID().replaceAll("-", "")}`;
+    const versionLabel = await allocateProjectVersion(root, "manuscript", runId);
+    const version = Number(versionLabel.replace(/^v/i, ""));
+    await atomicWriteFile(markdownTarget, written);
+    const evidenceIds = [];
+    const recordEvidence = async (path, sha256) => {
+        const id = `evidence_${sha256.slice(0, 16)}`;
+        // Idempotent by evidence id: publishing and importing the same file must
+        // not create duplicate ledger entries.
+        await appendJsonlIfMissing(projectPaths(root).evidence, {
+            id,
+            source: { kind: "file", locator: path, title: path.split("/").pop() ?? path },
+            level: "fulltext",
+            retrievedAt: new Date().toISOString(),
+            sha256,
+            accessStatus: "partial",
+            locators: [{ kind: "file", value: path }],
+        }, (item) => item.id);
+        return id;
+    };
+    evidenceIds.push(await recordEvidence(markdownPath, markdownSha256));
+    let docxPath = null;
+    let docxSha256 = null;
+    if (exportDocx) {
+        docxPath = `paper/${name}_APA7.docx`;
+        const docxTarget = await assertSafeProjectPath(root, docxPath);
+        const referenceDoc = await findReferenceDoc(root);
+        const referenceTarget = referenceDoc ? await assertSafeProjectPath(root, referenceDoc) : undefined;
+        await markdownToDocx(markdownTarget, docxTarget, referenceTarget);
+        docxSha256 = await sha256File(docxTarget);
+        evidenceIds.push(await recordEvidence(docxPath, docxSha256));
+    }
+    const publishedAt = new Date().toISOString();
+    const versionRecord = {
+        schemaVersion: "psyclaw/publish/v1",
+        version,
+        name,
+        markdownPath,
+        docxPath,
+        markdownSha256,
+        docxSha256,
+        sourcePath,
+        publishedAt,
+    };
+    await appendJsonlIfMissing(await assertSafeProjectPath(root, ".psyclaw/publish.jsonl"), versionRecord, (record) => record.markdownSha256);
+    const result = {
+        schemaVersion: "psyclaw/publish/v1",
+        version,
+        name,
+        markdownPath,
+        docxPath,
+        markdownSha256,
+        docxSha256,
+        evidenceIds,
+        sourcePath,
+        publishedAt,
+    };
+    const receipt = {
+        schemaVersion: "psyclaw/tool-receipt/v1",
+        runId,
+        taskId: "workflow.publish.manuscript",
+        tool: "workflow.publish.manuscript",
+        effect: "write",
+        approval: "approved",
+        idempotencyKey: `publish:${markdownSha256}`,
+        ok: true,
+        startedAt: publishedAt,
+        finishedAt: publishedAt,
+    };
+    await atomicWriteFile(await assertSafeProjectPath(root, `.psyclaw/manifests/${runId}.receipt.json`), `${JSON.stringify(receipt, null, 2)}\n`);
+    return result;
+}
+//# sourceMappingURL=publish.js.map

package/dist/src/workflows/publish.js.map

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

package/dist/src/workflows/spec.d.ts

@@ -0,0 +1,51 @@
+import type { GateResult, Handoff, ResearchParadigm } from "../core/contracts.js";
+export declare const WORKFLOW_SCHEMA: "psyclaw/workflow/v1";
+export type WorkflowRole = "researcher" | "analyst" | "critic" | "writer" | "verifier";
+export type WorkflowEffect = "read" | "write";
+export interface WorkflowStep {
+    id: string;
+    role: WorkflowRole;
+    effect: WorkflowEffect;
+    description: string;
+}
+export interface WorkflowSpec {
+    id: string;
+    version: string;
+    description: string;
+    paradigms: readonly ResearchParadigm[];
+    steps: readonly WorkflowStep[];
+    requiredArtifacts: readonly string[];
+}
+export interface WorkflowOutputRecord {
+    path: string;
+    sha256: string;
+    artifactVersion: string;
+    format: "json" | "markdown" | "text" | "unknown";
+    status: "verified" | "draft-blocked";
+}
+export interface WorkflowResult {
+    runId: string;
+    workflowId: string;
+    verdict: "pass" | "blocked";
+    gates: GateResult[];
+    outputPaths: string[];
+    manifestPath: string;
+    verdictPath: string;
+    outputIndexPath: string;
+    handoff: Handoff;
+}
+export declare const allParadigms: readonly ResearchParadigm[];
+/**
+ * Shared tail for every workflow pack. Outputs are written to safe project
+ * paths, the spec's required artifacts are actually checked, every output is
+ * SHA-pinned with a workflow version and input fingerprint, and `completed`
+ * is emitted only after outputs, manifest, and verdict are all on disk.
+ */
+export declare function finalizeWorkflow(root: string, workflow: WorkflowSpec, options: {
+    gates: GateResult[];
+    outputs: {
+        path: string;
+        contents: string;
+    }[];
+    completed: string[];
+}): Promise<WorkflowResult>;

package/dist/src/workflows/spec.js

@@ -0,0 +1,157 @@
+import { randomUUID } from "node:crypto";
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { sha256Text } from "../core/hash.js";
+import { assertSafeProjectPath, projectPaths } from "../project/paths.js";
+import { writeHandoff } from "../project/bootstrap.js";
+import { atomicWriteFile } from "../project/jsonl.js";
+import { readProject } from "../research/ledger.js";
+import { RunEventLog } from "../panel/events.js";
+export const WORKFLOW_SCHEMA = "psyclaw/workflow/v1";
+const ALL_PARADIGMS = [
+    "survey-observational",
+    "qualitative-thematic",
+    "experimental",
+    "quasi-experimental",
+    "longitudinal-panel",
+    "meta-analysis",
+    "ethnographic",
+    "historical-documentary",
+    "policy-legal",
+    "mixed-methods",
+];
+export const allParadigms = ALL_PARADIGMS;
+/**
+ * Reject a workflow output path before it is resolved, so a `..` segment or
+ * drive/ADS form cannot be collapsed away before the containment check.
+ */
+async function safeOutputPath(root, outputPath) {
+    const normalized = outputPath.trim().replaceAll("\\", "/");
+    if (normalized.length === 0 ||
+        normalized.startsWith("/") ||
+        /^[a-z]:/.test(normalized) ||
+        normalized.includes("\0") ||
+        normalized.split("/").some((segment) => segment === ".." || segment === "")) {
+        throw new Error(`unsafe output path: ${outputPath}`);
+    }
+    return assertSafeProjectPath(root, join("outputs", normalized));
+}
+/**
+ * Shared tail for every workflow pack. Outputs are written to safe project
+ * paths, the spec's required artifacts are actually checked, every output is
+ * SHA-pinned with a workflow version and input fingerprint, and `completed`
+ * is emitted only after outputs, manifest, and verdict are all on disk.
+ */
+export async function finalizeWorkflow(root, workflow, options) {
+    const paths = projectPaths(root);
+    const project = await readProject(root);
+    const runId = `run_${randomUUID().replaceAll("-", "")}`;
+    const gates = [...options.gates];
+    const eventLog = new RunEventLog(root, runId);
+    const eventAt = new Date().toISOString();
+    // planned first; any later failure only ever emits blocked/unknown.
+    await eventLog.append({ type: "planned", at: eventAt });
+    await mkdir(paths.manifests, { recursive: true });
+    await mkdir(paths.outputs, { recursive: true });
+    const outputPaths = [];
+    const outputRecords = [];
+    const artifactVersion = workflow.version;
+    const formatOf = (path) => {
+        const lower = path.toLowerCase();
+        if (lower.endsWith(".json"))
+            return "json";
+        if (lower.endsWith(".md") || lower.endsWith(".markdown"))
+            return "markdown";
+        if (lower.endsWith(".txt"))
+            return "text";
+        return "unknown";
+    };
+    for (const output of options.outputs) {
+        const target = await safeOutputPath(paths.root, output.path);
+        await atomicWriteFile(target, output.contents);
+        outputPaths.push(target);
+        outputRecords.push({ path: output.path, sha256: sha256Text(output.contents), artifactVersion, format: formatOf(output.path), status: "draft-blocked" });
+    }
+    // The spec's required artifacts must actually be produced.
+    for (const required of workflow.requiredArtifacts) {
+        if (!outputRecords.some((record) => record.path === required)) {
+            gates.push({
+                gateId: "workflow:missing-artifact",
+                ok: false,
+                severity: "block",
+                reason: `required artifact not produced: ${required}`,
+            });
+        }
+    }
+    const blocked = gates.filter((gate) => !gate.ok);
+    for (const gate of gates)
+        await eventLog.append({ type: "gate", at: eventAt, message: gate.reason });
+    const verifiedRecords = outputRecords.map((record) => ({
+        ...record,
+        status: blocked.length === 0 ? "verified" : "draft-blocked",
+    }));
+    const manifestPath = join(paths.manifests, `${runId}.json`);
+    const manifest = {
+        schemaVersion: "psyclaw/workflow-manifest/v1",
+        workflow: workflow.id,
+        workflowVersion: workflow.version,
+        runId,
+        inputDigest: sha256Text(`${project.goal}\u0000${project.paradigm}`),
+        outputs: verifiedRecords,
+        gates,
+        generatedAt: new Date().toISOString(),
+    };
+    await atomicWriteFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    const verdictPath = join(paths.manifests, `${runId}.verdict.json`);
+    const verdict = {
+        schemaVersion: "psyclaw/verdict/v1",
+        runId,
+        verdict: blocked.length === 0 ? "pass" : "blocked",
+        workflow: workflow.id,
+        manifestPath,
+        gateCount: gates.length,
+        blockedGateCount: blocked.length,
+        generatedAt: new Date().toISOString(),
+    };
+    await atomicWriteFile(verdictPath, `${JSON.stringify(verdict, null, 2)}\n`);
+    const outputIndexPath = await assertSafeProjectPath(root, "outputs/index.json");
+    await atomicWriteFile(outputIndexPath, `${JSON.stringify({
+        schemaVersion: "psyclaw/output-index/v1",
+        runId,
+        workflow: workflow.id,
+        workflowVersion: workflow.version,
+        artifacts: verifiedRecords,
+        generatedAt: new Date().toISOString(),
+    }, null, 2)}\n`);
+    const handoff = await writeHandoff(root, {
+        projectId: project.id,
+        runId,
+        goal: project.goal,
+        completed: options.completed,
+        verified: blocked.length === 0
+            ? ["outputs", "output index", "manifest", "verdict"]
+            : ["manifest", "verdict"],
+        blocked: blocked.map((gate) => gate.reason),
+        nextSteps: blocked.length === 0 ? ["human review before external use"] : ["resolve blocked workflow gates"],
+        verificationCommands: ["pnpm typecheck", "pnpm test"],
+        generatedAt: new Date().toISOString(),
+    });
+    // completed/blocked is emitted last, only after every artifact is on disk.
+    await eventLog.append({
+        type: blocked.length === 0 ? "completed" : "blocked",
+        at: eventAt,
+        message: blocked.length === 0 ? `${workflow.id} completed` : `${workflow.id} blocked`,
+    });
+    return {
+        runId,
+        workflowId: workflow.id,
+        verdict: blocked.length === 0 ? "pass" : "blocked",
+        gates,
+        outputPaths,
+        manifestPath,
+        verdictPath,
+        outputIndexPath,
+        handoff,
+    };
+}
+//# sourceMappingURL=spec.js.map

package/dist/src/workflows/spec.js.map

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

package/dist/src/workflows/style-contract.d.ts

@@ -0,0 +1,24 @@
+export type StyleArtifactKind = "manuscript" | "figure" | "table";
+export interface JournalStyleProfile {
+    schemaVersion: "psyclaw/journal-style/v1";
+    journal: string;
+    source: string;
+    ref: string;
+    version: string;
+    license?: string;
+    rules: Record<string, string | number | boolean>;
+}
+export interface StyleArtifactContract {
+    schemaVersion: "psyclaw/style-artifact/v1";
+    kind: StyleArtifactKind;
+    id: string;
+    version: string;
+    format: string;
+    profile: string;
+    sourceHash?: string;
+    scriptPath?: string;
+    inputHash?: string;
+}
+export declare const defaultJournalStyle: JournalStyleProfile;
+export declare function validateStyleArtifact(value: StyleArtifactContract): StyleArtifactContract;
+export declare function resolveJournalStyle(profile?: JournalStyleProfile): JournalStyleProfile;

package/dist/src/workflows/style-contract.js

@@ -0,0 +1,23 @@
+export const defaultJournalStyle = {
+    schemaVersion: "psyclaw/journal-style/v1",
+    journal: "default-scientific",
+    source: "psyclaw-built-in",
+    ref: "default-v1",
+    version: "1.0.0",
+    rules: { citations: "author-year-or-numbered", figureFormat: "png-or-pdf", tableFormat: "tsv-or-csv", discloseUncertainty: true },
+};
+export function validateStyleArtifact(value) {
+    if (value.schemaVersion !== "psyclaw/style-artifact/v1" || !value.id || !value.version || !value.format || !value.profile)
+        throw new Error("invalid psyclaw/style-artifact/v1");
+    if ((value.kind === "figure" || value.kind === "table") && (!value.scriptPath || !value.inputHash))
+        throw new Error("data-derived figures and tables require scriptPath and inputHash");
+    return value;
+}
+export function resolveJournalStyle(profile) {
+    if (!profile)
+        return defaultJournalStyle;
+    if (profile.schemaVersion !== "psyclaw/journal-style/v1" || !profile.source || !profile.ref || !profile.version || !profile.license)
+        throw new Error("journal profile requires source, ref, version, and license");
+    return profile;
+}
+//# sourceMappingURL=style-contract.js.map

package/dist/src/workflows/style-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-contract.js","sourceRoot":"","sources":["../../../src/workflows/style-contract.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,mBAAmB,GAAwB;IACtD,aAAa,EAAE,0BAA0B;IACzC,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,kBAAkB;IAC1B,GAAG,EAAE,YAAY;IACjB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,EAAE,SAAS,EAAE,yBAAyB,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,IAAI,EAAE;CAClI,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,KAA4B;IAChE,IAAI,KAAK,CAAC,aAAa,KAAK,2BAA2B,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAChL,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACxL,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO,mBAAmB,CAAC;IACzC,IAAI,OAAO,CAAC,aAAa,KAAK,0BAA0B,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACnN,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,15 @@
+import { type WorkflowResult, type WorkflowSpec } from "./spec.js";
+export declare const writingReviewSpec: WorkflowSpec;
+export interface ReviewFinding {
+    severity: "block" | "warn";
+    rule: string;
+    claimId?: string;
+    message: string;
+}
+export interface ReviewSuggestion {
+    severity: "block" | "warn";
+    rule: string;
+    claimId?: string;
+    suggestion: string;
+}
+export declare function runWritingReview(root: string): Promise<WorkflowResult>;

package/dist/src/workflows/writing-review.js

@@ -0,0 +1,82 @@
+import { checkEvidenceSufficiency } from "../core/evidence-policy.js";
+import { loadLedger, readProject } from "../research/ledger.js";
+import { allParadigms, finalizeWorkflow } from "./spec.js";
+import { allocateProjectVersion } from "../project/versions.js";
+export const writingReviewSpec = {
+    id: "writing-review",
+    version: "1.0.0",
+    description: "Audit drafted claims against evidence, honesty, and causal-language rules.",
+    paradigms: allParadigms,
+    steps: [
+        { id: "read", role: "verifier", effect: "read", description: "load claims and evidence" },
+        { id: "check", role: "critic", effect: "read", description: "honesty and causal-language heuristics" },
+        { id: "write", role: "writer", effect: "write", description: "write findings report" },
+    ],
+    requiredArtifacts: ["writing-review.md", "review-findings.json", "review-suggestions.json"],
+};
+const CAUSAL_PATTERN = /\b(?:causes?|leads? to|determines?|increases?|decreases?|drives?|improves?)\b/i;
+const CONFIRMATORY_PATTERN = /\b(?:proves?|proven|established)\b/i;
+export async function runWritingReview(root) {
+    const project = await readProject(root);
+    const ledger = await loadLedger(root);
+    const gates = checkEvidenceSufficiency({ ...ledger, paradigm: project.paradigm });
+    const version = await allocateProjectVersion(root, "manuscript-revision", `writing-review:${Date.now()}`);
+    const gateByClaim = new Map(gates.map((gate) => [gate.claimIds?.[0], gate]));
+    const findings = [];
+    for (const claim of ledger.claims) {
+        const gate = gateByClaim.get(claim.id);
+        if (claim.status === "supported" && gate && !gate.ok) {
+            findings.push({
+                severity: "block",
+                rule: "unsupported-claim-asserted-as-supported",
+                claimId: claim.id,
+                message: `claim ${claim.id} is marked supported but fails its evidence gate`,
+            });
+        }
+        if (claim.kind !== "result" && CAUSAL_PATTERN.test(claim.text)) {
+            findings.push({
+                severity: "warn",
+                rule: "causal-language-without-result-artifact",
+                claimId: claim.id,
+                message: `claim ${claim.id} uses causal language but is not backed by a result artifact`,
+            });
+        }
+        if (claim.kind === "result" && CONFIRMATORY_PATTERN.test(claim.text)) {
+            findings.push({
+                severity: "warn",
+                rule: "confirmatory-language",
+                claimId: claim.id,
+                message: `claim ${claim.id} asserts a proof or established fact; prefer uncertainty-qualified language`,
+            });
+        }
+    }
+    const report = {
+        schemaVersion: "psyclaw/writing-review/v1",
+        version,
+        findings,
+        blockCount: findings.filter((finding) => finding.severity === "block").length,
+        suggestions: findings.map((finding) => ({ severity: finding.severity, rule: finding.rule, ...(finding.claimId ? { claimId: finding.claimId } : {}), suggestion: finding.message })),
+    };
+    const markdown = [
+        `# Writing Review ${version}`,
+        "",
+        `Research goal: ${project.goal}`,
+        "",
+        "## Findings",
+        "",
+        ...(findings.length ? findings.map((finding) => `- [${finding.severity}] ${finding.rule}: ${finding.message}`) : ["- None"]),
+        "",
+    ].join("\n");
+    return finalizeWorkflow(root, writingReviewSpec, {
+        gates,
+        outputs: [
+            { path: "writing-review.md", contents: markdown },
+            { path: "review-findings.json", contents: `${JSON.stringify(report, null, 2)}\n` },
+            { path: "review-suggestions.json", contents: `${JSON.stringify({ schemaVersion: "psyclaw/review-suggestions/v1", version, suggestions: report.suggestions }, null, 2)}\n` },
+            { path: `writing-review-${version}.md`, contents: markdown },
+            { path: `review-findings-${version}.json`, contents: `${JSON.stringify(report, null, 2)}\n` },
+        ],
+        completed: ["claims loaded", "honesty heuristics applied", "findings reported"],
+    });
+}
+//# sourceMappingURL=writing-review.js.map

package/dist/src/workflows/writing-review.js.map

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

package/package.json

@@ -1,17 +1,29 @@
 {
   "name": "psyclaw",
-  "version": "0.25.2",
+  "version": "0.26.0",
   "description": "A standalone, evidence-grounded social-science research agent — a conversation-driven agent that bundles the Pi runtime with psyclaw's research contracts, evidence gates, and workflows",
   "type": "module",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Exekiel179/psyclaw.git"
+  },
+  "homepage": "https://github.com/Exekiel179/psyclaw#readme",
+  "bugs": {
+    "url": "https://github.com/Exekiel179/psyclaw/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "bin": {
     "psyclaw": "dist/src/cli.js"
   },
   "files": [
-    "dist",
+    "dist/src",
+    "dist/apps/panel/index.html",
     "skills",
-    "apps/panel",
-    "scripts"
+    "scripts/rebrand-pi.mjs"
   ],
   "engines": {
     "node": ">=22.19.0"
@@ -27,8 +39,8 @@
   "packageManager": "pnpm@10.28.2",
   "pi": {
     "extensions": [
-      "./src/extension.ts",
-      "./src/panel/extension.ts"
+      "./dist/src/extension.js",
+      "./dist/src/panel/extension.js"
     ],
     "skills": [
       "./skills/core"
@@ -42,8 +54,8 @@
     "eval": "tsx evals/harness.ts",
     "eval:modules": "tsx evals/modules.ts",
     "rebrand": "node scripts/rebrand-pi.mjs",
-    "postinstall": "node scripts/rebrand-pi.mjs",
-    "prepublishOnly": "pnpm build"
+    "check:branding": "node scripts/check-branding.mjs",
+    "prepublishOnly": "pnpm check:branding && pnpm build"
   },
   "dependencies": {
     "@earendil-works/pi-ai": "0.84.1",