valent-pipeline 0.1.13 → 0.1.15

package/package.json

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

package/pipeline/prompts/judge-g2.md

@@ -12,9 +12,9 @@ Read `.valent-pipeline/steps/common/agent-protocol.md` for Communication Standar
 
 You are spawned at story kick-off but do NOT begin work immediately.
 
-- **Wait for:** `[JUDGE-G1-APPROVAL]` (Pass 2) from JUDGE-G1
-- **On SHIP verdict:** Send `[JUDGE-G2-SHIP]` to Lead. Lead owns ship/teardown.
-- **On REJECT verdict:** Send `[JUDGE-G2-REJECT]` to Lead. Lead owns G2 rejection routing -- this is non-routine.
+- **Wait for:** `[JUDGE-G1-APPROVAL]` (Pass 2) from JUDGE-G1. Do NOT begin if CRITIC or QA-B tasks are still `in_progress` (rejection/bug cycle ongoing).
+- **On SHIP verdict:** Send `[JUDGE-G2-SHIP]` to Lead. Mark task completed. Lead owns ship/teardown.
+- **On REJECT verdict:** Send `[JUDGE-G2-REJECT]` to Lead. Mark task completed. Lead owns G2 rejection routing -- this is non-routine.
 - **Escalate to:** Lead -- for `[BLOCKER]` or any issue you cannot resolve.
 
 ## Output

package/pipeline/prompts/qa-b.md

@@ -12,9 +12,9 @@ Read `.valent-pipeline/steps/common/agent-protocol.md` for Communication Standar
 
 You are spawned at story kick-off but do NOT begin work immediately.
 
-- **Wait for:** `[CRITIC-APPROVED]` from CRITIC
-- **On completion:** Send `[HANDOFF]` to JUDGE-G1 (triggers Pass 2). CC Lead.
-- **On bugs found:** Send `[BUG]` directly to BEND or FEND. CC Lead. Continue execution.
+- **Wait for:** `[CRITIC-APPROVED]` from CRITIC. Do NOT begin if CRITIC's task is still `in_progress` (rejection cycle ongoing).
+- **On completion (all tests pass, no P1 bugs):** Send `[HANDOFF]` to JUDGE-G1 (triggers Pass 2). Send `[DONE]` to Lead. Mark task completed.
+- **On bugs found:** Send `[BUG]` directly to BEND or FEND. CC Lead. Do NOT mark task completed until dev fixes and you re-run. Task stays `in_progress` during bug fix cycle.
 - **Escalate to:** Lead -- for `[BLOCKER]`, `[ESCALATION]`, or any issue you cannot resolve peer-to-peer.
 
 ## Output

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();