@yanlinglabs/winter-conformance 0.0.2

package/dist/index-z5gwvsfh.js

@@ -0,0 +1,49 @@
+// src/trace.ts
+var VOLATILE = new Set(["session_id", "sessionId", "uuid", "toolUseID", "requestId", "total_cost_usd", "duration_ms", "durationMs", "timestamp"]);
+function normalizeTrace2(entries) {
+  return entries.map((e, i) => ({ ...e, sequence: i, payload: strip(e.payload) }));
+}
+function strip(v) {
+  if (Array.isArray(v))
+    return v.map(strip);
+  if (v && typeof v === "object") {
+    const out = {};
+    for (const [k, val] of Object.entries(v))
+      if (!VOLATILE.has(k))
+        out[k] = strip(val);
+    return out;
+  }
+  return v;
+}
+function sortKeysDeep(v) {
+  if (Array.isArray(v))
+    return v.map(sortKeysDeep);
+  if (v && typeof v === "object") {
+    const out = {};
+    for (const k of Object.keys(v).sort())
+      out[k] = sortKeysDeep(v[k]);
+    return out;
+  }
+  return v;
+}
+function canonicalStringify(v) {
+  return JSON.stringify(sortKeysDeep(v));
+}
+function compareTraces2(a, b) {
+  const diffs = [];
+  const n = Math.max(a.length, b.length);
+  for (let i = 0;i < n; i++) {
+    const x = a[i], y = b[i];
+    if (!x || !y) {
+      diffs.push(`length mismatch at ${i}`);
+      continue;
+    }
+    if (x.kind !== y.kind)
+      diffs.push(`kind@${i}: ${x.kind} != ${y.kind}`);
+    if (canonicalStringify(x.payload) !== canonicalStringify(y.payload))
+      diffs.push(`payload@${i} (${x.kind}) differs`);
+  }
+  return diffs;
+}
+
+export { normalizeTrace2, compareTraces2 };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { compareTraces, normalizeTrace } from "./trace.js";
+export type { ConformanceTraceEntry } from "./trace.js";
+export { goldenPath, listGoldens, loadGolden } from "./goldens.js";
+export { ChecksumMismatchError, OfficialCompatUnavailableError, fetchAndVerifyUpstream, getChecksums, resolveCacheDir, runCapture, verifyDigest, verifySha512Integrity } from "./official/index.js";
+export { BunRequiredError, hasBunRuntime, requireBunRuntime } from "./bun-required.js";

package/dist/index.js

@@ -0,0 +1,49 @@
+import {
+  normalizeTrace2,
+  compareTraces2
+} from "./index-z5gwvsfh.js";
+import {
+  BunRequiredError2,
+  hasBunRuntime2,
+  requireBunRuntime2,
+  ChecksumMismatchError2,
+  OfficialCompatUnavailableError2,
+  getChecksums2,
+  verifyDigest2,
+  verifySha512Integrity2,
+  resolveCacheDir2,
+  fetchAndVerifyUpstream2,
+  runCapture2
+} from "./index-v0zvhx0z.js";
+// src/goldens.ts
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+var GOLDENS_DIR = fileURLToPath(new URL("../goldens/", import.meta.url));
+function listGoldens() {
+  return readdirSync(GOLDENS_DIR).filter((name) => name.endsWith(".trace.json")).sort();
+}
+function goldenPath(name) {
+  return join(GOLDENS_DIR, name);
+}
+function loadGolden(name) {
+  return JSON.parse(readFileSync(goldenPath(name), "utf8"));
+}
+export {
+  BunRequiredError2 as BunRequiredError,
+  ChecksumMismatchError2 as ChecksumMismatchError,
+  OfficialCompatUnavailableError2 as OfficialCompatUnavailableError,
+  compareTraces2 as compareTraces,
+  fetchAndVerifyUpstream2 as fetchAndVerifyUpstream,
+  getChecksums2 as getChecksums,
+  goldenPath,
+  hasBunRuntime2 as hasBunRuntime,
+  listGoldens,
+  loadGolden,
+  normalizeTrace2 as normalizeTrace,
+  requireBunRuntime2 as requireBunRuntime,
+  resolveCacheDir2 as resolveCacheDir,
+  runCapture2 as runCapture,
+  verifyDigest2 as verifyDigest,
+  verifySha512Integrity2 as verifySha512Integrity
+};

package/dist/official/capture.d.ts

@@ -0,0 +1 @@
+export declare function runCapture(): Promise<void>;

package/dist/official/fetch.d.ts

@@ -0,0 +1,40 @@
+declare const CHECKSUM_MISMATCH_BRAND: unique symbol;
+declare const OFFICIAL_COMPAT_UNAVAILABLE_BRAND: unique symbol;
+export declare class ChecksumMismatchError extends Error {
+    readonly [CHECKSUM_MISMATCH_BRAND] = true;
+    static [Symbol.hasInstance]: (candidate: unknown) => boolean;
+    constructor(message: string);
+}
+/** Thrown by `getChecksums()` when `compat/anthropic/0.3.250/checksums.json` is absent -- i.e. this module is running from an INSTALLED package rather than a repository checkout. Never a raw ENOENT. */
+export declare class OfficialCompatUnavailableError extends Error {
+    readonly [OFFICIAL_COMPAT_UNAVAILABLE_BRAND] = true;
+    static [Symbol.hasInstance]: (candidate: unknown) => boolean;
+    constructor(message: string);
+}
+interface UpstreamChecksums {
+    tarballUrl: string;
+    wrapperTarballSha256: string;
+    wrapperTarballIntegrity: string;
+}
+/**
+ * Lazily reads and memoizes the pinned-upstream checksums. Called ONLY from inside
+ * `fetchAndVerifyUpstream()` -- never at module load -- so importing this file (directly or through
+ * a barrel) never touches the filesystem. When `compat/` is absent (an installed package, per
+ * R-7a-12), throws a typed, worded `OfficialCompatUnavailableError` instead of letting a raw `ENOENT`
+ * surface with no explanation of why.
+ */
+export declare function getChecksums(): UpstreamChecksums;
+export declare function verifyDigest(bytes: Uint8Array, expected: string): void;
+export declare function verifySha512Integrity(bytes: Uint8Array, expectedIntegrity: string): void;
+export declare function resolveCacheDir(cacheDir?: string): {
+    dir: string;
+    ownedDir: boolean;
+};
+export declare function fetchAndVerifyUpstream(opts?: {
+    cacheDir?: string;
+}): Promise<{
+    tarballPath: string;
+    sha256: string;
+    ownedDir: boolean;
+}>;
+export {};

package/dist/official/index.d.ts

@@ -0,0 +1,3 @@
+export { ChecksumMismatchError, OfficialCompatUnavailableError, fetchAndVerifyUpstream, getChecksums, resolveCacheDir, verifyDigest, verifySha512Integrity } from "./fetch.js";
+export { runCapture } from "./capture.js";
+export { BunRequiredError, hasBunRuntime, requireBunRuntime } from "../bun-required.js";

package/dist/official/index.js

@@ -0,0 +1,27 @@
+import {
+  BunRequiredError2,
+  hasBunRuntime2,
+  requireBunRuntime2,
+  ChecksumMismatchError2,
+  OfficialCompatUnavailableError2,
+  getChecksums2,
+  verifyDigest2,
+  verifySha512Integrity2,
+  resolveCacheDir2,
+  fetchAndVerifyUpstream2,
+  runCapture2
+} from "../index-v0zvhx0z.js";
+import"../index-z5gwvsfh.js";
+export {
+  BunRequiredError2 as BunRequiredError,
+  ChecksumMismatchError2 as ChecksumMismatchError,
+  OfficialCompatUnavailableError2 as OfficialCompatUnavailableError,
+  fetchAndVerifyUpstream2 as fetchAndVerifyUpstream,
+  getChecksums2 as getChecksums,
+  hasBunRuntime2 as hasBunRuntime,
+  requireBunRuntime2 as requireBunRuntime,
+  resolveCacheDir2 as resolveCacheDir,
+  runCapture2 as runCapture,
+  verifyDigest2 as verifyDigest,
+  verifySha512Integrity2 as verifySha512Integrity
+};

package/dist/trace.d.ts

@@ -0,0 +1,9 @@
+export interface ConformanceTraceEntry {
+    sequence: number;
+    direction: "runtime-to-host" | "host-to-runtime" | "callback" | "process";
+    kind: string;
+    payload: unknown;
+    timestampClass?: "before" | "same-boundary" | "after";
+}
+export declare function normalizeTrace(entries: ConformanceTraceEntry[]): ConformanceTraceEntry[];
+export declare function compareTraces(a: ConformanceTraceEntry[], b: ConformanceTraceEntry[]): string[];

package/dist/trace.js

@@ -0,0 +1,8 @@
+import {
+  normalizeTrace2,
+  compareTraces2
+} from "./index-z5gwvsfh.js";
+export {
+  compareTraces2 as compareTraces,
+  normalizeTrace2 as normalizeTrace
+};

package/goldens/advertised-set-round.trace.json

@@ -0,0 +1,81 @@
+[
+  {
+    "sequence": 0,
+    "direction": "runtime-to-host",
+    "kind": "system/init",
+    "payload": {
+      "type": "system",
+      "subtype": "init",
+      "cwd": "/winter-fixture",
+      "model": "winter-test/echo",
+      "permissionMode": "default",
+      "tools": [
+        "Agent",
+        "AskUserQuestion",
+        "CronCreate",
+        "CronDelete",
+        "CronList",
+        "Edit",
+        "EnterPlanMode",
+        "EnterWorktree",
+        "ExitPlanMode",
+        "ExitWorktree",
+        "Glob",
+        "Grep",
+        "ListAgents",
+        "Monitor",
+        "NotebookEdit",
+        "PushNotification",
+        "Read",
+        "ReadNotifications",
+        "ReportFindings",
+        "ScheduleWakeup",
+        "SendMessage",
+        "Skill",
+        "TaskCreate",
+        "TaskGet",
+        "TaskList",
+        "TaskOutput",
+        "TaskStop",
+        "TaskUpdate",
+        "Workflow",
+        "Write"
+      ],
+      "apiKeySource": "none",
+      "slash_commands": [
+        "compact"
+      ],
+      "output_style": "default",
+      "skills": [],
+      "plugins": []
+    }
+  },
+  {
+    "sequence": 1,
+    "direction": "runtime-to-host",
+    "kind": "assistant",
+    "payload": {
+      "type": "assistant",
+      "message": {
+        "content": [
+          {
+            "type": "text",
+            "text": "echo: <system-reminder>\nAuto-memory (injected by the runtime, not typed by the user):\nAuto-memory for this project lives at /winter-home/projects/-winter-fixture/memory. The directory is created on demand and there are no memory tools: read and write it with the ordinary file tools, exactly like any other directory.\n\n/winter-home/projects/-winter-fixture/memory/MEMORY.md is the INDEX, and only its first 200 lines / 25 KB are loaded into a session. Keep every index entry to one line; the substance belongs in the topic file it points at, which you can read on demand when it turns out to matter.\n\nTo record something worth having in a LATER session -- a standing preference, a correction you were given, a durable constraint of this project -- write it to its own `<slug>.md` in that directory and add a one-line pointer to the index: `- [<slug>](<slug>.md) — <one-line summary>`.\n\nRevise a fact by rewriting its file and its index line, never by adding a near-duplicate under a new name; remove both once it stops being true. An index full of stale near-duplicates is worse than an empty one, because it costs the same and misleads.\n\nDo not record what the repository already records. Code, configuration, documentation and WINTER.md are durable on their own; memory is for what is true about this project or this user and lives nowhere in the tree.\n</system-reminder>\n\nhi"
+          }
+        ]
+      }
+    }
+  },
+  {
+    "sequence": 2,
+    "direction": "runtime-to-host",
+    "kind": "result",
+    "payload": {
+      "type": "result",
+      "subtype": "success",
+      "is_error": false,
+      "result": "echo: <system-reminder>\nAuto-memory (injected by the runtime, not typed by the user):\nAuto-memory for this project lives at /winter-home/projects/-winter-fixture/memory. The directory is created on demand and there are no memory tools: read and write it with the ordinary file tools, exactly like any other directory.\n\n/winter-home/projects/-winter-fixture/memory/MEMORY.md is the INDEX, and only its first 200 lines / 25 KB are loaded into a session. Keep every index entry to one line; the substance belongs in the topic file it points at, which you can read on demand when it turns out to matter.\n\nTo record something worth having in a LATER session -- a standing preference, a correction you were given, a durable constraint of this project -- write it to its own `<slug>.md` in that directory and add a one-line pointer to the index: `- [<slug>](<slug>.md) — <one-line summary>`.\n\nRevise a fact by rewriting its file and its index line, never by adding a near-duplicate under a new name; remove both once it stops being true. An index full of stale near-duplicates is worse than an empty one, because it costs the same and misleads.\n\nDo not record what the repository already records. Code, configuration, documentation and WINTER.md are durable on their own; memory is for what is true about this project or this user and lives nowhere in the tree.\n</system-reminder>\n\nhi",
+      "permission_denials": []
+    }
+  }
+]

package/goldens/background-task-round.trace.json

@@ -0,0 +1,210 @@
+[
+  {
+    "sequence": 0,
+    "direction": "runtime-to-host",
+    "kind": "system/init",
+    "payload": {
+      "type": "system",
+      "subtype": "init",
+      "cwd": "/winter-fixture",
+      "model": "winter-test/echo",
+      "permissionMode": "default",
+      "tools": [
+        "Agent",
+        "AskUserQuestion",
+        "Bash",
+        "CronCreate",
+        "CronDelete",
+        "CronList",
+        "Edit",
+        "EnterPlanMode",
+        "EnterWorktree",
+        "ExitPlanMode",
+        "ExitWorktree",
+        "Glob",
+        "Grep",
+        "ListAgents",
+        "Monitor",
+        "NotebookEdit",
+        "PushNotification",
+        "Read",
+        "ReadNotifications",
+        "ReportFindings",
+        "ScheduleWakeup",
+        "SendMessage",
+        "Skill",
+        "TaskCreate",
+        "TaskGet",
+        "TaskList",
+        "TaskOutput",
+        "TaskStop",
+        "TaskUpdate",
+        "Workflow",
+        "Write"
+      ],
+      "apiKeySource": "none",
+      "slash_commands": [
+        "compact"
+      ],
+      "output_style": "default",
+      "skills": [],
+      "plugins": []
+    }
+  },
+  {
+    "sequence": 1,
+    "direction": "runtime-to-host",
+    "kind": "assistant",
+    "payload": {
+      "type": "assistant",
+      "message": {
+        "content": [
+          {
+            "type": "tool_use",
+            "id": "bgtask-call-1",
+            "name": "differential_bgtask_probe",
+            "input": {
+              "command": "sleep 100 &"
+            }
+          }
+        ]
+      }
+    }
+  },
+  {
+    "sequence": 2,
+    "direction": "runtime-to-host",
+    "kind": "system/task_started",
+    "payload": {
+      "type": "system",
+      "subtype": "task_started",
+      "task_id": "bgtask-differential-1",
+      "tool_use_id": "bgtask-call-1",
+      "description": "sleep 100 &",
+      "task_type": "local_bash",
+      "is_backgrounded": true
+    }
+  },
+  {
+    "sequence": 3,
+    "direction": "runtime-to-host",
+    "kind": "system/background_tasks_changed",
+    "payload": {
+      "type": "system",
+      "subtype": "background_tasks_changed",
+      "tasks": [
+        {
+          "task_id": "bgtask-differential-1",
+          "task_type": "local_bash",
+          "description": "sleep 100 &",
+          "ambient": false
+        }
+      ]
+    }
+  },
+  {
+    "sequence": 4,
+    "direction": "runtime-to-host",
+    "kind": "system/task_progress",
+    "payload": {
+      "type": "system",
+      "subtype": "task_progress",
+      "task_id": "bgtask-differential-1",
+      "tool_use_id": "bgtask-call-1",
+      "description": "sleep 100 &",
+      "usage": {
+        "total_tokens": 0,
+        "tool_uses": 0
+      },
+      "last_tool_name": "Bash",
+      "summary": "still running"
+    }
+  },
+  {
+    "sequence": 5,
+    "direction": "runtime-to-host",
+    "kind": "system/task_updated",
+    "payload": {
+      "type": "system",
+      "subtype": "task_updated",
+      "task_id": "bgtask-differential-1",
+      "patch": {
+        "status": "completed",
+        "end_time": 0
+      }
+    }
+  },
+  {
+    "sequence": 6,
+    "direction": "runtime-to-host",
+    "kind": "system/task_notification",
+    "payload": {
+      "type": "system",
+      "subtype": "task_notification",
+      "task_id": "bgtask-differential-1",
+      "tool_use_id": "bgtask-call-1",
+      "status": "completed",
+      "output_file": "/winter-fixture/tasks/bgtask-differential-1.output",
+      "summary": "background bash task finished",
+      "usage": {
+        "total_tokens": 0,
+        "tool_uses": 0
+      }
+    }
+  },
+  {
+    "sequence": 7,
+    "direction": "runtime-to-host",
+    "kind": "system/local_command_output",
+    "payload": {
+      "type": "system",
+      "subtype": "local_command_output",
+      "content": "[background] sleep 100 & -> completed"
+    }
+  },
+  {
+    "sequence": 8,
+    "direction": "runtime-to-host",
+    "kind": "user",
+    "payload": {
+      "type": "user",
+      "message": {
+        "content": [
+          {
+            "type": "tool_result",
+            "tool_use_id": "bgtask-call-1",
+            "content": "backgrounded"
+          }
+        ]
+      }
+    }
+  },
+  {
+    "sequence": 9,
+    "direction": "runtime-to-host",
+    "kind": "assistant",
+    "payload": {
+      "type": "assistant",
+      "message": {
+        "content": [
+          {
+            "type": "text",
+            "text": "backgrounded"
+          }
+        ]
+      }
+    }
+  },
+  {
+    "sequence": 10,
+    "direction": "runtime-to-host",
+    "kind": "result",
+    "payload": {
+      "type": "result",
+      "subtype": "success",
+      "is_error": false,
+      "result": "backgrounded",
+      "permission_denials": []
+    }
+  }
+]

package/goldens/bash-background-round.trace.json

@@ -0,0 +1,148 @@
+[
+  {
+    "sequence": 0,
+    "direction": "runtime-to-host",
+    "kind": "system/init",
+    "payload": {
+      "type": "system",
+      "subtype": "init",
+      "cwd": "/winter-fixture",
+      "model": "winter-test/echo",
+      "permissionMode": "default",
+      "tools": [
+        "Agent",
+        "AskUserQuestion",
+        "Bash",
+        "CronCreate",
+        "CronDelete",
+        "CronList",
+        "Edit",
+        "EnterPlanMode",
+        "EnterWorktree",
+        "ExitPlanMode",
+        "ExitWorktree",
+        "Glob",
+        "Grep",
+        "ListAgents",
+        "Monitor",
+        "NotebookEdit",
+        "PushNotification",
+        "Read",
+        "ReadNotifications",
+        "ReportFindings",
+        "ScheduleWakeup",
+        "SendMessage",
+        "Skill",
+        "TaskCreate",
+        "TaskGet",
+        "TaskList",
+        "TaskOutput",
+        "TaskStop",
+        "TaskUpdate",
+        "Workflow",
+        "Write"
+      ],
+      "apiKeySource": "none",
+      "slash_commands": [
+        "compact"
+      ],
+      "output_style": "default",
+      "skills": [],
+      "plugins": []
+    }
+  },
+  {
+    "sequence": 1,
+    "direction": "runtime-to-host",
+    "kind": "assistant",
+    "payload": {
+      "type": "assistant",
+      "message": {
+        "content": [
+          {
+            "type": "tool_use",
+            "id": "bash-bg-call-1",
+            "name": "Bash",
+            "input": {
+              "command": "sleep 10",
+              "run_in_background": true
+            }
+          }
+        ]
+      }
+    }
+  },
+  {
+    "sequence": 2,
+    "direction": "runtime-to-host",
+    "kind": "system/task_started",
+    "payload": {
+      "type": "system",
+      "subtype": "task_started",
+      "task_id": "TASKID",
+      "description": "sleep 10",
+      "is_backgrounded": true
+    }
+  },
+  {
+    "sequence": 3,
+    "direction": "runtime-to-host",
+    "kind": "system/background_tasks_changed",
+    "payload": {
+      "type": "system",
+      "subtype": "background_tasks_changed",
+      "tasks": [
+        {
+          "task_id": "TASKID",
+          "task_type": "bash",
+          "description": "sleep 10"
+        }
+      ]
+    }
+  },
+  {
+    "sequence": 4,
+    "direction": "runtime-to-host",
+    "kind": "user",
+    "payload": {
+      "type": "user",
+      "message": {
+        "content": [
+          {
+            "type": "tool_result",
+            "tool_use_id": "bash-bg-call-1",
+            "content": "background task TASKID started\noutput_file: /winter-fixture-tasks/TASKID.output\n[sandbox: config-disabled]\nRead or grep that file for output as it accumulates; use task_output to peek, task_stop to stop it."
+          }
+        ]
+      }
+    }
+  },
+  {
+    "sequence": 5,
+    "direction": "runtime-to-host",
+    "kind": "assistant",
+    "payload": {
+      "type": "assistant",
+      "message": {
+        "content": [
+          {
+            "type": "text",
+            "text": "backgrounded"
+          }
+        ]
+      }
+    }
+  },
+  {
+    "sequence": 6,
+    "direction": "runtime-to-host",
+    "kind": "result",
+    "payload": {
+      "type": "result",
+      "subtype": "success",
+      "is_error": false,
+      "result": "backgrounded",
+      "permission_denials": []
+    }
+  }
+]