micro-contracts 0.18.10 → 0.18.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/README.md +7 -14
- package/cli-contract.yaml +15 -27
- package/dist/agents/context-builder.d.ts +5 -0
- package/dist/agents/context-builder.d.ts.map +1 -0
- package/dist/agents/context-builder.js +239 -0
- package/dist/agents/context-builder.js.map +1 -0
- package/dist/agents/formatter.d.ts +9 -0
- package/dist/agents/formatter.d.ts.map +1 -0
- package/dist/agents/formatter.js +124 -0
- package/dist/agents/formatter.js.map +1 -0
- package/dist/agents/index.d.ts +6 -0
- package/dist/agents/index.d.ts.map +1 -0
- package/dist/agents/index.js +4 -0
- package/dist/agents/index.js.map +1 -0
- package/dist/agents/orchestrator.d.ts +5 -0
- package/dist/agents/orchestrator.d.ts.map +1 -0
- package/dist/agents/orchestrator.js +46 -0
- package/dist/agents/orchestrator.js.map +1 -0
- package/dist/agents/types.d.ts +29 -0
- package/dist/agents/types.d.ts.map +1 -0
- package/dist/agents/types.js +7 -0
- package/dist/agents/types.js.map +1 -0
- package/dist/cli/templates.d.ts +15 -0
- package/dist/cli/templates.d.ts.map +1 -0
- package/dist/cli/templates.js +445 -0
- package/dist/cli/templates.js.map +1 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +1201 -0
- package/dist/cli.js.map +1 -0
- package/dist/commands/audit-guardrails.d.ts +15 -0
- package/dist/commands/audit-guardrails.d.ts.map +1 -0
- package/dist/commands/audit-guardrails.js +33 -0
- package/dist/commands/audit-guardrails.js.map +1 -0
- package/dist/commands/audit-openapi.d.ts +15 -0
- package/dist/commands/audit-openapi.d.ts.map +1 -0
- package/dist/commands/audit-openapi.js +33 -0
- package/dist/commands/audit-openapi.js.map +1 -0
- package/dist/commands/insights.d.ts +8 -0
- package/dist/commands/insights.d.ts.map +1 -0
- package/dist/commands/insights.js +13 -0
- package/dist/commands/insights.js.map +1 -0
- package/dist/commands/propose-overlays.d.ts +15 -0
- package/dist/commands/propose-overlays.d.ts.map +1 -0
- package/dist/commands/propose-overlays.js +33 -0
- package/dist/commands/propose-overlays.js.map +1 -0
- package/dist/commands/review-published.d.ts +15 -0
- package/dist/commands/review-published.d.ts.map +1 -0
- package/dist/commands/review-published.js +33 -0
- package/dist/commands/review-published.js.map +1 -0
- package/dist/external/insight-provider.d.ts.map +1 -0
- package/dist/external/insight-provider.js.map +1 -0
- package/dist/generated/commands.d.ts +2 -0
- package/dist/generated/commands.d.ts.map +1 -0
- package/dist/generated/commands.js +2 -0
- package/dist/generated/commands.js.map +1 -0
- package/dist/generated/contract.d.ts +3 -0
- package/dist/generated/contract.d.ts.map +1 -0
- package/dist/generated/contract.js +5 -0
- package/dist/generated/contract.js.map +1 -0
- package/dist/generated/dsl/agents.d.ts +34 -0
- package/dist/generated/dsl/agents.d.ts.map +1 -0
- package/dist/generated/dsl/agents.js +98 -0
- package/dist/generated/dsl/agents.js.map +1 -0
- package/dist/generated/dsl/dsl-data.d.ts +7 -0
- package/dist/generated/dsl/dsl-data.d.ts.map +1 -0
- package/dist/generated/dsl/dsl-data.js +1041 -0
- package/dist/generated/dsl/dsl-data.js.map +1 -0
- package/dist/generated/dsl/handoffs.d.ts +457 -0
- package/dist/generated/dsl/handoffs.d.ts.map +1 -0
- package/dist/generated/dsl/handoffs.js +205 -0
- package/dist/generated/dsl/handoffs.js.map +1 -0
- package/dist/generated/dsl/index.d.ts +14 -0
- package/dist/generated/dsl/index.d.ts.map +1 -0
- package/dist/generated/dsl/index.js +11 -0
- package/dist/generated/dsl/index.js.map +1 -0
- package/dist/generated/dsl/tasks.d.ts +28 -0
- package/dist/generated/dsl/tasks.d.ts.map +1 -0
- package/dist/generated/dsl/tasks.js +137 -0
- package/dist/generated/dsl/tasks.js.map +1 -0
- package/dist/generated/dsl/workflows.d.ts +34 -0
- package/dist/generated/dsl/workflows.d.ts.map +1 -0
- package/dist/generated/dsl/workflows.js +84 -0
- package/dist/generated/dsl/workflows.js.map +1 -0
- package/dist/generated/index.d.ts +8 -0
- package/dist/generated/index.d.ts.map +1 -0
- package/dist/generated/index.js +8 -0
- package/dist/generated/index.js.map +1 -0
- package/dist/generated/policy-runtime.d.ts +114 -0
- package/dist/generated/policy-runtime.d.ts.map +1 -0
- package/dist/generated/policy-runtime.js +195 -0
- package/dist/generated/policy-runtime.js.map +1 -0
- package/dist/generated/policy.d.ts +658 -0
- package/dist/generated/policy.d.ts.map +1 -0
- package/dist/generated/policy.js +844 -0
- package/dist/generated/policy.js.map +1 -0
- package/dist/generated/program.d.ts +120 -0
- package/dist/generated/program.d.ts.map +1 -0
- package/dist/generated/program.js +370 -0
- package/dist/generated/program.js.map +1 -0
- package/dist/generated/schemas.d.ts +779 -0
- package/dist/generated/schemas.d.ts.map +1 -0
- package/dist/generated/schemas.js +1006 -0
- package/dist/generated/schemas.js.map +1 -0
- package/dist/generated/types.d.ts +786 -0
- package/dist/generated/types.d.ts.map +1 -0
- package/dist/generated/types.js +3 -0
- package/dist/generated/types.js.map +1 -0
- package/dist/generator/dependencyGenerator.d.ts +16 -0
- package/dist/generator/dependencyGenerator.d.ts.map +1 -0
- package/dist/generator/dependencyGenerator.js +25 -0
- package/dist/generator/dependencyGenerator.js.map +1 -0
- package/dist/generator/index.d.ts +47 -0
- package/dist/generator/index.d.ts.map +1 -0
- package/dist/generator/index.js +707 -0
- package/dist/generator/index.js.map +1 -0
- package/dist/generator/inputHash.d.ts +23 -0
- package/dist/generator/inputHash.d.ts.map +1 -0
- package/dist/generator/inputHash.js +138 -0
- package/dist/generator/inputHash.js.map +1 -0
- package/dist/generator/linter.d.ts +26 -0
- package/dist/generator/linter.d.ts.map +1 -0
- package/dist/generator/linter.js +441 -0
- package/dist/generator/linter.js.map +1 -0
- package/dist/generator/overlayProcessor.d.ts +71 -0
- package/dist/generator/overlayProcessor.d.ts.map +1 -0
- package/dist/generator/overlayProcessor.js +500 -0
- package/dist/generator/overlayProcessor.js.map +1 -0
- package/dist/generator/schemaGenerator.d.ts +10 -0
- package/dist/generator/schemaGenerator.d.ts.map +1 -0
- package/dist/generator/schemaGenerator.js +296 -0
- package/dist/generator/schemaGenerator.js.map +1 -0
- package/dist/generator/serviceGenerator.d.ts +20 -0
- package/dist/generator/serviceGenerator.d.ts.map +1 -0
- package/dist/generator/serviceGenerator.js +293 -0
- package/dist/generator/serviceGenerator.js.map +1 -0
- package/dist/generator/templateProcessor.d.ts +208 -0
- package/dist/generator/templateProcessor.d.ts.map +1 -0
- package/dist/generator/templateProcessor.js +604 -0
- package/dist/generator/templateProcessor.js.map +1 -0
- package/dist/generator/typeGenerator.d.ts +22 -0
- package/dist/generator/typeGenerator.d.ts.map +1 -0
- package/dist/generator/typeGenerator.js +439 -0
- package/dist/generator/typeGenerator.js.map +1 -0
- package/dist/generator/typeGenerator.test.d.ts +2 -0
- package/dist/generator/typeGenerator.test.d.ts.map +1 -0
- package/dist/generator/typeGenerator.test.js +155 -0
- package/dist/generator/typeGenerator.test.js.map +1 -0
- package/dist/glob.d.ts +22 -0
- package/dist/glob.d.ts.map +1 -0
- package/dist/glob.js +103 -0
- package/dist/glob.js.map +1 -0
- package/dist/guardrails/allowlist.d.ts +30 -0
- package/dist/guardrails/allowlist.d.ts.map +1 -0
- package/dist/guardrails/allowlist.js +174 -0
- package/dist/guardrails/allowlist.js.map +1 -0
- package/dist/guardrails/config.d.ts +40 -0
- package/dist/guardrails/config.d.ts.map +1 -0
- package/dist/guardrails/config.js +177 -0
- package/dist/guardrails/config.js.map +1 -0
- package/dist/guardrails/drift.d.ts +19 -0
- package/dist/guardrails/drift.d.ts.map +1 -0
- package/dist/guardrails/drift.js +115 -0
- package/dist/guardrails/drift.js.map +1 -0
- package/dist/guardrails/index.d.ts +18 -0
- package/dist/guardrails/index.d.ts.map +1 -0
- package/dist/guardrails/index.js +21 -0
- package/dist/guardrails/index.js.map +1 -0
- package/dist/guardrails/lint.d.ts +16 -0
- package/dist/guardrails/lint.d.ts.map +1 -0
- package/dist/guardrails/lint.js +172 -0
- package/dist/guardrails/lint.js.map +1 -0
- package/dist/guardrails/manifest.d.ts +63 -0
- package/dist/guardrails/manifest.d.ts.map +1 -0
- package/dist/guardrails/manifest.js +310 -0
- package/dist/guardrails/manifest.js.map +1 -0
- package/dist/guardrails/runner.d.ts +53 -0
- package/dist/guardrails/runner.d.ts.map +1 -0
- package/dist/guardrails/runner.js +387 -0
- package/dist/guardrails/runner.js.map +1 -0
- package/dist/guardrails/types.d.ts +196 -0
- package/dist/guardrails/types.d.ts.map +1 -0
- package/dist/guardrails/types.js +8 -0
- package/dist/guardrails/types.js.map +1 -0
- package/dist/index.d.ts +21 -4
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +21 -4
- package/dist/index.js.map +1 -0
- package/dist/micro-contracts.bundle.mjs +349 -374
- package/dist/micro-contracts.bundle.mjs.map +3 -3
- package/dist/types.d.ts +502 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +409 -0
- package/dist/types.js.map +1 -0
- package/dist/version.d.ts +10 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +31 -0
- package/dist/version.js.map +1 -0
- package/docs/cli-reference.md +13 -15
- package/docs/development-guardrails.md +3 -3
- package/docs/screen-spec.md +3 -3
- package/package.json +13 -12
|
@@ -0,0 +1,387 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Check runner for guardrails
|
|
3
|
+
*
|
|
4
|
+
* Orchestrates running multiple guardrail checks.
|
|
5
|
+
* Supports both built-in checks and custom checks from guardrails.yaml.
|
|
6
|
+
*/
|
|
7
|
+
import { runAllowlistCheck } from './allowlist.js';
|
|
8
|
+
import { runDriftCheck } from './drift.js';
|
|
9
|
+
import { runManifestCheck } from './manifest.js';
|
|
10
|
+
import { runCustomCommandCheck } from './lint.js';
|
|
11
|
+
import { loadGuardrailsConfigWithPath } from './config.js';
|
|
12
|
+
/**
|
|
13
|
+
* Gate descriptions for display
|
|
14
|
+
*/
|
|
15
|
+
export const GATE_DESCRIPTIONS = {
|
|
16
|
+
1: 'Change Allowlist',
|
|
17
|
+
2: 'OpenAPI Contract Validation',
|
|
18
|
+
3: 'Generated Artifact Integrity',
|
|
19
|
+
4: 'Code Quality',
|
|
20
|
+
5: 'Doc Consistency & Static Analysis',
|
|
21
|
+
};
|
|
22
|
+
/**
|
|
23
|
+
* Built-in checks (always available)
|
|
24
|
+
*/
|
|
25
|
+
const builtinChecks = [
|
|
26
|
+
{
|
|
27
|
+
name: 'allowlist',
|
|
28
|
+
description: 'Verify changes are within allowed paths',
|
|
29
|
+
gate: 1,
|
|
30
|
+
run: runAllowlistCheck,
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
name: 'drift',
|
|
34
|
+
description: 'Check for uncommitted generated file changes',
|
|
35
|
+
gate: 3,
|
|
36
|
+
run: runDriftCheck,
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
name: 'manifest',
|
|
40
|
+
description: 'Verify generated artifact integrity',
|
|
41
|
+
gate: 3,
|
|
42
|
+
run: runManifestCheck,
|
|
43
|
+
},
|
|
44
|
+
];
|
|
45
|
+
/**
|
|
46
|
+
* Legacy built-in checks (deprecated - use guardrails.yaml checks instead)
|
|
47
|
+
* These are only included if no custom checks are defined in guardrails.yaml
|
|
48
|
+
*/
|
|
49
|
+
const legacyChecks = [
|
|
50
|
+
// Removed: use spec-lint in guardrails.yaml instead
|
|
51
|
+
// Removed: use code-typecheck in guardrails.yaml instead
|
|
52
|
+
// Removed: use docs-sync, docs-links in guardrails.yaml instead
|
|
53
|
+
];
|
|
54
|
+
/**
|
|
55
|
+
* Load custom checks from guardrails.yaml
|
|
56
|
+
*/
|
|
57
|
+
function loadCustomChecks(options) {
|
|
58
|
+
const { config } = loadGuardrailsConfigWithPath(options.guardrailsPath);
|
|
59
|
+
const customChecks = [];
|
|
60
|
+
if (config?.checks) {
|
|
61
|
+
for (const [name, checkConfig] of Object.entries(config.checks)) {
|
|
62
|
+
if (!checkConfig || checkConfig.enabled === false) {
|
|
63
|
+
continue;
|
|
64
|
+
}
|
|
65
|
+
customChecks.push({
|
|
66
|
+
name,
|
|
67
|
+
description: `Custom check: ${name}`,
|
|
68
|
+
gate: checkConfig.gate,
|
|
69
|
+
run: (opts) => checkConfig.command
|
|
70
|
+
? runCustomCommandCheck(name, checkConfig.command, opts)
|
|
71
|
+
: Promise.resolve({
|
|
72
|
+
name,
|
|
73
|
+
status: 'fail',
|
|
74
|
+
duration: 0,
|
|
75
|
+
message: `Check '${name}' has no command. Set checks.${name}.command in guardrails.yaml.`,
|
|
76
|
+
}),
|
|
77
|
+
});
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
return customChecks;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Get all available checks (built-in + custom)
|
|
84
|
+
*/
|
|
85
|
+
function getAllChecks(options) {
|
|
86
|
+
const customChecks = loadCustomChecks(options);
|
|
87
|
+
const customNames = new Set(customChecks.map(c => c.name));
|
|
88
|
+
// Start with built-in checks
|
|
89
|
+
const allChecks = [...builtinChecks];
|
|
90
|
+
// Add legacy checks only if not overridden by custom checks
|
|
91
|
+
for (const legacyCheck of legacyChecks) {
|
|
92
|
+
if (!customNames.has(legacyCheck.name)) {
|
|
93
|
+
allChecks.push(legacyCheck);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
// Add custom checks
|
|
97
|
+
allChecks.push(...customChecks);
|
|
98
|
+
// Create index map to preserve original order within same gate
|
|
99
|
+
const indexMap = new Map(allChecks.map((c, i) => [c.name, i]));
|
|
100
|
+
// Sort by gate number (G1 → G2 → G3 → G4 → G5, then undefined)
|
|
101
|
+
// Within the same gate, preserve the order defined in guardrails.yaml
|
|
102
|
+
allChecks.sort((a, b) => {
|
|
103
|
+
const gateA = a.gate ?? 999;
|
|
104
|
+
const gateB = b.gate ?? 999;
|
|
105
|
+
if (gateA !== gateB) {
|
|
106
|
+
return gateA - gateB;
|
|
107
|
+
}
|
|
108
|
+
// Same gate: preserve original order (config file order)
|
|
109
|
+
return (indexMap.get(a.name) ?? 0) - (indexMap.get(b.name) ?? 0);
|
|
110
|
+
});
|
|
111
|
+
return allChecks;
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Get list of available checks
|
|
115
|
+
*/
|
|
116
|
+
export function getAvailableChecks(options = {}) {
|
|
117
|
+
return getAllChecks(options);
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Filter checks based on options
|
|
121
|
+
*/
|
|
122
|
+
function filterChecks(allChecks, options) {
|
|
123
|
+
let filtered = [...allChecks];
|
|
124
|
+
// A name that matches no check silently changes what runs: --only leaves
|
|
125
|
+
// nothing to verify, --skip skips nothing while the caller believes it did.
|
|
126
|
+
const known = new Set(allChecks.map(c => c.name));
|
|
127
|
+
for (const [flag, names] of [['--only', options.only], ['--skip', options.skip]]) {
|
|
128
|
+
for (const name of names ?? []) {
|
|
129
|
+
if (!known.has(name)) {
|
|
130
|
+
throw new Error(`Unknown check in ${flag}: '${name}'. Available: ${[...known].sort().join(', ')}`);
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
// Filter by --gate (highest priority)
|
|
135
|
+
if (options.gates && options.gates.length > 0) {
|
|
136
|
+
filtered = filtered.filter(c => c.gate !== undefined && options.gates.includes(c.gate));
|
|
137
|
+
}
|
|
138
|
+
// Filter by --only
|
|
139
|
+
if (options.only && options.only.length > 0) {
|
|
140
|
+
filtered = filtered.filter(c => options.only.includes(c.name));
|
|
141
|
+
}
|
|
142
|
+
// Filter by --skip
|
|
143
|
+
if (options.skip && options.skip.length > 0) {
|
|
144
|
+
filtered = filtered.filter(c => !options.skip.includes(c.name));
|
|
145
|
+
}
|
|
146
|
+
return filtered;
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* Run all guardrail checks
|
|
150
|
+
*/
|
|
151
|
+
export async function runAllChecks(options = {}) {
|
|
152
|
+
const results = [];
|
|
153
|
+
const allChecks = getAllChecks(options);
|
|
154
|
+
const checksToRun = filterChecks(allChecks, options);
|
|
155
|
+
const skippedChecks = allChecks.filter(c => !checksToRun.includes(c));
|
|
156
|
+
// Add skipped results (by filter, not reported in streaming)
|
|
157
|
+
for (const check of skippedChecks) {
|
|
158
|
+
results.push({
|
|
159
|
+
name: check.name,
|
|
160
|
+
status: 'skip',
|
|
161
|
+
duration: 0,
|
|
162
|
+
message: 'Skipped by filter',
|
|
163
|
+
});
|
|
164
|
+
}
|
|
165
|
+
// Run enabled checks
|
|
166
|
+
for (const check of checksToRun) {
|
|
167
|
+
// Notify check is starting
|
|
168
|
+
if (options.onCheckStart) {
|
|
169
|
+
options.onCheckStart(check);
|
|
170
|
+
}
|
|
171
|
+
let result;
|
|
172
|
+
try {
|
|
173
|
+
result = await check.run(options);
|
|
174
|
+
}
|
|
175
|
+
catch (error) {
|
|
176
|
+
result = {
|
|
177
|
+
name: check.name,
|
|
178
|
+
status: 'fail',
|
|
179
|
+
duration: 0,
|
|
180
|
+
message: error instanceof Error ? error.message : String(error),
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
results.push(result);
|
|
184
|
+
// Notify check completed
|
|
185
|
+
if (options.onCheckComplete) {
|
|
186
|
+
options.onCheckComplete(result, check);
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
// Calculate summary
|
|
190
|
+
const passed = results.filter(r => r.status === 'pass').length;
|
|
191
|
+
const failed = results.filter(r => r.status === 'fail').length;
|
|
192
|
+
const skipped = results.filter(r => r.status === 'skip').length;
|
|
193
|
+
return {
|
|
194
|
+
passed,
|
|
195
|
+
failed,
|
|
196
|
+
skipped,
|
|
197
|
+
results,
|
|
198
|
+
checks: allChecks,
|
|
199
|
+
};
|
|
200
|
+
}
|
|
201
|
+
/**
|
|
202
|
+
* Format a single check result for streaming output
|
|
203
|
+
*/
|
|
204
|
+
/**
|
|
205
|
+
* The run's verdict. Skipping every check verified nothing, so it is not
|
|
206
|
+
* success: a mistyped generated directory used to end in "All checks passed".
|
|
207
|
+
*
|
|
208
|
+
* The only definition of the verdict — `check` and `pipeline` both print it.
|
|
209
|
+
*/
|
|
210
|
+
export function formatVerdict(summary) {
|
|
211
|
+
if (summary.failed > 0) {
|
|
212
|
+
return '❌ Some checks failed. Fix issues before committing.';
|
|
213
|
+
}
|
|
214
|
+
if (summary.passed === 0) {
|
|
215
|
+
return '⚠️ No checks ran. Nothing was verified.';
|
|
216
|
+
}
|
|
217
|
+
return '✅ All checks passed!';
|
|
218
|
+
}
|
|
219
|
+
export function formatSingleCheckResult(result, check, verbose = false) {
|
|
220
|
+
const icon = result.status === 'pass' ? '✓' : result.status === 'fail' ? '✗' : '○';
|
|
221
|
+
const status = result.status.toUpperCase().padEnd(4);
|
|
222
|
+
const gateStr = check.gate !== undefined ? `[G${check.gate}] ` : '';
|
|
223
|
+
let output = ` ${icon} ${gateStr}${result.name.padEnd(20)} ${status} (${result.duration}ms)`;
|
|
224
|
+
if (result.message && (verbose || result.status !== 'pass')) {
|
|
225
|
+
output += `\n ${result.message}`;
|
|
226
|
+
}
|
|
227
|
+
return output;
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
* Format check start message for streaming output
|
|
231
|
+
*/
|
|
232
|
+
export function formatCheckStart(check) {
|
|
233
|
+
const gateStr = check.gate !== undefined ? `[G${check.gate}] ` : '';
|
|
234
|
+
return ` ⋯ ${gateStr}${check.name.padEnd(20)} running...`;
|
|
235
|
+
}
|
|
236
|
+
/**
|
|
237
|
+
* Format summary only (for use after streaming individual results)
|
|
238
|
+
*/
|
|
239
|
+
export function formatCheckSummary(summary, _checksWithGates) {
|
|
240
|
+
const lines = [];
|
|
241
|
+
// Summary
|
|
242
|
+
lines.push('');
|
|
243
|
+
lines.push('─'.repeat(50));
|
|
244
|
+
lines.push('');
|
|
245
|
+
lines.push(` Passed: ${summary.passed}`);
|
|
246
|
+
lines.push(` Failed: ${summary.failed}`);
|
|
247
|
+
if (summary.skipped > 0) {
|
|
248
|
+
lines.push(` Skipped: ${summary.skipped}`);
|
|
249
|
+
}
|
|
250
|
+
lines.push('');
|
|
251
|
+
lines.push(formatVerdict(summary));
|
|
252
|
+
lines.push('');
|
|
253
|
+
// Show details for failed checks
|
|
254
|
+
const failedWithDetails = summary.results.filter(r => r.status === 'fail' && r.details && r.details.length > 0);
|
|
255
|
+
if (failedWithDetails.length > 0) {
|
|
256
|
+
lines.push('');
|
|
257
|
+
lines.push('━'.repeat(50));
|
|
258
|
+
lines.push('📋 Failed Check Details');
|
|
259
|
+
lines.push('━'.repeat(50));
|
|
260
|
+
for (const result of failedWithDetails) {
|
|
261
|
+
lines.push('');
|
|
262
|
+
lines.push(`▶ ${result.name}`);
|
|
263
|
+
lines.push('─'.repeat(40));
|
|
264
|
+
for (const detail of result.details) {
|
|
265
|
+
lines.push(` ${detail}`);
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
lines.push('');
|
|
269
|
+
}
|
|
270
|
+
return lines.join('\n');
|
|
271
|
+
}
|
|
272
|
+
/**
|
|
273
|
+
* Format check results for CLI output
|
|
274
|
+
*/
|
|
275
|
+
export function formatCheckResults(summary, verbose = false, checksWithGates) {
|
|
276
|
+
const lines = [];
|
|
277
|
+
lines.push('');
|
|
278
|
+
lines.push('🔍 AI Guardrail Check Results');
|
|
279
|
+
lines.push('═'.repeat(50));
|
|
280
|
+
lines.push('');
|
|
281
|
+
// Build a map of check name -> gate for display
|
|
282
|
+
const gateMap = new Map();
|
|
283
|
+
if (checksWithGates) {
|
|
284
|
+
for (const check of checksWithGates) {
|
|
285
|
+
gateMap.set(check.name, check.gate);
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
// Group results by gate if gate info is available
|
|
289
|
+
const hasGateInfo = checksWithGates && checksWithGates.some(c => c.gate !== undefined);
|
|
290
|
+
if (hasGateInfo && verbose) {
|
|
291
|
+
// Group by gate for verbose output
|
|
292
|
+
const byGate = new Map();
|
|
293
|
+
for (const result of summary.results) {
|
|
294
|
+
const gate = gateMap.get(result.name);
|
|
295
|
+
if (!byGate.has(gate)) {
|
|
296
|
+
byGate.set(gate, []);
|
|
297
|
+
}
|
|
298
|
+
byGate.get(gate).push(result);
|
|
299
|
+
}
|
|
300
|
+
// Output by gate
|
|
301
|
+
const sortedGates = [...byGate.keys()].sort((a, b) => {
|
|
302
|
+
if (a === undefined)
|
|
303
|
+
return 1;
|
|
304
|
+
if (b === undefined)
|
|
305
|
+
return -1;
|
|
306
|
+
return a - b;
|
|
307
|
+
});
|
|
308
|
+
for (const gate of sortedGates) {
|
|
309
|
+
const results = byGate.get(gate);
|
|
310
|
+
if (gate !== undefined) {
|
|
311
|
+
lines.push(` Gate ${gate}: ${GATE_DESCRIPTIONS[gate]}`);
|
|
312
|
+
lines.push(' ' + '─'.repeat(40));
|
|
313
|
+
}
|
|
314
|
+
else {
|
|
315
|
+
lines.push(` Other Checks:`);
|
|
316
|
+
lines.push(' ' + '─'.repeat(40));
|
|
317
|
+
}
|
|
318
|
+
for (const result of results) {
|
|
319
|
+
const icon = result.status === 'pass' ? '✓' : result.status === 'fail' ? '✗' : '○';
|
|
320
|
+
const status = result.status.toUpperCase().padEnd(4);
|
|
321
|
+
lines.push(` ${icon} ${result.name.padEnd(20)} ${status} (${result.duration}ms)`);
|
|
322
|
+
if (result.message && (verbose || result.status !== 'pass')) {
|
|
323
|
+
lines.push(` ${result.message}`);
|
|
324
|
+
}
|
|
325
|
+
// Show details inline only for non-failed checks in verbose mode
|
|
326
|
+
// Failed check details are shown after the summary
|
|
327
|
+
if (verbose && result.details && result.status !== 'fail') {
|
|
328
|
+
for (const detail of result.details) {
|
|
329
|
+
lines.push(` ${detail}`);
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
lines.push('');
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
else {
|
|
337
|
+
// Flat output
|
|
338
|
+
for (const result of summary.results) {
|
|
339
|
+
const icon = result.status === 'pass' ? '✓' : result.status === 'fail' ? '✗' : '○';
|
|
340
|
+
const status = result.status.toUpperCase().padEnd(4);
|
|
341
|
+
const gate = gateMap.get(result.name);
|
|
342
|
+
const gateStr = gate !== undefined ? `[G${gate}] ` : '';
|
|
343
|
+
lines.push(` ${icon} ${gateStr}${result.name.padEnd(20)} ${status} (${result.duration}ms)`);
|
|
344
|
+
if (result.message && (verbose || result.status !== 'pass')) {
|
|
345
|
+
lines.push(` ${result.message}`);
|
|
346
|
+
}
|
|
347
|
+
// Show details inline only for non-failed checks in verbose mode
|
|
348
|
+
// Failed check details are shown after the summary
|
|
349
|
+
if (verbose && result.details && result.status !== 'fail') {
|
|
350
|
+
for (const detail of result.details) {
|
|
351
|
+
lines.push(` ${detail}`);
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
// Summary
|
|
357
|
+
lines.push('');
|
|
358
|
+
lines.push('─'.repeat(50));
|
|
359
|
+
lines.push('');
|
|
360
|
+
lines.push(` Passed: ${summary.passed}`);
|
|
361
|
+
lines.push(` Failed: ${summary.failed}`);
|
|
362
|
+
if (summary.skipped > 0) {
|
|
363
|
+
lines.push(` Skipped: ${summary.skipped}`);
|
|
364
|
+
}
|
|
365
|
+
lines.push('');
|
|
366
|
+
lines.push(formatVerdict(summary));
|
|
367
|
+
lines.push('');
|
|
368
|
+
// Show details for failed checks (always shown, not just in verbose mode)
|
|
369
|
+
const failedWithDetails = summary.results.filter(r => r.status === 'fail' && r.details && r.details.length > 0);
|
|
370
|
+
if (failedWithDetails.length > 0) {
|
|
371
|
+
lines.push('');
|
|
372
|
+
lines.push('━'.repeat(50));
|
|
373
|
+
lines.push('📋 Failed Check Details');
|
|
374
|
+
lines.push('━'.repeat(50));
|
|
375
|
+
for (const result of failedWithDetails) {
|
|
376
|
+
lines.push('');
|
|
377
|
+
lines.push(`▶ ${result.name}`);
|
|
378
|
+
lines.push('─'.repeat(40));
|
|
379
|
+
for (const detail of result.details) {
|
|
380
|
+
lines.push(` ${detail}`);
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
lines.push('');
|
|
384
|
+
}
|
|
385
|
+
return lines.join('\n');
|
|
386
|
+
}
|
|
387
|
+
//# sourceMappingURL=runner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/guardrails/runner.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Guardrails type definitions
|
|
3
|
+
*
|
|
4
|
+
* These types define the structure for AI-driven development guardrails
|
|
5
|
+
* that protect generated artifacts and enforce change policies.
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* Guardrails configuration file structure (guardrails.yaml)
|
|
9
|
+
*/
|
|
10
|
+
export interface GuardrailsConfig {
|
|
11
|
+
/**
|
|
12
|
+
* Paths that can be edited in normal development PRs
|
|
13
|
+
* Supports glob patterns and negation (prefix with !)
|
|
14
|
+
*/
|
|
15
|
+
allowed?: string[];
|
|
16
|
+
/**
|
|
17
|
+
* Paths that require special approval (e.g., security config, CI)
|
|
18
|
+
* Supports glob patterns and negation (prefix with !)
|
|
19
|
+
*/
|
|
20
|
+
protected?: string[];
|
|
21
|
+
/**
|
|
22
|
+
* Paths for generated artifacts (committed but only modified via generate)
|
|
23
|
+
* Supports glob patterns and negation (prefix with !)
|
|
24
|
+
*/
|
|
25
|
+
generated?: string[];
|
|
26
|
+
/**
|
|
27
|
+
* Check command configurations
|
|
28
|
+
* Define custom commands for each guardrail check
|
|
29
|
+
*/
|
|
30
|
+
checks?: ChecksConfig;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Configuration for guardrail check commands
|
|
34
|
+
*/
|
|
35
|
+
export interface ChecksConfig {
|
|
36
|
+
/** Checks by name; every one runs its own command */
|
|
37
|
+
[key: string]: CheckCommandConfig | undefined;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Gate numbers for guardrail checks
|
|
41
|
+
*
|
|
42
|
+
* Gate 1: Change Allowlist (allowlist)
|
|
43
|
+
* Gate 2: OpenAPI Contract Validation (spec-lint, spec-breaking)
|
|
44
|
+
* Gate 3: Generated Artifact Integrity (drift, manifest)
|
|
45
|
+
* Gate 4: Code Quality (code-lint, code-typecheck, code-test)
|
|
46
|
+
* Gate 5: Doc Consistency & Static Analysis (docs-sync, docs-links, security)
|
|
47
|
+
*/
|
|
48
|
+
export type GateNumber = 1 | 2 | 3 | 4 | 5;
|
|
49
|
+
/**
|
|
50
|
+
* Configuration for a single check command
|
|
51
|
+
*/
|
|
52
|
+
export interface CheckCommandConfig {
|
|
53
|
+
/**
|
|
54
|
+
* Command template to run.
|
|
55
|
+
* Supports placeholders:
|
|
56
|
+
* - {files} - space-separated list of target files (auto-detected)
|
|
57
|
+
* - {cwd} - current working directory
|
|
58
|
+
*
|
|
59
|
+
* @example
|
|
60
|
+
* command: "npx @stoplight/spectral-cli lint {files} --ruleset spec/spectral.yaml"
|
|
61
|
+
*/
|
|
62
|
+
command: string;
|
|
63
|
+
/**
|
|
64
|
+
* Whether this check is enabled (default: true)
|
|
65
|
+
*/
|
|
66
|
+
enabled?: boolean;
|
|
67
|
+
/**
|
|
68
|
+
* Gate number this check belongs to (1-5)
|
|
69
|
+
* Used with --gate option to run checks by gate
|
|
70
|
+
*
|
|
71
|
+
* Gate 1: Change Allowlist
|
|
72
|
+
* Gate 2: OpenAPI Contract Validation
|
|
73
|
+
* Gate 3: Generated Artifact Integrity
|
|
74
|
+
* Gate 4: Code Quality
|
|
75
|
+
* Gate 5: Doc Consistency & Static Analysis
|
|
76
|
+
*/
|
|
77
|
+
gate?: GateNumber;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Result of allowlist verification
|
|
81
|
+
*/
|
|
82
|
+
export interface AllowlistResult {
|
|
83
|
+
valid: boolean;
|
|
84
|
+
violations: AllowlistViolation[];
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* A single allowlist violation
|
|
88
|
+
*/
|
|
89
|
+
export interface AllowlistViolation {
|
|
90
|
+
file: string;
|
|
91
|
+
reason: 'protected' | 'not-in-allowlist';
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Result of drift check
|
|
95
|
+
*/
|
|
96
|
+
export interface DriftResult {
|
|
97
|
+
valid: boolean;
|
|
98
|
+
changedFiles: string[];
|
|
99
|
+
error?: string;
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* Generated artifact manifest structure
|
|
103
|
+
*/
|
|
104
|
+
export interface GeneratedManifest {
|
|
105
|
+
/** Manifest format version */
|
|
106
|
+
version: string;
|
|
107
|
+
/** Timestamp when manifest was last updated (only changes when files change) */
|
|
108
|
+
updatedAt?: string;
|
|
109
|
+
/** Version of micro-contracts that generated this */
|
|
110
|
+
generatorVersion: string;
|
|
111
|
+
/** SHA-256 hash of all input files (config, specs, templates, overlays) + package version */
|
|
112
|
+
inputHash?: string;
|
|
113
|
+
/** Map of relative file paths to their metadata */
|
|
114
|
+
files: Record<string, GeneratedFileInfo>;
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Metadata for a single generated file
|
|
118
|
+
*/
|
|
119
|
+
export interface GeneratedFileInfo {
|
|
120
|
+
/** SHA-256 hash of file content */
|
|
121
|
+
sha256: string;
|
|
122
|
+
/** Source file that generated this (e.g., OpenAPI spec path) */
|
|
123
|
+
source?: string;
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Result of manifest verification
|
|
127
|
+
*/
|
|
128
|
+
export interface ManifestResult {
|
|
129
|
+
valid: boolean;
|
|
130
|
+
mismatches: ManifestMismatch[];
|
|
131
|
+
manifestPath?: string;
|
|
132
|
+
}
|
|
133
|
+
/**
|
|
134
|
+
* A single manifest mismatch
|
|
135
|
+
*/
|
|
136
|
+
export interface ManifestMismatch {
|
|
137
|
+
file: string;
|
|
138
|
+
reason: 'missing' | 'hash-mismatch' | 'extra';
|
|
139
|
+
expected?: string;
|
|
140
|
+
actual?: string;
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Options for check command
|
|
144
|
+
*/
|
|
145
|
+
export interface CheckOptions {
|
|
146
|
+
/** Run specific checks only */
|
|
147
|
+
only?: string[];
|
|
148
|
+
/** Skip specific checks */
|
|
149
|
+
skip?: string[];
|
|
150
|
+
/** Run checks for specific gates only (1-5) */
|
|
151
|
+
gates?: GateNumber[];
|
|
152
|
+
/** Enable verbose output */
|
|
153
|
+
verbose?: boolean;
|
|
154
|
+
/** Enable auto-fix where possible */
|
|
155
|
+
fix?: boolean;
|
|
156
|
+
/** Path to guardrails.yaml */
|
|
157
|
+
guardrailsPath?: string;
|
|
158
|
+
/** Path to generated files directory */
|
|
159
|
+
generatedDir?: string;
|
|
160
|
+
/** File containing list of changed files (for CI) */
|
|
161
|
+
changedFilesPath?: string;
|
|
162
|
+
/** Callback called when each check completes (for streaming output) */
|
|
163
|
+
onCheckComplete?: (result: CheckResult, check: CheckDefinition) => void;
|
|
164
|
+
/** Callback called before each check starts (for streaming output) */
|
|
165
|
+
onCheckStart?: (check: CheckDefinition) => void;
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* Result of a single check
|
|
169
|
+
*/
|
|
170
|
+
export interface CheckResult {
|
|
171
|
+
name: string;
|
|
172
|
+
status: 'pass' | 'fail' | 'skip';
|
|
173
|
+
duration: number;
|
|
174
|
+
message?: string;
|
|
175
|
+
details?: string[];
|
|
176
|
+
}
|
|
177
|
+
/**
|
|
178
|
+
* Overall check summary
|
|
179
|
+
*/
|
|
180
|
+
export interface CheckSummary {
|
|
181
|
+
passed: number;
|
|
182
|
+
failed: number;
|
|
183
|
+
skipped: number;
|
|
184
|
+
results: CheckResult[];
|
|
185
|
+
}
|
|
186
|
+
/**
|
|
187
|
+
* Check definition
|
|
188
|
+
*/
|
|
189
|
+
export interface CheckDefinition {
|
|
190
|
+
name: string;
|
|
191
|
+
description: string;
|
|
192
|
+
/** Gate number this check belongs to (1-5) */
|
|
193
|
+
gate?: GateNumber;
|
|
194
|
+
run: (options: CheckOptions) => Promise<CheckResult>;
|
|
195
|
+
}
|
|
196
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guardrails/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/guardrails/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,24 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
2
|
+
* micro-contracts library entry point.
|
|
3
|
+
*
|
|
4
|
+
* An explicit list, not `export *`: re-exporting whole modules made every
|
|
5
|
+
* internal helper part of the public API, which meant an export nothing
|
|
6
|
+
* referenced could not be told apart from one a consumer depends on — and
|
|
7
|
+
* unreachable code accumulated behind that ambiguity.
|
|
8
|
+
*
|
|
9
|
+
* Adding a name here is a public commitment. Everything absent stays internal,
|
|
10
|
+
* and `npm run lint:exports` reports internal exports nothing references.
|
|
4
11
|
*/
|
|
5
|
-
export
|
|
6
|
-
export
|
|
12
|
+
export { generate, loadConfig, findConfigFile, loadOpenAPISpec, collectInputFiles, computeInputHash, } from './generator/index.js';
|
|
13
|
+
export type { GenerateOptions } from './generator/index.js';
|
|
14
|
+
export { lintSpec, formatLintResults } from './generator/index.js';
|
|
15
|
+
export type { LintOptions, LintResult } from './generator/linter.js';
|
|
16
|
+
export { generateTypes, generateSchemas, generateServiceInterfaces, buildTemplateContext, renderTemplate, } from './generator/index.js';
|
|
17
|
+
export type { TemplateContext, ScreenContext, ScreenLink, ScreenAction, ScreenInteraction, } from './generator/index.js';
|
|
18
|
+
export { processOverlays, generateExtensionInterfaces } from './generator/index.js';
|
|
19
|
+
export type { ExtensionInfo, OverlayConfig, OverlayResult } from './generator/overlayProcessor.js';
|
|
20
|
+
export { isMultiModuleConfig, resolveModuleConfig, validateConfigKeys, expandPlaceholders, } from './types.js';
|
|
21
|
+
export type { MultiModuleConfig, ModuleConfig, ModuleDefaults, ResolvedModuleConfig, ServerConfig, FrontendConfig, OutputConfig, ResolvedOutputConfig, GeneratorConfig, } from './types.js';
|
|
22
|
+
export { isReference, getRefName, extractDependencies } from './types.js';
|
|
23
|
+
export type { OpenAPISpec, PathItem, OperationObject, ParameterObject, RequestBodyObject, ResponseObject, SchemaObject, ReferenceObject, MediaTypeObject, LinkObject, OpenAPIType, LintError, DependencyRef, ModuleDependencies, InlineEventDefinition, InlineEventRaw, InteractionDefinitionRaw, ScreenEventDefinition, } from './types.js';
|
|
7
24
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,QAAQ,EACR,UAAU,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EACL,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAGnG,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EACV,WAAW,EACX,QAAQ,EACR,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,EACf,UAAU,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
|