artifact-contracts 0.1.0 → 0.2.0

package/dist/generated/types.d.ts

@@ -0,0 +1,187 @@
+export interface ValidateOptions {
+    config?: unknown;
+    checkFiles?: boolean;
+}
+export type ValidateExitCode = 0 | 1 | 2 | 3;
+export type ValidateExitResult = {
+    exitCode: 0;
+} | {
+    exitCode: 1;
+} | {
+    exitCode: 2;
+} | {
+    exitCode: 3;
+};
+export interface ResolveOptions {
+    config?: unknown;
+    format?: "yaml" | "json";
+}
+export type ResolveExitCode = 0 | 1 | 3;
+export type ResolveExitResult = {
+    exitCode: 0;
+} | {
+    exitCode: 1;
+} | {
+    exitCode: 3;
+};
+export interface ListOptions {
+    config?: unknown;
+    authority?: "canonical" | "derived" | "generated" | "control";
+    path?: unknown;
+    format?: "text" | "json" | "yaml";
+}
+export type ListExitCode = 0 | 1 | 3;
+export type ListExitResult = {
+    exitCode: 0;
+} | {
+    exitCode: 1;
+} | {
+    exitCode: 3;
+};
+export interface ExplainArgs {
+    path: unknown;
+}
+export interface ExplainOptions {
+    config?: unknown;
+    format?: "text" | "json" | "yaml";
+}
+export type ExplainExitCode = 0 | 2 | 3 | 4;
+export type ExplainExitResult = {
+    exitCode: 0;
+} | {
+    exitCode: 2;
+} | {
+    exitCode: 3;
+} | {
+    exitCode: 4;
+};
+export interface AuditOptions {
+    config?: unknown;
+    adapter?: "mock" | "cursor" | "openai" | "claude" | "gemini";
+    model?: unknown;
+    showPrompt?: boolean;
+    dryRun?: boolean;
+    failOn?: "info" | "warning" | "error" | "critical";
+    output?: unknown;
+    reportFormat?: "text" | "json" | "yaml";
+}
+export type AuditExitCode = 0 | 1 | 3 | 10 | 11 | 12;
+export type AuditExitResult = {
+    exitCode: 0;
+} | {
+    exitCode: 1;
+} | {
+    exitCode: 3;
+} | {
+    exitCode: 10;
+} | {
+    exitCode: 11;
+} | {
+    exitCode: 12;
+};
+export interface AgentFinding {
+    id: string;
+    severity: "critical" | "error" | "warning" | "info";
+    category: string;
+    title: string;
+    description: string;
+    location?: string;
+    target?: string;
+    recommendation?: string;
+    evidence?: {
+        kind: "schema" | "code" | "config" | "runtime" | "doc";
+        target?: string;
+        location?: string;
+        excerpt?: string;
+        reasoning?: string;
+    }[];
+}
+export interface AgentAuditResult {
+    summary: string;
+    riskLevel: "none" | "low" | "medium" | "high" | "critical";
+    findings: {
+        id: string;
+        severity: "critical" | "error" | "warning" | "info";
+        category: string;
+        title: string;
+        description: string;
+        location?: string;
+        target?: string;
+        recommendation?: string;
+        evidence?: {
+            kind: "schema" | "code" | "config" | "runtime" | "doc";
+            target?: string;
+            location?: string;
+            excerpt?: string;
+            reasoning?: string;
+        }[];
+    }[];
+    recommendedActions: {
+        action: string;
+        priority: "high" | "medium" | "low";
+        description?: string;
+    }[];
+    metadata?: {
+        totalArtifacts?: number;
+        analyzedArtifacts?: number;
+        analysisScope?: string;
+    };
+}
+export interface AgentEvidence {
+    kind: "schema" | "code" | "config" | "runtime" | "doc";
+    target?: string;
+    location?: string;
+    excerpt?: string;
+    reasoning?: string;
+}
+export interface AgentRecommendedAction {
+    action: string;
+    priority: "high" | "medium" | "low";
+    description?: string;
+}
+export interface ResolvedDefinitions {
+    artifactContracts: string;
+    system: {
+        id: string;
+        name?: string;
+    };
+    artifacts: Record<string, unknown>;
+}
+export interface ArtifactExplanation {
+    id: string;
+    type: string;
+    authority: string;
+    manual_edit: string;
+    change_control: string;
+    visibility?: string;
+    description?: string;
+    path_patterns?: string[];
+    exclude_patterns?: string[];
+}
+export interface ArtifactDefinition {
+    type: string;
+    authority: "canonical" | "derived" | "generated" | "control";
+    manual_edit: "allowed" | "discouraged" | "forbidden";
+    change_control: "none" | "approval-required" | "regeneration-required";
+    visibility: "public" | "internal" | "private";
+    description?: string;
+    path_patterns: string[];
+    exclude_patterns?: string[];
+    states?: string[];
+}
+export interface ArtifactList {
+    artifacts?: Record<string, unknown>;
+}
+export interface ValidationResult {
+    valid: boolean;
+    diagnostics: {
+        path?: string;
+        message: string;
+        severity: "error" | "warning";
+    }[];
+    overlaps: {
+        path: string;
+        matchingArtifacts: string[];
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/generated/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generated/types.ts"],"names":[],"mappings":"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"}

package/dist/generated/types.js

@@ -0,0 +1,3 @@
+// Auto-generated by cli-contracts. Do not edit.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/generated/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/generated/types.ts"],"names":[],"mappings":"AAAA,gDAAgD"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-declare const VERSION = "0.1.0";
-
-export { VERSION };
+export declare const VERSION: string;
+export { ArtifactContractsDocumentSchema, ArtifactContractsConfigSchema, ArtifactDefinitionSchema, SystemSchema, AuthoritySchema, ManualEditSchema, ChangeControlSchema, VisibilitySchema, ARTIFACT_ID_PATTERN, applyDefaults, loadConfig, loadDocument, resolveDocument, matchesArtifact, lookupByPath, detectOverlaps, validateDocument, } from "./core/index.js";
+export type { Authority, ManualEdit, ChangeControl, Visibility, ArtifactDefinition, ArtifactContractsDocument, ArtifactContractsConfig, ResolvedArtifact, LoadResult, ResolvedDocument, LookupResult, LookupOverlap, Diagnostic, ValidationResult, } from "./core/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AAE3C,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,EAC7B,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,5 +1,3 @@
-// src/index.ts
-var VERSION = "0.1.0";
-export {
-  VERSION
-};
+export const VERSION = __VERSION__;
+export { ArtifactContractsDocumentSchema, ArtifactContractsConfigSchema, ArtifactDefinitionSchema, SystemSchema, AuthoritySchema, ManualEditSchema, ChangeControlSchema, VisibilitySchema, ARTIFACT_ID_PATTERN, applyDefaults, loadConfig, loadDocument, resolveDocument, matchesArtifact, lookupByPath, detectOverlaps, validateDocument, } from "./core/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,CAAC;AAE3C,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,EAC7B,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,36 +1,48 @@
 {
   "name": "artifact-contracts",
-  "version": "0.1.0",
-  "description": "Declarative contract DSL for managing AI-generated artifacts — versioning, validation, and lifecycle control",
+  "version": "0.2.0",
+  "description": "Declarative artifact registry — define file properties, resolve paths to artifact IDs, and detect definition overlaps",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "artifact-contracts": "dist/cli/index.js"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./core": {
+      "import": "./dist/core/index.js",
+      "types": "./dist/core/index.d.ts"
     }
   },
   "files": [
     "dist",
+    "schemas",
+    "cli-contract.yaml",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsc",
     "clean": "rm -rf dist",
-    "test:unit": "echo 'no tests yet'",
+    "schema:build": "npx tsx scripts/bump-schema.ts",
+    "test:unit": "vitest run",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run clean && npm run build"
+    "contract:validate": "npx cli-contracts validate",
+    "contract:generate": "npx cli-contracts generate",
+    "dsl:generate": "npx agent-runtime generate --config dsl/agent-runtime.config.yaml && npx tsx scripts/fix-generated-imports.ts",
+    "prepublishOnly": "npm run clean && npm run build && npm run schema:build && npm run test:unit"
   },
   "keywords": [
     "artifact",
     "contracts",
     "ai",
     "dsl",
-    "validation",
-    "versioning",
-    "lifecycle"
+    "registry",
+    "validation"
   ],
   "author": "foo-ogawa",
   "license": "MIT",
@@ -42,9 +54,34 @@
   "bugs": {
     "url": "https://github.com/foo-ogawa/artifact-contracts/issues"
   },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "glob": "^11.0.0",
+    "js-yaml": "^4.1.0",
+    "minimatch": "^10.2.5",
+    "yaml": "^2.7.0",
+    "zod": "^3.22.4"
+  },
+  "peerDependencies": {
+    "agent-contracts-runtime": ">=0.13.0"
+  },
+  "peerDependenciesMeta": {
+    "agent-contracts-runtime": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "tsup": "^8.5.1",
-    "typescript": "^6.0.2"
+    "@anthropic-ai/claude-agent-sdk": "^0.2.140",
+    "@google/genai": "^2.2.0",
+    "@openai/agents": "^0.11.4",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.7.0",
+    "agent-contracts": "^0.22.3",
+    "agent-contracts-runtime": "^0.13.0",
+    "cli-contracts": "^0.7.0",
+    "tsx": "^4.19.0",
+    "typescript": "^6.0.2",
+    "vitest": "^2.0.0"
   },
   "engines": {
     "node": ">=20.0.0"

package/schemas/2026A.config.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/foo-ogawa/artifact-contracts/schemas/2026A.config.json",
+  "title": "Artifact Contracts Config",
+  "description": "Schema for artifact-contracts.config.yaml — processing configuration and variables.",
+  "version": "2026A",
+  "$ref": "#/definitions/ArtifactContractsConfig",
+  "definitions": {
+    "ArtifactContractsConfig": {
+      "type": "object",
+      "properties": {
+        "input": {
+          "type": "object",
+          "properties": {
+            "files": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [
+                "artifact-contracts.yaml"
+              ]
+            }
+          },
+          "additionalProperties": false
+        },
+        "variables": {
+          "type": "object",
+          "additionalProperties": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            ]
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/2026A.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/foo-ogawa/artifact-contracts/schemas/2026A.json",
+  "title": "Artifact Contracts Document",
+  "description": "Schema for artifact-contracts.yaml — declarative artifact registry definitions.",
+  "version": "2026A",
+  "$ref": "#/definitions/ArtifactContractsDocument",
+  "definitions": {
+    "ArtifactContractsDocument": {
+      "type": "object",
+      "properties": {
+        "artifactContracts": {
+          "type": "string",
+          "minLength": 1
+        },
+        "system": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "name": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        "artifacts": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": {
+                "type": "string"
+              },
+              "authority": {
+                "type": "string",
+                "enum": [
+                  "canonical",
+                  "derived",
+                  "generated",
+                  "control"
+                ]
+              },
+              "path_patterns": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "minItems": 1
+              },
+              "exclude_patterns": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "manual_edit": {
+                "type": "string",
+                "enum": [
+                  "allowed",
+                  "discouraged",
+                  "forbidden"
+                ]
+              },
+              "change_control": {
+                "type": "string",
+                "enum": [
+                  "none",
+                  "approval-required",
+                  "regeneration-required"
+                ]
+              },
+              "visibility": {
+                "type": "string",
+                "enum": [
+                  "public",
+                  "internal",
+                  "private"
+                ]
+              },
+              "states": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "type",
+              "authority",
+              "path_patterns"
+            ],
+            "additionalProperties": true
+          }
+        }
+      },
+      "required": [
+        "artifactContracts",
+        "system",
+        "artifacts"
+      ],
+      "additionalProperties": false
+    }
+  }
+}