valent-pipeline 0.1.14 → 0.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valent-pipeline",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "v3 multi-agent AI pipeline for software development lifecycle",
   "type": "module",
   "bin": {

package/pipeline/scripts/query-kb.ts

@@ -0,0 +1,185 @@
+#!/usr/bin/env npx tsx
+/**
+ * query-kb.ts — Query the pipeline knowledge database from the command line.
+ * Used by the Knowledge Agent to answer queries without writing SQL directly.
+ *
+ * Usage:
+ *   # Get a specific artifact:
+ *   npx tsx .valent-pipeline/scripts/query-kb.ts --artifact --story KANBAN-001 --type reqs-brief
+ *
+ *   # Get correction directives for an agent:
+ *   npx tsx .valent-pipeline/scripts/query-kb.ts --directives --agent BEND
+ *
+ *   # Full-text search across all artifacts:
+ *   npx tsx .valent-pipeline/scripts/query-kb.ts --search "acceptance criteria for auth"
+ *
+ *   # List all artifacts for a story:
+ *   npx tsx .valent-pipeline/scripts/query-kb.ts --list --story KANBAN-001
+ *
+ *   # List all stories in the database:
+ *   npx tsx .valent-pipeline/scripts/query-kb.ts --stories
+ *
+ *   # Get bugs since a date:
+ *   npx tsx .valent-pipeline/scripts/query-kb.ts --bugs-since 2026-03-01
+ *
+ *   # DB path defaults to .valent-pipeline/pipeline.db, override with --db-path
+ */
+
+import Database from 'better-sqlite3';
+import { existsSync } from 'fs';
+
+const args = process.argv.slice(2);
+const flags: Record<string, string> = {};
+const modes: string[] = [];
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i].startsWith('--')) {
+    const key = args[i].slice(2);
+    if (['artifact', 'directives', 'search', 'list', 'stories', 'bugs-since'].includes(key)) {
+      if (key === 'search' || key === 'bugs-since') {
+        modes.push(key);
+        flags[key] = args[++i];
+      } else {
+        modes.push(key);
+      }
+    } else if (i + 1 < args.length && !args[i + 1].startsWith('--')) {
+      flags[key] = args[++i];
+    }
+  }
+}
+
+const dbPath = flags['db-path'] || '.valent-pipeline/pipeline.db';
+
+if (!existsSync(dbPath)) {
+  console.error(`Database not found: ${dbPath}`);
+  console.error('Run "valent-pipeline db init" to create it.');
+  process.exit(1);
+}
+
+const db = new Database(dbPath, { readonly: true });
+const mode = modes[0];
+
+if (!mode) {
+  console.error('Usage: query-kb.ts --artifact|--directives|--search|--list|--stories|--bugs-since');
+  process.exit(1);
+}
+
+switch (mode) {
+  case 'artifact': {
+    const storyId = flags['story'];
+    const type = flags['type'];
+    if (!storyId || !type) {
+      console.error('--artifact requires --story and --type');
+      process.exit(1);
+    }
+    const row = db.prepare(
+      'SELECT content, agent, created_at FROM artifacts WHERE story_id = ? AND artifact_type = ?'
+    ).get(storyId, type) as { content: string; agent: string; created_at: string } | undefined;
+    if (row) {
+      console.log(`--- ${type} for ${storyId} (by ${row.agent}, ${row.created_at}) ---`);
+      console.log(row.content);
+    } else {
+      console.log(`No artifact found: story=${storyId}, type=${type}`);
+    }
+    break;
+  }
+
+  case 'directives': {
+    const agent = flags['agent'];
+    let rows;
+    if (agent) {
+      rows = db.prepare(
+        "SELECT id, directive, reason FROM correction_directives WHERE target_agent = ? AND status = 'active'"
+      ).all(agent) as { id: string; directive: string; reason: string }[];
+    } else {
+      rows = db.prepare(
+        "SELECT id, target_agent, directive, reason FROM correction_directives WHERE status = 'active'"
+      ).all() as { id: string; target_agent: string; directive: string; reason: string }[];
+    }
+    if (rows.length === 0) {
+      console.log(agent ? `No active directives for ${agent}` : 'No active correction directives');
+    } else {
+      for (const r of rows) {
+        const target = 'target_agent' in r ? ` [${r.target_agent}]` : '';
+        console.log(`${r.id}${target}: ${r.directive}`);
+        if (r.reason) console.log(`  Reason: ${r.reason}`);
+      }
+    }
+    break;
+  }
+
+  case 'search': {
+    const query = flags['search'];
+    if (!query) {
+      console.error('--search requires a search term');
+      process.exit(1);
+    }
+    const rows = db.prepare(
+      "SELECT story_id, agent, artifact_type, snippet(artifacts_fts, 0, '>>>', '<<<', '...', 40) as snippet FROM artifacts_fts WHERE artifacts_fts MATCH ? ORDER BY rank LIMIT 10"
+    ).all(query) as { story_id: string; agent: string; artifact_type: string; snippet: string }[];
+    if (rows.length === 0) {
+      console.log(`No results for: ${query}`);
+    } else {
+      for (const r of rows) {
+        console.log(`[${r.story_id}] ${r.artifact_type} (${r.agent}): ${r.snippet}`);
+      }
+    }
+    break;
+  }
+
+  case 'list': {
+    const storyId = flags['story'];
+    if (!storyId) {
+      console.error('--list requires --story');
+      process.exit(1);
+    }
+    const rows = db.prepare(
+      'SELECT artifact_type, agent, length(content) as size, created_at FROM artifacts WHERE story_id = ? ORDER BY created_at'
+    ).all(storyId) as { artifact_type: string; agent: string; size: number; created_at: string }[];
+    if (rows.length === 0) {
+      console.log(`No artifacts for story ${storyId}`);
+    } else {
+      console.log(`Artifacts for ${storyId}:`);
+      for (const r of rows) {
+        console.log(`  ${r.artifact_type} (${r.agent}, ${r.size} chars, ${r.created_at})`);
+      }
+    }
+    break;
+  }
+
+  case 'stories': {
+    const rows = db.prepare(
+      'SELECT DISTINCT story_id, COUNT(*) as artifact_count FROM artifacts GROUP BY story_id ORDER BY story_id'
+    ).all() as { story_id: string; artifact_count: number }[];
+    if (rows.length === 0) {
+      console.log('No stories in database');
+    } else {
+      for (const r of rows) {
+        console.log(`${r.story_id}: ${r.artifact_count} artifacts`);
+      }
+    }
+    break;
+  }
+
+  case 'bugs-since': {
+    const since = flags['bugs-since'];
+    if (!since) {
+      console.error('--bugs-since requires a date (YYYY-MM-DD)');
+      process.exit(1);
+    }
+    const rows = db.prepare(
+      "SELECT story_id, content FROM artifacts WHERE artifact_type = 'bugs' AND created_at > ? ORDER BY created_at"
+    ).all(since) as { story_id: string; content: string }[];
+    if (rows.length === 0) {
+      console.log(`No bugs filed since ${since}`);
+    } else {
+      for (const r of rows) {
+        console.log(`--- Bugs from ${r.story_id} ---`);
+        console.log(r.content);
+      }
+    }
+    break;
+  }
+}
+
+db.close();

package/src/commands/init.js

@@ -74,9 +74,29 @@ export async function init(options = {}) {
     console.log('  Created knowledge/correction-directives.yaml');
   }
 
-  // 7. Initialize SQLite DB if sqlite mode
+  // 7. Install SQLite dependencies inside .valent-pipeline/
   if (config.knowledge?.mode === 'sqlite') {
-    console.log('  SQLite knowledge mode selected. Run "valent-pipeline db init" to create the database.');
+    const vpPkgPath = join(pipelineDest, 'package.json');
+    if (!fileExists(vpPkgPath)) {
+      writeFileSafe(vpPkgPath, JSON.stringify({
+        "name": "valent-pipeline-runtime",
+        "private": true,
+        "description": "Runtime dependencies for valent-pipeline scripts. Do not edit.",
+        "dependencies": {
+          "better-sqlite3": "^11.0.0",
+          "sqlite-vec": "^0.1.0"
+        }
+      }, null, 2) + '\n');
+    }
+    console.log('  Installing SQLite dependencies in .valent-pipeline/...');
+    const { execSync } = await import('child_process');
+    try {
+      execSync('npm install --production', { cwd: pipelineDest, stdio: 'pipe' });
+      console.log('  Installed better-sqlite3 + sqlite-vec');
+    } catch (err) {
+      console.warn('  Warning: Failed to install SQLite dependencies. Run "cd .valent-pipeline && npm install" manually.');
+    }
+    console.log('  Run "valent-pipeline db init" to create the database.');
   }
 
   // 8. Configure Claude settings for agent teams