reflectt-node 0.1.0

package/dist/knowledge-auto-index.js

@@ -0,0 +1,149 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Knowledge Auto-Index Pipeline
+ *
+ * Automatically indexes knowledge into the vector store when:
+ * 1. A task transitions to done (indexes artifacts, QA bundle, done criteria)
+ * 2. Process files are written via API
+ * 3. Task comments tagged as decisions are created
+ *
+ * Dedup: uses composite source IDs to prevent duplicate indexing.
+ */
+import { getDb } from './db.js';
+// ── Dedup tracking ─────────────────────────────────────────────────────────
+// Track what's been indexed this session to avoid redundant embedding calls
+const indexedSet = new Set();
+function makeKey(sourceType, sourceId) {
+    return `${sourceType}::${sourceId}`;
+}
+function alreadyIndexed(sourceType, sourceId) {
+    return indexedSet.has(makeKey(sourceType, sourceId));
+}
+function markIndexed(sourceType, sourceId) {
+    indexedSet.add(makeKey(sourceType, sourceId));
+}
+/**
+ * Called when a task transitions to done.
+ * Indexes: task content, QA bundle summary, artifact references.
+ */
+export async function onTaskShipped(data) {
+    let indexed = 0;
+    try {
+        const { upsertVector } = await import('./vector-store.js');
+        const { embed } = await import('./embeddings.js');
+        const db = getDb();
+        // 1. Index the task itself (may already be indexed, but update with final state)
+        const taskKey = `task-ship::${data.taskId}`;
+        if (!alreadyIndexed('task_ship', taskKey)) {
+            const parts = [`Task shipped: ${data.title}`];
+            if (data.description)
+                parts.push(data.description);
+            if (data.doneCriteria?.length)
+                parts.push(`Done: ${data.doneCriteria.join('. ')}`);
+            if (data.assignee)
+                parts.push(`By: ${data.assignee}`);
+            const text = parts.join(' — ');
+            const embedding = await embed(text);
+            upsertVector(db, 'task_ship', data.taskId, text.slice(0, 500), embedding);
+            markIndexed('task_ship', taskKey);
+            indexed++;
+        }
+        // 2. Index QA bundle summary if present
+        const meta = data.metadata || {};
+        const qaBundleSummary = meta.qa_bundle?.summary;
+        if (qaBundleSummary && typeof qaBundleSummary === 'string') {
+            const qaKey = `qa::${data.taskId}`;
+            if (!alreadyIndexed('qa_bundle', qaKey)) {
+                const qaText = `QA: ${data.title} — ${qaBundleSummary}`;
+                const embedding = await embed(qaText);
+                upsertVector(db, 'qa_bundle', data.taskId, qaText.slice(0, 500), embedding);
+                markIndexed('qa_bundle', qaKey);
+                indexed++;
+            }
+        }
+        // 3. Index artifact paths/links
+        const artifacts = meta.artifacts || [];
+        const artifactPath = meta.artifact_path;
+        if (artifactPath)
+            artifacts.push(artifactPath);
+        for (const artifact of artifacts) {
+            const artKey = `artifact::${data.taskId}::${artifact}`;
+            if (!alreadyIndexed('artifact', artKey)) {
+                const artText = `Artifact for "${data.title}": ${artifact}`;
+                const embedding = await embed(artText);
+                upsertVector(db, 'artifact', `${data.taskId}::${artifact}`, artText.slice(0, 500), embedding);
+                markIndexed('artifact', artKey);
+                indexed++;
+            }
+        }
+    }
+    catch (err) {
+        console.error(`[KnowledgeAutoIndex] Failed to index shipped task ${data.taskId}:`, err?.message);
+    }
+    if (indexed > 0) {
+        console.log(`[KnowledgeAutoIndex] Indexed ${indexed} entries for shipped task ${data.taskId}`);
+    }
+    return indexed;
+}
+// ── Process File Indexing ──────────────────────────────────────────────────
+/**
+ * Called when a file in process/ is written via API or filesystem.
+ * Re-indexes the file content.
+ */
+export async function onProcessFileWritten(filePath, content) {
+    const key = `process_file::${filePath}`;
+    // Don't check alreadyIndexed for file writes — content may have changed
+    try {
+        const { upsertVector } = await import('./vector-store.js');
+        const { embed } = await import('./embeddings.js');
+        const db = getDb();
+        const text = `File: ${filePath}\n${content.slice(0, 3000)}`;
+        const embedding = await embed(text);
+        upsertVector(db, 'shared_file', filePath, text.slice(0, 500), embedding);
+        markIndexed('shared_file', key);
+        return true;
+    }
+    catch (err) {
+        console.error(`[KnowledgeAutoIndex] Failed to index process file ${filePath}:`, err?.message);
+        return false;
+    }
+}
+/**
+ * Called when a task comment is created with category 'decision' or
+ * contains decision-indicating content.
+ */
+export async function onDecisionComment(data) {
+    const key = `decision::${data.commentId}`;
+    if (alreadyIndexed('decision', key))
+        return false;
+    try {
+        const { upsertVector } = await import('./vector-store.js');
+        const { embed } = await import('./embeddings.js');
+        const db = getDb();
+        const parts = [`Decision on "${data.taskTitle || data.taskId}"`];
+        parts.push(data.content);
+        parts.push(`By: ${data.author}`);
+        const text = parts.join(' — ');
+        const embedding = await embed(text);
+        upsertVector(db, 'decision', data.commentId, text.slice(0, 500), embedding);
+        markIndexed('decision', key);
+        return true;
+    }
+    catch (err) {
+        console.error(`[KnowledgeAutoIndex] Failed to index decision comment ${data.commentId}:`, err?.message);
+        return false;
+    }
+}
+/**
+ * Check if a comment looks like a decision.
+ * Matches category=decision or content patterns.
+ */
+export function isDecisionComment(content, category) {
+    if (category === 'decision')
+        return true;
+    // Content heuristics
+    const lower = content.toLowerCase();
+    return lower.startsWith('decision:') || lower.includes('[decision]');
+}
+//# sourceMappingURL=knowledge-auto-index.js.map

package/dist/knowledge-auto-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-auto-index.js","sourceRoot":"","sources":["../src/knowledge-auto-index.ts"],"names":[],"mappings":"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"}

package/dist/knowledge-docs.d.ts

@@ -0,0 +1,45 @@
+export type DocCategory = 'decision' | 'runbook' | 'architecture' | 'lesson' | 'how-to';
+export declare const VALID_CATEGORIES: DocCategory[];
+export interface KnowledgeDoc {
+    id: string;
+    title: string;
+    content: string;
+    tags: string[];
+    category: DocCategory;
+    author: string;
+    related_task_ids: string[];
+    related_insight_ids: string[];
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateDocInput {
+    title: string;
+    content: string;
+    tags?: string[];
+    category: DocCategory;
+    author: string;
+    related_task_ids?: string[];
+    related_insight_ids?: string[];
+}
+export interface UpdateDocInput {
+    title?: string;
+    content?: string;
+    tags?: string[];
+    category?: DocCategory;
+    author?: string;
+    related_task_ids?: string[];
+    related_insight_ids?: string[];
+}
+export declare function createDoc(input: CreateDocInput): KnowledgeDoc;
+export declare function getDoc(id: string): KnowledgeDoc | null;
+export declare function listDocs(filters?: {
+    tag?: string;
+    category?: DocCategory;
+    author?: string;
+    search?: string;
+    limit?: number;
+}): KnowledgeDoc[];
+export declare function updateDoc(id: string, input: UpdateDocInput): KnowledgeDoc | null;
+export declare function deleteDoc(id: string): boolean;
+export declare function countDocs(category?: DocCategory): number;
+//# sourceMappingURL=knowledge-docs.d.ts.map

package/dist/knowledge-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-docs.d.ts","sourceRoot":"","sources":["../src/knowledge-docs.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEvF,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAAgE,CAAA;AAE1G,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,QAAQ,EAAE,WAAW,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,WAAW,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC/B;AA6FD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CA2B7D;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAKtD;AAED,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,YAAY,EAAE,CAgCjB;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAkDhF;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAK7C;AAED,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAOxD"}

package/dist/knowledge-docs.js

@@ -0,0 +1,188 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Knowledge Documents — Structured team knowledge with tags and categories
+ *
+ * CRUD for durable knowledge articles: decisions, runbooks, architecture docs,
+ * lessons, and how-tos. Auto-indexed in vector store for semantic search.
+ */
+import { getDb } from './db.js';
+export const VALID_CATEGORIES = ['decision', 'runbook', 'architecture', 'lesson', 'how-to'];
+// ── Database setup ─────────────────────────────────────────────────────────
+let initialized = false;
+function ensureTable() {
+    if (initialized)
+        return;
+    const db = getDb();
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS knowledge_docs (
+      id TEXT PRIMARY KEY,
+      title TEXT NOT NULL,
+      content TEXT NOT NULL,
+      tags_json TEXT NOT NULL DEFAULT '[]',
+      category TEXT NOT NULL CHECK(category IN ('decision', 'runbook', 'architecture', 'lesson', 'how-to')),
+      author TEXT NOT NULL,
+      related_task_ids_json TEXT NOT NULL DEFAULT '[]',
+      related_insight_ids_json TEXT NOT NULL DEFAULT '[]',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    )
+  `);
+    db.exec('CREATE INDEX IF NOT EXISTS idx_kdocs_category ON knowledge_docs(category)');
+    db.exec('CREATE INDEX IF NOT EXISTS idx_kdocs_author ON knowledge_docs(author)');
+    db.exec('CREATE INDEX IF NOT EXISTS idx_kdocs_created ON knowledge_docs(created_at)');
+    initialized = true;
+}
+// ── ID generation ──────────────────────────────────────────────────────────
+function generateId() {
+    const ts = Date.now();
+    const rand = Math.random().toString(36).slice(2, 10);
+    return `kdoc-${ts}-${rand}`;
+}
+function rowToDoc(row) {
+    return {
+        id: row.id,
+        title: row.title,
+        content: row.content,
+        tags: JSON.parse(row.tags_json || '[]'),
+        category: row.category,
+        author: row.author,
+        related_task_ids: JSON.parse(row.related_task_ids_json || '[]'),
+        related_insight_ids: JSON.parse(row.related_insight_ids_json || '[]'),
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    };
+}
+// ── Validation ─────────────────────────────────────────────────────────────
+function validateCreateInput(input) {
+    const errors = [];
+    if (!input.title || typeof input.title !== 'string' || input.title.trim() === '') {
+        errors.push('title is required');
+    }
+    if (!input.content || typeof input.content !== 'string' || input.content.trim() === '') {
+        errors.push('content is required');
+    }
+    if (!input.category || !VALID_CATEGORIES.includes(input.category)) {
+        errors.push(`category must be one of: ${VALID_CATEGORIES.join(', ')}`);
+    }
+    if (!input.author || typeof input.author !== 'string' || input.author.trim() === '') {
+        errors.push('author is required');
+    }
+    if (input.tags && !Array.isArray(input.tags)) {
+        errors.push('tags must be an array');
+    }
+    return errors;
+}
+// ── CRUD ───────────────────────────────────────────────────────────────────
+export function createDoc(input) {
+    ensureTable();
+    const errors = validateCreateInput(input);
+    if (errors.length > 0) {
+        throw new Error(`Validation failed: ${errors.join('; ')}`);
+    }
+    const db = getDb();
+    const now = Date.now();
+    const id = generateId();
+    db.prepare(`
+    INSERT INTO knowledge_docs (id, title, content, tags_json, category, author, related_task_ids_json, related_insight_ids_json, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, input.title.trim(), input.content, JSON.stringify(input.tags || []), input.category, input.author.trim(), JSON.stringify(input.related_task_ids || []), JSON.stringify(input.related_insight_ids || []), now, now);
+    return getDoc(id);
+}
+export function getDoc(id) {
+    ensureTable();
+    const db = getDb();
+    const row = db.prepare('SELECT * FROM knowledge_docs WHERE id = ?').get(id);
+    return row ? rowToDoc(row) : null;
+}
+export function listDocs(filters) {
+    ensureTable();
+    const db = getDb();
+    const conditions = [];
+    const params = [];
+    if (filters?.category) {
+        conditions.push('category = ?');
+        params.push(filters.category);
+    }
+    if (filters?.author) {
+        conditions.push('author = ?');
+        params.push(filters.author);
+    }
+    if (filters?.search) {
+        conditions.push('(title LIKE ? OR content LIKE ?)');
+        const term = `%${filters.search}%`;
+        params.push(term, term);
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const limit = filters?.limit || 100;
+    let docs = db.prepare(`SELECT * FROM knowledge_docs ${where} ORDER BY updated_at DESC LIMIT ?`).all(...params, limit).map(rowToDoc);
+    // Post-filter: tag (JSON array in tags_json)
+    if (filters?.tag) {
+        const tag = filters.tag.toLowerCase();
+        docs = docs.filter(d => d.tags.some(t => t.toLowerCase() === tag));
+    }
+    return docs;
+}
+export function updateDoc(id, input) {
+    ensureTable();
+    const db = getDb();
+    const existing = getDoc(id);
+    if (!existing)
+        return null;
+    const updates = [];
+    const params = [];
+    if (input.title !== undefined) {
+        updates.push('title = ?');
+        params.push(input.title.trim());
+    }
+    if (input.content !== undefined) {
+        updates.push('content = ?');
+        params.push(input.content);
+    }
+    if (input.tags !== undefined) {
+        updates.push('tags_json = ?');
+        params.push(JSON.stringify(input.tags));
+    }
+    if (input.category !== undefined) {
+        if (!VALID_CATEGORIES.includes(input.category)) {
+            throw new Error(`category must be one of: ${VALID_CATEGORIES.join(', ')}`);
+        }
+        updates.push('category = ?');
+        params.push(input.category);
+    }
+    if (input.author !== undefined) {
+        updates.push('author = ?');
+        params.push(input.author.trim());
+    }
+    if (input.related_task_ids !== undefined) {
+        updates.push('related_task_ids_json = ?');
+        params.push(JSON.stringify(input.related_task_ids));
+    }
+    if (input.related_insight_ids !== undefined) {
+        updates.push('related_insight_ids_json = ?');
+        params.push(JSON.stringify(input.related_insight_ids));
+    }
+    if (updates.length === 0)
+        return existing;
+    const now = Date.now();
+    updates.push('updated_at = ?');
+    params.push(now);
+    params.push(id);
+    db.prepare(`UPDATE knowledge_docs SET ${updates.join(', ')} WHERE id = ?`).run(...params);
+    return getDoc(id);
+}
+export function deleteDoc(id) {
+    ensureTable();
+    const db = getDb();
+    const result = db.prepare('DELETE FROM knowledge_docs WHERE id = ?').run(id);
+    return result.changes > 0;
+}
+export function countDocs(category) {
+    ensureTable();
+    const db = getDb();
+    if (category) {
+        return db.prepare('SELECT COUNT(*) as c FROM knowledge_docs WHERE category = ?').get(category).c;
+    }
+    return db.prepare('SELECT COUNT(*) as c FROM knowledge_docs').get().c;
+}
+//# sourceMappingURL=knowledge-docs.js.map

package/dist/knowledge-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-docs.js","sourceRoot":"","sources":["../src/knowledge-docs.ts"],"names":[],"mappings":"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"}

package/dist/lane-config.d.ts

@@ -0,0 +1,25 @@
+export interface LaneConfig {
+    name: string;
+    agents: string[];
+    readyFloor: number;
+    wipLimit: number;
+}
+export declare const DEFAULT_LANES: LaneConfig[];
+/**
+ * Load lanes config. Reads TEAM-ROLES.yaml `lanes:` section if available;
+ * falls back to DEFAULT_LANES.
+ */
+export declare function getLanesConfig(): LaneConfig[];
+/** Find the lane an agent belongs to. Returns null if not in any lane. */
+export declare function getAgentLane(agent: string): LaneConfig | null;
+/**
+ * Check if an agent has reached their WIP limit.
+ * Returns null if agent is not in any lane (no limit applies).
+ */
+export declare function checkWipLimit(agent: string, doingCount: number): {
+    blocked: boolean;
+    wipLimit: number;
+    doing: number;
+    message: string;
+} | null;
+//# sourceMappingURL=lane-config.d.ts.map

package/dist/lane-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-config.d.ts","sourceRoot":"","sources":["../src/lane-config.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAMD,eAAO,MAAM,aAAa,EAAE,UAAU,EAMrC,CAAA;AA+BD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAwB7C;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAG7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAa/E"}

package/dist/lane-config.js

@@ -0,0 +1,105 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Lane configuration for ready-queue engine v1
+ *
+ * Lanes group agents into work streams with:
+ *   readyFloor — minimum unblocked todo tasks per agent
+ *   wipLimit   — max simultaneous doing tasks per agent
+ *
+ * Config is loaded from TEAM-ROLES.yaml `lanes:` section.
+ * Falls back to hardcoded defaults if not configured.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { REFLECTT_HOME } from './config.js';
+// ── Hardcoded defaults ─────────────────────────────────────────────────────
+// Matches the hardcoded lanes in server.ts /health/backlog.
+// These are the fallback when TEAM-ROLES.yaml has no `lanes:` section.
+export const DEFAULT_LANES = [
+    { name: 'engineering', agents: ['link', 'pixel'], readyFloor: 2, wipLimit: 2 },
+    { name: 'content', agents: ['echo'], readyFloor: 2, wipLimit: 2 },
+    { name: 'operations', agents: ['kai', 'sage'], readyFloor: 1, wipLimit: 2 },
+    { name: 'research', agents: ['scout'], readyFloor: 1, wipLimit: 2 },
+    { name: 'rhythm', agents: ['rhythm'], readyFloor: 1, wipLimit: 2 },
+];
+// ── Config paths ────────────────────────────────────────────────────────────
+const CONFIG_PATHS = [
+    join(REFLECTT_HOME, 'TEAM-ROLES.yaml'),
+    join(REFLECTT_HOME, 'TEAM-ROLES.yml'),
+];
+// ── YAML parsing ────────────────────────────────────────────────────────────
+function parseLanesFromYaml(content) {
+    try {
+        const data = parseYaml(content);
+        if (!data?.lanes || !Array.isArray(data.lanes))
+            return null;
+        const parsed = data.lanes.map((l) => ({
+            name: String(l.name || ''),
+            agents: Array.isArray(l.agents) ? l.agents.map(String) : [],
+            readyFloor: typeof l.readyFloor === 'number' ? l.readyFloor : 1,
+            wipLimit: typeof l.wipLimit === 'number' ? l.wipLimit : 2,
+        })).filter((l) => l.name && l.agents.length > 0);
+        return parsed.length > 0 ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Load lanes config. Reads TEAM-ROLES.yaml `lanes:` section if available;
+ * falls back to DEFAULT_LANES.
+ */
+export function getLanesConfig() {
+    const isTest = Boolean(process.env.VITEST) || process.env.NODE_ENV === 'test';
+    if (!isTest) {
+        // Try user config files
+        for (const configPath of CONFIG_PATHS) {
+            if (!existsSync(configPath))
+                continue;
+            try {
+                const content = readFileSync(configPath, 'utf-8');
+                const lanes = parseLanesFromYaml(content);
+                if (lanes)
+                    return lanes;
+            }
+            catch { /* fall through */ }
+        }
+        // Try defaults shipped with repo
+        try {
+            const defaultsPath = new URL('../defaults/TEAM-ROLES.yaml', import.meta.url);
+            const content = readFileSync(defaultsPath, 'utf-8');
+            const lanes = parseLanesFromYaml(content);
+            if (lanes)
+                return lanes;
+        }
+        catch { /* fall through */ }
+    }
+    return DEFAULT_LANES;
+}
+/** Find the lane an agent belongs to. Returns null if not in any lane. */
+export function getAgentLane(agent) {
+    const agentLower = agent.toLowerCase();
+    return getLanesConfig().find(l => l.agents.some(a => a.toLowerCase() === agentLower)) ?? null;
+}
+/**
+ * Check if an agent has reached their WIP limit.
+ * Returns null if agent is not in any lane (no limit applies).
+ */
+export function checkWipLimit(agent, doingCount) {
+    const lane = getAgentLane(agent);
+    if (!lane)
+        return null;
+    const blocked = doingCount >= lane.wipLimit;
+    return {
+        blocked,
+        wipLimit: lane.wipLimit,
+        doing: doingCount,
+        message: blocked
+            ? `WIP limit reached (${doingCount}/${lane.wipLimit} doing). Complete or park a task first.`
+            : `WIP ok (${doingCount}/${lane.wipLimit} doing).`,
+    };
+}
+//# sourceMappingURL=lane-config.js.map

package/dist/lane-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-config.js","sourceRoot":"","sources":["../src/lane-config.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4BAA4B;AAE5B;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAW3C,8EAA8E;AAC9E,4DAA4D;AAC5D,uEAAuE;AAEvE,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC9E,EAAE,IAAI,EAAE,SAAS,EAAM,MAAM,EAAE,CAAC,MAAM,CAAC,EAAW,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC9E,EAAE,IAAI,EAAE,YAAY,EAAG,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAI,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC9E,EAAE,IAAI,EAAE,UAAU,EAAK,MAAM,EAAE,CAAC,OAAO,CAAC,EAAU,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC9E,EAAE,IAAI,EAAE,QAAQ,EAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAS,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;CAC/E,CAAA;AAED,+EAA+E;AAE/E,MAAM,YAAY,GAAG;IACnB,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC;IACtC,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC;CACtC,CAAA;AAED,+EAA+E;AAE/E,SAAS,kBAAkB,CAAC,OAAe;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;QAC/B,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QAE3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAC1B,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;YAC3D,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/D,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SAC1D,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAa,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAE5D,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAA;IAE7E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,wBAAwB;QACxB,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,SAAQ;YACrC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;gBACjD,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAA;gBACzC,IAAI,KAAK;oBAAE,OAAO,KAAK,CAAA;YACzB,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAChC,CAAC;QAED,iCAAiC;QACjC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC5E,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;YACnD,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAA;YACzC,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACzB,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;IACtC,OAAO,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC,IAAI,IAAI,CAAA;AAC/F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,UAAkB;IAElB,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAChC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,MAAM,OAAO,GAAG,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAA;IAC3C,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,OAAO;YACd,CAAC,CAAC,sBAAsB,UAAU,IAAI,IAAI,CAAC,QAAQ,yCAAyC;YAC5F,CAAC,CAAC,WAAW,UAAU,IAAI,IAAI,CAAC,QAAQ,UAAU;KACrD,CAAA;AACH,CAAC"}

package/dist/lineage.d.ts

@@ -0,0 +1,86 @@
+export interface LineageEntry {
+    /** Unique lineage chain ID (derived from insight or reflection) */
+    chain_id: string;
+    /** Reflection that started the chain */
+    reflection: {
+        id: string;
+        author: string;
+        pain: string;
+        severity: string | null;
+        confidence: number;
+        created_at: number;
+    } | null;
+    /** Insight the reflection was clustered into */
+    insight: {
+        id: string;
+        cluster_key: string;
+        status: string;
+        score: number;
+        priority: string;
+        promotion_readiness: string;
+        reflection_count: number;
+        independent_count: number;
+        severity_max: string | null;
+        created_at: number;
+        updated_at: number;
+    } | null;
+    /** Task created from the insight (if any) */
+    task: {
+        id: string;
+        title: string;
+        status: string;
+        priority: string;
+        assignee: string | null;
+        reviewer: string | null;
+        created_at: number;
+    } | null;
+    /** Promotion audit record (if promoted) */
+    promotion: {
+        id: string;
+        promoted_by: string;
+        created_at: number;
+    } | null;
+    /** Missing-link anomalies detected in this chain */
+    anomalies: LineageAnomaly[];
+    /** Timestamps of key events in the chain */
+    timeline: TimelineEvent[];
+}
+export interface LineageAnomaly {
+    type: 'missing_insight' | 'missing_task' | 'orphaned_insight' | 'stale_promotion' | 'missing_reflection';
+    message: string;
+    severity: 'warning' | 'error';
+}
+export interface TimelineEvent {
+    event: string;
+    timestamp: number;
+    actor?: string;
+    detail?: string;
+}
+export interface LineageListOpts {
+    status?: string;
+    team_id?: string;
+    role_type?: string;
+    author?: string;
+    has_anomaly?: boolean;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Build lineage entries by walking insight → reflections → tasks.
+ * Each insight forms a chain; orphaned reflections (no insight) get their own chain.
+ */
+export declare function listLineage(opts?: LineageListOpts): {
+    entries: LineageEntry[];
+    total: number;
+};
+/**
+ * Get lineage for a specific chain (by insight ID, reflection ID, or task ID).
+ */
+export declare function getLineage(id: string): LineageEntry | null;
+export declare function lineageStats(): {
+    total_chains: number;
+    with_task: number;
+    with_anomalies: number;
+    anomaly_breakdown: Record<string, number>;
+};
+//# sourceMappingURL=lineage.d.ts.map

package/dist/lineage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../src/lineage.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;QACvB,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;KACnB,GAAG,IAAI,CAAA;IACR,gDAAgD;IAChD,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAA;QACV,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,gBAAgB,EAAE,MAAM,CAAA;QACxB,iBAAiB,EAAE,MAAM,CAAA;QACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;KACnB,GAAG,IAAI,CAAA;IACR,6CAA6C;IAC7C,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;QACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;QACvB,UAAU,EAAE,MAAM,CAAA;KACnB,GAAG,IAAI,CAAA;IACR,2CAA2C;IAC3C,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAA;QACV,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;KACnB,GAAG,IAAI,CAAA;IACR,oDAAoD;IACpD,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,4CAA4C;IAC5C,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,iBAAiB,GAAG,cAAc,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,oBAAoB,CAAA;IACxG,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,eAAoB,GAAG;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAuClG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA6C1D;AAkND,wBAAgB,YAAY,IAAI;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C,CAqBA"}