@goondocks/myco 0.1.0

package/dist/src/agents/registry.js

@@ -0,0 +1,95 @@
+import { claudeCodeAdapter } from './claude-code.js';
+import { cursorAdapter } from './cursor.js';
+import fs from 'node:fs';
+/**
+ * All known agent adapters, ordered by priority.
+ * When searching for a transcript, adapters are tried in order.
+ * Add new adapters here as agent support grows.
+ */
+const ALL_ADAPTERS = [
+    claudeCodeAdapter,
+    cursorAdapter,
+];
+export class AgentRegistry {
+    adapters;
+    constructor(additionalAdapters = []) {
+        this.adapters = [...ALL_ADAPTERS, ...additionalAdapters];
+    }
+    /**
+     * Find and parse transcript turns for a session.
+     * Tries each adapter in priority order. Returns the first match.
+     */
+    getTranscriptTurns(sessionId) {
+        for (const adapter of this.adapters) {
+            const filePath = adapter.findTranscript(sessionId);
+            if (!filePath)
+                continue;
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const turns = adapter.parseTurns(content);
+                if (turns.length > 0) {
+                    return { turns, source: adapter.name };
+                }
+            }
+            catch {
+                // Adapter found a path but read/parse failed — try next
+            }
+        }
+        return null;
+    }
+    /** List all registered adapter names */
+    get adapterNames() {
+        return this.adapters.map((a) => a.name);
+    }
+    /** Get a specific adapter by name */
+    getAdapter(name) {
+        return this.adapters.find((a) => a.name === name);
+    }
+    /** Detect which agent is currently active based on environment variables */
+    detectActiveAgent() {
+        for (const adapter of this.adapters) {
+            if (process.env[adapter.pluginRootEnvVar]) {
+                return adapter;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Parse turns from a known transcript file path (provided by hook).
+     * Tries each adapter's parseTurns until one produces results.
+     * Skips directory scanning entirely — the path is already known.
+     */
+    parseTurnsFromPath(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            // Try the active agent's parser first, then fall back to others
+            const active = this.detectActiveAgent();
+            const orderedAdapters = active
+                ? [active, ...this.adapters.filter((a) => a !== active)]
+                : this.adapters;
+            for (const adapter of orderedAdapters) {
+                const turns = adapter.parseTurns(content);
+                if (turns.length > 0) {
+                    return { turns, source: `${adapter.name}:direct` };
+                }
+            }
+        }
+        catch {
+            // File unreadable — caller will fall back to directory scanning
+        }
+        return null;
+    }
+    /**
+     * Resolve the plugin root directory from the active agent's environment variable.
+     * Returns undefined if no agent env var is set (e.g., running from CLI directly).
+     */
+    resolvePluginRoot() {
+        for (const adapter of this.adapters) {
+            const value = process.env[adapter.pluginRootEnvVar];
+            if (value)
+                return value;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/agents/registry.js.map

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

package/dist/src/artifacts/candidates.d.ts

@@ -0,0 +1,20 @@
+export interface ArtifactCandidate {
+    path: string;
+    content: string;
+}
+/**
+ * Returns true if a relative path belongs to plugin/agent infrastructure
+ * that should never be captured as a project artifact.
+ */
+export declare function isExcludedPath(relativePath: string): boolean;
+/**
+ * Filters a set of written/edited file paths by extension, gitignore,
+ * and infrastructure exclusions, then reads final content from disk.
+ *
+ * Uses execFileSync (not exec) for git check-ignore — arguments are passed
+ * as an array, so no shell injection risk.
+ */
+export declare function collectArtifactCandidates(filePaths: Set<string>, config: {
+    artifact_extensions: string[];
+}, projectRoot: string): ArtifactCandidate[];
+//# sourceMappingURL=candidates.d.ts.map

package/dist/src/artifacts/candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../../src/artifacts/candidates.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAyBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAM5D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,MAAM,EAAE;IAAE,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAAE,EACzC,WAAW,EAAE,MAAM,GAClB,iBAAiB,EAAE,CAgCrB"}

package/dist/src/artifacts/candidates.js

@@ -0,0 +1,84 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+/** Filenames (case-insensitive) that are agent/plugin infrastructure, not project artifacts. */
+const EXCLUDED_FILENAMES = new Set([
+    'claude.md',
+    'agents.md',
+    'gemini.md',
+    'readme.md',
+    'contributing.md',
+    'changelog.md',
+    'license.md',
+    'pull_request_template.md',
+]);
+/** Directory prefixes (relative to project root) that contain plugin/agent components or repo infrastructure. */
+const EXCLUDED_PREFIXES = [
+    'commands/',
+    'skills/',
+    'hooks/',
+    '.claude-plugin/',
+    '.cursor-plugin/',
+    '.claude/',
+    '.github/',
+];
+/**
+ * Returns true if a relative path belongs to plugin/agent infrastructure
+ * that should never be captured as a project artifact.
+ */
+export function isExcludedPath(relativePath) {
+    const basename = path.basename(relativePath).toLowerCase();
+    if (EXCLUDED_FILENAMES.has(basename))
+        return true;
+    const normalized = relativePath.replace(/\\/g, '/');
+    return EXCLUDED_PREFIXES.some((prefix) => normalized.startsWith(prefix));
+}
+/**
+ * Filters a set of written/edited file paths by extension, gitignore,
+ * and infrastructure exclusions, then reads final content from disk.
+ *
+ * Uses execFileSync (not exec) for git check-ignore — arguments are passed
+ * as an array, so no shell injection risk.
+ */
+export function collectArtifactCandidates(filePaths, config, projectRoot) {
+    if (filePaths.size === 0)
+        return [];
+    // Filter by extension first (cheap)
+    const extFiltered = [...filePaths].filter((absPath) => config.artifact_extensions.includes(path.extname(absPath)));
+    if (extFiltered.length === 0)
+        return [];
+    // Batch git check-ignore: one subprocess instead of N
+    const ignoredSet = getGitIgnored(extFiltered, projectRoot);
+    const candidates = [];
+    for (const absPath of extFiltered) {
+        if (ignoredSet.has(absPath))
+            continue;
+        try {
+            const content = fs.readFileSync(absPath, 'utf-8');
+            const relativePath = path.relative(projectRoot, absPath);
+            // Skip plugin/agent infrastructure files
+            if (isExcludedPath(relativePath))
+                continue;
+            candidates.push({ path: relativePath, content });
+        }
+        catch {
+            // File was deleted between event capture and now — skip
+        }
+    }
+    return candidates;
+}
+function getGitIgnored(filePaths, cwd) {
+    try {
+        const result = execFileSync('git', ['check-ignore', ...filePaths], {
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            encoding: 'utf-8',
+        });
+        return new Set(result.trim().split('\n').filter(Boolean));
+    }
+    catch {
+        // exit 1 = none are ignored (or git not available)
+        return new Set();
+    }
+}
+//# sourceMappingURL=candidates.js.map

package/dist/src/artifacts/candidates.js.map

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

package/dist/src/artifacts/slugify.d.ts

@@ -0,0 +1,2 @@
+export declare function slugifyPath(relativePath: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/src/artifacts/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../../src/artifacts/slugify.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAoBxD"}

package/dist/src/artifacts/slugify.js

@@ -0,0 +1,22 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import { MAX_SLUG_LENGTH } from '../constants.js';
+export function slugifyPath(relativePath) {
+    const ext = path.extname(relativePath);
+    const withoutExt = ext ? relativePath.slice(0, -ext.length) : relativePath;
+    let slug = withoutExt
+        .replace(/[/\\]/g, '-')
+        .toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9-]/g, '');
+    if (slug.length > MAX_SLUG_LENGTH) {
+        const hash = crypto
+            .createHash('sha256')
+            .update(relativePath)
+            .digest('hex')
+            .slice(0, 6);
+        slug = slug.slice(0, MAX_SLUG_LENGTH) + '-' + hash;
+    }
+    return slug;
+}
+//# sourceMappingURL=slugify.js.map

package/dist/src/artifacts/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../../src/artifacts/slugify.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,UAAU,WAAW,CAAC,YAAoB;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAE3E,IAAI,IAAI,GAAG,UAAU;SAClB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAE9B,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM;aAChB,UAAU,CAAC,QAAQ,CAAC;aACpB,MAAM,CAAC,YAAY,CAAC;aACpB,MAAM,CAAC,KAAK,CAAC;aACb,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACf,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;IACrD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/capture/artifact-watcher.d.ts

@@ -0,0 +1,19 @@
+export interface ArtifactEvent {
+    type: 'add' | 'change';
+    path: string;
+    absolutePath: string;
+}
+type ArtifactHandler = (event: ArtifactEvent) => void;
+export declare class ArtifactWatcher {
+    private projectRoot;
+    private watchPaths;
+    private watcher;
+    private handlers;
+    constructor(projectRoot: string, watchPaths: string[]);
+    onArtifact(handler: ArtifactHandler): void;
+    start(): void;
+    stop(): void;
+    private emit;
+}
+export {};
+//# sourceMappingURL=artifact-watcher.d.ts.map

package/dist/src/capture/artifact-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-watcher.d.ts","sourceRoot":"","sources":["../../../src/capture/artifact-watcher.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAEtD,qBAAa,eAAe;IAKxB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,UAAU;IALpB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAyB;gBAG/B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAAE;IAG9B,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1C,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,IAAI;CAOb"}

package/dist/src/capture/artifact-watcher.js

@@ -0,0 +1,37 @@
+import { watch } from 'chokidar';
+import path from 'node:path';
+export class ArtifactWatcher {
+    projectRoot;
+    watchPaths;
+    watcher = null;
+    handlers = [];
+    constructor(projectRoot, watchPaths) {
+        this.projectRoot = projectRoot;
+        this.watchPaths = watchPaths;
+    }
+    onArtifact(handler) {
+        this.handlers.push(handler);
+    }
+    start() {
+        const absolutePaths = this.watchPaths.map((p) => path.resolve(this.projectRoot, p));
+        this.watcher = watch(absolutePaths, {
+            ignoreInitial: true,
+            persistent: false,
+            depth: 3,
+        });
+        this.watcher.on('add', (filePath) => this.emit('add', filePath));
+        this.watcher.on('change', (filePath) => this.emit('change', filePath));
+    }
+    stop() {
+        this.watcher?.close();
+        this.watcher = null;
+    }
+    emit(type, absolutePath) {
+        const relativePath = path.relative(this.projectRoot, absolutePath);
+        const event = { type, path: relativePath, absolutePath };
+        for (const handler of this.handlers) {
+            handler(event);
+        }
+    }
+}
+//# sourceMappingURL=artifact-watcher.js.map

package/dist/src/capture/artifact-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-watcher.js","sourceRoot":"","sources":["../../../src/capture/artifact-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,MAAM,OAAO,eAAe;IAKhB;IACA;IALF,OAAO,GAAqB,IAAI,CAAC;IACjC,QAAQ,GAAsB,EAAE,CAAC;IAEzC,YACU,WAAmB,EACnB,UAAoB;QADpB,gBAAW,GAAX,WAAW,CAAQ;QACnB,eAAU,GAAV,UAAU,CAAU;IAC3B,CAAC;IAEJ,UAAU,CAAC,OAAwB;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAClC,CAAC;QAEF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,aAAa,EAAE;YAClC,aAAa,EAAE,IAAI;YACnB,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAEO,IAAI,CAAC,IAAsB,EAAE,YAAoB;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACnE,MAAM,KAAK,GAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;QACxE,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;CACF"}

package/dist/src/capture/buffer.d.ts

@@ -0,0 +1,20 @@
+interface BufferOptions {
+    maxEvents?: number;
+}
+export declare class EventBuffer {
+    private bufferDir;
+    private sessionId;
+    private filePath;
+    private maxEvents;
+    private eventCount;
+    constructor(bufferDir: string, sessionId: string, options?: BufferOptions);
+    append(event: Record<string, unknown>): void;
+    readAll(): Array<Record<string, unknown>>;
+    count(): number;
+    exists(): boolean;
+    delete(): void;
+    isOverflow(): boolean;
+    getFilePath(): string;
+}
+export {};
+//# sourceMappingURL=buffer.d.ts.map

package/dist/src/capture/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../../src/capture/buffer.ts"],"names":[],"mappings":"AAGA,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,WAAW;IAMpB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,SAAS;IANnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAK;gBAGb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACzB,OAAO,GAAE,aAAkB;IAW7B,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAY5C,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOzC,KAAK,IAAI,MAAM;IAIf,MAAM,IAAI,OAAO;IAIjB,MAAM,IAAI,IAAI;IAOd,UAAU,IAAI,OAAO;IAIrB,WAAW,IAAI,MAAM;CAGtB"}

package/dist/src/capture/buffer.js

@@ -0,0 +1,55 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export class EventBuffer {
+    bufferDir;
+    sessionId;
+    filePath;
+    maxEvents;
+    eventCount = 0;
+    constructor(bufferDir, sessionId, options = {}) {
+        this.bufferDir = bufferDir;
+        this.sessionId = sessionId;
+        this.filePath = path.join(bufferDir, `${sessionId}.jsonl`);
+        this.maxEvents = options.maxEvents ?? 500;
+        if (fs.existsSync(this.filePath)) {
+            const content = fs.readFileSync(this.filePath, 'utf-8').trim();
+            this.eventCount = content ? content.split('\n').length : 0;
+        }
+    }
+    append(event) {
+        fs.mkdirSync(this.bufferDir, { recursive: true });
+        const line = JSON.stringify({
+            ...event,
+            timestamp: event.timestamp ?? new Date().toISOString(),
+        });
+        fs.appendFileSync(this.filePath, line + '\n');
+        this.eventCount++;
+    }
+    readAll() {
+        if (!fs.existsSync(this.filePath))
+            return [];
+        const content = fs.readFileSync(this.filePath, 'utf-8').trim();
+        if (!content)
+            return [];
+        return content.split('\n').map((line) => JSON.parse(line));
+    }
+    count() {
+        return this.eventCount;
+    }
+    exists() {
+        return fs.existsSync(this.filePath);
+    }
+    delete() {
+        if (fs.existsSync(this.filePath)) {
+            fs.unlinkSync(this.filePath);
+        }
+        this.eventCount = 0;
+    }
+    isOverflow() {
+        return this.eventCount > this.maxEvents;
+    }
+    getFilePath() {
+        return this.filePath;
+    }
+}
+//# sourceMappingURL=buffer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../../../src/capture/buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,MAAM,OAAO,WAAW;IAMZ;IACA;IANF,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,UAAU,GAAG,CAAC,CAAC;IAEvB,YACU,SAAiB,EACjB,SAAiB,EACzB,UAAyB,EAAE;QAFnB,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAQ;QAGzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;QAE1C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/D,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAA8B;QACnC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvD,CAAC,CAAC;QAEH,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/D,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,MAAM;QACJ,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;IAC1C,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/src/capture/plan-detector.d.ts

@@ -0,0 +1,15 @@
+export interface PlanSignal {
+    source: 'hook' | 'artifact' | 'content' | 'transcript';
+    confidence: 'high' | 'medium' | 'low';
+    detail: string;
+}
+interface DetectionInput {
+    hookEvents?: Array<Record<string, unknown>>;
+    newFiles?: string[];
+    sessionContent?: string;
+}
+export declare class PlanDetector {
+    detect(input: DetectionInput): PlanSignal[];
+}
+export {};
+//# sourceMappingURL=plan-detector.d.ts.map

package/dist/src/capture/plan-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-detector.d.ts","sourceRoot":"","sources":["../../../src/capture/plan-detector.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;IACvD,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD,qBAAa,YAAY;IACvB,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,EAAE;CA6B5C"}

package/dist/src/capture/plan-detector.js

@@ -0,0 +1,34 @@
+const PLAN_DIRECTORIES = [
+    'docs/superpowers/specs/',
+    '.claude/plans/',
+    '.cursor/plans/',
+];
+export class PlanDetector {
+    detect(input) {
+        const signals = [];
+        if (input.hookEvents) {
+            for (const event of input.hookEvents) {
+                if (event.type === 'EnterPlanMode' || event.type === 'ExitPlanMode') {
+                    signals.push({
+                        source: 'hook',
+                        confidence: 'high',
+                        detail: `Plan mode ${event.type === 'EnterPlanMode' ? 'entered' : 'exited'}`,
+                    });
+                }
+            }
+        }
+        if (input.newFiles) {
+            for (const file of input.newFiles) {
+                if (PLAN_DIRECTORIES.some((dir) => file.startsWith(dir))) {
+                    signals.push({
+                        source: 'artifact',
+                        confidence: 'medium',
+                        detail: `New file in plan directory: ${file}`,
+                    });
+                }
+            }
+        }
+        return signals;
+    }
+}
+//# sourceMappingURL=plan-detector.js.map

package/dist/src/capture/plan-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-detector.js","sourceRoot":"","sources":["../../../src/capture/plan-detector.ts"],"names":[],"mappings":"AAYA,MAAM,gBAAgB,GAAG;IACvB,yBAAyB;IACzB,gBAAgB;IAChB,gBAAgB;CACjB,CAAC;AAEF,MAAM,OAAO,YAAY;IACvB,MAAM,CAAC,KAAqB;QAC1B,MAAM,OAAO,GAAiB,EAAE,CAAC;QAEjC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBACpE,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,MAAM;wBACd,UAAU,EAAE,MAAM;wBAClB,MAAM,EAAE,aAAa,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;qBAC7E,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAClC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBACzD,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,UAAU;wBAClB,UAAU,EAAE,QAAQ;wBACpB,MAAM,EAAE,+BAA+B,IAAI,EAAE;qBAC9C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/src/capture/processor.d.ts

@@ -0,0 +1,2 @@
+export { BufferProcessor, type Observation, type ProcessorResult } from '../daemon/processor.js';
+//# sourceMappingURL=processor.d.ts.map

package/dist/src/capture/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../../src/capture/processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/capture/processor.js

@@ -0,0 +1,3 @@
+// Re-export from canonical location to avoid duplication
+export { BufferProcessor } from '../daemon/processor.js';
+//# sourceMappingURL=processor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processor.js","sourceRoot":"","sources":["../../../src/capture/processor.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,EAAE,eAAe,EAA0C,MAAM,wBAAwB,CAAC"}

package/dist/src/capture/prompts/classify.md

@@ -0,0 +1,28 @@
+---
+name: classify
+description: Classify activity type for a single user request
+---
+
+Classify the type of work done in response to a single user request.
+
+## Activity Summary
+
+- Duration: {{session_duration}} minutes
+- Tools used: {{tool_summary}}
+- Files read: {{files_read_count}}
+- Files modified: {{files_modified_count}}
+- Files created: {{files_created_count}}
+- Errors encountered: {{has_errors}}
+
+## Activity Log
+
+{{activities}}
+
+## Classification Types
+
+{{classification_types}}
+
+## Task
+
+Based on the activities above, determine what the agent was primarily doing.
+Respond with ONLY the classification word (e.g., exploration, debugging, implementation, refactoring), nothing else.

package/dist/src/capture/prompts/debugging.md

@@ -0,0 +1,91 @@
+---
+name: debugging
+description: For debugging sessions with errors
+activity_filter: Read,Edit,Bash
+min_activities: 2
+---
+
+You are analyzing a debugging session to capture the root cause and fix.
+
+## Context
+
+The developer was debugging an issue.
+
+Duration: {{session_duration}} minutes
+Files investigated: {{files_read}}
+Files modified: {{files_modified}}
+Errors: {{errors}}
+
+### Debugging Activity
+
+{{activities}}
+
+## Observation Types
+
+{{observation_types}}
+
+## Importance Levels
+
+Rate each observation's importance based on its value for future sessions:
+
+- **high**: Non-obvious insight that would cause bugs, confusion, or wasted time if forgotten. Cannot be easily rediscovered from code alone.
+- **medium**: Useful context that saves time but could be rediscovered with investigation.
+- **low**: Nice-to-know information that is easily found from code or already documented elsewhere. Skip if already captured in project docs.
+
+Prefer fewer high-quality observations over many low-importance ones.
+
+## Task
+
+Extract the debugging journey: what was the symptom, what was investigated, what was the root cause, and how was it fixed.
+
+Focus on:
+- The initial error or symptom
+- Wrong assumptions or dead ends
+- The actual root cause
+- The fix and why it works
+- How to avoid this in the future
+
+Prefer **bug_fix** and **gotcha** types for debugging sessions.
+
+## Examples
+
+**Good observation** (specific root cause and fix — extract this):
+```json
+{
+  "type": "bug_fix",
+  "observation": "SQLite LIMIT clause was string-interpolated, allowing SQL injection. Fix: use parameterized query with LIMIT ? and push value to params array.",
+  "context": "src/index/sqlite.ts",
+  "importance": "high"
+}
+```
+
+**Bad observation** (too vague — skip this):
+```json
+{
+  "type": "bug_fix",
+  "observation": "Fixed a database error",
+  "context": "src/index",
+  "importance": "medium"
+}
+```
+
+## Output Format
+
+```json
+{
+  "observations": [
+    {
+      "type": "{{type_names}}",
+      "observation": "Root cause and fix description",
+      "context": "File where bug was",
+      "importance": "high|medium|low"
+    }
+  ],
+  "summary": "Brief description of bug and fix"
+}
+```
+
+Guidelines:
+- Extract at most 5 observations per session. Prefer fewer, higher-quality observations over many low-value ones.
+
+Respond ONLY with valid JSON.