opencode-telos 1.0.0

package/dist/sdd/promises/classifier.js.map

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

package/dist/sdd/promises/tracker.d.ts

@@ -0,0 +1,20 @@
+import type { KnowledgeGraph, SpecPromise } from "../domain/types.js";
+import { type DependencyRule } from "./classifier.js";
+export interface PromiseReport {
+    total: number;
+    pending: number;
+    fulfilled: number;
+    violated: number;
+    unverifiable: number;
+    fulfillment_rate: number;
+    promises: SpecPromise[];
+}
+export declare function extractPromises(graph: KnowledgeGraph, options?: {
+    autoClassify?: boolean;
+    customRules?: DependencyRule[];
+}): SpecPromise[];
+export declare function verifyPromise(graph: KnowledgeGraph, promiseId: string, evidence: string): SpecPromise | null;
+export declare function markPromiseViolated(graph: KnowledgeGraph, promiseId: string): SpecPromise | null;
+export declare function getPromiseReport(graph: KnowledgeGraph): PromiseReport;
+export declare function formatPromiseReport(report: PromiseReport): string;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/sdd/promises/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/sdd/promises/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAqC,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGxG,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEnF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,WAAW,EAAE,CAAA;CACxB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAA;CAAE,GACnE,WAAW,EAAE,CAwFf;AAoCD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,WAAW,GAAG,IAAI,CAiBpB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,GAChB,WAAW,GAAG,IAAI,CAepB;AAyBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAkBrE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA6BjE"}

package/dist/sdd/promises/tracker.js

@@ -0,0 +1,204 @@
+import { getNodesByType } from "../graph/engine.js";
+import { getExclusionSets, isNodeExcludedOrDeprecated } from "../drift/exclusion.js";
+import { classifyPromiseVerifiability } from "./classifier.js";
+export function extractPromises(graph, options) {
+    const promises = [];
+    const { removed, deprecated } = getExclusionSets(graph);
+    const autoClassify = options?.autoClassify ?? true;
+    const customRules = options?.customRules;
+    // Build a map of persisted promise states from node metadata
+    const persistedStates = buildPersistedPromiseStates(graph);
+    const requirements = getNodesByType(graph, "requirement")
+        .filter((r) => !isNodeExcludedOrDeprecated(r.id, r.status, removed, deprecated));
+    for (const req of requirements) {
+        const criteria = req.metadata.acceptance_criteria || [];
+        for (let i = 0; i < criteria.length; i++) {
+            const criterion = criteria[i];
+            if (typeof criterion !== "string")
+                continue;
+            const promiseId = `PRM-${req.id}-${String(i + 1).padStart(3, "0")}`;
+            const persisted = persistedStates.get(promiseId);
+            let status = persisted?.status || "pending";
+            // Auto-classify unverifiable if infrastructure is missing
+            if (autoClassify && status === "pending") {
+                const classification = classifyPromiseVerifiability(criterion, graph, customRules);
+                if (!classification.verifiable) {
+                    status = "unverifiable";
+                }
+            }
+            promises.push({
+                id: promiseId,
+                description: criterion,
+                source_node_id: req.id,
+                status,
+                evidence: persisted?.evidence,
+                verified_at: persisted?.verified_at,
+            });
+        }
+        if (criteria.length === 0 && req.description) {
+            const promiseId = `PRM-${req.id}-DESC`;
+            const persisted = persistedStates.get(promiseId);
+            let status = persisted?.status || "pending";
+            if (autoClassify && status === "pending") {
+                const classification = classifyPromiseVerifiability(req.description, graph, customRules);
+                if (!classification.verifiable) {
+                    status = "unverifiable";
+                }
+            }
+            promises.push({
+                id: promiseId,
+                description: req.description,
+                source_node_id: req.id,
+                status,
+                evidence: persisted?.evidence,
+                verified_at: persisted?.verified_at,
+            });
+        }
+    }
+    const rules = getNodesByType(graph, "business_rule")
+        .filter((r) => !isNodeExcludedOrDeprecated(r.id, r.status, removed, deprecated));
+    for (const rule of rules) {
+        if (rule.metadata.rule_text) {
+            const promiseId = `PRM-${rule.id}`;
+            const persisted = persistedStates.get(promiseId);
+            let status = persisted?.status || "pending";
+            if (autoClassify && status === "pending") {
+                const classification = classifyPromiseVerifiability(rule.metadata.rule_text, graph, customRules);
+                if (!classification.verifiable) {
+                    status = "unverifiable";
+                }
+            }
+            promises.push({
+                id: promiseId,
+                description: rule.metadata.rule_text,
+                source_node_id: rule.id,
+                status,
+                evidence: persisted?.evidence,
+                verified_at: persisted?.verified_at,
+            });
+        }
+    }
+    return promises;
+}
+/**
+ * Build a map of persisted promise states from node metadata.
+ * Promise states are stored in the node's metadata.promise_states object.
+ */
+function buildPersistedPromiseStates(graph) {
+    const states = new Map();
+    // Check requirement nodes for promise states
+    const requirements = graph.nodes.filter(n => n.type === "requirement");
+    for (const req of requirements) {
+        const meta = req.metadata;
+        const promiseStates = meta.promise_states;
+        if (promiseStates) {
+            for (const [promiseId, state] of Object.entries(promiseStates)) {
+                states.set(promiseId, state);
+            }
+        }
+    }
+    // Check business_rule nodes for promise states
+    const rules = graph.nodes.filter(n => n.type === "business_rule");
+    for (const rule of rules) {
+        const meta = rule.metadata;
+        const promiseStates = meta.promise_states;
+        if (promiseStates) {
+            for (const [promiseId, state] of Object.entries(promiseStates)) {
+                states.set(promiseId, state);
+            }
+        }
+    }
+    return states;
+}
+export function verifyPromise(graph, promiseId, evidence) {
+    const allPromises = extractPromises(graph);
+    const promise = allPromises.find((p) => p.id === promiseId);
+    if (!promise)
+        return null;
+    promise.status = "fulfilled";
+    promise.evidence = evidence;
+    promise.verified_at = new Date().toISOString();
+    // Persist the state in the source node's metadata
+    persistPromiseState(graph, promise.source_node_id, promiseId, {
+        status: "fulfilled",
+        evidence,
+        verified_at: promise.verified_at,
+    });
+    return promise;
+}
+export function markPromiseViolated(graph, promiseId) {
+    const allPromises = extractPromises(graph);
+    const promise = allPromises.find((p) => p.id === promiseId);
+    if (!promise)
+        return null;
+    promise.status = "violated";
+    promise.verified_at = new Date().toISOString();
+    // Persist the state in the source node's metadata
+    persistPromiseState(graph, promise.source_node_id, promiseId, {
+        status: "violated",
+        verified_at: promise.verified_at,
+    });
+    return promise;
+}
+/**
+ * Persist a promise state in the source node's metadata.
+ * This ensures promise verification survives session restarts.
+ */
+function persistPromiseState(graph, sourceNodeId, promiseId, state) {
+    const node = graph.nodes.find(n => n.id === sourceNodeId);
+    if (!node)
+        return;
+    const meta = node.metadata;
+    if (!meta.promise_states) {
+        meta.promise_states = {};
+    }
+    ;
+    meta.promise_states[promiseId] = state;
+    // Update graph timestamp for cross-process cache invalidation
+    graph.metadata.updated_at = new Date().toISOString();
+}
+export function getPromiseReport(graph) {
+    const promises = extractPromises(graph);
+    const pending = promises.filter((p) => p.status === "pending").length;
+    const fulfilled = promises.filter((p) => p.status === "fulfilled").length;
+    const violated = promises.filter((p) => p.status === "violated").length;
+    const unverifiable = promises.filter((p) => p.status === "unverifiable").length;
+    const verifiable = promises.length - unverifiable;
+    return {
+        total: promises.length,
+        pending,
+        fulfilled,
+        violated,
+        unverifiable,
+        fulfillment_rate: verifiable > 0 ? fulfilled / verifiable : 1,
+        promises,
+    };
+}
+export function formatPromiseReport(report) {
+    const lines = [
+        `## Promise Report`,
+        `**Total:** ${report.total}`,
+        `**Pending:** ${report.pending}`,
+        `**Fulfilled:** ${report.fulfilled}`,
+        `**Violated:** ${report.violated}`,
+        `**Unverifiable:** ${report.unverifiable}`,
+        `**Fulfillment Rate:** ${(report.fulfillment_rate * 100).toFixed(1)}%`,
+    ];
+    if (report.violated > 0) {
+        lines.push("\n### Violated Promises");
+        for (const p of report.promises.filter((p) => p.status === "violated")) {
+            lines.push(`- **${p.id}** (${p.source_node_id}): ${p.description}`);
+        }
+    }
+    if (report.pending > 0) {
+        lines.push("\n### Pending Promises");
+        for (const p of report.promises.filter((p) => p.status === "pending").slice(0, 10)) {
+            lines.push(`- **${p.id}** (${p.source_node_id}): ${p.description}`);
+        }
+        if (report.pending > 10) {
+            lines.push(`- ... and ${report.pending - 10} more`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=tracker.js.map

package/dist/sdd/promises/tracker.js.map

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

package/dist/sdd/quality/scorer.d.ts

@@ -0,0 +1,44 @@
+import type { KnowledgeGraph } from "../domain/types.js";
+export interface QualityFactor {
+    name: string;
+    score: number;
+    weight: number;
+    details: string;
+}
+export interface QualityReport {
+    score: number;
+    trend: "improving" | "stable" | "declining";
+    factors: QualityFactor[];
+    history: Array<{
+        timestamp: string;
+        score: number;
+    }>;
+}
+/**
+ * Options for controlling quality scoring scope.
+ */
+export interface QualityScoringOptions {
+    /** Only calculate these specific factors. */
+    focusFactors?: string[];
+    /** Skip these factors (use cached results instead). */
+    skipFactors?: string[];
+    /** Skip drift detection (uses cached result). */
+    skipDrift?: boolean;
+    /** Skip promise calculation (uses cached result). */
+    skipPromises?: boolean;
+    /** Skip constitution check (uses cached result). */
+    skipConstitution?: boolean;
+    /** Skip validation (uses cached result). */
+    skipValidation?: boolean;
+    /** Cache for individual factor scores (factor_name → score). Reuse if provided. */
+    factorCache?: Map<string, {
+        score: number;
+        details: string;
+        timestamp: number;
+    }>;
+    /** Maximum age in ms for cached factors to be considered fresh (default: 60000 = 1 min). */
+    cacheMaxAge?: number;
+}
+export declare function calculateQualityScore(graph: KnowledgeGraph, projectDir: string, options?: QualityScoringOptions): QualityReport;
+export declare function formatQualityReport(report: QualityReport): string;
+//# sourceMappingURL=scorer.d.ts.map

package/dist/sdd/quality/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../../src/sdd/quality/scorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAUxD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;IAC3C,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,mFAAmF;IACnF,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChF,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAcD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CA6If;AAmCD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAwBjE"}

package/dist/sdd/quality/scorer.js

@@ -0,0 +1,216 @@
+import { getNodesByType } from "../graph/engine.js";
+import { getExclusionSets, isNodeExcludedOrDeprecated } from "../drift/exclusion.js";
+import { validateGraph } from "../validation/validator.js";
+import { detectDrift } from "../drift/detector.js";
+import { getPromiseReport } from "../promises/tracker.js";
+import { validateAgainstConstitution } from "../constitution/validator.js";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+const HISTORY_FILE = ".sdd/quality-history.json";
+const MAX_HISTORY = 20;
+const FACTOR_WEIGHTS = {
+    validation: 0.25,
+    drift: 0.20,
+    promises: 0.20,
+    completeness: 0.15,
+    constitution: 0.10,
+    coverage: 0.10,
+};
+export function calculateQualityScore(graph, projectDir, options) {
+    const factors = [];
+    const focusSet = options?.focusFactors ? new Set(options.focusFactors) : null;
+    const skipSet = options?.skipFactors ? new Set(options.skipFactors) : null;
+    const shouldInclude = (name) => {
+        if (skipSet?.has(name))
+            return false;
+        if (focusSet && !focusSet.has(name))
+            return false;
+        return true;
+    };
+    const getCachedFactor = (name) => {
+        if (!options?.factorCache)
+            return null;
+        const cached = options.factorCache.get(name);
+        if (!cached)
+            return null;
+        const maxAge = options.cacheMaxAge ?? 60000;
+        if (Date.now() - cached.timestamp > maxAge)
+            return null; // Expired
+        return { name, score: cached.score, weight: FACTOR_WEIGHTS[name] || 0.1, details: cached.details };
+    };
+    const setCachedFactor = (name, score, details) => {
+        if (options?.factorCache) {
+            options.factorCache.set(name, { score, details, timestamp: Date.now() });
+        }
+    };
+    // Validation factor
+    if (shouldInclude("validation")) {
+        const cached = getCachedFactor("validation");
+        if (cached) {
+            factors.push(cached);
+        }
+        else if (!options?.skipValidation) {
+            const validation = validateGraph(graph);
+            const validationScore = validation.errors.length === 0 ? 1 : Math.max(0, 1 - validation.errors.length / Math.max(graph.nodes.length, 1));
+            const details = `${validation.errors.length} errors, ${validation.warnings.length} warnings`;
+            factors.push({ name: "validation", score: validationScore, weight: FACTOR_WEIGHTS.validation, details });
+            setCachedFactor("validation", validationScore, details);
+        }
+        else {
+            factors.push({ name: "validation", score: 1, weight: FACTOR_WEIGHTS.validation, details: "Skipped (cached)" });
+        }
+    }
+    // Drift factor
+    if (shouldInclude("drift")) {
+        const cached = getCachedFactor("drift");
+        if (cached) {
+            factors.push(cached);
+        }
+        else if (!options?.skipDrift) {
+            const drift = detectDrift(graph, projectDir);
+            const driftItems = drift.missing_files.length + drift.untracked_files.length + drift.spec_code_mismatches.length;
+            const driftScore = driftItems === 0 ? 1 : Math.max(0, 1 - driftItems / Math.max(graph.nodes.length, 1));
+            const details = `${driftItems} drift items detected`;
+            factors.push({ name: "drift", score: driftScore, weight: FACTOR_WEIGHTS.drift, details });
+            setCachedFactor("drift", driftScore, details);
+        }
+        else {
+            factors.push({ name: "drift", score: 1, weight: FACTOR_WEIGHTS.drift, details: "Skipped (cached)" });
+        }
+    }
+    // Promises factor
+    if (shouldInclude("promises")) {
+        const cached = getCachedFactor("promises");
+        if (cached) {
+            factors.push(cached);
+        }
+        else if (!options?.skipPromises) {
+            const promiseReport = getPromiseReport(graph);
+            const promisesScore = promiseReport.total === 0 ? 1 : promiseReport.fulfillment_rate;
+            const details = `${promiseReport.fulfilled}/${promiseReport.total} fulfilled (${(promiseReport.fulfillment_rate * 100).toFixed(0)}%)`;
+            factors.push({ name: "promises", score: promisesScore, weight: FACTOR_WEIGHTS.promises, details });
+            setCachedFactor("promises", promisesScore, details);
+        }
+        else {
+            factors.push({ name: "promises", score: 1, weight: FACTOR_WEIGHTS.promises, details: "Skipped (cached)" });
+        }
+    }
+    // Completeness factor
+    if (shouldInclude("completeness")) {
+        const cached = getCachedFactor("completeness");
+        if (cached) {
+            factors.push(cached);
+        }
+        else {
+            const expectedTypes = ["project", "feature", "requirement", "entity", "api"];
+            const presentTypes = expectedTypes.filter((t) => graph.nodes.some((n) => n.type === t));
+            const completenessScore = presentTypes.length / expectedTypes.length;
+            const details = `${presentTypes.length}/${expectedTypes.length} expected node types present`;
+            factors.push({ name: "completeness", score: completenessScore, weight: FACTOR_WEIGHTS.completeness, details });
+            setCachedFactor("completeness", completenessScore, details);
+        }
+    }
+    // Constitution factor
+    if (shouldInclude("constitution")) {
+        const cached = getCachedFactor("constitution");
+        if (cached) {
+            factors.push(cached);
+        }
+        else if (!options?.skipConstitution) {
+            const constitutionResult = validateAgainstConstitution(graph);
+            const constitutionScore = constitutionResult.violations.length === 0 ? 1 : Math.max(0, 1 - constitutionResult.violations.length / Math.max(constitutionResult.total_principles, 1));
+            const details = `${constitutionResult.violations.length}/${constitutionResult.total_principles} principles violated`;
+            factors.push({ name: "constitution", score: constitutionScore, weight: FACTOR_WEIGHTS.constitution, details });
+            setCachedFactor("constitution", constitutionScore, details);
+        }
+        else {
+            factors.push({ name: "constitution", score: 1, weight: FACTOR_WEIGHTS.constitution, details: "Skipped (cached)" });
+        }
+    }
+    // Coverage factor
+    if (shouldInclude("coverage")) {
+        const cached = getCachedFactor("coverage");
+        if (cached) {
+            factors.push(cached);
+        }
+        else {
+            const { removed, deprecated } = getExclusionSets(graph);
+            const requirements = getNodesByType(graph, "requirement")
+                .filter((r) => !isNodeExcludedOrDeprecated(r.id, r.status, removed, deprecated));
+            const tests = getNodesByType(graph, "test");
+            const coverageScore = requirements.length === 0 ? 1 : Math.min(1, tests.length / requirements.length);
+            const details = `${tests.length} tests for ${requirements.length} requirements`;
+            factors.push({ name: "coverage", score: coverageScore, weight: FACTOR_WEIGHTS.coverage, details });
+            setCachedFactor("coverage", coverageScore, details);
+        }
+    }
+    // Renormalize weights if some factors were skipped
+    const totalWeight = factors.reduce((sum, f) => sum + f.weight, 0);
+    const totalScore = factors.reduce((sum, f) => sum + f.score * (f.weight / totalWeight), 0);
+    const finalScore = Math.round(totalScore * 100) / 100;
+    const history = loadHistory(projectDir);
+    const trend = calculateTrend(history, finalScore);
+    history.push({ timestamp: new Date().toISOString(), score: finalScore });
+    if (history.length > MAX_HISTORY)
+        history.splice(0, history.length - MAX_HISTORY);
+    saveHistory(projectDir, history);
+    return {
+        score: finalScore,
+        trend,
+        factors,
+        history,
+    };
+}
+function loadHistory(projectDir) {
+    const path = join(projectDir, HISTORY_FILE);
+    if (!existsSync(path))
+        return [];
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return [];
+    }
+}
+function saveHistory(projectDir, history) {
+    const path = join(projectDir, HISTORY_FILE);
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, JSON.stringify(history, null, 2), "utf-8");
+}
+function calculateTrend(history, _currentScore) {
+    if (history.length < 3)
+        return "stable";
+    const recent = history.slice(-5);
+    const avgRecent = recent.reduce((s, h) => s + h.score, 0) / recent.length;
+    const avgOlder = history.slice(0, -5).reduce((s, h) => s + h.score, 0) / Math.max(history.length - 5, 1);
+    const diff = avgRecent - avgOlder;
+    if (diff > 0.02)
+        return "improving";
+    if (diff < -0.02)
+        return "declining";
+    return "stable";
+}
+export function formatQualityReport(report) {
+    const trendEmoji = report.trend === "improving" ? "📈" : report.trend === "declining" ? "📉" : "➡️";
+    const scorePercent = (report.score * 100).toFixed(1);
+    const lines = [
+        `## Quality Score: ${scorePercent}% ${trendEmoji}`,
+        `**Trend:** ${report.trend}`,
+        "",
+        "### Factors",
+    ];
+    for (const f of report.factors) {
+        const bar = "█".repeat(Math.round(f.score * 10)) + "░".repeat(10 - Math.round(f.score * 10));
+        lines.push(`- **${f.name}** (${(f.weight * 100).toFixed(0)}%): ${bar} ${(f.score * 100).toFixed(0)}% — ${f.details}`);
+    }
+    if (report.history.length > 1) {
+        lines.push("\n### History (last 5)");
+        for (const h of report.history.slice(-5)) {
+            lines.push(`- ${h.timestamp.slice(0, 19)}: ${(h.score * 100).toFixed(1)}%`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=scorer.js.map

package/dist/sdd/quality/scorer.js.map

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

package/dist/sdd/rollback/manager.d.ts

@@ -0,0 +1,45 @@
+import type { KnowledgeGraph } from "../domain/types.js";
+export interface RollbackResult {
+    success: boolean;
+    method: "git" | "snapshot" | "backup" | "failed";
+    details: string;
+    restored_files?: string[];
+}
+export interface RollbackSnapshot {
+    id: string;
+    change_id: string;
+    timestamp: string;
+    graph_state: KnowledgeGraph;
+    backed_up_files: Array<{
+        path: string;
+        backup_path: string;
+    }>;
+}
+export interface RollbackHistory {
+    rollbacks: Array<{
+        id: string;
+        change_id: string;
+        timestamp: string;
+        method: string;
+        success: boolean;
+    }>;
+}
+export declare function createSnapshot(graph: KnowledgeGraph, changeId: string, projectDir: string): RollbackSnapshot;
+export declare function rollbackByGit(projectDir: string, changeId: string, options?: Pick<RollbackOptions, 'commitCache'>): RollbackResult;
+export declare function rollbackBySnapshot(graph: KnowledgeGraph, changeId: string, projectDir: string, options?: Pick<RollbackOptions, 'snapshotIndex'>): RollbackResult;
+export declare function rollbackByBackup(_graph: KnowledgeGraph, changeId: string, projectDir: string, options?: Pick<RollbackOptions, 'snapshotIndex'>): RollbackResult;
+export declare function executeRollback(graph: KnowledgeGraph, changeId: string, projectDir: string, options?: RollbackOptions): RollbackResult;
+export interface RollbackOptions {
+    /** Index for O(1) snapshot lookup (changeId → snapshotId). */
+    snapshotIndex?: Map<string, string>;
+    /** Only look for these specific change IDs. */
+    focusChangeId?: string[];
+    /** Cache for git commit lookups (changeId → commitHash). */
+    commitCache?: Map<string, string | null>;
+    /** Only look for commits matching these change IDs. */
+    focusChangeIds?: string[];
+}
+export declare function loadRollbackHistory(projectDir: string): RollbackHistory;
+export declare function formatRollbackResult(result: RollbackResult): string;
+export declare function formatRollbackHistory(history: RollbackHistory): string;
+//# sourceMappingURL=manager.d.ts.map

package/dist/sdd/rollback/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/sdd/rollback/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,oBAAoB,CAAA;AAMpE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAChD,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,cAAc,CAAA;IAC3B,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAA;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,OAAO,CAAA;KACjB,CAAC,CAAA;CACH;AAMD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,gBAAgB,CAkClB;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,GAC7C,cAAc,CAyBhB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAC/C,cAAc,CAwChB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAC/C,cAAc,CA4BhB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAsBhB;AA8BD,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;IACxC,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAqDD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAQvE;AASD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAiBnE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAiBtE"}