@mmnto/cli 0.1.0

package/dist/commands/shield.js

@@ -0,0 +1,130 @@
+import * as path from 'node:path';
+import { createEmbedder, LanceStore } from '@mmnto/totem';
+import { extractChangedFiles, getDefaultBranch, getGitBranchDiff, getGitDiff } from '../git.js';
+import { formatResults, loadConfig, loadEnv, resolveConfigPath, runOrchestrator, writeOutput, } from '../utils.js';
+// ─── Constants ──────────────────────────────────────────
+const TAG = 'Shield';
+const MAX_DIFF_CHARS = 50_000;
+const QUERY_DIFF_TRUNCATE = 2_000;
+const MAX_SPEC_RESULTS = 3;
+const MAX_SESSION_RESULTS = 5;
+const MAX_CODE_RESULTS = 5;
+// ─── System prompt ──────────────────────────────────────
+const SYSTEM_PROMPT = `# Shield System Prompt — Pre-Flight Code Review
+
+## Purpose
+Perform a pre-flight code review on a git diff, using project-specific knowledge to catch traps and anti-patterns before a PR is opened.
+
+## Role
+You are a senior code reviewer analyzing a diff against the project's accumulated knowledge: past session lessons, architectural specs, and codebase conventions. Flag issues the developer might miss, especially ones that have caused problems before.
+
+## Rules
+- Focus on the DIFF — only comment on code that is actually changing
+- Reference specific lines/hunks from the diff when flagging issues
+- Cite Totem knowledge when it directly applies (e.g., "Session #142 found that...")
+- Distinguish severity: CRITICAL (must fix), WARNING (should fix), INFO (consider)
+- Be concise — this is a pre-flight check, not a full RFC
+- If the diff looks clean and follows all known patterns, say so
+
+## Output Format
+Respond with ONLY the sections below. No preamble, no closing remarks.
+
+### Summary
+[1-2 sentences describing what this diff does at a high level]
+
+### Critical Issues
+[Issues that MUST be fixed before merging. If none, say "None found."]
+
+### Warnings
+[Issues that SHOULD be addressed. Include pattern violations, potential regressions, and lessons from past sessions. If none, say "None found."]
+
+### Suggestions
+[Optional improvements and style notes. If none, say "None."]
+
+### Relevant History
+[Specific past traps, lessons, or decisions from Totem knowledge that apply to this diff. If none, say "No relevant history found."]
+`;
+async function retrieveContext(query, store) {
+    const search = (typeFilter, maxResults) => store.search({ query, typeFilter, maxResults });
+    const [specs, sessions, code] = await Promise.all([
+        search('spec', MAX_SPEC_RESULTS),
+        search('session_log', MAX_SESSION_RESULTS),
+        search('code', MAX_CODE_RESULTS),
+    ]);
+    return { specs, sessions, code };
+}
+function buildSearchQuery(changedFiles, diff) {
+    const fileNames = changedFiles.map((f) => path.basename(f)).join(' ');
+    const diffSnippet = diff.slice(0, QUERY_DIFF_TRUNCATE);
+    return `${fileNames} ${diffSnippet}`.trim();
+}
+// ─── Prompt assembly ────────────────────────────────────
+function assemblePrompt(diff, changedFiles, context) {
+    const sections = [SYSTEM_PROMPT];
+    // Diff section
+    sections.push('=== DIFF ===');
+    sections.push(`Changed files: ${changedFiles.join(', ')}`);
+    sections.push('');
+    if (diff.length > MAX_DIFF_CHARS) {
+        sections.push(diff.slice(0, MAX_DIFF_CHARS));
+        sections.push(`\n... [diff truncated at ${MAX_DIFF_CHARS} chars] ...`);
+    }
+    else {
+        sections.push(diff);
+    }
+    // Totem knowledge
+    const specSection = formatResults(context.specs, 'RELATED SPECS & ADRs');
+    const sessionSection = formatResults(context.sessions, 'RELATED SESSION HISTORY & LESSONS');
+    const codeSection = formatResults(context.code, 'RELATED CODE PATTERNS');
+    if (specSection || sessionSection || codeSection) {
+        sections.push('\n=== TOTEM KNOWLEDGE ===');
+        if (specSection)
+            sections.push(specSection);
+        if (sessionSection)
+            sections.push(sessionSection);
+        if (codeSection)
+            sections.push(codeSection);
+    }
+    return sections.join('\n');
+}
+export async function shieldCommand(options) {
+    const cwd = process.cwd();
+    const configPath = resolveConfigPath(cwd);
+    loadEnv(cwd);
+    const config = await loadConfig(configPath);
+    // Get git diff — try uncommitted/staged first, fall back to branch diff vs main
+    const mode = options.staged ? 'staged' : 'all';
+    console.error(`[${TAG}] Getting ${mode === 'staged' ? 'staged' : 'uncommitted'} diff...`);
+    let diff = getGitDiff(mode, cwd);
+    if (!diff.trim()) {
+        const base = getDefaultBranch(cwd);
+        console.error(`[${TAG}] No uncommitted changes. Falling back to branch diff (${base}...HEAD)...`);
+        diff = getGitBranchDiff(cwd, base);
+    }
+    if (!diff.trim()) {
+        console.error(`[${TAG}] No changes detected. Nothing to review.`);
+        return;
+    }
+    const changedFiles = extractChangedFiles(diff);
+    console.error(`[${TAG}] Changed files (${changedFiles.length}): ${changedFiles.join(', ')}`);
+    // Connect to LanceDB
+    const embedder = createEmbedder(config.embedding);
+    const store = new LanceStore(path.join(cwd, config.lanceDir), embedder);
+    await store.connect();
+    // Retrieve context from LanceDB
+    const query = buildSearchQuery(changedFiles, diff);
+    console.error(`[${TAG}] Querying Totem index...`);
+    const context = await retrieveContext(query, store);
+    const totalResults = context.specs.length + context.sessions.length + context.code.length;
+    console.error(`[${TAG}] Found: ${context.specs.length} specs, ${context.sessions.length} sessions, ${context.code.length} code chunks`);
+    // Assemble prompt
+    const prompt = assemblePrompt(diff, changedFiles, context);
+    console.error(`[${TAG}] Prompt: ${(prompt.length / 1024).toFixed(0)}KB`);
+    const content = runOrchestrator({ prompt, tag: TAG, options, config, cwd, totalResults });
+    if (content != null) {
+        writeOutput(content, options.out);
+        if (options.out)
+            console.error(`[${TAG}] Written to ${options.out}`);
+    }
+}
+//# sourceMappingURL=shield.js.map

package/dist/commands/shield.js.map

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

package/dist/commands/spec.d.ts

@@ -0,0 +1,7 @@
+export interface SpecOptions {
+    raw?: boolean;
+    out?: string;
+    model?: string;
+}
+export declare function specCommand(input: string, options: SpecOptions): Promise<void>;
+//# sourceMappingURL=spec.d.ts.map

package/dist/commands/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/commands/spec.ts"],"names":[],"mappings":"AAwKA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CpF"}

package/dist/commands/spec.js

@@ -0,0 +1,159 @@
+import { execFileSync } from 'node:child_process';
+import * as path from 'node:path';
+import { z } from 'zod';
+import { createEmbedder, LanceStore } from '@mmnto/totem';
+import { formatResults, GH_TIMEOUT_MS, IS_WIN, loadConfig, loadEnv, resolveConfigPath, runOrchestrator, writeOutput, } from '../utils.js';
+// ─── Constants ──────────────────────────────────────────
+const TAG = 'Spec';
+const QUERY_BODY_TRUNCATE = 500;
+// ─── System prompt ──────────────────────────────────────
+const SYSTEM_PROMPT = `# Spec System Prompt — Pre-Work Briefing
+
+## Purpose
+Produce a structured pre-work briefing for a GitHub issue before implementation begins.
+
+## Role
+You are a technical spec writer analyzing a GitHub issue and its related project context. Your job is to produce a focused briefing that identifies: relevant history, files to examine, implementation approach, traps, and test plan.
+
+## Rules
+- File paths must reference actual files from the context provided
+- Cite related issues by number (#NNN) when relevant
+- Identify edge cases the issue description doesn't mention
+- Be concise — this is a briefing, not a full proposal
+- When multiple approaches exist, list trade-offs with a clear recommendation
+
+## Output Format
+Respond with ONLY the sections below. No preamble, no closing remarks.
+
+### Problem
+[1-2 sentences restating the issue in concrete implementation terms. What exactly needs to change?]
+
+### Historical Context
+[Relevant sessions, PRs, decisions, related issues from the provided Totem knowledge. If nothing relevant, say "None found in provided context."]
+
+### Files to Examine
+[Ordered list of files the developer should read before starting. Most critical first. Format: \`path/to/file.ts\` — reason to examine]
+
+### Approach
+[Recommended implementation approach. Concrete steps, not abstract descriptions. If multiple valid approaches exist, list them as Option A / Option B with trade-offs and a clear recommendation.]
+
+### Edge Cases & Traps
+[Things the issue description doesn't mention but the developer should watch for. Include existing patterns that MUST be followed for consistency and potential regressions in related features.]
+
+### Test Plan
+[Specific test scenarios. Reference existing test file patterns when applicable.]
+
+### Related Issues
+[Issues that might be affected by or related to this work. Format: #NNN — title — relationship (blocks, unblocks, overlaps, conflicts). If none found, say "None identified."]
+`;
+// ─── GitHub helpers ─────────────────────────────────────
+const GhIssueSchema = z.object({
+    number: z.number(),
+    title: z.string(),
+    body: z.string().nullable(),
+    labels: z.array(z.object({ name: z.string() })),
+    state: z.string(),
+});
+function fetchIssue(issueNumber, cwd) {
+    try {
+        const result = execFileSync('gh', ['issue', 'view', String(issueNumber), '--json', 'number,title,body,labels,state'], { cwd, encoding: 'utf-8', timeout: GH_TIMEOUT_MS, shell: IS_WIN });
+        return GhIssueSchema.parse(JSON.parse(result));
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            throw new Error(`[Totem Error] Failed to parse GitHub issue response: ${err.message}`);
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('ENOENT') || msg.includes('not found')) {
+            throw new Error(`[Totem Error] GitHub CLI (gh) is required for issue fetching. Install: https://cli.github.com`);
+        }
+        throw new Error(`[Totem Error] Failed to fetch issue #${issueNumber}: ${msg}`);
+    }
+}
+async function retrieveContext(query, store) {
+    const search = (typeFilter, maxResults) => store.search({ query, typeFilter, maxResults });
+    const [specs, sessions, code] = await Promise.all([
+        search('spec', 5),
+        search('session_log', 5),
+        search('code', 3),
+    ]);
+    return { specs, sessions, code };
+}
+function buildSearchQuery(issue) {
+    const labels = issue.labels.map((l) => l.name).join(' ');
+    const bodySnippet = (issue.body ?? '').slice(0, QUERY_BODY_TRUNCATE);
+    return `${issue.title} ${labels} ${bodySnippet}`.trim();
+}
+// ─── Prompt assembly ────────────────────────────────────
+function assemblePrompt(issue, freeText, context) {
+    const sections = [SYSTEM_PROMPT];
+    // Target issue or free-text topic
+    if (issue) {
+        const issueLabels = issue.labels.map((l) => l.name).join(', ');
+        sections.push('=== TARGET ISSUE ===');
+        sections.push(`Issue #${issue.number}: ${issue.title}`);
+        sections.push(`Labels: ${issueLabels || '(none)'}`);
+        sections.push(`State: ${issue.state}`);
+        if (issue.body) {
+            sections.push('');
+            sections.push(issue.body);
+        }
+    }
+    else if (freeText) {
+        sections.push('=== TOPIC ===');
+        sections.push(freeText);
+    }
+    // Totem knowledge
+    const specSection = formatResults(context.specs, 'RELATED SPECS & ADRs');
+    const sessionSection = formatResults(context.sessions, 'RELATED SESSION HISTORY');
+    const codeSection = formatResults(context.code, 'RELATED CODE');
+    if (specSection || sessionSection || codeSection) {
+        sections.push('\n=== TOTEM KNOWLEDGE ===');
+        if (specSection)
+            sections.push(specSection);
+        if (sessionSection)
+            sections.push(sessionSection);
+        if (codeSection)
+            sections.push(codeSection);
+    }
+    return sections.join('\n');
+}
+export async function specCommand(input, options) {
+    const cwd = process.cwd();
+    const configPath = resolveConfigPath(cwd);
+    loadEnv(cwd);
+    const config = await loadConfig(configPath);
+    // Connect to LanceDB
+    const embedder = createEmbedder(config.embedding);
+    const store = new LanceStore(path.join(cwd, config.lanceDir), embedder);
+    await store.connect();
+    // Parse input: issue number or free-text
+    const issueNumber = /^\d+$/.test(input) ? parseInt(input, 10) : null;
+    let issue = null;
+    let query;
+    if (issueNumber) {
+        console.error(`[${TAG}] Fetching issue #${issueNumber}...`);
+        issue = fetchIssue(issueNumber, cwd);
+        console.error(`[${TAG}] Title: ${issue.title}`);
+        query = buildSearchQuery(issue);
+    }
+    else {
+        console.error(`[${TAG}] Topic: ${input}`);
+        query = input;
+    }
+    // Retrieve context from LanceDB
+    console.error(`[${TAG}] Querying Totem index...`);
+    const context = await retrieveContext(query, store);
+    const totalResults = context.specs.length + context.sessions.length + context.code.length;
+    console.error(`[${TAG}] Found: ${context.specs.length} specs, ${context.sessions.length} sessions, ${context.code.length} code chunks`);
+    // Assemble prompt
+    const prompt = assemblePrompt(issue, issueNumber ? null : input, context);
+    console.error(`[${TAG}] Prompt: ${(prompt.length / 1024).toFixed(0)}KB`);
+    const content = runOrchestrator({ prompt, tag: TAG, options, config, cwd, totalResults });
+    if (content != null) {
+        writeOutput(content, options.out);
+        if (options.out)
+            console.error(`[${TAG}] Written to ${options.out}`);
+    }
+}
+//# sourceMappingURL=spec.js.map

package/dist/commands/spec.js.map

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

package/dist/commands/stats.d.ts

@@ -0,0 +1,2 @@
+export declare function statsCommand(): Promise<void>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAMA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAsBlD"}

package/dist/commands/stats.js

@@ -0,0 +1,22 @@
+import * as path from 'node:path';
+import { createEmbedder, LanceStore } from '@mmnto/totem';
+import { loadConfig, loadEnv, resolveConfigPath } from '../utils.js';
+export async function statsCommand() {
+    const cwd = process.cwd();
+    const configPath = resolveConfigPath(cwd);
+    loadEnv(cwd);
+    const config = await loadConfig(configPath);
+    const embedder = createEmbedder(config.embedding);
+    const store = new LanceStore(path.join(cwd, config.lanceDir), embedder);
+    await store.connect();
+    const { totalChunks, byType } = await store.stats();
+    console.log(`[Totem] Index statistics:`);
+    console.log(`  Total chunks: ${totalChunks}`);
+    for (const [type, count] of Object.entries(byType)) {
+        console.log(`  ${type}: ${count}`);
+    }
+    if (totalChunks === 0) {
+        console.log('\n  No data indexed yet. Run `totem sync` first.');
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAE1C,OAAO,CAAC,GAAG,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IACxE,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IAEtB,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IAEpD,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,mBAAmB,WAAW,EAAE,CAAC,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/commands/sync.d.ts

@@ -0,0 +1,4 @@
+export declare function syncCommand(options: {
+    full?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAIA,wBAAsB,WAAW,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E"}

package/dist/commands/sync.js

@@ -0,0 +1,16 @@
+import { runSync } from '@mmnto/totem';
+import { loadConfig, loadEnv, resolveConfigPath } from '../utils.js';
+export async function syncCommand(options) {
+    const cwd = process.cwd();
+    const configPath = resolveConfigPath(cwd);
+    loadEnv(cwd);
+    const config = await loadConfig(configPath);
+    const incremental = !options.full;
+    const result = await runSync(config, {
+        projectRoot: cwd,
+        incremental,
+        onProgress: (msg) => console.log(`[Totem] ${msg}`),
+    });
+    console.log(`[Totem] Done: ${result.chunksProcessed} chunks from ${result.filesProcessed} files`);
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAE1C,OAAO,CAAC,GAAG,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;IAElC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE;QACnC,WAAW,EAAE,GAAG;QAChB,WAAW;QACX,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC;KACnD,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,eAAe,gBAAgB,MAAM,CAAC,cAAc,QAAQ,CAAC,CAAC;AACpG,CAAC"}

package/dist/commands/triage.d.ts

@@ -0,0 +1,7 @@
+export interface TriageOptions {
+    raw?: boolean;
+    out?: string;
+    model?: string;
+}
+export declare function triageCommand(options: TriageOptions): Promise<void>;
+//# sourceMappingURL=triage.d.ts.map

package/dist/commands/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/commands/triage.ts"],"names":[],"mappings":"AAkKA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCzE"}

package/dist/commands/triage.js

@@ -0,0 +1,149 @@
+import { execFileSync } from 'node:child_process';
+import * as path from 'node:path';
+import { z } from 'zod';
+import { createEmbedder, LanceStore } from '@mmnto/totem';
+import { formatResults, GH_TIMEOUT_MS, IS_WIN, loadConfig, loadEnv, resolveConfigPath, runOrchestrator, writeOutput, } from '../utils.js';
+// ─── Constants ──────────────────────────────────────────
+const TAG = 'Triage';
+const MAX_SPEC_RESULTS = 5;
+const MAX_SESSION_RESULTS = 5;
+const QUERY_TITLES_TRUNCATE = 2_000;
+const GH_ISSUE_LIMIT = 100;
+// ─── System prompt ──────────────────────────────────────
+const SYSTEM_PROMPT = `# Triage System Prompt — Active Work Roadmap
+
+## Purpose
+Produce a prioritized roadmap from the project's open GitHub issues, informed by recent work history from Totem knowledge.
+
+## Role
+You are a technical project manager analyzing a project's open issue backlog alongside its recent development history. Your job is to produce a clear, actionable prioritization that helps the developer decide what to work on next.
+
+## Rules
+- Reference issues by number (#NNN) and title
+- Consider labels (bug, enhancement, priority, etc.) as strong signals
+- Use recent session history and specs to understand project momentum — what was just finished, what's in progress
+- Factor in issue age (updatedAt) — stale issues may need re-evaluation
+- Be opinionated — give a clear recommendation, not a wishy-washy list
+- Be concise — this is a decision-making tool, not a project plan
+
+## Output Format
+Respond with ONLY the sections below. No preamble, no closing remarks.
+
+### Active Work Summary
+[1-3 sentences about what was recently completed or is in progress, based on the Totem knowledge provided. If no relevant history, say "No recent session history available."]
+
+### Prioritized Roadmap
+[Ordered list of open issues, most important first. For each: #NNN — title — 1-sentence rationale for its priority position. Group by priority tier if helpful (e.g., "Do Next", "Up Next", "Backlog").]
+
+### Next Issue
+[Single recommended issue to work on next. Include: issue number, title, and 2-3 sentences explaining WHY this should be next — considering dependencies, momentum, and impact.]
+
+### Blocked / Needs Input
+[Issues that cannot progress without external input, decisions, or prerequisite work. If none, say "None identified."]
+`;
+// ─── GitHub helpers ─────────────────────────────────────
+const GhIssueListItemSchema = z.object({
+    number: z.number(),
+    title: z.string(),
+    labels: z.array(z.object({ name: z.string() })),
+    updatedAt: z.string().datetime(),
+});
+function fetchOpenIssues(cwd) {
+    try {
+        const result = execFileSync('gh', [
+            'issue',
+            'list',
+            '--state',
+            'open',
+            '--json',
+            'number,title,labels,updatedAt',
+            '--limit',
+            String(GH_ISSUE_LIMIT),
+        ], { cwd, encoding: 'utf-8', timeout: GH_TIMEOUT_MS, shell: IS_WIN });
+        return z.array(GhIssueListItemSchema).parse(JSON.parse(result));
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            throw new Error(`[Totem Error] Failed to parse GitHub issue list response: ${err.message}`);
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('ENOENT') || msg.includes('not found')) {
+            throw new Error(`[Totem Error] GitHub CLI (gh) is required for issue fetching. Install: https://cli.github.com`);
+        }
+        throw new Error(`[Totem Error] Failed to fetch open issues: ${msg}`);
+    }
+}
+async function retrieveContext(query, store) {
+    const search = (typeFilter, maxResults) => store.search({ query, typeFilter, maxResults });
+    const [specs, sessions] = await Promise.all([
+        search('spec', MAX_SPEC_RESULTS),
+        search('session_log', MAX_SESSION_RESULTS),
+    ]);
+    return { specs, sessions };
+}
+function buildSearchQuery(issues) {
+    const titles = issues.map((i) => i.title).join(' ');
+    const labels = [...new Set(issues.flatMap((i) => i.labels.map((l) => l.name)))].join(' ');
+    return `${titles} ${labels}`.slice(0, QUERY_TITLES_TRUNCATE).trim();
+}
+// ─── Prompt assembly ────────────────────────────────────
+function formatIssueInventory(issues) {
+    const rows = issues.map((i) => {
+        const labels = i.labels.map((l) => l.name).join(', ') || '(none)';
+        const updated = i.updatedAt.slice(0, 10); // YYYY-MM-DD
+        return `| #${i.number} | ${i.title} | ${labels} | ${updated} |`;
+    });
+    return ['| Issue | Title | Labels | Updated |', '|---|---|---|---|', ...rows].join('\n');
+}
+function assemblePrompt(issues, context) {
+    const sections = [SYSTEM_PROMPT];
+    // Issue inventory
+    sections.push('=== OPEN ISSUES ===');
+    sections.push(`Total: ${issues.length} open issues\n`);
+    sections.push(formatIssueInventory(issues));
+    // Totem knowledge
+    const specSection = formatResults(context.specs, 'RECENT SPECS & ADRs');
+    const sessionSection = formatResults(context.sessions, 'RECENT SESSION HISTORY');
+    if (specSection || sessionSection) {
+        sections.push('\n=== TOTEM KNOWLEDGE ===');
+        if (specSection)
+            sections.push(specSection);
+        if (sessionSection)
+            sections.push(sessionSection);
+    }
+    return sections.join('\n');
+}
+export async function triageCommand(options) {
+    const cwd = process.cwd();
+    const configPath = resolveConfigPath(cwd);
+    loadEnv(cwd);
+    const config = await loadConfig(configPath);
+    // Fetch open issues
+    console.error(`[${TAG}] Fetching open issues...`);
+    const issues = fetchOpenIssues(cwd);
+    if (issues.length === 0) {
+        console.error(`[${TAG}] No open issues found. Nothing to triage.`);
+        return;
+    }
+    console.error(`[${TAG}] Found ${issues.length} open issues.`);
+    // Connect to LanceDB
+    const embedder = createEmbedder(config.embedding);
+    const store = new LanceStore(path.join(cwd, config.lanceDir), embedder);
+    await store.connect();
+    // Retrieve context from LanceDB
+    const query = buildSearchQuery(issues);
+    console.error(`[${TAG}] Querying Totem index...`);
+    const context = await retrieveContext(query, store);
+    const totalResults = context.specs.length + context.sessions.length;
+    console.error(`[${TAG}] Found: ${context.specs.length} specs, ${context.sessions.length} sessions`);
+    // Assemble prompt
+    const prompt = assemblePrompt(issues, context);
+    console.error(`[${TAG}] Prompt: ${(prompt.length / 1024).toFixed(0)}KB`);
+    const content = runOrchestrator({ prompt, tag: TAG, options, config, cwd, totalResults });
+    if (content != null) {
+        writeOutput(content, options.out);
+        if (options.out)
+            console.error(`[${TAG}] Written to ${options.out}`);
+    }
+}
+//# sourceMappingURL=triage.js.map

package/dist/commands/triage.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,12 @@
+export declare function getGitBranch(cwd: string): string;
+export declare function getGitStatus(cwd: string): string;
+export declare function getGitDiff(mode: 'staged' | 'all', cwd: string): string;
+export declare function getGitDiffStat(cwd: string): string;
+/**
+ * Detect the default branch of the remote (e.g. main, master).
+ * Falls back to 'main' if detection fails.
+ */
+export declare function getDefaultBranch(cwd: string): string;
+export declare function getGitBranchDiff(cwd: string, base?: string): string;
+export declare function extractChangedFiles(diff: string): string[];
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAmBA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CActE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWlD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA+BpD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAcnE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS1D"}