patchwork-os 0.2.0-alpha.35 → 0.2.0-alpha.37

package/dist/commands/tracesExport.js

@@ -0,0 +1,269 @@
+/**
+ * patchwork traces export — bundle the four local trace logs into a
+ * single round-trippable file so a user can move machines, take a
+ * compliance snapshot, or share traces with another tool without the
+ * fragile-glob ritual of finding each .jsonl by hand.
+ *
+ * Output format (Decision 1 / option A in the 2026-05-02 strategic walk-through):
+ * a single gzipped JSONL file. Line 1 is a manifest envelope; every
+ * subsequent line is a per-row envelope. Encryption is intentionally NOT
+ * in this PR — encryption is a 2-hour follow-up once we know which
+ * passphrase / KMS UX the user wants.
+ *
+ *   {"type":"manifest","version":1,"exportedAt":"...","sources":[...],"counts":{...}}
+ *   {"source":"runs","entry":{...one runs.jsonl row...}}
+ *   {"source":"decision_traces","entry":{...one decision_traces.jsonl row...}}
+ *   ...
+ *
+ * Round-trip with `gunzip -c file.jsonl.gz | jq`. Filter one source with
+ * `gunzip -c file.jsonl.gz | jq 'select(.source=="decision_traces") | .entry'`.
+ *
+ * Memory/Ecosystem strategic-plan agent (2026-05-02) flagged trace
+ * durability as the top backlog item — see
+ * `docs/strategic/2026-05-02/memory-ecosystem-report.md` items 1, 3, 12.
+ * Without this, every claim about "years of personal AI memory" is
+ * undercut by the existing 1 MB / 10 000-line silent rotation.
+ */
+import { createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, statSync, } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createInterface } from "node:readline";
+import { pipeline } from "node:stream/promises";
+import { createGzip } from "node:zlib";
+export const TRACES_EXPORT_VERSION = 1;
+function defaultPatchworkDir() {
+    return path.join(os.homedir(), ".patchwork");
+}
+function defaultActivityDir() {
+    return path.join(os.homedir(), ".claude", "ide");
+}
+/** Single-file sources live at fixed names in the patchwork dir. */
+const SINGLE_FILE_SOURCES = [
+    { source: "runs", filename: "runs.jsonl" },
+    { source: "decision_traces", filename: "decision_traces.jsonl" },
+    { source: "commit_issue_links", filename: "commit_issue_links.jsonl" },
+];
+/**
+ * Discover activity-log files. Bridge instances each persist to
+ * `activity-{port}.jsonl` so we glob for that pattern and include any
+ * file that exists. Single explicit `activity.jsonl` (no port suffix)
+ * is also picked up — some test harnesses use that name.
+ */
+function discoverActivityFiles(activityDir) {
+    if (!existsSync(activityDir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(activityDir);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((name) => /^activity(-\d+)?\.jsonl$/i.test(name) ||
+        /^activity-log\.jsonl$/i.test(name))
+        .map((name) => path.join(activityDir, name))
+        .filter((p) => {
+        try {
+            return statSync(p).isFile();
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort();
+}
+async function readJsonlRows(filePath) {
+    const rows = [];
+    let bytes = 0;
+    try {
+        bytes = statSync(filePath).size;
+    }
+    catch {
+        return { rows, bytes: 0 };
+    }
+    const stream = createReadStream(filePath, { encoding: "utf8" });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    for await (const line of rl) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            continue;
+        try {
+            rows.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Drop unparseable rows. The export's invariant is "every line is
+            // valid JSON"; preserving a malformed line would break consumers.
+        }
+    }
+    return { rows, bytes };
+}
+/**
+ * Run the export. Pure function over filesystem state — no log instance
+ * handles needed, so it works headless (e.g. in CI restoring a snapshot)
+ * and during a running bridge alike (the export reads files atomically
+ * line-by-line; concurrent appends only add new rows beyond the export's
+ * point-in-time view).
+ */
+export async function runTracesExport(opts = {}) {
+    const exportedAt = new Date().toISOString();
+    const patchworkDir = opts.patchworkDir ?? defaultPatchworkDir();
+    const activityDir = opts.activityDir ?? defaultActivityDir();
+    // Default output: `<patchworkDir>/traces-export-<safeIso>.jsonl.gz`. ISO
+    // colons are filename-hostile on Windows so swap them for hyphens.
+    const safeStamp = exportedAt.replace(/:/g, "-").replace(/\..+$/, "");
+    const outputPath = opts.output ??
+        path.join(patchworkDir, `traces-export-${safeStamp}.jsonl.gz`);
+    // Discover sources.
+    const files = [];
+    for (const { source, filename } of SINGLE_FILE_SOURCES) {
+        const p = path.join(patchworkDir, filename);
+        if (!existsSync(p))
+            continue;
+        const { rows, bytes } = await readJsonlRows(p);
+        files.push({ source, path: p, relativePath: filename, rows, bytes });
+    }
+    for (const p of discoverActivityFiles(activityDir)) {
+        const { rows, bytes } = await readJsonlRows(p);
+        files.push({
+            source: "activity",
+            path: p,
+            relativePath: path.basename(p),
+            rows,
+            bytes,
+            activityFile: path.basename(p),
+        });
+    }
+    // Ensure output dir exists.
+    const outputDir = path.dirname(outputPath);
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    // Build manifest from discovered files (even ones with zero rows are
+    // recorded — "we looked here and found this" is more useful than silence).
+    const totalCount = files.reduce((sum, f) => sum + f.rows.length, 0);
+    const sources = [
+        ...new Set(files.map((f) => f.source)),
+    ].sort();
+    const manifest = {
+        type: "manifest",
+        version: TRACES_EXPORT_VERSION,
+        exportedAt,
+        sources,
+        files: files.map((f) => ({
+            source: f.source,
+            relativePath: f.relativePath,
+            count: f.rows.length,
+            bytes: f.bytes,
+        })),
+        totalCount,
+    };
+    // Emit: manifest line + one envelope per row, gzip-piped to disk.
+    // Use a Readable source so pipeline() owns backpressure end-to-end —
+    // writing directly to gzip outside the pipeline ignores the drain signal
+    // and silently buffers everything in memory on large exports.
+    const { Readable } = await import("node:stream");
+    const source = Readable.from((function* () {
+        yield `${JSON.stringify(manifest)}\n`;
+        for (const f of files) {
+            for (const entry of f.rows) {
+                const env = { source: f.source, entry };
+                if (f.activityFile)
+                    env.file = f.activityFile;
+                yield `${JSON.stringify(env)}\n`;
+            }
+        }
+    })(), { objectMode: false });
+    const sink = createWriteStream(outputPath, { mode: 0o600 });
+    await pipeline(source, createGzip(), sink);
+    return {
+        outputPath,
+        exportedAt,
+        files: files.map((f) => ({
+            source: f.source,
+            path: f.path,
+            count: f.rows.length,
+            bytes: f.bytes,
+        })),
+        totalCount,
+        totalBytes: files.reduce((sum, f) => sum + f.bytes, 0),
+    };
+}
+/**
+ * Stream-variant of `runTracesExport` — writes gzip-compressed JSONL
+ * directly into a caller-supplied `Writable` (e.g. an HTTP response).
+ * No temp file is created; the manifest/rows are emitted in one pass.
+ *
+ * The caller is responsible for setting `Content-Type`,
+ * `Content-Encoding`, and `Content-Disposition` headers BEFORE calling
+ * this function because Node's HTTP response is not writable after headers
+ * have been flushed.
+ *
+ * Returns row/byte accounting but omits `outputPath` (no disk file).
+ */
+export async function runTracesExportToStream(writable, opts = {}) {
+    const exportedAt = new Date().toISOString();
+    const patchworkDir = opts.patchworkDir ?? defaultPatchworkDir();
+    const activityDir = opts.activityDir ?? defaultActivityDir();
+    const files = [];
+    for (const { source, filename } of SINGLE_FILE_SOURCES) {
+        const p = path.join(patchworkDir, filename);
+        if (!existsSync(p))
+            continue;
+        const { rows, bytes } = await readJsonlRows(p);
+        files.push({ source, path: p, relativePath: filename, rows, bytes });
+    }
+    for (const p of discoverActivityFiles(activityDir)) {
+        const { rows, bytes } = await readJsonlRows(p);
+        files.push({
+            source: "activity",
+            path: p,
+            relativePath: path.relative(activityDir, p),
+            rows,
+            bytes,
+            activityFile: path.basename(p),
+        });
+    }
+    const totalCount = files.reduce((s, f) => s + f.rows.length, 0);
+    const sources = [
+        ...new Set(files.map((f) => f.source)),
+    ].sort();
+    const manifest = {
+        type: "manifest",
+        version: TRACES_EXPORT_VERSION,
+        exportedAt,
+        sources,
+        files: files.map((f) => ({
+            source: f.source,
+            relativePath: f.relativePath,
+            count: f.rows.length,
+            bytes: f.bytes,
+        })),
+        totalCount,
+    };
+    // Use a Readable source so pipeline() owns backpressure end-to-end.
+    const { Readable } = await import("node:stream");
+    const source = Readable.from((function* () {
+        yield `${JSON.stringify(manifest)}\n`;
+        for (const f of files) {
+            for (const entry of f.rows) {
+                const env = { source: f.source, entry };
+                if (f.activityFile)
+                    env.file = f.activityFile;
+                yield `${JSON.stringify(env)}\n`;
+            }
+        }
+    })(), { objectMode: false });
+    await pipeline(source, createGzip(), writable);
+    return {
+        exportedAt,
+        files: files.map((f) => ({
+            source: f.source,
+            path: f.path,
+            count: f.rows.length,
+            bytes: f.bytes,
+        })),
+        totalCount,
+        totalBytes: files.reduce((sum, f) => sum + f.bytes, 0),
+    };
+}
+//# sourceMappingURL=tracesExport.js.map

package/dist/commands/tracesExport.js.map

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

package/dist/commands/tracesImport.d.ts

@@ -0,0 +1,56 @@
+/**
+ * patchwork traces import — restore a bundle written by `tracesExport` into
+ * the local patchwork dirs. Closes the export → backup → restore-on-new-
+ * machine loop that was half-shipped (export landed, import did not).
+ *
+ * Bundle format is the manifest+row-envelope schema from tracesExport.ts:
+ *
+ *   {"type":"manifest","version":1,"exportedAt":"...","sources":[...],"files":[...]}
+ *   {"source":"runs","entry":{...}}
+ *   {"source":"decision_traces","entry":{...}}
+ *   ...
+ *
+ * Modes:
+ *   - "append" (default) — entries are appended to the target file. The
+ *     bundle's row order is preserved. No dedup; if you import the same
+ *     bundle twice, you get duplicates. This is by design — dedup needs
+ *     a stable key choice per source and we'd rather ship the simple
+ *     thing now and add it as a follow-up.
+ *   - "overwrite" — target file is truncated before any writes. Use
+ *     this for "clean restore on a fresh machine" — never use it when
+ *     there's local data you want to keep.
+ *
+ * Encryption: `.age` bundles must be decrypted out-of-band first
+ * (`age -d bundle.jsonl.gz.age | gunzip > bundle.jsonl`). A `--decrypt`
+ * flag is a small follow-up.
+ */
+import { type TraceSource } from "./tracesExport.js";
+export type ImportMode = "append" | "overwrite";
+export interface TracesImportOptions {
+    /** Path to a `.jsonl.gz` (or plain `.jsonl`) bundle written by tracesExport. */
+    input: string;
+    /** Where to restore single-file sources. Default: `~/.patchwork/`. */
+    patchworkDir?: string;
+    /** Where to restore activity-*.jsonl. Default: `~/.claude/ide/`. */
+    activityDir?: string;
+    /** "append" (default) or "overwrite". */
+    mode?: ImportMode;
+    /** Don't write anything — return what would happen. */
+    dryRun?: boolean;
+}
+export interface TracesImportResult {
+    inputPath: string;
+    exportedAt: string;
+    mode: ImportMode;
+    dryRun: boolean;
+    /** Per target-file accounting. Multiple files possible for activity (one per source bridge instance). */
+    files: Array<{
+        source: TraceSource;
+        targetPath: string;
+        /** Rows written (or that would be written, in dry-run). */
+        count: number;
+    }>;
+    /** Total rows across all target files. */
+    totalCount: number;
+}
+export declare function runTracesImport(opts: TracesImportOptions): Promise<TracesImportResult>;

package/dist/commands/tracesImport.js

@@ -0,0 +1,161 @@
+/**
+ * patchwork traces import — restore a bundle written by `tracesExport` into
+ * the local patchwork dirs. Closes the export → backup → restore-on-new-
+ * machine loop that was half-shipped (export landed, import did not).
+ *
+ * Bundle format is the manifest+row-envelope schema from tracesExport.ts:
+ *
+ *   {"type":"manifest","version":1,"exportedAt":"...","sources":[...],"files":[...]}
+ *   {"source":"runs","entry":{...}}
+ *   {"source":"decision_traces","entry":{...}}
+ *   ...
+ *
+ * Modes:
+ *   - "append" (default) — entries are appended to the target file. The
+ *     bundle's row order is preserved. No dedup; if you import the same
+ *     bundle twice, you get duplicates. This is by design — dedup needs
+ *     a stable key choice per source and we'd rather ship the simple
+ *     thing now and add it as a follow-up.
+ *   - "overwrite" — target file is truncated before any writes. Use
+ *     this for "clean restore on a fresh machine" — never use it when
+ *     there's local data you want to keep.
+ *
+ * Encryption: `.age` bundles must be decrypted out-of-band first
+ * (`age -d bundle.jsonl.gz.age | gunzip > bundle.jsonl`). A `--decrypt`
+ * flag is a small follow-up.
+ */
+import { appendFileSync, createReadStream, existsSync, mkdirSync, writeFileSync, } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createInterface } from "node:readline";
+import { createGunzip } from "node:zlib";
+import { TRACES_EXPORT_VERSION } from "./tracesExport.js";
+const SINGLE_FILE_TARGETS = {
+    runs: "runs.jsonl",
+    decision_traces: "decision_traces.jsonl",
+    commit_issue_links: "commit_issue_links.jsonl",
+};
+function defaultPatchworkDir() {
+    return path.join(os.homedir(), ".patchwork");
+}
+function defaultActivityDir() {
+    return path.join(os.homedir(), ".claude", "ide");
+}
+function resolveTargetPath(source, envelopeFile, patchworkDir, activityDir) {
+    if (source === "activity") {
+        // activity rows carry the original file name — preserve it so a
+        // multi-instance export round-trips per-port. Default fallback if
+        // the envelope didn't include one.
+        const name = envelopeFile ?? "activity.jsonl";
+        return path.join(activityDir, name);
+    }
+    return path.join(patchworkDir, SINGLE_FILE_TARGETS[source]);
+}
+export async function runTracesImport(opts) {
+    const inputPath = path.resolve(opts.input);
+    if (!existsSync(inputPath)) {
+        throw new Error(`Input bundle not found: ${inputPath}`);
+    }
+    const mode = opts.mode ?? "append";
+    const dryRun = opts.dryRun === true;
+    const patchworkDir = opts.patchworkDir ?? defaultPatchworkDir();
+    const activityDir = opts.activityDir ?? defaultActivityDir();
+    if (!dryRun) {
+        if (!existsSync(patchworkDir))
+            mkdirSync(patchworkDir, { recursive: true });
+        if (!existsSync(activityDir))
+            mkdirSync(activityDir, { recursive: true });
+    }
+    // Stream-read the bundle. Auto-detect gzip via `.gz` suffix; users who
+    // already gunzipped manually can pass the plain .jsonl.
+    const baseStream = createReadStream(inputPath);
+    const lineStream = inputPath.endsWith(".gz")
+        ? baseStream.pipe(createGunzip())
+        : baseStream;
+    const rl = createInterface({ input: lineStream, crlfDelay: Infinity });
+    let manifest = null;
+    // Group writes by target so we can truncate-once for overwrite mode and
+    // batch the appends. Memory cost is one row's worth of buffer per target,
+    // which is acceptable for a CLI command operating on user-machine-sized
+    // data.
+    const buffers = new Map();
+    let lineNum = 0;
+    for await (const raw of rl) {
+        lineNum++;
+        const line = raw.trim();
+        if (line === "")
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            throw new Error(`Bundle parse error at line ${lineNum}: not valid JSON`);
+        }
+        if (lineNum === 1) {
+            // First non-empty line must be the manifest.
+            if (!parsed ||
+                typeof parsed !== "object" ||
+                parsed.type !== "manifest") {
+                throw new Error(`First line of bundle is not a manifest envelope (got: ${line.slice(0, 80)}…)`);
+            }
+            manifest = parsed;
+            if (manifest.version !== TRACES_EXPORT_VERSION) {
+                throw new Error(`Bundle version ${manifest.version} not supported (expected ${TRACES_EXPORT_VERSION})`);
+            }
+            continue;
+        }
+        if (manifest === null) {
+            throw new Error("Bundle has rows before a manifest line");
+        }
+        const env = parsed;
+        if (typeof env.source !== "string" || env.entry === undefined) {
+            throw new Error(`Bundle row at line ${lineNum} missing source/entry`);
+        }
+        const source = env.source;
+        const file = typeof env.file === "string" ? env.file : undefined;
+        const targetPath = resolveTargetPath(source, file, patchworkDir, activityDir);
+        const buf = buffers.get(targetPath) ?? { source, lines: [] };
+        // Re-serialize the entry as one JSONL line. Tools downstream of these
+        // files expect one JSON object per line, no envelope.
+        buf.lines.push(JSON.stringify(env.entry));
+        buffers.set(targetPath, buf);
+    }
+    if (manifest === null) {
+        throw new Error("Bundle is empty (no manifest line)");
+    }
+    // Apply: in overwrite mode, truncate each target before appending its
+    // batch. In append mode, just append.
+    const files = [];
+    let totalCount = 0;
+    for (const [targetPath, buf] of buffers) {
+        const count = buf.lines.length;
+        totalCount += count;
+        if (!dryRun) {
+            // Ensure the target directory exists (activity-port files might
+            // land in a dir we don't control — covered by the mkdir above for
+            // the configured activityDir, but parent dir of arbitrary path
+            // needs its own check).
+            const parent = path.dirname(targetPath);
+            if (!existsSync(parent))
+                mkdirSync(parent, { recursive: true });
+            const payload = `${buf.lines.join("\n")}\n`;
+            if (mode === "overwrite") {
+                writeFileSync(targetPath, payload, "utf-8");
+            }
+            else {
+                appendFileSync(targetPath, payload, "utf-8");
+            }
+        }
+        files.push({ source: buf.source, targetPath, count });
+    }
+    return {
+        inputPath,
+        exportedAt: manifest.exportedAt,
+        mode,
+        dryRun,
+        files: files.sort((a, b) => a.targetPath.localeCompare(b.targetPath)),
+        totalCount,
+    };
+}
+//# sourceMappingURL=tracesImport.js.map

package/dist/commands/tracesImport.js.map

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

package/dist/config.d.ts

@@ -24,6 +24,14 @@ export interface Config {
     toolRateLimit: number;
     /** Patchwork: gate tool dispatch on human approval via dashboard. "high" = only high-risk tools (default-safe); "all" = every tool; "off" = disabled. */
     approvalGate: "off" | "high" | "all";
+    /**
+     * Patchwork: opt-in switch for the time-of-day anomaly heuristic
+     * (h10 in src/approvalSignals.ts). Off by default — catalog flags it
+     * as medium-FP for power users with irregular schedules. Enable via
+     * --enable-time-of-day-anomaly (CLI) or `personalSignals.timeOfDayAnomaly: true`
+     * in ~/.patchwork/config.json.
+     */
+    enableTimeOfDayAnomaly: boolean;
     /** Patchwork: admin-controlled managed settings file (highest rule precedence, cannot be overridden). */
     managedSettingsPath: string | null;
     /** Patchwork: outbound webhook URL for approval queue notifications (from dashboard.webhookUrl in patchwork config). */

package/dist/config.js

@@ -311,6 +311,8 @@ export function parseConfig(argv) {
     let automationPolicyPath = fileConfig.automationPolicyPath ?? null;
     let approvalGate = fileConfig.approvalGate ??
         "off";
+    let enableTimeOfDayAnomaly = fileConfig
+        .enableTimeOfDayAnomaly ?? false;
     let managedSettingsPath = null;
     // Read approvalWebhookUrl, approvalGate, driver, and apiKeys from patchwork config
     // (non-fatal; CLI flags and bridge config file take precedence over patchwork config)
@@ -482,6 +484,11 @@ export function parseConfig(argv) {
                 approvalGate = val;
                 break;
             }
+            case "--enable-time-of-day-anomaly": {
+                // Boolean flag — opt-in for personalSignals h10. No value arg.
+                enableTimeOfDayAnomaly = true;
+                break;
+            }
             case "--managed-settings": {
                 const mp = requireArg(args, ++i, "--managed-settings");
                 if (mp.length > 4096)
@@ -632,7 +639,7 @@ Options:
   --help                    Show this help
 
 Patchwork:
-  --approval-gate <level>   Gate tool calls via oversight dashboard: "off" | "high" | "all" (default: "off")
+  --approval-gate <level>   Delegation policy: gate tool calls via oversight dashboard: "off" | "high" | "all" (default: "off")
   --managed-settings <path> Admin-controlled settings file (highest rule precedence, cannot be overridden by users)
 
 Automation:
@@ -785,6 +792,7 @@ Environment Variables:
         automationEnabled,
         automationPolicyPath,
         approvalGate,
+        enableTimeOfDayAnomaly,
         managedSettingsPath,
         approvalWebhookUrl,
         toolRateLimit,