feat: business context integration & v0.2.0 release

Author: Dennis P

README.md

@@ -72,6 +72,12 @@ diffmind --branch develop
 diffmind --format json --min-severity high
 ```
 
+### Business-Aware Reviews
+Provide requirements or ticket descriptions to verify that the code actually meets the business criteria:
+```bash
+diffmind --branch develop --context ticket.md
+```
+
 ### Custom Diff (Stdin)
 ```bash
 git diff main...HEAD | diffmind --stdin
@@ -87,6 +93,7 @@ git diff main...HEAD | diffmind --stdin
 |--------|-------------|---------|
 | `--branch, -b` | Base branch to compare against | `main` |
 | `--format, -f` | Output format (`markdown` or `json`) | `markdown` |
+| `--context, -c` | Business context (ticket text or file path) | `""` |
 | `--min-severity` | Minimum severity level (`high`, `medium`, `low`) | `low` |
 | `--stdin` | Read diff from stdin | `false` |
 | `--output, -o` | Write report to a specific file | `stdout` |

apps/local-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diffmind/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "diffmind CLI — local-first AI code review for your git diffs",
   "author": "Thinkgrid Labs <hello@thinkgrid.com>",
   "license": "MIT",

apps/local-cli/src/index.ts

@@ -49,14 +49,18 @@ const program = new Command();
 program
   .name("diffmind")
   .description("Local-first AI code review for your git diffs")
-  .version("0.1.0")
+  .version("0.2.0")
   .option("-b, --branch <name>", "Target branch to diff against", "main")
   .option(
     "-f, --format <type>",
     'Output format: "markdown" or "json"',
     "markdown"
   )
   .option("-o, --output <file>", "Write output to a file instead of stdout")
+  .option(
+    "-c, --context <text|file>",
+    "Business context (ticket description, acceptance criteria)"
+  )
   .option(
     "--min-severity <level>",
     'Minimum severity to report: "high", "medium", or "low"',
@@ -73,6 +77,7 @@ const opts = program.opts<{
   minSeverity: Severity;
   stdin: boolean;
   color: boolean;
+  context?: string;
 }>();
 
 // ─── Main ─────────────────────────────────────────────────────────────────────
@@ -94,7 +99,17 @@ async function main(): Promise<void> {
     process.exit(0);
   }
 
-  // 3. Run analysis in a background worker
+  // 3. Prepare business context
+  let context = "";
+  if (opts.context) {
+    if (fs.existsSync(opts.context)) {
+      context = fs.readFileSync(opts.context, "utf-8");
+    } else {
+      context = opts.context;
+    }
+  }
+
+  // 4. Run analysis in a background worker
   // This keeps the process responsive and the spinner animated.
   const analyzeSpinner = ora("Initializing engine & analyzing diff...").start();
 
@@ -103,6 +118,7 @@ async function main(): Promise<void> {
       modelPath: path.join(MODEL_DIR, MODEL_FILENAME),
       tokenizerPath: path.join(MODEL_DIR, TOKENIZER_FILENAME),
       diff,
+      context,
       maxTokens: 2048,
     });
 
@@ -116,7 +132,7 @@ async function main(): Promise<void> {
     process.exit(1);
   }
 
-  // 4. Format and output results
+  // 5. Format and output results
   const output =
     opts.format === "json"
       ? formatJson(report)
@@ -140,6 +156,7 @@ function runAnalysisInWorker(workerData: {
   modelPath: string;
   tokenizerPath: string;
   diff: string;
+  context: string;
   maxTokens: number;
 }): Promise<string> {
   return new Promise((resolve, reject) => {
@@ -378,7 +395,7 @@ export function categoryBadge(category: Category): string {
 }
 
 function printBanner(): void {
-  console.log(chalk.cyan.bold("\n  diffmind") + chalk.dim(" v0.1.0 — local-first AI code review"));
+  console.log(chalk.cyan.bold("\n  diffmind") + chalk.dim(" v0.2.0 — local-first AI code review"));
   console.log(chalk.dim("  Model: Qwen2.5-Coder-3B-Instruct Q4_K_M | Inference: on-device Wasm\n"));
 }
 

apps/local-cli/src/worker.ts

@@ -11,10 +11,9 @@ async function runWorker() {
   if (!parentPort) return;
 
   try {
-    const { modelPath, tokenizerPath, diff, maxTokens } = workerData;
+    const { modelPath, tokenizerPath, diff, context, maxTokens } = workerData;
 
     // 1. Load Wasm bindings
-    // Note: In Node.js, we require the generated CommonJS bindings from pkg/
     const { ReviewAnalyzer } = require("@diffmind/core-wasm");
 
     // 2. Read model files
@@ -23,7 +22,7 @@ async function runWorker() {
 
     // 3. Initialize and run
     const analyzer = new ReviewAnalyzer(modelBytes, tokenizerBytes);
-    const resultJson = analyzer.analyze_diff_chunked(diff, maxTokens);
+    const resultJson = analyzer.analyze_diff_chunked(diff, context || "", maxTokens);
 
     // 4. Return results
     parentPort.postMessage({ success: true, data: resultJson });

package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffmind",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": true,
   "description": "Local-first AI code review agent — powered by on-device Wasm inference",
   "author": "Thinkgrid Labs <dennis@thinkgrid.dev>",
@@ -32,6 +32,7 @@
     "lint:cli": "pnpm --filter @diffmind/cli build",
     "lint": "pnpm build:wasm && pnpm lint:types && pnpm lint:cli",
     "test:wasm": "pnpm --filter @diffmind/core-wasm test",
+    "sync-version": "node scripts/sync-versions.js",
     "test:js": "jest",
     "test": "pnpm test:js && pnpm test:wasm"
   },

packages/core-wasm/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "core-wasm"
-version = "0.1.0"
+version = "0.2.0"
 edition = "2021"
 description = "diffmind Wasm core — on-device security analysis via Qwen2.5-Coder"
 

packages/core-wasm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diffmind/core-wasm",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "diffmind Wasm core — compiled from Rust via wasm-pack",
   "license": "MIT",
   "author": "Thinkgrid Labs <hello@thinkgrid.com>",

packages/core-wasm/src/lib.rs

@@ -89,35 +89,36 @@ impl ReviewAnalyzer {
         })
     }
 
-    pub fn analyze_diff(&mut self, diff: &str) -> Result<String, JsError> {
-        let findings = self.analyze_diff_internal(diff)?;
+    pub fn analyze_diff(&mut self, diff: &str, context: &str) -> Result<String, JsError> {
+        let findings = self.analyze_diff_internal(diff, context)?;
         serde_json::to_string(&findings)
             .map_err(|e| JsError::new(&format!("failed to serialize findings: {e}")))
     }
 
     pub fn analyze_diff_chunked(
         &mut self,
         diff: &str,
+        context: &str,
         _max_tokens_per_chunk: u32,
     ) -> Result<String, JsError> {
         let chunks = split_diff_by_file(diff);
         let mut all_findings: Vec<ReviewFinding> = Vec::new();
 
         for chunk in chunks {
-            let chunk_findings = self.analyze_diff_internal(&chunk)?;
+            let chunk_findings = self.analyze_diff_internal(&chunk, context)?;
             all_findings.extend(chunk_findings);
         }
 
         serde_json::to_string(&all_findings)
             .map_err(|e| JsError::new(&format!("failed to serialize merged findings: {e}")))
     }
 
-    fn analyze_diff_internal(&mut self, diff: &str) -> Result<Vec<ReviewFinding>, JsError> {
+    fn analyze_diff_internal(&mut self, diff: &str, context: &str) -> Result<Vec<ReviewFinding>, JsError> {
         if diff.trim().is_empty() {
             return Ok(Vec::new());
         }
 
-        let prompt = self.format_prompt(diff);
+        let prompt = self.format_prompt(diff, context);
         let response = self.generate(&prompt, 1024)?;
 
         // Extract JSON block
@@ -134,9 +135,16 @@ impl ReviewAnalyzer {
 }
 
 impl ReviewAnalyzer {
-    fn format_prompt(&self, diff: &str) -> String {
+    fn format_prompt(&self, diff: &str, context: &str) -> String {
+        let context_section = if context.is_empty() {
+            String::new()
+        } else {
+            format!("\n\n### Business Context / Requirements:\n{}\n", context)
+        };
+
         format!(
-            "<|im_start|>system\nYou are an expert Senior Software Engineer and Code Reviewer. Analyze the git diff and provide a comprehensive code review for TypeScript, NestJS, and React Native code.\nFocus on:\n1. **Security**: Vulnerabilities, secrets, insecure handling.\n2. **Quality**: Bugs, anti-patterns, logical errors.\n3. **Performance**: Bottlenecks, inefficient code.\n4. **Maintainability**: Readability, naming, complexity.\n\nReturn a JSON array ONLY. Format: [{{ \"file\": \"path\", \"line\": 12, \"severity\": \"high\"|\"medium\"|\"low\", \"category\": \"security\"|\"quality\"|\"performance\"|\"maintainability\", \"issue\": \"description\", \"suggested_fix\": \"code\" }}]\nIf no issues, return [].<|im_end|>\n<|im_start|>user\nAnalyze this diff:\n{}\n<|im_end|>\n<|im_start|>assistant\n",
+            "<|im_start|>system\nYou are an expert Senior Software Engineer and Code Reviewer. Analyze the git diff and provide a comprehensive code review for TypeScript, NestJS, and React Native code.{} \n\nFocus on:\n1. **Security**: Vulnerabilities, secrets, insecure handling.\n2. **Quality**: Bugs, anti-patterns, logical errors.\n3. **Performance**: Bottlenecks, inefficient code.\n4. **Maintainability**: Readability, naming, complexity.\n\nReturn a JSON array ONLY. Format: [{{ \"file\": \"path\", \"line\": 12, \"severity\": \"high\"|\"medium\"|\"low\", \"category\": \"security\"|\"quality\"|\"performance\"|\"maintainability\", \"issue\": \"description\", \"suggested_fix\": \"code\" }}]\nIf no issues, return [].<|im_end|>\n<|im_start|>user\nAnalyze this diff:\n{}\n<|im_end|>\n<|im_start|>assistant\n",
+            context_section,
             diff
         )
     }

packages/shared-types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diffmind/shared-types",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Shared TypeScript types for diffmind review findings",
   "license": "MIT",
   "author": "Thinkgrid Labs <hello@thinkgrid.com>",

scripts/sync-versions.js

@@ -0,0 +1,50 @@
+const fs = require('fs');
+const path = require('path');
+
+const version = process.argv[2];
+
+if (!version) {
+  console.error('Error: Please provide a version number (e.g., 0.2.0)');
+  process.exit(1);
+}
+
+// Clean version string (remove 'v' prefix if present)
+const cleanVersion = version.startsWith('v') ? version.slice(1) : version;
+
+console.log(`Syncing version to v${cleanVersion}...`);
+
+const filesToUpdate = [
+  'package.json',
+  'apps/local-cli/package.json',
+  'packages/shared-types/package.json',
+  'packages/core-wasm/package.json',
+  'packages/core-wasm/Cargo.toml',
+  'apps/local-cli/src/index.ts',
+];
+
+filesToUpdate.forEach(file => {
+  const absolutePath = path.join(__dirname, '..', file);
+  if (!fs.existsSync(absolutePath)) {
+    console.warn(`Warning: File not found - ${file}`);
+    return;
+  }
+
+  let content = fs.readFileSync(absolutePath, 'utf8');
+
+  if (file.endsWith('package.json')) {
+    // Update JSON version field
+    content = content.replace(/"version":\s*"[^"]+"/, `"version": "${cleanVersion}"`);
+  } else if (file.endsWith('Cargo.toml')) {
+    // Update TOML version field (usually under [package])
+    content = content.replace(/^version\s*=\s*"[^"]+"/m, `version = "${cleanVersion}"`);
+  } else if (file.endsWith('src/index.ts')) {
+    // Update CLI hardcoded version string
+    content = content.replace(/version\("[^"]+"\)/, `version("${cleanVersion}")`);
+    content = content.replace(/v[0-9]+\.[0-9]+\.[0-9]+/, `v${cleanVersion}`);
+  }
+
+  fs.writeFileSync(absolutePath, content, 'utf8');
+  console.log(`✓ Updated ${file}`);
+});
+
+console.log('\nSuccess! All versions synced to v' + cleanVersion);