@goondocks/myco 0.1.0

package/dist/src/capture/prompts.js

@@ -0,0 +1,255 @@
+/**
+ * Prompt template system for activity observation extraction.
+ *
+ * Templates are loaded from markdown files with YAML frontmatter.
+ * Schema is loaded from schema.yaml as the single source of truth
+ * for observation types and activity classifications.
+ *
+ * Ported from open-agent-kit's Python implementation.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import matter from 'gray-matter';
+import YAML from 'yaml';
+// ── Paths ─────────────────────────────────────────────────────
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DEFAULT_PROMPTS_DIR = path.join(__dirname, 'prompts');
+const DEFAULT_SCHEMA_PATH = path.join(DEFAULT_PROMPTS_DIR, 'schema.yaml');
+// ── Schema loader ─────────────────────────────────────────────
+function getDefaultSchema() {
+    return {
+        version: '1.0',
+        observationTypes: [
+            { name: 'gotcha', description: 'Non-obvious behaviors or edge cases', examples: [] },
+            { name: 'bug_fix', description: 'Bugs identified and fixed', examples: [] },
+            { name: 'decision', description: 'Architecture or design decisions', examples: [] },
+            { name: 'discovery', description: 'Facts learned about the codebase', examples: [] },
+            { name: 'trade_off', description: 'Trade-offs considered and evaluated', examples: [] },
+        ],
+        classificationTypes: [
+            { name: 'exploration', description: 'Reading and understanding code', indicators: [] },
+            { name: 'debugging', description: 'Investigating errors', indicators: [] },
+            { name: 'implementation', description: 'Writing new code', indicators: [] },
+            { name: 'refactoring', description: 'Modifying code structure', indicators: [] },
+        ],
+    };
+}
+export function loadSchema(schemaPath) {
+    const p = schemaPath ?? DEFAULT_SCHEMA_PATH;
+    if (!fs.existsSync(p)) {
+        return getDefaultSchema();
+    }
+    try {
+        const raw = fs.readFileSync(p, 'utf-8');
+        const data = YAML.parse(raw);
+        const observationTypes = [];
+        const obsRaw = (data.observation_types ?? {});
+        for (const [name, def] of Object.entries(obsRaw)) {
+            observationTypes.push({
+                name,
+                description: String(def.description ?? ''),
+                examples: def.examples ?? [],
+            });
+        }
+        const classificationTypes = [];
+        const classRaw = (data.activity_classifications ?? {});
+        for (const [name, def] of Object.entries(classRaw)) {
+            classificationTypes.push({
+                name,
+                description: String(def.description ?? ''),
+                indicators: def.indicators ?? [],
+            });
+        }
+        return {
+            version: String(data.version ?? '1.0'),
+            observationTypes,
+            classificationTypes,
+        };
+    }
+    catch {
+        return getDefaultSchema();
+    }
+}
+// ── Schema formatting helpers ─────────────────────────────────
+export function formatObservationTypes(schema) {
+    const lines = [];
+    for (const t of schema.observationTypes) {
+        lines.push(`- **${t.name}**: ${t.description}`);
+        for (const ex of t.examples.slice(0, 2)) {
+            lines.push(`  - Example: "${ex}"`);
+        }
+    }
+    return lines.join('\n');
+}
+export function formatClassificationTypes(schema) {
+    return schema.classificationTypes
+        .map((t) => `- **${t.name}**: ${t.description}`)
+        .join('\n');
+}
+export function getTypeNamesString(schema) {
+    return schema.observationTypes.map((t) => t.name).join('|');
+}
+// ── Template loader ───────────────────────────────────────────
+export function loadTemplate(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const { data, content } = matter(raw);
+        if (!data.name)
+            return null;
+        const filter = data.activity_filter
+            ? String(data.activity_filter).split(',').map((s) => s.trim())
+            : undefined;
+        return {
+            name: String(data.name),
+            description: String(data.description ?? ''),
+            prompt: content.trim(),
+            activityFilter: filter,
+            minActivities: Number(data.min_activities ?? 1),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function loadAllTemplates(promptsDir) {
+    const dir = promptsDir ?? DEFAULT_PROMPTS_DIR;
+    const templates = new Map();
+    if (!fs.existsSync(dir))
+        return templates;
+    for (const file of fs.readdirSync(dir)) {
+        if (!file.endsWith('.md'))
+            continue;
+        const template = loadTemplate(path.join(dir, file));
+        if (template) {
+            templates.set(template.name, template);
+        }
+    }
+    return templates;
+}
+// ── Template selector ─────────────────────────────────────────
+export function selectTemplate(templates, toolNames, hasErrors) {
+    // Prefer debugging template if errors present
+    if (hasErrors && templates.has('debugging')) {
+        return templates.get('debugging');
+    }
+    // Check for implementation pattern (writes/edits > 30%)
+    const editCount = toolNames.filter((t) => t === 'Write' || t === 'Edit').length;
+    if (editCount > toolNames.length * 0.3 && templates.has('implementation')) {
+        return templates.get('implementation');
+    }
+    // Check for exploration pattern (reads/searches > 50%)
+    const exploreCount = toolNames.filter((t) => t === 'Read' || t === 'Grep' || t === 'Glob').length;
+    if (exploreCount > toolNames.length * 0.5 && templates.has('exploration')) {
+        return templates.get('exploration');
+    }
+    // Fall back to extraction (general purpose)
+    return templates.get('extraction') ?? templates.values().next().value;
+}
+export function classifySessionOrigin(toolNames) {
+    if (toolNames.length === 0)
+        return 'mixed';
+    const reads = toolNames.filter((t) => t === 'Read' || t === 'Grep' || t === 'Glob').length;
+    const edits = toolNames.filter((t) => t === 'Write' || t === 'Edit').length;
+    const total = toolNames.length;
+    const readRatio = reads / total;
+    const editRatio = edits / total;
+    if (editRatio > 0.3)
+        return 'implementation';
+    if (readRatio > 0.7 && editRatio < 0.05)
+        return 'planning';
+    if (readRatio > 0.5 && editRatio < 0.15)
+        return 'investigation';
+    return 'mixed';
+}
+// ── Prompt renderer ───────────────────────────────────────────
+export function renderPrompt(template, context) {
+    let prompt = template.prompt;
+    for (const [key, value] of Object.entries(context)) {
+        if (value !== undefined) {
+            prompt = prompt.replaceAll(`{{${key}}}`, String(value));
+        }
+    }
+    return prompt;
+}
+export function formatActivities(events, maxItems = 30) {
+    const lines = [];
+    const toShow = events.slice(0, maxItems);
+    for (let i = 0; i < toShow.length; i++) {
+        const evt = toShow[i];
+        const tool = evt.tool_name ?? evt.tool ?? 'Unknown';
+        const filePath = evt.input?.file_path ?? evt.input?.path ?? '';
+        const summary = evt.output ? String(evt.output).slice(0, 150) : '';
+        let line = `${i + 1}. **${tool}**`;
+        if (filePath)
+            line += ` - \`${filePath}\``;
+        if (summary)
+            line += `\n   ${summary}`;
+        lines.push(line);
+    }
+    if (events.length > maxItems) {
+        lines.push(`\n... and ${events.length - maxItems} more activities`);
+    }
+    return lines.length > 0 ? lines.join('\n') : '(no activities)';
+}
+export function extractFilesList(events, toolFilter) {
+    const files = new Set();
+    for (const evt of events) {
+        const tool = evt.tool_name ?? evt.tool ?? '';
+        if (toolFilter.length > 0 && !toolFilter.includes(tool))
+            continue;
+        const fp = evt.input?.file_path ?? evt.input?.path;
+        if (fp)
+            files.add(String(fp));
+    }
+    return [...files];
+}
+export function extractErrors(events) {
+    const errors = [];
+    for (const evt of events) {
+        if (evt.error)
+            errors.push(evt.error);
+    }
+    return errors;
+}
+export function extractToolNames(events) {
+    return events.map((e) => e.tool_name ?? e.tool ?? 'Unknown');
+}
+// ── High-level: build extraction context ──────────────────────
+export function buildExtractionContext(events, sessionDuration, schema) {
+    const toolNames = extractToolNames(events);
+    const filesRead = extractFilesList(events, ['Read', 'Grep', 'Glob']);
+    const filesModified = extractFilesList(events, ['Edit']);
+    const filesCreated = extractFilesList(events, ['Write']);
+    const errors = extractErrors(events);
+    return {
+        activities: formatActivities(events),
+        session_duration: sessionDuration.toFixed(1),
+        files_read: filesRead.slice(0, 20).join(', ') || '(none)',
+        files_modified: filesModified.slice(0, 20).join(', ') || '(none)',
+        files_created: filesCreated.slice(0, 20).join(', ') || '(none)',
+        errors: errors.length > 0 ? errors.slice(0, 10).map((e) => `- ${e}`).join('\n') : '(none)',
+        observation_types: formatObservationTypes(schema),
+        classification_types: formatClassificationTypes(schema),
+        type_names: getTypeNamesString(schema),
+        // Counts for summary/classify templates
+        files_read_count: String(filesRead.length),
+        files_modified_count: String(filesModified.length),
+        files_created_count: String(filesCreated.length),
+        tool_calls: String(events.length),
+        tool_summary: summarizeToolUsage(toolNames),
+        has_errors: errors.length > 0 ? 'yes' : 'no',
+        session_origin_type: classifySessionOrigin(toolNames),
+    };
+}
+function summarizeToolUsage(toolNames) {
+    const counts = new Map();
+    for (const t of toolNames) {
+        counts.set(t, (counts.get(t) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .map(([tool, count]) => `${tool}: ${count}`)
+        .join(', ');
+}
+//# sourceMappingURL=prompts.js.map

package/dist/src/capture/prompts.js.map

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

package/dist/src/capture/transcript-miner.d.ts

@@ -0,0 +1,31 @@
+import type { AgentAdapter } from '../agents/adapter.js';
+export type { TranscriptTurn } from '../agents/adapter.js';
+import type { TranscriptTurn } from '../agents/adapter.js';
+interface TranscriptConfig {
+    /** Additional agent adapters to register (useful for testing or custom agents) */
+    additionalAdapters?: AgentAdapter[];
+}
+export declare class TranscriptMiner {
+    private registry;
+    constructor(config?: TranscriptConfig);
+    /**
+     * Extract all conversation turns for a session.
+     * Convenience wrapper — delegates to getAllTurnsWithSource.
+     */
+    getAllTurns(sessionId: string): TranscriptTurn[];
+    /**
+     * Extract turns using the hook-provided transcript path first (fast, no scanning),
+     * then fall back to adapter registry scanning if the path isn't provided.
+     */
+    getAllTurnsWithSource(sessionId: string, transcriptPath?: string): {
+        turns: TranscriptTurn[];
+        source: string;
+    };
+}
+/**
+ * Build turns from buffer events — the fallback when no agent transcript is available.
+ * Buffer events come from hooks (user_prompt, tool_use) and lack AI responses.
+ * Turns will have prompts and tool counts but no aiResponse.
+ */
+export declare function extractTurnsFromBuffer(events: Array<Record<string, unknown>>): TranscriptTurn[];
+//# sourceMappingURL=transcript-miner.d.ts.map

package/dist/src/capture/transcript-miner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-miner.d.ts","sourceRoot":"","sources":["../../../src/capture/transcript-miner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,UAAU,gBAAgB;IACxB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,YAAY,EAAE,CAAC;CACrC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,CAAC,EAAE,gBAAgB;IAIrC;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAIhD;;;OAGG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAY/G;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc,EAAE,CAmB/F"}

package/dist/src/capture/transcript-miner.js

@@ -0,0 +1,61 @@
+import { AgentRegistry } from '../agents/registry.js';
+import { PROMPT_PREVIEW_CHARS } from '../constants.js';
+export class TranscriptMiner {
+    registry;
+    constructor(config) {
+        this.registry = new AgentRegistry(config?.additionalAdapters);
+    }
+    /**
+     * Extract all conversation turns for a session.
+     * Convenience wrapper — delegates to getAllTurnsWithSource.
+     */
+    getAllTurns(sessionId) {
+        return this.getAllTurnsWithSource(sessionId).turns;
+    }
+    /**
+     * Extract turns using the hook-provided transcript path first (fast, no scanning),
+     * then fall back to adapter registry scanning if the path isn't provided.
+     */
+    getAllTurnsWithSource(sessionId, transcriptPath) {
+        // Primary: use the path provided by the hook (no directory scanning needed)
+        if (transcriptPath) {
+            const result = this.registry.parseTurnsFromPath(transcriptPath);
+            if (result)
+                return result;
+        }
+        // Fallback: scan known agent directories
+        const result = this.registry.getTranscriptTurns(sessionId);
+        if (result)
+            return result;
+        return { turns: [], source: 'none' };
+    }
+}
+/**
+ * Build turns from buffer events — the fallback when no agent transcript is available.
+ * Buffer events come from hooks (user_prompt, tool_use) and lack AI responses.
+ * Turns will have prompts and tool counts but no aiResponse.
+ */
+export function extractTurnsFromBuffer(events) {
+    const turns = [];
+    let current = null;
+    for (const event of events) {
+        const type = event.type;
+        if (type === 'user_prompt') {
+            if (current)
+                turns.push(current);
+            current = {
+                prompt: String(event.prompt ?? '').slice(0, PROMPT_PREVIEW_CHARS),
+                toolCount: 0,
+                timestamp: String(event.timestamp ?? new Date().toISOString()),
+            };
+        }
+        else if (type === 'tool_use') {
+            if (current)
+                current.toolCount++;
+        }
+    }
+    if (current)
+        turns.push(current);
+    return turns;
+}
+//# sourceMappingURL=transcript-miner.js.map

package/dist/src/capture/transcript-miner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-miner.js","sourceRoot":"","sources":["../../../src/capture/transcript-miner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAYvD,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAgB;IAEhC,YAAY,MAAyB;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,qBAAqB,CAAC,SAAiB,EAAE,cAAuB;QAC9D,4EAA4E;QAC5E,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;YAChE,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QAED,yCAAyC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAsC;IAC3E,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,IAAI,OAAO,GAA0B,IAAI,CAAC;IAE1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAc,CAAC;QAClC,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAC3B,IAAI,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO,GAAG;gBACR,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC;gBACjE,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;aAC/D,CAAC;QACJ,CAAC;aAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,IAAI,OAAO;gBAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IACD,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}