@bluewombat/manager-fake 0.1.0

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

@@ -0,0 +1,25 @@
+import type { ProgressWriter } from "../progress/emit.js";
+import type { FeatureStandard, Invalid, Invocation, RunOutcome } from "../types.js";
+export type RunResult = {
+    outcome: RunOutcome;
+    feature?: FeatureStandard;
+    invalid?: Invalid;
+    detail?: string;
+    exitCode: number;
+};
+export type RunOptions = {
+    invocation: Invocation;
+    /** The raw intention; the CLI reads it from --raw or stdin. */
+    raw: string;
+    write?: ProgressWriter;
+    now?: () => number;
+    interruptFlag?: {
+        interrupted: boolean;
+    };
+};
+export declare function invalidInvocationResult(write: ProgressWriter, reason: string): RunResult;
+/**
+ * Run one FeatureAdapter invocation to a run outcome.
+ */
+export declare function runAdapter(options: RunOptions): Promise<RunResult>;
+//# sourceMappingURL=run-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapter/run/run-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C,CAAC;AAiBF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAOxF;AAmBD;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA4FxE"}

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

@@ -0,0 +1,125 @@
+import { runFetch } from "../fetch/run-fetch.js";
+import { normalize } from "../normalize/normalize.js";
+import { parseRaw } from "../raw/parse-raw.js";
+function exitCodeFor(outcome) {
+    switch (outcome) {
+        case "converted":
+            return 0;
+        case "invalid":
+            return 1;
+        case "invalid-invocation":
+            return 2;
+        case "unavailable":
+            return 3;
+        case "interrupted":
+            return 130;
+    }
+}
+export function invalidInvocationResult(write, reason) {
+    write({ event: "result", outcome: "invalid-invocation", detail: reason });
+    return {
+        outcome: "invalid-invocation",
+        detail: reason,
+        exitCode: exitCodeFor("invalid-invocation"),
+    };
+}
+/** The raw `id`, as written, for the Fetch argv. */
+function rawIdArgument(raw) {
+    const value = raw.id;
+    if (typeof value === "string" && value.trim().length > 0) {
+        return value;
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return String(value);
+    }
+    return undefined;
+}
+function rawKindArgument(raw) {
+    const value = raw.kind;
+    return typeof value === "string" && value.trim().length > 0 ? value : "create";
+}
+/**
+ * Run one FeatureAdapter invocation to a run outcome.
+ */
+export async function runAdapter(options) {
+    const { invocation, raw } = options;
+    const write = options.write ?? (() => { });
+    const now = options.now ?? (() => Date.now());
+    const interruptState = options.interruptFlag ?? { interrupted: false };
+    const shouldInterrupt = () => interruptState.interrupted;
+    const finishInvalid = (invalid) => {
+        write({
+            event: "result",
+            manager: invocation.manager,
+            outcome: "invalid",
+            code: invalid.code,
+            reason: invalid.reason,
+        });
+        return { outcome: "invalid", invalid, exitCode: exitCodeFor("invalid") };
+    };
+    const finishUnavailable = (detail) => {
+        write({ event: "result", manager: invocation.manager, outcome: "unavailable", detail });
+        return { outcome: "unavailable", detail, exitCode: exitCodeFor("unavailable") };
+    };
+    const finishInterrupted = () => {
+        write({ event: "result", manager: invocation.manager, outcome: "interrupted" });
+        return { outcome: "interrupted", exitCode: exitCodeFor("interrupted") };
+    };
+    if (shouldInterrupt()) {
+        return finishInterrupted();
+    }
+    const parsed = parseRaw(raw, invocation.maxRawBytes);
+    if (!parsed.ok) {
+        // No id to enrich: the Fetch is skipped entirely.
+        return finishInvalid(parsed.invalid);
+    }
+    let merged = parsed.object;
+    if (invocation.fetchArgv !== undefined) {
+        const argv = [...invocation.fetchArgv, "--manager", invocation.manager];
+        const rawId = rawIdArgument(parsed.object);
+        if (rawId !== undefined) {
+            argv.push("--id", rawId);
+        }
+        argv.push("--kind", rawKindArgument(parsed.object));
+        const fetched = await runFetch({
+            argv,
+            timeoutMs: invocation.fetchDurationMs ?? 1,
+            shouldInterrupt,
+        });
+        write({ event: "fetch-finished", manager: invocation.manager, result: fetched.kind });
+        if (fetched.kind === "interrupted") {
+            return finishInterrupted();
+        }
+        if (fetched.kind === "unavailable") {
+            return finishUnavailable(fetched.detail);
+        }
+        if (fetched.kind === "merged") {
+            // The Fetch is the base; the raw intention is the fresher of the two.
+            merged = { ...fetched.object, ...parsed.object };
+        }
+    }
+    if (shouldInterrupt()) {
+        return finishInterrupted();
+    }
+    const normalizeOptions = {
+        manager: invocation.manager,
+        defaultPriority: invocation.defaultPriority,
+        normalizedAt: invocation.at ?? new Date(now()).toISOString(),
+        ...(invocation.defaultProject !== undefined
+            ? { defaultProject: invocation.defaultProject }
+            : {}),
+    };
+    const result = normalize(merged, normalizeOptions);
+    if (!result.ok) {
+        return finishInvalid(result.invalid);
+    }
+    write({
+        event: "result",
+        manager: invocation.manager,
+        key: result.feature.key,
+        outcome: "converted",
+        feature: result.feature,
+    });
+    return { outcome: "converted", feature: result.feature, exitCode: exitCodeFor("converted") };
+}
+//# sourceMappingURL=run-adapter.js.map

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

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

package/dist/adapter/types.d.ts

@@ -0,0 +1,51 @@
+/** Domain types owned by FeatureAdapter. Names match the Block perimeter only. */
+export type RunOutcome = "converted" | "invalid" | "invalid-invocation" | "unavailable" | "interrupted";
+export type Intent = "upsert" | "ready" | "cancel";
+export type InvalidCode = "raw-too-large" | "raw-not-json" | "raw-not-object" | "unknown-kind" | "missing-id" | "missing-project" | "missing-intention" | "bad-field-type" | "bad-priority";
+export type Invocation = {
+    manager: string;
+    /** The raw intention as one argument; absent means stdin. */
+    raw?: string;
+    defaultProject?: string;
+    defaultPriority: number;
+    maxRawBytes: number;
+    fetchArgv?: string[];
+    fetchDurationMs?: number;
+    /** Value stamped as normalized_at; absent means the current time. */
+    at?: string;
+};
+export type ParseResult = {
+    ok: true;
+    invocation: Invocation;
+} | {
+    ok: false;
+    reason: string;
+};
+export type FeatureStandard = {
+    key: string;
+    manager: string;
+    external_id: string;
+    intent: Intent;
+    project: string;
+    title?: string;
+    intention?: string;
+    priority: number;
+    source?: {
+        ref?: string;
+        revision?: string;
+    };
+    fingerprint: string;
+    normalized_at: string;
+};
+export type Invalid = {
+    code: InvalidCode;
+    reason: string;
+};
+export type NormalizeResult = {
+    ok: true;
+    feature: FeatureStandard;
+} | {
+    ok: false;
+    invalid: Invalid;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapter/types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,SAAS,GACT,oBAAoB,GACpB,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/adapter/types.js

@@ -0,0 +1,3 @@
+/** Domain types owned by FeatureAdapter. Names match the Block perimeter only. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapter/types.ts"],"names":[],"mappings":"AAAA,kFAAkF"}

package/dist/emitter/event/field-matrix.d.ts

@@ -0,0 +1,29 @@
+import type { EventFields, EventName } from "../types.js";
+export type FieldName = keyof EventFields;
+/** Column order of the matrix: it also orders a rendered section. */
+export declare const FIELD_ORDER: FieldName[];
+export declare const EVENT_NAMES: EventName[];
+type Rule = {
+    required: FieldName[];
+    optional: FieldName[];
+};
+/**
+ * What each Event accepts. A field outside its row is refused, not dropped:
+ * a caller setting `reference` on `planned` has confused two Events, and a
+ * report that hides that is worse than a refusal.
+ */
+export declare const FIELD_MATRIX: Record<EventName, Rule>;
+export type ValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Check one Event's fields against the matrix, plus the two rules on top of it.
+ * Pure: no directory, no clock.
+ */
+export declare function validateFields(event: EventName, fields: EventFields): ValidationResult;
+export declare function flagOf(field: FieldName): string;
+export {};
+//# sourceMappingURL=field-matrix.d.ts.map

package/dist/emitter/event/field-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-matrix.d.ts","sourceRoot":"","sources":["../../../src/emitter/event/field-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC;AAE1C,qEAAqE;AACrE,eAAO,MAAM,WAAW,EAAE,SAAS,EAclC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAAS,EAYlC,CAAC;AAEF,KAAK,IAAI,GAAG;IAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAAC,QAAQ,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,CAyBhD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,gBAAgB,CA4BtF;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE/C"}

package/dist/emitter/event/field-matrix.js

@@ -0,0 +1,93 @@
+/** Column order of the matrix: it also orders a rendered section. */
+export const FIELD_ORDER = [
+    "summary",
+    "reason",
+    "stage",
+    "trace",
+    "counters",
+    "plan",
+    "priority",
+    "unit",
+    "remaining",
+    "state",
+    "resume_point",
+    "reference",
+    "workspace_ref",
+];
+export const EVENT_NAMES = [
+    "invalid",
+    "accepted",
+    "planned",
+    "progress",
+    "escalated",
+    "escalation_reminder",
+    "resumed",
+    "submitted",
+    "done",
+    "cancelled",
+    "reject_late",
+];
+/**
+ * What each Event accepts. A field outside its row is refused, not dropped:
+ * a caller setting `reference` on `planned` has confused two Events, and a
+ * report that hides that is worse than a refusal.
+ */
+export const FIELD_MATRIX = {
+    invalid: { required: ["reason"], optional: [] },
+    accepted: { required: ["priority"], optional: [] },
+    planned: { required: ["plan"], optional: [] },
+    // Progress is one sentence a person reads — a Subtask landed, a refusal
+    // being repaired — and whatever detail the caller wants to leave under it.
+    progress: {
+        required: ["summary"],
+        optional: ["unit", "remaining", "state", "stage", "reason", "trace", "counters"],
+    },
+    escalated: {
+        required: ["reason", "stage"],
+        optional: ["trace", "counters", "unit"],
+    },
+    escalation_reminder: {
+        required: ["reason", "stage"],
+        optional: ["trace", "counters", "unit"],
+    },
+    resumed: { required: ["resume_point"], optional: ["reason"] },
+    // The work is in front of the Authority; the reference is where it can be seen.
+    submitted: { required: ["reference"], optional: [] },
+    // A local fold names nothing a reader could open; only an Authority's fold has a reference.
+    done: { required: [], optional: ["reference", "integration_reference"] },
+    cancelled: { required: ["state"], optional: ["reason", "workspace_ref"] },
+    reject_late: { required: ["reason"], optional: ["state", "reference"] },
+};
+/**
+ * Check one Event's fields against the matrix, plus the two rules on top of it.
+ * Pure: no directory, no clock.
+ */
+export function validateFields(event, fields) {
+    const rule = FIELD_MATRIX[event];
+    const allowed = new Set([...rule.required, ...rule.optional]);
+    const given = FIELD_ORDER.filter((field) => fields[field] !== undefined);
+    const refused = given.filter((field) => !allowed.has(field));
+    if (refused.length > 0) {
+        return {
+            ok: false,
+            reason: `Event "${event}" does not accept: ${refused.map(flagOf).join(", ")}.`,
+        };
+    }
+    const missing = rule.required.filter((field) => fields[field] === undefined);
+    if (missing.length > 0) {
+        return {
+            ok: false,
+            reason: `Event "${event}" requires: ${missing.map(flagOf).join(", ")}.`,
+        };
+    }
+    // An escalation about work that ran, without what it left behind, forces a
+    // human to reproduce the failure before they can understand it.
+    if (fields.stage === "unit" && fields.trace === undefined) {
+        return { ok: false, reason: 'Stage "unit" requires --trace or --trace-file.' };
+    }
+    return { ok: true };
+}
+export function flagOf(field) {
+    return `--${field.replace(/_/g, "-")}`;
+}
+//# sourceMappingURL=field-matrix.js.map

package/dist/emitter/event/field-matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-matrix.js","sourceRoot":"","sources":["../../../src/emitter/event/field-matrix.ts"],"names":[],"mappings":"AAIA,qEAAqE;AACrE,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,SAAS;IACT,QAAQ;IACR,OAAO;IACP,OAAO;IACP,UAAU;IACV,MAAM;IACN,UAAU;IACV,MAAM;IACN,WAAW;IACX,OAAO;IACP,cAAc;IACd,WAAW;IACX,eAAe;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,SAAS;IACT,UAAU;IACV,SAAS;IACT,UAAU;IACV,WAAW;IACX,qBAAqB;IACrB,SAAS;IACT,WAAW;IACX,MAAM;IACN,WAAW;IACX,aAAa;CACd,CAAC;AAIF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAA4B;IACnD,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC/C,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IAClD,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC7C,wEAAwE;IACxE,2EAA2E;IAC3E,QAAQ,EAAE;QACR,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC;KACjF;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC7B,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC;KACxC;IACD,mBAAmB,EAAE;QACnB,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC7B,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC;KACxC;IACD,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC7D,gFAAgF;IAChF,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IACpD,4FAA4F;IAC5F,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE;IACxE,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE;IACzE,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE;CACxE,CAAC;AAIF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAE,MAAmB;IAClE,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAY,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEzE,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,UAAU,KAAK,sBAAsB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SAC/E,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;IAC7E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,UAAU,KAAK,eAAe,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SACxE,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,gEAAgE;IAChE,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gDAAgD,EAAE,CAAC;IACjF,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAgB;IACrC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AACzC,CAAC"}

package/dist/emitter/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/emitter/progress/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../src/emitter/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/emitter/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/emitter/progress/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../src/emitter/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/emitter/render/render-event.d.ts

@@ -0,0 +1,14 @@
+import type { EventRecord, Invocation } from "../types.js";
+export type Rendered = {
+    record: EventRecord;
+    /** One line for the machine surface, newline included. */
+    line: string;
+    /** One section for the human surface, trailing newline included. */
+    section: string;
+};
+/**
+ * Turn one invocation into the exact bytes both Thread files receive.
+ * Pure: --dry-run renders through this same function, so a preview cannot lie.
+ */
+export declare function renderEvent(invocation: Invocation): Rendered;
+//# sourceMappingURL=render-event.d.ts.map

package/dist/emitter/render/render-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-event.d.ts","sourceRoot":"","sources":["../../../src/emitter/render/render-event.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASxE,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CA2B5D"}

package/dist/emitter/render/render-event.js

@@ -0,0 +1,116 @@
+import { FIELD_ORDER } from "../event/field-matrix.js";
+import { truncateText } from "./truncate.js";
+/** Free-text fields the report ceiling applies to. */
+const BOUNDED_FIELDS = ["reason", "plan", "trace"];
+/** Fields rendered as a fenced block rather than a bullet. */
+const BLOCK_FIELDS = ["trace", "plan"];
+/**
+ * Turn one invocation into the exact bytes both Thread files receive.
+ * Pure: --dry-run renders through this same function, so a preview cannot lie.
+ */
+export function renderEvent(invocation) {
+    const bounded = applyCeiling(invocation.fields, invocation.maxReportChars);
+    const record = {
+        event: invocation.event,
+        key: invocation.key,
+        project: invocation.project,
+        at: invocation.at,
+    };
+    if (invocation.eventId !== undefined) {
+        record.event_id = invocation.eventId;
+    }
+    for (const field of FIELD_ORDER) {
+        const value = bounded.fields[field];
+        if (value !== undefined) {
+            record[field] = value;
+        }
+    }
+    if (bounded.truncated.length > 0) {
+        record.truncated = bounded.truncated;
+    }
+    return {
+        record,
+        line: `${JSON.stringify(record)}\n`,
+        section: renderSection(invocation, bounded.fields),
+    };
+}
+function applyCeiling(fields, maxChars) {
+    const out = { ...fields };
+    const truncated = [];
+    for (const field of BOUNDED_FIELDS) {
+        const value = out[field];
+        if (typeof value !== "string") {
+            continue;
+        }
+        const cut = truncateText(value, maxChars);
+        if (cut.truncated) {
+            truncated.push(field);
+            out[field] = cut.text;
+        }
+    }
+    return { fields: out, truncated };
+}
+function renderSection(invocation, fields) {
+    const lines = [
+        `## ${invocation.at} — ${invocation.event}`,
+        "",
+        `- project: ${invocation.project}`,
+    ];
+    for (const field of FIELD_ORDER) {
+        if (BLOCK_FIELDS.includes(field) || field === "summary") {
+            continue;
+        }
+        const value = fields[field];
+        if (value === undefined) {
+            continue;
+        }
+        lines.push(`- ${label(field)}: ${bullet(value)}`);
+    }
+    if (typeof fields.summary === "string") {
+        lines.splice(2, 0, fields.summary, "");
+    }
+    const note = standingNote(invocation);
+    if (note !== undefined) {
+        lines.push(`- ${note}`);
+    }
+    for (const field of BLOCK_FIELDS) {
+        const value = fields[field];
+        if (typeof value !== "string") {
+            continue;
+        }
+        lines.push("", `### ${title(field)}`, "", "```text", value, "```");
+    }
+    lines.push("");
+    return `${lines.join("\n")}\n`;
+}
+/** What a reader must be told about this Event beyond its fields. */
+function standingNote(invocation) {
+    switch (invocation.event) {
+        case "escalated":
+            return "frozen: no further work starts until a human answers";
+        case "escalation_reminder":
+            return "frozen: still waiting, this is a repeat of an earlier escalation";
+        case "reject_late":
+            return "too late: this arrived after the point of no return";
+        default:
+            return undefined;
+    }
+}
+function label(field) {
+    return field.replace(/_/g, " ");
+}
+function title(field) {
+    return field === "trace" ? "Trace" : "Plan";
+}
+function bullet(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => String(entry)).join("; ");
+    }
+    if (value !== null && typeof value === "object") {
+        return Object.entries(value)
+            .map(([name, entry]) => `${name}=${entry}`)
+            .join(", ");
+    }
+    return String(value);
+}
+//# sourceMappingURL=render-event.js.map

package/dist/emitter/render/render-event.js.map

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

package/dist/emitter/render/truncate.d.ts

@@ -0,0 +1,9 @@
+export declare const TRUNCATION_MARKER = " [\u2026truncated]";
+export type TruncateResult = {
+    text: string;
+    truncated: boolean;
+};
+/** Cut long free text, and say so: a silent cut makes a human trust a
+ *  truncated diagnosis. */
+export declare function truncateText(text: string, maxChars: number): TruncateResult;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/emitter/render/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/emitter/render/truncate.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,uBAAkB,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE;2BAC2B;AAC3B,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAK3E"}

package/dist/emitter/render/truncate.js

@@ -0,0 +1,10 @@
+export const TRUNCATION_MARKER = " […truncated]";
+/** Cut long free text, and say so: a silent cut makes a human trust a
+ *  truncated diagnosis. */
+export function truncateText(text, maxChars) {
+    if (text.length <= maxChars) {
+        return { text, truncated: false };
+    }
+    return { text: `${text.slice(0, maxChars)}${TRUNCATION_MARKER}`, truncated: true };
+}
+//# sourceMappingURL=truncate.js.map

package/dist/emitter/render/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/emitter/render/truncate.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAIjD;2BAC2B;AAC3B,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB;IACzD,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACrF,CAAC"}

package/dist/emitter/run/run-emitter.d.ts

@@ -0,0 +1,21 @@
+import type { ProgressWriter } from "../progress/emit.js";
+import type { Invocation, RunOutcome } from "../types.js";
+export type RunResult = {
+    outcome: RunOutcome;
+    thread?: string;
+    detail?: string;
+    exitCode: number;
+};
+export type RunOptions = {
+    invocation: Invocation;
+    write?: ProgressWriter;
+    interruptFlag?: {
+        interrupted: boolean;
+    };
+};
+export declare function invalidInvocationResult(write: ProgressWriter, reason: string): RunResult;
+/**
+ * Run one FeatureEmitter invocation to a run outcome.
+ */
+export declare function runEmitter(options: RunOptions): RunResult;
+//# sourceMappingURL=run-emitter.d.ts.map

package/dist/emitter/run/run-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-emitter.d.ts","sourceRoot":"","sources":["../../../src/emitter/run/run-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,aAAa,CAAC,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C,CAAC;AAiBF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAOxF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAsEzD"}