psyclaw 0.25.2 → 0.26.0

package/dist/src/project/jsonl.js

@@ -0,0 +1,93 @@
+import { appendFile, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+const writeQueues = new Map();
+/**
+ * Serialize all mutations for one JSONL path in this process. A rejected
+ * operation must not poison later writes, so the next operation starts after
+ * the previous one settles.
+ */
+function enqueue(path, operation) {
+    const previous = writeQueues.get(path) ?? Promise.resolve();
+    const next = previous.catch(() => undefined).then(operation);
+    writeQueues.set(path, next);
+    void next.finally(() => {
+        if (writeQueues.get(path) === next)
+            writeQueues.delete(path);
+    }).catch(() => undefined);
+    return next;
+}
+export async function appendJsonl(path, value) {
+    await enqueue(path, async () => {
+        await mkdir(dirname(path), { recursive: true });
+        await appendFile(path, `${JSON.stringify(value)}\n`, "utf8");
+    });
+}
+/**
+ * Check for an existing logical record and append only when its key is new.
+ * The read and append happen inside the same per-path queue, making this
+ * operation safe for concurrent callers in the current process.
+ */
+export async function appendJsonlIfMissing(path, value, key) {
+    return enqueue(path, async () => {
+        const existing = await readJsonl(path);
+        const wanted = key(value);
+        if (existing.some((item) => key(item) === wanted))
+            return { appended: false };
+        await mkdir(dirname(path), { recursive: true });
+        await appendFile(path, `${JSON.stringify(value)}\n`, "utf8");
+        return { appended: true };
+    });
+}
+/**
+ * Replace a file through a same-directory temporary file and rename. Keeping
+ * the temporary file beside the destination preserves rename atomicity on
+ * filesystems that support it and avoids partially written JSON/Markdown.
+ */
+export async function atomicWriteFile(path, contents) {
+    const directory = dirname(path);
+    await mkdir(directory, { recursive: true });
+    const temporary = join(directory, `.${basename(path)}.${randomUUID()}.tmp`);
+    try {
+        await writeFile(temporary, contents, { encoding: "utf8", flag: "wx" });
+        try {
+            await rename(temporary, path);
+        }
+        catch (error) {
+            // Windows may reject replacing an existing file with rename. Remove
+            // only the exact destination, then complete the same-directory move.
+            const code = error.code;
+            if (code !== "EEXIST" && code !== "EPERM" && code !== "EACCES")
+                throw error;
+            await rm(path, { force: true });
+            await rename(temporary, path);
+        }
+    }
+    finally {
+        await rm(temporary, { force: true }).catch(() => undefined);
+    }
+}
+export async function readJsonl(path) {
+    let text;
+    try {
+        text = await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const rows = [];
+    for (const [index, line] of text.split(/\r?\n/).entries()) {
+        if (!line.trim())
+            continue;
+        try {
+            rows.push(JSON.parse(line));
+        }
+        catch {
+            throw new Error(`Invalid JSONL at ${path}:${index + 1}`);
+        }
+    }
+    return rows;
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/src/project/jsonl.js.map

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

package/dist/src/project/manuscript.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared manuscript discovery (convention: docs/文档规范.md).
+ *
+ * The panel, the publish workflow, and the agent tools all resolve "the
+ * manuscript" the same way so a document generated by any of them is
+ * immediately recognized by the others:
+ *   1. notes/manuscript.md   (panel-managed)
+ *   2. paper/ or docs/ *.md  (prefer names like 手稿/论文/初稿/draft/manuscript)
+ *   3. report fallbacks      (meta-analysis / literature review / HANDOFF)
+ */
+export declare const MANUSCRIPT_NAME_PATTERN: RegExp;
+export interface Manuscript {
+    exists: boolean;
+    path: string | null;
+    markdown: string;
+}
+export declare function findMarkdownManuscript(root: string): Promise<{
+    path: string;
+    markdown: string;
+} | null>;
+export declare function readManuscript(root: string): Promise<Manuscript>;

package/dist/src/project/manuscript.js

@@ -0,0 +1,74 @@
+import { lstat, readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { assertSafeProjectPath } from "./paths.js";
+/**
+ * Shared manuscript discovery (convention: docs/文档规范.md).
+ *
+ * The panel, the publish workflow, and the agent tools all resolve "the
+ * manuscript" the same way so a document generated by any of them is
+ * immediately recognized by the others:
+ *   1. notes/manuscript.md   (panel-managed)
+ *   2. paper/ or docs/ *.md  (prefer names like 手稿/论文/初稿/draft/manuscript)
+ *   3. report fallbacks      (meta-analysis / literature review / HANDOFF)
+ */
+export const MANUSCRIPT_NAME_PATTERN = /(手稿|论文|初稿|draft|manuscript|Draft|Manuscript)/i;
+export async function findMarkdownManuscript(root) {
+    for (const dir of ["paper", "docs"]) {
+        let entries = [];
+        try {
+            entries = await readdir(join(root, dir), { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        const candidates = [];
+        for (const entry of entries) {
+            if (!entry.isFile() || !/\.(md|markdown)$/i.test(entry.name))
+                continue;
+            const stat = await lstat(join(root, dir, entry.name)).catch(() => undefined);
+            if (stat?.isFile())
+                candidates.push({ name: entry.name, mtimeMs: stat.mtimeMs });
+        }
+        const preferred = candidates.filter((candidate) => MANUSCRIPT_NAME_PATTERN.test(candidate.name));
+        const pool = preferred.length > 0 ? preferred : candidates;
+        pool.sort((left, right) => right.mtimeMs - left.mtimeMs);
+        const picked = pool[0];
+        if (!picked)
+            continue;
+        const path = `${dir}/${picked.name}`;
+        try {
+            return { path, markdown: await readFile(await assertSafeProjectPath(root, path), "utf8") };
+        }
+        catch { /* try next candidate */ }
+    }
+    return null;
+}
+export async function readManuscript(root) {
+    // 1. The panel-managed working copy wins when present.
+    try {
+        const target = await assertSafeProjectPath(root, "notes/manuscript.md");
+        const markdown = await readFile(target, "utf8");
+        return { exists: true, path: "notes/manuscript.md", markdown };
+    }
+    catch { /* fall through */ }
+    // 2. A real manuscript under paper/ or docs/ is the next best source.
+    const found = await findMarkdownManuscript(root);
+    if (found)
+        return { exists: true, path: found.path, markdown: found.markdown };
+    // 3. Report fallbacks only when no manuscript exists at all.
+    const candidates = [
+        "analysis/outputs/meta-analysis.md",
+        "outputs/literature-review.md",
+        "notes/HANDOFF.md",
+    ];
+    for (const relative of candidates) {
+        try {
+            const target = await assertSafeProjectPath(root, relative);
+            const markdown = await readFile(target, "utf8");
+            return { exists: true, path: relative, markdown };
+        }
+        catch { /* try next candidate */ }
+    }
+    return { exists: false, path: null, markdown: "" };
+}
+//# sourceMappingURL=manuscript.js.map

package/dist/src/project/manuscript.js.map

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

package/dist/src/project/paths.d.ts

@@ -0,0 +1,38 @@
+export declare const PSYCLAW_DIR: ".psyclaw";
+export declare function projectPaths(root: string): {
+    root: string;
+    project: string;
+    evidence: string;
+    claims: string;
+    audit: string;
+    versions: string;
+    analysisHooks: string;
+    trust: string;
+    runs: string;
+    plans: string;
+    memory: string;
+    manifests: string;
+    raw: string;
+    clean: string;
+    analysis: string;
+    analysisScripts: string;
+    analysisConfigs: string;
+    analysisResults: string;
+    artifacts: string;
+    figures: string;
+    tables: string;
+    reports: string;
+    artifactData: string;
+    artifactCode: string;
+    notes: string;
+    outputs: string;
+    logs: string;
+    handoffMarkdown: string;
+    handoffJson: string;
+};
+export declare function ensureProjectDirectories(root: string): Promise<void>;
+/**
+ * Verify a write target stays inside an approved project directory and is not
+ * an existing symlink. This is an application boundary, not an OS sandbox.
+ */
+export declare function assertSafeProjectPath(root: string, target: string): Promise<string>;

package/dist/src/project/paths.js

@@ -0,0 +1,166 @@
+import { lstat, mkdir, realpath } from "node:fs/promises";
+import { isAbsolute, relative, resolve } from "node:path";
+export const PSYCLAW_DIR = ".psyclaw";
+export function projectPaths(root) {
+    const base = resolve(root);
+    return {
+        root: base,
+        project: resolve(base, PSYCLAW_DIR, "project.json"),
+        evidence: resolve(base, PSYCLAW_DIR, "evidence.jsonl"),
+        claims: resolve(base, PSYCLAW_DIR, "claims.jsonl"),
+        audit: resolve(base, PSYCLAW_DIR, "audit.jsonl"),
+        versions: resolve(base, PSYCLAW_DIR, "versions.jsonl"),
+        analysisHooks: resolve(base, PSYCLAW_DIR, "analysis-hooks.json"),
+        trust: resolve(base, PSYCLAW_DIR, "trust.json"),
+        runs: resolve(base, PSYCLAW_DIR, "runs"),
+        plans: resolve(base, PSYCLAW_DIR, "plans"),
+        memory: resolve(base, PSYCLAW_DIR, "memory"),
+        manifests: resolve(base, PSYCLAW_DIR, "manifests"),
+        raw: resolve(base, "data", "raw"),
+        clean: resolve(base, "data", "clean"),
+        analysis: resolve(base, "analysis"),
+        analysisScripts: resolve(base, "analysis", "scripts"),
+        analysisConfigs: resolve(base, "analysis", "configs"),
+        analysisResults: resolve(base, "analysis", "results"),
+        artifacts: resolve(base, "artifacts"),
+        figures: resolve(base, "artifacts", "figures"),
+        tables: resolve(base, "artifacts", "tables"),
+        reports: resolve(base, "artifacts", "reports"),
+        artifactData: resolve(base, "artifacts", "data"),
+        artifactCode: resolve(base, "artifacts", "code"),
+        notes: resolve(base, "notes"),
+        outputs: resolve(base, "outputs"),
+        logs: resolve(base, "logs"),
+        handoffMarkdown: resolve(base, "notes", "HANDOFF.md"),
+        handoffJson: resolve(base, "notes", "handoff.json"),
+    };
+}
+export async function ensureProjectDirectories(root) {
+    const paths = projectPaths(root);
+    const rootStat = await lstat(paths.root);
+    if (rootStat.isSymbolicLink())
+        throw new Error(`Project root symlink is not allowed: ${paths.root}`);
+    const directoryTargets = [
+        PSYCLAW_DIR,
+        `${PSYCLAW_DIR}/runs`,
+        `${PSYCLAW_DIR}/plans`,
+        `${PSYCLAW_DIR}/memory`,
+        `${PSYCLAW_DIR}/manifests`,
+        "data",
+        "data/raw",
+        "data/clean",
+        "analysis",
+        "analysis/scripts",
+        "analysis/configs",
+        "analysis/results",
+        "artifacts",
+        "artifacts/figures",
+        "artifacts/tables",
+        "artifacts/reports",
+        "artifacts/data",
+        "artifacts/code",
+        "notes",
+        "outputs",
+        "logs",
+    ];
+    for (const target of directoryTargets) {
+        const candidate = resolve(paths.root, target);
+        try {
+            const stat = await lstat(candidate);
+            if (stat.isSymbolicLink())
+                throw new Error(`Protected directory symlink: ${target}`);
+            if (!stat.isDirectory())
+                throw new Error(`Expected directory: ${target}`);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+            await mkdir(candidate, { recursive: false });
+        }
+    }
+}
+/**
+ * Verify a write target stays inside an approved project directory and is not
+ * an existing symlink. This is an application boundary, not an OS sandbox.
+ */
+export async function assertSafeProjectPath(root, target) {
+    const base = resolve(root);
+    // `path.resolve` is platform-specific. Normalize separators and reject all
+    // absolute/drive-prefixed inputs before resolving so a project created on
+    // one platform cannot be escaped by a path form from another platform.
+    const rawTarget = target.trim();
+    const normalizedTarget = rawTarget.replaceAll("\\", "/");
+    const isCrossPlatformAbsolute = normalizedTarget.startsWith("/") ||
+        /^\\\\/.test(rawTarget) ||
+        /^[A-Za-z]:/.test(rawTarget);
+    if (isCrossPlatformAbsolute) {
+        throw new Error(`Path escapes project root: ${target}`);
+    }
+    const candidate = resolve(base, normalizedTarget);
+    const rel = relative(base, candidate);
+    const normalizedRel = rel.replaceAll("\\", "/");
+    if (normalizedRel === "" ||
+        normalizedRel === ".." ||
+        normalizedRel.startsWith("../") ||
+        isAbsolute(rel) ||
+        normalizedRel.startsWith("/")) {
+        throw new Error(`Path escapes project root: ${target}`);
+    }
+    const protectedRel = normalizedRel.toLowerCase();
+    if (protectedRel === ".git" ||
+        protectedRel.startsWith(".git/") ||
+        protectedRel === "data/raw" ||
+        protectedRel.startsWith("data/raw/") ||
+        protectedRel.includes("credential") ||
+        protectedRel.includes("secret")) {
+        throw new Error(`Protected project path is not writable: ${target}`);
+    }
+    try {
+        const stat = await lstat(candidate);
+        if (stat.isSymbolicLink())
+            throw new Error(`Symlink target is not writable: ${target}`);
+        const resolvedCandidate = await realpath(candidate);
+        const resolvedBase = await realpath(base);
+        const resolvedRel = relative(resolvedBase, resolvedCandidate);
+        const normalizedResolvedRel = resolvedRel.replaceAll("\\", "/");
+        if (normalizedResolvedRel === ".." ||
+            normalizedResolvedRel.startsWith("../") ||
+            isAbsolute(resolvedRel) ||
+            normalizedResolvedRel.startsWith("/")) {
+            throw new Error(`Resolved path escapes project root: ${target}`);
+        }
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            // Resolve the nearest existing ancestor so a symlinked parent cannot
+            // redirect a future write outside the project root.
+            let ancestor = candidate;
+            while (true) {
+                try {
+                    const resolvedAncestor = await realpath(ancestor);
+                    const resolvedBase = await realpath(base);
+                    const ancestorRel = relative(resolvedBase, resolvedAncestor);
+                    const normalizedAncestorRel = ancestorRel.replaceAll("\\", "/");
+                    if (normalizedAncestorRel === ".." ||
+                        normalizedAncestorRel.startsWith("../") ||
+                        isAbsolute(ancestorRel) ||
+                        normalizedAncestorRel.startsWith("/")) {
+                        throw new Error(`Resolved path escapes project root: ${target}`);
+                    }
+                    return candidate;
+                }
+                catch (ancestorError) {
+                    if (ancestorError.code !== "ENOENT")
+                        throw ancestorError;
+                    const parent = resolve(ancestor, "..");
+                    if (parent === ancestor)
+                        throw ancestorError;
+                    ancestor = parent;
+                }
+            }
+        }
+        throw error;
+    }
+    return candidate;
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/project/paths.js.map

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

package/dist/src/project/versions.d.ts

@@ -0,0 +1,10 @@
+export type VersionedArtifactKind = "analysis-plan" | "manuscript-revision" | "figure" | "table" | "manuscript";
+export interface VersionRecord {
+    schemaVersion: "psyclaw/version-record/v1";
+    kind: VersionedArtifactKind;
+    version: number;
+    runId: string;
+    createdAt: string;
+}
+/** Allocate monotonically within a project and persist the allocation. */
+export declare function allocateProjectVersion(root: string, kind: VersionedArtifactKind, runId: string, now?: string): Promise<string>;

package/dist/src/project/versions.js

@@ -0,0 +1,14 @@
+import { readJsonl, appendJsonl } from "./jsonl.js";
+import { projectPaths } from "./paths.js";
+/** Allocate monotonically within a project and persist the allocation. */
+export async function allocateProjectVersion(root, kind, runId, now = new Date().toISOString()) {
+    const path = projectPaths(root).versions;
+    const records = await readJsonl(path);
+    const max = records
+        .filter((record) => record.kind === kind && Number.isInteger(record.version) && (record.version ?? 0) > 0)
+        .reduce((highest, record) => Math.max(highest, record.version ?? 0), 0);
+    const version = max + 1;
+    await appendJsonl(path, { schemaVersion: "psyclaw/version-record/v1", kind, version, runId, createdAt: now });
+    return `v${version}`;
+}
+//# sourceMappingURL=versions.js.map

package/dist/src/project/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../../src/project/versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY1C,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,IAA2B,EAAE,KAAa,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACnI,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,SAAS,CAAyB,IAAI,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,OAAO;SAChB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;SACzG,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC;IACxB,MAAM,WAAW,CAAgB,IAAI,EAAE,EAAE,aAAa,EAAE,2BAA2B,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7H,OAAO,IAAI,OAAO,EAAE,CAAC;AACvB,CAAC"}

package/dist/src/psyclaw-theme.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The psyclaw color theme for the bundled Pi TUI. It is a teal-dark variant of
+ * Pi's built-in dark theme: the accent is a calm teal, headings/borders shift
+ * cooler, and backgrounds get a faint teal tint. Every required color token is
+ * present so the theme passes Pi's theme JSON schema.
+ */
+export declare const PSYCLAW_THEME_NAME = "psyclaw";
+export declare const PSYCLAW_THEME: {
+    name: string;
+    vars: {
+        cyan: string;
+        blue: string;
+        green: string;
+        red: string;
+        yellow: string;
+        text: string;
+        gray: string;
+        dimGray: string;
+        darkGray: string;
+        accent: string;
+        selectedBg: string;
+        userMsgBg: string;
+        toolPendingBg: string;
+        toolSuccessBg: string;
+        toolErrorBg: string;
+        customMsgBg: string;
+    };
+    colors: {
+        accent: string;
+        border: string;
+        borderAccent: string;
+        borderMuted: string;
+        success: string;
+        error: string;
+        warning: string;
+        muted: string;
+        dim: string;
+        text: string;
+        thinkingText: string;
+        selectedBg: string;
+        scrollbarThumb: string;
+        userMessageBg: string;
+        userMessageText: string;
+        customMessageBg: string;
+        customMessageText: string;
+        customMessageLabel: string;
+        toolPendingBg: string;
+        toolSuccessBg: string;
+        toolErrorBg: string;
+        toolTitle: string;
+        toolOutput: string;
+        mdHeading: string;
+        mdLink: string;
+        mdLinkUrl: string;
+        mdCode: string;
+        mdCodeBlock: string;
+        mdCodeBlockBorder: string;
+        mdQuote: string;
+        mdQuoteBorder: string;
+        mdHr: string;
+        mdListBullet: string;
+        toolDiffAdded: string;
+        toolDiffRemoved: string;
+        toolDiffContext: string;
+        syntaxComment: string;
+        syntaxKeyword: string;
+        syntaxFunction: string;
+        syntaxVariable: string;
+        syntaxString: string;
+        syntaxNumber: string;
+        syntaxType: string;
+        syntaxOperator: string;
+        syntaxPunctuation: string;
+        thinkingOff: string;
+        thinkingMinimal: string;
+        thinkingLow: string;
+        thinkingMedium: string;
+        thinkingHigh: string;
+        thinkingXhigh: string;
+        thinkingMax: string;
+        bashMode: string;
+    };
+    export: {
+        pageBg: string;
+        cardBg: string;
+        infoBg: string;
+    };
+};

package/dist/src/psyclaw-theme.js

@@ -0,0 +1,89 @@
+/**
+ * The psyclaw color theme for the bundled Pi TUI. It is a teal-dark variant of
+ * Pi's built-in dark theme: the accent is a calm teal, headings/borders shift
+ * cooler, and backgrounds get a faint teal tint. Every required color token is
+ * present so the theme passes Pi's theme JSON schema.
+ */
+export const PSYCLAW_THEME_NAME = "psyclaw";
+export const PSYCLAW_THEME = {
+    name: PSYCLAW_THEME_NAME,
+    vars: {
+        cyan: "#2ec4b6",
+        blue: "#4a90d9",
+        green: "#7ec699",
+        red: "#e06c75",
+        yellow: "#e5c07b",
+        text: "#d8dee9",
+        gray: "#8b98a5",
+        dimGray: "#5b6672",
+        darkGray: "#3b4252",
+        accent: "#2ec4b6",
+        selectedBg: "#1f3a3d",
+        userMsgBg: "#2a2f3a",
+        toolPendingBg: "#2b303b",
+        toolSuccessBg: "#1f3d34",
+        toolErrorBg: "#3d2b2b",
+        customMsgBg: "#27333b",
+    },
+    colors: {
+        accent: "accent",
+        border: "blue",
+        borderAccent: "cyan",
+        borderMuted: "darkGray",
+        success: "green",
+        error: "red",
+        warning: "yellow",
+        muted: "gray",
+        dim: "dimGray",
+        text: "text",
+        thinkingText: "gray",
+        selectedBg: "selectedBg",
+        scrollbarThumb: "selectedBg",
+        userMessageBg: "userMsgBg",
+        userMessageText: "text",
+        customMessageBg: "customMsgBg",
+        customMessageText: "text",
+        customMessageLabel: "#2ec4b6",
+        toolPendingBg: "toolPendingBg",
+        toolSuccessBg: "toolSuccessBg",
+        toolErrorBg: "toolErrorBg",
+        toolTitle: "text",
+        toolOutput: "gray",
+        mdHeading: "#e5c07b",
+        mdLink: "#4fc3b8",
+        mdLinkUrl: "dimGray",
+        mdCode: "accent",
+        mdCodeBlock: "green",
+        mdCodeBlockBorder: "gray",
+        mdQuote: "gray",
+        mdQuoteBorder: "gray",
+        mdHr: "gray",
+        mdListBullet: "accent",
+        toolDiffAdded: "green",
+        toolDiffRemoved: "red",
+        toolDiffContext: "gray",
+        syntaxComment: "#7f9b7f",
+        syntaxKeyword: "#61afef",
+        syntaxFunction: "#98c379",
+        syntaxVariable: "#d19a66",
+        syntaxString: "#98c379",
+        syntaxNumber: "#d19a66",
+        syntaxType: "#2ec4b6",
+        syntaxOperator: "#d8dee9",
+        syntaxPunctuation: "#d8dee9",
+        thinkingOff: "darkGray",
+        thinkingMinimal: "#6e7b8a",
+        thinkingLow: "#5f87af",
+        thinkingMedium: "#6fb3b8",
+        thinkingHigh: "#7ec4c8",
+        thinkingXhigh: "#2ec4b6",
+        thinkingMax: "#4dd0c9",
+        bashMode: "green",
+    },
+    export: {
+        pageBg: "#16181d",
+        cardBg: "#1e222a",
+        infoBg: "#202a2e",
+    },
+};
+//# sourceMappingURL=psyclaw-theme.js.map

package/dist/src/psyclaw-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"psyclaw-theme.js","sourceRoot":"","sources":["../../src/psyclaw-theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,SAAS;QACpB,aAAa,EAAE,SAAS;QACxB,aAAa,EAAE,SAAS;QACxB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,SAAS;KACvB;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,MAAM;QACd,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,MAAM;QACZ,YAAY,EAAE,MAAM;QAEpB,UAAU,EAAE,YAAY;QACxB,cAAc,EAAE,YAAY;QAC5B,aAAa,EAAE,WAAW;QAC1B,eAAe,EAAE,MAAM;QACvB,eAAe,EAAE,aAAa;QAC9B,iBAAiB,EAAE,MAAM;QACzB,kBAAkB,EAAE,SAAS;QAC7B,aAAa,EAAE,eAAe;QAC9B,aAAa,EAAE,eAAe;QAC9B,WAAW,EAAE,aAAa;QAC1B,SAAS,EAAE,MAAM;QACjB,UAAU,EAAE,MAAM;QAElB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,OAAO;QACpB,iBAAiB,EAAE,MAAM;QACzB,OAAO,EAAE,MAAM;QACf,aAAa,EAAE,MAAM;QACrB,IAAI,EAAE,MAAM;QACZ,YAAY,EAAE,QAAQ;QAEtB,aAAa,EAAE,OAAO;QACtB,eAAe,EAAE,KAAK;QACtB,eAAe,EAAE,MAAM;QAEvB,aAAa,EAAE,SAAS;QACxB,aAAa,EAAE,SAAS;QACxB,cAAc,EAAE,SAAS;QACzB,cAAc,EAAE,SAAS;QACzB,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,SAAS;QACvB,UAAU,EAAE,SAAS;QACrB,cAAc,EAAE,SAAS;QACzB,iBAAiB,EAAE,SAAS;QAE5B,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,SAAS;QAC1B,WAAW,EAAE,SAAS;QACtB,cAAc,EAAE,SAAS;QACzB,YAAY,EAAE,SAAS;QACvB,aAAa,EAAE,SAAS;QACxB,WAAW,EAAE,SAAS;QAEtB,QAAQ,EAAE,OAAO;KAClB;IACD,MAAM,EAAE;QACN,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;KAClB;CACF,CAAC"}

package/dist/src/research/brief.d.ts

@@ -0,0 +1,11 @@
+import type { GateResult, Handoff } from "../core/contracts.js";
+export interface BriefResult {
+    runId: string;
+    verdict: "pass" | "blocked";
+    gates: GateResult[];
+    briefPath?: string;
+    manifestPath: string;
+    verdictPath: string;
+    handoff: Handoff;
+}
+export declare function runOfflineBrief(root: string): Promise<BriefResult>;