@bluewombat/manager-fake 0.1.0

package/README.md

@@ -0,0 +1,58 @@
+# Manager: fake
+
+The FeatureManager triplet that needs no account: a directory of JSON files is
+the Source, a directory of `.ndjson` Threads is the report.
+Contract: [SPECS.md](./SPECS.md).
+
+```bash
+npm install @bluewombat/runtime @bluewombat/manager-fake
+npx mason init --manager @bluewombat/manager-fake
+```
+
+```json
+{
+  "manager": "@bluewombat/manager-fake",
+  "managerOptions": { "source": "./.mason/source", "target": "./.mason/threads" }
+}
+```
+
+## Options
+
+| Option            | Required | Default | Meaning                                                         |
+| ----------------- | -------- | ------- | --------------------------------------------------------------- |
+| `source`          | yes      | —       | Directory of raw intentions. Must exist. Relative to the config |
+| `target`          | yes      | —       | Directory the Threads are appended to. Created if absent        |
+| `defaultPriority` | no       | `50`    | Priority for a raw intention that carries none (0…100)          |
+
+## Stack
+
+Repository stack — TypeScript, Node 24.20, Biome, `node:test`. See [docs/DEVELOPMENT.md](../../../docs/DEVELOPMENT.md).
+
+## Setup
+
+From the repository root:
+
+```bash
+nvm use
+npm install
+```
+
+## Commands
+
+| Task      | Command          |
+| --------- | ---------------- |
+| Lint      | `npm run lint`   |
+| Format    | `npm run format` |
+| Typecheck | `npm run tsc`    |
+| Test      | `npm test`       |
+| Build     | `npm run build`  |
+
+## Layout
+
+```
+SPECS.md      the contract
+README.md     how to build and configure it
+src/
+  index.ts    createManager, checkManager, scaffoldManager — the plugin face
+  manager.ts  the ManagerPort (listen / adapt / report live in listener/, adapter/, emitter/)
+```

package/SPECS.md

@@ -0,0 +1,65 @@
+# Manager: fake
+
+A plugin, not a Transformer. Directory Source in, directory Thread out, as
+one `ManagerPort`. Listen / adapt / report live in this package.
+
+## 1. Job
+
+```
+  Host                          manager-fake
+  ----                          ------------
+  managerOptions                read source / target
+  a Cursor                      drain the directory
+  one semantic Event            append to the Thread
+                            ←   ManagerPort
+```
+
+**In:** a `ManagerContext`. **Out:** a `ManagerPort`, or a reason.
+
+## 2. Options
+
+Relative paths resolve against the config file's directory, so a checked-in
+example needs no absolute path.
+
+| Option            | Rule                                                              |
+| ----------------- | ----------------------------------------------------------------- |
+| `source`          | Required. Must already exist as a directory — this package never creates it |
+| `target`          | Required. Created at `createManager` time if absent               |
+| `defaultPriority` | Integer 0…100. Default 50                                        |
+
+An unknown option key is refused by name.
+
+## 3. Keys
+
+`fake:<id>` from the raw intention's `id`, or `fake:unconvertible` when it has
+none. The project is the payload's `project`, or `unknown`.
+
+## 4. Ready
+
+This manager has no ready signal: a directory Source delivers a `ready` file as
+its own intention, so `signalsReady` is absent and Host uses the
+FeatureStandard's `intent`.
+
+## 5. Doctor
+
+`checkManager` reports the Source (`fail` when it is not a directory) and the
+Thread directory (`warn` when it does not exist yet — the run creates it). No
+network, ever.
+
+## 6. Init
+
+`scaffoldManager` writes the default `source` / `target` paths and creates
+those directories so the first JSON file has somewhere to go. `createManager`
+still refuses a missing Source: prepare is an init convenience, not a silent
+create at run time.
+
+## 7. Acceptance
+
+1. Relative `source` and `target` resolve against the config file, and the
+   Thread directory exists after `createManager`.
+2. A missing `source` directory, a missing required option, and an unknown
+   option key each return a reason, not a throw.
+3. `checkManager` with unreadable options returns exactly one `fail`.
+4. `scaffoldManager` creates the default Source and Thread directories.
+
+How to build and configure: [README.md](./README.md).

package/dist/adapter/fetch/run-fetch.d.ts

@@ -0,0 +1,24 @@
+export type FetchResult = {
+    kind: "merged";
+    object: Record<string, unknown>;
+} | {
+    kind: "empty";
+} | {
+    kind: "unavailable";
+    detail: string;
+} | {
+    kind: "interrupted";
+};
+export type FetchRequest = {
+    argv: string[];
+    timeoutMs: number;
+    shouldInterrupt: () => boolean;
+};
+/**
+ * Run the enrichment command. Every failure is `unavailable`, never `invalid`:
+ * a Fetch that did not answer says nothing about the intention.
+ */
+export declare function runFetch(request: FetchRequest): Promise<FetchResult>;
+/** Exported for tests: the stdout contract of the Fetch, without a process. */
+export declare function readFetchStdout(stdout: string): FetchResult;
+//# sourceMappingURL=run-fetch.d.ts.map

package/dist/adapter/fetch/run-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-fetch.d.ts","sourceRoot":"","sources":["../../../src/adapter/fetch/run-fetch.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,OAAO,CAAC;CAChC,CAAC;AAQF;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA2FpE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAgB3D"}

package/dist/adapter/fetch/run-fetch.js

@@ -0,0 +1,119 @@
+import { spawn } from "node:child_process";
+const OUTPUT_TRUNCATE = 8_192;
+function truncate(text) {
+    return text.length <= OUTPUT_TRUNCATE ? text : `${text.slice(0, OUTPUT_TRUNCATE)}…[truncated]`;
+}
+/**
+ * Run the enrichment command. Every failure is `unavailable`, never `invalid`:
+ * a Fetch that did not answer says nothing about the intention.
+ */
+export function runFetch(request) {
+    return new Promise((resolve) => {
+        const [file, ...args] = request.argv;
+        if (file === undefined) {
+            resolve({ kind: "unavailable", detail: "Empty Fetch command." });
+            return;
+        }
+        let settled = false;
+        let timedOut = false;
+        let interrupted = false;
+        let stdout = "";
+        let stderr = "";
+        let timer;
+        let interruptPoll;
+        const finish = (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            if (interruptPoll !== undefined) {
+                clearInterval(interruptPoll);
+            }
+            resolve(result);
+        };
+        let child;
+        try {
+            child = spawn(file, args, { stdio: ["ignore", "pipe", "pipe"] });
+        }
+        catch (error) {
+            finish({
+                kind: "unavailable",
+                detail: error instanceof Error ? error.message : String(error),
+            });
+            return;
+        }
+        child.stdout?.setEncoding("utf8");
+        child.stderr?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.on("error", (error) => {
+            finish({ kind: "unavailable", detail: error.message });
+        });
+        timer = setTimeout(() => {
+            timedOut = true;
+            kill(child);
+        }, Math.max(1, request.timeoutMs));
+        interruptPoll = setInterval(() => {
+            if (request.shouldInterrupt()) {
+                interrupted = true;
+                kill(child);
+            }
+        }, 20);
+        child.on("close", (exitCode) => {
+            if (interrupted || request.shouldInterrupt()) {
+                finish({ kind: "interrupted" });
+                return;
+            }
+            if (timedOut) {
+                finish({
+                    kind: "unavailable",
+                    detail: `The Fetch was killed after ${request.timeoutMs}ms.`,
+                });
+                return;
+            }
+            if (exitCode !== 0) {
+                finish({
+                    kind: "unavailable",
+                    detail: `The Fetch exited ${exitCode}. ${truncate(stderr).trim()}`.trim(),
+                });
+                return;
+            }
+            finish(readFetchStdout(stdout));
+        });
+    });
+}
+/** Exported for tests: the stdout contract of the Fetch, without a process. */
+export function readFetchStdout(stdout) {
+    const trimmed = stdout.trim();
+    if (trimmed.length === 0) {
+        return { kind: "empty" };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return { kind: "unavailable", detail: `The Fetch stdout is not JSON: ${detail}` };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { kind: "unavailable", detail: "The Fetch stdout is not a JSON object." };
+    }
+    return { kind: "merged", object: parsed };
+}
+function kill(child) {
+    try {
+        child.kill("SIGKILL");
+    }
+    catch {
+        // already gone
+    }
+}
+//# sourceMappingURL=run-fetch.js.map

package/dist/adapter/fetch/run-fetch.js.map

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

package/dist/adapter/normalize/fingerprint.d.ts

@@ -0,0 +1,8 @@
+/** JSON with object keys sorted, so two equal documents hash the same. */
+export declare function canonicalJson(value: unknown): string;
+/**
+ * Answers "did this intention change?". Covers every field of the
+ * FeatureStandard except the two that are not the intention itself.
+ */
+export declare function fingerprintOf(document: Record<string, unknown>): string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/adapter/normalize/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../src/adapter/normalize/fingerprint.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYpD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAKvE"}

package/dist/adapter/normalize/fingerprint.js

@@ -0,0 +1,26 @@
+import { createHash } from "node:crypto";
+/** JSON with object keys sorted, so two equal documents hash the same. */
+export function canonicalJson(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value) ?? "null";
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalJson).join(",")}]`;
+    }
+    const entries = Object.entries(value)
+        .filter(([, entryValue]) => entryValue !== undefined)
+        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+        .map(([key, entryValue]) => `${JSON.stringify(key)}:${canonicalJson(entryValue)}`);
+    return `{${entries.join(",")}}`;
+}
+/**
+ * Answers "did this intention change?". Covers every field of the
+ * FeatureStandard except the two that are not the intention itself.
+ */
+export function fingerprintOf(document) {
+    const subject = { ...document };
+    delete subject.fingerprint;
+    delete subject.normalized_at;
+    return `sha256:${createHash("sha256").update(canonicalJson(subject)).digest("hex")}`;
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/adapter/normalize/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../../src/adapter/normalize/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACnD,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;SAC7D,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC;SACpD,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACrE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACrF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAiC;IAC7D,MAAM,OAAO,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzD,OAAO,OAAO,CAAC,WAAW,CAAC;IAC3B,OAAO,OAAO,CAAC,aAAa,CAAC;IAC7B,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACvF,CAAC"}

package/dist/adapter/normalize/normalize.d.ts

@@ -0,0 +1,17 @@
+import type { NormalizeResult } from "../types.js";
+export type NormalizeOptions = {
+    manager: string;
+    defaultProject?: string;
+    defaultPriority: number;
+    normalizedAt: string;
+};
+/**
+ * Turn a parsed raw intention into a FeatureStandard, or say why it cannot be
+ * one. Pure: no clock, no child process, no file.
+ *
+ * Checks run in a fixed order — every recognised field's type first, then the
+ * kind, then the fields the intent requires, then the priority scale — so one
+ * raw intention always produces the same code.
+ */
+export declare function normalize(raw: Record<string, unknown>, options: NormalizeOptions): NormalizeResult;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/adapter/normalize/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/adapter/normalize/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoC,eAAe,EAAE,MAAM,aAAa,CAAC;AAGrF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAsHF;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,gBAAgB,GACxB,eAAe,CA2FjB"}

package/dist/adapter/normalize/normalize.js

@@ -0,0 +1,199 @@
+import { fingerprintOf } from "./fingerprint.js";
+const KIND_TO_INTENT = {
+    create: "upsert",
+    update: "upsert",
+    ready: "ready",
+    cancel: "cancel",
+    delete: "cancel",
+};
+const PRIORITY_NAMES = {
+    low: 25,
+    normal: 50,
+    high: 75,
+    urgent: 100,
+};
+function badType(field, value) {
+    return {
+        code: "bad-field-type",
+        reason: `Field "${field}" is ${describe(value)}, which this Block cannot read.`,
+    };
+}
+function describe(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (Array.isArray(value)) {
+        return "an array";
+    }
+    return `a ${typeof value}`;
+}
+function readString(raw, field) {
+    const value = raw[field];
+    if (value === undefined) {
+        return { ok: true };
+    }
+    if (typeof value !== "string") {
+        return { ok: false, invalid: badType(field, value) };
+    }
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? { ok: true } : { ok: true, value: trimmed };
+}
+function readIdLike(raw, field) {
+    const value = raw[field];
+    if (value === undefined) {
+        return { ok: true };
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return { ok: true, value: String(value) };
+    }
+    if (typeof value !== "string") {
+        return { ok: false, invalid: badType(field, value) };
+    }
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? { ok: true } : { ok: true, value: trimmed };
+}
+function readPriority(raw) {
+    const value = raw.priority;
+    if (value === undefined) {
+        return { ok: true };
+    }
+    if (typeof value === "number") {
+        if (!Number.isInteger(value) || value < 0 || value > 100) {
+            return {
+                ok: false,
+                invalid: {
+                    code: "bad-priority",
+                    reason: `Priority ${value} is outside the 0…100 scale.`,
+                },
+            };
+        }
+        return { ok: true, value };
+    }
+    if (typeof value !== "string") {
+        return { ok: false, invalid: badType("priority", value) };
+    }
+    const named = PRIORITY_NAMES[value.trim().toLowerCase()];
+    if (named === undefined) {
+        return {
+            ok: false,
+            invalid: {
+                code: "bad-priority",
+                reason: `Priority "${value}" is not one of low, normal, high, urgent.`,
+            },
+        };
+    }
+    return { ok: true, value: named };
+}
+function readKind(raw) {
+    const value = raw.kind;
+    if (value === undefined) {
+        return { ok: true, value: "upsert" };
+    }
+    if (typeof value !== "string") {
+        return { ok: false, invalid: badType("kind", value) };
+    }
+    const intent = KIND_TO_INTENT[value.trim().toLowerCase()];
+    if (intent === undefined) {
+        return {
+            ok: false,
+            invalid: {
+                code: "unknown-kind",
+                reason: `Kind "${value}" is not one of create, update, ready, cancel, delete.`,
+            },
+        };
+    }
+    return { ok: true, value: intent };
+}
+/**
+ * Turn a parsed raw intention into a FeatureStandard, or say why it cannot be
+ * one. Pure: no clock, no child process, no file.
+ *
+ * Checks run in a fixed order — every recognised field's type first, then the
+ * kind, then the fields the intent requires, then the priority scale — so one
+ * raw intention always produces the same code.
+ */
+export function normalize(raw, options) {
+    const externalId = readIdLike(raw, "id");
+    if (!externalId.ok) {
+        return { ok: false, invalid: externalId.invalid };
+    }
+    const project = readString(raw, "project");
+    if (!project.ok) {
+        return { ok: false, invalid: project.invalid };
+    }
+    const title = readString(raw, "title");
+    if (!title.ok) {
+        return { ok: false, invalid: title.invalid };
+    }
+    const intention = readString(raw, "intention");
+    if (!intention.ok) {
+        return { ok: false, invalid: intention.invalid };
+    }
+    const ref = readString(raw, "url");
+    if (!ref.ok) {
+        return { ok: false, invalid: ref.invalid };
+    }
+    const revision = readIdLike(raw, "revision");
+    if (!revision.ok) {
+        return { ok: false, invalid: revision.invalid };
+    }
+    const kind = readKind(raw);
+    if (!kind.ok) {
+        return { ok: false, invalid: kind.invalid };
+    }
+    const intent = kind.value ?? "upsert";
+    if (externalId.value === undefined) {
+        return {
+            ok: false,
+            invalid: { code: "missing-id", reason: 'The raw intention carries no usable "id".' },
+        };
+    }
+    const resolvedProject = project.value ?? options.defaultProject;
+    if (resolvedProject === undefined) {
+        return {
+            ok: false,
+            invalid: {
+                code: "missing-project",
+                reason: 'No "project" in the raw intention and no --default-project.',
+            },
+        };
+    }
+    const resolvedIntention = intention.value ?? title.value;
+    if (intent === "upsert" && resolvedIntention === undefined) {
+        return {
+            ok: false,
+            invalid: {
+                code: "missing-intention",
+                reason: 'An upsert needs an "intention" or, failing that, a "title".',
+            },
+        };
+    }
+    const priority = readPriority(raw);
+    if (!priority.ok) {
+        return { ok: false, invalid: priority.invalid };
+    }
+    const source = {};
+    if (ref.value !== undefined) {
+        source.ref = ref.value;
+    }
+    if (revision.value !== undefined) {
+        source.revision = revision.value;
+    }
+    // Built in the order the FeatureStandard documents, so stdout reads top-down.
+    const feature = {
+        key: `${options.manager}:${externalId.value}`,
+        manager: options.manager,
+        external_id: externalId.value,
+        intent,
+        project: resolvedProject,
+        ...(title.value !== undefined ? { title: title.value } : {}),
+        ...(resolvedIntention !== undefined ? { intention: resolvedIntention } : {}),
+        priority: priority.value ?? options.defaultPriority,
+        ...(Object.keys(source).length > 0 ? { source } : {}),
+        fingerprint: "",
+        normalized_at: options.normalizedAt,
+    };
+    feature.fingerprint = fingerprintOf(feature);
+    return { ok: true, feature };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/adapter/normalize/normalize.js.map

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

package/dist/adapter/progress/emit.d.ts

@@ -0,0 +1,3 @@
+export type ProgressWriter = (line: Record<string, unknown>) => void;
+export declare function createStdoutProgressWriter(): ProgressWriter;
+//# sourceMappingURL=emit.d.ts.map

package/dist/adapter/progress/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../src/adapter/progress/emit.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAErE,wBAAgB,0BAA0B,IAAI,cAAc,CAI3D"}

package/dist/adapter/progress/emit.js

@@ -0,0 +1,6 @@
+export function createStdoutProgressWriter() {
+    return (line) => {
+        process.stdout.write(`${JSON.stringify(line)}\n`);
+    };
+}
+//# sourceMappingURL=emit.js.map

package/dist/adapter/progress/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../src/adapter/progress/emit.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,0BAA0B;IACxC,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC"}

package/dist/adapter/raw/parse-raw.d.ts

@@ -0,0 +1,14 @@
+import type { Invalid } from "../types.js";
+export type ParseRawResult = {
+    ok: true;
+    object: Record<string, unknown>;
+} | {
+    ok: false;
+    invalid: Invalid;
+};
+/**
+ * Structural checks on the raw intention: size, then JSON, then object.
+ * Nothing here looks at a field — that is normalization's job.
+ */
+export declare function parseRaw(raw: string, maxRawBytes: number): ParseRawResult;
+//# sourceMappingURL=parse-raw.d.ts.map

package/dist/adapter/raw/parse-raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-raw.d.ts","sourceRoot":"","sources":["../../../src/adapter/raw/parse-raw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAkCzE"}

package/dist/adapter/raw/parse-raw.js

@@ -0,0 +1,47 @@
+/**
+ * Structural checks on the raw intention: size, then JSON, then object.
+ * Nothing here looks at a field — that is normalization's job.
+ */
+export function parseRaw(raw, maxRawBytes) {
+    const bytes = Buffer.byteLength(raw, "utf8");
+    if (bytes > maxRawBytes) {
+        return {
+            ok: false,
+            invalid: {
+                code: "raw-too-large",
+                reason: `The raw intention is ${bytes} bytes, over the ${maxRawBytes} allowed.`,
+            },
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return {
+            ok: false,
+            invalid: { code: "raw-not-json", reason: `The raw intention is not JSON: ${detail}` },
+        };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return {
+            ok: false,
+            invalid: {
+                code: "raw-not-object",
+                reason: `The raw intention parsed to ${describe(parsed)}, not an object.`,
+            },
+        };
+    }
+    return { ok: true, object: parsed };
+}
+function describe(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (Array.isArray(value)) {
+        return "an array";
+    }
+    return `a ${typeof value}`;
+}
+//# sourceMappingURL=parse-raw.js.map

package/dist/adapter/raw/parse-raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-raw.js","sourceRoot":"","sources":["../../../src/adapter/raw/parse-raw.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,WAAmB;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;QACxB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE;gBACP,IAAI,EAAE,eAAe;gBACrB,MAAM,EAAE,wBAAwB,KAAK,oBAAoB,WAAW,WAAW;aAChF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,kCAAkC,MAAM,EAAE,EAAE;SACtF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE;gBACP,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,+BAA+B,QAAQ,CAAC,MAAM,CAAC,kBAAkB;aAC1E;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAiC,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,OAAO,KAAK,EAAE,CAAC;AAC7B,CAAC"}