@sandrinio/vbounce 1.6.0 → 1.7.0

package/templates/sprint_report.md

@@ -3,7 +3,7 @@ FOLLOW THIS EXACT STRUCTURE. Output sections in order 1-6.
 
 1. **YAML Frontmatter**: Sprint ID, Goal, Dates, Status, Delivery Ref, Delivery Plan Ref
 2. **§1 What Was Delivered**: User-facing summary — what's accessible/usable vs what's internal/backend
-3. **§2 Story Results**: Table of all stories with final status and per-story metrics
+3. **§2 Story Results**: Table of all stories with final status and per-story metrics. §2.1 Change Requests logs any mid-sprint user interventions (bugs, spec clarifications, scope/approach changes)
 4. **§3 Execution Metrics**: AI performance metrics — tokens, duration, bounces, correction tax
 5. **§4 Lessons Learned**: Flagged from agent reports, pending user approval to record
 6. **§5 Retrospective**: What went well, what didn't, and what to change — covers both project and delivery process
@@ -72,6 +72,13 @@ delivery_plan_ref: "product_plans/{delivery}/DELIVERY_PLAN.md"
 ### Escalated Stories (if any)
 - **STORY-{ID}-{story_name}**: Escalated after {N} bounces. Root cause: {why}. Recommendation: {rewrite spec / descope / kill}.
 
+### 2.1 Change Requests
+> Mid-sprint user interventions — bugs found, spec clarifications, scope or approach changes. Tracked separately from agent-driven bounces so metrics aren't skewed. Omit this section if no CRs occurred.
+
+| Story | Category | Description | Impact |
+|-------|----------|-------------|--------|
+| STORY-{ID} | Bug / Spec Clarification / Scope Change / Approach Change | {One-line description} | {e.g., No bounce reset / Dev pass reset / +1 session} |
+
 ---
 
 ## 3. Execution Metrics

package/templates/story.md

@@ -153,4 +153,4 @@ POST /api/resource
 - [ ] LESSONS.md consulted before implementation.
 - [ ] No violations of Roadmap ADRs.
 - [ ] Documentation (API/Tech Stack) updated.
-- [ ] **Framework Integrity**: If `brains/` or `skills/` were modified, log to `brains/CHANGELOG.md` and run `./scripts/pre_bounce_sync.sh`.
+- [ ] **Framework Integrity**: If `brains/` or `skills/` were modified, log to `brains/CHANGELOG.md`.

package/scripts/pre_bounce_sync.sh

@@ -1,37 +0,0 @@
-#!/usr/bin/env bash
-
-# pre_bounce_sync.sh
-# 
-# Run this before kicking off the Implementation Loop (Bounce).
-# This prevents the "Stale Context" edge case by forcing the LanceDB
-# index to refresh with the latest rules from LESSONS.md and ROADMAP.md.
-
-echo "==========================================="
-echo " V-Bounce OS: Pre-Bounce Sync Started"
-echo "==========================================="
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" &> /dev/null && pwd)"
-ROOT_DIR="$(dirname "$SCRIPT_DIR")"
-
-cd "$ROOT_DIR" || exit 1
-
-# 1. Check for Node Modules
-if [ ! -d "node_modules" ]; then
-    echo "Error: node_modules not found. Run 'npm install'."
-    exit 1
-fi
-
-# 2. Rebuild the semantic search index
-echo "Syncing V-Bounce Knowledge Base (LanceDB)..."
-node ./scripts/vbounce_index.mjs --all
-
-if [ $? -ne 0 ]; then
-    echo "Error: LanceDB index sync failed."
-    exit 1
-fi
-
-echo "==========================================="
-echo " Pre-Bounce Sync Complete. RAG is fresh."
-echo " Ready for Team Lead delegation."
-echo "==========================================="
-exit 0

package/scripts/vbounce_ask.mjs

@@ -1,98 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import path from 'path';
-import { connect } from '@lancedb/lancedb';
-import { pipeline } from '@xenova/transformers';
-import { program } from 'commander';
-
-const LANCE_DIR = path.join(process.cwd(), '.bounce', '.lancedb');
-
-program
-    .name('vbounce_ask')
-    .description('Query V-Bounce OS LanceDB for relevant context')
-    .argument('<query>', 'The semantic query to search for')
-    .option('-f, --filter <field=value>', 'Filter by metadata (e.g., type=lesson)')
-    .option('-l, --limit <number>', 'Number of results to return', 3)
-    .parse(process.argv);
-
-const options = program.opts();
-const query = program.args[0];
-
-class LocalEmbeddingFunction {
-    constructor() {
-        this.modelName = 'Xenova/all-MiniLM-L6-v2';
-        this.extractor = null;
-    }
-
-    async init() {
-        if (!this.extractor) {
-            this.extractor = await pipeline('feature-extraction', this.modelName, {
-                quantized: true,
-            });
-        }
-    }
-
-    async embedQuery(text) {
-        await this.init();
-        const output = await this.extractor(text, { pooling: 'mean', normalize: true });
-        return Array.from(output.data);
-    }
-}
-
-async function main() {
-    if (!query) {
-        console.error("Error: Must provide a semantic query string.");
-        process.exit(1);
-    }
-
-    if (!fs.existsSync(LANCE_DIR)) {
-        console.error(`Error: LanceDB not found at ${LANCE_DIR}. Have you run vbounce_index yet?`);
-        process.exit(1);
-    }
-
-    const db = await connect(LANCE_DIR);
-    let table;
-    try {
-        table = await db.openTable('vbounce_context');
-    } catch (e) {
-        console.error("Error: Table 'vbounce_context' not found. Please index documents first.");
-        process.exit(1);
-    }
-
-    const embedder = new LocalEmbeddingFunction();
-    const queryVector = await embedder.embedQuery(query);
-
-    let search = table.vectorSearch(queryVector).limit(parseInt(options.limit));
-
-    if (options.filter) {
-        const [field, value] = options.filter.split('=');
-        // LanceDB JS uses SQL-like string criteria for filtering
-        if (field === "type") {
-            search = search.where(`\`type\` = '${value}'`);
-        } else if (field === "section") {
-            search = search.where(`\`section\` = '${value}'`);
-        }
-    }
-
-    const results = await search.toArray();
-
-    if (results.length === 0) {
-        console.log("No relevant context found.");
-        return;
-    }
-
-    console.log(`\n--- V-Bounce Semantic Retrieval ---`);
-    console.log(`Query: "${query}"`);
-    console.log(`Found ${results.length} relevant chunks.\n`);
-
-    results.forEach((r, idx) => {
-        console.log(`[Result ${idx + 1}] Source: ${r.file} (${r.type || 'unknown'} > ${r.section || 'General'})`);
-        console.log(`Distance: ${r._distance ? r._distance.toFixed(4) : 'N/A'}`);
-        console.log('-'.repeat(40));
-        console.log(r.text.trim());
-        console.log('\n');
-    });
-}
-
-main().catch(console.error);

package/scripts/vbounce_index.mjs

@@ -1,184 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import path from 'path';
-import { connect } from '@lancedb/lancedb';
-import { pipeline } from '@xenova/transformers';
-import { marked } from 'marked';
-import { program } from 'commander';
-
-const LANCE_DIR = path.join(process.cwd(), '.bounce', '.lancedb');
-
-program
-    .name('vbounce_index')
-    .description('Index V-Bounce OS documents into local LanceDB')
-    .argument('[path]', 'File or directory path to index (or use --all)')
-    .option('--all', 'Index all standard V-Bounce directories')
-    .parse(process.argv);
-
-const options = program.opts();
-const targetPath = program.args[0];
-
-// Initialize local embedding model wrapper
-class LocalEmbeddingFunction {
-    constructor() {
-        this.modelName = 'Xenova/all-MiniLM-L6-v2';
-        this.extractor = null;
-    }
-
-    async init() {
-        if (!this.extractor) {
-            console.log(`Loading embedding model (${this.modelName})...`);
-            this.extractor = await pipeline('feature-extraction', this.modelName, {
-                quantized: true,
-            });
-        }
-    }
-
-    async computeSourceEmbeddings(texts) {
-        await this.init();
-        const embeddings = [];
-        for (const text of texts) {
-            const output = await this.extractor(text, { pooling: 'mean', normalize: true });
-            embeddings.push(Array.from(output.data));
-        }
-        return embeddings;
-    }
-}
-
-// Function to chunk Markdown files semantically (simplified for MVP)
-function chunkMarkdown(content, metadata) {
-    const tokens = marked.lexer(content);
-    const chunks = [];
-    let currentHeader = 'General';
-    let buffer = '';
-
-    for (const token of tokens) {
-        if (token.type === 'heading') {
-            if (buffer.trim()) {
-                chunks.push({ text: buffer.trim(), section: currentHeader, ...metadata });
-            }
-            currentHeader = token.text;
-            buffer = `${token.raw}\n`;
-        } else {
-            buffer += `${token.raw}\n`;
-        }
-    }
-
-    if (buffer.trim()) {
-        chunks.push({ text: buffer.trim(), section: currentHeader, ...metadata });
-    }
-
-    return chunks;
-}
-
-async function indexFile(filePath, embedder) {
-    console.log(`Processing file: ${filePath}`);
-    const content = fs.readFileSync(filePath, 'utf-8');
-    const basename = path.basename(filePath);
-
-    let type = 'unknown';
-    if (filePath.includes('LESSONS.md')) type = 'lesson';
-    else if (filePath.includes('ROADMAP.md')) type = 'adr';
-    else if (filePath.includes('.bounce/reports')) type = 'report';
-    else if (filePath.includes('product_plans')) type = 'plan';
-    else if (filePath.includes('vdocs')) type = 'documentation';
-
-    const metadata = { file: basename, type };
-    const chunks = chunkMarkdown(content, metadata);
-
-    if (chunks.length === 0) return [];
-
-    console.log(`  Extracted ${chunks.length} chunks. Generating embeddings...`);
-
-    const textsToEmbed = chunks.map(c => `[${c.type} - ${c.file} - ${c.section}]\n${c.text}`);
-    const vectors = await embedder.computeSourceEmbeddings(textsToEmbed);
-
-    return chunks.map((chunk, i) => ({
-        id: `${chunk.file}-${i}`,
-        file: chunk.file,
-        type: chunk.type,
-        section: chunk.section,
-        text: chunk.text,
-        vector: vectors[i]
-    }));
-}
-
-async function main() {
-    if (!targetPath && !options.all) {
-        console.error("Error: Must specify a path or use --all");
-        process.exit(1);
-    }
-
-    const embedder = new LocalEmbeddingFunction();
-
-    // Ensure table exists
-    if (!fs.existsSync(LANCE_DIR)) {
-        fs.mkdirSync(LANCE_DIR, { recursive: true });
-    }
-
-    const db = await connect(LANCE_DIR);
-    let table;
-
-    try {
-        table = await db.openTable('vbounce_context');
-    } catch (e) {
-        // Table doesn't exist, will create dynamically on first insert
-        console.log("Creating new vbounce_context table...");
-    }
-
-    const filesToIndex = [];
-
-    function walkDir(dir) {
-        if (!fs.existsSync(dir)) return;
-        const files = fs.readdirSync(dir);
-        for (const file of files) {
-            const fullPath = path.join(dir, file);
-            const stat = fs.statSync(fullPath);
-            if (stat.isDirectory()) {
-                walkDir(fullPath);
-            } else if (fullPath.endsWith('.md')) {
-                filesToIndex.push(fullPath);
-            }
-        }
-    }
-
-    if (options.all) {
-        if (fs.existsSync('LESSONS.md')) filesToIndex.push('LESSONS.md');
-        if (fs.existsSync('ROADMAP.md')) filesToIndex.push('ROADMAP.md');
-        walkDir('product_plans');
-        walkDir('vdocs');
-        walkDir('.bounce/reports');
-    } else if (targetPath) {
-        const stat = fs.statSync(targetPath);
-        if (stat.isFile()) {
-            filesToIndex.push(targetPath);
-        } else if (stat.isDirectory()) {
-            walkDir(targetPath);
-        }
-    }
-
-    if (filesToIndex.length === 0) {
-        console.log("No files found to index.");
-        process.exit(0);
-    }
-
-    let allRecords = [];
-    for (const file of filesToIndex) {
-        const records = await indexFile(file, embedder);
-        allRecords = allRecords.concat(records);
-    }
-
-    if (allRecords.length > 0) {
-        if (table) {
-            console.log(`Adding ${allRecords.length} records to existing table...`);
-            await table.add(allRecords);
-        } else {
-            console.log(`Creating table with ${allRecords.length} records...`);
-            table = await db.createTable('vbounce_context', allRecords);
-        }
-        console.log(`Successfully indexed into LanceDB.`);
-    }
-}
-
-main().catch(console.error);