@davidorex/pi-context 0.29.0 → 0.31.0

package/dist/read-element.js

@@ -47,6 +47,13 @@ export function discoverArrayKey(data) {
 }
 /** Stable, greppable footer prefix — keep in sync with consumers/tests. */
 export const READ_ELEMENT_FOOTER_PREFIX = "[read-element:";
+/** Module-private key for the render context — symbol-keyed, so JSON.stringify ignores it. */
+const RENDER_CONTEXT = Symbol("read-element:render-context");
+/** Attach render context to a ReadStructured under the private symbol (non-enumerable to JSON). */
+function withRenderContext(s, ctx) {
+    s[RENDER_CONTEXT] = ctx;
+    return s;
+}
 export const DEFAULT_LIMIT = 50;
 /**
  * The ONE pagination implementation. Slices `arr` at offset(0)/limit(50) and
@@ -110,6 +117,27 @@ function resolveCollection(value, itemsKey) {
  * (prefix `[read-element:`) since the next page is reachable via offset/limit.
  */
 export function serializeForRead(value, opts = {}) {
+    const structured = structureForRead(value, opts);
+    return {
+        content: renderReadText(structured),
+        total: structured.total,
+        hasMore: structured.hasMore,
+        truncated: structured.truncated,
+        totalBytes: structured.totalBytes,
+        complete: structured.complete,
+    };
+}
+/**
+ * The cap / pagination / metadata computation that previously lived inside
+ * serializeForRead, returning the value UN-stringified (TASK-012 / FGAP-013).
+ * `data` is the page slice (collections) or the whole object — never stringified,
+ * never footered. The metadata fields mirror {@link ReadEnvelope}; the text-render
+ * inputs (label / offset / overCapDirective / paged / capped head) ride along
+ * under a private symbol so {@link renderReadText} can reproduce the exact prior
+ * `content` while JSON.stringify (the CLI `--json` envelope) emits only the six
+ * documented structured fields.
+ */
+export function structureForRead(value, opts = {}) {
     const offset = opts.offset ?? 0;
     const resolved = opts.whole ? { collection: false } : resolveCollection(value, opts.itemsKey);
     let serialized;
@@ -131,56 +159,86 @@ export function serializeForRead(value, opts = {}) {
     const jsonStr = JSON.stringify(serialized, null, 2);
     const cap = truncateHead(jsonStr);
     const label = opts.label ?? "result";
+    const renderCtx = {
+        label,
+        rawLabel: opts.label,
+        offset,
+        paged,
+        overCapDirective: opts.overCapDirective,
+        cappedContent: cap.content,
+    };
+    // Over-cap fail-closed (FGAP-089) → complete:false; under-cap → complete:true.
+    // The over-cap REFUSAL/PARTIAL *text* rendering is a renderReadText concern,
+    // but the structured `data` must ALSO fail closed: on over-cap (cap.truncated)
+    // `data` is bounded to null so the `--json` surface (which emits `data` directly
+    // via JSON.stringify, never routing through cappedContent) cannot leak the full
+    // un-truncated value past the cap, and a constrained agent never receives a
+    // truncated value dressed as complete. Under-cap (incl. paged-but-not-over-cap)
+    // keeps the full/page value unchanged. Metadata (truncated/totalBytes/total/
+    // hasMore/complete) is unaffected.
+    const complete = !cap.truncated;
+    return withRenderContext({
+        data: cap.truncated ? null : serialized,
+        total,
+        hasMore,
+        truncated: cap.truncated,
+        totalBytes: cap.totalBytes,
+        complete,
+    }, renderCtx);
+}
+/**
+ * Render a {@link ReadStructured} to the EXACT text serializeForRead's `content`
+ * produced before the TASK-012 split: the stringified body + the structured
+ * `[read-element:` paging footer, OR — on the over-cap fail-closed paths
+ * (FGAP-089) — the directive-only REFUSAL (no body) when a narrowing tool was
+ * named, else the head-leading marked PARTIAL. Reads its render inputs from the
+ * private symbol attached by {@link structureForRead}.
+ */
+export function renderReadText(s) {
+    const ctx = s[RENDER_CONTEXT];
+    // Defensive: a ReadStructured constructed without structureForRead has no
+    // render context — fall back to a plain stringify of the data.
+    if (ctx === undefined)
+        return JSON.stringify(s.data, null, 2);
+    const { label, offset, paged, overCapDirective, cappedContent } = ctx;
     // ── FGAP-089 over-CAP fail-closed path ──────────────────────────────────
     // When the serialized value exceeds the read cap, a partial body must NOT be
     // returned as if it were the whole value — a constrained agent skimmed past
     // the old trailing `[read-element: truncated …]` footer and treated a
-    // truncated catalog as complete (degraded info). So an over-cap read now
-    // fails closed: either a directive-only REFUSAL (when a narrowing tool
-    // exists) or an UNMISSABLE HEAD-LEADING marked partial (edge surfaces with
-    // no finer addressing). Either way `complete:false`.
-    if (cap.truncated) {
-        if (opts.overCapDirective !== undefined) {
+    // truncated catalog as complete (degraded info). So an over-cap read fails
+    // closed: either a directive-only REFUSAL (when a narrowing tool exists) or
+    // an UNMISSABLE HEAD-LEADING marked partial (edge surfaces with no finer
+    // addressing). Either way the structured `complete` is false.
+    if (s.truncated) {
+        if (overCapDirective !== undefined) {
             // Narrowing available → DIRECTIVE ONLY, no serialized body at all.
-            const { tool, params, hint } = opts.overCapDirective;
+            const { tool, params, hint } = overCapDirective;
             const paramsString = params && Object.keys(params).length > 0
                 ? Object.entries(params)
                     .map(([k, v]) => `${k}=${v}`)
                     .join(" ")
                 : undefined;
-            const content = `⚠️ READ REFUSED — this ${label} is ${cap.totalBytes} bytes, over the 50KB read cap. ` +
+            return (`⚠️ READ REFUSED — this ${label} is ${s.totalBytes} bytes, over the 50KB read cap. ` +
                 `Nothing was returned (a partial read would mislead). ` +
-                `Narrow your read: call \`${tool}\`${paramsString ? ` with ${paramsString}` : ""}.${hint ? ` ${hint}` : ""}`;
-            return { content, total, hasMore, truncated: true, totalBytes: cap.totalBytes, complete: false };
+                `Narrow your read: call \`${tool}\`${paramsString ? ` with ${paramsString}` : ""}.${hint ? ` ${hint}` : ""}`);
         }
-        // No finer addressing (edge case) → UNMISSABLE HEAD-LEADING marked
-        // partial. The warning goes FIRST (the old footer failed because it sat
-        // at the END, skimmed past); the head follows so the caller can still
-        // see structure, but is explicitly told it is INCOMPLETE.
-        const content = `⚠️ PARTIAL READ — this ${label} is ${cap.totalBytes} bytes, capped at 50KB, and has no finer addressing. ` +
-            `The HEAD below is INCOMPLETE — do NOT treat it as the full value:\n\n${cap.content}`;
-        return { content, total, hasMore, truncated: true, totalBytes: cap.totalBytes, complete: false };
+        // No finer addressing (edge case) → UNMISSABLE HEAD-LEADING marked partial.
+        return (`⚠️ PARTIAL READ — this ${label} is ${s.totalBytes} bytes, capped at 50KB, and has no finer addressing. ` +
+            `The HEAD below is INCOMPLETE — do NOT treat it as the full value:\n\n${cappedContent}`);
     }
     // ── Not over-cap: full content (a paged-but-not-truncated page is complete;
     // `hasMore` signals further pages). Paging footer stays — paging is reachable
     // via offset/limit, so it does not fail closed.
     const footers = [];
-    if (paged && total !== undefined) {
+    if (paged && s.total !== undefined) {
         // shown range is 1-based inclusive over the served slice
-        const shownCount = Array.isArray(serialized) ? serialized.length : 0;
-        const from = total === 0 ? 0 : offset + 1;
+        const shownCount = Array.isArray(s.data) ? s.data.length : 0;
+        const from = s.total === 0 ? 0 : offset + 1;
         const to = offset + shownCount;
-        const labelSuffix = opts.label ? ` · ${opts.label}` : "";
-        footers.push(`\n\n${READ_ELEMENT_FOOTER_PREFIX} showing ${from}-${to} of ${total} · hasMore=${hasMore}${labelSuffix} · narrow with an address]`);
+        const labelSuffix = ctx.rawLabel ? ` · ${ctx.rawLabel}` : "";
+        footers.push(`\n\n${READ_ELEMENT_FOOTER_PREFIX} showing ${from}-${to} of ${s.total} · hasMore=${s.hasMore}${labelSuffix} · narrow with an address]`);
     }
-    return {
-        content: cap.content + footers.join(""),
-        total,
-        hasMore,
-        truncated: false,
-        totalBytes: cap.totalBytes,
-        complete: true,
-    };
+    return cappedContent + footers.join("");
 }
 function asArrayOrSingleArray(value) {
     if (Array.isArray(value))

package/dist/read-element.js.map

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

package/dist/schema-merge.d.ts

@@ -0,0 +1,26 @@
+/** An irreconcilable 3-way disagreement at a single dotted schema path. */
+export interface SchemaConflict {
+    /** Dotted path from the schema root (e.g. `properties.status.type`). */
+    path: string;
+    /** The value at this path in the recorded merge base. */
+    base: unknown;
+    /** The value at this path in the currently-installed (locally-edited) body. */
+    ours: unknown;
+    /** The value at this path in the catalog's current body. */
+    theirs: unknown;
+}
+/**
+ * Deterministic 3-way merge of three draft-07 schema bodies.
+ *
+ * @param base   the recorded merge baseline body
+ * @param ours   the currently-installed (locally-edited) body
+ * @param theirs the catalog's current body
+ * @returns `{ merged, conflicts }` — `merged` is the merged object (conflicting
+ *          nodes left as OURS); `conflicts` is the per-path disagreement set. The
+ *          caller writes `merged` only when `conflicts` is empty.
+ */
+export declare function mergeSchema(base: Record<string, unknown>, ours: Record<string, unknown>, theirs: Record<string, unknown>): {
+    merged: Record<string, unknown>;
+    conflicts: SchemaConflict[];
+};
+//# sourceMappingURL=schema-merge.d.ts.map

package/dist/schema-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-merge.d.ts","sourceRoot":"","sources":["../src/schema-merge.ts"],"names":[],"mappings":"AAiBA,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC9B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,OAAO,CAAC;IACd,+EAA+E;IAC/E,IAAI,EAAE,OAAO,CAAC;IACd,4DAA4D;IAC5D,MAAM,EAAE,OAAO,CAAC;CAChB;AAkJD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,EAAE,cAAc,EAAE,CAAA;CAAE,CAUlE"}

package/dist/schema-merge.js

@@ -0,0 +1,176 @@
+/**
+ * Deterministic key/path-level draft-07 3-way schema merge (FEAT-006 T3 —
+ * TASK-036). Pure, no I/O: given the recorded merge BASE (the installed-from
+ * baseline schema body), OURS (the currently-installed, locally-edited body),
+ * and THEIRS (the catalog's current body), produce a merged body plus the set of
+ * irreconcilable per-path conflicts.
+ *
+ * Value equality throughout is canonical-JSON equality (`canonicalJson(a) ===
+ * canonicalJson(b)`) so structurally-equal-but-key-reordered values compare
+ * equal and the merge is order-insensitive + deterministic.
+ *
+ * The caller (`updateContext`) writes the merged body ONLY when the returned
+ * conflict set is empty; a non-empty conflict set means the merged body is left
+ * as OURS at the conflicting node(s) and the caller refrains from writing.
+ */
+import { canonicalJson } from "./content-hash.js";
+/**
+ * Module-private absent-key sentinel. A unique object (referential identity) so
+ * no representable JSON value can collide with "this key is absent on this
+ * side"; distinct from `null`/`undefined`, both of which are legitimate present
+ * values in a JSON document.
+ */
+const MISSING = Symbol("schema-merge:MISSING");
+function isMissing(v) {
+    return v === MISSING;
+}
+/** A plain JSON object: not MISSING, not null, not an array. */
+function isPlainObject(v) {
+    return !isMissing(v) && typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/** Present-and-an-array. */
+function isArrayValue(v) {
+    return !isMissing(v) && Array.isArray(v);
+}
+/** Canonical-JSON value equality (both sides must be present). */
+function valuesEqual(a, b) {
+    return canonicalJson(a) === canonicalJson(b);
+}
+/** `obj[key]` if the key is an own property, else MISSING. */
+function get(obj, key) {
+    return Object.hasOwn(obj, key) ? obj[key] : MISSING;
+}
+/**
+ * Whether the node at `path` (with the present sides all arrays) is a SET-ARRAY:
+ * an array whose order/duplication is not semantically meaningful, mergeable as
+ * a set. Applies when the LAST path segment is `required` or `enum`, OR when the
+ * path's last segment is `type` (a `type` whose value is an array is a JSON
+ * Schema type-union list — set-semantic).
+ */
+function isSetArrayPath(path) {
+    const last = path.includes(".") ? path.slice(path.lastIndexOf(".") + 1) : path;
+    return last === "required" || last === "enum" || last === "type";
+}
+/**
+ * 3-way set merge honoring adds AND removes, conflict-free:
+ *   result = (ours ∩ theirs) ∪ (ours \ base) ∪ (theirs \ base)
+ * Element identity is canonical-JSON. The result is returned as an array sorted
+ * by each element's canonical JSON for determinism. A MISSING base is treated as
+ * the empty set.
+ */
+function mergeSetArray(base, ours, theirs) {
+    const baseArr = isArrayValue(base) ? base : [];
+    const baseKeys = new Set(baseArr.map((e) => canonicalJson(e)));
+    const oursByKey = new Map();
+    for (const e of ours)
+        oursByKey.set(canonicalJson(e), e);
+    const theirsByKey = new Map();
+    for (const e of theirs)
+        theirsByKey.set(canonicalJson(e), e);
+    const resultByKey = new Map();
+    // (ours ∩ theirs): survivors present on both edited sides.
+    for (const [k, e] of oursByKey) {
+        if (theirsByKey.has(k))
+            resultByKey.set(k, e);
+    }
+    // (ours \ base): additions ours made.
+    for (const [k, e] of oursByKey) {
+        if (!baseKeys.has(k))
+            resultByKey.set(k, e);
+    }
+    // (theirs \ base): additions theirs made.
+    for (const [k, e] of theirsByKey) {
+        if (!baseKeys.has(k))
+            resultByKey.set(k, e);
+    }
+    const keys = [...resultByKey.keys()].sort();
+    return keys.map((k) => resultByKey.get(k));
+}
+/**
+ * Recursive 3-way merge of one node. Pushes any irreconcilable disagreement onto
+ * the shared `conflicts` array (tagged with `path`) and returns the merged value
+ * (which may be the MISSING sentinel to signal a key deletion to the parent
+ * object-merge).
+ */
+function merge3(base, ours, theirs, path, conflicts) {
+    const basePresent = !isMissing(base);
+    const oursPresent = !isMissing(ours);
+    const theirsPresent = !isMissing(theirs);
+    // --- Add / remove handling (at least one side MISSING) ---------------------
+    if (!(basePresent && oursPresent && theirsPresent)) {
+        const presentCount = (basePresent ? 1 : 0) + (oursPresent ? 1 : 0) + (theirsPresent ? 1 : 0);
+        if (presentCount === 0)
+            return MISSING; // (cannot occur from a present parent)
+        if (presentCount === 1) {
+            // Present on exactly one side → take that side's value.
+            return oursPresent ? ours : theirsPresent ? theirs : base;
+        }
+        // presentCount === 2: exactly one side is MISSING.
+        if (!basePresent) {
+            // Both ours + theirs added this key (base absent). Equal adds converge;
+            // differing adds conflict.
+            if (valuesEqual(ours, theirs))
+                return ours;
+            conflicts.push({ path, base: undefined, ours, theirs });
+            return ours;
+        }
+        // One of ours/theirs removed the key; the OTHER (non-base) side is present.
+        const otherPresent = oursPresent ? ours : theirs;
+        if (valuesEqual(base, otherPresent)) {
+            // The surviving side left the value unchanged vs base ⇒ honor the removal.
+            return MISSING;
+        }
+        // Delete-vs-modify: one side removed it while the other changed it → conflict.
+        conflicts.push({ path, base, ours, theirs });
+        return ours;
+    }
+    // --- All three present -----------------------------------------------------
+    // Plain-object node: recurse per key over the sorted union.
+    if (isPlainObject(base) && isPlainObject(ours) && isPlainObject(theirs)) {
+        const keys = [...new Set([...Object.keys(base), ...Object.keys(ours), ...Object.keys(theirs)])].sort();
+        const out = {};
+        for (const k of keys) {
+            const childPath = path ? `${path}.${k}` : k;
+            const merged = merge3(get(base, k), get(ours, k), get(theirs, k), childPath, conflicts);
+            if (!isMissing(merged))
+                out[k] = merged; // omit deleted keys
+        }
+        return out;
+    }
+    // SET-ARRAY node: required / enum / type-union list, all-three-arrays.
+    if (isSetArrayPath(path) && isArrayValue(base) && isArrayValue(ours) && isArrayValue(theirs)) {
+        return mergeSetArray(base, ours, theirs);
+    }
+    // --- Atomic 3-way (scalars; non-set arrays like allOf/anyOf/oneOf/
+    // x-lifecycle.transitions; object-vs-scalar kind mismatch) -----------------
+    if (valuesEqual(base, ours))
+        return theirs; // ours unchanged → take theirs
+    if (valuesEqual(base, theirs))
+        return ours; // theirs unchanged → take ours
+    if (valuesEqual(ours, theirs))
+        return ours; // both changed the same way → converged
+    conflicts.push({ path, base, ours, theirs });
+    return ours; // leave the conflicting node as ours
+}
+/**
+ * Deterministic 3-way merge of three draft-07 schema bodies.
+ *
+ * @param base   the recorded merge baseline body
+ * @param ours   the currently-installed (locally-edited) body
+ * @param theirs the catalog's current body
+ * @returns `{ merged, conflicts }` — `merged` is the merged object (conflicting
+ *          nodes left as OURS); `conflicts` is the per-path disagreement set. The
+ *          caller writes `merged` only when `conflicts` is empty.
+ */
+export function mergeSchema(base, ours, theirs) {
+    const conflicts = [];
+    const merged = merge3(base, ours, theirs, "", conflicts);
+    // The top-level call is over three objects, so merge3 returns an object
+    // (never MISSING — the three roots are present plain objects in every
+    // caller path; a defensive empty-object fallback keeps the return typed).
+    return {
+        merged: isPlainObject(merged) ? merged : {},
+        conflicts,
+    };
+}
+//# sourceMappingURL=schema-merge.js.map

package/dist/schema-merge.js.map

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

package/dist/write-schema-migration-tool.d.ts

@@ -19,6 +19,7 @@
  * (no canonical-id citations) per the operator-facing string convention.
  */
 import type { AgentToolResult } from "@earendil-works/pi-coding-agent";
+import { type DispatchContext } from "./dispatch-context.js";
 export interface WriteSchemaMigrationParams {
     operation: string;
     schemaName: string;
@@ -42,5 +43,5 @@ export interface WriteSchemaMigrationParams {
  * Returns an AgentToolResult naming the verb + persisted migrations.json
  * path so the caller's content array surfaces the on-disk effect.
  */
-export declare function writeSchemaMigrationExecute(cwd: string, params: WriteSchemaMigrationParams): Promise<AgentToolResult<undefined>>;
+export declare function writeSchemaMigrationExecute(cwd: string, params: WriteSchemaMigrationParams, ctx?: DispatchContext): Promise<AgentToolResult<undefined>>;
 //# sourceMappingURL=write-schema-migration-tool.d.ts.map

package/dist/write-schema-migration-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-schema-migration-tool.d.ts","sourceRoot":"","sources":["../src/write-schema-migration-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AASvE,MAAM,WAAW,0BAA0B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAChD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,0BAA0B,GAChC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CA+FrC"}
+{"version":3,"file":"write-schema-migration-tool.d.ts","sourceRoot":"","sources":["../src/write-schema-migration-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,uBAAuB,CAAC;AAQ7E,MAAM,WAAW,0BAA0B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAChD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,0BAA0B,EAClC,GAAG,CAAC,EAAE,eAAe,GACnB,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAiGrC"}

package/dist/write-schema-migration-tool.js

@@ -19,6 +19,7 @@
  * (no canonical-id citations) per the operator-facing string convention.
  */
 import { migrationsPath } from "./context-dir.js";
+import { writerToString } from "./dispatch-context.js";
 import { appendMigrationDecl, removeMigrationDecl, replaceMigrationDecl, } from "./migrations-store.js";
 /**
  * Execute body for the write-schema-migration tool. Dispatches the three
@@ -31,7 +32,7 @@ import { appendMigrationDecl, removeMigrationDecl, replaceMigrationDecl, } from
  * Returns an AgentToolResult naming the verb + persisted migrations.json
  * path so the caller's content array surfaces the on-disk effect.
  */
-export async function writeSchemaMigrationExecute(cwd, params) {
+export async function writeSchemaMigrationExecute(cwd, params, ctx) {
     const op = params.operation;
     if (op !== "create" && op !== "replace" && op !== "remove") {
         throw new Error(`write-schema-migration: unknown operation '${op}' — expected create | replace | remove`);
@@ -41,13 +42,16 @@ export async function writeSchemaMigrationExecute(cwd, params) {
     // has prompted the operator and — on confirm=true with a verifiable
     // identity — stamped event.input.writer with the verified terminal-
     // operator identity. The body trusts the writer field as-is.
-    if (!params.writer?.user) {
-        throw new Error("write-schema-migration: writer.user is required.");
+    if (!ctx?.writer) {
+        throw new Error("write-schema-migration: a DispatchContext writer is required.");
     }
+    // The recorded author marker derives from the contract DispatchContext: a
+    // human writer keeps its bare user (preserving the prior `params.writer.user`
+    // shape committed to migrations.json), other kinds fall back to the canonical
+    // `<kind>/<id>` string.
+    const migrationAuthor = ctx.writer.kind === "human" ? ctx.writer.user : writerToString(ctx.writer);
     if (op === "remove") {
-        removeMigrationDecl(cwd, params.schemaName, params.fromVersion, {
-            writer: { kind: "human", user: params.writer.user },
-        });
+        removeMigrationDecl(cwd, params.schemaName, params.fromVersion, ctx);
         return {
             details: undefined,
             content: [
@@ -91,15 +95,14 @@ export async function writeSchemaMigrationExecute(cwd, params) {
         toVersion: params.toVersion,
         kind,
         ...(kind === "declarative-transform" ? { transform: transformBody } : {}),
-        created_by: params.writer.user,
+        created_by: migrationAuthor,
         created_at: new Date().toISOString(),
     };
-    const dispatchCtx = { writer: { kind: "human", user: params.writer.user } };
     if (op === "create") {
-        appendMigrationDecl(cwd, decl, dispatchCtx);
+        appendMigrationDecl(cwd, decl, ctx);
     }
     else {
-        replaceMigrationDecl(cwd, decl, dispatchCtx);
+        replaceMigrationDecl(cwd, decl, ctx);
     }
     const verb = op === "create" ? "created" : "replaced";
     return {

package/dist/write-schema-migration-tool.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@davidorex/pi-context",
-	"version": "0.29.0",
+	"version": "0.31.0",
 	"publishConfig": {
 		"access": "public"
 	},
@@ -20,6 +20,7 @@
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
 	"exports": {
+		"./package.json": "./package.json",
 		".": {
 			"types": "./dist/index.d.ts",
 			"default": "./dist/index.js"

package/samples/conception.json

@@ -327,6 +327,20 @@
       "source_kinds": ["tasks"],
       "target_kinds": ["decisions"]
     },
+    {
+      "canonical_id": "item_governed_by_convention",
+      "display_name": "governed by convention",
+      "category": "data_flow",
+      "source_kinds": ["decisions", "features", "tasks"],
+      "target_kinds": ["conventions"]
+    },
+    {
+      "canonical_id": "item_acknowledges_missing_convention",
+      "display_name": "acknowledges missing convention",
+      "category": "data_flow",
+      "source_kinds": ["decisions", "features", "tasks"],
+      "target_kinds": ["framework-gaps"]
+    },
     {
       "canonical_id": "item_derived_from_item",
       "display_name": "derived from",
@@ -479,6 +493,42 @@
       "forbid_target_bucket": "unknown",
       "severity": "warning",
       "message": "Task '{id}' is governed by a superseded or cancelled decision"
+    },
+    {
+      "id": "decision-articulates-convention",
+      "class": "requires-edge",
+      "block": "decisions",
+      "relation_types": [
+        "item_governed_by_convention",
+        "item_acknowledges_missing_convention"
+      ],
+      "direction": "as_parent",
+      "severity": "warning",
+      "message": "Decision '{id}' articulates no governing convention — add an item_governed_by_convention edge to a convention, or an item_acknowledges_missing_convention edge to a missing-convention gap"
+    },
+    {
+      "id": "feature-articulates-convention",
+      "class": "requires-edge",
+      "block": "features",
+      "relation_types": [
+        "item_governed_by_convention",
+        "item_acknowledges_missing_convention"
+      ],
+      "direction": "as_parent",
+      "severity": "warning",
+      "message": "Feature '{id}' articulates no governing convention — add an item_governed_by_convention edge to a convention, or an item_acknowledges_missing_convention edge to a missing-convention gap"
+    },
+    {
+      "id": "task-articulates-convention",
+      "class": "requires-edge",
+      "block": "tasks",
+      "relation_types": [
+        "item_governed_by_convention",
+        "item_acknowledges_missing_convention"
+      ],
+      "direction": "as_parent",
+      "severity": "warning",
+      "message": "Task '{id}' articulates no governing convention — add an item_governed_by_convention edge to a convention, or an item_acknowledges_missing_convention edge to a missing-convention gap"
     }
   ],
   "tool_operations": [],

package/samples/schemas/framework-gaps.schema.json

@@ -3,7 +3,7 @@
   "$id": "pi-context://schemas/framework-gaps",
   "version": "1.1.1",
   "title": "Framework Gaps",
-  "description": "Capability gaps in the pi-project-workflows framework — pieces that must exist natively for the target artifact-ownership model to be expressible as configuration rather than hand-enactment. Each gap carries evidence (file + line references), impact, canonical engineering vocabulary for the missing capability, proposed resolution, and lifecycle state. Framework gaps are distinct from feature-level defects: they describe what the framework cannot yet express at all, not bugs in expressible functionality.",
+  "description": "Capability gaps in the framework — pieces that must exist natively for the target artifact-ownership model to be expressible as configuration rather than hand-enactment. Each gap carries evidence (file + line references), impact, canonical engineering vocabulary for the missing capability, proposed resolution, and lifecycle state. Framework gaps are distinct from feature-level defects: they describe what the framework cannot yet express at all, not bugs in expressible functionality.",
   "type": "object",
   "required": [
     "gaps"

package/samples/schemas/issues.schema.json

@@ -43,7 +43,7 @@
           },
           "location": {
             "type": "string",
-            "description": "File path + line number, e.g. packages/pi-workflows/src/dag.ts:219"
+            "description": "File path + line number, e.g. src/module/file.ts:NNN"
           },
           "status": {
             "type": "string",
@@ -74,7 +74,7 @@
           },
           "package": {
             "type": "string",
-            "description": "Which monorepo package this issue touches (e.g. pi-workflows, pi-project, pi-behavior-monitors)"
+            "description": "Which package/module this issue touches (e.g. package-a, package-b)"
           },
           "source": {
             "type": "string",