artifact-contracts 0.1.0 → 0.2.0

package/dist/generated/policy.d.ts

@@ -0,0 +1,146 @@
+import type { DerivedPolicy, IntrospectionResult } from "cli-contracts/policy";
+export type { DerivedPolicy, IntrospectionResult };
+export declare const commandDefinitions: {
+    readonly validate: {
+        readonly effects: {
+            readonly riskLevel: "low";
+            readonly reads: readonly [{
+                readonly target: "artifact-definitions";
+                readonly description: "artifact-contracts.yaml and config";
+            }, {
+                readonly target: "repository-files";
+                readonly description: "All tracked files via git ls-files. Only read when --check-files is specified.";
+            }];
+            readonly executionMode: "normal";
+        };
+        readonly options: readonly [{
+            readonly name: "config";
+        }, {
+            readonly name: "check-files";
+            readonly schema: {
+                readonly type: "boolean";
+            };
+        }];
+    };
+    readonly resolve: {
+        readonly effects: {
+            readonly riskLevel: "low";
+            readonly reads: readonly [{
+                readonly target: "artifact-definitions";
+                readonly description: "artifact-contracts.yaml and config";
+            }];
+            readonly executionMode: "normal";
+        };
+        readonly options: readonly [{
+            readonly name: "config";
+        }, {
+            readonly name: "format";
+            readonly schema: {
+                readonly type: "string";
+                readonly enum: readonly ["yaml", "json"];
+            };
+        }];
+    };
+    readonly list: {
+        readonly effects: {
+            readonly riskLevel: "low";
+            readonly reads: readonly [{
+                readonly target: "artifact-definitions";
+                readonly description: "artifact-contracts.yaml and config";
+            }];
+            readonly executionMode: "normal";
+        };
+        readonly options: readonly [{
+            readonly name: "config";
+        }, {
+            readonly name: "authority";
+            readonly schema: {
+                readonly type: "string";
+                readonly enum: readonly ["canonical", "derived", "generated", "control"];
+            };
+        }, {
+            readonly name: "path";
+        }, {
+            readonly name: "format";
+            readonly schema: {
+                readonly type: "string";
+                readonly enum: readonly ["text", "json", "yaml"];
+            };
+        }];
+    };
+    readonly explain: {
+        readonly effects: {
+            readonly riskLevel: "low";
+            readonly reads: readonly [{
+                readonly target: "artifact-definitions";
+                readonly description: "artifact-contracts.yaml and config";
+            }];
+            readonly executionMode: "normal";
+        };
+        readonly options: readonly [{
+            readonly name: "config";
+        }, {
+            readonly name: "format";
+            readonly schema: {
+                readonly type: "string";
+                readonly enum: readonly ["text", "json", "yaml"];
+            };
+        }];
+    };
+    readonly audit: {
+        readonly effects: {
+            readonly riskLevel: "medium";
+            readonly reads: readonly [{
+                readonly target: "artifact-definitions";
+                readonly description: "artifact-contracts.yaml and config";
+            }];
+            readonly writes: readonly [{
+                readonly target: "output-file";
+                readonly description: "Written only when --output is specified";
+                readonly overwrite: true;
+            }];
+            readonly network: {
+                readonly description: "LLM API calls to configured provider";
+                readonly idempotent: false;
+            };
+            readonly executionMode: "normal";
+        };
+        readonly options: readonly [{
+            readonly name: "config";
+        }, {
+            readonly name: "adapter";
+            readonly schema: {
+                readonly type: "string";
+                readonly enum: readonly ["mock", "cursor", "openai", "claude", "gemini"];
+            };
+        }, {
+            readonly name: "model";
+        }, {
+            readonly name: "show-prompt";
+            readonly schema: {
+                readonly type: "boolean";
+            };
+        }, {
+            readonly name: "dry-run";
+            readonly schema: {
+                readonly type: "boolean";
+            };
+        }, {
+            readonly name: "fail-on";
+            readonly schema: {
+                readonly type: "string";
+                readonly enum: readonly ["info", "warning", "error", "critical"];
+            };
+        }, {
+            readonly name: "output";
+        }, {
+            readonly name: "report-format";
+            readonly schema: {
+                readonly type: "string";
+                readonly enum: readonly ["text", "json", "yaml"];
+            };
+        }];
+    };
+};
+export declare function deriveCommandPolicy(commandId: string, optionValues: Record<string, unknown>): IntrospectionResult;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/generated/policy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AAEnD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgNrB,CAAC;AAEX,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,mBAAmB,CA0BrB"}

package/dist/generated/policy.js

@@ -0,0 +1,236 @@
+// Auto-generated by cli-contracts. Do not edit.
+import { derivePolicy, isOptionActive } from "cli-contracts/policy";
+export const commandDefinitions = {
+    "validate": {
+        "effects": {
+            "riskLevel": "low",
+            "reads": [
+                {
+                    "target": "artifact-definitions",
+                    "description": "artifact-contracts.yaml and config"
+                },
+                {
+                    "target": "repository-files",
+                    "description": "All tracked files via git ls-files. Only read when --check-files is specified."
+                }
+            ],
+            "executionMode": "normal"
+        },
+        "options": [
+            {
+                "name": "config"
+            },
+            {
+                "name": "check-files",
+                "schema": {
+                    "type": "boolean"
+                }
+            }
+        ]
+    },
+    "resolve": {
+        "effects": {
+            "riskLevel": "low",
+            "reads": [
+                {
+                    "target": "artifact-definitions",
+                    "description": "artifact-contracts.yaml and config"
+                }
+            ],
+            "executionMode": "normal"
+        },
+        "options": [
+            {
+                "name": "config"
+            },
+            {
+                "name": "format",
+                "schema": {
+                    "type": "string",
+                    "enum": [
+                        "yaml",
+                        "json"
+                    ]
+                }
+            }
+        ]
+    },
+    "list": {
+        "effects": {
+            "riskLevel": "low",
+            "reads": [
+                {
+                    "target": "artifact-definitions",
+                    "description": "artifact-contracts.yaml and config"
+                }
+            ],
+            "executionMode": "normal"
+        },
+        "options": [
+            {
+                "name": "config"
+            },
+            {
+                "name": "authority",
+                "schema": {
+                    "type": "string",
+                    "enum": [
+                        "canonical",
+                        "derived",
+                        "generated",
+                        "control"
+                    ]
+                }
+            },
+            {
+                "name": "path"
+            },
+            {
+                "name": "format",
+                "schema": {
+                    "type": "string",
+                    "enum": [
+                        "text",
+                        "json",
+                        "yaml"
+                    ]
+                }
+            }
+        ]
+    },
+    "explain": {
+        "effects": {
+            "riskLevel": "low",
+            "reads": [
+                {
+                    "target": "artifact-definitions",
+                    "description": "artifact-contracts.yaml and config"
+                }
+            ],
+            "executionMode": "normal"
+        },
+        "options": [
+            {
+                "name": "config"
+            },
+            {
+                "name": "format",
+                "schema": {
+                    "type": "string",
+                    "enum": [
+                        "text",
+                        "json",
+                        "yaml"
+                    ]
+                }
+            }
+        ]
+    },
+    "audit": {
+        "effects": {
+            "riskLevel": "medium",
+            "reads": [
+                {
+                    "target": "artifact-definitions",
+                    "description": "artifact-contracts.yaml and config"
+                }
+            ],
+            "writes": [
+                {
+                    "target": "output-file",
+                    "description": "Written only when --output is specified",
+                    "overwrite": true
+                }
+            ],
+            "network": {
+                "description": "LLM API calls to configured provider",
+                "idempotent": false
+            },
+            "executionMode": "normal"
+        },
+        "options": [
+            {
+                "name": "config"
+            },
+            {
+                "name": "adapter",
+                "schema": {
+                    "type": "string",
+                    "enum": [
+                        "mock",
+                        "cursor",
+                        "openai",
+                        "claude",
+                        "gemini"
+                    ]
+                }
+            },
+            {
+                "name": "model"
+            },
+            {
+                "name": "show-prompt",
+                "schema": {
+                    "type": "boolean"
+                }
+            },
+            {
+                "name": "dry-run",
+                "schema": {
+                    "type": "boolean"
+                }
+            },
+            {
+                "name": "fail-on",
+                "schema": {
+                    "type": "string",
+                    "enum": [
+                        "info",
+                        "warning",
+                        "error",
+                        "critical"
+                    ]
+                }
+            },
+            {
+                "name": "output"
+            },
+            {
+                "name": "report-format",
+                "schema": {
+                    "type": "string",
+                    "enum": [
+                        "text",
+                        "json",
+                        "yaml"
+                    ]
+                }
+            }
+        ]
+    },
+};
+export function deriveCommandPolicy(commandId, optionValues) {
+    const def = commandDefinitions[commandId];
+    if (!def)
+        throw new Error(`Unknown command: ${commandId}`);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const cmdDef = def;
+    const options = {};
+    const activeOptions = [];
+    for (const optDef of cmdDef.options ?? []) {
+        const value = optionValues[optDef.name];
+        const specified = optDef.name in optionValues && value !== undefined;
+        options[optDef.name] = { value, specified, definition: optDef };
+        if (isOptionActive(optDef, value, specified)) {
+            activeOptions.push(optDef.name);
+        }
+    }
+    const policy = derivePolicy({
+        commandId,
+        commandEffects: cmdDef.effects,
+        options,
+        env: cmdDef.env,
+    });
+    return { command: commandId, activeOptions, policy };
+}
+//# sourceMappingURL=policy.js.map

package/dist/generated/policy.js.map

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

package/dist/generated/program.d.ts

@@ -0,0 +1,33 @@
+import { Command } from "commander";
+export interface CommandHandlers {
+    validate: (options: {
+        config?: string;
+        checkFiles?: boolean;
+    }, parentOpts: Record<string, unknown>) => Promise<void>;
+    resolve: (options: {
+        config?: string;
+        format?: string;
+    }, parentOpts: Record<string, unknown>) => Promise<void>;
+    list: (options: {
+        config?: string;
+        authority?: string;
+        path?: string;
+        format?: string;
+    }, parentOpts: Record<string, unknown>) => Promise<void>;
+    explain: (path: string | undefined, options: {
+        config?: string;
+        format?: string;
+    }, parentOpts: Record<string, unknown>) => Promise<void>;
+    audit: (options: {
+        config?: string;
+        adapter?: string;
+        model?: string;
+        showPrompt?: boolean;
+        dryRun?: boolean;
+        failOn?: string;
+        output?: string;
+        reportFormat?: string;
+    }, parentOpts: Record<string, unknown>) => Promise<void>;
+}
+export declare function createProgram(handlers: CommandHandlers, version: string): Command;
+//# sourceMappingURL=program.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/generated/program.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrH,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/G,IAAI,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/I,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzI,KAAK,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChO;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CA8FT"}

package/dist/generated/program.js

@@ -0,0 +1,92 @@
+// Auto-generated by cli-contracts. Do not edit.
+import { Command } from "commander";
+import { deriveCommandPolicy } from "./policy.js";
+export function createProgram(handlers, version) {
+    const program = new Command();
+    program
+        .name("artifact-contracts")
+        .version(version, "-V, --version")
+        .description("Artifact registry CLI — validate definitions, resolve artifacts, list registered entries, and explain file properties.");
+    program.option("--introspect", "Output derived policy as JSON without executing the command");
+    program
+        .command("validate")
+        .description("Validate artifact-contracts definitions")
+        .option("--config <path>", "Path to artifact-contracts.config.yaml")
+        .option("--check-files", "Scan repository files to detect path_patterns overlaps that static glob analysis cannot fully determine. When enabled, reads all files from git ls-files or glob.")
+        .action(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        if (globalOpts.introspect) {
+            const policy = deriveCommandPolicy("validate", opts);
+            console.log(JSON.stringify(policy, null, 2));
+            return;
+        }
+        await handlers.validate(opts, globalOpts);
+    });
+    program
+        .command("resolve")
+        .description("Output fully-resolved artifact definitions")
+        .option("--config <path>", "Path to artifact-contracts.config.yaml")
+        .option("--format <value>", "Output format (default: yaml)")
+        .action(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        if (globalOpts.introspect) {
+            const policy = deriveCommandPolicy("resolve", opts);
+            console.log(JSON.stringify(policy, null, 2));
+            return;
+        }
+        await handlers.resolve(opts, globalOpts);
+    });
+    program
+        .command("list")
+        .description("List registered artifacts")
+        .option("--config <path>", "Path to artifact-contracts.config.yaml")
+        .option("--authority <value>", "Filter by authority type")
+        .option("--path <file>", "Reverse-lookup — show artifact IDs matching this file path. For full governance details, use the explain command.")
+        .option("--format <value>", "Output format (default: text)")
+        .action(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        if (globalOpts.introspect) {
+            const policy = deriveCommandPolicy("list", opts);
+            console.log(JSON.stringify(policy, null, 2));
+            return;
+        }
+        await handlers.list(opts, globalOpts);
+    });
+    program
+        .command("explain")
+        .description("Explain artifact properties for a file path")
+        .argument("<path>", "File path to explain")
+        .option("--config <path>", "Path to artifact-contracts.config.yaml")
+        .option("--format <value>", "Output format (default: text)")
+        .action(async (path, opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        if (globalOpts.introspect) {
+            const policy = deriveCommandPolicy("explain", opts);
+            console.log(JSON.stringify(policy, null, 2));
+            return;
+        }
+        await handlers.explain(path, opts, globalOpts);
+    });
+    program
+        .command("audit")
+        .description("LLM-based semantic audit of artifact definitions")
+        .option("--config <path>", "Path to artifact-contracts.config.yaml")
+        .option("--adapter <value>", "LLM adapter to use")
+        .option("--model <value>", "Model name to pass to the adapter")
+        .option("--show-prompt", "Output the constructed prompt without calling the LLM API")
+        .option("-n, --dry-run", "Alias for --show-prompt (output prompt without LLM call)")
+        .option("--fail-on <value>", "Minimum severity that causes exit 10. Ordering: critical > error > warning > info. For example, --fail-on warning exits 10 on warning, error, or critical.")
+        .option("-o, --output <file>", "Write result to a file instead of stdout")
+        .option("--report-format <value>", "Output format for the report (default: text). LLM commands use --report-format; deterministic commands use --format.")
+        .action(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        if (globalOpts.introspect) {
+            const policy = deriveCommandPolicy("audit", opts);
+            console.log(JSON.stringify(policy, null, 2));
+            return;
+        }
+        await handlers.audit(opts, globalOpts);
+    });
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/generated/program.js.map

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