@soleri/core 2.10.0 → 2.12.0

package/dist/migrations/migration-runner.js

@@ -0,0 +1,141 @@
+/**
+ * Schema Migration Runner — versioned migration scripts for engine upgrades.
+ *
+ * Migrations run in version order, track state in `_soleri_migrations` table,
+ * and support verify + rollback.
+ */
+// ─── Runner ───────────────────────────────────────────────────────────
+export class MigrationRunner {
+    db;
+    constructor(db) {
+        this.db = db;
+        this.ensureTable();
+    }
+    /**
+     * Run all pending migrations in version order.
+     */
+    run(migrations) {
+        const applied = this.getApplied();
+        const sorted = [...migrations].sort((a, b) => compareVersions(a.version, b.version));
+        const results = [];
+        for (const migration of sorted) {
+            if (applied.has(migration.version)) {
+                results.push({
+                    version: migration.version,
+                    description: migration.description,
+                    status: 'skipped',
+                    durationMs: 0,
+                });
+                continue;
+            }
+            const start = Date.now();
+            try {
+                migration.up(this.db);
+                // Verify if verifier provided
+                if (migration.verify && !migration.verify(this.db)) {
+                    // Rollback if possible
+                    if (migration.down) {
+                        migration.down(this.db);
+                        results.push({
+                            version: migration.version,
+                            description: migration.description,
+                            status: 'rolled-back',
+                            error: 'Verification failed after apply',
+                            durationMs: Date.now() - start,
+                        });
+                    }
+                    else {
+                        results.push({
+                            version: migration.version,
+                            description: migration.description,
+                            status: 'failed',
+                            error: 'Verification failed, no rollback available',
+                            durationMs: Date.now() - start,
+                        });
+                    }
+                    continue;
+                }
+                // Record as applied
+                this.recordApplied(migration);
+                results.push({
+                    version: migration.version,
+                    description: migration.description,
+                    status: 'applied',
+                    durationMs: Date.now() - start,
+                });
+            }
+            catch (err) {
+                // Attempt rollback
+                if (migration.down) {
+                    try {
+                        migration.down(this.db);
+                    }
+                    catch {
+                        // Rollback failed — nothing we can do
+                    }
+                }
+                results.push({
+                    version: migration.version,
+                    description: migration.description,
+                    status: 'failed',
+                    error: err instanceof Error ? err.message : String(err),
+                    durationMs: Date.now() - start,
+                });
+                // Stop on failure — don't run subsequent migrations
+                break;
+            }
+        }
+        return results;
+    }
+    /**
+     * Get list of applied migrations.
+     */
+    listApplied() {
+        const stmt = this.db.prepare('SELECT version, applied_at, description FROM _soleri_migrations ORDER BY version');
+        const rows = stmt.all();
+        return rows.map((row) => ({
+            version: row.version,
+            appliedAt: row.applied_at,
+            description: row.description,
+        }));
+    }
+    /**
+     * Get pending migrations (not yet applied).
+     */
+    getPending(migrations) {
+        const applied = this.getApplied();
+        return migrations
+            .filter((m) => !applied.has(m.version))
+            .sort((a, b) => compareVersions(a.version, b.version));
+    }
+    getApplied() {
+        const stmt = this.db.prepare('SELECT version FROM _soleri_migrations');
+        const rows = stmt.all();
+        return new Set(rows.map((r) => r.version));
+    }
+    recordApplied(migration) {
+        const stmt = this.db.prepare('INSERT INTO _soleri_migrations (version, applied_at, description) VALUES (?, ?, ?)');
+        stmt.run(migration.version, new Date().toISOString(), migration.description);
+    }
+    ensureTable() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS _soleri_migrations (
+        version TEXT PRIMARY KEY,
+        applied_at TEXT NOT NULL,
+        description TEXT NOT NULL
+      )
+    `);
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const diff = (pa[i] || 0) - (pb[i] || 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+//# sourceMappingURL=migration-runner.js.map

package/dist/migrations/migration-runner.js.map

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

package/dist/packs/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Knowledge Packs — Barrel Exports
+ */
+export { packManifestSchema, type PackManifest, type PackStatus, type InstalledPack, type InstallResult, type ValidateResult, } from './types.js';
+export { PackInstaller } from './pack-installer.js';
+export { PackLockfile, inferPackType } from './lockfile.js';
+export type { LockEntry, PackType, PackSource, LockfileData } from './lockfile.js';
+export { resolvePack, checkNpmVersion, checkVersionCompat } from './resolver.js';
+export type { ResolvedPack, ResolveOptions } from './resolver.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/packs/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/packs/index.js

@@ -0,0 +1,8 @@
+/**
+ * Knowledge Packs — Barrel Exports
+ */
+export { packManifestSchema, } from './types.js';
+export { PackInstaller } from './pack-installer.js';
+export { PackLockfile, inferPackType } from './lockfile.js';
+export { resolvePack, checkNpmVersion, checkVersionCompat } from './resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/packs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/packs/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,GAMnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/packs/lockfile.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Pack Lockfile — persists installed pack metadata to `soleri.lock`.
+ *
+ * Tracks installed pack versions, types, sources, and integrity hashes
+ * for reproducible agent setups. The lockfile enables:
+ * - `soleri pack install --frozen` (CI mode — fail if lockfile is stale)
+ * - `soleri pack outdated` (compare installed vs. latest available)
+ * - Persistence across restarts (unlike the in-memory PackInstaller registry)
+ */
+export interface LockEntry {
+    /** Pack ID (from manifest) */
+    id: string;
+    /** Installed version (semver) */
+    version: string;
+    /** Pack type: hooks, skills, knowledge, domain, bundle */
+    type: PackType;
+    /** Where it was installed from */
+    source: PackSource;
+    /** Path to installed pack directory */
+    directory: string;
+    /** SHA-256 of the manifest file at install time */
+    integrity: string;
+    /** ISO timestamp of install */
+    installedAt: string;
+    /** Number of vault entries seeded */
+    vaultEntries: number;
+    /** Skill names discovered */
+    skills: string[];
+    /** Hook names discovered */
+    hooks: string[];
+    /** Whether facades were registered */
+    facadesRegistered: boolean;
+    /** Compatible @soleri/core version range (from manifest "soleri" field) */
+    soleriRange?: string;
+}
+export type PackType = 'hooks' | 'skills' | 'knowledge' | 'domain' | 'bundle';
+export type PackSource = 'built-in' | 'local' | 'npm';
+export interface LockfileData {
+    /** Lockfile format version */
+    version: 1;
+    /** Map of packId → lock entry */
+    packs: Record<string, LockEntry>;
+}
+export declare class PackLockfile {
+    private readonly filePath;
+    private data;
+    private dirty;
+    constructor(filePath: string);
+    /**
+     * Get a lock entry by pack ID.
+     */
+    get(packId: string): LockEntry | undefined;
+    /**
+     * Set (add or update) a lock entry.
+     */
+    set(entry: LockEntry): void;
+    /**
+     * Remove a lock entry.
+     */
+    remove(packId: string): boolean;
+    /**
+     * List all lock entries.
+     */
+    list(): LockEntry[];
+    /**
+     * Check if a pack is locked.
+     */
+    has(packId: string): boolean;
+    /**
+     * Get number of locked packs.
+     */
+    get size(): number;
+    /**
+     * Save lockfile to disk (only if dirty).
+     */
+    save(): boolean;
+    /**
+     * Force reload from disk.
+     */
+    reload(): void;
+    /**
+     * Compute integrity hash for a manifest file.
+     */
+    static computeIntegrity(manifestPath: string): string;
+    private load;
+}
+/**
+ * Infer pack type from manifest content.
+ */
+export declare function inferPackType(manifest: {
+    vault?: unknown;
+    skills?: unknown;
+    hooks?: unknown;
+    facades?: unknown[];
+    domains?: string[];
+}): PackType;
+//# sourceMappingURL=lockfile.d.ts.map

package/dist/packs/lockfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.d.ts","sourceRoot":"","sources":["../../src/packs/lockfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,IAAI,EAAE,QAAQ,CAAC;IACf,kCAAkC;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sCAAsC;IACtC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAID,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,KAAK,CAAS;gBAEO,QAAQ,EAAE,MAAM;IAI7C;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI1C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAK3B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAO/B;;OAEG;IACH,IAAI,IAAI,SAAS,EAAE;IAInB;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,OAAO;IAWf;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAMrD,OAAO,CAAC,IAAI;CAcb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,QAAQ,CAcX"}

package/dist/packs/lockfile.js

@@ -0,0 +1,129 @@
+/**
+ * Pack Lockfile — persists installed pack metadata to `soleri.lock`.
+ *
+ * Tracks installed pack versions, types, sources, and integrity hashes
+ * for reproducible agent setups. The lockfile enables:
+ * - `soleri pack install --frozen` (CI mode — fail if lockfile is stale)
+ * - `soleri pack outdated` (compare installed vs. latest available)
+ * - Persistence across restarts (unlike the in-memory PackInstaller registry)
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { createHash } from 'node:crypto';
+// ─── Lockfile Manager ─────────────────────────────────────────────────
+export class PackLockfile {
+    filePath;
+    data;
+    dirty = false;
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.data = this.load();
+    }
+    /**
+     * Get a lock entry by pack ID.
+     */
+    get(packId) {
+        return this.data.packs[packId];
+    }
+    /**
+     * Set (add or update) a lock entry.
+     */
+    set(entry) {
+        this.data.packs[entry.id] = entry;
+        this.dirty = true;
+    }
+    /**
+     * Remove a lock entry.
+     */
+    remove(packId) {
+        if (!(packId in this.data.packs))
+            return false;
+        delete this.data.packs[packId];
+        this.dirty = true;
+        return true;
+    }
+    /**
+     * List all lock entries.
+     */
+    list() {
+        return Object.values(this.data.packs);
+    }
+    /**
+     * Check if a pack is locked.
+     */
+    has(packId) {
+        return packId in this.data.packs;
+    }
+    /**
+     * Get number of locked packs.
+     */
+    get size() {
+        return Object.keys(this.data.packs).length;
+    }
+    /**
+     * Save lockfile to disk (only if dirty).
+     */
+    save() {
+        if (!this.dirty)
+            return false;
+        const dir = dirname(this.filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(this.filePath, JSON.stringify(this.data, null, 2) + '\n', 'utf-8');
+        this.dirty = false;
+        return true;
+    }
+    /**
+     * Force reload from disk.
+     */
+    reload() {
+        this.data = this.load();
+        this.dirty = false;
+    }
+    /**
+     * Compute integrity hash for a manifest file.
+     */
+    static computeIntegrity(manifestPath) {
+        if (!existsSync(manifestPath))
+            return '';
+        const content = readFileSync(manifestPath, 'utf-8');
+        return 'sha256-' + createHash('sha256').update(content).digest('hex');
+    }
+    load() {
+        if (!existsSync(this.filePath)) {
+            return { version: 1, packs: {} };
+        }
+        try {
+            const raw = JSON.parse(readFileSync(this.filePath, 'utf-8'));
+            if (raw.version === 1 && typeof raw.packs === 'object') {
+                return raw;
+            }
+            return { version: 1, packs: {} };
+        }
+        catch {
+            return { version: 1, packs: {} };
+        }
+    }
+}
+/**
+ * Infer pack type from manifest content.
+ */
+export function inferPackType(manifest) {
+    const hasVault = !!manifest.vault;
+    const hasSkills = !!manifest.skills;
+    const hasHooks = !!manifest.hooks;
+    const hasFacades = (manifest.facades?.length ?? 0) > 0;
+    // Bundle if multiple content types
+    const types = [hasVault, hasSkills, hasHooks, hasFacades].filter(Boolean).length;
+    if (types > 1)
+        return 'bundle';
+    if (hasHooks)
+        return 'hooks';
+    if (hasSkills)
+        return 'skills';
+    if (hasFacades)
+        return 'domain';
+    return 'knowledge';
+}
+//# sourceMappingURL=lockfile.js.map

package/dist/packs/lockfile.js.map

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

package/dist/packs/pack-installer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pack Installer — validates, loads vault entries, registers facades.
+ *
+ * Install flow:
+ * 1. Read and validate soleri-pack.json manifest
+ * 2. Load vault intelligence bundles from vault/ subdirectory
+ * 3. Register facades via plugin system
+ * 4. Discover skills and hooks
+ * 5. Return install summary
+ */
+import { type InstalledPack, type InstallResult, type ValidateResult } from './types.js';
+import type { Vault } from '../vault/vault.js';
+import type { PluginRegistry } from '../plugins/plugin-registry.js';
+export declare class PackInstaller {
+    private vault;
+    private pluginRegistry;
+    private packs;
+    constructor(vault: Vault, pluginRegistry: PluginRegistry);
+    /**
+     * Validate a pack directory without installing.
+     */
+    validate(packDir: string): ValidateResult;
+    /**
+     * Install a knowledge pack from a directory.
+     */
+    install(packDir: string, runtimeCtx?: unknown): Promise<InstallResult>;
+    /**
+     * Uninstall a pack — deactivates facades, removes from registry.
+     * Note: vault entries are NOT removed (they become part of knowledge).
+     */
+    uninstall(packId: string): boolean;
+    /**
+     * Get an installed pack by ID.
+     */
+    get(packId: string): InstalledPack | undefined;
+    /**
+     * List all installed packs.
+     */
+    list(): InstalledPack[];
+}
+//# sourceMappingURL=pack-installer.d.ts.map

package/dist/packs/pack-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-installer.d.ts","sourceRoot":"","sources":["../../src/packs/pack-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AASpE,qBAAa,aAAa;IAItB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,cAAc;IAJxB,OAAO,CAAC,KAAK,CAAoC;gBAGvC,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,cAAc;IAGxC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAkEzC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAqI5E;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAclC;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9C;;OAEG;IACH,IAAI,IAAI,aAAa,EAAE;CAGxB"}