@zhuk/spego 0.1.0

package/dist/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,UAAU,GAAiC,IAAI,GAAG,EAAE,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAAC,GAAoB;IACpD,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,iBAAiB,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,OAAiB;IAEjB,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/generator/markers.d.ts

@@ -0,0 +1,3 @@
+export declare const SPEGO_GENERATED_MARKER = "<!-- spego-generated";
+export declare function wrapWithMarker(content: string, version?: number): string;
+export declare function isSpegoGenerated(fileContent: string): boolean;

package/dist/generator/markers.js

@@ -0,0 +1,8 @@
+export const SPEGO_GENERATED_MARKER = '<!-- spego-generated';
+export function wrapWithMarker(content, version = 1) {
+    return `${SPEGO_GENERATED_MARKER} v${version} -->\n${content}`;
+}
+export function isSpegoGenerated(fileContent) {
+    return fileContent.startsWith(SPEGO_GENERATED_MARKER);
+}
+//# sourceMappingURL=markers.js.map

package/dist/generator/markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.js","sourceRoot":"","sources":["../../src/generator/markers.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAE7D,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,UAAkB,CAAC;IACjE,OAAO,GAAG,sBAAsB,KAAK,OAAO,SAAS,OAAO,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,WAAW,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;AACxD,CAAC"}

package/dist/generator/types.d.ts

@@ -0,0 +1,15 @@
+export declare const GENERATOR_VERSION = 1;
+export type FileAction = 'created' | 'updated' | 'unchanged' | 'skipped';
+export interface GeneratedFile {
+    path: string;
+    action: FileAction;
+}
+export interface GenerationReport {
+    target: string;
+    files: GeneratedFile[];
+    version: number;
+}
+export interface TargetGenerator {
+    readonly targetName: string;
+    generate(projectRoot: string): Promise<GenerationReport>;
+}

package/dist/generator/types.js

@@ -0,0 +1,2 @@
+export const GENERATOR_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/generator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/generator/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC"}

package/dist/generator/write.d.ts

@@ -0,0 +1,2 @@
+import type { FileAction } from './types.js';
+export declare function writeGeneratedFile(absPath: string, content: string): Promise<FileAction>;

package/dist/generator/write.js

@@ -0,0 +1,28 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { isSpegoGenerated, wrapWithMarker } from './markers.js';
+import { GENERATOR_VERSION } from './types.js';
+export async function writeGeneratedFile(absPath, content) {
+    const marked = wrapWithMarker(content, GENERATOR_VERSION);
+    await fs.mkdir(path.dirname(absPath), { recursive: true });
+    let existing = null;
+    try {
+        existing = await fs.readFile(absPath, 'utf8');
+    }
+    catch {
+        // file does not exist — will create
+    }
+    if (existing !== null) {
+        if (!isSpegoGenerated(existing)) {
+            return 'skipped';
+        }
+        if (marked.trim() === existing.trim()) {
+            return 'unchanged';
+        }
+        await fs.writeFile(absPath, marked, 'utf8');
+        return 'updated';
+    }
+    await fs.writeFile(absPath, marked, 'utf8');
+    return 'created';
+}
+//# sourceMappingURL=write.js.map

package/dist/generator/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/generator/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,OAAe;IAEf,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3D,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index/db.d.ts

@@ -0,0 +1,17 @@
+declare const DatabaseSync: typeof import("node:sqlite").DatabaseSync;
+export type Db = InstanceType<typeof DatabaseSync>;
+/** Open (or create) the SQLite index database with safe pragmas. */
+export declare function openIndexDb(dbPath: string): Db;
+export declare function closeIndexDb(db: Db): void;
+/** Run `fn` inside a SQLite transaction. Rolls back on throw. */
+export declare function transaction<T>(db: Db, fn: () => T): T;
+/**
+ * Create or migrate the index schema. Idempotent.
+ *
+ * Tables:
+ *   - artifacts:      one row per logical artifact (latest snapshot mirror)
+ *   - revisions:      one row per saved revision
+ *   - index_meta:     key/value (schema version, last rebuild, etc.)
+ */
+export declare function ensureIndexSchema(db: Db): void;
+export {};

package/dist/index/db.js

@@ -0,0 +1,95 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+// `node:sqlite` is a Node built-in, but bundlers (Vite/Rollup) trip over the
+// `node:` prefix because their built-in lists lag behind Node releases.
+// Loading via createRequire keeps the import opaque to static analyzers.
+const requireFromHere = createRequire(import.meta.url);
+const { DatabaseSync } = requireFromHere('node:sqlite');
+/** Open (or create) the SQLite index database with safe pragmas. */
+export function openIndexDb(dbPath) {
+    fs.mkdirSync(path.dirname(dbPath), { recursive: true });
+    const db = new DatabaseSync(dbPath);
+    db.exec('PRAGMA journal_mode = WAL');
+    db.exec('PRAGMA synchronous = NORMAL');
+    db.exec('PRAGMA foreign_keys = ON');
+    return db;
+}
+export function closeIndexDb(db) {
+    db.close();
+}
+/** Run `fn` inside a SQLite transaction. Rolls back on throw. */
+export function transaction(db, fn) {
+    db.exec('BEGIN');
+    try {
+        const result = fn();
+        db.exec('COMMIT');
+        return result;
+    }
+    catch (err) {
+        try {
+            db.exec('ROLLBACK');
+        }
+        catch {
+            // ignore secondary rollback failures
+        }
+        throw err;
+    }
+}
+/**
+ * Create or migrate the index schema. Idempotent.
+ *
+ * Tables:
+ *   - artifacts:      one row per logical artifact (latest snapshot mirror)
+ *   - revisions:      one row per saved revision
+ *   - index_meta:     key/value (schema version, last rebuild, etc.)
+ */
+export function ensureIndexSchema(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS index_meta (
+      key   TEXT PRIMARY KEY,
+      value TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS artifacts (
+      id          TEXT PRIMARY KEY,
+      type        TEXT NOT NULL,
+      slug        TEXT NOT NULL,
+      title       TEXT NOT NULL,
+      revision    INTEGER NOT NULL,
+      path        TEXT NOT NULL,
+      created_at  TEXT NOT NULL,
+      updated_at  TEXT NOT NULL,
+      deleted_at  TEXT,
+      meta_json   TEXT NOT NULL DEFAULT '{}'
+    );
+
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_artifacts_type_slug
+      ON artifacts (type, slug);
+
+    CREATE INDEX IF NOT EXISTS idx_artifacts_type
+      ON artifacts (type);
+
+    CREATE INDEX IF NOT EXISTS idx_artifacts_deleted
+      ON artifacts (deleted_at);
+
+    CREATE TABLE IF NOT EXISTS revisions (
+      artifact_id  TEXT NOT NULL,
+      revision     INTEGER NOT NULL,
+      type         TEXT NOT NULL,
+      slug         TEXT NOT NULL,
+      title        TEXT NOT NULL,
+      path         TEXT NOT NULL,
+      created_at   TEXT NOT NULL,
+      meta_json    TEXT NOT NULL DEFAULT '{}',
+      PRIMARY KEY (artifact_id, revision),
+      FOREIGN KEY (artifact_id) REFERENCES artifacts(id) ON DELETE CASCADE
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_revisions_artifact
+      ON revisions (artifact_id);
+  `);
+    db.prepare(`INSERT INTO index_meta (key, value) VALUES ('schema_version', '1')
+     ON CONFLICT(key) DO NOTHING`).run();
+}
+//# sourceMappingURL=db.js.map

package/dist/index/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/index/db.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,6EAA6E;AAC7E,wEAAwE;AACxE,yEAAyE;AACzE,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvD,MAAM,EAAE,YAAY,EAAE,GAAG,eAAe,CAAC,aAAa,CAAiC,CAAC;AAIxF,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACrC,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACvC,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAM;IACjC,EAAE,CAAC,KAAK,EAAE,CAAC;AACb,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAI,EAAM,EAAE,EAAW;IAChD,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;QACpB,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAM;IACtC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CP,CAAC,CAAC;IAEH,EAAE,CAAC,OAAO,CACR;iCAC6B,CAC9B,CAAC,GAAG,EAAE,CAAC;AACV,CAAC"}

package/dist/index/indexer.d.ts

@@ -0,0 +1,42 @@
+import { type WorkspacePaths } from '../workspace/paths.js';
+import type { ArtifactFrontmatter } from '../artifacts/types.js';
+import type { Db } from './db.js';
+export interface IndexedArtifact {
+    id: string;
+    type: string;
+    slug: string;
+    title: string;
+    revision: number;
+    path: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt: string | null;
+    meta: Record<string, unknown>;
+}
+/** Upsert the artifact mirror row + revision row in a single transaction. */
+export declare function upsertArtifact(db: Db, fm: ArtifactFrontmatter, filePath: string, revisionPath?: string): void;
+export interface ListOptions {
+    type?: string;
+    includeDeleted?: boolean;
+}
+export declare function listArtifacts(db: Db, opts?: ListOptions): IndexedArtifact[];
+export declare function getArtifactById(db: Db, id: string): IndexedArtifact | null;
+export declare function getArtifactByTypeSlug(db: Db, type: string, slug: string): IndexedArtifact | null;
+export declare function listRevisions(db: Db, artifactId: string): Array<{
+    revision: number;
+    path: string;
+    createdAt: string;
+}>;
+export interface RebuildReport {
+    scannedFiles: number;
+    indexedArtifacts: number;
+    invalidFiles: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+/**
+ * Walk `.spego/artifacts/**\/*.md`, drop the index tables, and rebuild from
+ * the markdown files. Invalid files are reported but do not abort the rebuild.
+ */
+export declare function rebuildIndex(db: Db, paths: WorkspacePaths, knownTypes?: ReadonlySet<string>): Promise<RebuildReport>;

package/dist/index/indexer.js

@@ -0,0 +1,219 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { artifactFilePath, } from '../workspace/paths.js';
+import { parseArtifactFile, } from '../artifacts/storage.js';
+import { ensureIndexSchema, transaction } from './db.js';
+import { SpegoError } from '../errors.js';
+function rowToArtifact(row) {
+    return {
+        id: row.id,
+        type: row.type,
+        slug: row.slug,
+        title: row.title,
+        revision: row.revision,
+        path: row.path,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        deletedAt: row.deleted_at ?? null,
+        meta: JSON.parse(row.meta_json ?? '{}'),
+    };
+}
+/** Upsert the artifact mirror row + revision row in a single transaction. */
+export function upsertArtifact(db, fm, filePath, revisionPath) {
+    transaction(db, () => {
+        db.prepare(`INSERT INTO artifacts
+         (id, type, slug, title, revision, path, created_at, updated_at, deleted_at, meta_json)
+       VALUES
+         (@id, @type, @slug, @title, @revision, @path, @created_at, @updated_at, @deleted_at, @meta_json)
+       ON CONFLICT(id) DO UPDATE SET
+         type       = excluded.type,
+         slug       = excluded.slug,
+         title      = excluded.title,
+         revision   = excluded.revision,
+         path       = excluded.path,
+         updated_at = excluded.updated_at,
+         deleted_at = excluded.deleted_at,
+         meta_json  = excluded.meta_json`).run({
+            id: fm.id,
+            type: fm.type,
+            slug: fm.slug,
+            title: fm.title,
+            revision: fm.revision,
+            path: filePath,
+            created_at: fm.createdAt,
+            updated_at: fm.updatedAt,
+            deleted_at: fm.deletedAt ?? null,
+            meta_json: JSON.stringify(fm.meta ?? {}),
+        });
+        db.prepare(`INSERT INTO revisions
+         (artifact_id, revision, type, slug, title, path, created_at, meta_json)
+       VALUES
+         (@id, @revision, @type, @slug, @title, @path, @created_at, @meta_json)
+       ON CONFLICT(artifact_id, revision) DO UPDATE SET
+         title      = excluded.title,
+         path       = excluded.path,
+         meta_json  = excluded.meta_json`).run({
+            id: fm.id,
+            revision: fm.revision,
+            type: fm.type,
+            slug: fm.slug,
+            title: fm.title,
+            path: revisionPath ?? filePath,
+            created_at: fm.updatedAt,
+            meta_json: JSON.stringify(fm.meta ?? {}),
+        });
+    });
+}
+export function listArtifacts(db, opts = {}) {
+    const where = [];
+    const params = {};
+    if (opts.type) {
+        where.push('type = @type');
+        params.type = opts.type;
+    }
+    if (!opts.includeDeleted) {
+        where.push('deleted_at IS NULL');
+    }
+    const sql = `SELECT * FROM artifacts` +
+        (where.length ? ` WHERE ${where.join(' AND ')}` : '') +
+        ` ORDER BY type ASC, updated_at DESC`;
+    const stmt = db.prepare(sql);
+    const rows = where.length ? stmt.all(params) : stmt.all();
+    return rows.map((r) => rowToArtifact(r));
+}
+export function getArtifactById(db, id) {
+    const row = db.prepare(`SELECT * FROM artifacts WHERE id = ?`).get(id);
+    return row ? rowToArtifact(row) : null;
+}
+export function getArtifactByTypeSlug(db, type, slug) {
+    const row = db
+        .prepare(`SELECT * FROM artifacts WHERE type = ? AND slug = ?`)
+        .get(type, slug);
+    return row ? rowToArtifact(row) : null;
+}
+export function listRevisions(db, artifactId) {
+    const rows = db
+        .prepare(`SELECT revision, path, created_at FROM revisions WHERE artifact_id = ? ORDER BY revision ASC`)
+        .all(artifactId);
+    return rows.map((r) => ({
+        revision: r.revision,
+        path: r.path,
+        createdAt: r.created_at,
+    }));
+}
+/**
+ * Walk `.spego/artifacts/**\/*.md`, drop the index tables, and rebuild from
+ * the markdown files. Invalid files are reported but do not abort the rebuild.
+ */
+export async function rebuildIndex(db, paths, knownTypes) {
+    const report = {
+        scannedFiles: 0,
+        indexedArtifacts: 0,
+        invalidFiles: [],
+    };
+    // Reset tables; recreate schema for safety.
+    db.exec(`DROP TABLE IF EXISTS revisions; DROP TABLE IF EXISTS artifacts;`);
+    ensureIndexSchema(db);
+    let typeDirs = [];
+    try {
+        typeDirs = await fs.readdir(paths.artifactsRoot);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return report;
+        }
+        throw err;
+    }
+    for (const type of typeDirs) {
+        const typeDir = path.join(paths.artifactsRoot, type);
+        let stat;
+        try {
+            stat = await fs.stat(typeDir);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        const entries = await fs.readdir(typeDir);
+        for (const entry of entries) {
+            if (!entry.endsWith('.md'))
+                continue;
+            const file = path.join(typeDir, entry);
+            report.scannedFiles += 1;
+            try {
+                const text = await fs.readFile(file, 'utf8');
+                const { frontmatter } = parseArtifactFile(text, file);
+                if (knownTypes && !knownTypes.has(frontmatter.type)) {
+                    throw new SpegoError('INVALID_ARTIFACT_TYPE', `Unsupported artifact type: ${frontmatter.type}`, {
+                        type: frontmatter.type,
+                        path: file,
+                    });
+                }
+                const expectedName = `${frontmatter.slug}.md`;
+                if (entry !== expectedName) {
+                    throw new SpegoError('VALIDATION_FAILED', `File name "${entry}" does not match slug "${frontmatter.slug}" in frontmatter`, { path: file, expectedSlug: frontmatter.slug, fileName: entry });
+                }
+                // Use the canonical computed path so reads from any cwd resolve.
+                const canonical = artifactFilePath(paths, frontmatter.type, frontmatter.slug);
+                upsertArtifact(db, frontmatter, canonical);
+                // Discover revision snapshots and reattach.
+                await reindexRevisions(db, paths, frontmatter, report);
+                report.indexedArtifacts += 1;
+            }
+            catch (err) {
+                const message = err instanceof SpegoError ? `${err.code}: ${err.message}` : err.message;
+                report.invalidFiles.push({ path: file, error: message });
+            }
+        }
+    }
+    db.prepare(`INSERT INTO index_meta (key, value) VALUES ('last_rebuild', @value)
+     ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run({ value: new Date().toISOString() });
+    return report;
+}
+async function reindexRevisions(db, paths, fm, report) {
+    const revDir = path.join(paths.revisionsRoot, fm.type);
+    let entries;
+    try {
+        entries = await fs.readdir(revDir);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    const prefix = `${fm.slug}.r`;
+    for (const entry of entries) {
+        if (!entry.startsWith(prefix) || !entry.endsWith('.md'))
+            continue;
+        const file = path.join(revDir, entry);
+        try {
+            const text = await fs.readFile(file, 'utf8');
+            const { frontmatter } = parseArtifactFile(text, file);
+            if (frontmatter.id !== fm.id)
+                continue;
+            db.prepare(`INSERT INTO revisions
+           (artifact_id, revision, type, slug, title, path, created_at, meta_json)
+         VALUES
+           (@id, @revision, @type, @slug, @title, @path, @created_at, @meta_json)
+         ON CONFLICT(artifact_id, revision) DO UPDATE SET
+           title     = excluded.title,
+           path      = excluded.path,
+           meta_json = excluded.meta_json`).run({
+                id: frontmatter.id,
+                revision: frontmatter.revision,
+                type: frontmatter.type,
+                slug: frontmatter.slug,
+                title: frontmatter.title,
+                path: file,
+                created_at: frontmatter.updatedAt,
+                meta_json: JSON.stringify(frontmatter.meta ?? {}),
+            });
+        }
+        catch (err) {
+            const message = err instanceof SpegoError ? `${err.code}: ${err.message}` : err.message;
+            report.invalidFiles.push({ path: file, error: message });
+        }
+    }
+}
+//# sourceMappingURL=indexer.js.map

package/dist/index/indexer.js.map

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

package/dist/index/revisions.d.ts

@@ -0,0 +1,13 @@
+import { type WorkspacePaths } from '../workspace/paths.js';
+import type { ArtifactFrontmatter } from '../artifacts/types.js';
+/**
+ * Persist a snapshot of an artifact at the given revision under
+ * `.spego/revisions/<type>/<slug>.r<n>.md`.
+ */
+export declare function writeRevisionSnapshot(paths: WorkspacePaths, frontmatter: ArtifactFrontmatter, body: string): Promise<string>;
+/** Read a previously snapshotted revision. */
+export declare function readRevisionSnapshot(paths: WorkspacePaths, type: string, slug: string, revision: number): Promise<{
+    frontmatter: ArtifactFrontmatter;
+    body: string;
+    path: string;
+}>;

package/dist/index/revisions.js

@@ -0,0 +1,31 @@
+import fs from 'node:fs/promises';
+import { revisionFilePath } from '../workspace/paths.js';
+import { atomicWriteFile, parseArtifactFile } from '../artifacts/storage.js';
+import { renderArtifactFile } from '../artifacts/storage.js';
+import { SpegoError } from '../errors.js';
+/**
+ * Persist a snapshot of an artifact at the given revision under
+ * `.spego/revisions/<type>/<slug>.r<n>.md`.
+ */
+export async function writeRevisionSnapshot(paths, frontmatter, body) {
+    const dest = revisionFilePath(paths, frontmatter.type, frontmatter.slug, frontmatter.revision);
+    await atomicWriteFile(dest, renderArtifactFile(frontmatter, body));
+    return dest;
+}
+/** Read a previously snapshotted revision. */
+export async function readRevisionSnapshot(paths, type, slug, revision) {
+    const file = revisionFilePath(paths, type, slug, revision);
+    let raw;
+    try {
+        raw = await fs.readFile(file, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new SpegoError('REVISION_NOT_FOUND', `Revision ${revision} not found for ${type}/${slug}`, { type, slug, revision, path: file });
+        }
+        throw err;
+    }
+    const parsed = parseArtifactFile(raw, file);
+    return { ...parsed, path: file };
+}
+//# sourceMappingURL=revisions.js.map

package/dist/index/revisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revisions.js","sourceRoot":"","sources":["../../src/index/revisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAuB,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAqB,EACrB,WAAgC,EAChC,IAAY;IAEZ,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/F,MAAM,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAqB,EACrB,IAAY,EACZ,IAAY,EACZ,QAAgB;IAEhB,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3D,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,UAAU,CAClB,oBAAoB,EACpB,YAAY,QAAQ,kBAAkB,IAAI,IAAI,IAAI,EAAE,EACpD,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CACrC,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Public API for embedding the spego artifact engine in other tools.
+ * The CLI in `cli.ts` is built on top of these exports.
+ */
+export { ArtifactEngine } from './artifacts/engine.js';
+export type { EngineOptions } from './artifacts/engine.js';
+export { artifactFrontmatterSchema, BUILTIN_ARTIFACT_TYPES, } from './artifacts/types.js';
+export type { ArtifactFrontmatter, ArtifactRecord, ArtifactType, BuiltinArtifactType, } from './artifacts/types.js';
+export { initWorkspace, workspaceStatus, } from './workspace/init.js';
+export type { InitOptions, InitSummary, WorkspaceStatus } from './workspace/init.js';
+export { resolveWorkspacePaths, artifactFilePath, artifactTypeDir, revisionFilePath, WORKSPACE_DIR_NAME, ARTIFACTS_DIR_NAME, REVISIONS_DIR_NAME, INDEX_DIR_NAME, CONFIG_FILE_NAME, INDEX_DB_FILE_NAME, } from './workspace/paths.js';
+export type { WorkspacePaths } from './workspace/paths.js';
+export { defaultConfig, knownArtifactTypes, readConfig, writeConfig, workspaceConfigSchema, } from './workspace/config.js';
+export type { WorkspaceConfig, SupportedAgent } from './workspace/config.js';
+export type { CreateArtifactInput, UpdateArtifactInput } from './artifacts/validation.js';
+export type { IndexedArtifact, RebuildReport } from './index/indexer.js';
+export { viewArtifacts, renderMarkdownBundle, renderJsonBundle } from './export/view.js';
+export type { ViewOptions, ViewResult, MarkdownBundle, JsonBundle, JsonArtifact, } from './export/view.js';
+export { SpegoError } from './errors.js';
+export type { SpegoErrorCode } from './errors.js';
+export { validateMetaForType, hasTypeSchema, ARTIFACT_META_SCHEMAS } from './artifacts/schemas.js';
+export { COMMAND_REGISTRY, getCommandByName } from './commands/registry.js';
+export type { CommandMeta, InputField } from './commands/registry.js';
+export { generateAll, registerGenerator, getGenerator, availableTargets } from './generator/index.js';
+export { ClaudeGenerator } from './generator/claude.js';
+export type { TargetGenerator, GenerationReport, GeneratedFile, FileAction } from './generator/types.js';
+export { SPEGO_GENERATED_MARKER, isSpegoGenerated, wrapWithMarker } from './generator/markers.js';
+export { resolveAdapter } from './delivery/index.js';
+export type { DeliveryAdapter, DeliveryEpicLink, DeliveryItemStatus, DeliveryStatus, DeliveryTaskSummary, } from './delivery/index.js';

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * Public API for embedding the spego artifact engine in other tools.
+ * The CLI in `cli.ts` is built on top of these exports.
+ */
+export { ArtifactEngine } from './artifacts/engine.js';
+export { artifactFrontmatterSchema, BUILTIN_ARTIFACT_TYPES, } from './artifacts/types.js';
+export { initWorkspace, workspaceStatus, } from './workspace/init.js';
+export { resolveWorkspacePaths, artifactFilePath, artifactTypeDir, revisionFilePath, WORKSPACE_DIR_NAME, ARTIFACTS_DIR_NAME, REVISIONS_DIR_NAME, INDEX_DIR_NAME, CONFIG_FILE_NAME, INDEX_DB_FILE_NAME, } from './workspace/paths.js';
+export { defaultConfig, knownArtifactTypes, readConfig, writeConfig, workspaceConfigSchema, } from './workspace/config.js';
+export { viewArtifacts, renderMarkdownBundle, renderJsonBundle } from './export/view.js';
+export { SpegoError } from './errors.js';
+export { validateMetaForType, hasTypeSchema, ARTIFACT_META_SCHEMAS } from './artifacts/schemas.js';
+export { COMMAND_REGISTRY, getCommandByName } from './commands/registry.js';
+export { generateAll, registerGenerator, getGenerator, availableTargets } from './generator/index.js';
+export { ClaudeGenerator } from './generator/claude.js';
+export { SPEGO_GENERATED_MARKER, isSpegoGenerated, wrapWithMarker } from './generator/markers.js';
+export { resolveAdapter } from './delivery/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EACL,aAAa,EACb,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQzF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/workspace/config.d.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+export declare const SUPPORTED_AGENTS: readonly ["claude", "cursor", "opencode", "amp"];
+export type SupportedAgent = (typeof SUPPORTED_AGENTS)[number];
+export declare const workspaceConfigSchema: z.ZodObject<{
+    /** Schema version. Bump when config layout changes. */
+    version: z.ZodDefault<z.ZodLiteral<1>>;
+    /** Agent toolchains the workspace targets. */
+    agents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Whether init seeded demo artifacts. */
+    demo: z.ZodDefault<z.ZodBoolean>;
+    /** Built-in types are always allowed; this list extends them. */
+    extraArtifactTypes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    deliveryAdapter: z.ZodDefault<z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        options: Record<string, unknown>;
+        name: string;
+    }, {
+        options?: Record<string, unknown> | undefined;
+        name?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    version: 1;
+    agents: string[];
+    demo: boolean;
+    extraArtifactTypes: string[];
+    deliveryAdapter: {
+        options: Record<string, unknown>;
+        name: string;
+    };
+}, {
+    version?: 1 | undefined;
+    agents?: string[] | undefined;
+    demo?: boolean | undefined;
+    extraArtifactTypes?: string[] | undefined;
+    deliveryAdapter?: {
+        options?: Record<string, unknown> | undefined;
+        name?: string | undefined;
+    } | undefined;
+}>;
+export type WorkspaceConfig = z.infer<typeof workspaceConfigSchema>;
+export declare function defaultConfig(overrides?: Partial<WorkspaceConfig>): WorkspaceConfig;
+export declare function readConfig(configPath: string): Promise<WorkspaceConfig>;
+export declare function writeConfig(configPath: string, config: WorkspaceConfig): Promise<void>;
+/** Returns the union of built-in and user-extended artifact types. */
+export declare function knownArtifactTypes(config: WorkspaceConfig): Set<string>;