psyclaw 0.24.0

package/dist/src/core/citations.js

@@ -0,0 +1,48 @@
+import { sha256Text } from "./hash.js";
+import { readJsonl, appendJsonlIfMissing } from "../project/jsonl.js";
+import { assertSafeProjectPath } from "../project/paths.js";
+import { referenceFromVerification, upsertReference } from "./references.js";
+import { verifyDoi } from "./doi.js";
+export async function citationsPath(root) {
+    return assertSafeProjectPath(root, ".psyclaw/citations.jsonl");
+}
+export async function listCitationUses(root) {
+    return readJsonl(await citationsPath(root));
+}
+/**
+ * Record one citation use: verify the DOI (real network unless a verifier is
+ * injected), archive the reference when verifiable, then append the use with
+ * its reason. The use is always recorded (with `verified` reflecting the
+ * verification outcome) so the citation reason is never lost.
+ */
+export async function recordCitationUse(root, input, verify = verifyDoi) {
+    const doi = input.doi.trim();
+    const reason = input.reason.trim();
+    const context = input.context.trim();
+    if (!doi || !reason || !context) {
+        throw new Error("doi, reason, and context are all required");
+    }
+    const verification = await verify(doi);
+    const reference = referenceFromVerification(verification);
+    if (reference !== null) {
+        await upsertReference(root, reference);
+    }
+    const surname = (reference?.authors[0]?.split(/\s+/).at(-1) ?? doi.split("/")[0] ?? doi).slice(0, 40);
+    const citationId = `cite_${sha256Text(`${doi}\u0000${reason}\u0000${context}`).slice(0, 16)}`;
+    const record = {
+        schemaVersion: "psyclaw/citation-use/v1",
+        citationId,
+        doi,
+        surname,
+        ...(reference?.year === undefined ? {} : { year: reference.year }),
+        reason,
+        context,
+        ...(input.section === undefined || input.section.trim() === "" ? {} : { section: input.section.trim() }),
+        ...(input.claimId === undefined || input.claimId.trim() === "" ? {} : { claimId: input.claimId.trim() }),
+        verified: verification.status === "verified",
+        recordedAt: new Date().toISOString(),
+    };
+    const { appended } = await appendJsonlIfMissing(await citationsPath(root), record, (item) => item.citationId);
+    return { record, reference, appended };
+}
+//# sourceMappingURL=citations.js.map

package/dist/src/core/citations.js.map

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

package/dist/src/core/contracts.d.ts

@@ -0,0 +1,119 @@
+export declare const CONTRACT_VERSION: "psyclaw/core/v1";
+export type Effect = "read" | "write" | "network" | "destructive";
+export type EvidenceLevel = "metadata" | "abstract" | "snippet" | "fulltext" | "user";
+export type ClaimStatus = "supported" | "uncertain" | "unsupported";
+export type Relation = "supports" | "contradicts" | "context";
+export type ResearchParadigm = "survey-observational" | "qualitative-thematic" | "experimental" | "quasi-experimental" | "longitudinal-panel" | "meta-analysis" | "ethnographic" | "historical-documentary" | "policy-legal" | "mixed-methods";
+export interface ResearchProject {
+    id: string;
+    root: string;
+    paradigm: ResearchParadigm;
+    goal: string;
+    policyVersion: string;
+    createdAt: string;
+}
+export interface SourceRef {
+    kind: "doi" | "url" | "file" | "user" | "mcp";
+    locator: string;
+    title?: string;
+}
+export interface Evidence {
+    id: string;
+    source: SourceRef;
+    level: EvidenceLevel;
+    quote?: string;
+    retrievedAt: string;
+    sha256?: string;
+    accessStatus: "verified" | "partial" | "unavailable";
+    locators: EvidenceLocator[];
+}
+export interface EvidenceLocator {
+    kind: "doi" | "url" | "file" | "page" | "section" | "offset" | "row";
+    value: string;
+}
+export type ClaimKind = "existence" | "definition" | "method" | "result" | "interpretation";
+export interface Claim {
+    recordType?: "claim";
+    id: string;
+    text: string;
+    kind: ClaimKind;
+    evidenceIds: string[];
+    status: ClaimStatus;
+    uncertainty?: string;
+}
+export interface ClaimEvidenceLink {
+    recordType?: "claim-evidence-link";
+    claimId: string;
+    evidenceId: string;
+    relation: Relation;
+    locator?: EvidenceLocator;
+    rationale: string;
+}
+export interface EvidencePolicy {
+    paradigm: ResearchParadigm;
+    claimKind: ClaimKind;
+    minimumLevel: EvidenceLevel;
+    locatorRequired: boolean;
+    requiresIndependentSource: boolean;
+    requiresArtifactRun: boolean;
+}
+export interface Artifact {
+    id: string;
+    path: string;
+    sha256: string;
+    producedBy: string;
+    inputIds: string[];
+    reproducible: boolean;
+}
+export interface ToolReceipt {
+    schemaVersion: "psyclaw/tool-receipt/v1";
+    runId: string;
+    taskId: string;
+    tool: string;
+    effect: Effect;
+    approval: "not-needed" | "approved" | "denied";
+    idempotencyKey?: string;
+    ok: boolean;
+    /** Stable, non-sensitive diagnostic code for a denied or failed call. */
+    reasonCode?: string;
+    resultHash?: string;
+    startedAt: string;
+    finishedAt: string;
+}
+export interface GateResult {
+    gateId: string;
+    ok: boolean;
+    severity: "block" | "warn";
+    reason: string;
+    claimIds?: string[];
+    evidenceIds?: string[];
+}
+export interface MemoryRecord {
+    id: string;
+    kind: "profile" | "decision" | "fact" | "lesson" | "evidence";
+    scope: "session" | "project" | "user";
+    content: unknown;
+    sourceRefs: string[];
+    confidence: number;
+    status: "pending" | "active" | "archived";
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Handoff {
+    schemaVersion: "psyclaw/handoff/v1";
+    projectId: string;
+    runId: string;
+    goal: string;
+    completed: string[];
+    verified: string[];
+    blocked: string[];
+    nextSteps: string[];
+    verificationCommands: string[];
+    generatedAt: string;
+}
+export interface ResearchRequest {
+    goal: string;
+    paradigm: ResearchParadigm;
+    output: "brief" | "ledger";
+    sourcePaths: string[];
+}

package/dist/src/core/contracts.js

@@ -0,0 +1,2 @@
+export const CONTRACT_VERSION = "psyclaw/core/v1";
+//# sourceMappingURL=contracts.js.map

package/dist/src/core/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/core/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAA0B,CAAC"}

package/dist/src/core/docx.d.ts

@@ -0,0 +1,11 @@
+/** Plain text (whitespace-unwrapped) for evidence reading. */
+export declare function docxToText(path: string): Promise<string>;
+/** Markdown (structure preserved) for citation-audit and quoting. */
+export declare function docxToMarkdown(path: string): Promise<string>;
+/**
+ * Export a Markdown file to DOCX (the convention target is
+ * `paper/<name>_APA7.docx`). An optional reference document (e.g. a black and
+ * white APA-7 template) is passed through `--reference-doc` so heading/table
+ * styling follows the project template instead of pandoc defaults.
+ */
+export declare function markdownToDocx(markdownPath: string, outputPath: string, referenceDoc?: string): Promise<void>;

package/dist/src/core/docx.js

@@ -0,0 +1,46 @@
+import { spawn } from "node:child_process";
+/**
+ * Word document conversion via Pandoc. Pandoc is already part of psyclaw's DOCX
+ * export path; if it is unavailable, the caller should fall back to the
+ * markitdown skill (read) or report the failure (write).
+ */
+function runPandoc(args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("pandoc", args, {
+            stdio: ["ignore", "pipe", "pipe"],
+            shell: process.platform === "win32",
+        });
+        let output = "";
+        let errorText = "";
+        child.stdout?.on("data", (chunk) => { output += String(chunk); });
+        child.stderr?.on("data", (chunk) => { errorText += String(chunk); });
+        child.on("error", (error) => reject(new Error(`pandoc unavailable (${error.message}); install Pandoc or use the markitdown skill`)));
+        child.on("close", (code) => {
+            if (code === 0)
+                resolve(output);
+            else
+                reject(new Error(`pandoc failed (exit ${code ?? "unknown"})${errorText ? `: ${errorText.trim().slice(0, 300)}` : ""}`));
+        });
+    });
+}
+/** Plain text (whitespace-unwrapped) for evidence reading. */
+export function docxToText(path) {
+    return runPandoc([path, "-t", "plain", "--wrap=none"]);
+}
+/** Markdown (structure preserved) for citation-audit and quoting. */
+export function docxToMarkdown(path) {
+    return runPandoc([path, "-t", "markdown", "--wrap=none"]);
+}
+/**
+ * Export a Markdown file to DOCX (the convention target is
+ * `paper/<name>_APA7.docx`). An optional reference document (e.g. a black and
+ * white APA-7 template) is passed through `--reference-doc` so heading/table
+ * styling follows the project template instead of pandoc defaults.
+ */
+export async function markdownToDocx(markdownPath, outputPath, referenceDoc) {
+    const args = [markdownPath, "-o", outputPath, "--wrap=none"];
+    if (referenceDoc)
+        args.push("--reference-doc", referenceDoc);
+    await runPandoc(args);
+}
+//# sourceMappingURL=docx.js.map

package/dist/src/core/docx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx.js","sourceRoot":"","sources":["../../../src/core/docx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAc;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE;YAClC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;SACpC,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,OAAO,+CAA+C,CAAC,CAAC,CAAC,CAAC;QACrI,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,CAAC;;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,IAAI,IAAI,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/H,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,SAAS,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,SAAS,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,YAAoB,EAAE,UAAkB,EAAE,YAAqB;IAClG,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAC7D,IAAI,YAAY;QAAE,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/src/core/doi.d.ts

@@ -0,0 +1,41 @@
+/**
+ * DOI utilities: real cross-source verification (Crossref + OpenAlex) and
+ * open-access PDF lookup. Moved out of the panel server so the reference
+ * archive and any other caller can use them without a server dependency.
+ */
+export interface DoiVerification {
+    schemaVersion: "psyclaw/doi-verify/v1";
+    doi: string;
+    status: "verified" | "unverified" | "error";
+    crossref?: {
+        title?: string;
+        authors?: string[];
+        year?: number;
+        container?: string;
+    };
+    openalex?: {
+        title?: string;
+        citedBy?: number;
+    };
+    mismatch?: string;
+    error?: string;
+    verifiedAt: string;
+}
+export interface OpenAlexOaLookup {
+    doi: string;
+    oaPdfUrl: string | null;
+    isOa: boolean;
+    queriedAt: string;
+}
+/**
+ * Real cross-source DOI verification via Crossref + OpenAlex. Never fabricates
+ * a "verified" status: any network failure returns `error`.
+ */
+export declare function verifyDoi(doi: string, fetchFn?: typeof fetch): Promise<DoiVerification>;
+/**
+ * Look up an open-access PDF URL for a DOI via OpenAlex
+ * (`open_access.oa_url` / `best_oa_location.pdf_url`). Returns null when the
+ * work is not open access or the lookup fails; the caller must still verify
+ * the returned URL before downloading it.
+ */
+export declare function lookupOaPdfUrl(doi: string, fetchFn?: typeof fetch): Promise<OpenAlexOaLookup>;

package/dist/src/core/doi.js

@@ -0,0 +1,82 @@
+/**
+ * DOI utilities: real cross-source verification (Crossref + OpenAlex) and
+ * open-access PDF lookup. Moved out of the panel server so the reference
+ * archive and any other caller can use them without a server dependency.
+ */
+/**
+ * Real cross-source DOI verification via Crossref + OpenAlex. Never fabricates
+ * a "verified" status: any network failure returns `error`.
+ */
+export async function verifyDoi(doi, fetchFn = fetch) {
+    const normalized = doi.trim();
+    const verifiedAt = new Date().toISOString();
+    if (!/^10\.\d{4,9}\/\S+$/i.test(normalized)) {
+        return { schemaVersion: "psyclaw/doi-verify/v1", doi: normalized, status: "error", error: "不是合法 DOI（应为 10.xxxx/…）", verifiedAt };
+    }
+    try {
+        const [crossrefRes, openalexRes] = await Promise.all([
+            fetchFn(`https://api.crossref.org/works/${encodeURIComponent(normalized)}`, { signal: AbortSignal.timeout(12_000) }),
+            fetchFn(`https://api.openalex.org/works/doi:${encodeURIComponent(normalized)}`, { signal: AbortSignal.timeout(12_000) }),
+        ]);
+        const crossref = crossrefRes.ok
+            ? await crossrefRes.json()
+            : undefined;
+        const openalex = openalexRes.ok
+            ? await openalexRes.json()
+            : undefined;
+        const crossTitle = crossref?.message?.title?.[0];
+        const openalexTitle = openalex?.title;
+        const mismatch = crossTitle && openalexTitle && crossTitle.toLowerCase() !== openalexTitle.toLowerCase()
+            ? `Crossref 与 OpenAlex 标题不一致：「${crossTitle}」vs「${openalexTitle}」`
+            : undefined;
+        const found = Boolean(crossref || openalex);
+        return {
+            schemaVersion: "psyclaw/doi-verify/v1",
+            doi: normalized,
+            status: found && !mismatch ? "verified" : mismatch ? "unverified" : "error",
+            ...(crossref?.message ? {
+                crossref: {
+                    ...(crossref.message.title?.[0] === undefined ? {} : { title: crossref.message.title[0] }),
+                    ...(crossref.message.author && crossref.message.author.length > 0
+                        ? { authors: crossref.message.author.slice(0, 10).map((author) => [author.given, author.family].filter(Boolean).join(" ")).filter(Boolean) }
+                        : {}),
+                    ...(crossref.message.issued?.["date-parts"]?.[0]?.[0] === undefined ? {} : { year: crossref.message.issued["date-parts"][0][0] }),
+                    ...(crossref.message["container-title"]?.[0] === undefined ? {} : { container: crossref.message["container-title"][0] }),
+                },
+            } : {}),
+            ...(openalex ? { openalex: { ...(openalex.title === undefined ? {} : { title: openalex.title }), ...(openalex.cited_by_count === undefined ? {} : { citedBy: openalex.cited_by_count }) } } : {}),
+            ...(mismatch ? { mismatch } : {}),
+            ...(found ? {} : { error: "Crossref 与 OpenAlex 均未检索到该 DOI" }),
+            verifiedAt,
+        };
+    }
+    catch (error) {
+        return { schemaVersion: "psyclaw/doi-verify/v1", doi: normalized, status: "error", error: error instanceof Error ? error.message : String(error), verifiedAt };
+    }
+}
+/**
+ * Look up an open-access PDF URL for a DOI via OpenAlex
+ * (`open_access.oa_url` / `best_oa_location.pdf_url`). Returns null when the
+ * work is not open access or the lookup fails; the caller must still verify
+ * the returned URL before downloading it.
+ */
+export async function lookupOaPdfUrl(doi, fetchFn = fetch) {
+    const normalized = doi.trim();
+    const queriedAt = new Date().toISOString();
+    if (!/^10\.\d{4,9}\/\S+$/i.test(normalized)) {
+        return { doi: normalized, oaPdfUrl: null, isOa: false, queriedAt };
+    }
+    try {
+        const response = await fetchFn(`https://api.openalex.org/works/doi:${encodeURIComponent(normalized)}`, { signal: AbortSignal.timeout(12_000) });
+        if (!response.ok)
+            return { doi: normalized, oaPdfUrl: null, isOa: false, queriedAt };
+        const body = await response.json();
+        const isOa = Boolean(body.open_access?.is_oa || body.best_oa_location?.pdf_url);
+        const oaPdfUrl = body.best_oa_location?.pdf_url ?? body.open_access?.oa_url ?? null;
+        return { doi: normalized, oaPdfUrl: isOa ? oaPdfUrl : null, isOa, queriedAt };
+    }
+    catch {
+        return { doi: normalized, oaPdfUrl: null, isOa: false, queriedAt };
+    }
+}
+//# sourceMappingURL=doi.js.map

package/dist/src/core/doi.js.map

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

package/dist/src/core/evidence-policy.d.ts

@@ -0,0 +1,24 @@
+import type { Claim, ClaimEvidenceLink, Evidence, EvidencePolicy, GateResult, ResearchParadigm } from "./contracts.js";
+export declare function defaultEvidencePolicy(paradigm: ResearchParadigm, claimKind: Claim["kind"]): EvidencePolicy;
+/**
+ * The paradigm profile changes only the evidence thresholds and required
+ * reporting, never the honesty/locator/source baseline. Qualitative and
+ * ethnographic material is coded primary data: a theme does not need a second
+ * independent source or a numeric artifact run, but it still needs a located,
+ * non-user source. Absence of an effect size must not make a qualitative
+ * finding invalid.
+ */
+export declare function policiesForParadigm(paradigm: ResearchParadigm): EvidencePolicy[];
+/** Required report sections per paradigm, beyond the universal honesty baseline. */
+export declare const PARADIGM_REPORT_FIELDS: Record<ResearchParadigm, readonly string[]>;
+export interface EvidenceCheckContext {
+    claims: readonly Claim[];
+    evidence: readonly Evidence[];
+    links: readonly ClaimEvidenceLink[];
+    /** Explicit policies take precedence over the paradigm profile. */
+    policies?: readonly EvidencePolicy[];
+    /** Methodological paradigm; drives the profile when `policies` is absent. */
+    paradigm?: ResearchParadigm;
+    artifactRunClaimIds?: ReadonlySet<string>;
+}
+export declare function checkEvidenceSufficiency(ctx: EvidenceCheckContext): GateResult[];