diffdoc 0.6.0 → 0.6.2

package/dist/commands/embed.js

@@ -22,34 +22,22 @@ function getSummaryPath(summaryDir, hash) {
     return node_path_1.default.resolve(summaryDir, `${hash}.json`);
 }
 async function readManifest(manifestPath) {
-    const parsed = JSON.parse(await promises_1.default.readFile(manifestPath, "utf8"));
-    if (parsed.schemaVersion !== artifacts_1.MANIFEST_SCHEMA_VERSION) {
-        throw new Error(`Unsupported manifest schema in ${manifestPath}. Expected schemaVersion ${artifacts_1.MANIFEST_SCHEMA_VERSION}.`);
+    const raw = JSON.parse(await promises_1.default.readFile(manifestPath, "utf8"));
+    const result = artifacts_1.RepoManifestSchema.safeParse(raw);
+    if (!result.success) {
+        const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+        throw new Error(`Invalid manifest in ${manifestPath}:\n${issues}`);
     }
-    return {
-        schemaVersion: artifacts_1.MANIFEST_SCHEMA_VERSION,
-        lastSyncedCommit: typeof parsed.lastSyncedCommit === "string" ? parsed.lastSyncedCommit : "",
-        files: parsed.files && typeof parsed.files === "object" ? parsed.files : {}
-    };
+    return result.data;
 }
 async function readSummaryAsset(summaryPath) {
-    const parsed = JSON.parse(await promises_1.default.readFile(summaryPath, "utf8"));
-    if (typeof parsed.schemaVersion !== "number" || parsed.schemaVersion < 1 || parsed.schemaVersion > artifacts_1.SUMMARY_ASSET_SCHEMA_VERSION) {
-        throw new Error(`Unsupported summary schema in ${summaryPath}. Expected schemaVersion 1-${artifacts_1.SUMMARY_ASSET_SCHEMA_VERSION}.`);
+    const raw = JSON.parse(await promises_1.default.readFile(summaryPath, "utf8"));
+    const result = artifacts_1.SummaryAssetSchema.safeParse(raw);
+    if (!result.success) {
+        const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+        throw new Error(`Invalid summary asset in ${summaryPath}:\n${issues}`);
     }
-    if (typeof parsed.content_hash !== "string") {
-        throw new Error(`Invalid summary hash in ${summaryPath}.`);
-    }
-    if (typeof parsed.summary !== "string") {
-        throw new Error(`Invalid summary text in ${summaryPath}.`);
-    }
-    return {
-        schemaVersion: parsed.schemaVersion,
-        content_hash: parsed.content_hash,
-        metadata: parsed.metadata && typeof parsed.metadata === "object" ? parsed.metadata : undefined,
-        summary: parsed.summary,
-        raw_code_snapshot: typeof parsed.raw_code_snapshot === "string" ? parsed.raw_code_snapshot : undefined
-    };
+    return result.data;
 }
 function buildDocument(summaryAsset) {
     return summaryAsset.summary;

package/dist/commands/init.js

@@ -8,7 +8,9 @@ const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
 const promises_2 = require("node:readline/promises");
 const node_process_1 = require("node:process");
+const schemas_1 = require("../schemas");
 const DEFAULT_CONFIG = {
+    $schema: `${schemas_1.SCHEMA_BASE_URL}/diffdocrc.schema.json`,
     baseDir: "./.diffdoc",
     aiProvider: "local",
     localLlmEndpoint: "http://localhost:11434/v1",

package/dist/commands/status.js

@@ -26,18 +26,12 @@ async function readManifest(manifestPath) {
         }
         throw error;
     }
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-        throw new Error(`Invalid manifest JSON in ${manifestPath}. Expected an object.`);
+    const result = artifacts_1.RepoManifestSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+        throw new Error(`Invalid manifest in ${manifestPath}:\n${issues}`);
     }
-    const manifest = parsed;
-    if (manifest.schemaVersion !== artifacts_1.MANIFEST_SCHEMA_VERSION) {
-        throw new Error(`Unsupported manifest schema in ${manifestPath}. Expected schemaVersion ${artifacts_1.MANIFEST_SCHEMA_VERSION}.`);
-    }
-    return {
-        schemaVersion: artifacts_1.MANIFEST_SCHEMA_VERSION,
-        lastSyncedCommit: typeof manifest.lastSyncedCommit === "string" ? manifest.lastSyncedCommit : "",
-        files: manifest.files && typeof manifest.files === "object" ? manifest.files : {}
-    };
+    return result.data;
 }
 async function getSummaryStats(manifestPath, manifest) {
     const summaryDir = getSummaryDir(manifestPath);
@@ -71,19 +65,18 @@ async function getSummaryStats(manifestPath, manifest) {
             continue;
         }
         try {
-            const parsed = JSON.parse(await promises_1.default.readFile(node_path_1.default.resolve(summaryDir, `${hash}.json`), "utf8"));
-            const metadata = parsed.metadata && typeof parsed.metadata === "object" && !Array.isArray(parsed.metadata)
-                ? parsed.metadata
-                : undefined;
-            if (parsed.schemaVersion !== artifacts_1.SUMMARY_ASSET_SCHEMA_VERSION ||
-                parsed.content_hash !== hash ||
-                !metadata ||
-                typeof metadata.file_path !== "string" ||
-                typeof metadata.file_name !== "string" ||
-                typeof metadata.extension !== "string" ||
-                metadata.content_hash !== hash ||
-                metadata.prompt_version !== llm_1.SUMMARY_PROMPT_VERSION ||
-                metadata.summary_format !== llm_1.SUMMARY_FORMAT) {
+            const raw = JSON.parse(await promises_1.default.readFile(node_path_1.default.resolve(summaryDir, `${hash}.json`), "utf8"));
+            const result = artifacts_1.SummaryAssetSchema.safeParse(raw);
+            if (!result.success) {
+                staleCount += 1;
+                continue;
+            }
+            const asset = result.data;
+            if (asset.content_hash !== hash ||
+                !asset.metadata ||
+                asset.metadata.content_hash !== hash ||
+                asset.metadata.prompt_version !== llm_1.SUMMARY_PROMPT_VERSION ||
+                asset.metadata.summary_format !== llm_1.SUMMARY_FORMAT) {
                 staleCount += 1;
             }
         }

package/dist/commands/summarize.js

@@ -8,10 +8,13 @@ const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
 const ignore_1 = __importDefault(require("ignore"));
 const artifacts_1 = require("../types/artifacts");
+const schemas_1 = require("../schemas");
 const git_1 = require("../utils/git");
 const hashing_1 = require("../utils/hashing");
 const llm_1 = require("../utils/llm");
 const paths_1 = require("../utils/paths");
+const MANIFEST_SCHEMA_URL = `${schemas_1.SCHEMA_BASE_URL}/manifest.schema.json`;
+const SUMMARY_ASSET_SCHEMA_URL = `${schemas_1.SCHEMA_BASE_URL}/summary-asset.schema.json`;
 function normalizeRelativePath(filePath) {
     return filePath.split(node_path_1.default.sep).join("/");
 }
@@ -158,20 +161,19 @@ async function isSummaryAssetFresh(summaryPath, expected) {
 }
 async function readManifest(manifestPath) {
     try {
-        const parsed = JSON.parse(await promises_1.default.readFile(manifestPath, "utf8"));
-        if (parsed.schemaVersion !== artifacts_1.MANIFEST_SCHEMA_VERSION) {
-            throw new Error(`Unsupported manifest schema in ${manifestPath}. Expected schemaVersion ${artifacts_1.MANIFEST_SCHEMA_VERSION}.`);
+        const raw = JSON.parse(await promises_1.default.readFile(manifestPath, "utf8"));
+        const result = artifacts_1.RepoManifestSchema.safeParse(raw);
+        if (!result.success) {
+            const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+            throw new Error(`Invalid manifest in ${manifestPath}:\n${issues}`);
         }
-        return {
-            schemaVersion: artifacts_1.MANIFEST_SCHEMA_VERSION,
-            lastSyncedCommit: typeof parsed.lastSyncedCommit === "string" ? parsed.lastSyncedCommit : "",
-            files: parsed.files && typeof parsed.files === "object" ? parsed.files : {}
-        };
+        return result.data;
     }
     catch (error) {
         const nodeError = error;
         if (nodeError.code === "ENOENT") {
             return {
+                $schema: MANIFEST_SCHEMA_URL,
                 schemaVersion: artifacts_1.MANIFEST_SCHEMA_VERSION,
                 lastSyncedCommit: "",
                 files: {}
@@ -270,6 +272,7 @@ async function removeManifestPath(filePath, manifest, manifestPath, summaryDir,
 async function ensureSummaryAsset(summaryDir, hash, metadata, summaryText, rawCodeSnapshot, includeCodeSnapshot) {
     const summaryPath = getSummaryPath(summaryDir, hash);
     const summary = {
+        $schema: SUMMARY_ASSET_SCHEMA_URL,
         schemaVersion: artifacts_1.SUMMARY_ASSET_SCHEMA_VERSION,
         content_hash: hash,
         metadata,

package/dist/commands/validate.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runValidate = runValidate;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const artifacts_1 = require("../types/artifacts");
+const paths_1 = require("../utils/paths");
+function getSummaryDir(manifestPath) {
+    return node_path_1.default.resolve(node_path_1.default.dirname(manifestPath), "summaries");
+}
+async function runValidate(options, config) {
+    const manifestPath = (0, paths_1.resolveDiffdocArtifactPath)(options.manifest, config.baseDir);
+    const issues = [];
+    let manifestValid = false;
+    let summaryAssetsChecked = 0;
+    let summaryAssetsValid = 0;
+    // Validate manifest
+    let manifestData;
+    try {
+        manifestData = JSON.parse(await promises_1.default.readFile(manifestPath, "utf8"));
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === "ENOENT") {
+            issues.push({ file: manifestPath, path: "", message: "Manifest file not found." });
+        }
+        else {
+            issues.push({ file: manifestPath, path: "", message: `Failed to parse JSON: ${error.message}` });
+        }
+        manifestData = undefined;
+    }
+    if (manifestData !== undefined) {
+        const result = artifacts_1.RepoManifestSchema.safeParse(manifestData);
+        if (result.success) {
+            manifestValid = true;
+            // Validate each referenced summary asset
+            const summaryDir = getSummaryDir(manifestPath);
+            const hashes = new Set(Object.values(result.data.files));
+            for (const hash of hashes) {
+                summaryAssetsChecked += 1;
+                const summaryPath = node_path_1.default.resolve(summaryDir, `${hash}.json`);
+                let summaryRaw;
+                try {
+                    summaryRaw = JSON.parse(await promises_1.default.readFile(summaryPath, "utf8"));
+                }
+                catch (error) {
+                    const nodeError = error;
+                    if (nodeError.code === "ENOENT") {
+                        issues.push({ file: summaryPath, path: "", message: "Summary asset file not found." });
+                    }
+                    else {
+                        issues.push({ file: summaryPath, path: "", message: `Failed to parse JSON: ${error.message}` });
+                    }
+                    continue;
+                }
+                const assetResult = artifacts_1.SummaryAssetSchema.safeParse(summaryRaw);
+                if (assetResult.success) {
+                    // Cross-check content_hash matches filename
+                    if (assetResult.data.content_hash !== hash) {
+                        issues.push({ file: summaryPath, path: "content_hash", message: `Expected "${hash}" but got "${assetResult.data.content_hash}".` });
+                    }
+                    else {
+                        summaryAssetsValid += 1;
+                    }
+                }
+                else {
+                    for (const issue of assetResult.error.issues) {
+                        issues.push({ file: summaryPath, path: issue.path.join("."), message: issue.message });
+                    }
+                }
+            }
+        }
+        else {
+            for (const issue of result.error.issues) {
+                issues.push({ file: manifestPath, path: issue.path.join("."), message: issue.message });
+            }
+        }
+    }
+    const report = {
+        valid: manifestValid && issues.length === 0,
+        manifestPath,
+        manifestValid,
+        summaryAssetsChecked,
+        summaryAssetsValid,
+        issues
+    };
+    if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        console.log(`Manifest: ${manifestPath}`);
+        console.log(`Manifest valid: ${manifestValid ? "yes" : "NO"}`);
+        console.log(`Summary assets checked: ${summaryAssetsChecked}`);
+        console.log(`Summary assets valid: ${summaryAssetsValid}`);
+        console.log("---");
+        if (issues.length === 0) {
+            console.log("All artifacts pass schema validation.");
+        }
+        else {
+            console.log(`Issues (${issues.length}):`);
+            for (const issue of issues) {
+                const location = issue.path ? `${issue.file} -> ${issue.path}` : issue.file;
+                console.log(`  - ${location}: ${issue.message}`);
+            }
+        }
+    }
+    if (!report.valid) {
+        process.exitCode = 1;
+    }
+}

package/dist/config.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildRuntimeConfig = buildRuntimeConfig;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
+const schemas_1 = require("./schemas");
 function readOption(value, envName, fallback = "") {
     return value || process.env[envName] || fallback;
 }
@@ -56,7 +57,12 @@ function loadRcFile(configPath) {
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
         throw new Error(`Config file must contain a JSON object: ${resolvedPath}`);
     }
-    return parsed;
+    const result = schemas_1.DiffdocConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+        throw new Error(`Invalid config file ${resolvedPath}:\n${issues}`);
+    }
+    return result.data;
 }
 function mergeConfigOptions(options) {
     const rcOptions = loadRcFile(options.config);

package/dist/index.js

@@ -8,6 +8,7 @@ const init_1 = require("./commands/init");
 const query_1 = require("./commands/query");
 const status_1 = require("./commands/status");
 const summarize_1 = require("./commands/summarize");
+const validate_1 = require("./commands/validate");
 const program = new commander_1.Command();
 function collectOption(value, previous) {
     previous.push(value);
@@ -157,6 +158,21 @@ addBaseOptions(program
         process.exit(1);
     }
 });
+addBaseOptions(program
+    .command("validate"))
+    .description("Validate manifest and summary assets against JSON schemas")
+    .option("--manifest <path>", "manifest input path under --base-dir", "manifest.json")
+    .option("--json", "print validation report as JSON for CI", false)
+    .action(async (options) => {
+    try {
+        const config = (0, config_1.buildRuntimeConfig)(options, { embeddings: false, chat: false });
+        await (0, validate_1.runValidate)({ manifest: options.manifest, json: options.json }, config);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
 program.parseAsync(process.argv).catch((error) => {
     console.error(error instanceof Error ? error.message : error);
     process.exit(1);

package/dist/schemas.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SummaryAssetSchema = exports.SummaryMetadataSchema = exports.RepoManifestSchema = exports.DiffdocConfigSchema = exports.SCHEMA_BASE_URL = exports.SCHEMA_DIR_VERSION = exports.SUMMARY_ASSET_SCHEMA_VERSION = exports.MANIFEST_SCHEMA_VERSION = void 0;
+const zod_1 = require("zod");
+// ---------------------------------------------------------------------------
+// Schema version constants
+// ---------------------------------------------------------------------------
+exports.MANIFEST_SCHEMA_VERSION = 2;
+exports.SUMMARY_ASSET_SCHEMA_VERSION = 2;
+exports.SCHEMA_DIR_VERSION = 2;
+exports.SCHEMA_BASE_URL = `https://raw.githubusercontent.com/sullyTheDev/diffdoc/main/schemas/v${exports.SCHEMA_DIR_VERSION}`;
+// ---------------------------------------------------------------------------
+// Configuration schema (.diffdocrc)
+// ---------------------------------------------------------------------------
+exports.DiffdocConfigSchema = zod_1.z.object({
+    $schema: zod_1.z.string().optional(),
+    baseDir: zod_1.z.string().optional(),
+    aiProvider: zod_1.z.enum(["local", "cloud"]).optional(),
+    localLlmEndpoint: zod_1.z.string().optional(),
+    localEmbedEndpoint: zod_1.z.string().optional(),
+    localChatModel: zod_1.z.string().optional(),
+    localEmbedModel: zod_1.z.string().optional(),
+    cloudLlmEndpoint: zod_1.z.string().optional(),
+    cloudChatModel: zod_1.z.string().optional(),
+    cloudEmbedModel: zod_1.z.string().optional(),
+    embedBatchSize: zod_1.z.union([zod_1.z.number().int().positive(), zod_1.z.string()]).optional(),
+    summarizeConcurrency: zod_1.z.union([zod_1.z.number().int().positive(), zod_1.z.string()]).optional(),
+    openaiApiKey: zod_1.z.string().optional(),
+    includeGlobs: zod_1.z.union([zod_1.z.array(zod_1.z.string()), zod_1.z.string()]).optional(),
+    excludeGlobs: zod_1.z.union([zod_1.z.array(zod_1.z.string()), zod_1.z.string()]).optional(),
+    ignoreFile: zod_1.z.string().optional(),
+    summaryPrompt: zod_1.z.string().optional(),
+    summaryPromptFile: zod_1.z.string().optional()
+}).strict();
+// ---------------------------------------------------------------------------
+// Repository manifest schema
+// ---------------------------------------------------------------------------
+exports.RepoManifestSchema = zod_1.z.object({
+    $schema: zod_1.z.string().optional(),
+    schemaVersion: zod_1.z.literal(exports.MANIFEST_SCHEMA_VERSION),
+    lastSyncedCommit: zod_1.z.string(),
+    files: zod_1.z.record(zod_1.z.string(), zod_1.z.string())
+});
+// ---------------------------------------------------------------------------
+// Summary metadata schema (nested within summary assets)
+// ---------------------------------------------------------------------------
+exports.SummaryMetadataSchema = zod_1.z.object({
+    file_path: zod_1.z.string(),
+    file_name: zod_1.z.string(),
+    extension: zod_1.z.string(),
+    line_count: zod_1.z.number().int().nonnegative(),
+    byte_size: zod_1.z.number().int().nonnegative(),
+    content_hash: zod_1.z.string(),
+    generated_at: zod_1.z.string(),
+    generator: zod_1.z.object({
+        provider: zod_1.z.string(),
+        model: zod_1.z.string()
+    }),
+    prompt_version: zod_1.z.number().int(),
+    summary_format: zod_1.z.string(),
+    custom_prompt_hash: zod_1.z.string().optional(),
+    custom_prompt_source: zod_1.z.string().optional()
+});
+// ---------------------------------------------------------------------------
+// Summary asset schema (individual hash-named JSON files)
+// ---------------------------------------------------------------------------
+exports.SummaryAssetSchema = zod_1.z.object({
+    $schema: zod_1.z.string().optional(),
+    schemaVersion: zod_1.z.literal(exports.SUMMARY_ASSET_SCHEMA_VERSION),
+    content_hash: zod_1.z.string(),
+    metadata: exports.SummaryMetadataSchema.optional(),
+    summary: zod_1.z.string(),
+    raw_code_snapshot: zod_1.z.string().optional()
+});

package/dist/scripts/generate-schemas.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const schemas_1 = require("../schemas");
+const schemas = [
+    { name: "diffdocrc.schema.json", zodSchema: schemas_1.DiffdocConfigSchema },
+    { name: "manifest.schema.json", zodSchema: schemas_1.RepoManifestSchema },
+    { name: "summary-asset.schema.json", zodSchema: schemas_1.SummaryAssetSchema }
+];
+const outDir = node_path_1.default.resolve(__dirname, `../../schemas/v${schemas_1.SCHEMA_DIR_VERSION}`);
+node_fs_1.default.mkdirSync(outDir, { recursive: true });
+for (const entry of schemas) {
+    const jsonSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(entry.zodSchema, {
+        name: entry.name.replace(".schema.json", ""),
+        $refStrategy: "none"
+    });
+    const schemaWithId = {
+        ...jsonSchema,
+        $id: `${schemas_1.SCHEMA_BASE_URL}/${entry.name}`
+    };
+    const outPath = node_path_1.default.resolve(outDir, entry.name);
+    node_fs_1.default.writeFileSync(outPath, `${JSON.stringify(schemaWithId, null, 2)}\n`);
+    console.log(`Generated: ${outPath}`);
+}
+console.log("Schema generation complete.");

package/dist/types/artifacts.js

@@ -1,5 +1,14 @@
 "use strict";
+// Re-export all schema definitions and types from the canonical source.
+// This file exists for backwards-compatible import paths.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUMMARY_ASSET_SCHEMA_VERSION = exports.MANIFEST_SCHEMA_VERSION = void 0;
-exports.MANIFEST_SCHEMA_VERSION = 2;
-exports.SUMMARY_ASSET_SCHEMA_VERSION = 2;
+exports.DiffdocConfigSchema = exports.SummaryAssetSchema = exports.SummaryMetadataSchema = exports.RepoManifestSchema = exports.SCHEMA_BASE_URL = exports.SCHEMA_DIR_VERSION = exports.SUMMARY_ASSET_SCHEMA_VERSION = exports.MANIFEST_SCHEMA_VERSION = void 0;
+var schemas_1 = require("../schemas");
+Object.defineProperty(exports, "MANIFEST_SCHEMA_VERSION", { enumerable: true, get: function () { return schemas_1.MANIFEST_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "SUMMARY_ASSET_SCHEMA_VERSION", { enumerable: true, get: function () { return schemas_1.SUMMARY_ASSET_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "SCHEMA_DIR_VERSION", { enumerable: true, get: function () { return schemas_1.SCHEMA_DIR_VERSION; } });
+Object.defineProperty(exports, "SCHEMA_BASE_URL", { enumerable: true, get: function () { return schemas_1.SCHEMA_BASE_URL; } });
+Object.defineProperty(exports, "RepoManifestSchema", { enumerable: true, get: function () { return schemas_1.RepoManifestSchema; } });
+Object.defineProperty(exports, "SummaryMetadataSchema", { enumerable: true, get: function () { return schemas_1.SummaryMetadataSchema; } });
+Object.defineProperty(exports, "SummaryAssetSchema", { enumerable: true, get: function () { return schemas_1.SummaryAssetSchema; } });
+Object.defineProperty(exports, "DiffdocConfigSchema", { enumerable: true, get: function () { return schemas_1.DiffdocConfigSchema; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffdoc",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Translate repository code shifts into plain-English business context",
   "license": "MIT",
   "author": "Christopher Sullivan",
@@ -20,6 +20,7 @@
   },
   "files": [
     "dist",
+    "schemas",
     "README.md",
     "LICENSE",
     ".diffdocrc.example"
@@ -28,7 +29,8 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node dist/scripts/generate-schemas.js",
+    "generate:schemas": "node dist/scripts/generate-schemas.js",
     "clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
     "start": "tsc && node ./dist/index.js",
     "prepare": "npm run build"
@@ -44,6 +46,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.19.41",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "zod-to-json-schema": "^3.25.2"
   }
 }

package/schemas/v2/diffdocrc.schema.json

@@ -0,0 +1,107 @@
+{
+  "$ref": "#/definitions/diffdocrc",
+  "definitions": {
+    "diffdocrc": {
+      "type": "object",
+      "properties": {
+        "$schema": {
+          "type": "string"
+        },
+        "baseDir": {
+          "type": "string"
+        },
+        "aiProvider": {
+          "type": "string",
+          "enum": [
+            "local",
+            "cloud"
+          ]
+        },
+        "localLlmEndpoint": {
+          "type": "string"
+        },
+        "localEmbedEndpoint": {
+          "type": "string"
+        },
+        "localChatModel": {
+          "type": "string"
+        },
+        "localEmbedModel": {
+          "type": "string"
+        },
+        "cloudLlmEndpoint": {
+          "type": "string"
+        },
+        "cloudChatModel": {
+          "type": "string"
+        },
+        "cloudEmbedModel": {
+          "type": "string"
+        },
+        "embedBatchSize": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "summarizeConcurrency": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "openaiApiKey": {
+          "type": "string"
+        },
+        "includeGlobs": {
+          "anyOf": [
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "excludeGlobs": {
+          "anyOf": [
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "ignoreFile": {
+          "type": "string"
+        },
+        "summaryPrompt": {
+          "type": "string"
+        },
+        "summaryPromptFile": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/sullyTheDev/diffdoc/main/schemas/v2/diffdocrc.schema.json"
+}

package/schemas/v2/manifest.schema.json

@@ -0,0 +1,34 @@
+{
+  "$ref": "#/definitions/manifest",
+  "definitions": {
+    "manifest": {
+      "type": "object",
+      "properties": {
+        "$schema": {
+          "type": "string"
+        },
+        "schemaVersion": {
+          "type": "number",
+          "const": 2
+        },
+        "lastSyncedCommit": {
+          "type": "string"
+        },
+        "files": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "lastSyncedCommit",
+        "files"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/sullyTheDev/diffdoc/main/schemas/v2/manifest.schema.json"
+}

package/schemas/v2/summary-asset.schema.json

@@ -0,0 +1,103 @@
+{
+  "$ref": "#/definitions/summary-asset",
+  "definitions": {
+    "summary-asset": {
+      "type": "object",
+      "properties": {
+        "$schema": {
+          "type": "string"
+        },
+        "schemaVersion": {
+          "type": "number",
+          "const": 2
+        },
+        "content_hash": {
+          "type": "string"
+        },
+        "metadata": {
+          "type": "object",
+          "properties": {
+            "file_path": {
+              "type": "string"
+            },
+            "file_name": {
+              "type": "string"
+            },
+            "extension": {
+              "type": "string"
+            },
+            "line_count": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "byte_size": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "content_hash": {
+              "type": "string"
+            },
+            "generated_at": {
+              "type": "string"
+            },
+            "generator": {
+              "type": "object",
+              "properties": {
+                "provider": {
+                  "type": "string"
+                },
+                "model": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "provider",
+                "model"
+              ],
+              "additionalProperties": false
+            },
+            "prompt_version": {
+              "type": "integer"
+            },
+            "summary_format": {
+              "type": "string"
+            },
+            "custom_prompt_hash": {
+              "type": "string"
+            },
+            "custom_prompt_source": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "file_path",
+            "file_name",
+            "extension",
+            "line_count",
+            "byte_size",
+            "content_hash",
+            "generated_at",
+            "generator",
+            "prompt_version",
+            "summary_format"
+          ],
+          "additionalProperties": false
+        },
+        "summary": {
+          "type": "string"
+        },
+        "raw_code_snapshot": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "schemaVersion",
+        "content_hash",
+        "summary"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/sullyTheDev/diffdoc/main/schemas/v2/summary-asset.schema.json"
+}