@apexops/renderers 0.10.0-next.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.
- package/dist/.tsbuildinfo +1 -0
- package/dist/document-registry.d.ts +17 -0
- package/dist/document-registry.d.ts.map +1 -0
- package/dist/document-registry.js +138 -0
- package/dist/document-registry.js.map +1 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +6 -0
- package/dist/index.js.map +1 -0
- package/dist/markdown.d.ts +5 -0
- package/dist/markdown.d.ts.map +1 -0
- package/dist/markdown.js +30 -0
- package/dist/markdown.js.map +1 -0
- package/dist/renderers.d.ts +7 -0
- package/dist/renderers.d.ts.map +1 -0
- package/dist/renderers.js +154 -0
- package/dist/renderers.js.map +1 -0
- package/dist/scorecard.d.ts +19 -0
- package/dist/scorecard.d.ts.map +1 -0
- package/dist/scorecard.js +70 -0
- package/dist/scorecard.js.map +1 -0
- package/dist/semantic-diff.d.ts +17 -0
- package/dist/semantic-diff.d.ts.map +1 -0
- package/dist/semantic-diff.js +80 -0
- package/dist/semantic-diff.js.map +1 -0
- package/dist/test/renderers.test.d.ts +2 -0
- package/dist/test/renderers.test.d.ts.map +1 -0
- package/dist/test/renderers.test.js +182 -0
- package/dist/test/renderers.test.js.map +1 -0
- package/dist/test/scorecard.test.d.ts +2 -0
- package/dist/test/scorecard.test.d.ts.map +1 -0
- package/dist/test/scorecard.test.js +129 -0
- package/dist/test/scorecard.test.js.map +1 -0
- package/dist/test/semantic-diff.test.d.ts +2 -0
- package/dist/test/semantic-diff.test.d.ts.map +1 -0
- package/dist/test/semantic-diff.test.js +19 -0
- package/dist/test/semantic-diff.test.js.map +1 -0
- package/package.json +38 -0
package/dist/markdown.js
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
export function escapeMarkdown(value) {
|
|
2
|
+
const text = value === null ? "null" : String(value);
|
|
3
|
+
return text
|
|
4
|
+
.replace(/[\u0000-\u0009\u000b\u000c\u000e-\u001f\u007f]/g, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`)
|
|
5
|
+
.replace(/\r\n?|\n/g, "<br>")
|
|
6
|
+
.replace(/\\/g, "\\\\")
|
|
7
|
+
.replace(/\|/g, "\\|");
|
|
8
|
+
}
|
|
9
|
+
export function markdownTable(headers, rows) {
|
|
10
|
+
const header = `| ${headers.map(escapeMarkdown).join(" | ")} |`;
|
|
11
|
+
const separator = `| ${headers.map(() => "---").join(" | ")} |`;
|
|
12
|
+
const body = rows.map((row) => `| ${row.map(escapeMarkdown).join(" | ")} |`);
|
|
13
|
+
return [header, separator, ...body].join("\n");
|
|
14
|
+
}
|
|
15
|
+
export function stableJson(value) {
|
|
16
|
+
if (value === null || typeof value !== "object") {
|
|
17
|
+
const encoded = JSON.stringify(value);
|
|
18
|
+
return encoded === undefined ? "null" : encoded;
|
|
19
|
+
}
|
|
20
|
+
if (Array.isArray(value))
|
|
21
|
+
return `[${value.map(stableJson).join(",")}]`;
|
|
22
|
+
const entries = Object.entries(value)
|
|
23
|
+
.filter(([, item]) => item !== undefined)
|
|
24
|
+
.sort(([left], [right]) => left.localeCompare(right));
|
|
25
|
+
return `{${entries.map(([key, item]) => `${JSON.stringify(key)}:${stableJson(item)}`).join(",")}}`;
|
|
26
|
+
}
|
|
27
|
+
export function optional(value) {
|
|
28
|
+
return value === undefined ? "-" : String(value);
|
|
29
|
+
}
|
|
30
|
+
//# sourceMappingURL=markdown.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrD,OAAO,IAAI;SACR,OAAO,CACN,iDAAiD,EACjD,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC7E;SACA,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC;SAC5B,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA0B,EAAE,IAAqC;IAC7F,MAAM,MAAM,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAChE,MAAM,SAAS,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtC,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAClD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAA0C,CAAC;SACvE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;SACxC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { ApprovalEvidenceV1, DeploymentPreviewV1, RequirementsV1, ResourceInventoryV1, RunConfigV1 } from "@apexops/contracts";
|
|
2
|
+
export declare function renderRequirements(requirements: RequirementsV1): string;
|
|
3
|
+
export declare function renderRunStatus(run: RunConfigV1): string;
|
|
4
|
+
export declare function renderDeploymentPreview(preview: DeploymentPreviewV1): string;
|
|
5
|
+
export declare function renderApprovalEvidence(approval: ApprovalEvidenceV1): string;
|
|
6
|
+
export declare function renderResourceInventory(inventory: ResourceInventoryV1): string;
|
|
7
|
+
//# sourceMappingURL=renderers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../src/renderers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAS5B,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,cAAc,GAAG,MAAM,CA2BvE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CA6BxD;AAMD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAwC5E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAqB3E;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM,CA4B9E"}
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
import { escapeMarkdown, markdownTable, optional, stableJson } from "./markdown.js";
|
|
2
|
+
const compareText = (left, right) => left.localeCompare(right);
|
|
3
|
+
function fieldList(fields) {
|
|
4
|
+
return fields.map(([label, value]) => `- **${label}:** ${escapeMarkdown(value)}`).join("\n");
|
|
5
|
+
}
|
|
6
|
+
export function renderRequirements(requirements) {
|
|
7
|
+
const rows = [...requirements.requirements]
|
|
8
|
+
.sort((left, right) => compareText(left.id, right.id))
|
|
9
|
+
.map((item) => [item.id, item.priority, item.status, item.statement, item.source]);
|
|
10
|
+
const assumptions = [...requirements.assumptions].sort(compareText);
|
|
11
|
+
const unknowns = [...requirements.unknowns].sort(compareText);
|
|
12
|
+
return [
|
|
13
|
+
"# Requirements",
|
|
14
|
+
"",
|
|
15
|
+
fieldList([
|
|
16
|
+
["Project", requirements.projectId],
|
|
17
|
+
["Environment", requirements.environment],
|
|
18
|
+
["Workload", requirements.workload],
|
|
19
|
+
]),
|
|
20
|
+
"",
|
|
21
|
+
"## Requirements",
|
|
22
|
+
"",
|
|
23
|
+
markdownTable(["ID", "Priority", "Status", "Statement", "Source"], rows),
|
|
24
|
+
"",
|
|
25
|
+
"## Assumptions",
|
|
26
|
+
"",
|
|
27
|
+
assumptions.length === 0 ? "None." : assumptions.map((item) => `- ${escapeMarkdown(item)}`).join("\n"),
|
|
28
|
+
"",
|
|
29
|
+
"## Unknowns",
|
|
30
|
+
"",
|
|
31
|
+
unknowns.length === 0 ? "None." : unknowns.map((item) => `- ${escapeMarkdown(item)}`).join("\n"),
|
|
32
|
+
].join("\n");
|
|
33
|
+
}
|
|
34
|
+
export function renderRunStatus(run) {
|
|
35
|
+
const gates = [...run.gates]
|
|
36
|
+
.sort((left, right) => left.gate - right.gate)
|
|
37
|
+
.map((gate) => [
|
|
38
|
+
gate.gate,
|
|
39
|
+
gate.state,
|
|
40
|
+
gate.state === "inherited" ? optional(gate.inheritedFromRunId) : "-",
|
|
41
|
+
optional(gate.decidedAt),
|
|
42
|
+
optional(gate.reason),
|
|
43
|
+
gate.dependencyHash,
|
|
44
|
+
]);
|
|
45
|
+
return [
|
|
46
|
+
"# Run Status",
|
|
47
|
+
"",
|
|
48
|
+
fieldList([
|
|
49
|
+
["Project", run.projectId],
|
|
50
|
+
["Run", run.runId],
|
|
51
|
+
["Environment", run.environment],
|
|
52
|
+
["Target scope", run.targetScope],
|
|
53
|
+
["IaC tool", run.iacTool],
|
|
54
|
+
["Parent run", optional(run.parentRunId)],
|
|
55
|
+
["Owner epoch", run.ownerEpoch],
|
|
56
|
+
["Created", run.createdAt],
|
|
57
|
+
]),
|
|
58
|
+
"",
|
|
59
|
+
"## Gates",
|
|
60
|
+
"",
|
|
61
|
+
markdownTable(["Gate", "State", "Inherited From", "Decided", "Reason", "Dependency Hash"], gates),
|
|
62
|
+
].join("\n");
|
|
63
|
+
}
|
|
64
|
+
function previewAction(action) {
|
|
65
|
+
return action === "delete" || action === "replace" ? `**${action.toUpperCase()}**` : action;
|
|
66
|
+
}
|
|
67
|
+
export function renderDeploymentPreview(preview) {
|
|
68
|
+
const changes = [...preview.changes]
|
|
69
|
+
.sort((left, right) => compareText(`${left.resourceId}\u0000${left.action}`, `${right.resourceId}\u0000${right.action}`))
|
|
70
|
+
.map((change) => [
|
|
71
|
+
change.resourceId,
|
|
72
|
+
previewAction(change.action),
|
|
73
|
+
change.material ? "yes" : "no",
|
|
74
|
+
optional(change.details),
|
|
75
|
+
]);
|
|
76
|
+
const blockers = [...preview.blockers].sort(compareText);
|
|
77
|
+
const destructive = preview.operation === "destroy" ||
|
|
78
|
+
preview.changes.some(({ action }) => action === "delete" || action === "replace");
|
|
79
|
+
return [
|
|
80
|
+
"# Deployment Preview",
|
|
81
|
+
"",
|
|
82
|
+
destructive ? "> **DESTRUCTIVE CHANGES PRESENT**" : "> No destructive changes detected.",
|
|
83
|
+
"",
|
|
84
|
+
fieldList([
|
|
85
|
+
["Project", preview.projectId],
|
|
86
|
+
["Run", preview.runId],
|
|
87
|
+
["Environment", preview.environment],
|
|
88
|
+
["Track", preview.track],
|
|
89
|
+
["Operation", preview.operation],
|
|
90
|
+
["Target", preview.target],
|
|
91
|
+
["Created", preview.createdAt],
|
|
92
|
+
["Expires", preview.expiresAt],
|
|
93
|
+
["Preview hash", preview.previewHash],
|
|
94
|
+
]),
|
|
95
|
+
"",
|
|
96
|
+
"## Blockers",
|
|
97
|
+
"",
|
|
98
|
+
blockers.length === 0 ? "None." : blockers.map((blocker) => `- **BLOCKED:** ${escapeMarkdown(blocker)}`).join("\n"),
|
|
99
|
+
"",
|
|
100
|
+
"## Semantic Changes",
|
|
101
|
+
"",
|
|
102
|
+
changes.length === 0 ? "No changes." : markdownTable(["Resource", "Action", "Material", "Details"], changes),
|
|
103
|
+
].join("\n");
|
|
104
|
+
}
|
|
105
|
+
export function renderApprovalEvidence(approval) {
|
|
106
|
+
const summary = [
|
|
107
|
+
"# Approval Evidence",
|
|
108
|
+
"",
|
|
109
|
+
fieldList([
|
|
110
|
+
["Project", approval.projectId],
|
|
111
|
+
["Run", approval.runId],
|
|
112
|
+
["Gate", approval.gate],
|
|
113
|
+
["Decision", approval.decision.toUpperCase()],
|
|
114
|
+
["Actor", approval.actor],
|
|
115
|
+
["Mechanism", approval.mechanism],
|
|
116
|
+
["Recipient identity", optional(approval.recipientIdentity)],
|
|
117
|
+
["Writer transfer claim hash", optional(approval.writerTransferClaimHash)],
|
|
118
|
+
["Writer epoch", approval.writerEpoch],
|
|
119
|
+
["Dependency hash", approval.dependencyHash],
|
|
120
|
+
["Preview hash", optional(approval.previewHash)],
|
|
121
|
+
["Decided", approval.decidedAt],
|
|
122
|
+
["Expires", optional(approval.expiresAt)],
|
|
123
|
+
]),
|
|
124
|
+
];
|
|
125
|
+
return summary.join("\n");
|
|
126
|
+
}
|
|
127
|
+
export function renderResourceInventory(inventory) {
|
|
128
|
+
const rows = [...inventory.resources]
|
|
129
|
+
.sort((left, right) => compareText(`${left.logicalId}\u0000${left.resourceId}`, `${right.logicalId}\u0000${right.resourceId}`))
|
|
130
|
+
.map((resource) => [
|
|
131
|
+
resource.logicalId,
|
|
132
|
+
resource.resourceId,
|
|
133
|
+
resource.type,
|
|
134
|
+
resource.location,
|
|
135
|
+
stableJson(resource.properties),
|
|
136
|
+
]);
|
|
137
|
+
return [
|
|
138
|
+
"# Resource Inventory",
|
|
139
|
+
"",
|
|
140
|
+
fieldList([
|
|
141
|
+
["Project", inventory.projectId],
|
|
142
|
+
["Run", inventory.runId],
|
|
143
|
+
["Deployment hash", inventory.deploymentHash],
|
|
144
|
+
["Collected", inventory.collectedAt],
|
|
145
|
+
]),
|
|
146
|
+
"",
|
|
147
|
+
"## Resources",
|
|
148
|
+
"",
|
|
149
|
+
rows.length === 0
|
|
150
|
+
? "No resources."
|
|
151
|
+
: markdownTable(["Logical ID", "Resource ID", "Type", "Location", "Properties"], rows),
|
|
152
|
+
].join("\n");
|
|
153
|
+
}
|
|
154
|
+
//# sourceMappingURL=renderers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"renderers.js","sourceRoot":"","sources":["../src/renderers.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { QualityScorecardV1 } from "@apexops/contracts";
|
|
2
|
+
export interface ScorecardMeasurement {
|
|
3
|
+
readonly metric: string;
|
|
4
|
+
readonly scenario: string;
|
|
5
|
+
readonly value?: number;
|
|
6
|
+
readonly samples: number;
|
|
7
|
+
}
|
|
8
|
+
export type ScorecardDecision = "pass" | "fail" | "omitted";
|
|
9
|
+
export interface ScorecardEvaluation {
|
|
10
|
+
readonly metric: string;
|
|
11
|
+
readonly scenario: string;
|
|
12
|
+
readonly decision: ScorecardDecision;
|
|
13
|
+
readonly value?: number;
|
|
14
|
+
readonly samples: number;
|
|
15
|
+
readonly reason: string;
|
|
16
|
+
}
|
|
17
|
+
export declare function evaluateQualityScorecard(scorecard: QualityScorecardV1, measurements: readonly ScorecardMeasurement[]): readonly ScorecardEvaluation[];
|
|
18
|
+
export declare function renderQualityScorecardEvaluation(scorecard: QualityScorecardV1, measurements: readonly ScorecardMeasurement[]): string;
|
|
19
|
+
//# sourceMappingURL=scorecard.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scorecard.d.ts","sourceRoot":"","sources":["../src/scorecard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAMD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,kBAAkB,EAC7B,YAAY,EAAE,SAAS,oBAAoB,EAAE,GAC5C,SAAS,mBAAmB,EAAE,CA0ChC;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,kBAAkB,EAC7B,YAAY,EAAE,SAAS,oBAAoB,EAAE,GAC5C,MAAM,CA2BR"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { markdownTable, optional } from "./markdown.js";
|
|
2
|
+
function unavailableDecision(unavailable) {
|
|
3
|
+
return unavailable === "block" ? "fail" : "omitted";
|
|
4
|
+
}
|
|
5
|
+
export function evaluateQualityScorecard(scorecard, measurements) {
|
|
6
|
+
const indexed = new Map(measurements.map((item) => [`${item.metric}\u0000${item.scenario}`, item]));
|
|
7
|
+
return [...scorecard.rules]
|
|
8
|
+
.sort((left, right) => `${left.metric}\u0000${left.scenario}`.localeCompare(`${right.metric}\u0000${right.scenario}`))
|
|
9
|
+
.map((rule) => {
|
|
10
|
+
const measurement = indexed.get(`${rule.metric}\u0000${rule.scenario}`);
|
|
11
|
+
if (measurement === undefined || measurement.value === undefined || !Number.isFinite(measurement.value)) {
|
|
12
|
+
return {
|
|
13
|
+
metric: rule.metric,
|
|
14
|
+
scenario: rule.scenario,
|
|
15
|
+
decision: unavailableDecision(rule.unavailable),
|
|
16
|
+
samples: measurement?.samples ?? 0,
|
|
17
|
+
reason: "measurement unavailable",
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
if (measurement.samples < rule.minimumSamples) {
|
|
21
|
+
return {
|
|
22
|
+
metric: rule.metric,
|
|
23
|
+
scenario: rule.scenario,
|
|
24
|
+
decision: unavailableDecision(rule.unavailable),
|
|
25
|
+
value: measurement.value,
|
|
26
|
+
samples: measurement.samples,
|
|
27
|
+
reason: `requires at least ${rule.minimumSamples} samples`,
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
const passed = rule.direction === "min"
|
|
31
|
+
? measurement.value >= rule.target - rule.tolerance
|
|
32
|
+
: rule.direction === "max"
|
|
33
|
+
? measurement.value <= rule.target + rule.tolerance
|
|
34
|
+
: Math.abs(measurement.value - rule.target) <= rule.tolerance;
|
|
35
|
+
return {
|
|
36
|
+
metric: rule.metric,
|
|
37
|
+
scenario: rule.scenario,
|
|
38
|
+
decision: passed ? "pass" : "fail",
|
|
39
|
+
value: measurement.value,
|
|
40
|
+
samples: measurement.samples,
|
|
41
|
+
reason: passed ? "target satisfied" : "target not satisfied",
|
|
42
|
+
};
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
export function renderQualityScorecardEvaluation(scorecard, measurements) {
|
|
46
|
+
const evaluations = evaluateQualityScorecard(scorecard, measurements);
|
|
47
|
+
const rules = new Map(scorecard.rules.map((rule) => [`${rule.metric}\u0000${rule.scenario}`, rule]));
|
|
48
|
+
const rows = evaluations.map((evaluation) => {
|
|
49
|
+
const rule = rules.get(`${evaluation.metric}\u0000${evaluation.scenario}`);
|
|
50
|
+
return [
|
|
51
|
+
evaluation.metric,
|
|
52
|
+
evaluation.scenario,
|
|
53
|
+
rule.direction,
|
|
54
|
+
rule.target,
|
|
55
|
+
rule.tolerance,
|
|
56
|
+
optional(evaluation.value),
|
|
57
|
+
`${evaluation.samples}/${rule.minimumSamples}`,
|
|
58
|
+
evaluation.decision.toUpperCase(),
|
|
59
|
+
evaluation.reason,
|
|
60
|
+
];
|
|
61
|
+
});
|
|
62
|
+
return [
|
|
63
|
+
"# Quality Scorecard Evaluation",
|
|
64
|
+
"",
|
|
65
|
+
`- **Frozen at:** ${scorecard.frozenAt}`,
|
|
66
|
+
"",
|
|
67
|
+
markdownTable(["Metric", "Scenario", "Direction", "Target", "Tolerance", "Value", "Samples", "Decision", "Reason"], rows),
|
|
68
|
+
].join("\n");
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=scorecard.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scorecard.js","sourceRoot":"","sources":["../src/scorecard.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export type JsonPrimitive = boolean | number | string | null;
|
|
2
|
+
export type JsonValue = JsonPrimitive | JsonValue[] | {
|
|
3
|
+
readonly [key: string]: JsonValue;
|
|
4
|
+
};
|
|
5
|
+
export interface SemanticDiffChange {
|
|
6
|
+
readonly path: string;
|
|
7
|
+
readonly before: JsonValue;
|
|
8
|
+
readonly after: JsonValue;
|
|
9
|
+
}
|
|
10
|
+
export interface SemanticDiffResult {
|
|
11
|
+
readonly added: readonly string[];
|
|
12
|
+
readonly removed: readonly string[];
|
|
13
|
+
readonly changed: readonly SemanticDiffChange[];
|
|
14
|
+
}
|
|
15
|
+
export declare function semanticDiff(before: JsonValue, after: JsonValue): SemanticDiffResult;
|
|
16
|
+
export declare function renderSemanticDiff(diff: SemanticDiffResult): string;
|
|
17
|
+
//# sourceMappingURL=semantic-diff.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"semantic-diff.d.ts","sourceRoot":"","sources":["../src/semantic-diff.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE5F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACjD;AA2BD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,kBAAkB,CAuCpF;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CASnE"}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { markdownTable } from "./markdown.js";
|
|
2
|
+
function pointerSegment(segment) {
|
|
3
|
+
return segment.replace(/~/g, "~0").replace(/\//g, "~1");
|
|
4
|
+
}
|
|
5
|
+
function childPath(path, segment) {
|
|
6
|
+
return `${path}/${pointerSegment(segment)}`;
|
|
7
|
+
}
|
|
8
|
+
function isObject(value) {
|
|
9
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
10
|
+
}
|
|
11
|
+
function collectLeafPaths(value, path) {
|
|
12
|
+
if (Array.isArray(value)) {
|
|
13
|
+
return value.length === 0
|
|
14
|
+
? [path]
|
|
15
|
+
: value.flatMap((item, index) => collectLeafPaths(item, childPath(path, String(index))));
|
|
16
|
+
}
|
|
17
|
+
if (isObject(value)) {
|
|
18
|
+
const keys = Object.keys(value).sort();
|
|
19
|
+
return keys.length === 0 ? [path] : keys.flatMap((key) => collectLeafPaths(value[key], childPath(path, key)));
|
|
20
|
+
}
|
|
21
|
+
return [path];
|
|
22
|
+
}
|
|
23
|
+
export function semanticDiff(before, after) {
|
|
24
|
+
const added = [];
|
|
25
|
+
const removed = [];
|
|
26
|
+
const changed = [];
|
|
27
|
+
function visit(left, right, path) {
|
|
28
|
+
if (Object.is(left, right))
|
|
29
|
+
return;
|
|
30
|
+
if (Array.isArray(left) && Array.isArray(right)) {
|
|
31
|
+
const sharedLength = Math.min(left.length, right.length);
|
|
32
|
+
for (let index = 0; index < sharedLength; index += 1) {
|
|
33
|
+
visit(left[index], right[index], childPath(path, String(index)));
|
|
34
|
+
}
|
|
35
|
+
for (let index = sharedLength; index < left.length; index += 1) {
|
|
36
|
+
removed.push(...collectLeafPaths(left[index], childPath(path, String(index))));
|
|
37
|
+
}
|
|
38
|
+
for (let index = sharedLength; index < right.length; index += 1) {
|
|
39
|
+
added.push(...collectLeafPaths(right[index], childPath(path, String(index))));
|
|
40
|
+
}
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
if (isObject(left) && isObject(right)) {
|
|
44
|
+
const keys = [...new Set([...Object.keys(left), ...Object.keys(right)])].sort();
|
|
45
|
+
for (const key of keys) {
|
|
46
|
+
const nextPath = childPath(path, key);
|
|
47
|
+
if (!(key in left))
|
|
48
|
+
added.push(...collectLeafPaths(right[key], nextPath));
|
|
49
|
+
else if (!(key in right))
|
|
50
|
+
removed.push(...collectLeafPaths(left[key], nextPath));
|
|
51
|
+
else
|
|
52
|
+
visit(left[key], right[key], nextPath);
|
|
53
|
+
}
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
changed.push({ path, before: left, after: right });
|
|
57
|
+
}
|
|
58
|
+
visit(before, after, "");
|
|
59
|
+
return {
|
|
60
|
+
added: added.sort(),
|
|
61
|
+
removed: removed.sort(),
|
|
62
|
+
changed: changed.sort((left, right) => left.path.localeCompare(right.path)),
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
function conciseJson(value) {
|
|
66
|
+
return JSON.stringify(value);
|
|
67
|
+
}
|
|
68
|
+
export function renderSemanticDiff(diff) {
|
|
69
|
+
const rows = [];
|
|
70
|
+
for (const path of diff.added)
|
|
71
|
+
rows.push(["Added", path || "/", "", ""]);
|
|
72
|
+
for (const path of diff.removed)
|
|
73
|
+
rows.push(["Removed", path || "/", "", ""]);
|
|
74
|
+
for (const item of diff.changed) {
|
|
75
|
+
rows.push(["Changed", item.path || "/", conciseJson(item.before), conciseJson(item.after)]);
|
|
76
|
+
}
|
|
77
|
+
rows.sort((left, right) => `${left[1]}\u0000${left[0]}`.localeCompare(`${right[1]}\u0000${right[0]}`));
|
|
78
|
+
return rows.length === 0 ? "No semantic changes." : markdownTable(["Change", "Path", "Before", "After"], rows);
|
|
79
|
+
}
|
|
80
|
+
//# sourceMappingURL=semantic-diff.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"semantic-diff.js","sourceRoot":"","sources":["../src/semantic-diff.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"renderers.test.d.ts","sourceRoot":"","sources":["../../src/test/renderers.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
import assert from "node:assert/strict";
|
|
2
|
+
import test from "node:test";
|
|
3
|
+
import { DOCUMENT_REGISTRY, REQUIREMENTS_TEMPLATE_SLOTS, renderApprovalEvidence, renderDeploymentPreview, renderRequirementsDocument, renderRequirements, renderResourceInventory, renderRunStatus, } from "../index.js";
|
|
4
|
+
const hash = (character) => character.repeat(64);
|
|
5
|
+
test("document registry limits template bindings to supported sources", () => {
|
|
6
|
+
assert.equal(DOCUMENT_REGISTRY.requirements?.sourceAvailability, "available");
|
|
7
|
+
assert.equal(DOCUMENT_REGISTRY.requirements?.templateAvailability, "available");
|
|
8
|
+
assert.equal(DOCUMENT_REGISTRY.inventory?.sourceAvailability, "available");
|
|
9
|
+
assert.equal(DOCUMENT_REGISTRY["resource-inventory-template"]?.templateAvailability, "reference-only");
|
|
10
|
+
for (const documentId of [
|
|
11
|
+
"architecture-assessment",
|
|
12
|
+
"cost-estimate",
|
|
13
|
+
"governance-constraints",
|
|
14
|
+
"implementation-plan",
|
|
15
|
+
"deployment-summary",
|
|
16
|
+
"operations-runbook",
|
|
17
|
+
]) {
|
|
18
|
+
assert.equal(DOCUMENT_REGISTRY[documentId]?.sourceAvailability, "unavailable");
|
|
19
|
+
assert.equal(DOCUMENT_REGISTRY[documentId]?.templateAvailability, "reference-only");
|
|
20
|
+
}
|
|
21
|
+
});
|
|
22
|
+
test("requirements document rendering fills exact template slots with typed or unavailable values", () => {
|
|
23
|
+
const input = {
|
|
24
|
+
schemaVersion: "1.0.0",
|
|
25
|
+
projectId: "sample-project",
|
|
26
|
+
workload: "API",
|
|
27
|
+
environment: "prod",
|
|
28
|
+
requirements: [
|
|
29
|
+
{ id: "REQ-1", statement: "Serve requests", priority: "must", status: "confirmed", source: "brief" },
|
|
30
|
+
],
|
|
31
|
+
assumptions: [],
|
|
32
|
+
unknowns: [],
|
|
33
|
+
};
|
|
34
|
+
const template = REQUIREMENTS_TEMPLATE_SLOTS.map((slot) => `{${slot}}`).join("\n");
|
|
35
|
+
const rendered = renderRequirementsDocument(input, template, hash("a"), hash("b"));
|
|
36
|
+
assert.doesNotMatch(rendered, /\{[a-z][a-z-]*\}/u);
|
|
37
|
+
assert.match(rendered, /Unavailable: RequirementsV1 does not represent business context\./u);
|
|
38
|
+
assert.match(rendered, /Unavailable: no architecture handoff artifact is produced by the current workflow\./u);
|
|
39
|
+
assert.throws(() => renderRequirementsDocument(input, `${template}\n{unexpected-slot}`, hash("a"), hash("b")), /invalid slots/u);
|
|
40
|
+
});
|
|
41
|
+
test("requirements rendering is deterministic, sorted, and escaped", () => {
|
|
42
|
+
const input = {
|
|
43
|
+
schemaVersion: "1.0.0",
|
|
44
|
+
projectId: "sample-project",
|
|
45
|
+
workload: "API|worker\tpool\u0002",
|
|
46
|
+
environment: "prod",
|
|
47
|
+
requirements: [
|
|
48
|
+
{ id: "REQ-2", statement: "Second", priority: "should", status: "unknown", source: "user" },
|
|
49
|
+
{ id: "REQ-1", statement: "First|line\nnext", priority: "must", status: "confirmed", source: "brief" },
|
|
50
|
+
],
|
|
51
|
+
assumptions: ["Zulu", "Alpha"],
|
|
52
|
+
unknowns: ["Unknown B", "Unknown A"],
|
|
53
|
+
};
|
|
54
|
+
const reordered = {
|
|
55
|
+
...input,
|
|
56
|
+
requirements: [...input.requirements].reverse(),
|
|
57
|
+
assumptions: [...input.assumptions].reverse(),
|
|
58
|
+
unknowns: [...input.unknowns].reverse(),
|
|
59
|
+
};
|
|
60
|
+
const rendered = renderRequirements(input);
|
|
61
|
+
assert.equal(rendered, renderRequirements(input));
|
|
62
|
+
assert.equal(rendered, renderRequirements(reordered));
|
|
63
|
+
assert.ok(rendered.indexOf("REQ-1") < rendered.indexOf("REQ-2"));
|
|
64
|
+
assert.match(rendered, /First\\\|line<br>next/);
|
|
65
|
+
assert.match(rendered, /API\\\|worker\\\\u0009pool\\\\u0002/);
|
|
66
|
+
assert.doesNotMatch(rendered, /[\t\u0002]/);
|
|
67
|
+
});
|
|
68
|
+
test("run status displays sorted inherited gate provenance", () => {
|
|
69
|
+
const gates = [
|
|
70
|
+
{ gate: 4, state: "closed", dependencyHash: hash("d") },
|
|
71
|
+
{ gate: 2, state: "inherited", dependencyHash: hash("b"), inheritedFromRunId: "parent-run", reason: "promotion" },
|
|
72
|
+
{ gate: 1, state: "approved", dependencyHash: hash("a"), decidedAt: "2026-07-01T10:00:00Z" },
|
|
73
|
+
{ gate: 3, state: "open", dependencyHash: hash("c") },
|
|
74
|
+
];
|
|
75
|
+
const run = {
|
|
76
|
+
schemaVersion: "1.0.0",
|
|
77
|
+
projectId: "sample-project",
|
|
78
|
+
runId: "prod-run",
|
|
79
|
+
environment: "prod",
|
|
80
|
+
targetScope: "/subscriptions/example",
|
|
81
|
+
iacTool: "bicep",
|
|
82
|
+
createdAt: "2026-07-01T09:00:00Z",
|
|
83
|
+
runtimeLockHash: hash("e"),
|
|
84
|
+
parentRunId: "parent-run",
|
|
85
|
+
ownerEpoch: 3,
|
|
86
|
+
gates,
|
|
87
|
+
};
|
|
88
|
+
const rendered = renderRunStatus(run);
|
|
89
|
+
assert.equal(rendered, renderRunStatus({ ...run, gates: [...gates].reverse() }));
|
|
90
|
+
assert.match(rendered, /\| 2 \| inherited \| parent-run \| - \| promotion \|/);
|
|
91
|
+
assert.ok(rendered.indexOf("| 1 |") < rendered.indexOf("| 4 |"));
|
|
92
|
+
});
|
|
93
|
+
test("deployment preview emphasizes destructive changes and sorted blockers", () => {
|
|
94
|
+
const preview = {
|
|
95
|
+
schemaVersion: "1.0.0",
|
|
96
|
+
projectId: "sample-project",
|
|
97
|
+
runId: "prod-run",
|
|
98
|
+
environment: "prod",
|
|
99
|
+
track: "terraform",
|
|
100
|
+
operation: "apply",
|
|
101
|
+
target: "production",
|
|
102
|
+
commit: hash("a"),
|
|
103
|
+
dependencyRevision: hash("a"),
|
|
104
|
+
ownerEpoch: 2,
|
|
105
|
+
inputHash: hash("b"),
|
|
106
|
+
iacHash: hash("c"),
|
|
107
|
+
policyHash: hash("d"),
|
|
108
|
+
changes: [
|
|
109
|
+
{ resourceId: "z-resource", action: "delete", material: true, details: "data|loss" },
|
|
110
|
+
{ resourceId: "a-resource", action: "create", material: true },
|
|
111
|
+
],
|
|
112
|
+
blockers: ["Zulu blocker", "Alpha|blocker"],
|
|
113
|
+
createdAt: "2026-07-01T10:00:00Z",
|
|
114
|
+
expiresAt: "2026-07-02T10:00:00Z",
|
|
115
|
+
previewHash: hash("f"),
|
|
116
|
+
};
|
|
117
|
+
const reordered = {
|
|
118
|
+
...preview,
|
|
119
|
+
changes: [...preview.changes].reverse(),
|
|
120
|
+
blockers: [...preview.blockers].reverse(),
|
|
121
|
+
};
|
|
122
|
+
const rendered = renderDeploymentPreview(preview);
|
|
123
|
+
assert.equal(rendered, renderDeploymentPreview(reordered));
|
|
124
|
+
assert.match(rendered, /\*\*DESTRUCTIVE CHANGES PRESENT\*\*/);
|
|
125
|
+
assert.match(rendered, /\*\*DELETE\*\*/);
|
|
126
|
+
assert.match(rendered, /\*\*BLOCKED:\*\* Alpha\\\|blocker/);
|
|
127
|
+
assert.ok(rendered.indexOf("Alpha") < rendered.indexOf("Zulu"));
|
|
128
|
+
assert.ok(rendered.indexOf("a-resource") < rendered.indexOf("z-resource"));
|
|
129
|
+
});
|
|
130
|
+
test("approval evidence renders supplied timestamps and optional binding fields", () => {
|
|
131
|
+
const approval = {
|
|
132
|
+
schemaVersion: "1.0.0",
|
|
133
|
+
projectId: "sample-project",
|
|
134
|
+
runId: "prod-run",
|
|
135
|
+
gate: 4,
|
|
136
|
+
decision: "approved",
|
|
137
|
+
actor: "local-maintainer",
|
|
138
|
+
mechanism: "tty",
|
|
139
|
+
dependencyHash: hash("a"),
|
|
140
|
+
previewHash: hash("b"),
|
|
141
|
+
writerEpoch: 4,
|
|
142
|
+
recipientIdentity: "github-actions:owner/repo:123:2:deploy",
|
|
143
|
+
decidedAt: "2026-07-01T11:00:00Z",
|
|
144
|
+
expiresAt: "2026-07-01T12:00:00Z",
|
|
145
|
+
};
|
|
146
|
+
const rendered = renderApprovalEvidence(approval);
|
|
147
|
+
assert.equal(rendered, renderApprovalEvidence(approval));
|
|
148
|
+
assert.match(rendered, /\*\*Decision:\*\* APPROVED/);
|
|
149
|
+
assert.match(rendered, /2026-07-01T11:00:00Z/);
|
|
150
|
+
assert.match(rendered, /github-actions:owner\/repo:123:2:deploy/);
|
|
151
|
+
});
|
|
152
|
+
test("resource inventory sorts resources and property keys", () => {
|
|
153
|
+
const resources = [
|
|
154
|
+
{
|
|
155
|
+
logicalId: "storage",
|
|
156
|
+
resourceId: "/storage/z",
|
|
157
|
+
type: "Storage",
|
|
158
|
+
location: "swedencentral",
|
|
159
|
+
properties: { z: 2, a: "value|one" },
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
logicalId: "api",
|
|
163
|
+
resourceId: "/apps/a",
|
|
164
|
+
type: "App",
|
|
165
|
+
location: "swedencentral",
|
|
166
|
+
properties: { enabled: true },
|
|
167
|
+
},
|
|
168
|
+
];
|
|
169
|
+
const inventory = {
|
|
170
|
+
schemaVersion: "1.0.0",
|
|
171
|
+
projectId: "sample-project",
|
|
172
|
+
runId: "prod-run",
|
|
173
|
+
deploymentHash: hash("a"),
|
|
174
|
+
collectedAt: "2026-07-01T12:00:00Z",
|
|
175
|
+
resources,
|
|
176
|
+
};
|
|
177
|
+
const rendered = renderResourceInventory(inventory);
|
|
178
|
+
assert.equal(rendered, renderResourceInventory({ ...inventory, resources: [...resources].reverse() }));
|
|
179
|
+
assert.ok(rendered.indexOf("| api |") < rendered.indexOf("| storage |"));
|
|
180
|
+
assert.match(rendered, /\{"a":"value\\\|one","z":2\}/);
|
|
181
|
+
});
|
|
182
|
+
//# sourceMappingURL=renderers.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"renderers.test.js","sourceRoot":"","sources":["../../src/test/renderers.test.ts"],"names":[],"mappings":"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"}
|