@hongmaple0820/scale-engine 0.1.0

package/dist/artifact/sqliteStore.js

@@ -0,0 +1,394 @@
+/**
+ * SCALE Engine — SQLite Artifact Store (W3)
+ *
+ * 替代 InMemoryArtifactStore，提供持久化存储。
+ * 设计参考：docs/02-DATA-MODEL.md §四、docs/03-CORE-MODULES.md §3.2
+ *
+ * 特性：
+ * - SQLite WAL 模式（读写并发安全）
+ * - JSON 序列化 payload/gates/statusHistory/parents/children/tags/labels
+ * - 事件自动落入 events 表
+ * - 完整 CRUD + query + findChildren + findParents
+ */
+import Database from 'better-sqlite3';
+import { ArtifactNotFoundError } from './types.js';
+import { mkdirSync, existsSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+// ============================================================================
+// Schema DDL
+// ============================================================================
+const SCHEMA_DDL = `
+-- Artifacts 主表
+CREATE TABLE IF NOT EXISTS artifacts (
+  id            TEXT PRIMARY KEY,
+  type          TEXT NOT NULL,
+  version       INTEGER NOT NULL DEFAULT 1,
+  status        TEXT NOT NULL DEFAULT 'DRAFT',
+  status_history TEXT NOT NULL DEFAULT '[]',   -- JSON array of StatusChange
+  parents       TEXT NOT NULL DEFAULT '[]',    -- JSON array of ArtifactId
+  children      TEXT NOT NULL DEFAULT '[]',    -- JSON array of ArtifactId
+  supersedes    TEXT,
+  title         TEXT NOT NULL,
+  content_ref   TEXT NOT NULL DEFAULT '',
+  payload       TEXT NOT NULL DEFAULT '{}',    -- JSON
+  gates         TEXT NOT NULL DEFAULT '[]',    -- JSON array of Gate
+  created_by    TEXT NOT NULL DEFAULT '{}',    -- JSON Actor
+  created_at    INTEGER NOT NULL,
+  updated_at    INTEGER NOT NULL,
+  closed_at     INTEGER,
+  tags          TEXT NOT NULL DEFAULT '[]',    -- JSON array
+  labels        TEXT NOT NULL DEFAULT '{}'     -- JSON object
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_type ON artifacts(type);
+CREATE INDEX IF NOT EXISTS idx_artifacts_status ON artifacts(status);
+CREATE INDEX IF NOT EXISTS idx_artifacts_created_at ON artifacts(created_at);
+
+-- Events 表（事件溯源的持久化副本）
+CREATE TABLE IF NOT EXISTS events (
+  id           TEXT PRIMARY KEY,
+  type         TEXT NOT NULL,
+  timestamp    INTEGER NOT NULL,
+  session_id   TEXT,
+  artifact_id  TEXT,
+  actor        TEXT DEFAULT '{}',
+  payload      TEXT NOT NULL DEFAULT '{}',
+  metadata     TEXT DEFAULT '{}'
+);
+
+CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
+CREATE INDEX IF NOT EXISTS idx_events_artifact_id ON events(artifact_id);
+CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
+
+-- Artifact 关系边表（加速 parent/child 查询）
+CREATE TABLE IF NOT EXISTS artifact_edges (
+  parent_id TEXT NOT NULL,
+  child_id  TEXT NOT NULL,
+  PRIMARY KEY (parent_id, child_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_edges_parent ON artifact_edges(parent_id);
+CREATE INDEX IF NOT EXISTS idx_edges_child ON artifact_edges(child_id);
+
+-- 元信息表
+CREATE TABLE IF NOT EXISTS meta (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+-- 初始化 schema version
+INSERT OR IGNORE INTO meta (key, value) VALUES ('schema_version', '1');
+`;
+// ============================================================================
+// SQLiteArtifactStore
+// ============================================================================
+export class SQLiteArtifactStore {
+    eventBus;
+    db;
+    seq = 0;
+    artifactsDir;
+    // Prepared statements (性能优化)
+    stmtInsert;
+    stmtGet;
+    stmtUpdate;
+    stmtDelete;
+    stmtInsertEdge;
+    stmtDeleteEdges;
+    stmtFindChildren;
+    stmtFindParents;
+    stmtInsertEvent;
+    constructor(eventBus, opts = {}) {
+        this.eventBus = eventBus;
+        const dbPath = opts.dbPath ?? '.scale/scale.db';
+        this.artifactsDir = opts.artifactsDir ?? '.scale/artifacts';
+        // 确保目录存在
+        mkdirSync(dirname(dbPath), { recursive: true });
+        if (!existsSync(this.artifactsDir))
+            mkdirSync(this.artifactsDir, { recursive: true });
+        // 创建 DB
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this.db.pragma('busy_timeout = 5000');
+        // 初始化 schema
+        this.db.exec(SCHEMA_DDL);
+        // 准备 statements
+        this.prepareStatements();
+        // 恢复 seq
+        const maxRow = this.db.prepare(`SELECT id FROM artifacts ORDER BY created_at DESC LIMIT 1`).get();
+        if (maxRow) {
+            const parts = maxRow.id.split('-');
+            this.seq = parseInt(parts[parts.length - 1], 10) || 0;
+        }
+        // 订阅 EventBus 事件 → 自动写入 events 表
+        this.eventBus.on('*', (event) => {
+            try {
+                this.stmtInsertEvent.run(event.id, event.type, event.timestamp, event.sessionId ?? null, event.artifactId ?? null, JSON.stringify(event.actor ?? {}), JSON.stringify(event.payload ?? {}), JSON.stringify({}));
+            }
+            catch {
+                // 容忍写入失败（避免循环依赖阻塞）
+            }
+        });
+    }
+    prepareStatements() {
+        this.stmtInsert = this.db.prepare(`
+      INSERT INTO artifacts (id, type, version, status, status_history, parents, children, supersedes,
+        title, content_ref, payload, gates, created_by, created_at, updated_at, closed_at, tags, labels)
+      VALUES (@id, @type, @version, @status, @statusHistory, @parents, @children, @supersedes,
+        @title, @contentRef, @payload, @gates, @createdBy, @createdAt, @updatedAt, @closedAt, @tags, @labels)
+    `);
+        this.stmtGet = this.db.prepare(`SELECT * FROM artifacts WHERE id = ?`);
+        this.stmtUpdate = this.db.prepare(`
+      UPDATE artifacts SET
+        version = @version, status = @status, status_history = @statusHistory,
+        parents = @parents, children = @children, supersedes = @supersedes,
+        title = @title, content_ref = @contentRef, payload = @payload,
+        gates = @gates, updated_at = @updatedAt, closed_at = @closedAt,
+        tags = @tags, labels = @labels
+      WHERE id = @id
+    `);
+        this.stmtDelete = this.db.prepare(`DELETE FROM artifacts WHERE id = ?`);
+        this.stmtInsertEdge = this.db.prepare(`INSERT OR IGNORE INTO artifact_edges (parent_id, child_id) VALUES (?, ?)`);
+        this.stmtDeleteEdges = this.db.prepare(`DELETE FROM artifact_edges WHERE child_id = ?`);
+        this.stmtFindChildren = this.db.prepare(`
+      SELECT a.* FROM artifacts a
+      INNER JOIN artifact_edges e ON a.id = e.child_id
+      WHERE e.parent_id = ?
+    `);
+        this.stmtFindParents = this.db.prepare(`
+      SELECT a.* FROM artifacts a
+      INNER JOIN artifact_edges e ON a.id = e.parent_id
+      WHERE e.child_id = ?
+    `);
+        this.stmtInsertEvent = this.db.prepare(`
+      INSERT OR IGNORE INTO events (id, type, timestamp, session_id, artifact_id, actor, payload, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+    }
+    // ===== CRUD =====
+    async create(input) {
+        const id = this.generateId(input.type);
+        const contentRef = this.contentPath(input.type, id);
+        if (input.contentBody) {
+            mkdirSync(dirname(contentRef), { recursive: true });
+            writeFileSync(contentRef, input.contentBody, 'utf-8');
+        }
+        const artifact = {
+            id,
+            type: input.type,
+            version: 1,
+            status: input.initialStatus ?? 'DRAFT',
+            statusHistory: [],
+            parents: input.parents ?? [],
+            children: [],
+            title: input.title,
+            contentRef,
+            payload: input.payload,
+            gates: [],
+            createdBy: input.createdBy ?? { kind: 'system', component: 'CLI' },
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            tags: input.tags ?? [],
+            labels: input.labels ?? {},
+        };
+        const insertAll = this.db.transaction(() => {
+            this.stmtInsert.run(this.toRow(artifact));
+            // 写入边表
+            for (const parentId of artifact.parents) {
+                this.stmtInsertEdge.run(parentId, id);
+                // 更新父的 children 字段
+                const parentRow = this.stmtGet.get(parentId);
+                if (parentRow) {
+                    const parentChildren = JSON.parse(parentRow.children);
+                    if (!parentChildren.includes(id)) {
+                        parentChildren.push(id);
+                        this.db.prepare(`UPDATE artifacts SET children = ? WHERE id = ?`).run(JSON.stringify(parentChildren), parentId);
+                    }
+                }
+            }
+        });
+        insertAll();
+        this.eventBus.emit('artifact.created', { id, type: input.type, title: input.title }, { artifactId: id, actor: artifact.createdBy });
+        return artifact;
+    }
+    async get(id) {
+        const row = this.stmtGet.get(id);
+        return row ? this.fromRow(row) : null;
+    }
+    async update(id, updates) {
+        const existing = await this.get(id);
+        if (!existing)
+            throw new ArtifactNotFoundError(id);
+        const updated = {
+            ...existing,
+            ...updates,
+            id, // 不允许改 id
+            type: existing.type, // 不允许改 type
+            version: existing.version + 1,
+            updatedAt: Date.now(),
+        };
+        this.stmtUpdate.run(this.toRow(updated));
+        this.eventBus.emit('artifact.updated', { id, fields: Object.keys(updates) }, { artifactId: id });
+        return updated;
+    }
+    async delete(id) {
+        const existing = await this.get(id);
+        if (!existing)
+            throw new ArtifactNotFoundError(id);
+        const deleteAll = this.db.transaction(() => {
+            this.stmtDeleteEdges.run(id);
+            this.stmtDelete.run(id);
+        });
+        deleteAll();
+        this.eventBus.emit('artifact.deleted', { id }, { artifactId: id });
+    }
+    async query(filter) {
+        const conditions = ['1=1'];
+        const params = [];
+        if (filter.type) {
+            const types = Array.isArray(filter.type) ? filter.type : [filter.type];
+            conditions.push(`type IN (${types.map(() => '?').join(',')})`);
+            params.push(...types);
+        }
+        if (filter.status) {
+            const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+            conditions.push(`status IN (${statuses.map(() => '?').join(',')})`);
+            params.push(...statuses);
+        }
+        if (filter.tags && filter.tags.length > 0) {
+            // JSON 包含检查：每个 tag 都必须在 tags JSON 数组中
+            for (const tag of filter.tags) {
+                conditions.push(`tags LIKE ?`);
+                params.push(`%"${tag}"%`);
+            }
+        }
+        if (filter.parentId) {
+            conditions.push(`id IN (SELECT child_id FROM artifact_edges WHERE parent_id = ?)`);
+            params.push(filter.parentId);
+        }
+        let sql = `SELECT * FROM artifacts WHERE ${conditions.join(' AND ')} ORDER BY created_at DESC`;
+        if (filter.limit) {
+            sql += ` LIMIT ?`;
+            params.push(filter.limit);
+        }
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((r) => this.fromRow(r));
+    }
+    async findChildren(parentId, type) {
+        if (type) {
+            const rows = this.db.prepare(`
+        SELECT a.* FROM artifacts a
+        INNER JOIN artifact_edges e ON a.id = e.child_id
+        WHERE e.parent_id = ? AND a.type = ?
+      `).all(parentId, type);
+            return rows.map((r) => this.fromRow(r));
+        }
+        const rows = this.stmtFindChildren.all(parentId);
+        return rows.map((r) => this.fromRow(r));
+    }
+    async findParents(childId) {
+        const rows = this.stmtFindParents.all(childId);
+        return rows.map((r) => this.fromRow(r));
+    }
+    async setGate(artifactId, gate) {
+        const artifact = await this.get(artifactId);
+        if (!artifact)
+            throw new ArtifactNotFoundError(artifactId);
+        const idx = artifact.gates.findIndex((g) => g.name === gate.name);
+        if (idx >= 0)
+            artifact.gates[idx] = gate;
+        else
+            artifact.gates.push(gate);
+        this.db.prepare(`UPDATE artifacts SET gates = ?, updated_at = ? WHERE id = ?`)
+            .run(JSON.stringify(artifact.gates), Date.now(), artifactId);
+        this.eventBus.emit('artifact.gate_checked', { artifactId, gate }, { artifactId });
+    }
+    // ===== 额外方法 =====
+    /** 查询事件（从 events 表） */
+    queryEvents(opts = {}) {
+        const conditions = ['1=1'];
+        const params = [];
+        if (opts.artifactId) {
+            conditions.push('artifact_id = ?');
+            params.push(opts.artifactId);
+        }
+        if (opts.type) {
+            conditions.push('type = ?');
+            params.push(opts.type);
+        }
+        let sql = `SELECT * FROM events WHERE ${conditions.join(' AND ')} ORDER BY timestamp DESC`;
+        if (opts.limit) {
+            sql += ` LIMIT ?`;
+            params.push(opts.limit);
+        }
+        return this.db.prepare(sql).all(...params);
+    }
+    /** 获取统计信息 */
+    stats() {
+        const artifactCount = this.db.prepare('SELECT COUNT(*) as c FROM artifacts').get().c;
+        const eventCount = this.db.prepare('SELECT COUNT(*) as c FROM events').get().c;
+        const rows = this.db.prepare('SELECT type, COUNT(*) as c FROM artifacts GROUP BY type').all();
+        const byType = {};
+        for (const r of rows)
+            byType[r.type] = r.c;
+        return { artifactCount, eventCount, byType };
+    }
+    /** 关闭数据库连接 */
+    close() {
+        this.db.close();
+    }
+    // ===== 内部 =====
+    generateId(type) {
+        const date = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+        this.seq = (this.seq + 1) % 10000;
+        return `${type.toUpperCase()}-${date}-${this.seq.toString().padStart(4, '0')}`;
+    }
+    contentPath(type, id) {
+        return join(this.artifactsDir, type.toLowerCase(), `${id}.md`);
+    }
+    toRow(a) {
+        return {
+            id: a.id,
+            type: a.type,
+            version: a.version,
+            status: a.status,
+            statusHistory: JSON.stringify(a.statusHistory),
+            parents: JSON.stringify(a.parents),
+            children: JSON.stringify(a.children),
+            supersedes: a.supersedes ?? null,
+            title: a.title,
+            contentRef: a.contentRef,
+            payload: JSON.stringify(a.payload),
+            gates: JSON.stringify(a.gates),
+            createdBy: JSON.stringify(a.createdBy),
+            createdAt: a.createdAt,
+            updatedAt: a.updatedAt,
+            closedAt: a.closedAt ?? null,
+            tags: JSON.stringify(a.tags),
+            labels: JSON.stringify(a.labels),
+        };
+    }
+    fromRow(row) {
+        return {
+            id: row.id,
+            type: row.type,
+            version: row.version,
+            status: row.status,
+            statusHistory: JSON.parse(row.status_history),
+            parents: JSON.parse(row.parents),
+            children: JSON.parse(row.children),
+            supersedes: row.supersedes ?? undefined,
+            title: row.title,
+            contentRef: row.content_ref,
+            payload: JSON.parse(row.payload),
+            gates: JSON.parse(row.gates),
+            createdBy: JSON.parse(row.created_by),
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            closedAt: row.closed_at ?? undefined,
+            tags: JSON.parse(row.tags),
+            labels: JSON.parse(row.labels),
+        };
+    }
+}
+//# sourceMappingURL=sqliteStore.js.map

package/dist/artifact/sqliteStore.js.map

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

package/dist/artifact/store.d.ts

@@ -0,0 +1,49 @@
+import type { Artifact, ArtifactType, Gate, ArtifactId } from './types.js';
+import type { IEventBus } from '../core/eventBus.js';
+export interface CreateArtifactInput {
+    type: ArtifactType;
+    title: string;
+    payload: unknown;
+    parents?: ArtifactId[];
+    tags?: string[];
+    labels?: Record<string, string>;
+    createdBy?: import('./types.js').Actor;
+    initialStatus?: string;
+    contentBody?: string;
+}
+export interface ArtifactFilter {
+    type?: ArtifactType | ArtifactType[];
+    status?: string | string[];
+    tags?: string[];
+    parentId?: ArtifactId;
+    limit?: number;
+}
+export interface IArtifactStore {
+    create(input: CreateArtifactInput): Promise<Artifact>;
+    get(id: ArtifactId): Promise<Artifact | null>;
+    update(id: ArtifactId, updates: Partial<Artifact>): Promise<Artifact>;
+    delete(id: ArtifactId): Promise<void>;
+    query(filter: ArtifactFilter): Promise<Artifact[]>;
+    findChildren(parentId: ArtifactId, type?: ArtifactType): Promise<Artifact[]>;
+    findParents(childId: ArtifactId): Promise<Artifact[]>;
+    setGate(artifactId: ArtifactId, gate: Gate): Promise<void>;
+}
+export declare class InMemoryArtifactStore implements IArtifactStore {
+    private eventBus;
+    private artifacts;
+    private artifactsDir;
+    private seq;
+    constructor(eventBus: IEventBus, opts?: {
+        artifactsDir?: string;
+    });
+    create(input: CreateArtifactInput): Promise<Artifact>;
+    get(id: ArtifactId): Promise<Artifact | null>;
+    update(id: ArtifactId, updates: Partial<Artifact>): Promise<Artifact>;
+    delete(id: ArtifactId): Promise<void>;
+    query(filter: ArtifactFilter): Promise<Artifact[]>;
+    findChildren(parentId: ArtifactId, type?: ArtifactType): Promise<Artifact[]>;
+    findParents(childId: ArtifactId): Promise<Artifact[]>;
+    setGate(artifactId: ArtifactId, gate: Gate): Promise<void>;
+    private generateId;
+    private contentPath;
+}

package/dist/artifact/store.js

@@ -0,0 +1,118 @@
+// SCALE Engine — Artifact Store (内存版骨架, W3 升级 SQLite)
+// 设计参考：docs/03-CORE-MODULES.md §3.2
+import { ArtifactNotFoundError } from './types.js';
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+export class InMemoryArtifactStore {
+    eventBus;
+    artifacts = new Map();
+    artifactsDir;
+    seq = 0;
+    constructor(eventBus, opts = {}) {
+        this.eventBus = eventBus;
+        this.artifactsDir = opts.artifactsDir ?? '.scale/artifacts';
+        if (!existsSync(this.artifactsDir))
+            mkdirSync(this.artifactsDir, { recursive: true });
+    }
+    async create(input) {
+        const id = this.generateId(input.type);
+        const contentRef = this.contentPath(input.type, id);
+        if (input.contentBody) {
+            mkdirSync(dirname(contentRef), { recursive: true });
+            writeFileSync(contentRef, input.contentBody, 'utf-8');
+        }
+        const artifact = {
+            id, type: input.type, version: 1,
+            status: input.initialStatus ?? 'DRAFT',
+            statusHistory: [],
+            parents: input.parents ?? [],
+            children: [],
+            title: input.title,
+            contentRef,
+            payload: input.payload,
+            gates: [],
+            createdBy: input.createdBy ?? { kind: 'system', component: 'CLI' },
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            tags: input.tags ?? [],
+            labels: input.labels ?? {},
+        };
+        this.artifacts.set(id, artifact);
+        // 更新父 artifacts 的 children
+        for (const parentId of artifact.parents) {
+            const parent = this.artifacts.get(parentId);
+            if (parent)
+                parent.children.push(id);
+        }
+        this.eventBus.emit('artifact.created', { id, type: input.type, title: input.title }, { artifactId: id, actor: artifact.createdBy });
+        return artifact;
+    }
+    async get(id) {
+        return this.artifacts.get(id) ?? null;
+    }
+    async update(id, updates) {
+        const existing = this.artifacts.get(id);
+        if (!existing)
+            throw new ArtifactNotFoundError(id);
+        const updated = { ...existing, ...updates, version: existing.version + 1, updatedAt: Date.now() };
+        this.artifacts.set(id, updated);
+        this.eventBus.emit('artifact.updated', { id, fields: Object.keys(updates) }, { artifactId: id });
+        return updated;
+    }
+    async delete(id) {
+        if (!this.artifacts.has(id))
+            throw new ArtifactNotFoundError(id);
+        this.artifacts.delete(id);
+        this.eventBus.emit('artifact.deleted', { id }, { artifactId: id });
+    }
+    async query(filter) {
+        let result = Array.from(this.artifacts.values());
+        if (filter.type) {
+            const types = Array.isArray(filter.type) ? filter.type : [filter.type];
+            result = result.filter((a) => types.includes(a.type));
+        }
+        if (filter.status) {
+            const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+            result = result.filter((a) => statuses.includes(a.status));
+        }
+        if (filter.tags) {
+            result = result.filter((a) => filter.tags.every((t) => a.tags.includes(t)));
+        }
+        if (filter.parentId) {
+            result = result.filter((a) => a.parents.includes(filter.parentId));
+        }
+        if (filter.limit)
+            result = result.slice(0, filter.limit);
+        return result;
+    }
+    async findChildren(parentId, type) {
+        return this.query({ parentId, type });
+    }
+    async findParents(childId) {
+        const child = this.artifacts.get(childId);
+        if (!child)
+            return [];
+        return child.parents.map((id) => this.artifacts.get(id)).filter(Boolean);
+    }
+    async setGate(artifactId, gate) {
+        const artifact = this.artifacts.get(artifactId);
+        if (!artifact)
+            throw new ArtifactNotFoundError(artifactId);
+        const idx = artifact.gates.findIndex((g) => g.name === gate.name);
+        if (idx >= 0)
+            artifact.gates[idx] = gate;
+        else
+            artifact.gates.push(gate);
+        this.eventBus.emit('artifact.gate_checked', { artifactId, gate }, { artifactId });
+    }
+    // ===== 内部 =====
+    generateId(type) {
+        const date = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+        this.seq = (this.seq + 1) % 10000;
+        return `${type.toUpperCase()}-${date}-${this.seq.toString().padStart(4, '0')}`;
+    }
+    contentPath(type, id) {
+        return join(this.artifactsDir, type.toLowerCase(), `${id}.md`);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/artifact/store.js.map

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