@soleri/core 2.1.0 → 2.5.0

package/dist/playbooks/playbook-types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Playbook Type System
+ *
+ * Two-tier playbook architecture ported from Salvador:
+ * - Generic playbooks: process discipline (TDD, brainstorming, debugging, etc.)
+ * - Domain playbooks: agent-specific workflows that extend generics
+ *
+ * Playbooks compose at plan creation time via the `extends` relationship.
+ * Generic provides the rhythm, domain fills in domain-specific beats.
+ */
+export type PlaybookTier = 'generic' | 'domain';
+export type PlaybookIntent = 'BUILD' | 'FIX' | 'REVIEW' | 'PLAN' | 'IMPROVE' | 'DELIVER';
+/**
+ * A structured brainstorming section returned by the brainstorm op.
+ * The LLM uses these to guide design conversation with the user.
+ */
+export interface BrainstormSection {
+    /** Section title (e.g., "Component API", "Color Requirements") */
+    title: string;
+    /** What this section covers */
+    description: string;
+    /** Guiding questions for the user */
+    questions: string[];
+}
+/**
+ * A gate that must be satisfied at a given lifecycle phase.
+ * Gates inject checkId requirements into the planning lifecycle.
+ */
+export interface PlaybookGate {
+    /** Which lifecycle phase this gate applies to */
+    phase: 'brainstorming' | 'pre-execution' | 'post-task' | 'completion';
+    /** Human-readable requirement description */
+    requirement: string;
+    /** Check type to create/validate */
+    checkType: string;
+}
+/**
+ * A task template that the playbook injects into generated plans.
+ * These become PlanTask entries during task splitting.
+ */
+export interface PlaybookTaskTemplate {
+    /** Task type for the generated task */
+    taskType: 'implementation' | 'test' | 'story' | 'documentation' | 'verification';
+    /** Title template — may contain {objective} placeholder */
+    titleTemplate: string;
+    /** Acceptance criteria injected into the task */
+    acceptanceCriteria: string[];
+    /** Tools relevant to this task */
+    tools: string[];
+    /** When this task should execute relative to implementation */
+    order: 'before-implementation' | 'after-implementation' | 'parallel';
+}
+/**
+ * Complete playbook definition — the core data type.
+ * Playbooks are pure data objects with no logic.
+ */
+export interface PlaybookDefinition {
+    /** Unique identifier (e.g., 'generic-tdd', 'domain-component-build') */
+    id: string;
+    /** Which tier this playbook belongs to */
+    tier: PlaybookTier;
+    /** Human-readable title */
+    title: string;
+    /** When to activate — maps to vault entry 'context' field */
+    trigger: string;
+    /** Overview of what this playbook does — maps to vault 'description' field */
+    description: string;
+    /** Step-by-step process — maps to vault 'example' field */
+    steps: string;
+    /** What success looks like — maps to vault 'why' field */
+    expectedOutcome: string;
+    /** ID of generic playbook this extends (domain playbooks only) */
+    extends?: string;
+    /** Free string category (agents define their own domains) */
+    category: string;
+    /** Searchable tags */
+    tags: string[];
+    /** Intents that trigger this playbook */
+    matchIntents: PlaybookIntent[];
+    /** Keywords in plan objective/scope that trigger this playbook */
+    matchKeywords: string[];
+    /** Brainstorming sections for design exploration (used by brainstorm op) */
+    brainstormSections?: BrainstormSection[];
+    /** Lifecycle gates to enforce */
+    gates: PlaybookGate[];
+    /** Task templates to inject during task generation */
+    taskTemplates: PlaybookTaskTemplate[];
+    /** Generic op names to auto-inject into tool chain (not agent-prefixed) */
+    toolInjections: string[];
+    /** Verification criteria for completion gate */
+    verificationCriteria: string[];
+}
+/**
+ * Result of matching and merging a generic + domain playbook pair.
+ * This is the shape that plan-handler receives after playbook resolution.
+ */
+export interface MergedPlaybook {
+    /** The generic playbook (if matched) */
+    generic?: PlaybookDefinition;
+    /** The domain playbook (if matched) */
+    domain?: PlaybookDefinition;
+    /** Combined gates from both tiers (generic first, then domain) */
+    mergedGates: PlaybookGate[];
+    /** Combined task templates (domain overrides generic where order conflicts) */
+    mergedTasks: PlaybookTaskTemplate[];
+    /** Combined tool injections (deduplicated) */
+    mergedTools: string[];
+    /** Combined verification criteria */
+    mergedVerification: string[];
+    /** Human-readable label for the matched playbook(s) */
+    label: string;
+}
+/**
+ * Result of playbook matching — includes the source of each match.
+ */
+export interface PlaybookMatchResult {
+    /** The merged playbook (null if no match) */
+    playbook: MergedPlaybook | null;
+    /** Which generic matched and why */
+    genericMatch?: {
+        id: string;
+        source: 'vault' | 'builtin';
+        score: number;
+    };
+    /** Which domain matched and why */
+    domainMatch?: {
+        id: string;
+        source: 'vault' | 'builtin';
+        score: number;
+    };
+}
+//# sourceMappingURL=playbook-types.d.ts.map

package/dist/playbooks/playbook-types.d.ts.map

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

package/dist/playbooks/playbook-types.js

@@ -0,0 +1,12 @@
+/**
+ * Playbook Type System
+ *
+ * Two-tier playbook architecture ported from Salvador:
+ * - Generic playbooks: process discipline (TDD, brainstorming, debugging, etc.)
+ * - Domain playbooks: agent-specific workflows that extend generics
+ *
+ * Playbooks compose at plan creation time via the `extends` relationship.
+ * Generic provides the rhythm, domain fills in domain-specific beats.
+ */
+export {};
+//# sourceMappingURL=playbook-types.js.map

package/dist/playbooks/playbook-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-types.js","sourceRoot":"","sources":["../../src/playbooks/playbook-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/project/project-registry.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Project Registry — SQLite-backed registry for tracking projects,
+ * rules, and cross-project links.
+ *
+ * Uses the Vault's underlying SQLite database via `vault.getDb()`.
+ * Tables are created lazily on first access.
+ */
+import type Database from 'better-sqlite3';
+import type { RegisteredProject, ProjectRule, ProjectLink, LinkType } from './types.js';
+export declare class ProjectRegistry {
+    private db;
+    constructor(db: Database.Database);
+    private initTables;
+    /**
+     * Register (upsert) a project. Updates lastAccessedAt on re-register.
+     */
+    register(path: string, name?: string, metadata?: Record<string, unknown>): RegisteredProject;
+    /**
+     * Get a project by ID.
+     */
+    get(projectId: string): RegisteredProject | null;
+    /**
+     * Get a project by its filesystem path.
+     */
+    getByPath(path: string): RegisteredProject | null;
+    /**
+     * List all registered projects.
+     */
+    list(): RegisteredProject[];
+    /**
+     * Unregister a project by ID. Also removes associated rules and links.
+     */
+    unregister(projectId: string): boolean;
+    /**
+     * Update the lastAccessedAt timestamp for a project.
+     */
+    touch(projectId: string): void;
+    /**
+     * Add a rule to a project.
+     */
+    addRule(projectId: string, rule: Omit<ProjectRule, 'id' | 'projectId' | 'createdAt'>): ProjectRule;
+    /**
+     * Get all rules for a project.
+     */
+    getRules(projectId: string): ProjectRule[];
+    /**
+     * Remove a rule by ID.
+     */
+    removeRule(ruleId: string): boolean;
+    /**
+     * List all projects with their rules.
+     */
+    listRulesAll(): Array<{
+        project: RegisteredProject;
+        rules: ProjectRule[];
+    }>;
+    /**
+     * Link two projects.
+     */
+    link(sourceId: string, targetId: string, linkType: LinkType): ProjectLink;
+    /**
+     * Unlink two projects. If linkType is omitted, removes all links between them.
+     * Returns count of links removed.
+     */
+    unlink(sourceId: string, targetId: string, linkType?: LinkType): number;
+    /**
+     * Get all links for a project (both outgoing and incoming).
+     */
+    getLinks(projectId: string): ProjectLink[];
+    /**
+     * Get linked projects with details — returns project info, link type, and direction.
+     */
+    getLinkedProjects(projectId: string): Array<{
+        project: RegisteredProject;
+        linkType: LinkType;
+        direction: 'outgoing' | 'incoming';
+    }>;
+}
+//# sourceMappingURL=project-registry.d.ts.map

package/dist/project/project-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registry.d.ts","sourceRoot":"","sources":["../../src/project/project-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA0ExF,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAKjC,OAAO,CAAC,UAAU;IAgClB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB;IA0C5F;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAOhD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAOjD;;OAEG;IACH,IAAI,IAAI,iBAAiB,EAAE;IAO3B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAatC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ9B;;OAEG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GACxD,WAAW;IAmBd;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IAS1C;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,KAAK,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAU3E;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW;IA2BzE;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM;IAavE;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IAS1C;;OAEG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAC;QAAC,SAAS,EAAE,UAAU,GAAG,UAAU,CAAA;KAAE,CAAC;CAuBjG"}

package/dist/project/project-registry.js

@@ -0,0 +1,274 @@
+/**
+ * Project Registry — SQLite-backed registry for tracking projects,
+ * rules, and cross-project links.
+ *
+ * Uses the Vault's underlying SQLite database via `vault.getDb()`.
+ * Tables are created lazily on first access.
+ */
+/**
+ * Generate a deterministic project ID from a filesystem path.
+ */
+function pathToId(path) {
+    return path
+        .replace(/[^a-z0-9]/gi, '-')
+        .toLowerCase()
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function rowToProject(row) {
+    return {
+        id: row.id,
+        path: row.path,
+        name: row.name ?? undefined,
+        registeredAt: row.registered_at,
+        lastAccessedAt: row.last_accessed_at,
+        metadata: JSON.parse(row.metadata || '{}'),
+    };
+}
+function rowToRule(row) {
+    return {
+        id: row.id,
+        projectId: row.project_id,
+        category: row.category,
+        text: row.text,
+        priority: row.priority,
+        createdAt: row.created_at,
+    };
+}
+function rowToLink(row) {
+    return {
+        id: row.id,
+        sourceProjectId: row.source_project_id,
+        targetProjectId: row.target_project_id,
+        linkType: row.link_type,
+        createdAt: row.created_at,
+    };
+}
+export class ProjectRegistry {
+    db;
+    constructor(db) {
+        this.db = db;
+        this.initTables();
+    }
+    initTables() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS registered_projects (
+        id TEXT PRIMARY KEY,
+        path TEXT UNIQUE NOT NULL,
+        name TEXT,
+        registered_at INTEGER NOT NULL,
+        last_accessed_at INTEGER NOT NULL,
+        metadata TEXT DEFAULT '{}'
+      );
+
+      CREATE TABLE IF NOT EXISTS project_rules (
+        id TEXT PRIMARY KEY,
+        project_id TEXT NOT NULL,
+        category TEXT NOT NULL,
+        text TEXT NOT NULL,
+        priority INTEGER DEFAULT 0,
+        created_at INTEGER NOT NULL,
+        FOREIGN KEY (project_id) REFERENCES registered_projects(id)
+      );
+
+      CREATE TABLE IF NOT EXISTS project_links (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        source_project_id TEXT NOT NULL,
+        target_project_id TEXT NOT NULL,
+        link_type TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        UNIQUE(source_project_id, target_project_id, link_type)
+      );
+    `);
+    }
+    /**
+     * Register (upsert) a project. Updates lastAccessedAt on re-register.
+     */
+    register(path, name, metadata) {
+        const id = pathToId(path);
+        const now = Date.now();
+        const existing = this.db.prepare('SELECT * FROM registered_projects WHERE id = ?').get(id);
+        if (existing) {
+            // Update lastAccessedAt, and optionally name/metadata if provided
+            const newName = name ?? existing.name;
+            const newMetadata = metadata ? JSON.stringify(metadata) : existing.metadata;
+            this.db
+                .prepare('UPDATE registered_projects SET last_accessed_at = ?, name = ?, metadata = ? WHERE id = ?')
+                .run(now, newName, newMetadata, id);
+            return rowToProject({
+                ...existing,
+                last_accessed_at: now,
+                name: newName,
+                metadata: newMetadata,
+            });
+        }
+        const row = {
+            id,
+            path,
+            name: name ?? null,
+            registered_at: now,
+            last_accessed_at: now,
+            metadata: JSON.stringify(metadata ?? {}),
+        };
+        this.db
+            .prepare('INSERT INTO registered_projects (id, path, name, registered_at, last_accessed_at, metadata) VALUES (?, ?, ?, ?, ?, ?)')
+            .run(row.id, row.path, row.name, row.registered_at, row.last_accessed_at, row.metadata);
+        return rowToProject(row);
+    }
+    /**
+     * Get a project by ID.
+     */
+    get(projectId) {
+        const row = this.db.prepare('SELECT * FROM registered_projects WHERE id = ?').get(projectId);
+        return row ? rowToProject(row) : null;
+    }
+    /**
+     * Get a project by its filesystem path.
+     */
+    getByPath(path) {
+        const row = this.db.prepare('SELECT * FROM registered_projects WHERE path = ?').get(path);
+        return row ? rowToProject(row) : null;
+    }
+    /**
+     * List all registered projects.
+     */
+    list() {
+        const rows = this.db
+            .prepare('SELECT * FROM registered_projects ORDER BY last_accessed_at DESC')
+            .all();
+        return rows.map(rowToProject);
+    }
+    /**
+     * Unregister a project by ID. Also removes associated rules and links.
+     */
+    unregister(projectId) {
+        const result = this.db.transaction(() => {
+            this.db.prepare('DELETE FROM project_rules WHERE project_id = ?').run(projectId);
+            this.db
+                .prepare('DELETE FROM project_links WHERE source_project_id = ? OR target_project_id = ?')
+                .run(projectId, projectId);
+            return (this.db.prepare('DELETE FROM registered_projects WHERE id = ?').run(projectId).changes > 0);
+        })();
+        return result;
+    }
+    /**
+     * Update the lastAccessedAt timestamp for a project.
+     */
+    touch(projectId) {
+        this.db
+            .prepare('UPDATE registered_projects SET last_accessed_at = ? WHERE id = ?')
+            .run(Date.now(), projectId);
+    }
+    // ─── Rules ──────────────────────────────────────────────────────────
+    /**
+     * Add a rule to a project.
+     */
+    addRule(projectId, rule) {
+        const id = `rule-${projectId}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const now = Date.now();
+        this.db
+            .prepare('INSERT INTO project_rules (id, project_id, category, text, priority, created_at) VALUES (?, ?, ?, ?, ?, ?)')
+            .run(id, projectId, rule.category, rule.text, rule.priority, now);
+        return {
+            id,
+            projectId,
+            category: rule.category,
+            text: rule.text,
+            priority: rule.priority,
+            createdAt: now,
+        };
+    }
+    /**
+     * Get all rules for a project.
+     */
+    getRules(projectId) {
+        const rows = this.db
+            .prepare('SELECT * FROM project_rules WHERE project_id = ? ORDER BY priority DESC, created_at ASC')
+            .all(projectId);
+        return rows.map(rowToRule);
+    }
+    /**
+     * Remove a rule by ID.
+     */
+    removeRule(ruleId) {
+        return this.db.prepare('DELETE FROM project_rules WHERE id = ?').run(ruleId).changes > 0;
+    }
+    /**
+     * List all projects with their rules.
+     */
+    listRulesAll() {
+        const projects = this.list();
+        return projects.map((project) => ({
+            project,
+            rules: this.getRules(project.id),
+        }));
+    }
+    // ─── Links ──────────────────────────────────────────────────────────
+    /**
+     * Link two projects.
+     */
+    link(sourceId, targetId, linkType) {
+        const now = Date.now();
+        const info = this.db
+            .prepare('INSERT OR IGNORE INTO project_links (source_project_id, target_project_id, link_type, created_at) VALUES (?, ?, ?, ?)')
+            .run(sourceId, targetId, linkType, now);
+        // If insert was ignored (duplicate), fetch existing
+        if (info.changes === 0) {
+            const existing = this.db
+                .prepare('SELECT * FROM project_links WHERE source_project_id = ? AND target_project_id = ? AND link_type = ?')
+                .get(sourceId, targetId, linkType);
+            return rowToLink(existing);
+        }
+        return {
+            id: Number(info.lastInsertRowid),
+            sourceProjectId: sourceId,
+            targetProjectId: targetId,
+            linkType,
+            createdAt: now,
+        };
+    }
+    /**
+     * Unlink two projects. If linkType is omitted, removes all links between them.
+     * Returns count of links removed.
+     */
+    unlink(sourceId, targetId, linkType) {
+        if (linkType) {
+            return this.db
+                .prepare('DELETE FROM project_links WHERE source_project_id = ? AND target_project_id = ? AND link_type = ?')
+                .run(sourceId, targetId, linkType).changes;
+        }
+        return this.db
+            .prepare('DELETE FROM project_links WHERE source_project_id = ? AND target_project_id = ?')
+            .run(sourceId, targetId).changes;
+    }
+    /**
+     * Get all links for a project (both outgoing and incoming).
+     */
+    getLinks(projectId) {
+        const rows = this.db
+            .prepare('SELECT * FROM project_links WHERE source_project_id = ? OR target_project_id = ? ORDER BY created_at DESC')
+            .all(projectId, projectId);
+        return rows.map(rowToLink);
+    }
+    /**
+     * Get linked projects with details — returns project info, link type, and direction.
+     */
+    getLinkedProjects(projectId) {
+        const links = this.getLinks(projectId);
+        const results = [];
+        for (const link of links) {
+            const isOutgoing = link.sourceProjectId === projectId;
+            const otherProjectId = isOutgoing ? link.targetProjectId : link.sourceProjectId;
+            const project = this.get(otherProjectId);
+            if (project) {
+                results.push({
+                    project,
+                    linkType: link.linkType,
+                    direction: isOutgoing ? 'outgoing' : 'incoming',
+                });
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=project-registry.js.map

package/dist/project/project-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registry.js","sourceRoot":"","sources":["../../src/project/project-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkCH;;GAEG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,WAAW,EAAE;SACb,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,YAAY,CAAC,GAAe;IACnC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,SAAS;QAC3B,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,cAAc,EAAE,GAAG,CAAC,gBAAgB;QACpC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,QAAQ,EAAE,GAAG,CAAC,QAAmC;QACjD,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,eAAe,EAAE,GAAG,CAAC,iBAAiB;QACtC,eAAe,EAAE,GAAG,CAAC,iBAAiB;QACtC,QAAQ,EAAE,GAAG,CAAC,SAAqB;QACnC,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,eAAe;IAClB,EAAE,CAAoB;IAE9B,YAAY,EAAqB;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAY,EAAE,IAAa,EAAE,QAAkC;QACtE,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,CAAC,EAAE,CAE5E,CAAC;QAEd,IAAI,QAAQ,EAAE,CAAC;YACb,kEAAkE;YAClE,MAAM,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC;YACtC,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC5E,IAAI,CAAC,EAAE;iBACJ,OAAO,CACN,0FAA0F,CAC3F;iBACA,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YACtC,OAAO,YAAY,CAAC;gBAClB,GAAG,QAAQ;gBACX,gBAAgB,EAAE,GAAG;gBACrB,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,WAAW;aACtB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,GAAe;YACtB,EAAE;YACF,IAAI;YACJ,IAAI,EAAE,IAAI,IAAI,IAAI;YAClB,aAAa,EAAE,GAAG;YAClB,gBAAgB,EAAE,GAAG;YACrB,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC;SACzC,CAAC;QACF,IAAI,CAAC,EAAE;aACJ,OAAO,CACN,uHAAuH,CACxH;aACA,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE1F,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,CAAC,SAAS,CAE9E,CAAC;QACd,OAAO,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC,GAAG,CAAC,IAAI,CAE3E,CAAC;QACd,OAAO,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,kEAAkE,CAAC;aAC3E,GAAG,EAAkB,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAiB;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACjF,IAAI,CAAC,EAAE;iBACJ,OAAO,CAAC,gFAAgF,CAAC;iBACzF,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC7B,OAAO,CACL,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAC3F,CAAC;QACJ,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,EAAE;aACJ,OAAO,CAAC,kEAAkE,CAAC;aAC3E,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,uEAAuE;IAEvE;;OAEG;IACH,OAAO,CACL,SAAiB,EACjB,IAAyD;QAEzD,MAAM,EAAE,GAAG,QAAQ,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE;aACJ,OAAO,CACN,4GAA4G,CAC7G;aACA,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAEpE,OAAO;YACL,EAAE;YACF,SAAS;YACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,GAAG;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN,yFAAyF,CAC1F;aACA,GAAG,CAAC,SAAS,CAAc,CAAC;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChC,OAAO;YACP,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;SACjC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,uEAAuE;IAEvE;;OAEG;IACH,IAAI,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAkB;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN,uHAAuH,CACxH;aACA,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAE1C,oDAAoD;QACpD,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;iBACrB,OAAO,CACN,qGAAqG,CACtG;iBACA,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAY,CAAC;YAChD,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;YAChC,eAAe,EAAE,QAAQ;YACzB,eAAe,EAAE,QAAQ;YACzB,QAAQ;YACR,SAAS,EAAE,GAAG;SACf,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAmB;QAC5D,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,EAAE;iBACX,OAAO,CACN,mGAAmG,CACpG;iBACA,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC,EAAE;aACX,OAAO,CAAC,iFAAiF,CAAC;aAC1F,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN,2GAA2G,CAC5G;aACA,GAAG,CAAC,SAAS,EAAE,SAAS,CAAc,CAAC;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,SAAiB;QAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,OAAO,GAIR,EAAE,CAAC;QAER,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC;YACtD,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;YAChF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACzC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC;oBACX,OAAO;oBACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;iBAChD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/project/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Project registry types — tracks projects, rules, and cross-project links.
+ */
+export interface RegisteredProject {
+    id: string;
+    path: string;
+    name?: string;
+    registeredAt: number;
+    lastAccessedAt: number;
+    metadata?: Record<string, unknown>;
+}
+export interface ProjectRule {
+    id: string;
+    projectId: string;
+    category: 'behavior' | 'preference' | 'restriction' | 'convention';
+    text: string;
+    priority: number;
+    createdAt: number;
+}
+export type LinkType = 'related' | 'parent' | 'child' | 'fork';
+export interface ProjectLink {
+    id: number;
+    sourceProjectId: string;
+    targetProjectId: string;
+    linkType: LinkType;
+    createdAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/project/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/project/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/project/types.js

@@ -0,0 +1,5 @@
+/**
+ * Project registry types — tracks projects, rules, and cross-project links.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/project/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/project/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,4 @@
+export { TemplateManager } from './template-manager.js';
+export { parseVariables, resolveIncludes } from './parser.js';
+export type { PromptTemplate, TemplateVariable, RenderOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,3 @@
+export { TemplateManager } from './template-manager.js';
+export { parseVariables, resolveIncludes } from './parser.js';
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/prompts/parser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Template parser — extract variables and resolve includes.
+ */
+import type { TemplateVariable } from './types.js';
+/**
+ * Extract unique variables from template content.
+ * Supports {{name}} (required) and {{name:default}} (optional with default).
+ */
+export declare function parseVariables(content: string): TemplateVariable[];
+/**
+ * Resolve @include(partial-name) directives.
+ *
+ * The loader function receives the partial name and returns its content.
+ * Cycle detection prevents infinite recursion.
+ */
+export declare function resolveIncludes(content: string, loader: (name: string) => string, _stack?: Set<string>, _depth?: number): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/prompts/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/prompts/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMnD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAgBlE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAChC,MAAM,GAAE,GAAG,CAAC,MAAM,CAAa,EAC/B,MAAM,GAAE,MAAU,GACjB,MAAM,CAeR"}

package/dist/prompts/parser.js

@@ -0,0 +1,47 @@
+/**
+ * Template parser — extract variables and resolve includes.
+ */
+const VAR_PATTERN = /\{\{(\w+)(?::([^}]*))?\}\}/g;
+const INCLUDE_PATTERN = /@include\(([^)]+)\)/g;
+const MAX_INCLUDE_DEPTH = 10;
+/**
+ * Extract unique variables from template content.
+ * Supports {{name}} (required) and {{name:default}} (optional with default).
+ */
+export function parseVariables(content) {
+    const seen = new Map();
+    for (const match of content.matchAll(VAR_PATTERN)) {
+        const name = match[1];
+        const defaultValue = match[2];
+        if (!seen.has(name)) {
+            seen.set(name, {
+                name,
+                required: defaultValue === undefined,
+                defaultValue,
+            });
+        }
+    }
+    return Array.from(seen.values());
+}
+/**
+ * Resolve @include(partial-name) directives.
+ *
+ * The loader function receives the partial name and returns its content.
+ * Cycle detection prevents infinite recursion.
+ */
+export function resolveIncludes(content, loader, _stack = new Set(), _depth = 0) {
+    if (_depth > MAX_INCLUDE_DEPTH) {
+        throw new Error(`Include depth exceeded ${MAX_INCLUDE_DEPTH}. Possible circular include.`);
+    }
+    return content.replace(INCLUDE_PATTERN, (_match, partialName) => {
+        const trimmed = partialName.trim();
+        if (_stack.has(trimmed)) {
+            throw new Error(`Circular include detected: ${trimmed} (stack: ${[..._stack].join(' → ')})`);
+        }
+        const newStack = new Set(_stack);
+        newStack.add(trimmed);
+        const partialContent = loader(trimmed);
+        return resolveIncludes(partialContent, loader, newStack, _depth + 1);
+    });
+}
+//# sourceMappingURL=parser.js.map

package/dist/prompts/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/prompts/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,GAAG,6BAA6B,CAAC;AAClD,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAC/C,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEjD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;gBACb,IAAI;gBACJ,QAAQ,EAAE,YAAY,KAAK,SAAS;gBACpC,YAAY;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,MAAgC,EAChC,SAAsB,IAAI,GAAG,EAAE,EAC/B,SAAiB,CAAC;IAElB,IAAI,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0BAA0B,iBAAiB,8BAA8B,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,WAAmB,EAAE,EAAE;QACtE,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,YAAY,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtB,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC"}