@soleri/core 2.9.0 → 2.11.0

package/dist/vault/obsidian-sync.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Obsidian Bidirectional Sync — export/import vault entries as Obsidian markdown.
+ *
+ * Supports three modes:
+ * - Push (vault → Obsidian)
+ * - Pull (Obsidian → vault)
+ * - Bidirectional (timestamp-based merge with conflict detection)
+ *
+ * Format: YAML frontmatter + body content + wikilinks for related entries.
+ */
+import type { Vault } from './vault.js';
+import type { IntelligenceEntry } from '../intelligence/types.js';
+export interface ObsidianSyncConfig {
+    vault: Vault;
+}
+export interface ExportOptions {
+    types?: string[];
+    domains?: string[];
+    dryRun?: boolean;
+}
+export interface ImportOptions {
+    defaultType?: string;
+    defaultDomain?: string;
+    dryRun?: boolean;
+}
+export type SyncMode = 'push' | 'pull' | 'bidirectional';
+export interface SyncOptions {
+    mode?: SyncMode;
+    dryRun?: boolean;
+}
+export interface ExportResult {
+    exported: number;
+    files: string[];
+    skipped: number;
+}
+export interface ImportResult {
+    imported: number;
+    updated: number;
+    skipped: number;
+    conflicts: ConflictInfo[];
+}
+export interface SyncResult {
+    pushed: number;
+    pulled: number;
+    conflicts: ConflictInfo[];
+    mode: SyncMode;
+}
+export interface ConflictInfo {
+    title: string;
+    id: string;
+    vaultUpdated: number;
+    obsidianUpdated: number;
+    vaultSnippet: string;
+    obsidianSnippet: string;
+}
+/**
+ * Convert a vault entry to Obsidian-compatible markdown with YAML frontmatter.
+ */
+export declare function toObsidianMarkdown(entry: IntelligenceEntry): string;
+/**
+ * Parse Obsidian markdown with YAML frontmatter back to vault entry fields.
+ */
+export declare function fromObsidianMarkdown(content: string): {
+    id?: string;
+    type?: string;
+    domain?: string;
+    severity?: string;
+    tags?: string[];
+    title?: string;
+    description?: string;
+    updated?: number;
+};
+/**
+ * Slugify a title for use as a filename.
+ */
+export declare function titleToSlug(title: string): string;
+export declare class ObsidianSync {
+    private vault;
+    constructor(config: ObsidianSyncConfig);
+    /**
+     * Export vault entries to Obsidian markdown files.
+     */
+    export(obsidianDir: string, opts?: ExportOptions): ExportResult;
+    /**
+     * Import Obsidian markdown files into the vault.
+     */
+    import(obsidianDir: string, opts?: ImportOptions): ImportResult;
+    /**
+     * Bidirectional sync between vault and Obsidian directory.
+     */
+    sync(obsidianDir: string, opts?: SyncOptions): SyncResult;
+    private findMarkdownFiles;
+}
+//# sourceMappingURL=obsidian-sync.d.ts.map

package/dist/vault/obsidian-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian-sync.d.ts","sourceRoot":"","sources":["../../src/vault/obsidian-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIlE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAkBnE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG;IACrD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CA+DA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAQ;gBAET,MAAM,EAAE,kBAAkB;IAItC;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY;IAqCnE;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY;IA0DnE;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,UAAU;IA8B7D,OAAO,CAAC,iBAAiB;CAiB1B"}

package/dist/vault/obsidian-sync.js

@@ -0,0 +1,247 @@
+/**
+ * Obsidian Bidirectional Sync — export/import vault entries as Obsidian markdown.
+ *
+ * Supports three modes:
+ * - Push (vault → Obsidian)
+ * - Pull (Obsidian → vault)
+ * - Bidirectional (timestamp-based merge with conflict detection)
+ *
+ * Format: YAML frontmatter + body content + wikilinks for related entries.
+ */
+import { mkdirSync, writeFileSync, readFileSync, readdirSync } from 'node:fs';
+import { join, extname, relative, dirname } from 'node:path';
+// ─── Format Helpers ──────────────────────────────────────────────────
+/**
+ * Convert a vault entry to Obsidian-compatible markdown with YAML frontmatter.
+ */
+export function toObsidianMarkdown(entry) {
+    const lines = ['---'];
+    lines.push(`id: "${entry.id}"`);
+    lines.push(`type: "${entry.type}"`);
+    if (entry.domain)
+        lines.push(`domain: "${entry.domain}"`);
+    if (entry.severity)
+        lines.push(`severity: "${entry.severity}"`);
+    if (entry.tags && entry.tags.length > 0) {
+        lines.push(`tags: [${entry.tags.map((t) => `"${t}"`).join(', ')}]`);
+    }
+    lines.push(`updated: ${Date.now()}`);
+    lines.push('---');
+    lines.push('');
+    lines.push(`# ${entry.title}`);
+    lines.push('');
+    lines.push(entry.description);
+    return lines.join('\n');
+}
+/**
+ * Parse Obsidian markdown with YAML frontmatter back to vault entry fields.
+ */
+export function fromObsidianMarkdown(content) {
+    const result = {};
+    // Parse YAML frontmatter
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (fmMatch) {
+        const yaml = fmMatch[1];
+        for (const line of yaml.split('\n')) {
+            const kv = line.match(/^(\w+):\s*(.+)$/);
+            if (!kv)
+                continue;
+            const [, key, value] = kv;
+            if (key === 'tags') {
+                const tagMatch = value.match(/\[([^\]]*)\]/);
+                if (tagMatch) {
+                    result.tags = tagMatch[1]
+                        .split(',')
+                        .map((t) => t.trim().replace(/^"|"$/g, ''))
+                        .filter(Boolean);
+                }
+            }
+            else if (key === 'updated') {
+                result.updated = parseInt(value, 10);
+            }
+            else {
+                result[key] = value.replace(/^"|"$/g, '');
+            }
+        }
+    }
+    // Parse body
+    const body = content.replace(/^---\n[\s\S]*?\n---\n*/, '');
+    const titleMatch = body.match(/^# (.+)$/m);
+    if (titleMatch) {
+        result.title = titleMatch[1];
+    }
+    const description = body.replace(/^# .+\n*/, '').trim();
+    if (description) {
+        result.description = description;
+    }
+    // Type inference when missing
+    if (!result.type && description) {
+        const lower = description.toLowerCase();
+        if (/\b(don't|avoid|never|anti-pattern)\b/.test(lower)) {
+            result.type = 'anti-pattern';
+        }
+        else if (/\b(always|prefer|use|pattern)\b/.test(lower)) {
+            result.type = 'pattern';
+        }
+        else if (/^rule:/i.test(description)) {
+            result.type = 'rule';
+        }
+        else {
+            result.type = 'concept';
+        }
+    }
+    return result;
+}
+/**
+ * Slugify a title for use as a filename.
+ */
+export function titleToSlug(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 80);
+}
+// ─── Sync Engine ─────────────────────────────────────────────────────
+export class ObsidianSync {
+    vault;
+    constructor(config) {
+        this.vault = config.vault;
+    }
+    /**
+     * Export vault entries to Obsidian markdown files.
+     */
+    export(obsidianDir, opts = {}) {
+        let entries = this.vault.list({});
+        // Filter by types and domains (vault.list takes singular, we support arrays)
+        if (opts.types && opts.types.length > 0) {
+            entries = entries.filter((e) => opts.types.includes(e.type));
+        }
+        if (opts.domains && opts.domains.length > 0) {
+            entries = entries.filter((e) => opts.domains.includes(e.domain || ''));
+        }
+        const files = [];
+        let skipped = 0;
+        for (const entry of entries) {
+            const domain = entry.domain || 'general';
+            const slug = titleToSlug(entry.title);
+            if (!slug) {
+                skipped++;
+                continue;
+            }
+            const dir = join(obsidianDir, domain);
+            const filePath = join(dir, `${slug}.md`);
+            const relPath = relative(obsidianDir, filePath);
+            if (!opts.dryRun) {
+                mkdirSync(dir, { recursive: true });
+                writeFileSync(filePath, toObsidianMarkdown(entry), 'utf-8');
+            }
+            files.push(relPath);
+        }
+        return { exported: files.length, files, skipped };
+    }
+    /**
+     * Import Obsidian markdown files into the vault.
+     */
+    import(obsidianDir, opts = {}) {
+        const mdFiles = this.findMarkdownFiles(obsidianDir);
+        let imported = 0;
+        let updated = 0;
+        let skipped = 0;
+        const conflicts = [];
+        for (const file of mdFiles) {
+            const content = readFileSync(file, 'utf-8');
+            const parsed = fromObsidianMarkdown(content);
+            if (!parsed.title || !parsed.description) {
+                skipped++;
+                continue;
+            }
+            // Use directory name as domain fallback
+            const relDir = dirname(relative(obsidianDir, file));
+            const domain = parsed.domain || (relDir !== '.' ? relDir : opts.defaultDomain || 'general');
+            const type = parsed.type || opts.defaultType || 'concept';
+            // Check if exists by ID
+            if (parsed.id) {
+                const existing = this.vault.get(parsed.id);
+                if (existing) {
+                    if (!opts.dryRun) {
+                        this.vault.update(parsed.id, {
+                            title: parsed.title,
+                            description: parsed.description,
+                            domain,
+                            tags: parsed.tags || [],
+                        });
+                    }
+                    updated++;
+                    continue;
+                }
+            }
+            // New entry
+            if (!opts.dryRun) {
+                this.vault.seed([
+                    {
+                        id: parsed.id || `obsidian-${titleToSlug(parsed.title)}-${Date.now()}`,
+                        type: type,
+                        domain,
+                        title: parsed.title,
+                        description: parsed.description,
+                        severity: parsed.severity || 'suggestion',
+                        tags: parsed.tags || [],
+                    },
+                ]);
+            }
+            imported++;
+        }
+        return { imported, updated, skipped, conflicts };
+    }
+    /**
+     * Bidirectional sync between vault and Obsidian directory.
+     */
+    sync(obsidianDir, opts = {}) {
+        const mode = opts.mode || 'bidirectional';
+        if (mode === 'push') {
+            const result = this.export(obsidianDir, { dryRun: opts.dryRun });
+            return { pushed: result.exported, pulled: 0, conflicts: [], mode };
+        }
+        if (mode === 'pull') {
+            const result = this.import(obsidianDir, { dryRun: opts.dryRun });
+            return {
+                pushed: 0,
+                pulled: result.imported + result.updated,
+                conflicts: result.conflicts,
+                mode,
+            };
+        }
+        // Bidirectional: export first, then import new entries
+        const exportResult = this.export(obsidianDir, { dryRun: opts.dryRun });
+        const importResult = this.import(obsidianDir, { dryRun: opts.dryRun });
+        return {
+            pushed: exportResult.exported,
+            pulled: importResult.imported + importResult.updated,
+            conflicts: importResult.conflicts,
+            mode,
+        };
+    }
+    findMarkdownFiles(dir) {
+        const results = [];
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    results.push(...this.findMarkdownFiles(fullPath));
+                }
+                else if (extname(entry.name) === '.md') {
+                    results.push(fullPath);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or can't be read
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=obsidian-sync.js.map

package/dist/vault/obsidian-sync.js.map

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

package/dist/vault/scope-detector.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Scope detector — classifies knowledge entries into agent/project/team tiers.
+ *
+ * Uses weighted signal heuristics from content, category, tags, and title
+ * to determine where an entry should live:
+ * - agent: personal preferences, local config, workflow habits
+ * - project: repo-specific patterns, architecture decisions, internal APIs
+ * - team: universal patterns, language best practices, design principles
+ */
+export type ScopeTier = 'agent' | 'project' | 'team';
+export type ConfidenceLevel = 'HIGH' | 'MEDIUM' | 'LOW';
+export interface ScopeSignal {
+    tier: ScopeTier;
+    source: 'content' | 'category' | 'tags' | 'title';
+    indicator: string;
+    weight: number;
+}
+export interface ScopeDetectionResult {
+    tier: ScopeTier;
+    confidence: ConfidenceLevel;
+    reason: string;
+    signals: ScopeSignal[];
+}
+export interface ScopeInput {
+    title: string;
+    description: string;
+    category?: string;
+    tags?: string[];
+}
+export declare function detectScope(input: ScopeInput): ScopeDetectionResult;
+//# sourceMappingURL=scope-detector.d.ts.map

package/dist/vault/scope-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-detector.d.ts","sourceRoot":"","sources":["../../src/vault/scope-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAwJD,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,oBAAoB,CAkCnE"}

package/dist/vault/scope-detector.js

@@ -0,0 +1,182 @@
+/**
+ * Scope detector — classifies knowledge entries into agent/project/team tiers.
+ *
+ * Uses weighted signal heuristics from content, category, tags, and title
+ * to determine where an entry should live:
+ * - agent: personal preferences, local config, workflow habits
+ * - project: repo-specific patterns, architecture decisions, internal APIs
+ * - team: universal patterns, language best practices, design principles
+ */
+// ─── Signal patterns ─────────────────────────────────────────────────
+const TEAM_CONTENT_PATTERNS = [
+    { pattern: /accessibility|a11y|aria-|screen\s+reader/i, weight: 0.85, desc: 'accessibility' },
+    { pattern: /design\s+system|semantic\s+token/i, weight: 0.8, desc: 'design system' },
+    { pattern: /contrast\s+ratio|wcag/i, weight: 0.85, desc: 'WCAG guidelines' },
+    {
+        pattern: /clean\s+code|solid\s+principle|dry|kiss/i,
+        weight: 0.7,
+        desc: 'clean code principles',
+    },
+    { pattern: /security|xss|csrf|injection|sanitiz/i, weight: 0.75, desc: 'security patterns' },
+    { pattern: /performance|lazy\s+load|memoiz/i, weight: 0.6, desc: 'performance patterns' },
+    { pattern: /type\s+safety|type\s+guard/i, weight: 0.55, desc: 'type safety' },
+    { pattern: /error\s+handling|error\s+boundary/i, weight: 0.6, desc: 'error handling' },
+    { pattern: /touch\s+target|tap\s+target|fitts/i, weight: 0.8, desc: 'UX touch targets' },
+    { pattern: /focus\s+(ring|state|indicator)/i, weight: 0.8, desc: 'focus states' },
+    { pattern: /best\s+practice|anti.?pattern/i, weight: 0.65, desc: 'best practice' },
+];
+const PROJECT_CONTENT_PATTERNS = [
+    { pattern: /@[\w-]+\/[\w-]+/, weight: 0.9, desc: 'scoped package (@org/pkg)' },
+    { pattern: /packages\/[\w/-]+/, weight: 0.8, desc: 'monorepo path' },
+    { pattern: /src\/[\w/-]+\.(ts|js|tsx|jsx)/, weight: 0.7, desc: 'project file path' },
+    {
+        pattern: /our\s+(project|codebase|team|repo)/i,
+        weight: 0.75,
+        desc: 'project-specific language',
+    },
+    { pattern: /this\s+(project|codebase|repository)/i, weight: 0.8, desc: 'explicit project ref' },
+    { pattern: /internal\s+(api|service)/i, weight: 0.7, desc: 'internal service' },
+    { pattern: /\.config\.(ts|js|mjs)/i, weight: 0.5, desc: 'config file reference' },
+    { pattern: /localhost|127\.0\.0\.1/i, weight: 0.6, desc: 'local dev reference' },
+];
+const AGENT_CONTENT_PATTERNS = [
+    { pattern: /I\s+prefer|my\s+workflow|my\s+setup/i, weight: 0.8, desc: 'personal preference' },
+    { pattern: /~\/|\/Users\/|\/home\//i, weight: 0.7, desc: 'home directory path' },
+    { pattern: /my\s+(editor|IDE|terminal|shell)/i, weight: 0.75, desc: 'personal tooling' },
+    { pattern: /alias(es)?|shortcut/i, weight: 0.6, desc: 'personal aliases' },
+    { pattern: /habit|routine|always\s+do/i, weight: 0.55, desc: 'personal habit' },
+];
+const TEAM_CATEGORIES = new Set([
+    'styling',
+    'accessibility',
+    'performance',
+    'security',
+    'design',
+    'methodology',
+]);
+const PROJECT_CATEGORIES = new Set([
+    'monorepo',
+    'prisma',
+    'infrastructure',
+    'deployment',
+    'config',
+]);
+const TEAM_TAGS = new Set([
+    'universal',
+    'best-practice',
+    'a11y',
+    'accessibility',
+    'wcag',
+    'security',
+    'performance',
+    'clean-code',
+    'design-system',
+    'pattern',
+    'principle',
+]);
+const PROJECT_TAGS = new Set([
+    'project-specific',
+    'internal',
+    'monorepo',
+    'infrastructure',
+    'deployment',
+]);
+const AGENT_TAGS = new Set(['personal', 'preference', 'workflow', 'habit', 'local']);
+// ─── Analysis functions ──────────────────────────────────────────────
+function analyzeContent(text) {
+    const signals = [];
+    for (const { pattern, weight, desc } of TEAM_CONTENT_PATTERNS) {
+        if (pattern.test(text)) {
+            signals.push({ tier: 'team', source: 'content', indicator: desc, weight });
+        }
+    }
+    for (const { pattern, weight, desc } of PROJECT_CONTENT_PATTERNS) {
+        if (pattern.test(text)) {
+            signals.push({ tier: 'project', source: 'content', indicator: desc, weight });
+        }
+    }
+    for (const { pattern, weight, desc } of AGENT_CONTENT_PATTERNS) {
+        if (pattern.test(text)) {
+            signals.push({ tier: 'agent', source: 'content', indicator: desc, weight });
+        }
+    }
+    return signals;
+}
+function analyzeCategory(category) {
+    const norm = category.toLowerCase();
+    if (TEAM_CATEGORIES.has(norm)) {
+        return [{ tier: 'team', source: 'category', indicator: `category "${category}"`, weight: 0.7 }];
+    }
+    if (PROJECT_CATEGORIES.has(norm)) {
+        return [
+            { tier: 'project', source: 'category', indicator: `category "${category}"`, weight: 0.6 },
+        ];
+    }
+    return [];
+}
+function analyzeTags(tags) {
+    const signals = [];
+    for (const tag of tags) {
+        const norm = tag.toLowerCase();
+        if (TEAM_TAGS.has(norm)) {
+            signals.push({ tier: 'team', source: 'tags', indicator: `tag "${tag}"`, weight: 0.8 });
+        }
+        else if (PROJECT_TAGS.has(norm)) {
+            signals.push({ tier: 'project', source: 'tags', indicator: `tag "${tag}"`, weight: 0.8 });
+        }
+        else if (AGENT_TAGS.has(norm)) {
+            signals.push({ tier: 'agent', source: 'tags', indicator: `tag "${tag}"`, weight: 0.8 });
+        }
+    }
+    return signals;
+}
+function computeConfidence(scores, winner) {
+    const winScore = scores[winner];
+    const others = Object.entries(scores)
+        .filter(([t]) => t !== winner)
+        .map(([, v]) => v);
+    const runnerUp = Math.max(...others, 0);
+    if (winScore === 0)
+        return 'LOW';
+    if (runnerUp === 0 && winScore >= 0.5)
+        return 'HIGH';
+    const ratio = winScore / (winScore + runnerUp);
+    if (ratio >= 0.7 && winScore >= 1.0)
+        return 'HIGH';
+    if (ratio >= 0.55)
+        return 'MEDIUM';
+    return 'LOW';
+}
+// ─── Public API ──────────────────────────────────────────────────────
+export function detectScope(input) {
+    const signals = [];
+    const fullText = `${input.title} ${input.description}`;
+    signals.push(...analyzeContent(fullText));
+    if (input.category)
+        signals.push(...analyzeCategory(input.category));
+    if (input.tags?.length)
+        signals.push(...analyzeTags(input.tags));
+    const scores = { agent: 0, project: 0, team: 0 };
+    for (const s of signals) {
+        scores[s.tier] += s.weight;
+    }
+    // Default to agent when no signals
+    let winner = 'agent';
+    let maxScore = 0;
+    for (const [tier, score] of Object.entries(scores)) {
+        if (score > maxScore) {
+            maxScore = score;
+            winner = tier;
+        }
+    }
+    const confidence = computeConfidence(scores, winner);
+    const topSignals = signals
+        .filter((s) => s.tier === winner)
+        .sort((a, b) => b.weight - a.weight)
+        .slice(0, 3);
+    const reason = topSignals.length > 0
+        ? topSignals.map((s) => s.indicator).join('; ')
+        : 'No clear signals — defaulting to agent tier';
+    return { tier: winner, confidence, reason, signals };
+}
+//# sourceMappingURL=scope-detector.js.map

package/dist/vault/scope-detector.js.map

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

package/dist/vault/vault-branching.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Vault Branching — experiment with knowledge changes on named branches
+ * before merging to the main vault.
+ *
+ * Each branch tracks a set of operations (add/modify/remove) against vault entries.
+ * On merge, all operations are applied atomically to the main vault.
+ * Conflict resolution: branch entry wins (explicit user action to merge).
+ *
+ * Improved over Salvador: uses PersistenceProvider abstraction, separate
+ * metadata table (no sentinel markers), and merge logic built-in.
+ */
+import type { IntelligenceEntry } from '../intelligence/types.js';
+import type { Vault } from './vault.js';
+export type BranchAction = 'add' | 'modify' | 'remove';
+export interface BranchEntry {
+    id: number;
+    branchName: string;
+    entryId: string;
+    action: BranchAction;
+    entryData: IntelligenceEntry | null;
+    createdAt: number;
+}
+export interface BranchSummary {
+    name: string;
+    entryCount: number;
+    createdAt: number;
+    merged: boolean;
+}
+export interface MergeResult {
+    merged: boolean;
+    branchName: string;
+    added: number;
+    modified: number;
+    removed: number;
+    total: number;
+}
+export declare class VaultBranching {
+    private provider;
+    private vault;
+    constructor(vault: Vault);
+    private initialize;
+    /**
+     * Create a new branch. Name must be unique among active (unmerged) branches.
+     */
+    branch(name: string): boolean;
+    /**
+     * Add an operation to a branch.
+     * For 'add' and 'modify', entryData is required.
+     * For 'remove', entryData is optional.
+     */
+    addOperation(branchName: string, entryId: string, action: BranchAction, entryData?: IntelligenceEntry): void;
+    /**
+     * List entries on a branch.
+     */
+    listEntries(branchName: string): BranchEntry[];
+    /**
+     * List all branches with summary info.
+     */
+    listBranches(): BranchSummary[];
+    /**
+     * Merge a branch into the main vault. Applies all operations atomically.
+     * Conflict resolution: branch entry wins (the user explicitly chose to merge).
+     */
+    merge(branchName: string): MergeResult;
+    /**
+     * Delete a branch and all its operations.
+     */
+    deleteBranch(branchName: string): boolean;
+    private assertActiveBranch;
+}
+//# sourceMappingURL=vault-branching.d.ts.map

package/dist/vault/vault-branching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-branching.d.ts","sourceRoot":"","sources":["../../src/vault/vault-branching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,KAAK,CAAQ;gBAET,KAAK,EAAE,KAAK;IAMxB,OAAO,CAAC,UAAU;IAmBlB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAiB7B;;;;OAIG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,EACpB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,IAAI;IAiBP;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE;IAwB9C;;OAEG;IACH,YAAY,IAAI,aAAa,EAAE;IAsB/B;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAqDtC;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAgBzC,OAAO,CAAC,kBAAkB;CAQ3B"}