migraguard 0.9.2 → 0.10.1

package/cli-contract.yaml

@@ -3,7 +3,7 @@ cliContracts: 0.1.0
 
 info:
   title: migraguard CLI
-  version: 0.8.4
+  version: 0.10.1
   description: >-
     PostgreSQL-first schema-aware deployment control — idempotent SQL migrations
     with CI-enforced integrity checks, expand/contract migration orchestration,
@@ -342,6 +342,15 @@ commandSets:
           output and saves it to schema.sql.
         usage:
           - migraguard dump
+          - migraguard dump --dry-run
+
+        options:
+          - name: dry-run
+            aliases: [n]
+            description: Output normalized schema to stdout without writing schema.sql.
+            schema:
+              type: boolean
+              default: false
 
         exits:
           '0':
@@ -370,6 +379,7 @@ commandSets:
           sideEffectNote: >-
             Reads DB schema via pg_dump/mysqldump and writes normalized
             output to schema.sql.
+          safeDryRunOption: dry-run
           expectedDurationMs: 10000
           retryableExitCodes: [1]
 
@@ -1349,225 +1359,92 @@ commandSets:
 
 components:
   schemas:
-    # ── AI Agent Interoperability Schemas (SSoT) ─────────
-
-    # Conforms to agent-contracts dsl_base/components.yaml#/schemas/agent-evidence.
-    # Canonical property names are kind/target/location/excerpt (NOT type/content/source).
+    # ── AI Agent Interoperability Schemas ──────────────────
+    # Canonical definitions copied from agent-contracts dsl_base/components.yaml.
+    # Keep components.yaml in sync when upgrading agent-contracts.
     AgentEvidence:
-      type: object
-      description: Evidence supporting an agent finding.
-      required: [kind]
-      properties:
-        kind:
-          type: string
-          enum: [file, command, schema, diff, stdout, stderr, text]
-        target:
-          type: string
-          description: Target identifier (file path, command ID, schema name).
-        location:
-          type: string
-          description: Location within the target (line number, JSON pointer).
-        excerpt:
-          type: string
-          description: Relevant excerpt from the target.
-
+      $ref: 'components.yaml#/schemas/agent-evidence'
     AgentFinding:
-      type: object
-      description: A single finding from a migration audit.
-      required: [severity, category, message]
-      properties:
-        id:
-          type: string
-          description: Unique finding identifier.
-        severity:
-          type: string
-          enum: [info, warning, error, critical]
-        category:
-          type: string
-          description: >-
-            Finding category. Migration-specific categories:
-            lock_risk, idempotency, expand_contract, backfill_safety,
-            rollback_risk, deploy_order, allow_directive.
-        target:
-          type: string
-          description: Target of the finding (file path, SQL statement).
-        location:
-          type: string
-          description: Location within the target.
-        message:
-          type: string
-        recommendation:
-          type: string
-        confidence:
-          type: number
-          minimum: 0
-          maximum: 1
-          description: Confidence score (0-1) for LLM-generated findings.
-        evidence:
-          type: array
-          items:
-            $ref: '#/components/schemas/AgentEvidence'
-        details:
-          type: object
-          additionalProperties: true
-
+      $ref: 'components.yaml#/schemas/agent-finding'
     AgentRecommendedAction:
-      type: object
-      description: A recommended action from a migration audit.
-      required: [kind, title]
-      properties:
-        kind:
-          type: string
-          enum: [run_command, edit_file, review, confirm, block, ignore]
-        title:
-          type: string
-        command:
-          type: string
-          description: CLI command to run (for run_command kind).
-        target:
-          type: string
-          description: Target file or resource.
-        rationale:
-          type: string
-
+      $ref: 'components.yaml#/schemas/agent-recommended-action'
     MigrationAuditResult:
-      type: object
-      description: >-
-        Top-level result from a migration safety audit.
-        Conforms to cli-contracts AgentAuditResult reference schema.
-      required: [summary, riskLevel, findings]
-      properties:
-        summary:
-          type: string
-        riskLevel:
-          type: string
-          enum: [low, medium, high, critical]
-        findings:
-          type: array
-          items:
-            $ref: '#/components/schemas/AgentFinding'
-        recommendedActions:
-          type: array
-          items:
-            $ref: '#/components/schemas/AgentRecommendedAction'
-        metadata:
-          type: object
-          properties:
-            tool:
-              type: string
-            command:
-              type: string
-            version:
-              type: string
-            generatedAt:
-              type: string
-            adapter:
-              type: string
-            model:
-              type: string
+      $ref: 'components.yaml#/schemas/agent-audit-result'
 
     ExpandContractProposal:
       type: object
       description: >-
         Result from propose-expand-contract command. Contains the proposed
         phased migration group with SQL for each phase.
-      required: [summary, riskLevel, findings, phases]
-      properties:
-        summary:
-          type: string
-          description: Overview of the proposed decomposition.
-        riskLevel:
-          type: string
-          enum: [low, medium, high, critical]
-          description: Risk level of the original unsafe DDL.
-        findings:
-          type: array
-          items:
-            $ref: '#/components/schemas/AgentFinding'
-          description: Issues found in the original migration.
-        phases:
-          type: array
-          items:
-            type: object
-            required: [name, sql, description]
-            properties:
-              name:
-                type: string
-                enum: [expand, backfill, switch, contract]
-              sql:
-                type: string
-                description: SQL content for this phase.
-              description:
-                type: string
-                description: Human-readable description of what this phase does.
-              deploymentGate:
-                type: string
-                description: Gate condition to verify before proceeding to next phase.
-          description: Ordered list of migration phases.
-        recommendedActions:
-          type: array
-          items:
-            $ref: '#/components/schemas/AgentRecommendedAction'
-        metadata:
-          type: object
+      allOf:
+        - $ref: 'components.yaml#/schemas/agent-audit-result'
+        - type: object
+          required: [phases]
           properties:
-            tool:
-              type: string
-            command:
-              type: string
-            version:
-              type: string
-            generatedAt:
-              type: string
-            adapter:
+            summary:
               type: string
-            model:
+              description: Overview of the proposed decomposition.
+            riskLevel:
               type: string
+              enum: [low, medium, high, critical]
+              description: Risk level of the original unsafe DDL.
+            findings:
+              type: array
+              items:
+                $ref: '#/components/schemas/AgentFinding'
+              description: Issues found in the original migration.
+            phases:
+              type: array
+              items:
+                type: object
+                required: [name, sql, description]
+                properties:
+                  name:
+                    type: string
+                    enum: [expand, backfill, switch, contract]
+                  sql:
+                    type: string
+                    description: SQL content for this phase.
+                  description:
+                    type: string
+                    description: Human-readable description of what this phase does.
+                  deploymentGate:
+                    type: string
+                    description: Gate condition to verify before proceeding to next phase.
+              description: Ordered list of migration phases.
 
     ExplainResult:
       type: object
       description: >-
         Result from explain command. Contains a human-readable explanation
         of another command's output, suitable for PR comments or release decisions.
-      required: [summary, riskLevel, findings, explanation]
-      properties:
-        summary:
-          type: string
-          description: One-line summary for quick scanning.
-        riskLevel:
-          type: string
-          enum: [low, medium, high, critical]
-          description: Assessed urgency of the underlying issue.
-        explanation:
-          type: string
-          description: >-
-            Multi-paragraph human-readable explanation in Markdown format.
-            Written for non-DBA audiences.
-        findings:
-          type: array
-          items:
-            $ref: '#/components/schemas/AgentFinding'
-          description: Key points extracted from the command output.
-        recommendedActions:
-          type: array
-          items:
-            $ref: '#/components/schemas/AgentRecommendedAction'
-          description: Concrete next steps for the reader.
-        sourceCommand:
-          type: string
-          description: The command that produced the input (e.g. "migraguard lint").
-        metadata:
-          type: object
+      allOf:
+        - $ref: 'components.yaml#/schemas/agent-audit-result'
+        - type: object
+          required: [explanation]
           properties:
-            tool:
-              type: string
-            command:
-              type: string
-            version:
+            summary:
               type: string
-            generatedAt:
+              description: One-line summary for quick scanning.
+            riskLevel:
               type: string
-            adapter:
+              enum: [low, medium, high, critical]
+              description: Assessed urgency of the underlying issue.
+            explanation:
               type: string
-            model:
+              description: >-
+                Multi-paragraph human-readable explanation in Markdown format.
+                Written for non-DBA audiences.
+            findings:
+              type: array
+              items:
+                $ref: '#/components/schemas/AgentFinding'
+              description: Key points extracted from the command output.
+            recommendedActions:
+              type: array
+              items:
+                $ref: '#/components/schemas/AgentRecommendedAction'
+              description: Concrete next steps for the reader.
+            sourceCommand:
               type: string
+              description: The command that produced the input (e.g. "migraguard lint").

package/docs/cli-reference.md

@@ -337,6 +337,15 @@ Executes pg_dump (PostgreSQL), mysqldump (MySQL), or sqlite3 .schema (SQLite) to
 ```
 migraguard dump
 ```
+```
+migraguard dump --dry-run
+```
+
+#### Options
+
+| Option | Aliases | Required | Default | Description |
+|---|---|---|---|---|
+| `--dry-run` | -n | No | `false` | Output normalized schema to stdout without writing schema.sql. |
 
 #### Exit Codes
 
@@ -362,6 +371,7 @@ x-agent:
     - database_read
     - file_write
   sideEffectNote: Reads DB schema via pg_dump/mysqldump and writes normalized output to schema.sql.
+  safeDryRunOption: dry-run
   expectedDurationMs: 10000
   retryableExitCodes: 
     - 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "migraguard",
-  "version": "0.9.2",
+  "version": "0.10.1",
   "description": "PostgreSQL schema-aware deployment control — idempotent SQL migrations with CI-enforced integrity checks, expand/contract migration orchestration, schema drift detection, and unified gating across database, application, and infrastructure rollouts",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,7 +57,7 @@
     "deployment-gate"
   ],
   "peerDependencies": {
-    "agent-contracts-runtime": ">=0.12.0",
+    "agent-contracts-runtime": ">=0.13.0",
     "better-sqlite3": ">=11.0.0",
     "mysql2": ">=3.0.0"
   },
@@ -94,8 +94,8 @@
     "@typescript-eslint/eslint-plugin": "^8.54.0",
     "@typescript-eslint/parser": "^8.54.0",
     "agent-contracts": "^0.17.1",
-    "agent-contracts-runtime": "^0.12.1",
-    "cli-contracts": "^0.5.2",
+    "agent-contracts-runtime": "^0.13.0",
+    "cli-contracts": "^0.6.0",
     "eslint": "^9.39.2",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",