diffdoc 0.2.0 → 0.4.0

package/dist/index.js

@@ -4,10 +4,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const config_1 = require("./config");
 const embed_1 = require("./commands/embed");
+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 llm_1 = require("./utils/llm");
 const program = new commander_1.Command();
+function collectOption(value, previous) {
+    previous.push(value);
+    return previous;
+}
 function addBaseOptions(command) {
     return command
         .option("--config <path>", "path to .diffdocrc JSON config file")
@@ -37,16 +42,17 @@ program
     .name("diffdoc")
     .description("Translate repository code shifts into plain-English business context")
     .version("0.1.0");
-addChatOptions(addBaseOptions(program
-    .command("summarize")))
-    .description("Summarize repository code into a portable JSON manifest")
-    .option("--path <path>", "repository or code path to scan", ".")
-    .option("--out <path>", "manifest output path under --base-dir", "manifest.json")
-    .option("--mode <mode>", "summarization mode: all or delta", "all")
+program
+    .command("init")
+    .description("Initialize DiffDoc configuration for this repository")
+    .option("--yes", "use defaults without prompting", false)
+    .option("--provider <provider>", "AI provider: local or cloud")
+    .option("--config <path>", "path to .diffdocrc JSON config file")
+    .option("--base-dir <path>", "DiffDoc artifact directory")
+    .option("--force", "overwrite existing config file", false)
     .action(async (options) => {
     try {
-        const config = (0, config_1.buildRuntimeConfig)(options, { chat: true });
-        await (0, summarize_1.runSummarize)({ path: options.path, out: options.out, mode: options.mode }, config);
+        await (0, init_1.runInit)(options);
     }
     catch (error) {
         console.error(error instanceof Error ? error.message : error);
@@ -54,14 +60,29 @@ addChatOptions(addBaseOptions(program
     }
 });
 addChatOptions(addBaseOptions(program
-    .command("prompt")))
-    .description("Send a plain prompt to the configured LLM")
-    .argument("<message...>", "prompt text to send")
-    .action(async (messageParts, options) => {
+    .command("summarize")))
+    .description("Summarize repository code into a portable JSON manifest")
+    .option("--path <path>", "repository or code path to scan", ".")
+    .option("--out <path>", "manifest output path under --base-dir", "manifest.json")
+    .option("--mode <mode>", "summarization mode: all or delta", "all")
+    .option("--include-code-snapshot", "store raw code in summary assets", false)
+    .option("--json", "print summarize report as JSON for CI", false)
+    .option("--include-glob <pattern>", "include glob pattern (repeatable)", collectOption, [])
+    .option("--exclude-glob <pattern>", "exclude glob pattern (repeatable)", collectOption, [])
+    .option("--ignore-file <path>", "path to ignore pattern file relative to --path")
+    .action(async (options) => {
     try {
         const config = (0, config_1.buildRuntimeConfig)(options, { chat: true });
-        const response = await (0, llm_1.promptLlm)(messageParts.join(" "), config.chat);
-        console.log(response);
+        await (0, summarize_1.runSummarize)({
+            path: options.path,
+            out: options.out,
+            mode: options.mode,
+            includeCodeSnapshot: options.includeCodeSnapshot,
+            json: options.json,
+            includeGlobs: options.includeGlob,
+            excludeGlobs: options.excludeGlob,
+            ignoreFile: options.ignoreFile
+        }, config);
     }
     catch (error) {
         console.error(error instanceof Error ? error.message : error);
@@ -104,10 +125,26 @@ addCloudEndpointAndKeyOptions(addEmbeddingOptions(addBaseOptions(program
     .command("embed"))))
     .description("Embed manifest summaries into a local Vectra index")
     .option("--manifest <path>", "manifest input path under --base-dir", "manifest.json")
+    .option("--rebuild", "rebuild local index from scratch", false)
     .action(async (options) => {
     try {
         const config = (0, config_1.buildRuntimeConfig)(options, { embeddings: true });
-        await (0, embed_1.runEmbed)({ manifest: options.manifest }, config);
+        await (0, embed_1.runEmbed)({ manifest: options.manifest, rebuild: options.rebuild }, config);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+addBaseOptions(program
+    .command("status"))
+    .description("Show manifest and index sync status")
+    .option("--manifest <path>", "manifest input path under --base-dir", "manifest.json")
+    .option("--json", "print status as JSON for CI", false)
+    .action(async (options) => {
+    try {
+        const config = (0, config_1.buildRuntimeConfig)(options, { embeddings: false, chat: false });
+        await (0, status_1.runStatus)({ manifest: options.manifest, json: options.json }, config);
     }
     catch (error) {
         console.error(error instanceof Error ? error.message : error);

package/dist/services/retrieval.js

@@ -39,7 +39,7 @@ function buildAnswerPrompt(question, results) {
             `File: ${result.filePath}`,
             `Score: ${result.score}`,
             `Summary:\n${result.summaryText}`,
-            `Code Snapshot:\n${result.rawCodeSnapshot}`
+            `Code Snapshot:\n${result.rawCodeSnapshot || "(not stored)"}`
         ].join("\n");
     }).join("\n\n---\n\n");
     return `Answer the user's question using only the retrieved DiffDoc results below. If the results do not contain enough information, say what is missing. Prefer a direct answer first, then cite the relevant file paths. Keep the explanation appropriate to the question: summarize when asked for a summary, explain implementation details when asked how something works, and avoid unsupported claims.\n\nUser question:\n${question}\n\nRetrieved results:\n${context}`;
@@ -67,7 +67,7 @@ async function answerFromIndex(question, topK, config) {
             results: []
         };
     }
-    const answer = await (0, llm_1.promptLlm)(buildAnswerPrompt(question, results), config.chat);
+    const answer = await (0, llm_1.generateAnswer)(buildAnswerPrompt(question, results), config.chat);
     return {
         answer,
         sources: results.map((result) => ({ filePath: result.filePath, score: result.score })),

package/dist/types/artifacts.js

@@ -0,0 +1,5 @@
+"use strict";
+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 = 1;

package/dist/utils/git.js

@@ -7,16 +7,12 @@ exports.getGitDeltas = getGitDeltas;
 exports.getCurrentCommit = getCurrentCommit;
 const node_path_1 = __importDefault(require("node:path"));
 const simple_git_1 = __importDefault(require("simple-git"));
-const TARGET_EXTENSIONS = new Set([".ts", ".js", ".cs", ".py"]);
 function normalizePath(filePath) {
     return filePath.split(node_path_1.default.sep).join("/");
 }
-function isTargetCodeFile(filePath) {
-    return TARGET_EXTENSIONS.has(node_path_1.default.extname(filePath));
-}
 function addUnique(target, filePath) {
     const normalized = normalizePath(filePath.trim());
-    if (normalized && isTargetCodeFile(normalized)) {
+    if (normalized) {
         target.add(normalized);
     }
 }

package/dist/utils/llm.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateFunctionalSummary = generateFunctionalSummary;
-exports.promptLlm = promptLlm;
+exports.generateAnswer = generateAnswer;
 exports.generateEmbeddings = generateEmbeddings;
 const openai_1 = __importDefault(require("openai"));
 function createClient(config) {
@@ -31,7 +31,7 @@ async function generateFunctionalSummary(fileName, codeContent, config) {
     });
     return response.choices[0]?.message?.content?.trim() || "No business behavior summary was returned.";
 }
-async function promptLlm(prompt, config) {
+async function generateAnswer(prompt, config) {
     const { client, model } = createClient(config);
     const response = await client.chat.completions.create({
         model,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffdoc",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Translate repository code shifts into plain-English business context",
   "license": "MIT",
   "author": "Christopher Sullivan",
@@ -15,8 +15,8 @@
   "type": "commonjs",
   "main": "dist/index.js",
   "bin": {
-    "diffdoc": "./dist/index.js",
-    "diffdoc-mcp": "./dist/mcp.js"
+    "diffdoc": "dist/index.js",
+    "diffdoc-mcp": "dist/mcp.js"
   },
   "files": [
     "dist",