pm-context 2026.7.25 → 2026.7.27

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 2026.7.27 - 2026-07-27
+
+### Added
+
+- Adopt sdk/query context engine and drop spawnSync shell-outs ([pm-context-lk82](https://github.com/unbraind/pm-context/blob/main/.agents/pm/features/pm-context-lk82.toon))
+
+### Removed
+
+- Adopt pm-cli 2026.7.26 typed authoring contracts and remove the any-cast defineExtension shim ([pm-context-q67i](https://github.com/unbraind/pm-context/blob/main/.agents/pm/tasks/pm-context-q67i.toon))
+
+### Other
+
+- Exclude generated dist output from DeepScan static analysis ([pm-context-01lr](https://github.com/unbraind/pm-context/blob/main/.agents/pm/chores/pm-context-01lr.toon))
+
+## 2026.7.26 - 2026-07-26
+
+### Other
+
+- Enable governance duplicate-detection advisory mode and adopt pm-cli 2026.7.25 ([pm-context-x5qt](https://github.com/unbraind/pm-context/blob/main/.agents/pm/chores/pm-context-x5qt.toon))
+
 ## 2026.7.23 - 2026-07-23
 
 ### Fixed

package/README.md

@@ -27,9 +27,11 @@ pm context-pack --id pm-1234 --include-deps --section focus --section blockers
 pm context-pack --id pm-1234 --max-items 10
 ```
 
-The command is read-only. It shells out to the active `pm` binary for
-workspace data, so generated packs reflect the installed CLI and package
-runtime rather than a stale parser.
+The command reads workspace data in-process through the typed pm SDK, so packs
+use the installed CLI's canonical query and relevance engines rather than a
+second parser. Normal pack and handoff runs record one best-effort context-usage
+serving event for the emitted items when an author is available; `--explain`
+does not write to the usage ledger.
 
 ## Output
 
@@ -73,8 +75,10 @@ section is rendered in markdown/agent output when present.
 ### Max items
 
 `--max-items <n>` caps the total number of items (focus + neighbors) in the
-pack. Focus items take priority; neighbors are trimmed to fit the remaining
-budget.
+pack. The SDK packer first selects candidates under a token budget with
+projection degradation, preserving required focus items and relevance-ranked
+neighbors; `--max-items` is then enforced as an additional hard item-count
+ceiling.
 
 ## Command
 
@@ -106,16 +110,63 @@ Options:
 - `--compress` minimize output tokens (compact JSON, no blank lines)
 - `--include-deps` include per-item dependency info in the context pack
 - `--max-items <n>` maximum total items (focus + neighbors) in the pack
+- `--explain` explain the exact focus and neighborhood items that the normal
+  selection and packing path would emit, without recording a serving event;
+  reported ranks and scores are relative to that emitted pack, not the workspace
 - `--section <section>` include only specific sections (repeatable):
   `summary`, `focus`, `neighborhood`, `neighbors`, `links`, `deps`,
   `blockers`, `next-actions` (alias: `actions`), `recent` (alias: `activity`),
   `refresh`
 
+`pm context-usage`
+
+Reports which items `pm context` and `pm next` served, and which of those were
+actually touched afterwards — the feedback half of "project management = context
+management".
+
+pm maintains an append-only ledger at `<pm_root>/runtime/context-usage.jsonl`
+(a `serve` row per ranking, a `touch` row per mutation) and folds it into the
+`usage_affinity` signal of its built-in relevance model. Nothing surfaces the
+ledger itself, so an agent cannot ask *what was I shown, and did I use it?*
+This command answers that:
+
+- **conversion** — share of served items followed by a same-author touch
+- **waste** — served but never touched afterwards: context you paid tokens for and did not use
+- **misses** — touched but never served: work the ranking failed to surface
+
+An item counts as *served* only when pm marked it `included` — it actually made
+the pack. The per-item `ranked` column counts every appearance, so
+`ranked - serves` is how often the item lost to the token budget rather than to
+the ranking: tune the budget, not the query. An item that was only ever ranked
+and cut is never reported as waste, because the agent never saw it.
+
+```bash
+pm context-usage                          # markdown brief
+pm context-usage --json                   # raw report
+pm context-usage --surface next --since 7d
+pm context-usage --author agent-a --limit 50
+```
+
+Options:
+
+- `--author <author>` restrict to one recording author
+- `--surface <context|next>` restrict serve events to one surface
+- `--since <when>` drop events at or before an ISO timestamp or a day offset (`7d`, `-7d`, `7`)
+- `--limit <n>` maximum per-item rows (default `20`)
+- `--format <markdown|json>` output format (default `markdown`); pm's global `--json` also selects JSON
+
+The command is strictly read-only. The ledger is pm's file, with pm's schema and
+pm's pruning, and it deliberately reports only what the ledger states directly —
+it does **not** compute a competing affinity score, because pm owns the decay
+model and a second implementation could silently disagree with the ranking it
+purports to explain.
+
 ## Philosophy
 
 Project management is context management. `pm-context` makes that concrete by
 turning pm's source-of-truth items into portable context that can be reviewed,
-sent to another agent, or attached to a pull request.
+sent to another agent, or attached to a pull request — and, with
+`pm context-usage`, by measuring whether that context was worth sending.
 
 ## Multi-agent merge safety
 

package/dist/context-usage.d.ts

@@ -0,0 +1,166 @@
+import type { ContextUsageEvent } from "@unbrained/pm-cli/sdk";
+/** Ledger location relative to the tracker root, owned and pruned by pm itself. */
+export declare const LEDGER_RELATIVE_PATH: string;
+/** Default number of per-item rows rendered before the report truncates. */
+export declare const DEFAULT_REPORT_LIMIT = 20;
+/** Per-item rollup of every retained ledger row referencing one item. */
+export interface ContextUsageItemReport {
+    /** Item identifier as recorded by the ledger. */
+    id: string;
+    /**
+     * Serve rows that actually put this item in the pack (`included: true`).
+     *
+     * Only these count as "shown", so only these can be wasted. An item pm ranked
+     * but cut from the pack was never in front of the agent.
+     */
+    serves: number;
+    /**
+     * Serve rows that ranked this item at all, whether or not it made the pack.
+     *
+     * `ranked - serves` is the number of times the item lost to the token budget,
+     * which is the signal for tuning that budget rather than the ranking.
+     */
+    ranked: number;
+    /** Serve rows for this item followed by a same-author touch. */
+    conversions: number;
+    /** Total touch rows for this item, whether or not a serve preceded them. */
+    touches: number;
+    /** Best (lowest) rank the item was ever served at, or null when never served. */
+    best_rank: number | null;
+    /** Timestamp of the most recent serve, or null when never served. */
+    last_served_at: string | null;
+    /** Timestamp of the most recent touch, or null when never touched. */
+    last_touched_at: string | null;
+    /** Distinct touch intents observed, sorted, e.g. `["close", "create"]`. */
+    intents: string[];
+}
+/** Decay-aware served-then-touched affinity for one author, sourced from the
+ * SDK context-usage store (`readContextUsageAffinity`) rather than recomputed here. */
+export interface ContextUsageAffinitySummary {
+    /** Normalized affinity by item id. */
+    affinity: Record<string, number>;
+    /** Number of eligible served-then-touched judgments. */
+    positive_judgments: number;
+    /** Number of retained serving events inspected. */
+    serving_events: number;
+}
+/** Complete read-only view of the ledger for one filter selection. */
+export interface ContextUsageReport {
+    /** Whether the ledger file exists; false means pm has not served or mutated yet. */
+    ledger_present: boolean;
+    /** Rows that parsed into a recognized event, after filtering. */
+    event_count: number;
+    /** Rows that could not be parsed; pm truncates on prune, so a tail row can be partial. */
+    malformed_line_count: number;
+    /** Serve events retained after filtering. */
+    serve_event_count: number;
+    /** Touch events retained after filtering. */
+    touch_event_count: number;
+    /** Distinct authors present, sorted. */
+    authors: string[];
+    /** Distinct surfaces present, sorted; `context` and/or `next`. */
+    surfaces: string[];
+    /** Earliest retained event timestamp, or null when no events matched. */
+    from: string | null;
+    /** Latest retained event timestamp, or null when no events matched. */
+    to: string | null;
+    /** Per-item rollups, ordered by serves desc, then conversions desc, then id. */
+    items: ContextUsageItemReport[];
+    /** Items served but never touched afterwards — context paid for and unused. */
+    waste: string[];
+    /** Items touched but never served — work the ranking failed to surface. */
+    misses: string[];
+    /**
+     * Fraction of included serve judgments followed by a same-author touch, or
+     * null when no judgments exist. This is serve-then-touch conversion, not pm's
+     * `usage_affinity`, which additionally applies recency decay.
+     */
+    conversion_rate: number | null;
+    /**
+     * Optional decay-aware affinity for the selected author, supplied by the SDK
+     * context-usage store when `--author` is set. Absent for unfiltered reports
+     * and for the pure {@link reportContextUsage} path.
+     */
+    affinity?: ContextUsageAffinitySummary;
+}
+/** Filters narrowing which ledger rows a report is derived from. */
+export interface ContextUsageReportOptions {
+    /** Restrict to one recording author. */
+    author?: string;
+    /** Restrict to one serving surface; touch rows carry no surface and are kept. */
+    surface?: string;
+    /** Drop events at or before this ISO timestamp. */
+    since?: string;
+    /** Maximum per-item rows retained in {@link ContextUsageReport.items}. */
+    limit?: number;
+}
+/**
+ * Resolve a `--since` value into an ISO timestamp.
+ *
+ * Accepts a full ISO timestamp, or a relative day offset written as `7d`,
+ * `-7d`, or `7`. pm's own `--from` silently yields an empty window for an
+ * unsigned offset (upstream pm-cli#651); both signs are accepted here because
+ * "7 days ago" and "-7 days" are the same request from an agent.
+ *
+ * @param value - Raw flag text.
+ * @param now - Clock used to resolve relative offsets, for deterministic tests.
+ * @returns The resolved ISO timestamp, or null when the value is unparseable.
+ */
+export declare function resolveSince(value: string, now?: Date): string | null;
+/**
+ * Decode one ledger line into a recognized event.
+ *
+ * Validates the discriminant and every field the report reads, so a row written
+ * by a future pm version — or a partial tail row left by a prune — is reported
+ * as malformed rather than silently contributing zeroes to the metrics.
+ *
+ * @param line - Raw JSONL line, assumed already trimmed of surrounding space.
+ * @returns The decoded event, or null when the line is absent or malformed.
+ */
+export declare function parseLedgerLine(line: string): ContextUsageEvent | null;
+/**
+ * Read and decode every retained ledger row for a tracker.
+ *
+ * @param pmRoot - Tracker root containing the `runtime` directory.
+ * @returns Decoded events in file order plus the count of unparseable lines,
+ *   and `present: false` when pm has not written a ledger yet.
+ */
+export declare function readLedger(pmRoot: string): {
+    present: boolean;
+    events: ContextUsageEvent[];
+    malformed: number;
+};
+/**
+ * Roll decoded ledger events up into a usage report.
+ *
+ * A serve judgment converts when the same author touches the served item at a
+ * later timestamp. Only rows pm marked `included` are judged: a candidate that
+ * was ranked but cut from the pack was never shown, so failing to touch it is
+ * not waste. Touch matching uses each item's latest touch per author, which is
+ * sufficient because conversion asks only whether *any* later touch exists.
+ *
+ * @param events - Decoded events, in any order; ordering is derived internally.
+ * @param options - Author, surface, since, and limit filters.
+ * @returns The rolled-up report over the filtered event set.
+ */
+export declare function buildUsageReport(events: readonly ContextUsageEvent[], options?: ContextUsageReportOptions): Omit<ContextUsageReport, "ledger_present" | "malformed_line_count">;
+/**
+ * Read a tracker's ledger and roll it up in one call.
+ *
+ * @param pmRoot - Tracker root containing the `runtime` directory.
+ * @param options - Author, surface, since, and limit filters.
+ * @returns The complete report, with `ledger_present: false` and zeroed
+ *   counters when pm has not written a ledger yet.
+ */
+export declare function reportContextUsage(pmRoot: string, options?: ContextUsageReportOptions): ContextUsageReport;
+/**
+ * Render a report as an agent-readable Markdown brief.
+ *
+ * Leads with conversion rate and the two failure lists, because those are the
+ * only parts an agent acts on; the per-item table is supporting detail.
+ *
+ * @param report - Report produced by {@link reportContextUsage}.
+ * @returns Markdown text ending in a newline.
+ */
+export declare function renderUsageReport(report: ContextUsageReport): string;
+//# sourceMappingURL=context-usage.d.ts.map

package/dist/context-usage.d.ts.map

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

package/dist/context-usage.js

@@ -0,0 +1,331 @@
+/**
+ * @module context-usage
+ *
+ * Reports on pm's own context-usage ledger: which items `pm context` and
+ * `pm next` served, and which of those the agent subsequently touched.
+ *
+ * pm 2026.7.25 maintains an append-only ledger at
+ * `<pm_root>/runtime/context-usage.jsonl`, writing a `serve` row whenever
+ * `pm context` / `pm next` rank candidates and a `touch` row whenever a command
+ * mutates an item. The CLI folds that ledger into the `usage_affinity` signal of
+ * its built-in relevance model, but nothing surfaces the ledger itself — an
+ * agent cannot ask "what was I shown, and did I actually use it?".
+ *
+ * This module answers exactly that, and deliberately stops there. It derives
+ * only facts the ledger states directly — serve counts, touch counts, and
+ * serve-then-touch conversion — and does **not** compute a competing affinity
+ * score. pm owns the decay model; a second implementation of it here could
+ * silently disagree with the ranking it purports to explain.
+ *
+ * Two failure modes fall out of the conversion analysis and are the practical
+ * payload of the report:
+ *
+ * - **waste** — items pm served that were never touched afterwards. Every one
+ *   is context an agent paid tokens for and did not use.
+ * - **misses** — items an agent touched that pm never served. Every one is work
+ *   the ranking failed to surface.
+ *
+ * The whole surface is read-only. The ledger is pm's file, with pm's schema and
+ * pm's pruning; writing to it from here would corrupt the very signal being
+ * reported on. {@link ContextUsageEvent} is imported as a type so the parser is
+ * checked against the SDK's real contract while adding no runtime dependency —
+ * installed extensions cannot resolve `@unbrained/pm-cli` at runtime
+ * (upstream pm-cli#717).
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** Ledger location relative to the tracker root, owned and pruned by pm itself. */
+export const LEDGER_RELATIVE_PATH = join("runtime", "context-usage.jsonl");
+/**
+ * Serving surfaces recognized by the parser.
+ *
+ * Typed against the SDK union so it cannot drift into an invalid value. A row
+ * naming a surface pm adds later decodes as malformed, which the report states
+ * explicitly — preferable to admitting it and skewing conversion silently.
+ */
+const SERVE_SURFACES = ["context", "next"];
+/**
+ * Whether a timestamp is in canonical `Date.prototype.toISOString` form.
+ *
+ * Every window filter, report bound, "latest" wins, and conversion check in this
+ * module compares `at` values as strings. That is only sound for a fixed-width
+ * representation: `"2026-07-01T00:00:00.500Z"` sorts *before*
+ * `"2026-07-01T00:00:00Z"` lexically, because `.` precedes `Z`, even though it
+ * is the later instant. Requiring the canonical form — which is what pm writes —
+ * makes string order equal chronological order, so any other spelling is
+ * reported as malformed instead of silently skewing the metrics.
+ */
+function isCanonicalTimestamp(value) {
+    const parsed = Date.parse(value);
+    return !Number.isNaN(parsed) && new Date(parsed).toISOString() === value;
+}
+/** Default number of per-item rows rendered before the report truncates. */
+export const DEFAULT_REPORT_LIMIT = 20;
+/**
+ * Resolve a `--since` value into an ISO timestamp.
+ *
+ * Accepts a full ISO timestamp, or a relative day offset written as `7d`,
+ * `-7d`, or `7`. pm's own `--from` silently yields an empty window for an
+ * unsigned offset (upstream pm-cli#651); both signs are accepted here because
+ * "7 days ago" and "-7 days" are the same request from an agent.
+ *
+ * @param value - Raw flag text.
+ * @param now - Clock used to resolve relative offsets, for deterministic tests.
+ * @returns The resolved ISO timestamp, or null when the value is unparseable.
+ */
+export function resolveSince(value, now = new Date()) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    const relative = /^-?(\d+(?:\.\d+)?)d?$/i.exec(trimmed);
+    if (relative)
+        return new Date(now.getTime() - Number(relative[1]) * 86_400_000).toISOString();
+    const parsed = Date.parse(trimmed);
+    return Number.isNaN(parsed) ? null : new Date(parsed).toISOString();
+}
+/**
+ * Decode one ledger line into a recognized event.
+ *
+ * Validates the discriminant and every field the report reads, so a row written
+ * by a future pm version — or a partial tail row left by a prune — is reported
+ * as malformed rather than silently contributing zeroes to the metrics.
+ *
+ * @param line - Raw JSONL line, assumed already trimmed of surrounding space.
+ * @returns The decoded event, or null when the line is absent or malformed.
+ */
+export function parseLedgerLine(line) {
+    if (!line)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return null;
+    const row = parsed;
+    if (typeof row.at !== "string" || !isCanonicalTimestamp(row.at) || typeof row.author !== "string")
+        return null;
+    if (row.kind === "touch") {
+        if (typeof row.item_id !== "string" || typeof row.intent !== "string")
+            return null;
+        return { kind: "touch", at: row.at, author: row.author, item_id: row.item_id, intent: row.intent };
+    }
+    if (row.kind !== "serve")
+        return null;
+    if (typeof row.profile !== "string" || !Array.isArray(row.rows))
+        return null;
+    const surface = SERVE_SURFACES.find((candidate) => candidate === row.surface);
+    if (!surface)
+        return null;
+    const rows = [];
+    for (const candidate of row.rows) {
+        if (typeof candidate !== "object" || candidate === null)
+            return null;
+        const entry = candidate;
+        if (typeof entry.id !== "string" || typeof entry.rank !== "number" || typeof entry.included !== "boolean")
+            return null;
+        rows.push({ id: entry.id, rank: entry.rank, included: entry.included });
+    }
+    return { kind: "serve", at: row.at, author: row.author, surface, profile: row.profile, rows };
+}
+/**
+ * Read and decode every retained ledger row for a tracker.
+ *
+ * @param pmRoot - Tracker root containing the `runtime` directory.
+ * @returns Decoded events in file order plus the count of unparseable lines,
+ *   and `present: false` when pm has not written a ledger yet.
+ */
+export function readLedger(pmRoot) {
+    const path = join(pmRoot, LEDGER_RELATIVE_PATH);
+    if (!existsSync(path))
+        return { present: false, events: [], malformed: 0 };
+    const events = [];
+    let malformed = 0;
+    for (const raw of readFileSync(path, "utf-8").split("\n")) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        const event = parseLedgerLine(line);
+        if (event)
+            events.push(event);
+        else
+            malformed += 1;
+    }
+    return { present: true, events, malformed };
+}
+/**
+ * Roll decoded ledger events up into a usage report.
+ *
+ * A serve judgment converts when the same author touches the served item at a
+ * later timestamp. Only rows pm marked `included` are judged: a candidate that
+ * was ranked but cut from the pack was never shown, so failing to touch it is
+ * not waste. Touch matching uses each item's latest touch per author, which is
+ * sufficient because conversion asks only whether *any* later touch exists.
+ *
+ * @param events - Decoded events, in any order; ordering is derived internally.
+ * @param options - Author, surface, since, and limit filters.
+ * @returns The rolled-up report over the filtered event set.
+ */
+export function buildUsageReport(events, options = {}) {
+    const { author, surface, since } = options;
+    const limit = options.limit ?? DEFAULT_REPORT_LIMIT;
+    const selected = events.filter((event) => {
+        if (author && event.author !== author)
+            return false;
+        if (since && event.at <= since)
+            return false;
+        if (surface && event.kind === "serve" && event.surface !== surface)
+            return false;
+        return true;
+    });
+    const items = new Map();
+    const touchTimesByAuthor = new Map();
+    const judgments = [];
+    const authors = new Set();
+    const surfaces = new Set();
+    let serveEvents = 0;
+    let touchEvents = 0;
+    let from = null;
+    let to = null;
+    const entryFor = (id) => {
+        const existing = items.get(id);
+        if (existing)
+            return existing;
+        const created = {
+            id,
+            serves: 0,
+            conversions: 0,
+            ranked: 0,
+            touches: 0,
+            best_rank: null,
+            last_served_at: null,
+            last_touched_at: null,
+            intents: [],
+        };
+        items.set(id, created);
+        return created;
+    };
+    for (const event of selected) {
+        authors.add(event.author);
+        if (from === null || event.at < from)
+            from = event.at;
+        if (to === null || event.at > to)
+            to = event.at;
+        if (event.kind === "touch") {
+            touchEvents += 1;
+            const entry = entryFor(event.item_id);
+            entry.touches += 1;
+            if (entry.last_touched_at === null || event.at > entry.last_touched_at)
+                entry.last_touched_at = event.at;
+            if (!entry.intents.includes(event.intent))
+                entry.intents.push(event.intent);
+            const key = `${event.author}\u0000${event.item_id}`;
+            const times = touchTimesByAuthor.get(key);
+            if (times)
+                times.push(event.at);
+            else
+                touchTimesByAuthor.set(key, [event.at]);
+            continue;
+        }
+        serveEvents += 1;
+        surfaces.add(event.surface);
+        for (const row of event.rows) {
+            const entry = entryFor(row.id);
+            entry.ranked += 1;
+            if (entry.best_rank === null || row.rank < entry.best_rank)
+                entry.best_rank = row.rank;
+            // Only an included row was actually shown, so only it can be served, wasted, or converted.
+            if (!row.included)
+                continue;
+            entry.serves += 1;
+            if (entry.last_served_at === null || event.at > entry.last_served_at)
+                entry.last_served_at = event.at;
+            judgments.push({ id: row.id, rank: row.rank, at: event.at, author: event.author });
+        }
+    }
+    let converted = 0;
+    for (const judgment of judgments) {
+        const times = touchTimesByAuthor.get(`${judgment.author}\u0000${judgment.id}`);
+        if (!times?.some((at) => at > judgment.at))
+            continue;
+        converted += 1;
+        entryFor(judgment.id).conversions += 1;
+    }
+    const ranked = [...items.values()].sort((a, b) => b.serves - a.serves || b.conversions - a.conversions || a.id.localeCompare(b.id));
+    for (const entry of ranked)
+        entry.intents.sort();
+    return {
+        event_count: selected.length,
+        serve_event_count: serveEvents,
+        touch_event_count: touchEvents,
+        authors: [...authors].sort(),
+        surfaces: [...surfaces].sort(),
+        from,
+        to,
+        items: ranked.slice(0, Math.max(0, limit)),
+        waste: ranked.filter((entry) => entry.serves > 0 && entry.conversions === 0).map((entry) => entry.id),
+        misses: ranked.filter((entry) => entry.serves === 0 && entry.touches > 0).map((entry) => entry.id),
+        conversion_rate: judgments.length === 0 ? null : converted / judgments.length,
+    };
+}
+/**
+ * Read a tracker's ledger and roll it up in one call.
+ *
+ * @param pmRoot - Tracker root containing the `runtime` directory.
+ * @param options - Author, surface, since, and limit filters.
+ * @returns The complete report, with `ledger_present: false` and zeroed
+ *   counters when pm has not written a ledger yet.
+ */
+export function reportContextUsage(pmRoot, options = {}) {
+    const { present, events, malformed } = readLedger(pmRoot);
+    return { ledger_present: present, malformed_line_count: malformed, ...buildUsageReport(events, options) };
+}
+/**
+ * Render a report as an agent-readable Markdown brief.
+ *
+ * Leads with conversion rate and the two failure lists, because those are the
+ * only parts an agent acts on; the per-item table is supporting detail.
+ *
+ * @param report - Report produced by {@link reportContextUsage}.
+ * @returns Markdown text ending in a newline.
+ */
+export function renderUsageReport(report) {
+    const lines = ["# Context usage", ""];
+    if (!report.ledger_present) {
+        lines.push("No ledger at `runtime/context-usage.jsonl`.", "", "pm writes it on the first `pm context`, `pm next`, or item mutation.", "");
+        return lines.join("\n");
+    }
+    const rate = report.conversion_rate === null ? "n/a" : `${(report.conversion_rate * 100).toFixed(1)}%`;
+    lines.push(`- serve-then-touch conversion: **${rate}**`, `- events: ${report.event_count} (${report.serve_event_count} serve, ${report.touch_event_count} touch)`, `- window: ${report.from ?? "n/a"} .. ${report.to ?? "n/a"}`, `- authors: ${report.authors.length > 0 ? report.authors.join(", ") : "n/a"}`, `- surfaces: ${report.surfaces.length > 0 ? report.surfaces.join(", ") : "n/a"}`);
+    if (report.malformed_line_count > 0)
+        lines.push(`- malformed lines skipped: ${report.malformed_line_count}`);
+    lines.push("");
+    lines.push("## Waste (served, never touched)", "", report.waste.length > 0 ? report.waste.map((id) => `- ${id}`).join("\n") : "_none_", "", "## Misses (touched, never served)", "", report.misses.length > 0 ? report.misses.map((id) => `- ${id}`).join("\n") : "_none_", "");
+    if (report.items.length > 0) {
+        lines.push("## Items", "", "| id | serves | ranked | conversions | touches | best rank | last served | last touched | intents |", "| --- | ---: | ---: | ---: | ---: | ---: | --- | --- | --- |");
+        for (const entry of report.items) {
+            lines.push(`| ${entry.id} | ${entry.serves} | ${entry.ranked} | ${entry.conversions} | ${entry.touches} | ` +
+                `${entry.best_rank ?? "-"} | ${entry.last_served_at ?? "-"} | ${entry.last_touched_at ?? "-"} | ` +
+                `${entry.intents.join(", ") || "-"} |`);
+        }
+        lines.push("");
+    }
+    if (report.affinity) {
+        const entries = Object.entries(report.affinity.affinity)
+            .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
+        lines.push("## Author affinity (SDK decayed)", "", `- positive judgments: ${report.affinity.positive_judgments}`, `- serving events: ${report.affinity.serving_events}`, "");
+        if (entries.length === 0) {
+            lines.push("_no decayed affinity yet._", "");
+        }
+        else {
+            for (const [id, value] of entries)
+                lines.push(`- ${id}: ${value.toFixed(3)}`);
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=context-usage.js.map

package/dist/context-usage.js.map

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