micro-contracts 0.17.1 → 0.17.3

package/docs/cli-reference.md

@@ -13,6 +13,7 @@ Contract-first OpenAPI toolchain for TypeScript Web/API systems. Generates contr
   - [check](#micro-contracts-check)
   - [pipeline](#micro-contracts-pipeline)
   - [deps](#micro-contracts-deps)
+  - [insights](#micro-contracts-insights)
   - [guardrails-init](#micro-contracts-guardrails-init)
   - [manifest](#micro-contracts-manifest)
   - [audit-openapi](#micro-contracts-audit-openapi)
@@ -417,6 +418,52 @@ x-agent:
 
 ---
 
+### insights
+
+Emit ExternalInsight JSON for agent-contracts-analyzer.
+
+Reads x-micro-contracts-depend-on from OpenAPI specs and outputs structured dependency edges and anchor mappings as JSON on stdout. Used by agent-contracts-analyzer CommandProvider integration.
+
+**Usage:**
+
+```
+micro-contracts insights --format json
+```
+```
+micro-contracts insights --format json --project-root .
+```
+
+#### Options
+
+| Option | Aliases | Required | Default | Description |
+|---|---|---|---|---|
+| `--format` |  | No | `"json"` | Output format (json only). |
+| `--project-root` |  | No | `"."` | Project root directory containing micro-contracts.config.yaml. |
+| `--config` | -c | No |  | Path to config file (micro-contracts.config.yaml). |
+
+#### Exit Codes
+
+**Exit 0:** ExternalInsight JSON written to stdout.
+
+- **stdout:** format=`json`
+
+**Exit 1:** Insights generation failed.
+
+- **stderr:** format=`text`
+
+#### Extensions
+
+```yaml
+x-agent: 
+  risk_level: low
+  requires_confirmation: false
+  idempotent: true
+  side_effects: 
+
+```
+
+---
+
 ### guardrails-init
 
 Create a guardrails.yaml configuration file.
@@ -551,6 +598,7 @@ micro-contracts audit-openapi --show-prompt
 | `--fail-on` |  | No | `"error"` | Minimum severity that causes a non-zero exit. |
 | `--output` | -o | No |  | Write result to a file instead of stdout. |
 | `--report-format` |  | No | `"text"` | Output format for the audit report. |
+| `--log-file` | -l | No |  | Write agent progress log to this file path. |
 
 #### Exit Codes
 
@@ -618,6 +666,7 @@ micro-contracts review-published --adapter claude --report-format json
 | `--fail-on` |  | No | `"error"` | Minimum severity that causes a non-zero exit. |
 | `--output` | -o | No |  | Write result to a file instead of stdout. |
 | `--report-format` |  | No | `"text"` | Output format for the review report. |
+| `--log-file` | -l | No |  | Write agent progress log to this file path. |
 
 #### Exit Codes
 
@@ -685,6 +734,7 @@ micro-contracts propose-overlays --adapter openai --report-format json
 | `--fail-on` |  | No | `"error"` | Minimum severity that causes a non-zero exit. |
 | `--output` | -o | No |  | Write result to a file instead of stdout. |
 | `--report-format` |  | No | `"json"` | Output format for the proposal report. |
+| `--log-file` | -l | No |  | Write agent progress log to this file path. |
 
 #### Exit Codes
 
@@ -749,6 +799,7 @@ micro-contracts audit-guardrails --adapter mock --report-format json
 | `--fail-on` |  | No | `"error"` | Minimum severity that causes a non-zero exit. |
 | `--output` | -o | No |  | Write result to a file instead of stdout. |
 | `--report-format` |  | No | `"text"` | Output format for the audit report. |
+| `--log-file` | -l | No |  | Write agent progress log to this file path. |
 
 #### Exit Codes
 

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "micro-contracts",
-  "version": "0.17.1",
+  "version": "0.17.3",
   "description": "Contract-first OpenAPI toolchain that keeps TypeScript UI and microservices aligned via code generation",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    "./insight-provider": {
+      "import": "./dist/external/insight-provider.js",
+      "types": "./dist/external/insight-provider.d.ts"
+    }
+  },
   "bin": {
     "micro-contracts": "dist/micro-contracts.bundle.mjs"
   },
@@ -13,12 +19,16 @@
     "dist/micro-contracts.bundle.mjs.map",
     "dist/index.js",
     "dist/index.d.ts",
+    "dist/external/insight-provider.js",
+    "dist/external/insight-provider.d.ts",
     "docs",
     "cli-contract.yaml",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "vendor/agent-contracts-analyzer-0.1.1.tgz"
   ],
   "scripts": {
+    "prebuild": "node scripts/ensure-agent-contracts-analyzer.mjs",
     "build": "tsc",
     "bundle": "node esbuild.bundle.mjs",
     "bundle:min": "node esbuild.bundle.mjs --minify",
@@ -61,7 +71,8 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.0",
     "agent-contracts": "^0.33.1",
-    "agent-contracts-runtime": "^0.32.10",
+    "agent-contracts-analyzer": "file:vendor/agent-contracts-analyzer-0.1.1.tgz",
+    "agent-contracts-runtime": "^0.35.7",
     "chalk": "^5.3.0",
     "cli-contracts": "^0.32.0",
     "commander": "^12.1.0",

package/vendor/README.md

@@ -0,0 +1,9 @@
+# Vendored packages
+
+## agent-contracts-analyzer-0.1.1.tgz
+
+`npm pack` output from `agent-contracts-analyzer` tag `v0.1.1` (includes `dist/`).
+
+The private GitHub repository cannot be fetched from CI via `github:` dependencies without
+cross-repo credentials, so the tarball is committed and referenced as
+`file:vendor/agent-contracts-analyzer-0.1.1.tgz` in `package.json`.