opencode-telos 1.0.0

package/dist/sdd/permissions/access.js

@@ -0,0 +1,333 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { execSync } from "child_process";
+const PERMISSIONS_FILE = ".sdd/permissions.json";
+const AUDIT_LOG_FILE = ".sdd/audit-log.json";
+const DEFAULT_ROLES = [
+    {
+        role: "admin",
+        permissions: [
+            "create_feature", "create_requirement", "create_entity", "create_endpoint",
+            "create_change", "approve_feature", "approve_requirement",
+            "approve_architecture", "approve_breaking", "modify_constitution",
+            "modify_decision", "execute_rollback", "manage_permissions",
+            "sync_push", "sync_pull",
+        ],
+        max_approvals: 100,
+    },
+    {
+        role: "architect",
+        permissions: [
+            "create_feature", "create_requirement", "create_entity", "create_endpoint",
+            "create_change", "approve_feature", "approve_requirement",
+            "approve_architecture", "modify_decision",
+            "sync_push", "sync_pull",
+        ],
+        max_approvals: 50,
+    },
+    {
+        role: "developer",
+        permissions: [
+            "create_feature", "create_requirement", "create_entity", "create_endpoint",
+            "create_change", "approve_feature", "approve_requirement",
+            "sync_push", "sync_pull",
+        ],
+        max_approvals: 20,
+    },
+    {
+        role: "viewer",
+        permissions: [],
+        max_approvals: 0,
+    },
+];
+const CHANGE_TYPE_PERMISSIONS = {
+    feature: "approve_feature",
+    requirement: "approve_requirement",
+    architecture_component: "approve_architecture",
+    constraint: "approve_architecture",
+    decision: "modify_decision",
+    constitution: "modify_constitution",
+};
+export function loadPermissions(projectDir) {
+    const path = join(projectDir, PERMISSIONS_FILE);
+    if (!existsSync(path)) {
+        return {
+            roles: DEFAULT_ROLES,
+            approval_requirements: {
+                feature: 1,
+                requirement: 1,
+                architecture_component: 2,
+                breaking_change: 2,
+            },
+            audit_log: [],
+        };
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return {
+            roles: DEFAULT_ROLES,
+            approval_requirements: {},
+            audit_log: [],
+        };
+    }
+}
+export function savePermissions(projectDir, config) {
+    const path = join(projectDir, PERMISSIONS_FILE);
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, JSON.stringify(config, null, 2), "utf-8");
+}
+export function checkPermission(userRole, permission, projectDir) {
+    const config = loadPermissions(projectDir);
+    const roleConfig = config.roles.find((r) => r.role === userRole);
+    if (!roleConfig)
+        return false;
+    return roleConfig.permissions.includes(permission);
+}
+export function checkChangeApproval(changeType, userRole, projectDir) {
+    const permission = CHANGE_TYPE_PERMISSIONS[changeType];
+    if (!permission)
+        return true;
+    return checkPermission(userRole, permission, projectDir);
+}
+export function getRequiredApprovals(changeType, projectDir) {
+    const config = loadPermissions(projectDir);
+    return config.approval_requirements[changeType] || 1;
+}
+export function addAuditEntry(projectDir, user, action, target, result, details) {
+    const auditPath = join(projectDir, AUDIT_LOG_FILE);
+    const dir = dirname(auditPath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    let entries = [];
+    if (existsSync(auditPath)) {
+        try {
+            entries = JSON.parse(readFileSync(auditPath, "utf-8"));
+        }
+        catch {
+            entries = [];
+        }
+    }
+    entries.push({
+        id: `audit_${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        user,
+        action,
+        target,
+        result,
+        details,
+    });
+    if (entries.length > 1000) {
+        entries = entries.slice(-1000);
+    }
+    writeFileSync(auditPath, JSON.stringify(entries, null, 2), "utf-8");
+}
+/** Cache for audit log reads. Key: projectDir. */
+const auditLogCache = new Map();
+export function getAuditLog(projectDir, filters) {
+    const auditPath = join(projectDir, AUDIT_LOG_FILE);
+    if (!existsSync(auditPath))
+        return [];
+    try {
+        let entries = JSON.parse(readFileSync(auditPath, "utf-8"));
+        if (filters?.user) {
+            entries = entries.filter((e) => e.user === filters.user);
+        }
+        if (filters?.action) {
+            entries = entries.filter((e) => e.action === filters.action);
+        }
+        if (filters?.target) {
+            entries = entries.filter((e) => e.target === filters.target);
+        }
+        if (filters?.result) {
+            entries = entries.filter((e) => e.result === filters.result);
+        }
+        if (filters?.dateFrom) {
+            entries = entries.filter((e) => e.timestamp >= filters.dateFrom);
+        }
+        if (filters?.dateTo) {
+            entries = entries.filter((e) => e.timestamp <= filters.dateTo);
+        }
+        if (filters?.maxEntries) {
+            entries = entries.slice(-filters.maxEntries);
+        }
+        else if (filters?.limit) {
+            entries = entries.slice(-filters.limit);
+        }
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+export function setRole(projectDir, user, role) {
+    const usersFile = join(projectDir, ".sdd", "users.json");
+    let users = {};
+    if (existsSync(usersFile)) {
+        try {
+            users = JSON.parse(readFileSync(usersFile, "utf-8"));
+        }
+        catch {
+            users = {};
+        }
+    }
+    users[user] = role;
+    writeFileSync(usersFile, JSON.stringify(users, null, 2), "utf-8");
+    addAuditEntry(projectDir, "system", "set_role", user, "allowed", `Role set to ${role}`);
+}
+export function getUserRole(projectDir, user) {
+    const usersFile = join(projectDir, ".sdd", "users.json");
+    if (!existsSync(usersFile))
+        return "viewer";
+    try {
+        const users = JSON.parse(readFileSync(usersFile, "utf-8"));
+        return users[user] || "viewer";
+    }
+    catch {
+        return "viewer";
+    }
+}
+export function detectRemote(projectDir) {
+    try {
+        const remoteUrl = execSync("git remote get-url origin", {
+            cwd: projectDir,
+            encoding: "utf-8",
+            timeout: 5000,
+        }).trim();
+        if (!remoteUrl)
+            return null;
+        let provider = null;
+        let owner = "";
+        let repo = "";
+        if (remoteUrl.includes("github.com")) {
+            provider = "github";
+            const match = remoteUrl.match(/github\.com[:/](.+?)\/(.+?)(?:\.git)?$/);
+            if (match) {
+                owner = match[1];
+                repo = match[2];
+            }
+        }
+        else if (remoteUrl.includes("gitlab.com")) {
+            provider = "gitlab";
+            const match = remoteUrl.match(/gitlab\.com[:/](.+?)\/(.+?)(?:\.git)?$/);
+            if (match) {
+                owner = match[1];
+                repo = match[2];
+            }
+        }
+        if (!provider || !owner || !repo)
+            return null;
+        const token = process.env.GITHUB_TOKEN || process.env.GITLAB_TOKEN || "";
+        return {
+            provider,
+            owner,
+            repo,
+            token,
+            branch: "main",
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function fetchRemoteUser(projectDir, username) {
+    const remote = detectRemote(projectDir);
+    if (!remote || !remote.token)
+        return null;
+    try {
+        if (remote.provider === "github") {
+            const response = execSync(`curl -s -H "Authorization: token ${remote.token}" "https://api.github.com/repos/${remote.owner}/${remote.repo}/collaborators/${username}/permission"`, { cwd: projectDir, encoding: "utf-8", timeout: 10000 });
+            const data = JSON.parse(response);
+            if (!data.permission)
+                return null;
+            const role = data.permission === "admin" ? "admin"
+                : data.permission === "write" ? "developer"
+                    : data.permission === "read" ? "viewer"
+                        : "viewer";
+            return {
+                login: username,
+                id: 0,
+                role,
+                permissions: {
+                    admin: data.permission === "admin",
+                    push: data.permission === "admin" || data.permission === "write",
+                    pull: true,
+                },
+            };
+        }
+        if (remote.provider === "gitlab") {
+            const response = execSync(`curl -s -H "PRIVATE-TOKEN: ${remote.token}" "https://gitlab.com/api/v4/projects/${encodeURIComponent(`${remote.owner}/${remote.repo}`)}/members/all/${username}"`, { cwd: projectDir, encoding: "utf-8", timeout: 10000 });
+            const data = JSON.parse(response);
+            if (!data.access_level)
+                return null;
+            const role = data.access_level >= 50 ? "admin"
+                : data.access_level >= 30 ? "developer"
+                    : data.access_level >= 10 ? "viewer"
+                        : "viewer";
+            return {
+                login: username,
+                id: data.id,
+                role,
+                permissions: {
+                    admin: data.access_level >= 50,
+                    push: data.access_level >= 30,
+                    pull: data.access_level >= 10,
+                },
+            };
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export function getUserRoleWithAuth(projectDir, user) {
+    const localRole = getUserRole(projectDir, user);
+    if (localRole !== "viewer")
+        return localRole;
+    const remoteUser = fetchRemoteUser(projectDir, user);
+    if (remoteUser) {
+        return remoteUser.role;
+    }
+    const remote = detectRemote(projectDir);
+    if (remote && remote.token) {
+        return "viewer";
+    }
+    return "admin";
+}
+export function formatRemoteStatus(remote) {
+    if (!remote)
+        return "No remote configured";
+    const lines = [
+        `**Provider:** ${remote.provider}`,
+        `**Repository:** ${remote.owner}/${remote.repo}`,
+        `**Token:** ${remote.token ? "✅ Configured" : "❌ Not configured"}`,
+    ];
+    return lines.join("\n");
+}
+export function formatPermissionCheck(user, role, permission, allowed) {
+    const status = allowed ? "✅" : "❌";
+    return `${status} User **${user}** (${role}) → ${permission}: ${allowed ? "ALLOWED" : "DENIED"}`;
+}
+export function formatAuditLog(entries) {
+    const lines = [
+        "## Audit Log",
+        "",
+    ];
+    if (entries.length === 0) {
+        lines.push("No audit entries found.");
+        return lines.join("\n");
+    }
+    for (const entry of entries.slice(-20)) {
+        const status = entry.result === "allowed" ? "✅" : "❌";
+        lines.push(`- ${status} **${entry.user}** ${entry.action} → ${entry.target} (${entry.timestamp})`);
+        if (entry.details) {
+            lines.push(`  ${entry.details}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=access.js.map

package/dist/sdd/permissions/access.js.map

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

package/dist/sdd/persistence/repository.d.ts

@@ -0,0 +1,60 @@
+import type { KnowledgeGraph, AnyNode, NodeType, NodeStatus, Relationship } from "../domain/types.js";
+import { type SddConfig } from "../domain/types.js";
+import { GraphIndices } from "../graph/index.js";
+/**
+ * Unified interface for graph storage.
+ * Both YAML and SQLite implementations satisfy this contract.
+ */
+export interface GraphRepository {
+    /** Check if SDD is initialized (graph file/db exists) */
+    isInitialized(): boolean;
+    /** Load the full graph into memory */
+    loadGraph(): KnowledgeGraph;
+    /** Save the full graph (and update cache/indices) */
+    saveGraph(graph: KnowledgeGraph): void;
+    /** Get pre-computed indices for O(1) queries */
+    getIndices(): GraphIndices;
+    /** Get the underlying storage type */
+    getStorageType(): "yaml" | "sqlite";
+    /** Check if the cache is still valid */
+    isCacheValid(): boolean;
+    /** Invalidate the in-memory cache */
+    invalidateCache(): void;
+    /** Ensure the .sdd directory structure exists */
+    ensureSddDir(): void;
+    /** Create a new project graph */
+    createProject(projectId: string, name: string, description?: string): KnowledgeGraph;
+    /** Create a snapshot of the current state */
+    createSnapshot(description: string): string;
+    /** List available snapshots */
+    listSnapshots(): string[];
+    /** Migrate to a different storage backend */
+    migrateTo(target: "yaml" | "sqlite", projectDir: string): GraphRepository;
+    /** Get node count without loading full graph (optimized) */
+    getNodeCount(): number;
+    /** Get relationship count without loading full graph (optimized) */
+    getRelationshipCount(): number;
+    /** Get nodes by type without loading full graph (optimized for large graphs) */
+    getNodesByType?(type: NodeType): AnyNode[];
+    /** Get nodes by status without loading full graph (optimized for large graphs) */
+    getNodesByStatus?(status: NodeStatus): AnyNode[];
+    /** Get a single node by ID without loading full graph (optimized for large graphs) */
+    getNodeById?(id: string): AnyNode | undefined;
+    /** Get relationships for a node without loading full graph (optimized for large graphs) */
+    getRelationshipsForNode?(nodeId: string): Relationship[];
+}
+/**
+ * Auto-detect the best storage backend and return a repository.
+ *
+ * Decision logic:
+ * - If .sdd/graph.db exists → use SQLite
+ * - If .sdd/graph.yaml exists and <1000 nodes → use YAML
+ * - If .sdd/graph.yaml exists and ≥1000 nodes → auto-migrate to SQLite
+ * - If neither exists → return YAML (default for new projects)
+ */
+export declare function createRepository(projectDir: string): GraphRepository;
+/**
+ * Load the SDD configuration, falling back to defaults.
+ */
+export declare function loadSddConfig(projectDir: string): SddConfig;
+//# sourceMappingURL=repository.d.ts.map

package/dist/sdd/persistence/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/sdd/persistence/repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACrG,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIhD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,aAAa,IAAI,OAAO,CAAA;IAExB,sCAAsC;IACtC,SAAS,IAAI,cAAc,CAAA;IAE3B,qDAAqD;IACrD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAEtC,gDAAgD;IAChD,UAAU,IAAI,YAAY,CAAA;IAE1B,sCAAsC;IACtC,cAAc,IAAI,MAAM,GAAG,QAAQ,CAAA;IAEnC,wCAAwC;IACxC,YAAY,IAAI,OAAO,CAAA;IAEvB,qCAAqC;IACrC,eAAe,IAAI,IAAI,CAAA;IAEvB,iDAAiD;IACjD,YAAY,IAAI,IAAI,CAAA;IAEpB,iCAAiC;IACjC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,CAAA;IAEpF,6CAA6C;IAC7C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;IAE3C,+BAA+B;IAC/B,aAAa,IAAI,MAAM,EAAE,CAAA;IAEzB,6CAA6C;IAC7C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAAA;IAEzE,4DAA4D;IAC5D,YAAY,IAAI,MAAM,CAAA;IAEtB,oEAAoE;IACpE,oBAAoB,IAAI,MAAM,CAAA;IAE9B,gFAAgF;IAChF,cAAc,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,EAAE,CAAA;IAE1C,kFAAkF;IAClF,gBAAgB,CAAC,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,EAAE,CAAA;IAEhD,sFAAsF;IACtF,WAAW,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IAE7C,2FAA2F;IAC3F,uBAAuB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAAA;CACzD;AAID;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAyBpE;AA0CD;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAkB3D"}

package/dist/sdd/persistence/repository.js

@@ -0,0 +1,96 @@
+import { DEFAULT_SDD_CONFIG } from "../domain/types.js";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+const MIGRATION_THRESHOLD = 1000;
+/**
+ * Auto-detect the best storage backend and return a repository.
+ *
+ * Decision logic:
+ * - If .sdd/graph.db exists → use SQLite
+ * - If .sdd/graph.yaml exists and <1000 nodes → use YAML
+ * - If .sdd/graph.yaml exists and ≥1000 nodes → auto-migrate to SQLite
+ * - If neither exists → return YAML (default for new projects)
+ */
+export function createRepository(projectDir) {
+    const sddDir = join(projectDir, ".sdd");
+    const yamlPath = join(sddDir, "graph.yaml");
+    const dbPath = join(sddDir, "graph.db");
+    // If SQLite already exists, use it
+    if (existsSync(dbPath)) {
+        const { SqliteGraphRepository } = require("./sqlite.js");
+        return new SqliteGraphRepository(projectDir);
+    }
+    // If YAML exists, check if migration is needed
+    if (existsSync(yamlPath)) {
+        const nodeCount = countNodesInYaml(yamlPath);
+        if (nodeCount >= MIGRATION_THRESHOLD) {
+            // Auto-migrate to SQLite
+            return autoMigrateToSqlite(projectDir);
+        }
+        const { YamlGraphRepository } = require("./yaml.js");
+        return new YamlGraphRepository(projectDir);
+    }
+    // Default: YAML for new projects
+    const { YamlGraphRepository } = require("./yaml.js");
+    return new YamlGraphRepository(projectDir);
+}
+/**
+ * Quick node count from YAML without full parse.
+ * Reads the file and counts node entries approximately.
+ */
+function countNodesInYaml(yamlPath) {
+    try {
+        const content = readFileSync(yamlPath, "utf-8");
+        // Count "- id:" occurrences which indicates node entries
+        const matches = content.match(/^  - id:/gm);
+        return matches ? matches.length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Auto-migrate from YAML to SQLite.
+ * Reads the YAML graph, writes to SQLite, returns SQLite repository.
+ */
+function autoMigrateToSqlite(projectDir) {
+    const { YamlGraphRepository } = require("./yaml.js");
+    const { SqliteGraphRepository } = require("./sqlite.js");
+    const yamlRepo = new YamlGraphRepository(projectDir);
+    const graph = yamlRepo.loadGraph();
+    const sqliteRepo = new SqliteGraphRepository(projectDir);
+    sqliteRepo.saveGraph(graph);
+    // Keep YAML as backup
+    const yamlPath = join(projectDir, ".sdd", "graph.yaml.bak");
+    try {
+        const { writeFileSync } = require("fs");
+        const yaml = require("js-yaml");
+        writeFileSync(yamlPath, yaml.dump(graph, { noRefs: true, lineWidth: 120 }));
+    }
+    catch { }
+    return sqliteRepo;
+}
+/**
+ * Load the SDD configuration, falling back to defaults.
+ */
+export function loadSddConfig(projectDir) {
+    const configPath = join(projectDir, ".sdd", "config.json");
+    if (existsSync(configPath)) {
+        try {
+            const content = readFileSync(configPath, "utf-8");
+            const parsed = JSON.parse(content);
+            return {
+                ...DEFAULT_SDD_CONFIG,
+                ...parsed,
+                dashboard: { ...DEFAULT_SDD_CONFIG.dashboard, ...(parsed.dashboard || {}) },
+                workflow: { ...DEFAULT_SDD_CONFIG.workflow, ...(parsed.workflow || {}) },
+                graph: { ...DEFAULT_SDD_CONFIG.graph, ...(parsed.graph || {}) },
+                git: { ...DEFAULT_SDD_CONFIG.git, ...(parsed.git || {}) },
+                validation: { ...DEFAULT_SDD_CONFIG.validation, ...(parsed.validation || {}) },
+            };
+        }
+        catch { }
+    }
+    return DEFAULT_SDD_CONFIG;
+}
+//# sourceMappingURL=repository.js.map

package/dist/sdd/persistence/repository.js.map

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

package/dist/sdd/persistence/sqlite.d.ts

@@ -0,0 +1,122 @@
+import type { KnowledgeGraph, AnyNode, NodeType, NodeStatus, Relationship } from "../domain/types.js";
+import { GraphIndices } from "../graph/index.js";
+import type { GraphRepository } from "./repository.js";
+/**
+ * SQLite-backed graph repository.
+ * Uses Bun's built-in SQLite for storage with native indexing.
+ *
+ * Benefits over YAML:
+ * - O(log n) queries by type/status/id (indexed)
+ * - Atomic writes via transactions
+ * - Lazy loading: can query subsets without loading full graph
+ * - Better concurrency for multi-process scenarios
+ * - Handles 10,000+ nodes efficiently
+ */
+export declare class SqliteGraphRepository {
+    private baseDir;
+    private dbPath;
+    private db;
+    private static cache;
+    constructor(projectDir: string);
+    private getDb;
+    isInitialized(): boolean;
+    loadGraph(): KnowledgeGraph;
+    saveGraph(graph: KnowledgeGraph): void;
+    getIndices(): GraphIndices;
+    getStorageType(): "sqlite";
+    isCacheValid(): boolean;
+    invalidateCache(): void;
+    ensureSddDir(): void;
+    createProject(projectId: string, name: string, description?: string): KnowledgeGraph;
+    createSnapshot(description: string): string;
+    listSnapshots(): string[];
+    migrateTo(target: "yaml" | "sqlite", projectDir: string): GraphRepository;
+    getNodeCount(): number;
+    getRelationshipCount(): number;
+    getNodesByType(type: NodeType): AnyNode[];
+    getNodesByStatus(status: NodeStatus): AnyNode[];
+    getNodeById(id: string): AnyNode | undefined;
+    getRelationshipsForNode(nodeId: string): Relationship[];
+    /**
+     * Search nodes by text using SQLite's LIKE (fast with index).
+     */
+    searchNodes(query: string, type?: NodeType): AnyNode[];
+    /**
+     * Get counts only — O(1), no graph load.
+     */
+    getGraphCounts(): {
+        nodeCount: number;
+        relCount: number;
+    };
+    /**
+     * Get graph metadata only — O(1), no node/rel load.
+     */
+    getMetadata(): Record<string, string>;
+    /**
+     * Get paginated node summary (id, type, name, status, version).
+     * Lightweight — no metadata/description loaded.
+     */
+    getNodesSummary(offset: number, limit: number, type?: string): {
+        nodes: Array<{
+            id: string;
+            type: string;
+            name: string;
+            status: string;
+            version: number;
+        }>;
+        total: number;
+    };
+    /**
+     * Get paginated relationships (id, from, to, type).
+     * Lightweight — no metadata loaded.
+     */
+    getRelationshipsSummary(offset: number, limit: number): {
+        relationships: Array<{
+            id: string;
+            from: string;
+            to: string;
+            type: string;
+        }>;
+        total: number;
+    };
+    /**
+     * Get all node types with counts — O(n) but lightweight (no metadata).
+     */
+    getNodeTypeCounts(): Array<{
+        type: string;
+        count: number;
+    }>;
+    /**
+     * Get all status counts — O(n) but lightweight.
+     */
+    getStatusCounts(): Array<{
+        status: string;
+        count: number;
+    }>;
+    /**
+     * Get all nodes (for small graphs or when full data is needed).
+     * Returns just the dashboard-relevant fields.
+     */
+    getAllNodesSummary(): Array<{
+        id: string;
+        type: string;
+        name: string;
+        status: string;
+        version: number;
+    }>;
+    /**
+     * Get all relationships (for small graphs or when full data is needed).
+     * Returns just the dashboard-relevant fields.
+     */
+    getAllRelationshipsSummary(): Array<{
+        id: string;
+        from: string;
+        to: string;
+        type: string;
+    }>;
+    /**
+     * Get updated_at timestamp — O(1).
+     */
+    getUpdatedAt(): string;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/sdd/persistence/sqlite.d.ts.map

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