micro-contracts 0.18.9 → 0.18.11

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 (202) hide show
  1. package/README.md +7 -14
  2. package/cli-contract.yaml +15 -27
  3. package/dist/agents/context-builder.d.ts +5 -0
  4. package/dist/agents/context-builder.d.ts.map +1 -0
  5. package/dist/agents/context-builder.js +239 -0
  6. package/dist/agents/context-builder.js.map +1 -0
  7. package/dist/agents/formatter.d.ts +9 -0
  8. package/dist/agents/formatter.d.ts.map +1 -0
  9. package/dist/agents/formatter.js +124 -0
  10. package/dist/agents/formatter.js.map +1 -0
  11. package/dist/agents/index.d.ts +6 -0
  12. package/dist/agents/index.d.ts.map +1 -0
  13. package/dist/agents/index.js +4 -0
  14. package/dist/agents/index.js.map +1 -0
  15. package/dist/agents/orchestrator.d.ts +5 -0
  16. package/dist/agents/orchestrator.d.ts.map +1 -0
  17. package/dist/agents/orchestrator.js +46 -0
  18. package/dist/agents/orchestrator.js.map +1 -0
  19. package/dist/agents/types.d.ts +29 -0
  20. package/dist/agents/types.d.ts.map +1 -0
  21. package/dist/agents/types.js +7 -0
  22. package/dist/agents/types.js.map +1 -0
  23. package/dist/cli/templates.d.ts +15 -0
  24. package/dist/cli/templates.d.ts.map +1 -0
  25. package/dist/cli/templates.js +445 -0
  26. package/dist/cli/templates.js.map +1 -0
  27. package/dist/cli.d.ts +3 -0
  28. package/dist/cli.d.ts.map +1 -0
  29. package/dist/cli.js +1201 -0
  30. package/dist/cli.js.map +1 -0
  31. package/dist/commands/audit-guardrails.d.ts +15 -0
  32. package/dist/commands/audit-guardrails.d.ts.map +1 -0
  33. package/dist/commands/audit-guardrails.js +33 -0
  34. package/dist/commands/audit-guardrails.js.map +1 -0
  35. package/dist/commands/audit-openapi.d.ts +15 -0
  36. package/dist/commands/audit-openapi.d.ts.map +1 -0
  37. package/dist/commands/audit-openapi.js +33 -0
  38. package/dist/commands/audit-openapi.js.map +1 -0
  39. package/dist/commands/insights.d.ts +8 -0
  40. package/dist/commands/insights.d.ts.map +1 -0
  41. package/dist/commands/insights.js +13 -0
  42. package/dist/commands/insights.js.map +1 -0
  43. package/dist/commands/propose-overlays.d.ts +15 -0
  44. package/dist/commands/propose-overlays.d.ts.map +1 -0
  45. package/dist/commands/propose-overlays.js +33 -0
  46. package/dist/commands/propose-overlays.js.map +1 -0
  47. package/dist/commands/review-published.d.ts +15 -0
  48. package/dist/commands/review-published.d.ts.map +1 -0
  49. package/dist/commands/review-published.js +33 -0
  50. package/dist/commands/review-published.js.map +1 -0
  51. package/dist/external/insight-provider.d.ts.map +1 -0
  52. package/dist/external/insight-provider.js.map +1 -0
  53. package/dist/generated/commands.d.ts +2 -0
  54. package/dist/generated/commands.d.ts.map +1 -0
  55. package/dist/generated/commands.js +2 -0
  56. package/dist/generated/commands.js.map +1 -0
  57. package/dist/generated/contract.d.ts +3 -0
  58. package/dist/generated/contract.d.ts.map +1 -0
  59. package/dist/generated/contract.js +5 -0
  60. package/dist/generated/contract.js.map +1 -0
  61. package/dist/generated/dsl/agents.d.ts +34 -0
  62. package/dist/generated/dsl/agents.d.ts.map +1 -0
  63. package/dist/generated/dsl/agents.js +98 -0
  64. package/dist/generated/dsl/agents.js.map +1 -0
  65. package/dist/generated/dsl/dsl-data.d.ts +7 -0
  66. package/dist/generated/dsl/dsl-data.d.ts.map +1 -0
  67. package/dist/generated/dsl/dsl-data.js +1041 -0
  68. package/dist/generated/dsl/dsl-data.js.map +1 -0
  69. package/dist/generated/dsl/handoffs.d.ts +457 -0
  70. package/dist/generated/dsl/handoffs.d.ts.map +1 -0
  71. package/dist/generated/dsl/handoffs.js +205 -0
  72. package/dist/generated/dsl/handoffs.js.map +1 -0
  73. package/dist/generated/dsl/index.d.ts +14 -0
  74. package/dist/generated/dsl/index.d.ts.map +1 -0
  75. package/dist/generated/dsl/index.js +11 -0
  76. package/dist/generated/dsl/index.js.map +1 -0
  77. package/dist/generated/dsl/tasks.d.ts +28 -0
  78. package/dist/generated/dsl/tasks.d.ts.map +1 -0
  79. package/dist/generated/dsl/tasks.js +137 -0
  80. package/dist/generated/dsl/tasks.js.map +1 -0
  81. package/dist/generated/dsl/workflows.d.ts +34 -0
  82. package/dist/generated/dsl/workflows.d.ts.map +1 -0
  83. package/dist/generated/dsl/workflows.js +84 -0
  84. package/dist/generated/dsl/workflows.js.map +1 -0
  85. package/dist/generated/index.d.ts +8 -0
  86. package/dist/generated/index.d.ts.map +1 -0
  87. package/dist/generated/index.js +8 -0
  88. package/dist/generated/index.js.map +1 -0
  89. package/dist/generated/policy-runtime.d.ts +114 -0
  90. package/dist/generated/policy-runtime.d.ts.map +1 -0
  91. package/dist/generated/policy-runtime.js +195 -0
  92. package/dist/generated/policy-runtime.js.map +1 -0
  93. package/dist/generated/policy.d.ts +658 -0
  94. package/dist/generated/policy.d.ts.map +1 -0
  95. package/dist/generated/policy.js +844 -0
  96. package/dist/generated/policy.js.map +1 -0
  97. package/dist/generated/program.d.ts +120 -0
  98. package/dist/generated/program.d.ts.map +1 -0
  99. package/dist/generated/program.js +370 -0
  100. package/dist/generated/program.js.map +1 -0
  101. package/dist/generated/schemas.d.ts +779 -0
  102. package/dist/generated/schemas.d.ts.map +1 -0
  103. package/dist/generated/schemas.js +1006 -0
  104. package/dist/generated/schemas.js.map +1 -0
  105. package/dist/generated/types.d.ts +786 -0
  106. package/dist/generated/types.d.ts.map +1 -0
  107. package/dist/generated/types.js +3 -0
  108. package/dist/generated/types.js.map +1 -0
  109. package/dist/generator/dependencyGenerator.d.ts +16 -0
  110. package/dist/generator/dependencyGenerator.d.ts.map +1 -0
  111. package/dist/generator/dependencyGenerator.js +25 -0
  112. package/dist/generator/dependencyGenerator.js.map +1 -0
  113. package/dist/generator/index.d.ts +47 -0
  114. package/dist/generator/index.d.ts.map +1 -0
  115. package/dist/generator/index.js +707 -0
  116. package/dist/generator/index.js.map +1 -0
  117. package/dist/generator/inputHash.d.ts +23 -0
  118. package/dist/generator/inputHash.d.ts.map +1 -0
  119. package/dist/generator/inputHash.js +138 -0
  120. package/dist/generator/inputHash.js.map +1 -0
  121. package/dist/generator/linter.d.ts +26 -0
  122. package/dist/generator/linter.d.ts.map +1 -0
  123. package/dist/generator/linter.js +441 -0
  124. package/dist/generator/linter.js.map +1 -0
  125. package/dist/generator/overlayProcessor.d.ts +71 -0
  126. package/dist/generator/overlayProcessor.d.ts.map +1 -0
  127. package/dist/generator/overlayProcessor.js +500 -0
  128. package/dist/generator/overlayProcessor.js.map +1 -0
  129. package/dist/generator/schemaGenerator.d.ts +10 -0
  130. package/dist/generator/schemaGenerator.d.ts.map +1 -0
  131. package/dist/generator/schemaGenerator.js +296 -0
  132. package/dist/generator/schemaGenerator.js.map +1 -0
  133. package/dist/generator/serviceGenerator.d.ts +20 -0
  134. package/dist/generator/serviceGenerator.d.ts.map +1 -0
  135. package/dist/generator/serviceGenerator.js +293 -0
  136. package/dist/generator/serviceGenerator.js.map +1 -0
  137. package/dist/generator/templateProcessor.d.ts +208 -0
  138. package/dist/generator/templateProcessor.d.ts.map +1 -0
  139. package/dist/generator/templateProcessor.js +604 -0
  140. package/dist/generator/templateProcessor.js.map +1 -0
  141. package/dist/generator/typeGenerator.d.ts +22 -0
  142. package/dist/generator/typeGenerator.d.ts.map +1 -0
  143. package/dist/generator/typeGenerator.js +439 -0
  144. package/dist/generator/typeGenerator.js.map +1 -0
  145. package/dist/generator/typeGenerator.test.d.ts +2 -0
  146. package/dist/generator/typeGenerator.test.d.ts.map +1 -0
  147. package/dist/generator/typeGenerator.test.js +155 -0
  148. package/dist/generator/typeGenerator.test.js.map +1 -0
  149. package/dist/glob.d.ts +22 -0
  150. package/dist/glob.d.ts.map +1 -0
  151. package/dist/glob.js +103 -0
  152. package/dist/glob.js.map +1 -0
  153. package/dist/guardrails/allowlist.d.ts +30 -0
  154. package/dist/guardrails/allowlist.d.ts.map +1 -0
  155. package/dist/guardrails/allowlist.js +174 -0
  156. package/dist/guardrails/allowlist.js.map +1 -0
  157. package/dist/guardrails/config.d.ts +40 -0
  158. package/dist/guardrails/config.d.ts.map +1 -0
  159. package/dist/guardrails/config.js +177 -0
  160. package/dist/guardrails/config.js.map +1 -0
  161. package/dist/guardrails/drift.d.ts +19 -0
  162. package/dist/guardrails/drift.d.ts.map +1 -0
  163. package/dist/guardrails/drift.js +115 -0
  164. package/dist/guardrails/drift.js.map +1 -0
  165. package/dist/guardrails/index.d.ts +18 -0
  166. package/dist/guardrails/index.d.ts.map +1 -0
  167. package/dist/guardrails/index.js +21 -0
  168. package/dist/guardrails/index.js.map +1 -0
  169. package/dist/guardrails/lint.d.ts +16 -0
  170. package/dist/guardrails/lint.d.ts.map +1 -0
  171. package/dist/guardrails/lint.js +172 -0
  172. package/dist/guardrails/lint.js.map +1 -0
  173. package/dist/guardrails/manifest.d.ts +63 -0
  174. package/dist/guardrails/manifest.d.ts.map +1 -0
  175. package/dist/guardrails/manifest.js +310 -0
  176. package/dist/guardrails/manifest.js.map +1 -0
  177. package/dist/guardrails/runner.d.ts +53 -0
  178. package/dist/guardrails/runner.d.ts.map +1 -0
  179. package/dist/guardrails/runner.js +387 -0
  180. package/dist/guardrails/runner.js.map +1 -0
  181. package/dist/guardrails/types.d.ts +196 -0
  182. package/dist/guardrails/types.d.ts.map +1 -0
  183. package/dist/guardrails/types.js +8 -0
  184. package/dist/guardrails/types.js.map +1 -0
  185. package/dist/index.d.ts +21 -4
  186. package/dist/index.d.ts.map +1 -0
  187. package/dist/index.js +21 -4
  188. package/dist/index.js.map +1 -0
  189. package/dist/micro-contracts.bundle.mjs +358 -383
  190. package/dist/micro-contracts.bundle.mjs.map +3 -3
  191. package/dist/types.d.ts +502 -0
  192. package/dist/types.d.ts.map +1 -0
  193. package/dist/types.js +409 -0
  194. package/dist/types.js.map +1 -0
  195. package/dist/version.d.ts +10 -0
  196. package/dist/version.d.ts.map +1 -0
  197. package/dist/version.js +31 -0
  198. package/dist/version.js.map +1 -0
  199. package/docs/cli-reference.md +13 -15
  200. package/docs/development-guardrails.md +3 -3
  201. package/docs/screen-spec.md +3 -3
  202. package/package.json +13 -12
package/dist/glob.js ADDED
@@ -0,0 +1,103 @@
1
+ /**
2
+ * Glob matching.
3
+ *
4
+ * The single glob implementation: used both for guardrail file allowlists and
5
+ * for selecting outputs by id on the command line.
6
+ */
7
+ /**
8
+ * Simple glob pattern matching with negation support
9
+ * Patterns are evaluated top-to-bottom; last match wins.
10
+ * - "!pattern" → if matched, result becomes false (exclude)
11
+ * - "pattern" → if matched, result becomes true (include)
12
+ */
13
+ export function matchWithNegation(patterns, file) {
14
+ if (!patterns || patterns.length === 0)
15
+ return false;
16
+ let matched = false;
17
+ for (const raw of patterns) {
18
+ const neg = raw.startsWith('!');
19
+ const pattern = neg ? raw.slice(1) : raw;
20
+ if (!pattern)
21
+ continue;
22
+ if (matchGlob(file, pattern)) {
23
+ matched = !neg;
24
+ }
25
+ }
26
+ return matched;
27
+ }
28
+ /**
29
+ * Simple glob pattern matching
30
+ * Supports:
31
+ * - * matches any characters except /
32
+ * - ** matches any characters including / (zero or more path segments)
33
+ * - ? matches single character
34
+ */
35
+ export function matchGlob(file, pattern) {
36
+ // Normalize paths
37
+ const normalizedFile = file.replace(/\\/g, '/');
38
+ const normalizedPattern = pattern.replace(/\\/g, '/');
39
+ return matchGlobInternal(normalizedFile, normalizedPattern);
40
+ }
41
+ /**
42
+ * Internal glob matching implementation using regex
43
+ */
44
+ function matchGlobInternal(file, pattern) {
45
+ // Convert glob pattern to regex step by step
46
+ let regex = '';
47
+ let i = 0;
48
+ while (i < pattern.length) {
49
+ const char = pattern[i];
50
+ const nextChar = pattern[i + 1];
51
+ if (char === '*' && nextChar === '*') {
52
+ // ** - matches any path segments
53
+ const afterStars = pattern[i + 2];
54
+ if (afterStars === '/') {
55
+ // **/ at start or middle - matches zero or more path segments including nothing
56
+ regex += '(?:.*/)?';
57
+ i += 3; // skip **/
58
+ }
59
+ else if (i + 2 === pattern.length || afterStars === undefined) {
60
+ // ** at end - matches everything
61
+ regex += '.*';
62
+ i += 2;
63
+ }
64
+ else {
65
+ // ** without trailing / - matches any characters
66
+ regex += '.*';
67
+ i += 2;
68
+ }
69
+ }
70
+ else if (char === '*') {
71
+ // * - matches any characters except /
72
+ regex += '[^/]*';
73
+ i++;
74
+ }
75
+ else if (char === '?') {
76
+ // ? - matches single character except /
77
+ regex += '[^/]';
78
+ i++;
79
+ }
80
+ else if (char === '/') {
81
+ regex += '/';
82
+ i++;
83
+ }
84
+ else if ('.+^${}()|[]\\'.includes(char)) {
85
+ // Escape regex special chars
86
+ regex += '\\' + char;
87
+ i++;
88
+ }
89
+ else {
90
+ regex += char;
91
+ i++;
92
+ }
93
+ }
94
+ // Anchor the pattern
95
+ regex = `^${regex}$`;
96
+ try {
97
+ return new RegExp(regex).test(file);
98
+ }
99
+ catch {
100
+ return false;
101
+ }
102
+ }
103
+ //# sourceMappingURL=glob.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"glob.js","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Allowlist verification for guardrails
3
+ *
4
+ * Verifies that changed files are within allowed boundaries.
5
+ */
6
+ import type { GuardrailsConfig, AllowlistResult, CheckResult, CheckOptions } from './types.js';
7
+ /**
8
+ * Get list of changed files, filtered to a specific base directory
9
+ */
10
+ export declare function getChangedFiles(options: {
11
+ /** Path to file containing list of changed files */
12
+ changedFilesPath?: string;
13
+ /** Base ref for git diff (default: HEAD) */
14
+ baseRef?: string;
15
+ /** Base directory to filter files (only files under this dir are returned) */
16
+ baseDir?: string;
17
+ }): string[];
18
+ /**
19
+ * Verify changed files against allowlist
20
+ */
21
+ export declare function verifyAllowlist(changedFiles: string[], config: GuardrailsConfig): AllowlistResult;
22
+ /**
23
+ * Run allowlist check
24
+ */
25
+ export declare function runAllowlistCheck(options: CheckOptions): Promise<CheckResult>;
26
+ /**
27
+ * Format allowlist result for CLI output
28
+ */
29
+ export declare function formatAllowlistResult(result: AllowlistResult): string;
30
+ //# sourceMappingURL=allowlist.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../../src/guardrails/allowlist.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAsB,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAKnH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,EAAE,CA+CX;AAsBD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,gBAAgB,GACvB,eAAe,CA2BjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAyDnF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAiBrE"}
@@ -0,0 +1,174 @@
1
+ /**
2
+ * Allowlist verification for guardrails
3
+ *
4
+ * Verifies that changed files are within allowed boundaries.
5
+ */
6
+ import fs from 'fs';
7
+ import path from 'path';
8
+ import { matchWithNegation } from '../glob.js';
9
+ import { execSync } from 'child_process';
10
+ import { loadGuardrailsConfigWithPath } from './config.js';
11
+ /**
12
+ * Get list of changed files, filtered to a specific base directory
13
+ */
14
+ export function getChangedFiles(options) {
15
+ const { changedFilesPath, baseRef, baseDir } = options;
16
+ let files;
17
+ if (changedFilesPath) {
18
+ // Read from file (CI mode)
19
+ if (!fs.existsSync(changedFilesPath)) {
20
+ throw new Error(`Changed files list not found: ${changedFilesPath}`);
21
+ }
22
+ files = fs.readFileSync(changedFilesPath, 'utf-8')
23
+ .trim()
24
+ .split('\n')
25
+ .filter(Boolean);
26
+ }
27
+ else if (baseRef && baseRef !== 'HEAD') {
28
+ // Comparing branches (CI mode)
29
+ files = runGit(`git diff --name-only ${baseRef}...HEAD`);
30
+ }
31
+ else {
32
+ // Everything not yet committed. Taking staged files and only falling back to
33
+ // unstaged ones left a partly staged change half inspected: an edit to a
34
+ // protected path went unseen as long as something else was staged.
35
+ files = [...new Set([
36
+ ...runGit('git diff --name-only HEAD'),
37
+ ...runGit('git ls-files --others --exclude-standard'),
38
+ ])];
39
+ }
40
+ // Filter and convert paths relative to baseDir
41
+ if (baseDir) {
42
+ // Get git root to resolve absolute paths
43
+ let gitRoot;
44
+ try {
45
+ gitRoot = execSync('git rev-parse --show-toplevel', { encoding: 'utf8' }).trim();
46
+ }
47
+ catch {
48
+ gitRoot = process.cwd();
49
+ }
50
+ const absoluteBaseDir = path.resolve(baseDir);
51
+ // Filter to only files under baseDir and convert to relative paths
52
+ files = files
53
+ .map(f => path.resolve(gitRoot, f)) // Convert to absolute
54
+ .filter(f => f.startsWith(absoluteBaseDir + path.sep) || f === absoluteBaseDir) // Filter to baseDir
55
+ .map(f => path.relative(absoluteBaseDir, f)); // Convert to relative from baseDir
56
+ }
57
+ return files;
58
+ }
59
+ /**
60
+ * Run a git command, returning its output lines.
61
+ *
62
+ * Failures propagate: returning no files would report "nothing changed" when the
63
+ * truth is that nothing could be inspected.
64
+ */
65
+ function runGit(command) {
66
+ try {
67
+ return execSync(command, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
68
+ .trim()
69
+ .split('\n')
70
+ .filter(Boolean);
71
+ }
72
+ catch (error) {
73
+ throw new Error(`Cannot determine changed files (${command}): ` +
74
+ (error instanceof Error ? error.message.split('\n')[0] : String(error)));
75
+ }
76
+ }
77
+ /**
78
+ * Verify changed files against allowlist
79
+ */
80
+ export function verifyAllowlist(changedFiles, config) {
81
+ const violations = [];
82
+ for (const file of changedFiles) {
83
+ // 1. Check if protected (not allowed in normal PRs)
84
+ if (matchWithNegation(config.protected, file)) {
85
+ violations.push({ file, reason: 'protected' });
86
+ continue;
87
+ }
88
+ // 2. Check if generated (allowed, but must pass drift/manifest checks)
89
+ if (matchWithNegation(config.generated, file)) {
90
+ // Generated files are allowed to change, but we don't add a violation
91
+ // The drift/manifest checks will verify integrity
92
+ continue;
93
+ }
94
+ // 3. Must be in allowed list
95
+ if (!matchWithNegation(config.allowed, file)) {
96
+ violations.push({ file, reason: 'not-in-allowlist' });
97
+ }
98
+ }
99
+ return {
100
+ valid: violations.length === 0,
101
+ violations,
102
+ };
103
+ }
104
+ /**
105
+ * Run allowlist check
106
+ */
107
+ export async function runAllowlistCheck(options) {
108
+ const start = Date.now();
109
+ try {
110
+ // Load config with path information
111
+ const { config, baseDir, configPath } = loadGuardrailsConfigWithPath(options.guardrailsPath);
112
+ // Get changed files relative to guardrails config directory
113
+ const changedFiles = getChangedFiles({
114
+ changedFilesPath: options.changedFilesPath,
115
+ baseDir, // Filter to files under guardrails.yaml directory
116
+ });
117
+ if (changedFiles.length === 0) {
118
+ return {
119
+ name: 'allowlist',
120
+ status: 'pass',
121
+ duration: Date.now() - start,
122
+ message: configPath
123
+ ? `No changed files under ${path.basename(path.dirname(configPath))}/`
124
+ : 'No changed files to check',
125
+ };
126
+ }
127
+ // Verify allowlist
128
+ const result = verifyAllowlist(changedFiles, config);
129
+ if (result.valid) {
130
+ return {
131
+ name: 'allowlist',
132
+ status: 'pass',
133
+ duration: Date.now() - start,
134
+ message: `All ${changedFiles.length} changed files are within allowed boundaries`,
135
+ };
136
+ }
137
+ // Build error details
138
+ const details = result.violations.map(v => ` - ${v.file} (${v.reason})`);
139
+ return {
140
+ name: 'allowlist',
141
+ status: 'fail',
142
+ duration: Date.now() - start,
143
+ message: `${result.violations.length} file(s) are not allowed to be modified`,
144
+ details,
145
+ };
146
+ }
147
+ catch (error) {
148
+ return {
149
+ name: 'allowlist',
150
+ status: 'fail',
151
+ duration: Date.now() - start,
152
+ message: error instanceof Error ? error.message : String(error),
153
+ };
154
+ }
155
+ }
156
+ /**
157
+ * Format allowlist result for CLI output
158
+ */
159
+ export function formatAllowlistResult(result) {
160
+ const lines = [];
161
+ if (result.valid) {
162
+ lines.push('✅ All changed files are within allowed boundaries');
163
+ }
164
+ else {
165
+ lines.push('❌ The following files are not allowed to be modified in a normal PR:\n');
166
+ for (const { file, reason } of result.violations) {
167
+ lines.push(` - ${file} (${reason})`);
168
+ }
169
+ lines.push('\n💡 If this is a generated artifact, run the pinned generator and pass drift/manifest checks.');
170
+ lines.push('💡 If this should be editable, update guardrails.yaml (allowed/protected/generated).');
171
+ }
172
+ return lines.join('\n');
173
+ }
174
+ //# sourceMappingURL=allowlist.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"allowlist.js","sourceRoot":"","sources":["../../src/guardrails/allowlist.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Guardrails configuration parser
3
+ *
4
+ * Handles loading and validation of guardrails.yaml configuration files.
5
+ */
6
+ import type { GuardrailsConfig } from './types.js';
7
+ /**
8
+ * Default guardrails configuration
9
+ */
10
+ export declare const DEFAULT_GUARDRAILS: GuardrailsConfig;
11
+ /**
12
+ * Find guardrails config file in current directory or ancestors
13
+ */
14
+ export declare function findGuardrailsConfig(startDir?: string): string | null;
15
+ export interface LoadedGuardrailsConfig {
16
+ config: GuardrailsConfig;
17
+ /** Directory containing the guardrails config file (for relative path resolution) */
18
+ baseDir: string;
19
+ /** Full path to the config file (null if using defaults) */
20
+ configPath: string | null;
21
+ }
22
+ /**
23
+ * Load guardrails configuration from file
24
+ * Falls back to defaults if file not found
25
+ */
26
+ export declare function loadGuardrailsConfig(configPath?: string): GuardrailsConfig;
27
+ /**
28
+ * Load guardrails configuration with path information
29
+ * Returns both the config and the base directory for relative path resolution
30
+ */
31
+ export declare function loadGuardrailsConfigWithPath(configPath?: string): LoadedGuardrailsConfig;
32
+ /**
33
+ * Create a guardrails.yaml template
34
+ */
35
+ export declare function generateGuardrailsTemplate(): string;
36
+ /**
37
+ * Write guardrails template to file
38
+ */
39
+ export declare function createGuardrailsConfig(outputPath?: string): void;
40
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/guardrails/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAyBhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBrE;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,CAAC;IACzB,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAG1E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAiCxF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CA+DnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,GAAE,MAA0C,GAAG,IAAI,CAGnG"}
@@ -0,0 +1,177 @@
1
+ /**
2
+ * Guardrails configuration parser
3
+ *
4
+ * Handles loading and validation of guardrails.yaml configuration files.
5
+ */
6
+ import fs from 'fs';
7
+ import path from 'path';
8
+ import yaml from 'js-yaml';
9
+ /**
10
+ * Default guardrails configuration
11
+ */
12
+ export const DEFAULT_GUARDRAILS = {
13
+ allowed: [
14
+ 'spec/**/*.yaml',
15
+ 'spec/**/*.yml',
16
+ 'spec/**/*.hbs',
17
+ 'server/src/**/services/**/*.ts',
18
+ 'server/src/**/container.ts',
19
+ 'server/src/server.ts',
20
+ 'docs/**/*.md',
21
+ 'README.md',
22
+ 'package.json',
23
+ 'tsconfig.json',
24
+ ],
25
+ protected: [
26
+ 'spec/spectral.yaml',
27
+ 'spec/_shared/overlays/**',
28
+ 'guardrails.yaml',
29
+ '.github/**',
30
+ ],
31
+ generated: [
32
+ 'packages/**',
33
+ '**/*.generated.ts',
34
+ '**/*.generated.yaml',
35
+ '**/*.generated.yml',
36
+ ],
37
+ };
38
+ /**
39
+ * Find guardrails config file in current directory or ancestors
40
+ */
41
+ export function findGuardrailsConfig(startDir) {
42
+ const dir = startDir || process.cwd();
43
+ // Support multiple naming conventions
44
+ const candidates = [
45
+ 'micro-contracts.guardrails.yaml',
46
+ 'micro-contracts.guardrails.yml',
47
+ 'guardrails.yaml', // Legacy name
48
+ 'guardrails.yml',
49
+ ];
50
+ let current = path.resolve(dir);
51
+ const root = path.parse(current).root;
52
+ while (current !== root) {
53
+ for (const candidate of candidates) {
54
+ const configPath = path.join(current, candidate);
55
+ if (fs.existsSync(configPath)) {
56
+ return configPath;
57
+ }
58
+ }
59
+ current = path.dirname(current);
60
+ }
61
+ return null;
62
+ }
63
+ /**
64
+ * Load guardrails configuration from file
65
+ * Falls back to defaults if file not found
66
+ */
67
+ export function loadGuardrailsConfig(configPath) {
68
+ const result = loadGuardrailsConfigWithPath(configPath);
69
+ return result.config;
70
+ }
71
+ /**
72
+ * Load guardrails configuration with path information
73
+ * Returns both the config and the base directory for relative path resolution
74
+ */
75
+ export function loadGuardrailsConfigWithPath(configPath) {
76
+ const resolvedPath = configPath || findGuardrailsConfig();
77
+ if (!resolvedPath || !fs.existsSync(resolvedPath)) {
78
+ // Return default config with current directory as base
79
+ return {
80
+ config: DEFAULT_GUARDRAILS,
81
+ baseDir: process.cwd(),
82
+ configPath: null,
83
+ };
84
+ }
85
+ const content = fs.readFileSync(resolvedPath, 'utf-8');
86
+ const config = yaml.load(content);
87
+ // Validate basic structure
88
+ if (typeof config !== 'object' || config === null) {
89
+ throw new Error(`Invalid guardrails config: ${resolvedPath}`);
90
+ }
91
+ // Merge with defaults for any missing sections
92
+ const mergedConfig = {
93
+ allowed: config.allowed ?? DEFAULT_GUARDRAILS.allowed,
94
+ protected: config.protected ?? DEFAULT_GUARDRAILS.protected,
95
+ generated: config.generated ?? DEFAULT_GUARDRAILS.generated,
96
+ checks: config.checks, // Pass through checks config
97
+ };
98
+ return {
99
+ config: mergedConfig,
100
+ baseDir: path.dirname(resolvedPath),
101
+ configPath: resolvedPath,
102
+ };
103
+ }
104
+ /**
105
+ * Create a guardrails.yaml template
106
+ */
107
+ export function generateGuardrailsTemplate() {
108
+ const template = `# AI-Driven Development Guardrails Configuration
109
+ #
110
+ # This file defines which files can be modified in normal development PRs.
111
+ # Patterns use gitignore-style matching with glob patterns.
112
+ # Prefix with ! to negate (exclude) a pattern.
113
+
114
+ # Files that can be edited in normal development PRs
115
+ allowed:
116
+ # OpenAPI specs (source of truth)
117
+ - spec/**/openapi/*.yaml
118
+ - spec/**/templates/*.hbs
119
+
120
+ # Service implementations (human-written). \`init\` scaffolds these under
121
+ # src/<module>/ by default, and under server/src/ when run with --dir.
122
+ - src/**/*.ts
123
+ - server/src/**/services/**/*.ts
124
+ - server/src/**/container.ts
125
+ - server/src/server.ts
126
+
127
+ # Module-specific overlays (NOT _shared)
128
+ - server/src/*/overlays/**/*.ts
129
+ - "!server/src/_shared/overlays/**"
130
+
131
+ # Configuration
132
+ - micro-contracts.config.yaml
133
+ - micro-contracts.guardrails.yaml
134
+ - package.json
135
+ - tsconfig.json
136
+
137
+ # Documentation
138
+ - docs/**/*.md
139
+ - README.md
140
+
141
+ # Files that require special approval
142
+ protected:
143
+ # Spectral lint rules
144
+ - spec/spectral.yaml
145
+
146
+ # Shared overlay definitions
147
+ - spec/_shared/overlays/**
148
+
149
+ # Shared security overlay implementations
150
+ - server/src/_shared/overlays/**
151
+
152
+ # This guardrails configuration
153
+ - micro-contracts.guardrails.yaml
154
+
155
+ # CI/workflow definitions
156
+ - .github/**
157
+
158
+ # Generated artifacts (committed, but only modified via generate)
159
+ generated:
160
+ # Contract packages
161
+ - packages/**
162
+
163
+ # Generated files
164
+ - "**/*.generated.ts"
165
+ - "**/*.generated.yaml"
166
+ - "**/*.generated.yml"
167
+ `;
168
+ return template;
169
+ }
170
+ /**
171
+ * Write guardrails template to file
172
+ */
173
+ export function createGuardrailsConfig(outputPath = 'micro-contracts.guardrails.yaml') {
174
+ const template = generateGuardrailsTemplate();
175
+ fs.writeFileSync(outputPath, template);
176
+ }
177
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/guardrails/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Drift detection for generated artifacts
3
+ *
4
+ * Verifies that generated files match the committed state after running generate.
5
+ */
6
+ import type { DriftResult, CheckResult, CheckOptions } from './types.js';
7
+ /**
8
+ * Check for uncommitted changes (including untracked files)
9
+ */
10
+ export declare function checkUncommittedChanges(generatedDir?: string): DriftResult;
11
+ /**
12
+ * Run drift check
13
+ */
14
+ export declare function runDriftCheck(options: CheckOptions): Promise<CheckResult>;
15
+ /**
16
+ * Format drift result for CLI output
17
+ */
18
+ export declare function formatDriftResult(result: DriftResult): string;
19
+ //# sourceMappingURL=drift.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../src/guardrails/drift.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,GAAE,MAAoB,GAAG,WAAW,CA+BvF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAsD/E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsB7D"}