autotel-pact 0.2.0

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.
Files changed (86) hide show
  1. package/README.md +385 -0
  2. package/dist/audit.cjs +412 -0
  3. package/dist/audit.cjs.map +1 -0
  4. package/dist/audit.d.cts +25 -0
  5. package/dist/audit.d.ts +25 -0
  6. package/dist/audit.js +403 -0
  7. package/dist/audit.js.map +1 -0
  8. package/dist/auto-wrap.cjs +255 -0
  9. package/dist/auto-wrap.cjs.map +1 -0
  10. package/dist/auto-wrap.d.cts +57 -0
  11. package/dist/auto-wrap.d.ts +57 -0
  12. package/dist/auto-wrap.js +248 -0
  13. package/dist/auto-wrap.js.map +1 -0
  14. package/dist/broker.cjs +84 -0
  15. package/dist/broker.cjs.map +1 -0
  16. package/dist/broker.d.cts +23 -0
  17. package/dist/broker.d.ts +23 -0
  18. package/dist/broker.js +80 -0
  19. package/dist/broker.js.map +1 -0
  20. package/dist/cli.cjs +662 -0
  21. package/dist/cli.cjs.map +1 -0
  22. package/dist/cli.d.cts +4 -0
  23. package/dist/cli.d.ts +4 -0
  24. package/dist/cli.js +656 -0
  25. package/dist/cli.js.map +1 -0
  26. package/dist/index.cjs +967 -0
  27. package/dist/index.cjs.map +1 -0
  28. package/dist/index.d.cts +200 -0
  29. package/dist/index.d.ts +200 -0
  30. package/dist/index.js +932 -0
  31. package/dist/index.js.map +1 -0
  32. package/dist/ledger-BuBmfWNc.d.ts +22 -0
  33. package/dist/ledger-D88TzN1c.d.cts +22 -0
  34. package/dist/processor.cjs +200 -0
  35. package/dist/processor.cjs.map +1 -0
  36. package/dist/processor.d.cts +58 -0
  37. package/dist/processor.d.ts +58 -0
  38. package/dist/processor.js +193 -0
  39. package/dist/processor.js.map +1 -0
  40. package/dist/provider.cjs +219 -0
  41. package/dist/provider.cjs.map +1 -0
  42. package/dist/provider.d.cts +41 -0
  43. package/dist/provider.d.ts +41 -0
  44. package/dist/provider.js +213 -0
  45. package/dist/provider.js.map +1 -0
  46. package/dist/tag.cjs +50 -0
  47. package/dist/tag.cjs.map +1 -0
  48. package/dist/tag.d.cts +9 -0
  49. package/dist/tag.d.ts +9 -0
  50. package/dist/tag.js +48 -0
  51. package/dist/tag.js.map +1 -0
  52. package/dist/types-BHGiwqcp.d.cts +157 -0
  53. package/dist/types-BHGiwqcp.d.ts +157 -0
  54. package/package.json +108 -0
  55. package/schemas/README.md +24 -0
  56. package/schemas/audit-matrix-v0.2.0.json +78 -0
  57. package/schemas/ledger-entry-v0.2.0.json +77 -0
  58. package/src/attrs.test.ts +35 -0
  59. package/src/attrs.ts +53 -0
  60. package/src/audit.test.ts +189 -0
  61. package/src/audit.ts +251 -0
  62. package/src/auto-wrap.test.ts +149 -0
  63. package/src/auto-wrap.ts +283 -0
  64. package/src/broker.test.ts +175 -0
  65. package/src/broker.ts +118 -0
  66. package/src/cli.test.ts +148 -0
  67. package/src/cli.ts +287 -0
  68. package/src/index.ts +94 -0
  69. package/src/labels.ts +25 -0
  70. package/src/ledger-normalize.test.ts +141 -0
  71. package/src/ledger-normalize.ts +82 -0
  72. package/src/ledger.test.ts +92 -0
  73. package/src/ledger.ts +156 -0
  74. package/src/pact-file.test.ts +124 -0
  75. package/src/pact-file.ts +65 -0
  76. package/src/processor.test.ts +90 -0
  77. package/src/processor.ts +191 -0
  78. package/src/tag.test.ts +72 -0
  79. package/src/tag.ts +21 -0
  80. package/src/types.ts +169 -0
  81. package/src/wrapper-http.test.ts +133 -0
  82. package/src/wrapper-http.ts +194 -0
  83. package/src/wrapper-provider.test.ts +132 -0
  84. package/src/wrapper-provider.ts +163 -0
  85. package/src/wrapper.test.ts +176 -0
  86. package/src/wrapper.ts +221 -0
package/dist/cli.js ADDED
@@ -0,0 +1,656 @@
1
+ #!/usr/bin/env node
2
+ import path from 'path';
3
+ import { existsSync, statSync, readdirSync, readFileSync } from 'fs';
4
+ import 'fs/promises';
5
+
6
+ // src/broker.ts
7
+ function authHeaders(config) {
8
+ const headers = {
9
+ Accept: "application/json"
10
+ };
11
+ if (config.token) {
12
+ headers.Authorization = `Bearer ${config.token}`;
13
+ } else if (config.username && config.password) {
14
+ const encoded = Buffer.from(`${config.username}:${config.password}`).toString("base64");
15
+ headers.Authorization = `Basic ${encoded}`;
16
+ }
17
+ return headers;
18
+ }
19
+ function trimBaseUrl(url) {
20
+ return url.replace(/\/$/, "");
21
+ }
22
+ function parseBrokerVerificationResult(consumer, provider, json) {
23
+ if (!json || typeof json !== "object") return null;
24
+ const body = json;
25
+ const success = body.success === true || body.success === void 0 && body.result === "success";
26
+ const verifiedAt = typeof body.verifiedAt === "string" ? body.verifiedAt : typeof body.verified_at === "string" ? body.verified_at : typeof body.createdAt === "string" ? body.createdAt : void 0;
27
+ return {
28
+ consumer,
29
+ provider,
30
+ success: !!success,
31
+ verifiedAt
32
+ };
33
+ }
34
+ async function fetchBrokerVerifications(config, pairs) {
35
+ const base = trimBaseUrl(config.baseUrl);
36
+ const headers = authHeaders(config);
37
+ const results = [];
38
+ for (const { consumer, provider } of pairs) {
39
+ const url = `${base}/pacts/provider/${encodeURIComponent(provider)}/consumer/${encodeURIComponent(consumer)}/latest/verification-results`;
40
+ try {
41
+ const res = await fetch(url, { headers });
42
+ if (!res.ok) {
43
+ results.push({
44
+ consumer,
45
+ provider,
46
+ success: false,
47
+ error: `HTTP ${res.status} ${res.statusText}`.trim()
48
+ });
49
+ continue;
50
+ }
51
+ const json = await res.json();
52
+ const parsed = parseBrokerVerificationResult(consumer, provider, json);
53
+ results.push(
54
+ parsed ?? {
55
+ consumer,
56
+ provider,
57
+ success: false,
58
+ error: "Unparseable broker response"
59
+ }
60
+ );
61
+ } catch (error) {
62
+ results.push({
63
+ consumer,
64
+ provider,
65
+ success: false,
66
+ error: error instanceof Error ? error.message : String(error)
67
+ });
68
+ }
69
+ }
70
+ return results;
71
+ }
72
+ function brokerConfigFromEnv() {
73
+ const baseUrl = process.env.PACT_BROKER_BASE_URL;
74
+ if (!baseUrl) return void 0;
75
+ return {
76
+ baseUrl,
77
+ token: process.env.PACT_BROKER_TOKEN,
78
+ username: process.env.PACT_BROKER_USERNAME,
79
+ password: process.env.PACT_BROKER_PASSWORD
80
+ };
81
+ }
82
+
83
+ // src/types.ts
84
+ var LEDGER_ENTRY_SPEC = "autotel-pact-ledger-entry/v0.2.0";
85
+ var AUDIT_MATRIX_SPEC = "autotel-pact-audit-matrix/v0.2.0";
86
+ function isInteractionLedgerEntry(entry) {
87
+ return entry.type !== "provider_verification_run";
88
+ }
89
+ function isProviderVerificationRun(entry) {
90
+ return entry.type === "provider_verification_run";
91
+ }
92
+
93
+ // src/ledger-normalize.ts
94
+ function isRecord(value) {
95
+ return typeof value === "object" && value !== null;
96
+ }
97
+ function normalizeLedgerRecord(parsed) {
98
+ if (!isRecord(parsed) || parsed.spec !== LEDGER_ENTRY_SPEC) return null;
99
+ const { consumer, provider, observed_at } = parsed;
100
+ if (typeof consumer !== "string" || typeof provider !== "string" || typeof observed_at !== "string") {
101
+ return null;
102
+ }
103
+ if (parsed.type === "provider_verification_run") {
104
+ if (typeof parsed.error !== "string") return null;
105
+ const entry2 = {
106
+ type: "provider_verification_run",
107
+ spec: LEDGER_ENTRY_SPEC,
108
+ consumer,
109
+ provider,
110
+ outcome: "failed",
111
+ source: parsed.source === "production" ? "production" : "test",
112
+ role: "provider",
113
+ observed_at,
114
+ error: parsed.error
115
+ };
116
+ if (typeof parsed.run_id === "string") entry2.run_id = parsed.run_id;
117
+ if (typeof parsed.git_sha === "string") entry2.git_sha = parsed.git_sha;
118
+ if (typeof parsed.trace_id === "string") entry2.trace_id = parsed.trace_id;
119
+ if (typeof parsed.span_id === "string") entry2.span_id = parsed.span_id;
120
+ return entry2;
121
+ }
122
+ if (typeof parsed.interaction !== "string") return null;
123
+ const states = Array.isArray(parsed.states) ? parsed.states.filter((s) => typeof s === "string") : [];
124
+ const entry = {
125
+ type: "interaction",
126
+ spec: LEDGER_ENTRY_SPEC,
127
+ consumer,
128
+ provider,
129
+ interaction: parsed.interaction,
130
+ states,
131
+ kind: parsed.kind === "http" ? "http" : "message",
132
+ outcome: parsed.outcome === "failed" ? "failed" : "passed",
133
+ source: parsed.source === "production" ? "production" : "test",
134
+ role: parsed.role === "provider" ? "provider" : "consumer",
135
+ duration_ms: typeof parsed.duration_ms === "number" && parsed.duration_ms >= 0 ? parsed.duration_ms : 0,
136
+ observed_at
137
+ };
138
+ if (typeof parsed.interaction_id === "string" && parsed.interaction_id.length > 0) {
139
+ entry.interaction_id = parsed.interaction_id;
140
+ }
141
+ if (typeof parsed.trace_id === "string") entry.trace_id = parsed.trace_id;
142
+ if (typeof parsed.span_id === "string") entry.span_id = parsed.span_id;
143
+ if (typeof parsed.run_id === "string") entry.run_id = parsed.run_id;
144
+ if (typeof parsed.git_sha === "string") entry.git_sha = parsed.git_sha;
145
+ if (typeof parsed.error === "string") entry.error = parsed.error;
146
+ return entry;
147
+ }
148
+
149
+ // src/ledger.ts
150
+ var DEFAULT_DIR = ".autotel-pact";
151
+ function resolveLedgerDir(opts = {}) {
152
+ return path.resolve(process.cwd(), opts.dir ?? process.env.AUTOTEL_PACT_LEDGER_DIR ?? DEFAULT_DIR);
153
+ }
154
+ function readLedger(opts = {}) {
155
+ const dir = resolveLedgerDir(opts);
156
+ if (!existsSync(dir)) return [];
157
+ const files = readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
158
+ const entries = [];
159
+ for (const file of files) {
160
+ const text = readFileSync(path.join(dir, file), "utf8");
161
+ for (const line of text.split("\n")) {
162
+ if (!line.trim()) continue;
163
+ try {
164
+ const normalized = normalizeLedgerRecord(JSON.parse(line));
165
+ if (normalized) entries.push(normalized);
166
+ } catch {
167
+ }
168
+ }
169
+ }
170
+ return entries;
171
+ }
172
+ Promise.resolve();
173
+ function listPactFiles(dir) {
174
+ if (!existsSync(dir) || !statSync(dir).isDirectory()) return [];
175
+ const out = [];
176
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
177
+ const full = path.join(dir, entry.name);
178
+ if (entry.isDirectory()) {
179
+ out.push(...listPactFiles(full));
180
+ } else if (entry.isFile() && entry.name.endsWith(".json")) {
181
+ out.push(full);
182
+ }
183
+ }
184
+ return out;
185
+ }
186
+ function extractInteractionId(metadata) {
187
+ if (!metadata) return void 0;
188
+ const id = metadata.interactionId ?? metadata.interaction_id;
189
+ return typeof id === "string" && id.length > 0 ? id : void 0;
190
+ }
191
+ function interactionsFromPactFile(pact) {
192
+ const consumer = pact.consumer?.name;
193
+ const provider = pact.provider?.name;
194
+ if (!consumer || !provider) return [];
195
+ const keys = [];
196
+ for (const m of pact.messages ?? []) {
197
+ keys.push({
198
+ consumer,
199
+ provider,
200
+ interaction: m.description,
201
+ kind: "message",
202
+ interactionId: extractInteractionId(m.metadata)
203
+ });
204
+ }
205
+ for (const i of pact.interactions ?? []) {
206
+ keys.push({
207
+ consumer,
208
+ provider,
209
+ interaction: i.description,
210
+ kind: "http",
211
+ interactionId: extractInteractionId(i.metadata)
212
+ });
213
+ }
214
+ return keys;
215
+ }
216
+ function parsePactFile(filePath) {
217
+ try {
218
+ return JSON.parse(readFileSync(filePath, "utf8"));
219
+ } catch {
220
+ return null;
221
+ }
222
+ }
223
+
224
+ // src/audit.ts
225
+ var DEFAULT_PACTS_DIR = "./pacts";
226
+ var DEFAULT_WINDOW_DAYS = 14;
227
+ function keyOf(k) {
228
+ const identity = k.interactionId ?? k.interaction;
229
+ return `${k.consumer}::${k.provider}::${k.kind}::${identity}`;
230
+ }
231
+ function pairKey(consumer, provider) {
232
+ return `${consumer}::${provider}`;
233
+ }
234
+ function inWindow(observedAt, cutoff) {
235
+ const t = Date.parse(observedAt);
236
+ return Number.isFinite(t) && t >= cutoff;
237
+ }
238
+ function computeAuditMatrix(input) {
239
+ const windowDays = input.windowDays ?? DEFAULT_WINDOW_DAYS;
240
+ const now = input.now ?? /* @__PURE__ */ new Date();
241
+ const cutoff = now.getTime() - windowDays * 24 * 60 * 60 * 1e3;
242
+ const verificationFailures = [];
243
+ const recentInteractions = [];
244
+ for (const entry of input.ledger) {
245
+ if (!inWindow(entry.observed_at, cutoff)) continue;
246
+ if (isProviderVerificationRun(entry)) {
247
+ verificationFailures.push(entry);
248
+ continue;
249
+ }
250
+ if (isInteractionLedgerEntry(entry)) {
251
+ recentInteractions.push(entry);
252
+ }
253
+ }
254
+ const brokerByPair = /* @__PURE__ */ new Map();
255
+ for (const b of input.brokerVerifications ?? []) {
256
+ brokerByPair.set(pairKey(b.consumer, b.provider), b);
257
+ }
258
+ const testSeenByKey = /* @__PURE__ */ new Map();
259
+ const prodSeenByKey = /* @__PURE__ */ new Map();
260
+ const providerVerifiedByKey = /* @__PURE__ */ new Map();
261
+ const anyObservedByKey = /* @__PURE__ */ new Map();
262
+ for (const entry of recentInteractions) {
263
+ const k = keyOf({
264
+ consumer: entry.consumer,
265
+ provider: entry.provider,
266
+ interaction: entry.interaction,
267
+ kind: entry.kind,
268
+ interactionId: entry.interaction_id
269
+ });
270
+ const push = (map) => {
271
+ const arr = map.get(k) ?? [];
272
+ arr.push(entry);
273
+ map.set(k, arr);
274
+ };
275
+ push(anyObservedByKey);
276
+ if (entry.source === "test" && entry.role === "consumer") {
277
+ push(testSeenByKey);
278
+ }
279
+ if (entry.source === "production") {
280
+ push(prodSeenByKey);
281
+ }
282
+ if (entry.role === "provider" && entry.outcome === "passed") {
283
+ push(providerVerifiedByKey);
284
+ }
285
+ }
286
+ const contractedByKey = /* @__PURE__ */ new Map();
287
+ for (const c of input.contracted) {
288
+ contractedByKey.set(keyOf(c), c);
289
+ }
290
+ const rows = [];
291
+ function pushRow(parts, k, isContracted) {
292
+ const testObs = testSeenByKey.get(k) ?? [];
293
+ const prodObs = prodSeenByKey.get(k) ?? [];
294
+ const providerObs = providerVerifiedByKey.get(k) ?? [];
295
+ const allObs = anyObservedByKey.get(k) ?? [];
296
+ const latest = allObs.toSorted(
297
+ (a, b) => b.observed_at.localeCompare(a.observed_at)
298
+ )[0];
299
+ const broker = brokerByPair.get(pairKey(parts.consumer, parts.provider));
300
+ rows.push({
301
+ consumer: parts.consumer,
302
+ provider: parts.provider,
303
+ interaction: parts.interaction,
304
+ interaction_id: parts.interactionId ?? latest?.interaction_id,
305
+ kind: parts.kind,
306
+ contracted: isContracted,
307
+ observed: testObs.length > 0 || prodObs.length > 0,
308
+ test_seen: testObs.length > 0,
309
+ prod_seen: prodObs.length > 0,
310
+ provider_verified: providerObs.length > 0,
311
+ broker_verified: broker?.success === true,
312
+ broker_verified_at: broker?.verifiedAt,
313
+ broker_error: broker?.error,
314
+ last_observed_at: latest?.observed_at,
315
+ last_outcome: latest?.outcome
316
+ });
317
+ }
318
+ for (const [k, contracted] of contractedByKey) {
319
+ pushRow(contracted, k, true);
320
+ }
321
+ for (const [k, observations] of anyObservedByKey) {
322
+ if (contractedByKey.has(k)) continue;
323
+ const first = observations[0];
324
+ pushRow(
325
+ {
326
+ consumer: first.consumer,
327
+ provider: first.provider,
328
+ interaction: first.interaction,
329
+ kind: first.kind,
330
+ interactionId: first.interaction_id
331
+ },
332
+ k,
333
+ false
334
+ );
335
+ }
336
+ rows.sort(
337
+ (a, b) => a.consumer.localeCompare(b.consumer) || a.provider.localeCompare(b.provider) || a.interaction.localeCompare(b.interaction)
338
+ );
339
+ const counts = {
340
+ total: rows.length,
341
+ contracted: rows.filter((r) => r.contracted).length,
342
+ observed: rows.filter((r) => r.observed).length,
343
+ contracted_and_test_seen: rows.filter((r) => r.contracted && r.test_seen).length,
344
+ contracted_not_test_seen: rows.filter((r) => r.contracted && !r.test_seen).length,
345
+ test_or_prod_seen_not_contracted: rows.filter(
346
+ (r) => !r.contracted && (r.test_seen || r.prod_seen)
347
+ ).length,
348
+ test_seen: rows.filter((r) => r.test_seen).length,
349
+ prod_seen: rows.filter((r) => r.prod_seen).length,
350
+ provider_verified: rows.filter((r) => r.provider_verified).length,
351
+ broker_verified: rows.filter((r) => r.broker_verified).length
352
+ };
353
+ const matrix = {
354
+ spec: AUDIT_MATRIX_SPEC,
355
+ rows,
356
+ counts,
357
+ window_days: windowDays,
358
+ generated_at: now.toISOString()
359
+ };
360
+ if (verificationFailures.length > 0) {
361
+ matrix.verification_failures = verificationFailures;
362
+ }
363
+ return matrix;
364
+ }
365
+ async function runAudit(opts = {}) {
366
+ const pactsDir = path.resolve(process.cwd(), opts.pactsDir ?? DEFAULT_PACTS_DIR);
367
+ const contracted = [];
368
+ const pairs = /* @__PURE__ */ new Set();
369
+ for (const file of listPactFiles(pactsDir)) {
370
+ const pact = parsePactFile(file);
371
+ if (!pact) continue;
372
+ const interactions = interactionsFromPactFile(pact);
373
+ contracted.push(...interactions);
374
+ const consumer = pact.consumer?.name;
375
+ const provider = pact.provider?.name;
376
+ if (consumer && provider) {
377
+ pairs.add(pairKey(consumer, provider));
378
+ }
379
+ }
380
+ const ledger = readLedger(opts);
381
+ let brokerVerifications;
382
+ if (opts.broker) {
383
+ brokerVerifications = await fetchBrokerVerifications(opts.broker, [...pairs].map((p) => {
384
+ const [consumer, provider] = p.split("::");
385
+ return { consumer, provider };
386
+ }));
387
+ }
388
+ return computeAuditMatrix({
389
+ contracted,
390
+ ledger,
391
+ brokerVerifications,
392
+ windowDays: opts.windowDays
393
+ });
394
+ }
395
+
396
+ // src/labels.ts
397
+ var CLI_COLUMNS = {
398
+ STATUS: "STATUS",
399
+ CONTRACTED: "CONTRACTED",
400
+ TEST_SEEN: "TEST_SEEN",
401
+ PROD_SEEN: "PROD_SEEN",
402
+ PROVIDER_VERIFIED: "PROVIDER_VERIFIED",
403
+ BROKER_VERIFIED: "BROKER_VERIFIED",
404
+ PAIR: "CONSUMER \u2192 PROVIDER",
405
+ KIND: "KIND",
406
+ INTERACTION: "INTERACTION"
407
+ };
408
+ function formatYesNo(value) {
409
+ return value ? "yes" : "no";
410
+ }
411
+
412
+ // src/cli.ts
413
+ var HELP_TEXT = `autotel-pact audit \u2014 runtime evidence for Pact contracts
414
+
415
+ USAGE
416
+ autotel-pact audit [options]
417
+
418
+ OPTIONS
419
+ --pacts <dir> Directory containing pact files (default: ./pacts)
420
+ --ledger <dir> Directory containing ledger files (default: .autotel-pact)
421
+ --window <days> How many days back to consider observations recent (default: 14)
422
+ --gate Exit non-zero if any contracted interaction was not seen in test
423
+ --gate=strict Also exit non-zero on observations with no matching contract
424
+ --gate=broker Exit non-zero if broker is configured and any row lacks broker verification
425
+ --broker-url <url> Pact Broker base URL (or PACT_BROKER_BASE_URL)
426
+ --broker-token <tok> Pact Broker bearer token (or PACT_BROKER_TOKEN)
427
+ --json Emit machine-readable JSON instead of a table
428
+ --help, -h Show this help
429
+
430
+ ENVIRONMENT
431
+ AUTOTEL_PACT_RUN_ID Tag ledger entries with a run id
432
+ AUTOTEL_PACT_LEDGER_DIR Override default ledger directory
433
+ PACT_BROKER_BASE_URL Broker base URL
434
+ PACT_BROKER_TOKEN Broker bearer token
435
+ PACT_BROKER_USERNAME Broker basic auth username
436
+ PACT_BROKER_PASSWORD Broker basic auth password
437
+ `;
438
+ function parseDuration(value) {
439
+ const m = /^(\d+)(d?)$/.exec(value);
440
+ if (!m) throw new Error(`Invalid --window value: ${value}`);
441
+ return Number.parseInt(m[1], 10);
442
+ }
443
+ function requireValue(argv, i, flag) {
444
+ const value = argv[i];
445
+ if (value === void 0 || value.startsWith("--")) {
446
+ throw new Error(`Missing value for ${flag}`);
447
+ }
448
+ return value;
449
+ }
450
+ function parseArgs(argv) {
451
+ const args = { gate: "off", json: false, help: false };
452
+ for (let i = 0; i < argv.length; i++) {
453
+ const a = argv[i];
454
+ switch (a) {
455
+ case "--help":
456
+ case "-h": {
457
+ args.help = true;
458
+ break;
459
+ }
460
+ case "--json": {
461
+ args.json = true;
462
+ break;
463
+ }
464
+ case "--gate": {
465
+ args.gate = "on";
466
+ break;
467
+ }
468
+ case "--gate=strict": {
469
+ args.gate = "strict";
470
+ break;
471
+ }
472
+ case "--gate=broker": {
473
+ args.gate = "broker";
474
+ break;
475
+ }
476
+ case "--pacts": {
477
+ args.pactsDir = requireValue(argv, ++i, "--pacts");
478
+ break;
479
+ }
480
+ case "--ledger": {
481
+ args.ledgerDir = requireValue(argv, ++i, "--ledger");
482
+ break;
483
+ }
484
+ case "--window": {
485
+ args.windowDays = parseDuration(requireValue(argv, ++i, "--window"));
486
+ break;
487
+ }
488
+ case "--broker-url": {
489
+ args.brokerUrl = requireValue(argv, ++i, "--broker-url");
490
+ break;
491
+ }
492
+ case "--broker-token": {
493
+ args.brokerToken = requireValue(argv, ++i, "--broker-token");
494
+ break;
495
+ }
496
+ default: {
497
+ if (a.startsWith("--pacts=")) {
498
+ const value = a.slice("--pacts=".length);
499
+ if (!value) throw new Error("Missing value for --pacts");
500
+ args.pactsDir = value;
501
+ } else if (a.startsWith("--ledger=")) {
502
+ const value = a.slice("--ledger=".length);
503
+ if (!value) throw new Error("Missing value for --ledger");
504
+ args.ledgerDir = value;
505
+ } else if (a.startsWith("--window=")) {
506
+ const value = a.slice("--window=".length);
507
+ if (!value) throw new Error("Missing value for --window");
508
+ args.windowDays = parseDuration(value);
509
+ } else if (a.startsWith("--broker-url=")) {
510
+ const value = a.slice("--broker-url=".length);
511
+ if (!value) throw new Error("Missing value for --broker-url");
512
+ args.brokerUrl = value;
513
+ } else if (a.startsWith("--broker-token=")) {
514
+ const value = a.slice("--broker-token=".length);
515
+ if (!value) throw new Error("Missing value for --broker-token");
516
+ args.brokerToken = value;
517
+ } else if (a === "audit") continue;
518
+ else throw new Error(`Unknown argument: ${a}`);
519
+ }
520
+ }
521
+ }
522
+ return args;
523
+ }
524
+ function statusLabel(r) {
525
+ if (r.contracted && r.test_seen) return "OK";
526
+ if (r.contracted && !r.test_seen) return "STALE";
527
+ return "SHADOW";
528
+ }
529
+ function formatTable(matrix) {
530
+ const lines = [
531
+ `Window: last ${matrix.window_days} day(s)`,
532
+ `Generated: ${matrix.generated_at}`,
533
+ ""
534
+ ];
535
+ if (matrix.rows.length === 0) {
536
+ lines.push("No contracts or observations found.");
537
+ return lines.join("\n");
538
+ }
539
+ const header = [
540
+ CLI_COLUMNS.STATUS,
541
+ CLI_COLUMNS.CONTRACTED,
542
+ CLI_COLUMNS.TEST_SEEN,
543
+ CLI_COLUMNS.PROD_SEEN,
544
+ CLI_COLUMNS.PROVIDER_VERIFIED,
545
+ CLI_COLUMNS.BROKER_VERIFIED,
546
+ CLI_COLUMNS.PAIR,
547
+ CLI_COLUMNS.KIND,
548
+ CLI_COLUMNS.INTERACTION
549
+ ];
550
+ const rows = matrix.rows.map((r) => [
551
+ statusLabel(r),
552
+ formatYesNo(r.contracted),
553
+ formatYesNo(r.test_seen),
554
+ formatYesNo(r.prod_seen),
555
+ formatYesNo(r.provider_verified),
556
+ formatYesNo(r.broker_verified),
557
+ `${r.consumer} \u2192 ${r.provider}`,
558
+ r.kind,
559
+ r.interaction
560
+ ]);
561
+ const widths = header.map(
562
+ (h, i) => Math.max(h.length, ...rows.map((row) => row[i].length))
563
+ );
564
+ const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join(" ");
565
+ lines.push(
566
+ fmt(header),
567
+ widths.map((w) => "\u2500".repeat(w)).join(" "),
568
+ ...rows.map((r) => fmt(r)),
569
+ "",
570
+ "Summary",
571
+ ` Total interactions: ${matrix.counts.total}`,
572
+ ` Contracted: ${matrix.counts.contracted}`,
573
+ ` Seen in test: ${matrix.counts.test_seen}`,
574
+ ` Seen in production: ${matrix.counts.prod_seen}`,
575
+ ` Provider verified (interaction): ${matrix.counts.provider_verified}`,
576
+ ` Broker verified (pact-pair): ${matrix.counts.broker_verified}`,
577
+ ` Contracted AND seen in test: ${matrix.counts.contracted_and_test_seen}`,
578
+ ` Contracted, NOT seen in test: ${matrix.counts.contracted_not_test_seen} \u2190 stale confidence`,
579
+ ` Seen, NOT contracted: ${matrix.counts.test_or_prod_seen_not_contracted} \u2190 ungoverned flow`
580
+ );
581
+ if (matrix.verification_failures && matrix.verification_failures.length > 0) {
582
+ lines.push("", "Provider verification failures (run-level):");
583
+ for (const f of matrix.verification_failures) {
584
+ lines.push(` ${f.consumer} \u2192 ${f.provider}: ${f.error}`);
585
+ }
586
+ }
587
+ const brokerErrors = /* @__PURE__ */ new Map();
588
+ for (const r of matrix.rows) {
589
+ if (r.broker_error) {
590
+ brokerErrors.set(`${r.consumer} \u2192 ${r.provider}`, r.broker_error);
591
+ }
592
+ }
593
+ if (brokerErrors.size > 0) {
594
+ lines.push("", "Broker unreachable / errored (verification status unknown):");
595
+ for (const [pair, err] of brokerErrors) {
596
+ lines.push(` ${pair}: ${err}`);
597
+ }
598
+ }
599
+ return lines.join("\n");
600
+ }
601
+ function shouldFail(matrix, gate) {
602
+ if (gate === "off") return false;
603
+ if (matrix.counts.contracted_not_test_seen > 0) return true;
604
+ if (gate === "strict" && matrix.counts.test_or_prod_seen_not_contracted > 0) return true;
605
+ if (gate === "broker") {
606
+ const contractedRows = matrix.rows.filter((r) => r.contracted);
607
+ if (contractedRows.some((r) => r.broker_error)) return true;
608
+ if (contractedRows.some((r) => !r.broker_verified)) return true;
609
+ }
610
+ return false;
611
+ }
612
+ async function main(argv) {
613
+ let args;
614
+ try {
615
+ args = parseArgs(argv);
616
+ } catch (error) {
617
+ process.stderr.write(`${error.message}
618
+
619
+ ${HELP_TEXT}`);
620
+ return 2;
621
+ }
622
+ if (args.help) {
623
+ process.stdout.write(HELP_TEXT);
624
+ return 0;
625
+ }
626
+ const envBroker = brokerConfigFromEnv();
627
+ const broker = args.brokerUrl || envBroker ? {
628
+ baseUrl: args.brokerUrl ?? envBroker.baseUrl,
629
+ token: args.brokerToken ?? envBroker?.token,
630
+ username: envBroker?.username,
631
+ password: envBroker?.password
632
+ } : void 0;
633
+ const matrix = await runAudit({
634
+ pactsDir: args.pactsDir,
635
+ dir: args.ledgerDir,
636
+ windowDays: args.windowDays,
637
+ broker
638
+ });
639
+ if (args.json) {
640
+ process.stdout.write(JSON.stringify(matrix, null, 2) + "\n");
641
+ } else {
642
+ process.stdout.write(formatTable(matrix) + "\n");
643
+ }
644
+ return shouldFail(matrix, args.gate) ? 1 : 0;
645
+ }
646
+ var isDirectInvocation = typeof process !== "undefined" && process.argv[1] && (process.argv[1].endsWith("cli.js") || process.argv[1].endsWith("autotel-pact"));
647
+ if (isDirectInvocation) {
648
+ main(process.argv.slice(2)).then((code) => process.exit(code)).catch((error) => {
649
+ console.error(error);
650
+ process.exit(1);
651
+ });
652
+ }
653
+
654
+ export { main };
655
+ //# sourceMappingURL=cli.js.map
656
+ //# sourceMappingURL=cli.js.map