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
package/README.md
CHANGED
|
@@ -137,10 +137,10 @@ modules:
|
|
|
137
137
|
outputs:
|
|
138
138
|
screen-navigation:
|
|
139
139
|
output: frontend/src/screens/navigation.generated.ts
|
|
140
|
-
template: screen-navigation.hbs
|
|
140
|
+
template: spec/default/templates/screen-navigation.hbs
|
|
141
141
|
screen-events:
|
|
142
142
|
output: frontend/src/screens/events.generated.ts
|
|
143
|
-
template: screen-events.hbs
|
|
143
|
+
template: spec/default/templates/screen-events.hbs
|
|
144
144
|
```
|
|
145
145
|
|
|
146
146
|
Initialize a screen module with starter files:
|
|
@@ -301,9 +301,6 @@ Create `micro-contracts.config.yaml`. All paths support `{module}` placeholder.
|
|
|
301
301
|
|
|
302
302
|
| `overlays.shared` | string[] | no | Overlay files applied to all modules |
|
|
303
303
|
| `overlays.collision` | string | no | `error` \| `warn` \| `last-wins` (default: `error`) |
|
|
304
|
-
| `docs.enabled` | boolean | no | Enable documentation generation (default: `true`) |
|
|
305
|
-
| `docs.template` | string | no | Documentation template |
|
|
306
|
-
| `sharedModuleName` | string | no | Shared module name for overlays |
|
|
307
304
|
| `server.output` | string | no | Output **file** path for generated routes (default: `server/src/{module}/routes.generated.ts`) |
|
|
308
305
|
| `server.template` | string | yes if `server` is declared | Handlebars template for the routes file |
|
|
309
306
|
| `server.servicesPath` | string | no | Path to the services object in Fastify (default: `fastify.services.{module}`) |
|
|
@@ -333,8 +330,6 @@ apply to the built-in sections only. Select outputs with `--output`.
|
|
|
333
330
|
| `outputs.<id>.*` | — | no | Override any output config field |
|
|
334
331
|
| `overlays` | string[] | no | Module-specific overlay files |
|
|
335
332
|
| `dependsOn` | string[] | no | Dependencies (`{module}.{service}.{method}`) |
|
|
336
|
-
| `spectral` | string | no | Module-specific Spectral config path |
|
|
337
|
-
| `docs.enabled` | boolean | no | Override documentation generation |
|
|
338
333
|
| `server.*` | — | no | Override any `defaults.server` field |
|
|
339
334
|
| `server.enabled` | boolean | no | Disable built-in server generation for this module |
|
|
340
335
|
| `frontend.*` | — | no | Override any `defaults.frontend` field |
|
|
@@ -391,7 +386,6 @@ Generate code from OpenAPI specifications.
|
|
|
391
386
|
| `--output <ids>` | Output ids to generate, comma-separated; glob patterns allowed (e.g. `'*routes*'`). Fails when a pattern matches no output |
|
|
392
387
|
| `--server-only` | Generate the built-in `server` section only (not valid with an `outputs` configuration) |
|
|
393
388
|
| `--frontend-only` | Generate the built-in `frontend` section only (not valid with an `outputs` configuration) |
|
|
394
|
-
| `--docs-only` | Generate documentation only |
|
|
395
389
|
| `--skip-lint` | Skip linting before generation |
|
|
396
390
|
| `--no-manifest` | Skip manifest generation |
|
|
397
391
|
| `--manifest-dir <path>` | Directory for manifest (default: `packages/`) |
|
|
@@ -441,7 +435,7 @@ Run guardrail checks.
|
|
|
441
435
|
| `--gate <gates>` | Run checks for specific gates only (1-5) |
|
|
442
436
|
| `-v, --verbose` | Enable verbose output |
|
|
443
437
|
| `--fix` | Auto-fix issues where possible |
|
|
444
|
-
| `-g, --guardrails <path>` | Path to `guardrails.yaml` |
|
|
438
|
+
| `-g, --guardrails <path>` | Path to `micro-contracts.guardrails.yaml` |
|
|
445
439
|
| `-d, --generated-dir <path>` | Path to generated files directory (default: `packages/`) |
|
|
446
440
|
| `--changed-files <path>` | Path to file containing changed files (for CI) |
|
|
447
441
|
| `--list` | List available checks |
|
|
@@ -457,7 +451,7 @@ Run full guardrails pipeline: **Gate 1,2 → Generate → Gate 3,4,5**.
|
|
|
457
451
|
| `-v, --verbose` | Enable verbose output |
|
|
458
452
|
| `--skip <checks>` | Skip specific checks (comma-separated) |
|
|
459
453
|
| `--continue-on-error` | Continue running even if a step fails |
|
|
460
|
-
| `-g, --guardrails <path>` | Path to `guardrails.yaml` |
|
|
454
|
+
| `-g, --guardrails <path>` | Path to `micro-contracts.guardrails.yaml` |
|
|
461
455
|
| `-d, --generated-dir <path>` | Path to generated files directory (default: `packages/`) |
|
|
462
456
|
| `--no-manifest` | Skip manifest generation |
|
|
463
457
|
| `--skip-lint` | Skip linting before generation |
|
|
@@ -465,7 +459,6 @@ Run full guardrails pipeline: **Gate 1,2 → Generate → Gate 3,4,5**.
|
|
|
465
459
|
| `--output <ids>` | Output ids to generate, comma-separated; glob patterns allowed (e.g. `'*routes*'`). Fails when a pattern matches no output |
|
|
466
460
|
| `--server-only` | Generate the built-in `server` section only (not valid with an `outputs` configuration) |
|
|
467
461
|
| `--frontend-only` | Generate the built-in `frontend` section only (not valid with an `outputs` configuration) |
|
|
468
|
-
| `--docs-only` | Generate documentation only |
|
|
469
462
|
| `--force` | Bypass input hash cache and always regenerate |
|
|
470
463
|
| `--no-cache` | Run without reading or writing input hash cache |
|
|
471
464
|
|
|
@@ -490,11 +483,11 @@ Analyze module dependencies.
|
|
|
490
483
|
|
|
491
484
|
### guardrails-init
|
|
492
485
|
|
|
493
|
-
Create a `guardrails.yaml` configuration file.
|
|
486
|
+
Create a `micro-contracts.guardrails.yaml` configuration file.
|
|
494
487
|
|
|
495
488
|
| Option | Description |
|
|
496
489
|
|--------|-------------|
|
|
497
|
-
| `-o, --output <path>` | Output path (default: `guardrails.yaml`) |
|
|
490
|
+
| `-o, --output <path>` | Output path (default: `micro-contracts.guardrails.yaml`) |
|
|
498
491
|
|
|
499
492
|
### manifest
|
|
500
493
|
|
|
@@ -558,7 +551,7 @@ Audit guardrails configuration for drift detection and lint rule coverage. File
|
|
|
558
551
|
| Option | Description |
|
|
559
552
|
|--------|-------------|
|
|
560
553
|
| `-c, --config <path>` | Path to config file |
|
|
561
|
-
| `-g, --guardrails <path>` | Path to guardrails.yaml |
|
|
554
|
+
| `-g, --guardrails <path>` | Path to micro-contracts.guardrails.yaml |
|
|
562
555
|
| `-a, --adapter <name>` | SDK adapter (`claude`, `openai`, `gemini`, `mock`) |
|
|
563
556
|
| `--model <name>` | LLM model override |
|
|
564
557
|
| `--show-prompt` | Output the constructed prompt without calling LLM |
|
package/cli-contract.yaml
CHANGED
|
@@ -3,7 +3,7 @@ cli_contracts: 0.1.0
|
|
|
3
3
|
|
|
4
4
|
info:
|
|
5
5
|
title: micro-contracts CLI
|
|
6
|
-
version: 0.18.
|
|
6
|
+
version: 0.18.12
|
|
7
7
|
description: >-
|
|
8
8
|
Contract-first OpenAPI toolchain for TypeScript Web/API systems.
|
|
9
9
|
Generates contract packages, server routes, and frontend clients
|
|
@@ -26,7 +26,7 @@ artifact_slots:
|
|
|
26
26
|
description: Generated contract packages, server routes, and frontend clients
|
|
27
27
|
guardrails-config:
|
|
28
28
|
direction: read
|
|
29
|
-
description: guardrails.yaml configuration
|
|
29
|
+
description: micro-contracts.guardrails.yaml configuration
|
|
30
30
|
manifest:
|
|
31
31
|
direction: write
|
|
32
32
|
description: Generated manifest (.generated-manifest.json)
|
|
@@ -116,12 +116,6 @@ command_sets:
|
|
|
116
116
|
type: boolean
|
|
117
117
|
default: false
|
|
118
118
|
|
|
119
|
-
- name: docs-only
|
|
120
|
-
description: Generate documentation only.
|
|
121
|
-
schema:
|
|
122
|
-
type: boolean
|
|
123
|
-
default: false
|
|
124
|
-
|
|
125
119
|
- name: skip-lint
|
|
126
120
|
description: Skip Spectral linting before generation.
|
|
127
121
|
schema:
|
|
@@ -131,7 +125,7 @@ command_sets:
|
|
|
131
125
|
- name: manifest
|
|
132
126
|
description: >-
|
|
133
127
|
Generate manifest after generation. Enabled by default when
|
|
134
|
-
guardrails.yaml has a generated section. Use --no-manifest to disable.
|
|
128
|
+
micro-contracts.guardrails.yaml has a generated section. Use --no-manifest to disable.
|
|
135
129
|
schema:
|
|
136
130
|
type: boolean
|
|
137
131
|
default: true
|
|
@@ -382,7 +376,7 @@ command_sets:
|
|
|
382
376
|
|
|
383
377
|
- name: guardrails
|
|
384
378
|
aliases: [g]
|
|
385
|
-
description: Path to guardrails.yaml.
|
|
379
|
+
description: Path to micro-contracts.guardrails.yaml.
|
|
386
380
|
value_name: path
|
|
387
381
|
schema:
|
|
388
382
|
type: string
|
|
@@ -493,7 +487,7 @@ command_sets:
|
|
|
493
487
|
|
|
494
488
|
- name: guardrails
|
|
495
489
|
aliases: [g]
|
|
496
|
-
description: Path to guardrails.yaml.
|
|
490
|
+
description: Path to micro-contracts.guardrails.yaml.
|
|
497
491
|
value_name: path
|
|
498
492
|
schema:
|
|
499
493
|
type: string
|
|
@@ -547,12 +541,6 @@ command_sets:
|
|
|
547
541
|
type: boolean
|
|
548
542
|
default: false
|
|
549
543
|
|
|
550
|
-
- name: docs-only
|
|
551
|
-
description: Generate documentation only.
|
|
552
|
-
schema:
|
|
553
|
-
type: boolean
|
|
554
|
-
default: false
|
|
555
|
-
|
|
556
544
|
- name: force
|
|
557
545
|
description: Bypass input hash cache and always regenerate.
|
|
558
546
|
schema:
|
|
@@ -588,7 +576,7 @@ command_sets:
|
|
|
588
576
|
side_effects:
|
|
589
577
|
- file_write
|
|
590
578
|
recommended_before_use:
|
|
591
|
-
- Ensure micro-contracts.config.yaml and guardrails.yaml exist.
|
|
579
|
+
- Ensure micro-contracts.config.yaml and micro-contracts.guardrails.yaml exist.
|
|
592
580
|
- Verify OpenAPI specs are valid.
|
|
593
581
|
|
|
594
582
|
# ── deps ─────────────────────────────────────────
|
|
@@ -725,26 +713,26 @@ command_sets:
|
|
|
725
713
|
# ── guardrails-init ──────────────────────────────
|
|
726
714
|
guardrails-init:
|
|
727
715
|
path: [guardrails-init]
|
|
728
|
-
summary: Create a guardrails.yaml configuration file.
|
|
716
|
+
summary: Create a micro-contracts.guardrails.yaml configuration file.
|
|
729
717
|
description: >-
|
|
730
|
-
Generates a starter guardrails.yaml with default check
|
|
718
|
+
Generates a starter micro-contracts.guardrails.yaml with default check
|
|
731
719
|
configuration. Fails if the target file already exists.
|
|
732
720
|
usage:
|
|
733
721
|
- micro-contracts guardrails-init
|
|
734
|
-
- micro-contracts guardrails-init -o custom-guardrails.yaml
|
|
722
|
+
- micro-contracts guardrails-init -o custom-micro-contracts.guardrails.yaml
|
|
735
723
|
|
|
736
724
|
options:
|
|
737
725
|
- name: output
|
|
738
726
|
aliases: [o]
|
|
739
|
-
description: Output path for guardrails.
|
|
727
|
+
description: Output path for the guardrails configuration.
|
|
740
728
|
value_name: path
|
|
741
729
|
schema:
|
|
742
730
|
type: string
|
|
743
|
-
default: guardrails.yaml
|
|
731
|
+
default: micro-contracts.guardrails.yaml
|
|
744
732
|
|
|
745
733
|
exits:
|
|
746
734
|
'0':
|
|
747
|
-
description:
|
|
735
|
+
description: Guardrails configuration created successfully.
|
|
748
736
|
stdout:
|
|
749
737
|
format: text
|
|
750
738
|
files:
|
|
@@ -1218,7 +1206,7 @@ command_sets:
|
|
|
1218
1206
|
path: [audit-guardrails]
|
|
1219
1207
|
summary: Audit guardrails configuration for drift and lint coverage.
|
|
1220
1208
|
description: >-
|
|
1221
|
-
Checks that guardrails.yaml configuration covers all generated
|
|
1209
|
+
Checks that micro-contracts.guardrails.yaml configuration covers all generated
|
|
1222
1210
|
output directories for drift detection and that OpenAPI lint
|
|
1223
1211
|
rules are properly configured. Note: file permission and
|
|
1224
1212
|
editing checks have been moved to artifact-contracts.
|
|
@@ -1242,7 +1230,7 @@ command_sets:
|
|
|
1242
1230
|
|
|
1243
1231
|
- name: guardrails
|
|
1244
1232
|
aliases: [g]
|
|
1245
|
-
description: Path to guardrails.yaml.
|
|
1233
|
+
description: Path to micro-contracts.guardrails.yaml.
|
|
1246
1234
|
value_name: path
|
|
1247
1235
|
schema:
|
|
1248
1236
|
type: string
|
|
@@ -1313,7 +1301,7 @@ command_sets:
|
|
|
1313
1301
|
format: text
|
|
1314
1302
|
|
|
1315
1303
|
'3':
|
|
1316
|
-
description: Input validation failed (guardrails.yaml not found).
|
|
1304
|
+
description: Input validation failed (micro-contracts.guardrails.yaml not found).
|
|
1317
1305
|
stderr:
|
|
1318
1306
|
format: text
|
|
1319
1307
|
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export declare function buildAuditOpenapiContext(configPath: string | undefined, moduleName: string | undefined): Promise<string>;
|
|
2
|
+
export declare function buildReviewPublishedContext(configPath: string | undefined, moduleName: string | undefined): Promise<string>;
|
|
3
|
+
export declare function buildProposeOverlaysContext(configPath: string | undefined, moduleName: string | undefined): Promise<string>;
|
|
4
|
+
export declare function buildAuditGuardrailsContext(configPath: string | undefined, guardrailsPath: string | undefined): Promise<string>;
|
|
5
|
+
//# sourceMappingURL=context-builder.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/agents/context-builder.ts"],"names":[],"mappings":"AA+GA,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,MAAM,CAAC,CAmCjB;AAED,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,MAAM,CAAC,CA8CjB;AA2BD,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,MAAM,CAAC,CAsEjB"}
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
import fs from "fs";
|
|
2
|
+
import path from "path";
|
|
3
|
+
import { loadConfig, loadOpenAPISpec, lintSpec, formatLintResults } from "../generator/index.js";
|
|
4
|
+
import { isMultiModuleConfig } from "../types.js";
|
|
5
|
+
import { loadGuardrailsConfigWithPath } from "../guardrails/index.js";
|
|
6
|
+
function findConfigFile() {
|
|
7
|
+
const candidates = [
|
|
8
|
+
"micro-contracts.config.yaml",
|
|
9
|
+
"micro-contracts.config.yml",
|
|
10
|
+
"api-framework.config.yaml",
|
|
11
|
+
"api-framework.config.yml",
|
|
12
|
+
];
|
|
13
|
+
for (const c of candidates) {
|
|
14
|
+
const p = path.resolve(c);
|
|
15
|
+
if (fs.existsSync(p))
|
|
16
|
+
return p;
|
|
17
|
+
}
|
|
18
|
+
return null;
|
|
19
|
+
}
|
|
20
|
+
function loadModules(configPath, moduleName) {
|
|
21
|
+
const resolved = configPath ? path.resolve(configPath) : findConfigFile();
|
|
22
|
+
if (!resolved || !fs.existsSync(resolved)) {
|
|
23
|
+
throw Object.assign(new Error(`Config file not found: ${resolved ?? "micro-contracts.config.yaml"}`), { exitCode: 3 });
|
|
24
|
+
}
|
|
25
|
+
const config = loadConfig(resolved);
|
|
26
|
+
if (!isMultiModuleConfig(config)) {
|
|
27
|
+
throw Object.assign(new Error("Config must be a multi-module config with modules defined."), { exitCode: 3 });
|
|
28
|
+
}
|
|
29
|
+
const modules = [];
|
|
30
|
+
for (const [name, modConfig] of Object.entries(config.modules)) {
|
|
31
|
+
if (moduleName && name !== moduleName)
|
|
32
|
+
continue;
|
|
33
|
+
const specPath = path.resolve(path.dirname(resolved), modConfig.openapi);
|
|
34
|
+
if (!fs.existsSync(specPath))
|
|
35
|
+
continue;
|
|
36
|
+
const spec = loadOpenAPISpec(specPath);
|
|
37
|
+
modules.push({ name, spec, specPath });
|
|
38
|
+
}
|
|
39
|
+
return { config, configPath: resolved, modules };
|
|
40
|
+
}
|
|
41
|
+
function formatSpec(_spec, specPath) {
|
|
42
|
+
const raw = fs.readFileSync(specPath, "utf-8");
|
|
43
|
+
const maxLen = 24000;
|
|
44
|
+
if (raw.length > maxLen) {
|
|
45
|
+
return raw.slice(0, maxLen) + "\n# (truncated)";
|
|
46
|
+
}
|
|
47
|
+
return raw;
|
|
48
|
+
}
|
|
49
|
+
function collectOverlays(config, configPath) {
|
|
50
|
+
const overlays = [];
|
|
51
|
+
const baseDir = path.dirname(configPath);
|
|
52
|
+
const sharedOverlays = config.defaults?.overlays?.shared ?? [];
|
|
53
|
+
for (const o of sharedOverlays) {
|
|
54
|
+
const p = path.resolve(baseDir, o);
|
|
55
|
+
if (fs.existsSync(p)) {
|
|
56
|
+
overlays.push(`### ${o}\n\n\`\`\`yaml\n${fs.readFileSync(p, "utf-8")}\n\`\`\``);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
for (const [, modConfig] of Object.entries(config.modules)) {
|
|
60
|
+
const modOverlays = modConfig.overlays ?? [];
|
|
61
|
+
for (const o of modOverlays) {
|
|
62
|
+
const p = path.resolve(baseDir, o);
|
|
63
|
+
if (fs.existsSync(p)) {
|
|
64
|
+
overlays.push(`### ${o}\n\n\`\`\`yaml\n${fs.readFileSync(p, "utf-8")}\n\`\`\``);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
return overlays;
|
|
69
|
+
}
|
|
70
|
+
function buildDepsSection(config, configPath) {
|
|
71
|
+
const lines = [];
|
|
72
|
+
for (const [name, modConfig] of Object.entries(config.modules)) {
|
|
73
|
+
const specPath = path.resolve(path.dirname(configPath), modConfig.openapi);
|
|
74
|
+
if (!fs.existsSync(specPath))
|
|
75
|
+
continue;
|
|
76
|
+
const spec = loadOpenAPISpec(specPath);
|
|
77
|
+
const deps = spec.info["x-micro-contracts-depend-on"] ?? [];
|
|
78
|
+
const configDeps = modConfig.dependsOn ?? [];
|
|
79
|
+
const allDeps = [...new Set([...deps, ...configDeps])];
|
|
80
|
+
if (allDeps.length > 0) {
|
|
81
|
+
lines.push(`- ${name} → ${allDeps.join(", ")}`);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
return lines.length > 0 ? lines.join("\n") : null;
|
|
85
|
+
}
|
|
86
|
+
export async function buildAuditOpenapiContext(configPath, moduleName) {
|
|
87
|
+
const { config, configPath: resolved, modules } = loadModules(configPath, moduleName);
|
|
88
|
+
const sections = [];
|
|
89
|
+
sections.push("# OpenAPI Design Audit Request");
|
|
90
|
+
sections.push(`## Project Configuration\n\n` +
|
|
91
|
+
`\`\`\`yaml\n${fs.readFileSync(resolved, "utf-8")}\n\`\`\``);
|
|
92
|
+
for (const mod of modules) {
|
|
93
|
+
sections.push(`## Module: ${mod.name}\n\n` +
|
|
94
|
+
`### OpenAPI Specification (${path.basename(mod.specPath)})\n\n` +
|
|
95
|
+
`\`\`\`yaml\n${formatSpec(mod.spec, mod.specPath)}\n\`\`\``);
|
|
96
|
+
const lintResult = lintSpec(mod.spec, { strict: false });
|
|
97
|
+
if (!lintResult.valid || lintResult.warnings.length > 0) {
|
|
98
|
+
sections.push(`### Lint Results\n\n${formatLintResults(lintResult)}`);
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
const overlays = collectOverlays(config, resolved);
|
|
102
|
+
if (overlays.length > 0) {
|
|
103
|
+
sections.push(`## Existing Overlays\n\n${overlays.join("\n\n")}`);
|
|
104
|
+
}
|
|
105
|
+
const deps = buildDepsSection(config, resolved);
|
|
106
|
+
if (deps) {
|
|
107
|
+
sections.push(`## Module Dependency Graph\n\n${deps}`);
|
|
108
|
+
}
|
|
109
|
+
return sections.join("\n\n");
|
|
110
|
+
}
|
|
111
|
+
export async function buildReviewPublishedContext(configPath, moduleName) {
|
|
112
|
+
const { config, configPath: resolved, modules } = loadModules(configPath, moduleName);
|
|
113
|
+
const sections = [];
|
|
114
|
+
sections.push("# Published API Review Request");
|
|
115
|
+
for (const mod of modules) {
|
|
116
|
+
sections.push(`## Module: ${mod.name}\n\n` +
|
|
117
|
+
`### Master Specification (${path.basename(mod.specPath)})\n\n` +
|
|
118
|
+
`\`\`\`yaml\n${formatSpec(mod.spec, mod.specPath)}\n\`\`\``);
|
|
119
|
+
const publishedDir = config.defaults?.contractPublic?.output?.replace("{module}", mod.name)
|
|
120
|
+
?? `packages/contract-published/${mod.name}`;
|
|
121
|
+
if (fs.existsSync(publishedDir)) {
|
|
122
|
+
const files = fs.readdirSync(publishedDir, { recursive: true })
|
|
123
|
+
.filter((f) => String(f).endsWith(".ts"))
|
|
124
|
+
.slice(0, 10);
|
|
125
|
+
if (files.length > 0) {
|
|
126
|
+
const excerpts = files.map((f) => {
|
|
127
|
+
const content = fs.readFileSync(path.join(publishedDir, String(f)), "utf-8");
|
|
128
|
+
const truncated = content.length > 4000
|
|
129
|
+
? content.slice(0, 4000) + "\n// (truncated)"
|
|
130
|
+
: content;
|
|
131
|
+
return `#### ${f}\n\n\`\`\`typescript\n${truncated}\n\`\`\``;
|
|
132
|
+
});
|
|
133
|
+
sections.push(`### Published Contracts\n\n${excerpts.join("\n\n")}`);
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
const nonExportable = extractNonExportable(mod.spec);
|
|
137
|
+
if (nonExportable.length > 0) {
|
|
138
|
+
sections.push(`### x-micro-contracts-non-exportable Schemas\n\n` +
|
|
139
|
+
nonExportable.map((s) => `- ${s}`).join("\n"));
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
const deps = buildDepsSection(config, resolved);
|
|
143
|
+
if (deps) {
|
|
144
|
+
sections.push(`## Module Dependency Graph\n\n${deps}`);
|
|
145
|
+
}
|
|
146
|
+
return sections.join("\n\n");
|
|
147
|
+
}
|
|
148
|
+
function extractNonExportable(spec) {
|
|
149
|
+
const result = [];
|
|
150
|
+
const schemas = spec.components?.schemas ?? {};
|
|
151
|
+
for (const [name, schema] of Object.entries(schemas)) {
|
|
152
|
+
if (schema && typeof schema === "object" && schema["x-micro-contracts-non-exportable"]) {
|
|
153
|
+
result.push(name);
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
if (spec.paths) {
|
|
157
|
+
for (const [, pathItem] of Object.entries(spec.paths)) {
|
|
158
|
+
if (!pathItem || typeof pathItem !== "object")
|
|
159
|
+
continue;
|
|
160
|
+
for (const method of ["get", "post", "put", "patch", "delete"]) {
|
|
161
|
+
const op = pathItem[method];
|
|
162
|
+
if (op && typeof op === "object" && op["x-micro-contracts-non-exportable"]) {
|
|
163
|
+
const opId = op.operationId ?? `${method} ${Object.keys(spec.paths).find((k) => spec.paths[k] === pathItem)}`;
|
|
164
|
+
result.push(String(opId));
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
return result;
|
|
170
|
+
}
|
|
171
|
+
export async function buildProposeOverlaysContext(configPath, moduleName) {
|
|
172
|
+
const { config, configPath: resolved, modules } = loadModules(configPath, moduleName);
|
|
173
|
+
const sections = [];
|
|
174
|
+
sections.push("# Overlay Proposal Request");
|
|
175
|
+
for (const mod of modules) {
|
|
176
|
+
sections.push(`## Module: ${mod.name}\n\n` +
|
|
177
|
+
`### OpenAPI Specification (${path.basename(mod.specPath)})\n\n` +
|
|
178
|
+
`\`\`\`yaml\n${formatSpec(mod.spec, mod.specPath)}\n\`\`\``);
|
|
179
|
+
}
|
|
180
|
+
const overlays = collectOverlays(config, resolved);
|
|
181
|
+
if (overlays.length > 0) {
|
|
182
|
+
sections.push(`## Existing Overlays\n\n${overlays.join("\n\n")}`);
|
|
183
|
+
}
|
|
184
|
+
else {
|
|
185
|
+
sections.push("## Existing Overlays\n\nNo existing overlays found.");
|
|
186
|
+
}
|
|
187
|
+
sections.push(`## Project Configuration\n\n` +
|
|
188
|
+
`\`\`\`yaml\n${fs.readFileSync(resolved, "utf-8")}\n\`\`\``);
|
|
189
|
+
return sections.join("\n\n");
|
|
190
|
+
}
|
|
191
|
+
export async function buildAuditGuardrailsContext(configPath, guardrailsPath) {
|
|
192
|
+
const resolved = configPath ? path.resolve(configPath) : findConfigFile();
|
|
193
|
+
if (!resolved || !fs.existsSync(resolved)) {
|
|
194
|
+
throw Object.assign(new Error(`Config file not found: ${resolved ?? "micro-contracts.config.yaml"}`), { exitCode: 3 });
|
|
195
|
+
}
|
|
196
|
+
const config = loadConfig(resolved);
|
|
197
|
+
const sections = [];
|
|
198
|
+
sections.push("# Guardrails Coverage Audit Request");
|
|
199
|
+
const loaded = loadGuardrailsConfigWithPath(guardrailsPath);
|
|
200
|
+
if (!loaded.config) {
|
|
201
|
+
throw Object.assign(new Error(`guardrails.yaml not found${guardrailsPath ? `: ${guardrailsPath}` : ""}`), { exitCode: 3 });
|
|
202
|
+
}
|
|
203
|
+
if (loaded.configPath) {
|
|
204
|
+
sections.push(`## Guardrails Configuration (${loaded.configPath})\n\n` +
|
|
205
|
+
`\`\`\`yaml\n${fs.readFileSync(loaded.configPath, "utf-8")}\n\`\`\``);
|
|
206
|
+
}
|
|
207
|
+
sections.push(`## Project Configuration\n\n` +
|
|
208
|
+
`\`\`\`yaml\n${fs.readFileSync(resolved, "utf-8")}\n\`\`\``);
|
|
209
|
+
if (isMultiModuleConfig(config)) {
|
|
210
|
+
const outputDirs = [];
|
|
211
|
+
for (const [name, modConfig] of Object.entries(config.modules)) {
|
|
212
|
+
const contractDir = config.defaults?.contract?.output?.replace("{module}", name)
|
|
213
|
+
?? `packages/contract/${name}`;
|
|
214
|
+
outputDirs.push(contractDir);
|
|
215
|
+
if (config.defaults?.contractPublic) {
|
|
216
|
+
const pubDir = config.defaults.contractPublic.output?.replace("{module}", name)
|
|
217
|
+
?? `packages/contract-published/${name}`;
|
|
218
|
+
outputDirs.push(pubDir);
|
|
219
|
+
}
|
|
220
|
+
if (modConfig.outputs) {
|
|
221
|
+
for (const [, outConfig] of Object.entries(modConfig.outputs)) {
|
|
222
|
+
if (outConfig.output) {
|
|
223
|
+
outputDirs.push(outConfig.output.replace("{module}", name));
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
sections.push(`## Configured Output Directories\n\n` +
|
|
229
|
+
outputDirs.map((d) => `- ${d}`).join("\n"));
|
|
230
|
+
for (const [name, modConfig] of Object.entries(config.modules)) {
|
|
231
|
+
const specPath = path.resolve(path.dirname(resolved), modConfig.openapi);
|
|
232
|
+
if (fs.existsSync(specPath)) {
|
|
233
|
+
sections.push(`## Module Spec: ${name}\n\nPath: ${modConfig.openapi}`);
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
return sections.join("\n\n");
|
|
238
|
+
}
|
|
239
|
+
//# sourceMappingURL=context-builder.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../../src/agents/context-builder.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { AuditRunResult, AuditOptions } from "./types.js";
|
|
2
|
+
export type ReportFormat = "json" | "text" | "yaml";
|
|
3
|
+
export declare function computeExitCode(result: AuditRunResult, options: AuditOptions): number;
|
|
4
|
+
export declare function formatResultText(result: AuditRunResult): string;
|
|
5
|
+
export declare function formatResultJson(result: AuditRunResult): string;
|
|
6
|
+
export declare function formatResultYaml(result: AuditRunResult): string;
|
|
7
|
+
export declare function formatResult(result: AuditRunResult, format: ReportFormat): string;
|
|
8
|
+
export declare function writeOutput(content: string, outputPath?: string): Promise<void>;
|
|
9
|
+
//# sourceMappingURL=formatter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/agents/formatter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAYrF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAwC/D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAK/D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAK/D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAMjF;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrF"}
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
import { writeFile } from "node:fs/promises";
|
|
2
|
+
export function computeExitCode(result, options) {
|
|
3
|
+
if (result.status !== "success" || !result.data)
|
|
4
|
+
return 1;
|
|
5
|
+
const failOn = options.failOn ?? "error";
|
|
6
|
+
const severityOrder = ["info", "warning", "error", "critical"];
|
|
7
|
+
const threshold = severityOrder.indexOf(failOn);
|
|
8
|
+
const hasBlocking = result.data.findings.some((f) => severityOrder.indexOf(f.severity) >= threshold);
|
|
9
|
+
return hasBlocking ? 10 : 0;
|
|
10
|
+
}
|
|
11
|
+
export function formatResultText(result) {
|
|
12
|
+
if (result.status !== "success" || !result.data) {
|
|
13
|
+
return result.errorMessage ?? `Task failed with status: ${result.status}`;
|
|
14
|
+
}
|
|
15
|
+
const data = result.data;
|
|
16
|
+
const lines = [];
|
|
17
|
+
lines.push(`Risk Level: ${data.riskLevel.toUpperCase()}`);
|
|
18
|
+
lines.push(`Summary: ${data.summary}`);
|
|
19
|
+
lines.push("");
|
|
20
|
+
if (data.findings.length > 0) {
|
|
21
|
+
lines.push(`Findings (${data.findings.length}):`);
|
|
22
|
+
lines.push("");
|
|
23
|
+
for (const finding of data.findings) {
|
|
24
|
+
const prefix = severityIcon(finding.severity);
|
|
25
|
+
lines.push(` ${prefix} [${finding.category}] ${finding.message}`);
|
|
26
|
+
if (finding.location) {
|
|
27
|
+
lines.push(` Location: ${finding.location}`);
|
|
28
|
+
}
|
|
29
|
+
if (finding.recommendation) {
|
|
30
|
+
lines.push(` Recommendation: ${finding.recommendation}`);
|
|
31
|
+
}
|
|
32
|
+
lines.push("");
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
if (data.recommendedActions && data.recommendedActions.length > 0) {
|
|
36
|
+
lines.push("Recommended Actions:");
|
|
37
|
+
for (const action of data.recommendedActions) {
|
|
38
|
+
lines.push(` - [${action.kind}] ${action.title}`);
|
|
39
|
+
if (action.command) {
|
|
40
|
+
lines.push(` $ ${action.command}`);
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
return lines.join("\n");
|
|
45
|
+
}
|
|
46
|
+
export function formatResultJson(result) {
|
|
47
|
+
if (!result.data) {
|
|
48
|
+
return JSON.stringify({ error: result.errorMessage, status: result.status }, null, 2);
|
|
49
|
+
}
|
|
50
|
+
return JSON.stringify(result.data, null, 2);
|
|
51
|
+
}
|
|
52
|
+
export function formatResultYaml(result) {
|
|
53
|
+
if (!result.data) {
|
|
54
|
+
return `error: ${JSON.stringify(result.errorMessage)}\nstatus: ${result.status}`;
|
|
55
|
+
}
|
|
56
|
+
return toSimpleYaml(result.data);
|
|
57
|
+
}
|
|
58
|
+
export function formatResult(result, format) {
|
|
59
|
+
switch (format) {
|
|
60
|
+
case "json": return formatResultJson(result);
|
|
61
|
+
case "yaml": return formatResultYaml(result);
|
|
62
|
+
case "text": return formatResultText(result);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
export async function writeOutput(content, outputPath) {
|
|
66
|
+
if (outputPath) {
|
|
67
|
+
await writeFile(outputPath, content + "\n", "utf-8");
|
|
68
|
+
}
|
|
69
|
+
else {
|
|
70
|
+
process.stdout.write(content + "\n");
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
function severityIcon(severity) {
|
|
74
|
+
switch (severity) {
|
|
75
|
+
case "critical": return "✖";
|
|
76
|
+
case "error": return "✖";
|
|
77
|
+
case "warning": return "⚠";
|
|
78
|
+
case "info": return "ℹ";
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
function indent(text, spaces = 2) {
|
|
82
|
+
const pad = " ".repeat(spaces);
|
|
83
|
+
return text.split("\n").map((l) => pad + l).join("\n");
|
|
84
|
+
}
|
|
85
|
+
function toSimpleYaml(obj, depth = 0) {
|
|
86
|
+
const pad = " ".repeat(depth);
|
|
87
|
+
if (obj === null || obj === undefined)
|
|
88
|
+
return `${pad}null`;
|
|
89
|
+
if (typeof obj === "string") {
|
|
90
|
+
if (obj.includes("\n"))
|
|
91
|
+
return `|\n${indent(obj, (depth + 1) * 2)}`;
|
|
92
|
+
return JSON.stringify(obj);
|
|
93
|
+
}
|
|
94
|
+
if (typeof obj === "number" || typeof obj === "boolean")
|
|
95
|
+
return String(obj);
|
|
96
|
+
if (Array.isArray(obj)) {
|
|
97
|
+
if (obj.length === 0)
|
|
98
|
+
return "[]";
|
|
99
|
+
return obj.map((item) => {
|
|
100
|
+
const val = toSimpleYaml(item, depth + 1);
|
|
101
|
+
if (typeof item === "object" && item !== null) {
|
|
102
|
+
return `${pad}- ${val.trimStart()}`;
|
|
103
|
+
}
|
|
104
|
+
return `${pad}- ${val}`;
|
|
105
|
+
}).join("\n");
|
|
106
|
+
}
|
|
107
|
+
if (typeof obj === "object") {
|
|
108
|
+
const entries = Object.entries(obj);
|
|
109
|
+
if (entries.length === 0)
|
|
110
|
+
return "{}";
|
|
111
|
+
return entries.map(([k, v]) => {
|
|
112
|
+
const val = toSimpleYaml(v, depth + 1);
|
|
113
|
+
if (typeof v === "object" && v !== null && !Array.isArray(v)) {
|
|
114
|
+
return `${pad}${k}:\n${val}`;
|
|
115
|
+
}
|
|
116
|
+
if (Array.isArray(v) && v.length > 0) {
|
|
117
|
+
return `${pad}${k}:\n${val}`;
|
|
118
|
+
}
|
|
119
|
+
return `${pad}${k}: ${val}`;
|
|
120
|
+
}).join("\n");
|
|
121
|
+
}
|
|
122
|
+
return String(obj);
|
|
123
|
+
}
|
|
124
|
+
//# sourceMappingURL=formatter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/agents/formatter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export { runAgentTask, EXIT_RUNTIME_MISSING, EXIT_ADAPTER_ERROR } from "./orchestrator.js";
|
|
2
|
+
export { computeExitCode, formatResultText, formatResultJson, formatResultYaml, formatResult, writeOutput } from "./formatter.js";
|
|
3
|
+
export type { ReportFormat } from "./formatter.js";
|
|
4
|
+
export { TASK_IDS } from "./types.js";
|
|
5
|
+
export type { TaskId, AuditConfig, AuditOptions, AuditRunResult } from "./types.js";
|
|
6
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClI,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
|