@taurgis/bonsai 1.0.5 → 3.0.0

package/dist/commands/research/list.d.ts

@@ -1,25 +0,0 @@
-import { BaseCommand } from '../../base-command.js';
-export default class ResearchList extends BaseCommand<typeof ResearchList> {
-    static id: string;
-    static summary: string;
-    static description: string;
-    static examples: {
-        description: string;
-        command: string;
-    }[];
-    static flags: {
-        topic: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        tags: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        freshness: import("@oclif/core/interfaces").OptionFlag<"fresh" | "stale_grace" | "stale_expired" | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'artifact-type': import("@oclif/core/interfaces").OptionFlag<"source" | "research_note" | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'capture-method': import("@oclif/core/interfaces").OptionFlag<"static_fetch" | "browser_fallback" | "agent_supplied" | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    static stdoutIsPrimaryData: boolean;
-    init(): Promise<void>;
-    private validateListFlags;
-    private matchesFilters;
-    private scanCacheDirForList;
-    private logListResults;
-    execute(): Promise<unknown>;
-}

package/dist/commands/research/list.js

@@ -1,143 +0,0 @@
-import { Flags } from '@oclif/core';
-import { BaseCommand } from '../../base-command.js';
-import { scanCacheDirs } from '../../lib/research/storage.js';
-import { loadStoreRoots } from '../../lib/research/store-roots.js';
-import { evaluateFreshness } from '../../lib/research/freshness.js';
-export default class ResearchList extends BaseCommand {
-    static id = 'research list';
-    static summary = 'List cached research artifacts by metadata filters.';
-    static description = 'Lists cached research artifacts, including metadata details like path, source count, freshness, token estimates, and quality metrics without printing full content.';
-    static examples = [
-        {
-            description: 'List all cached entries',
-            command: '<%= config.bin %> research list',
-        },
-        {
-            description: 'List cached entries for a specific topic with JSON output',
-            command: '<%= config.bin %> research list --topic "React Suspense" --json',
-        },
-        {
-            description: 'List only fresh entries filtered by tags',
-            command: '<%= config.bin %> research list --freshness fresh --tags node --tags url',
-        },
-    ];
-    static flags = {
-        topic: Flags.string({
-            char: 't',
-            description: 'Filter by exact topic (case-insensitive).',
-        }),
-        tags: Flags.string({
-            char: 'g',
-            description: 'Filter by tags (must match all tags specified).',
-            multiple: true,
-        }),
-        freshness: Flags.option({
-            description: 'Filter by freshness state.',
-            options: ['fresh', 'stale_grace', 'stale_expired'],
-        })(),
-        'artifact-type': Flags.option({
-            description: 'Filter by artifact type.',
-            options: ['source', 'research_note'],
-        })(),
-        'capture-method': Flags.option({
-            description: 'Filter by capture method.',
-            options: ['static_fetch', 'browser_fallback', 'agent_supplied'],
-        })(),
-        limit: Flags.integer({
-            description: 'Maximum number of results to return (default 50, max 100).',
-            default: 50,
-        }),
-    };
-    static stdoutIsPrimaryData = true;
-    async init() {
-        await super.init();
-        const { flags } = await this.parse(ResearchList);
-        this.flags = flags;
-    }
-    validateListFlags() {
-        const limit = this.flags.limit;
-        if (limit !== undefined && (limit < 1 || limit > 100)) {
-            this.error('Limit must be between 1 and 100.', { exit: 2 });
-        }
-    }
-    matchesFilters(meta, freshness) {
-        if (this.flags.topic &&
-            (!meta.topic || meta.topic.trim().toLowerCase() !== this.flags.topic.trim().toLowerCase())) {
-            return false;
-        }
-        if (this.flags.tags && this.flags.tags.length > 0) {
-            const metaTagsLower = (meta.tags || []).map((t) => t.toLowerCase());
-            const hasAllTags = this.flags.tags.every((t) => metaTagsLower.includes(t.toLowerCase()));
-            if (!hasAllTags) {
-                return false;
-            }
-        }
-        if (this.flags['artifact-type'] && meta.artifact_type !== this.flags['artifact-type']) {
-            return false;
-        }
-        if (this.flags['capture-method'] && meta.capture_method !== this.flags['capture-method']) {
-            return false;
-        }
-        if (this.flags.freshness && freshness !== this.flags.freshness) {
-            return false;
-        }
-        return true;
-    }
-    scanCacheDirForList(readRoots, currentTime) {
-        return scanCacheDirs(readRoots, (artifact, filePath) => {
-            if (artifact.metadata.status !== 'active')
-                return null;
-            const freshness = evaluateFreshness(artifact.metadata, currentTime, null);
-            if (!this.matchesFilters(artifact.metadata, freshness))
-                return null;
-            return {
-                cacheKey: artifact.metadata.cache_key,
-                path: filePath,
-                artifactType: artifact.metadata.artifact_type,
-                sourceUrls: artifact.metadata.source_urls,
-                topic: artifact.metadata.topic,
-                tags: artifact.metadata.tags,
-                freshness,
-                captureMethod: artifact.metadata.capture_method,
-                tokenEstimate: artifact.metadata.token_estimate,
-                qualityNotes: artifact.metadata.quality_notes,
-                fetchedAt: artifact.metadata.fetched_at,
-                validatedAt: artifact.metadata.validated_at,
-            };
-        });
-    }
-    logListResults(finalResults) {
-        if (this.requestedJson())
-            return;
-        if (finalResults.length === 0) {
-            this.log('No cached research entries found matching filters.');
-            return;
-        }
-        this.log(`Found ${finalResults.length} cached research entries:\n`);
-        finalResults.forEach((res, index) => {
-            this.log(`${index + 1}. [${res.topic || 'No Topic'}] Key: ${res.cacheKey}`);
-            this.log(`   Type: ${res.artifactType} | Freshness: ${res.freshness}`);
-            this.log(`   Tokens: compressed=${res.tokenEstimate?.compressed || 0}, detailed=${res.tokenEstimate?.detailed || 0}`);
-            this.log(`   Source URLs: ${res.sourceUrls.join(', ')}\n`);
-        });
-    }
-    async execute() {
-        this.validateListFlags();
-        const roots = loadStoreRoots({
-            configDir: this.config.configDir,
-            cwd: process.cwd(),
-            dataDir: this.config.dataDir,
-        });
-        const currentTime = new Date();
-        const results = this.scanCacheDirForList(roots.readRoots, currentTime);
-        // Sort by validated_at or fetched_at descending (most recent first)
-        results.sort((a, b) => {
-            const timeA = new Date(a.validatedAt || a.fetchedAt || 0).getTime();
-            const timeB = new Date(b.validatedAt || b.fetchedAt || 0).getTime();
-            return timeB - timeA;
-        });
-        const finalResults = results.slice(0, this.flags.limit);
-        this.logListResults(finalResults);
-        return finalResults;
-    }
-}

package/dist/commands/research/prune.d.ts

@@ -1,24 +0,0 @@
-import { BaseCommand } from '../../base-command.js';
-export default class ResearchPrune extends BaseCommand<typeof ResearchPrune> {
-    static id: string;
-    static summary: string;
-    static description: string;
-    static examples: {
-        description: string;
-        command: string;
-    }[];
-    static flags: {
-        'older-than': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        inactive: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'artifact-type': import("@oclif/core/interfaces").OptionFlag<"source" | "research_note" | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    static stdoutIsPrimaryData: boolean;
-    init(): Promise<void>;
-    private validatePruneFlags;
-    private shouldPrune;
-    private findPruneCandidates;
-    private deletePruneCandidates;
-    execute(): Promise<unknown>;
-}

package/dist/commands/research/prune.js

@@ -1,141 +0,0 @@
-import { Flags } from '@oclif/core';
-import { unlinkSync } from 'node:fs';
-import { join } from 'node:path';
-import { BaseCommand } from '../../base-command.js';
-import { scanCacheDir } from '../../lib/research/storage.js';
-import { loadStoreRoots } from '../../lib/research/store-roots.js';
-import { parseTtlToMs } from '../../lib/research/freshness.js';
-export default class ResearchPrune extends BaseCommand {
-    static id = 'research prune';
-    static summary = 'Clean up old or inactive research cache entries.';
-    static description = 'Prunes cached research entries based on age, inactivity, or artifact type to free up disk space.';
-    static examples = [
-        {
-            description: 'Perform a dry run of pruning entries older than 90 days',
-            command: '<%= config.bin %> research prune --older-than 90d --dry-run',
-        },
-        {
-            description: 'Actually prune entries older than 30 days that are source scrapes',
-            command: '<%= config.bin %> research prune --older-than 30d --artifact-type source --yes',
-        },
-    ];
-    static flags = {
-        'older-than': Flags.string({
-            description: 'Prune entries older than duration (e.g. "30d", "90d").',
-        }),
-        inactive: Flags.string({
-            description: 'Prune entries inactive (unvalidated/unfetched) for duration (e.g. "14d", "30d").',
-        }),
-        'artifact-type': Flags.option({
-            description: 'Filter pruning to specific artifact type.',
-            options: ['source', 'research_note'],
-        })(),
-        'dry-run': Flags.boolean({
-            description: 'List files that would be deleted without actually deleting them.',
-            default: false,
-        }),
-        yes: Flags.boolean({
-            char: 'y',
-            description: 'Skip confirmation prompt and prune files.',
-            default: false,
-        }),
-    };
-    static stdoutIsPrimaryData = true;
-    async init() {
-        await super.init();
-        const { flags } = await this.parse(ResearchPrune);
-        this.flags = flags;
-    }
-    validatePruneFlags() {
-        if (!this.flags['older-than'] && !this.flags.inactive && !this.flags['artifact-type']) {
-            this.error('Must specify at least one pruning filter: --older-than, --inactive, or --artifact-type.', { exit: 2 });
-        }
-        if (!this.flags['dry-run'] && !this.flags.yes) {
-            this.error('Safety check: Please specify --yes to confirm pruning, or --dry-run to list files that would be deleted.', { exit: 2 });
-        }
-    }
-    shouldPrune(meta, currentTime) {
-        const fetched = meta.fetched_at ? new Date(meta.fetched_at).getTime() : 0;
-        const validated = meta.validated_at ? new Date(meta.validated_at).getTime() : 0;
-        const baseTime = Math.max(fetched, validated);
-        const ageMs = currentTime.getTime() - baseTime;
-        if (this.flags['artifact-type'] && meta.artifact_type !== this.flags['artifact-type']) {
-            return false;
-        }
-        if (this.flags['older-than']) {
-            const olderThanMs = parseTtlToMs(this.flags['older-than']);
-            if (ageMs < olderThanMs) {
-                return false;
-            }
-        }
-        if (this.flags.inactive) {
-            const inactiveMs = parseTtlToMs(this.flags.inactive);
-            if (ageMs < inactiveMs) {
-                return false;
-            }
-        }
-        return true;
-    }
-    // Prune across every read root (project + global). No cross-root dedup: each file is a distinct
-    // deletion target, so a cache key present in both locations is pruned in both.
-    findPruneCandidates(readRoots, currentTime) {
-        return readRoots.flatMap((dataDir) => scanCacheDir(join(dataDir, 'research'), (artifact, filePath) => {
-            if (!this.shouldPrune(artifact.metadata, currentTime))
-                return null;
-            return {
-                cacheKey: artifact.metadata.cache_key,
-                path: filePath,
-                topic: artifact.metadata.topic,
-                url: artifact.metadata.source_url,
-            };
-        }));
-    }
-    deletePruneCandidates(filesToPrune) {
-        let prunedCount = 0;
-        for (const f of filesToPrune) {
-            try {
-                unlinkSync(f.path);
-                prunedCount++;
-            }
-            catch (err) {
-                this.warn(`Failed to delete cache file ${f.path}: ${err.message}`);
-            }
-        }
-        return prunedCount;
-    }
-    async execute() {
-        this.validatePruneFlags();
-        const roots = loadStoreRoots({
-            configDir: this.config.configDir,
-            cwd: process.cwd(),
-            dataDir: this.config.dataDir,
-        });
-        const currentTime = new Date();
-        const filesToPrune = this.findPruneCandidates(roots.readRoots, currentTime);
-        const dryRun = this.flags['dry-run'];
-        const count = filesToPrune.length;
-        if (dryRun) {
-            if (!this.requestedJson()) {
-                this.log(`[Dry Run] Found ${count} research cache entries that would be pruned:\n`);
-                filesToPrune.forEach((f) => {
-                    this.log(`- [${f.topic || 'No Topic'}] Key: ${f.cacheKey} (${f.url || 'Imported note'})`);
-                });
-            }
-        }
-        else {
-            const prunedCount = this.deletePruneCandidates(filesToPrune);
-            if (!this.requestedJson()) {
-                this.log(`Successfully pruned ${prunedCount} of ${count} research cache entries.`);
-            }
-        }
-        return {
-            dryRun,
-            prunedCount: dryRun ? 0 : filesToPrune.length,
-            candidateCount: filesToPrune.length,
-            files: filesToPrune.map((f) => ({
-                cacheKey: f.cacheKey,
-                path: f.path,
-            })),
-        };
-    }
-}

package/dist/commands/research/search.d.ts

@@ -1,32 +0,0 @@
-import { BaseCommand } from '../../base-command.js';
-export default class ResearchSearch extends BaseCommand<typeof ResearchSearch> {
-    static id: string;
-    static summary: string;
-    static description: string;
-    static args: {
-        query: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static flags: {
-        topic: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        tags: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'artifact-type': import("@oclif/core/interfaces").OptionFlag<"source" | "research_note" | "index" | "section" | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        'include-stale': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        domain: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    static stdoutIsPrimaryData: boolean;
-    init(): Promise<void>;
-    private validateSearchFlags;
-    private getSearchQueryTerms;
-    private matchesFilters;
-    private phraseMatchBonus;
-    private calculateScore;
-    private makeSnippet;
-    private scanCacheDirForResults;
-    private logSearchResults;
-    private printResults;
-    private executeSiteSearch;
-    private executeRemoteSearch;
-    execute(): Promise<unknown>;
-}