pm-context 2026.10.10 → 2026.10.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/README.md +167 -36
- package/dist/context-receipts.d.ts +115 -0
- package/dist/context-receipts.d.ts.map +1 -0
- package/dist/context-receipts.js +317 -0
- package/dist/context-receipts.js.map +1 -0
- package/dist/index.d.ts +2 -10
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +70 -33
- package/dist/index.js.map +1 -1
- package/manifest.json +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,317 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Receipt protocol for the final output of pm-context's serving commands.
|
|
3
|
+
* The package owns only runtime/context-receipts, never the SDK usage ledger.
|
|
4
|
+
*/
|
|
5
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
6
|
+
import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
|
|
7
|
+
import { basename, isAbsolute, join, posix } from "node:path";
|
|
8
|
+
/** Physical retention ceilings: at most 200 receipts of 256 KiB each. */
|
|
9
|
+
export const RECEIPT_LIMITS = { count: 200, bytes: 262_144 };
|
|
10
|
+
/** Isolated, ignored tracker runtime directory used by this protocol. */
|
|
11
|
+
export const RECEIPTS_RELATIVE_PATH = join("runtime", "context-receipts");
|
|
12
|
+
/** Normalize only repository-relative file evidence, rejecting URLs and traversal. */
|
|
13
|
+
export function normalizeReceiptFile(value) {
|
|
14
|
+
const portable = value.replaceAll("\\", "/");
|
|
15
|
+
const normalized = posix.normalize(portable);
|
|
16
|
+
if (!portable || isAbsolute(portable) || /^[a-z][a-z\d+.-]*:/i.test(portable) || normalized === ".." || normalized.startsWith("../") || normalized === ".") {
|
|
17
|
+
throw new Error("File evidence must name a repository-relative file");
|
|
18
|
+
}
|
|
19
|
+
return normalized;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Build facts from exactly the rendered content, annotate text or attach a JSON
|
|
23
|
+
* manifest, and persist its receipt. Fact hashes exclude clocks and receipt ids.
|
|
24
|
+
* Write failures propagate so callers disclose that measurement is unavailable.
|
|
25
|
+
*/
|
|
26
|
+
export function serveContextReceipt(pmRoot, output, format, associations, identity, outputPath) {
|
|
27
|
+
const receipt = {
|
|
28
|
+
protocol: "pm-context-usage/v1", receipt_id: randomUUID(), session: "", author: identity.author,
|
|
29
|
+
served_at: new Date().toISOString(), command: identity.command, sections: [], facts: [], protocol_tokens: 0, used: {},
|
|
30
|
+
};
|
|
31
|
+
receipt.session = identity.session ?? receipt.receipt_id;
|
|
32
|
+
const knownFiles = [];
|
|
33
|
+
for (const file of associations.files) {
|
|
34
|
+
try {
|
|
35
|
+
knownFiles.push({ ...file, normalized: normalizeReceiptFile(file.value) });
|
|
36
|
+
}
|
|
37
|
+
catch { /* External links are not editable files. */ }
|
|
38
|
+
}
|
|
39
|
+
// Compile each literal id once for this receipt; patterns have no mutable flags.
|
|
40
|
+
const itemMatchers = associations.item_ids.map((id) => ({
|
|
41
|
+
id, pattern: new RegExp(`(?<![\\w-])${id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?![\\w-])`),
|
|
42
|
+
}));
|
|
43
|
+
/** Intern a stable section name for both JSON and text projections. */
|
|
44
|
+
const sectionFor = (name) => {
|
|
45
|
+
const existing = receipt.sections.find((section) => section.name === name);
|
|
46
|
+
if (existing)
|
|
47
|
+
return existing;
|
|
48
|
+
const section = { id: `s-${createHash("sha256").update(name).digest("hex").slice(0, 24)}`, name };
|
|
49
|
+
receipt.sections.push(section);
|
|
50
|
+
return section;
|
|
51
|
+
};
|
|
52
|
+
/** Associate one visible fragment with content ids, items and editable files. */
|
|
53
|
+
const factFor = (section, text, inheritedItems = []) => {
|
|
54
|
+
const itemIds = itemMatchers.filter(({ pattern }) => pattern.test(text)).map(({ id }) => id);
|
|
55
|
+
const item_ids = [...new Set([...inheritedItems, ...itemIds])].sort();
|
|
56
|
+
const files = [...new Set(knownFiles.filter((file) => item_ids.includes(file.itemId) && (format === "json" ? text.includes(JSON.stringify(file.value)) : text === `- ${file.itemId} file: ${file.value}`)).map((file) => file.normalized))].sort();
|
|
57
|
+
const id = `f-${createHash("sha256").update(JSON.stringify([section.id, item_ids, text])).digest("hex").slice(0, 24)}`;
|
|
58
|
+
const existing = receipt.facts.find((fact) => fact.id === id);
|
|
59
|
+
if (existing) {
|
|
60
|
+
existing.estimated_tokens += Math.ceil(text.length / 4);
|
|
61
|
+
return existing;
|
|
62
|
+
}
|
|
63
|
+
const fact = { id, section_id: section.id, item_ids, files, estimated_tokens: Math.ceil(text.length / 4) };
|
|
64
|
+
receipt.facts.push(fact);
|
|
65
|
+
return fact;
|
|
66
|
+
};
|
|
67
|
+
let rendered;
|
|
68
|
+
if (format === "json") {
|
|
69
|
+
const payload = JSON.parse(output);
|
|
70
|
+
for (const [name, value] of Object.entries(payload)) {
|
|
71
|
+
if (name === "generatedAt")
|
|
72
|
+
continue;
|
|
73
|
+
const section = sectionFor(name);
|
|
74
|
+
for (const fragment of Array.isArray(value) ? value : [value])
|
|
75
|
+
factFor(section, JSON.stringify(fragment));
|
|
76
|
+
}
|
|
77
|
+
const { used: _used, ...publicReceipt } = receipt;
|
|
78
|
+
payload.context_receipt = publicReceipt;
|
|
79
|
+
// Preserve compact JSON when the original output was minified.
|
|
80
|
+
rendered = `${JSON.stringify(payload, null, output.trim().includes("\n") ? 2 : 0)}\n`;
|
|
81
|
+
receipt.protocol_tokens = Math.ceil((rendered.length - output.length) / 4);
|
|
82
|
+
publicReceipt.protocol_tokens = receipt.protocol_tokens;
|
|
83
|
+
rendered = `${JSON.stringify(payload, null, output.trim().includes("\n") ? 2 : 0)}\n`;
|
|
84
|
+
}
|
|
85
|
+
else {
|
|
86
|
+
let section = sectionFor("preamble");
|
|
87
|
+
let inheritedItems = [];
|
|
88
|
+
const lines = output.trimEnd().split("\n").map((line) => {
|
|
89
|
+
if (/^#+ /.test(line)) {
|
|
90
|
+
section = sectionFor(line.replace(/^#+ /, ""));
|
|
91
|
+
inheritedItems = [];
|
|
92
|
+
return `${line} [${section.id}]`;
|
|
93
|
+
}
|
|
94
|
+
if (!line.trim() || line.startsWith("Generated:"))
|
|
95
|
+
return line;
|
|
96
|
+
const fact = factFor(section, line, /^\s/.test(line) ? inheritedItems : []);
|
|
97
|
+
inheritedItems = fact.item_ids;
|
|
98
|
+
return `${line} [${fact.id}]`;
|
|
99
|
+
});
|
|
100
|
+
rendered = `${lines.join("\n")}\n\nContext receipt: ${receipt.receipt_id}; session: ${receipt.session}; protocol: ${receipt.protocol}\n`;
|
|
101
|
+
receipt.protocol_tokens = Math.ceil((rendered.length - output.length) / 4);
|
|
102
|
+
}
|
|
103
|
+
withReceiptStore(pmRoot, (directory) => {
|
|
104
|
+
const path = join(directory, `${receipt.receipt_id}.json`);
|
|
105
|
+
try {
|
|
106
|
+
persistReceipt(path, receipt);
|
|
107
|
+
if (outputPath)
|
|
108
|
+
writeFileSync(outputPath, rendered, "utf8");
|
|
109
|
+
const entries = readdirSync(directory).filter((entry) => /^[\da-f-]{36}\.json$/.test(entry) && entry !== `${receipt.receipt_id}.json`)
|
|
110
|
+
.map((entry) => ({ entry, modified: statSync(join(directory, entry)).mtimeMs }))
|
|
111
|
+
.sort((a, b) => b.modified - a.modified || b.entry.localeCompare(a.entry));
|
|
112
|
+
for (const entry of entries.slice(RECEIPT_LIMITS.count - 1))
|
|
113
|
+
rmSync(join(directory, entry.entry));
|
|
114
|
+
}
|
|
115
|
+
catch (error) {
|
|
116
|
+
rmSync(path, { force: true });
|
|
117
|
+
throw error;
|
|
118
|
+
}
|
|
119
|
+
});
|
|
120
|
+
const { used: _used, ...publicReceipt } = receipt;
|
|
121
|
+
return { output: rendered, receipt: publicReceipt };
|
|
122
|
+
}
|
|
123
|
+
/** Serialize an atomic bounded snapshot; readers never observe a partial write. */
|
|
124
|
+
function persistReceipt(path, receipt) {
|
|
125
|
+
const serialized = JSON.stringify(receipt);
|
|
126
|
+
if (Buffer.byteLength(serialized) > RECEIPT_LIMITS.bytes)
|
|
127
|
+
throw new Error("Context receipt exceeds the runtime byte limit");
|
|
128
|
+
const temporary = `${path}.${randomUUID()}.tmp`;
|
|
129
|
+
try {
|
|
130
|
+
writeFileSync(temporary, serialized, { mode: 0o600 });
|
|
131
|
+
renameSync(temporary, path);
|
|
132
|
+
}
|
|
133
|
+
finally {
|
|
134
|
+
rmSync(temporary, { force: true });
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
/** Cooperating writers serialize rotation and evidence updates; contention asks for retry. */
|
|
138
|
+
function withReceiptStore(pmRoot, operation) {
|
|
139
|
+
const directory = join(pmRoot, RECEIPTS_RELATIVE_PATH);
|
|
140
|
+
mkdirSync(directory, { recursive: true, mode: 0o700 });
|
|
141
|
+
const lock = join(directory, ".lock");
|
|
142
|
+
mkdirSync(lock);
|
|
143
|
+
try {
|
|
144
|
+
return operation(directory);
|
|
145
|
+
}
|
|
146
|
+
finally {
|
|
147
|
+
rmSync(lock, { recursive: true, force: true });
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
/** Validate every field consumed by reports, skipping oversized or corrupt snapshots. */
|
|
151
|
+
function readReceipt(path) {
|
|
152
|
+
try {
|
|
153
|
+
if (statSync(path).size > RECEIPT_LIMITS.bytes)
|
|
154
|
+
return null;
|
|
155
|
+
const decoded = JSON.parse(readFileSync(path, "utf8"));
|
|
156
|
+
if (typeof decoded !== "object" || decoded === null)
|
|
157
|
+
return null;
|
|
158
|
+
const row = decoded;
|
|
159
|
+
if (row.protocol !== "pm-context-usage/v1" || typeof row.receipt_id !== "string" || !/^[\da-f-]{36}$/.test(row.receipt_id) || basename(path) !== `${row.receipt_id}.json`)
|
|
160
|
+
return null;
|
|
161
|
+
for (const key of ["session", "author", "served_at", "command"])
|
|
162
|
+
if (typeof row[key] !== "string")
|
|
163
|
+
return null;
|
|
164
|
+
const at = row.served_at;
|
|
165
|
+
if (Number.isNaN(Date.parse(at)) || new Date(at).toISOString() !== at)
|
|
166
|
+
return null;
|
|
167
|
+
if (!Number.isSafeInteger(row.protocol_tokens) || row.protocol_tokens < 0 || !Array.isArray(row.sections) || !Array.isArray(row.facts))
|
|
168
|
+
return null;
|
|
169
|
+
const sectionIds = new Set();
|
|
170
|
+
for (const section of row.sections) {
|
|
171
|
+
if (typeof section !== "object" || section === null || typeof section.id !== "string" || typeof section.name !== "string")
|
|
172
|
+
return null;
|
|
173
|
+
sectionIds.add(section.id);
|
|
174
|
+
}
|
|
175
|
+
const factIds = new Set();
|
|
176
|
+
for (const entry of row.facts) {
|
|
177
|
+
if (typeof entry !== "object" || entry === null)
|
|
178
|
+
return null;
|
|
179
|
+
const fact = entry;
|
|
180
|
+
if (typeof fact.id !== "string" || factIds.has(fact.id) || typeof fact.section_id !== "string" || !sectionIds.has(fact.section_id))
|
|
181
|
+
return null;
|
|
182
|
+
if (!Array.isArray(fact.item_ids) || !fact.item_ids.every((id) => typeof id === "string"))
|
|
183
|
+
return null;
|
|
184
|
+
if (!Array.isArray(fact.files) || !fact.files.every((file) => typeof file === "string" && normalizeReceiptFile(file) === file))
|
|
185
|
+
return null;
|
|
186
|
+
if (!Number.isSafeInteger(fact.estimated_tokens) || fact.estimated_tokens < 0)
|
|
187
|
+
return null;
|
|
188
|
+
factIds.add(fact.id);
|
|
189
|
+
}
|
|
190
|
+
if (typeof row.used !== "object" || row.used === null || Array.isArray(row.used))
|
|
191
|
+
return null;
|
|
192
|
+
for (const [id, signals] of Object.entries(row.used)) {
|
|
193
|
+
if (!factIds.has(id) || !Array.isArray(signals) || !signals.every((signal) => signal === "citation" || signal === "touch" || signal === "edit"))
|
|
194
|
+
return null;
|
|
195
|
+
}
|
|
196
|
+
return row;
|
|
197
|
+
}
|
|
198
|
+
catch {
|
|
199
|
+
return null;
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
/**
|
|
203
|
+
* Record explicit, receipt-scoped usage. Unknown ids reject the entire update;
|
|
204
|
+
* repeat reports are idempotent. Item/file proxies match only facts in this receipt.
|
|
205
|
+
*/
|
|
206
|
+
export function recordReceiptUsage(pmRoot, usage) {
|
|
207
|
+
if (!/^[\da-f-]{36}$/.test(usage.receipt_id))
|
|
208
|
+
throw new Error("Invalid context receipt id");
|
|
209
|
+
withReceiptStore(pmRoot, (directory) => {
|
|
210
|
+
const path = join(directory, `${usage.receipt_id}.json`);
|
|
211
|
+
const receipt = readReceipt(path);
|
|
212
|
+
if (!receipt)
|
|
213
|
+
throw new Error("Context receipt is missing, expired or malformed");
|
|
214
|
+
if (usage.session !== undefined && usage.session !== receipt.session)
|
|
215
|
+
throw new Error("Session does not match the context receipt");
|
|
216
|
+
const editedFiles = usage.edited_files.map(normalizeReceiptFile);
|
|
217
|
+
const citations = new Set(usage.citations);
|
|
218
|
+
for (const id of citations) {
|
|
219
|
+
if (!receipt.facts.some((fact) => fact.id === id) && !receipt.sections.some((section) => section.id === id))
|
|
220
|
+
throw new Error("Citation was not served in this receipt");
|
|
221
|
+
}
|
|
222
|
+
for (const id of usage.touched_items)
|
|
223
|
+
if (!receipt.facts.some((fact) => fact.item_ids.includes(id)))
|
|
224
|
+
throw new Error("Touched item was not served in this receipt");
|
|
225
|
+
for (const file of editedFiles)
|
|
226
|
+
if (!receipt.facts.some((fact) => fact.files.includes(file)))
|
|
227
|
+
throw new Error("Edited file was not served in this receipt");
|
|
228
|
+
for (const fact of receipt.facts) {
|
|
229
|
+
const signals = new Set(receipt.used[fact.id]);
|
|
230
|
+
if (citations.has(fact.id) || citations.has(fact.section_id))
|
|
231
|
+
signals.add("citation");
|
|
232
|
+
if (usage.touched_items.some((id) => fact.item_ids.includes(id)))
|
|
233
|
+
signals.add("touch");
|
|
234
|
+
if (editedFiles.some((file) => fact.files.includes(file)))
|
|
235
|
+
signals.add("edit");
|
|
236
|
+
if (signals.size > 0)
|
|
237
|
+
receipt.used[fact.id] = [...signals].sort();
|
|
238
|
+
}
|
|
239
|
+
persistReceipt(path, receipt);
|
|
240
|
+
});
|
|
241
|
+
}
|
|
242
|
+
/** Count fact impressions and estimated unused cost without claiming cognitive use. */
|
|
243
|
+
function receiptMetrics(receipts, itemId) {
|
|
244
|
+
const metrics = { served_facts: 0, used_facts: 0, cited_facts: 0, touch_facts: 0, edit_facts: 0,
|
|
245
|
+
precision: null, estimated_served_tokens: 0, unused_context_tokens: 0, protocol_tokens: 0 };
|
|
246
|
+
for (const receipt of receipts) {
|
|
247
|
+
if (itemId === undefined)
|
|
248
|
+
metrics.protocol_tokens += receipt.protocol_tokens;
|
|
249
|
+
for (const fact of receipt.facts) {
|
|
250
|
+
if (itemId !== undefined && !fact.item_ids.includes(itemId))
|
|
251
|
+
continue;
|
|
252
|
+
const signals = receipt.used[fact.id] ?? [];
|
|
253
|
+
metrics.served_facts += 1;
|
|
254
|
+
metrics.estimated_served_tokens += fact.estimated_tokens;
|
|
255
|
+
if (signals.length > 0)
|
|
256
|
+
metrics.used_facts += 1;
|
|
257
|
+
else
|
|
258
|
+
metrics.unused_context_tokens += fact.estimated_tokens;
|
|
259
|
+
if (signals.includes("citation"))
|
|
260
|
+
metrics.cited_facts += 1;
|
|
261
|
+
if (signals.includes("touch"))
|
|
262
|
+
metrics.touch_facts += 1;
|
|
263
|
+
if (signals.includes("edit"))
|
|
264
|
+
metrics.edit_facts += 1;
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
if (metrics.served_facts > 0)
|
|
268
|
+
metrics.precision = metrics.used_facts / metrics.served_facts;
|
|
269
|
+
return metrics;
|
|
270
|
+
}
|
|
271
|
+
/** Read retained receipts, report skipped corruption, and aggregate before limiting detail. */
|
|
272
|
+
export function reportContextReceipts(pmRoot, options) {
|
|
273
|
+
const directory = join(pmRoot, RECEIPTS_RELATIVE_PATH);
|
|
274
|
+
const selected = [];
|
|
275
|
+
let malformed = 0;
|
|
276
|
+
if (existsSync(directory)) {
|
|
277
|
+
for (const entry of readdirSync(directory).filter((name) => /^[\da-f-]{36}\.json$/.test(name))) {
|
|
278
|
+
const receipt = readReceipt(join(directory, entry));
|
|
279
|
+
if (!receipt) {
|
|
280
|
+
malformed += 1;
|
|
281
|
+
continue;
|
|
282
|
+
}
|
|
283
|
+
if (options.session !== undefined && receipt.session !== options.session)
|
|
284
|
+
continue;
|
|
285
|
+
if (options.author !== undefined && receipt.author !== options.author)
|
|
286
|
+
continue;
|
|
287
|
+
if (options.since !== undefined && receipt.served_at <= options.since)
|
|
288
|
+
continue;
|
|
289
|
+
if (options.receipt_id !== undefined && receipt.receipt_id !== options.receipt_id)
|
|
290
|
+
continue;
|
|
291
|
+
selected.push(receipt);
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
selected.sort((a, b) => a.served_at.localeCompare(b.served_at) || a.receipt_id.localeCompare(b.receipt_id));
|
|
295
|
+
const sessions = [...new Set(selected.map((receipt) => receipt.session))].sort();
|
|
296
|
+
const itemIds = [...new Set(selected.flatMap((receipt) => receipt.facts.flatMap((fact) => fact.item_ids)))].sort();
|
|
297
|
+
return {
|
|
298
|
+
protocol: "pm-context-usage/v1", retained_receipts: selected.length, malformed_receipts: malformed,
|
|
299
|
+
totals: receiptMetrics(selected),
|
|
300
|
+
sessions: sessions.slice(0, options.limit).map((session) => ({ session, ...receiptMetrics(selected.filter((receipt) => receipt.session === session)) })),
|
|
301
|
+
items: itemIds.slice(0, options.limit).map((id) => ({ id, ...receiptMetrics(selected, id) })),
|
|
302
|
+
receipts: selected.slice(0, options.limit).map((receipt) => ({ receipt_id: receipt.receipt_id, session: receipt.session,
|
|
303
|
+
...receiptMetrics([receipt]), unused_fact_ids: receipt.facts.filter((fact) => !receipt.used[fact.id]?.length).map((fact) => fact.id) })),
|
|
304
|
+
};
|
|
305
|
+
}
|
|
306
|
+
/** Render the receipt denominator, usage proxies and unused estimated cost as a brief. */
|
|
307
|
+
export function renderReceiptReport(report) {
|
|
308
|
+
const metrics = report.totals;
|
|
309
|
+
const precision = metrics.precision === null ? "n/a" : `${(100 * metrics.precision).toFixed(1)}%`;
|
|
310
|
+
return ["## Bundle receipts (reported usage)", "", `- receipts: ${report.retained_receipts}; malformed skipped: ${report.malformed_receipts}`,
|
|
311
|
+
`- used / served facts: ${metrics.used_facts} / ${metrics.served_facts}; precision: ${precision}`,
|
|
312
|
+
`- citations: ${metrics.cited_facts}; item-touch proxies: ${metrics.touch_facts}; file-edit proxies: ${metrics.edit_facts}`,
|
|
313
|
+
`- unused context: ~${metrics.unused_context_tokens} tokens; protocol overhead: ~${metrics.protocol_tokens} tokens`, "",
|
|
314
|
+
"| session | used / served | unused tokens (estimated) |", "| --- | ---: | ---: |",
|
|
315
|
+
...report.sessions.map((session) => `| ${session.session.replaceAll("|", "\\|").replaceAll("\n", " ")} | ${session.used_facts} / ${session.served_facts} | ${session.unused_context_tokens} |`), ""].join("\n");
|
|
316
|
+
}
|
|
317
|
+
//# sourceMappingURL=context-receipts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context-receipts.js","sourceRoot":"","sources":["../context-receipts.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -2,16 +2,7 @@ import type { ExtensionApi, RuntimeStatusRegistry } from "@unbrained/pm-cli/sdk"
|
|
|
2
2
|
import { list as pmList } from "@unbrained/pm-cli/sdk/core";
|
|
3
3
|
import type { ListResult } from "@unbrained/pm-cli/sdk/query";
|
|
4
4
|
import type { ContextRelevanceReport } from "@unbrained/pm-cli/sdk/query";
|
|
5
|
-
/**
|
|
6
|
-
* Runtime stand-in for the SDK's `defineExtension`.
|
|
7
|
-
*
|
|
8
|
-
* `defineExtension` is a documented zero-cost identity function. This package
|
|
9
|
-
* now resolves `@unbrained/pm-cli` at runtime (it is a peer dependency the pm
|
|
10
|
-
* host provides) for the `sdk/core` and `sdk/query` engines, but the authoring
|
|
11
|
-
* helper itself has no runtime behavior, so a local identity shim avoids a
|
|
12
|
-
* needless value import while still contract-checking the module against
|
|
13
|
-
* {@link ExtensionModule}.
|
|
14
|
-
*/
|
|
5
|
+
/** Stable failure categories reported by context command handlers. */
|
|
15
6
|
export declare const EXIT_CODE: {
|
|
16
7
|
readonly GENERIC_FAILURE: 1;
|
|
17
8
|
readonly USAGE: 2;
|
|
@@ -433,6 +424,7 @@ export declare function buildContextExplain(items: readonly PmItem[], options: S
|
|
|
433
424
|
export declare function renderContextExplain(report: ContextExplainReport, options?: {
|
|
434
425
|
compress?: boolean;
|
|
435
426
|
}): string;
|
|
427
|
+
/** Register context commands and renderers with checked host behavior and package metadata. */
|
|
436
428
|
declare const _default: {
|
|
437
429
|
name: string;
|
|
438
430
|
version: string;
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,YAAY,EAEZ,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,6BAA6B,CAAC;AAO9E,OAAO,KAAK,EAGV,sBAAsB,EAEvB,MAAM,6BAA6B,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -4,16 +4,8 @@ import { list as pmList } from "@unbrained/pm-cli/sdk/core";
|
|
|
4
4
|
import { buildItemContextRelevanceCandidates, defaultScoreContextCandidates, packContextCandidates, recordContextUsageServing, } from "@unbrained/pm-cli/sdk/query";
|
|
5
5
|
import { DEFAULT_REPORT_LIMIT, renderUsageReport, reportContextUsage, resolveSince } from "./context-usage.js";
|
|
6
6
|
import { readContextUsageAffinity } from "@unbrained/pm-cli/sdk/query";
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
*
|
|
10
|
-
* `defineExtension` is a documented zero-cost identity function. This package
|
|
11
|
-
* now resolves `@unbrained/pm-cli` at runtime (it is a peer dependency the pm
|
|
12
|
-
* host provides) for the `sdk/core` and `sdk/query` engines, but the authoring
|
|
13
|
-
* helper itself has no runtime behavior, so a local identity shim avoids a
|
|
14
|
-
* needless value import while still contract-checking the module against
|
|
15
|
-
* {@link ExtensionModule}.
|
|
16
|
-
*/
|
|
7
|
+
import { recordReceiptUsage, reportContextReceipts, renderReceiptReport, serveContextReceipt } from "./context-receipts.js";
|
|
8
|
+
/** Stable failure categories reported by context command handlers. */
|
|
17
9
|
export const EXIT_CODE = {
|
|
18
10
|
GENERIC_FAILURE: 1,
|
|
19
11
|
USAGE: 2,
|
|
@@ -1073,6 +1065,39 @@ async function recordPackServing(ctx, focus, neighbors) {
|
|
|
1073
1065
|
// Recording is best-effort: a ledger write failure must not break a pack.
|
|
1074
1066
|
}
|
|
1075
1067
|
}
|
|
1068
|
+
/**
|
|
1069
|
+
* Measure the rendered subset on both serving paths. A failed runtime write is
|
|
1070
|
+
* disclosed in the output rather than inventing a receipt or blocking context.
|
|
1071
|
+
*/
|
|
1072
|
+
async function measureContextOutput(ctx, pack, output, format, command, compress, outputPath) {
|
|
1073
|
+
try {
|
|
1074
|
+
const measured = serveContextReceipt(ctx.pm_root, output, format === "json" ? "json" : "text", {
|
|
1075
|
+
item_ids: [...pack.items, ...pack.neighbors].map((item) => item.id),
|
|
1076
|
+
files: pack.links.filter((link) => link.kind === "file"),
|
|
1077
|
+
}, {
|
|
1078
|
+
session: stringOption(ctx.options, "session") ?? process.env.PM_CONTEXT_SESSION,
|
|
1079
|
+
author: stringOption(ctx.options, "author") ?? ctx.global.author ?? process.env.PM_AUTHOR ?? "anonymous",
|
|
1080
|
+
command,
|
|
1081
|
+
}, outputPath);
|
|
1082
|
+
const visible = new Set(measured.receipt.facts.flatMap((fact) => fact.item_ids));
|
|
1083
|
+
await recordPackServing(ctx, pack.items.filter((item) => visible.has(item.id)), pack.neighbors.filter((item) => visible.has(item.id)));
|
|
1084
|
+
return measured.output;
|
|
1085
|
+
}
|
|
1086
|
+
catch {
|
|
1087
|
+
let fallback;
|
|
1088
|
+
if (format === "json") {
|
|
1089
|
+
const payload = JSON.parse(output);
|
|
1090
|
+
payload.context_receipt_error = "Runtime receipt unavailable; usage cannot be measured for this bundle";
|
|
1091
|
+
fallback = `${JSON.stringify(payload, null, compress ? 0 : 2)}\n`;
|
|
1092
|
+
}
|
|
1093
|
+
else {
|
|
1094
|
+
fallback = `${output}\nContext receipt unavailable; usage cannot be measured for this bundle.\n`;
|
|
1095
|
+
}
|
|
1096
|
+
if (outputPath)
|
|
1097
|
+
writeFileSync(outputPath, fallback, "utf8");
|
|
1098
|
+
return fallback;
|
|
1099
|
+
}
|
|
1100
|
+
}
|
|
1076
1101
|
function setupCommands(api) {
|
|
1077
1102
|
const contextPackDefaultLimit = 25;
|
|
1078
1103
|
const contextHandoffDefaultLimit = 12;
|
|
@@ -1093,6 +1118,7 @@ function setupCommands(api) {
|
|
|
1093
1118
|
"pm context-pack --status in_progress --explain",
|
|
1094
1119
|
],
|
|
1095
1120
|
flags: [
|
|
1121
|
+
{ long: "--session", value_name: "id", description: "Usage session id (defaults to PM_CONTEXT_SESSION or the receipt id)", type: "string" },
|
|
1096
1122
|
{ long: "--id", value_name: "id", description: "Focus item id (repeatable or comma-separated)", type: "string" },
|
|
1097
1123
|
{ long: "--ids", value_name: "ids", description: "Comma-separated focus ids (alias for repeated --id)", type: "string" },
|
|
1098
1124
|
{ long: "--status", value_name: "status", description: "Filter focus items by status", type: "string" },
|
|
@@ -1170,7 +1196,6 @@ function setupCommands(api) {
|
|
|
1170
1196
|
}
|
|
1171
1197
|
return renderedCommandResult(output);
|
|
1172
1198
|
}
|
|
1173
|
-
await recordPackServing(ctx, pack.items, pack.neighbors);
|
|
1174
1199
|
const suggestedCommand = buildSuggestedAgentCommand({
|
|
1175
1200
|
commandName: "context-pack",
|
|
1176
1201
|
selection,
|
|
@@ -1188,16 +1213,16 @@ function setupCommands(api) {
|
|
|
1188
1213
|
sections: sections.length > 0 ? sections : undefined,
|
|
1189
1214
|
});
|
|
1190
1215
|
const renderOpts = { recentLimit, suggestedCommand, compress, sections: sections.length > 0 ? sections : undefined };
|
|
1191
|
-
|
|
1216
|
+
let output = format === "json"
|
|
1192
1217
|
? `${JSON.stringify(pack, null, compress ? 0 : 2)}\n`
|
|
1193
1218
|
: format === "agent"
|
|
1194
1219
|
? renderAgentHandoff(pack, renderOpts)
|
|
1195
1220
|
: renderMarkdown(pack, renderOpts);
|
|
1196
1221
|
const outputPath = stringOption(options, "output");
|
|
1222
|
+
output = await measureContextOutput(ctx, pack, output, format, "context-pack", compress, outputPath);
|
|
1197
1223
|
if (outputPath) {
|
|
1198
|
-
writeFileSync(outputPath, output, "utf-8");
|
|
1199
1224
|
const reportedFormat = requestedFormat === "compact" ? "compact" : format;
|
|
1200
|
-
return format === "json" ?
|
|
1225
|
+
return format === "json" ? JSON.parse(output) : { ok: true, format: reportedFormat, selected: pack.summary.selectedItems, neighbors: pack.summary.neighborItems };
|
|
1201
1226
|
}
|
|
1202
1227
|
return renderedCommandResult(output);
|
|
1203
1228
|
},
|
|
@@ -1215,6 +1240,7 @@ function setupCommands(api) {
|
|
|
1215
1240
|
"pm context-handoff --id pm-1234 --compress --include-deps",
|
|
1216
1241
|
],
|
|
1217
1242
|
flags: [
|
|
1243
|
+
{ long: "--session", value_name: "id", description: "Usage session id (defaults to PM_CONTEXT_SESSION or the receipt id)", type: "string" },
|
|
1218
1244
|
{ long: "--id", value_name: "id", description: "Focus item id (repeatable or comma-separated)", type: "string" },
|
|
1219
1245
|
{ long: "--ids", value_name: "ids", description: "Comma-separated focus ids (alias for repeated --id)", type: "string" },
|
|
1220
1246
|
{ long: "--status", value_name: "status", description: "Filter focus items by status", type: "string" },
|
|
@@ -1273,7 +1299,6 @@ function setupCommands(api) {
|
|
|
1273
1299
|
ranker,
|
|
1274
1300
|
packer,
|
|
1275
1301
|
});
|
|
1276
|
-
await recordPackServing(ctx, pack.items, pack.neighbors);
|
|
1277
1302
|
const suggestedCommand = buildSuggestedAgentCommand({
|
|
1278
1303
|
commandName: "context-handoff",
|
|
1279
1304
|
selection,
|
|
@@ -1291,12 +1316,12 @@ function setupCommands(api) {
|
|
|
1291
1316
|
});
|
|
1292
1317
|
const renderOpts = { recentLimit, suggestedCommand, compress, sections: sections.length > 0 ? sections : undefined };
|
|
1293
1318
|
const handoff = buildAgentHandoff(pack, { recentLimit, suggestedCommand });
|
|
1294
|
-
|
|
1319
|
+
let output = format === "json"
|
|
1295
1320
|
? `${JSON.stringify(handoff, null, compress ? 0 : 2)}\n`
|
|
1296
1321
|
: renderAgentHandoff(pack, renderOpts);
|
|
1297
1322
|
const outputPath = stringOption(options, "output");
|
|
1323
|
+
output = await measureContextOutput(ctx, pack, output, format, "context-handoff", compress, outputPath);
|
|
1298
1324
|
if (outputPath) {
|
|
1299
|
-
writeFileSync(outputPath, output, "utf-8");
|
|
1300
1325
|
return {
|
|
1301
1326
|
ok: true,
|
|
1302
1327
|
format: format === "json" ? "json" : "agent",
|
|
@@ -1319,6 +1344,11 @@ function setupCommands(api) {
|
|
|
1319
1344
|
"pm context-usage --by agent-a --limit 50",
|
|
1320
1345
|
],
|
|
1321
1346
|
flags: [
|
|
1347
|
+
{ long: "--session", value_name: "id", description: "Filter bundle receipts to a session", type: "string" },
|
|
1348
|
+
{ long: "--receipt", value_name: "id", description: "Filter or report usage against one bundle receipt", type: "string" },
|
|
1349
|
+
{ long: "--cite", value_name: "ids", description: "Used fact or section ids (repeatable/comma-separated; requires --receipt)", type: "string" },
|
|
1350
|
+
{ long: "--touch", value_name: "ids", description: "Item ids touched in later mutations (requires --receipt)", type: "string" },
|
|
1351
|
+
{ long: "--edited-file", value_name: "paths", description: "Repository-relative edited files (requires --receipt)", type: "string" },
|
|
1322
1352
|
{ long: "--by", value_name: "author", description: "Restrict to one recording author", type: "string" },
|
|
1323
1353
|
{ long: "--surface", value_name: "surface", description: "Restrict serve events to one surface: context or next", type: "string" },
|
|
1324
1354
|
{ long: "--since", value_name: "when", description: "Drop events at or before this point (ISO timestamp, or a day offset such as 7d)", type: "string" },
|
|
@@ -1346,6 +1376,23 @@ function setupCommands(api) {
|
|
|
1346
1376
|
// would silently narrow every report to the invoking agent, so this keeps
|
|
1347
1377
|
// a distinct `--by`.
|
|
1348
1378
|
const author = stringOption(options, "by");
|
|
1379
|
+
const session = stringOption(options, "session") ?? process.env.PM_CONTEXT_SESSION;
|
|
1380
|
+
const receiptId = stringOption(options, "receipt");
|
|
1381
|
+
const citations = asArray(options.cite);
|
|
1382
|
+
const touchedItems = asArray(options.touch);
|
|
1383
|
+
const editedFiles = asArray(options["edited-file"] ?? options.editedFile);
|
|
1384
|
+
if (citations.length + touchedItems.length + editedFiles.length > 0) {
|
|
1385
|
+
if (!receiptId)
|
|
1386
|
+
throw new CommandError("Usage evidence requires --receipt", EXIT_CODE.USAGE);
|
|
1387
|
+
try {
|
|
1388
|
+
recordReceiptUsage(ctx.pm_root, { receipt_id: receiptId, session, citations, touched_items: touchedItems, edited_files: editedFiles });
|
|
1389
|
+
}
|
|
1390
|
+
catch (error) {
|
|
1391
|
+
throw new CommandError(error instanceof Error ? error.message : String(error), EXIT_CODE.USAGE);
|
|
1392
|
+
}
|
|
1393
|
+
}
|
|
1394
|
+
const bundles = reportContextReceipts(ctx.pm_root, { session, author, since: since ?? undefined,
|
|
1395
|
+
receipt_id: receiptId, limit: intOption(options, "limit", DEFAULT_REPORT_LIMIT) });
|
|
1349
1396
|
const report = reportContextUsage(ctx.pm_root, {
|
|
1350
1397
|
author,
|
|
1351
1398
|
surface,
|
|
@@ -1367,29 +1414,19 @@ function setupCommands(api) {
|
|
|
1367
1414
|
affinity = undefined;
|
|
1368
1415
|
}
|
|
1369
1416
|
}
|
|
1370
|
-
const reportWithAffinity =
|
|
1417
|
+
const reportWithAffinity = { ...report, bundles, ...(affinity ? { affinity } : {}) };
|
|
1371
1418
|
// pm's global --json owns that flag name, so a command-level alias would be
|
|
1372
1419
|
// silently shadowed and never populate ctx.options. Read the global instead,
|
|
1373
1420
|
// so `pm context-usage --json` returns the raw report as an agent expects.
|
|
1374
1421
|
const wantsJson = requestedFormat === "json" || ctx.global?.json === true;
|
|
1375
|
-
return renderedCommandResult(wantsJson ? `${JSON.stringify(reportWithAffinity, null, 2)}\n` : renderUsageReport(reportWithAffinity));
|
|
1422
|
+
return renderedCommandResult(wantsJson ? `${JSON.stringify(reportWithAffinity, null, 2)}\n` : `${renderUsageReport(reportWithAffinity)}\n${renderReceiptReport(bundles)}`);
|
|
1376
1423
|
},
|
|
1377
1424
|
});
|
|
1378
1425
|
}
|
|
1379
|
-
/**
|
|
1380
|
-
|
|
1381
|
-
*
|
|
1382
|
-
* This package resolves `@unbrained/pm-cli` at runtime for the `sdk/core` and
|
|
1383
|
-
* `sdk/query` engines (it is a peer dependency the pm host provides), but
|
|
1384
|
-
* `defineExtension` itself is a pure identity with no runtime behavior, so a
|
|
1385
|
-
* local shim avoids a needless value import while still contract-checking the
|
|
1386
|
-
* extension object against {@link ExtensionModule} exactly as the imported
|
|
1387
|
-
* helper would.
|
|
1388
|
-
*/
|
|
1389
|
-
const defineExtension = (module) => module;
|
|
1390
|
-
export default defineExtension({
|
|
1426
|
+
/** Register context commands and renderers with checked host behavior and package metadata. */
|
|
1427
|
+
export default {
|
|
1391
1428
|
name: "pm-context",
|
|
1392
|
-
version: "2026.10.
|
|
1429
|
+
version: "2026.10.12",
|
|
1393
1430
|
description: "Generate deterministic pm context packs for agent handoffs, reviews, and status briefs",
|
|
1394
1431
|
activate(api) {
|
|
1395
1432
|
setupCommands(api);
|
|
@@ -1402,5 +1439,5 @@ export default defineExtension({
|
|
|
1402
1439
|
api.registerRenderer("json", renderCommandResult, rendererOwnership);
|
|
1403
1440
|
}
|
|
1404
1441
|
},
|
|
1405
|
-
}
|
|
1442
|
+
};
|
|
1406
1443
|
//# sourceMappingURL=index.js.map
|