@weavelogic/knowledge-graph-agent 0.11.8 → 0.12.0

package/dist/sparc/decision-log.js

@@ -0,0 +1,325 @@
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("decision-log");
+class DecisionLogManager {
+  log;
+  options;
+  logPath;
+  constructor(options) {
+    this.options = {
+      autoSave: true,
+      ...options
+    };
+    this.logPath = join(this.options.outputDir, "decision-log.json");
+    this.log = this.loadOrCreate();
+  }
+  /**
+   * Load existing log or create new one
+   */
+  loadOrCreate() {
+    if (existsSync(this.logPath)) {
+      try {
+        const content = readFileSync(this.logPath, "utf-8");
+        const parsed = JSON.parse(content);
+        parsed.createdAt = new Date(parsed.createdAt);
+        parsed.updatedAt = new Date(parsed.updatedAt);
+        for (const decision of parsed.decisions) {
+          decision.createdAt = new Date(decision.createdAt);
+          decision.updatedAt = new Date(decision.updatedAt);
+        }
+        logger.info("Loaded existing decision log", {
+          decisions: parsed.decisions.length
+        });
+        return parsed;
+      } catch (error) {
+        logger.warn("Failed to load decision log, creating new", { error });
+      }
+    }
+    return this.createNewLog();
+  }
+  /**
+   * Create a new decision log
+   */
+  createNewLog() {
+    const now = /* @__PURE__ */ new Date();
+    return {
+      id: `dlog_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`,
+      planId: this.options.planId,
+      decisions: [],
+      statistics: {
+        total: 0,
+        approved: 0,
+        rejected: 0,
+        deferred: 0,
+        highConfidence: 0,
+        lowConfidence: 0,
+        consensusRequired: 0
+      },
+      createdAt: now,
+      updatedAt: now
+    };
+  }
+  /**
+   * Add a new decision to the log
+   */
+  addDecision(options) {
+    const now = /* @__PURE__ */ new Date();
+    const id = `dec_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+    const decision = {
+      id,
+      title: options.title,
+      description: options.description,
+      phase: options.phase,
+      status: "proposed",
+      confidence: options.confidence,
+      rationale: options.rationale,
+      alternatives: options.alternatives || [],
+      impact: options.impact || "Impact assessment pending",
+      stakeholders: options.stakeholders || [],
+      relatedDecisions: options.relatedDecisions || [],
+      consensus: options.consensus,
+      createdAt: now,
+      updatedAt: now,
+      decidedBy: options.decidedBy
+    };
+    this.log.decisions.push(decision);
+    this.updateStatistics();
+    this.log.updatedAt = now;
+    logger.info("Added decision", {
+      id: decision.id,
+      title: decision.title,
+      confidence: decision.confidence
+    });
+    if (this.options.autoSave) {
+      this.save();
+    }
+    return decision;
+  }
+  /**
+   * Update decision status
+   */
+  updateDecisionStatus(decisionId, status, notes) {
+    const decision = this.log.decisions.find((d) => d.id === decisionId);
+    if (!decision) {
+      logger.warn("Decision not found", { decisionId });
+      return false;
+    }
+    decision.status = status;
+    decision.updatedAt = /* @__PURE__ */ new Date();
+    if (notes) {
+      decision.rationale = `${decision.rationale}
+
+Update: ${notes}`;
+    }
+    this.updateStatistics();
+    this.log.updatedAt = /* @__PURE__ */ new Date();
+    logger.info("Updated decision status", {
+      id: decisionId,
+      status
+    });
+    if (this.options.autoSave) {
+      this.save();
+    }
+    return true;
+  }
+  /**
+   * Add consensus information to a decision
+   */
+  addConsensusInfo(decisionId, consensus) {
+    const decision = this.log.decisions.find((d) => d.id === decisionId);
+    if (!decision) {
+      logger.warn("Decision not found", { decisionId });
+      return false;
+    }
+    decision.consensus = consensus;
+    decision.updatedAt = /* @__PURE__ */ new Date();
+    if (consensus.achieved) {
+      decision.status = "approved";
+    }
+    this.updateStatistics();
+    this.log.updatedAt = /* @__PURE__ */ new Date();
+    logger.info("Added consensus info", {
+      id: decisionId,
+      achieved: consensus.achieved,
+      method: consensus.method
+    });
+    if (this.options.autoSave) {
+      this.save();
+    }
+    return true;
+  }
+  /**
+   * Get all decisions
+   */
+  getDecisions() {
+    return [...this.log.decisions];
+  }
+  /**
+   * Get decisions by phase
+   */
+  getDecisionsByPhase(phase) {
+    return this.log.decisions.filter((d) => d.phase === phase);
+  }
+  /**
+   * Get decisions by confidence level
+   */
+  getDecisionsByConfidence(confidence) {
+    return this.log.decisions.filter((d) => d.confidence === confidence);
+  }
+  /**
+   * Get low confidence decisions requiring review
+   */
+  getLowConfidenceDecisions() {
+    return this.log.decisions.filter(
+      (d) => d.confidence === "low" || d.confidence === "uncertain"
+    );
+  }
+  /**
+   * Get decisions requiring consensus
+   */
+  getDecisionsRequiringConsensus() {
+    return this.log.decisions.filter(
+      (d) => d.consensus?.required && !d.consensus?.achieved
+    );
+  }
+  /**
+   * Get decision by ID
+   */
+  getDecision(id) {
+    return this.log.decisions.find((d) => d.id === id);
+  }
+  /**
+   * Get the full log
+   */
+  getLog() {
+    return { ...this.log };
+  }
+  /**
+   * Get statistics
+   */
+  getStatistics() {
+    return { ...this.log.statistics };
+  }
+  /**
+   * Update statistics
+   */
+  updateStatistics() {
+    const decisions = this.log.decisions;
+    this.log.statistics = {
+      total: decisions.length,
+      approved: decisions.filter((d) => d.status === "approved").length,
+      rejected: decisions.filter((d) => d.status === "rejected").length,
+      deferred: decisions.filter((d) => d.status === "deferred").length,
+      highConfidence: decisions.filter((d) => d.confidence === "high").length,
+      lowConfidence: decisions.filter(
+        (d) => d.confidence === "low" || d.confidence === "uncertain"
+      ).length,
+      consensusRequired: decisions.filter((d) => d.consensus?.required).length
+    };
+  }
+  /**
+   * Save the log to disk
+   */
+  save() {
+    const dir = dirname(this.logPath);
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(this.logPath, JSON.stringify(this.log, null, 2));
+    logger.debug("Saved decision log", { path: this.logPath });
+  }
+  /**
+   * Export log as markdown
+   */
+  exportMarkdown() {
+    const lines = [
+      "# Decision Log",
+      "",
+      `**Plan ID:** ${this.log.planId}`,
+      `**Created:** ${this.log.createdAt.toISOString()}`,
+      `**Updated:** ${this.log.updatedAt.toISOString()}`,
+      "",
+      "## Statistics",
+      "",
+      `| Metric | Count |`,
+      `|--------|-------|`,
+      `| Total Decisions | ${this.log.statistics.total} |`,
+      `| Approved | ${this.log.statistics.approved} |`,
+      `| Rejected | ${this.log.statistics.rejected} |`,
+      `| Deferred | ${this.log.statistics.deferred} |`,
+      `| High Confidence | ${this.log.statistics.highConfidence} |`,
+      `| Low Confidence | ${this.log.statistics.lowConfidence} |`,
+      `| Consensus Required | ${this.log.statistics.consensusRequired} |`,
+      "",
+      "## Decisions",
+      ""
+    ];
+    const phases = ["specification", "pseudocode", "architecture", "refinement", "completion"];
+    for (const phase of phases) {
+      const phaseDecisions = this.getDecisionsByPhase(phase);
+      if (phaseDecisions.length === 0) continue;
+      lines.push(`### ${phase.charAt(0).toUpperCase() + phase.slice(1)} Phase`);
+      lines.push("");
+      for (const decision of phaseDecisions) {
+        lines.push(`#### ${decision.title}`);
+        lines.push("");
+        lines.push(`- **ID:** ${decision.id}`);
+        lines.push(`- **Status:** ${decision.status}`);
+        lines.push(`- **Confidence:** ${decision.confidence}`);
+        lines.push(`- **Decided By:** ${decision.decidedBy}`);
+        lines.push(`- **Date:** ${decision.createdAt.toISOString()}`);
+        lines.push("");
+        lines.push("**Description:**");
+        lines.push(decision.description);
+        lines.push("");
+        lines.push("**Rationale:**");
+        lines.push(decision.rationale);
+        lines.push("");
+        if (decision.alternatives.length > 0) {
+          lines.push("**Alternatives Considered:**");
+          for (const alt of decision.alternatives) {
+            lines.push(`- ${alt}`);
+          }
+          lines.push("");
+        }
+        if (decision.impact) {
+          lines.push("**Impact:**");
+          lines.push(decision.impact);
+          lines.push("");
+        }
+        if (decision.consensus) {
+          lines.push("**Consensus:**");
+          lines.push(`- Required: ${decision.consensus.required}`);
+          lines.push(`- Achieved: ${decision.consensus.achieved}`);
+          lines.push(`- Method: ${decision.consensus.method}`);
+          lines.push(`- Outcome: ${decision.consensus.outcome}`);
+          lines.push("");
+        }
+        lines.push("---");
+        lines.push("");
+      }
+    }
+    return lines.join("\n");
+  }
+  /**
+   * Save markdown export
+   */
+  saveMarkdown() {
+    const mdPath = join(this.options.outputDir, "decision-log.md");
+    const dir = dirname(mdPath);
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(mdPath, this.exportMarkdown());
+    logger.info("Saved decision log markdown", { path: mdPath });
+  }
+}
+function createDecisionLogManager(options) {
+  return new DecisionLogManager(options);
+}
+export {
+  DecisionLogManager,
+  createDecisionLogManager
+};
+//# sourceMappingURL=decision-log.js.map

package/dist/sparc/decision-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-log.js","sources":["../../src/sparc/decision-log.ts"],"sourcesContent":["/**\n * Decision Log Manager\n *\n * Manages the decision log throughout the SPARC planning process.\n * Tracks all decisions, their rationale, confidence levels, and consensus information.\n *\n * @module sparc/decision-log\n */\n\nimport { writeFileSync, readFileSync, existsSync, mkdirSync } from 'fs';\nimport { join, dirname } from 'path';\nimport { createLogger } from '../utils/index.js';\nimport type {\n  DecisionLog,\n  DecisionEntry,\n  DecisionStatus,\n  ConfidenceLevel,\n  SPARCPhase,\n  ConsensusInfo,\n} from './types.js';\n\nconst logger = createLogger('decision-log');\n\n/**\n * Decision log manager options\n */\nexport interface DecisionLogManagerOptions {\n  /** Output directory for the log */\n  outputDir: string;\n  /** Plan ID */\n  planId: string;\n  /** Auto-save on changes */\n  autoSave?: boolean;\n}\n\n/**\n * Add decision options\n */\nexport interface AddDecisionOptions {\n  /** Decision title */\n  title: string;\n  /** Decision description */\n  description: string;\n  /** SPARC phase */\n  phase: SPARCPhase;\n  /** Confidence level */\n  confidence: ConfidenceLevel;\n  /** Rationale */\n  rationale: string;\n  /** Alternatives considered */\n  alternatives?: string[];\n  /** Impact assessment */\n  impact?: string;\n  /** Stakeholders */\n  stakeholders?: string[];\n  /** Related decision IDs */\n  relatedDecisions?: string[];\n  /** Decision maker */\n  decidedBy: string;\n  /** Consensus info if applicable */\n  consensus?: ConsensusInfo;\n}\n\n/**\n * Decision Log Manager\n *\n * Handles creation, updating, and persistence of decision logs.\n */\nexport class DecisionLogManager {\n  private log: DecisionLog;\n  private readonly options: Required<DecisionLogManagerOptions>;\n  private readonly logPath: string;\n\n  constructor(options: DecisionLogManagerOptions) {\n    this.options = {\n      autoSave: true,\n      ...options,\n    };\n\n    this.logPath = join(this.options.outputDir, 'decision-log.json');\n\n    // Load existing or create new log\n    this.log = this.loadOrCreate();\n  }\n\n  /**\n   * Load existing log or create new one\n   */\n  private loadOrCreate(): DecisionLog {\n    if (existsSync(this.logPath)) {\n      try {\n        const content = readFileSync(this.logPath, 'utf-8');\n        const parsed = JSON.parse(content);\n        // Restore Date objects\n        parsed.createdAt = new Date(parsed.createdAt);\n        parsed.updatedAt = new Date(parsed.updatedAt);\n        for (const decision of parsed.decisions) {\n          decision.createdAt = new Date(decision.createdAt);\n          decision.updatedAt = new Date(decision.updatedAt);\n        }\n        logger.info('Loaded existing decision log', {\n          decisions: parsed.decisions.length,\n        });\n        return parsed;\n      } catch (error) {\n        logger.warn('Failed to load decision log, creating new', { error });\n      }\n    }\n\n    return this.createNewLog();\n  }\n\n  /**\n   * Create a new decision log\n   */\n  private createNewLog(): DecisionLog {\n    const now = new Date();\n    return {\n      id: `dlog_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`,\n      planId: this.options.planId,\n      decisions: [],\n      statistics: {\n        total: 0,\n        approved: 0,\n        rejected: 0,\n        deferred: 0,\n        highConfidence: 0,\n        lowConfidence: 0,\n        consensusRequired: 0,\n      },\n      createdAt: now,\n      updatedAt: now,\n    };\n  }\n\n  /**\n   * Add a new decision to the log\n   */\n  addDecision(options: AddDecisionOptions): DecisionEntry {\n    const now = new Date();\n    const id = `dec_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n\n    const decision: DecisionEntry = {\n      id,\n      title: options.title,\n      description: options.description,\n      phase: options.phase,\n      status: 'proposed',\n      confidence: options.confidence,\n      rationale: options.rationale,\n      alternatives: options.alternatives || [],\n      impact: options.impact || 'Impact assessment pending',\n      stakeholders: options.stakeholders || [],\n      relatedDecisions: options.relatedDecisions || [],\n      consensus: options.consensus,\n      createdAt: now,\n      updatedAt: now,\n      decidedBy: options.decidedBy,\n    };\n\n    this.log.decisions.push(decision);\n    this.updateStatistics();\n    this.log.updatedAt = now;\n\n    logger.info('Added decision', {\n      id: decision.id,\n      title: decision.title,\n      confidence: decision.confidence,\n    });\n\n    if (this.options.autoSave) {\n      this.save();\n    }\n\n    return decision;\n  }\n\n  /**\n   * Update decision status\n   */\n  updateDecisionStatus(decisionId: string, status: DecisionStatus, notes?: string): boolean {\n    const decision = this.log.decisions.find(d => d.id === decisionId);\n    if (!decision) {\n      logger.warn('Decision not found', { decisionId });\n      return false;\n    }\n\n    decision.status = status;\n    decision.updatedAt = new Date();\n\n    if (notes) {\n      decision.rationale = `${decision.rationale}\\n\\nUpdate: ${notes}`;\n    }\n\n    this.updateStatistics();\n    this.log.updatedAt = new Date();\n\n    logger.info('Updated decision status', {\n      id: decisionId,\n      status,\n    });\n\n    if (this.options.autoSave) {\n      this.save();\n    }\n\n    return true;\n  }\n\n  /**\n   * Add consensus information to a decision\n   */\n  addConsensusInfo(decisionId: string, consensus: ConsensusInfo): boolean {\n    const decision = this.log.decisions.find(d => d.id === decisionId);\n    if (!decision) {\n      logger.warn('Decision not found', { decisionId });\n      return false;\n    }\n\n    decision.consensus = consensus;\n    decision.updatedAt = new Date();\n\n    // Update status based on consensus outcome\n    if (consensus.achieved) {\n      decision.status = 'approved';\n    }\n\n    this.updateStatistics();\n    this.log.updatedAt = new Date();\n\n    logger.info('Added consensus info', {\n      id: decisionId,\n      achieved: consensus.achieved,\n      method: consensus.method,\n    });\n\n    if (this.options.autoSave) {\n      this.save();\n    }\n\n    return true;\n  }\n\n  /**\n   * Get all decisions\n   */\n  getDecisions(): DecisionEntry[] {\n    return [...this.log.decisions];\n  }\n\n  /**\n   * Get decisions by phase\n   */\n  getDecisionsByPhase(phase: SPARCPhase): DecisionEntry[] {\n    return this.log.decisions.filter(d => d.phase === phase);\n  }\n\n  /**\n   * Get decisions by confidence level\n   */\n  getDecisionsByConfidence(confidence: ConfidenceLevel): DecisionEntry[] {\n    return this.log.decisions.filter(d => d.confidence === confidence);\n  }\n\n  /**\n   * Get low confidence decisions requiring review\n   */\n  getLowConfidenceDecisions(): DecisionEntry[] {\n    return this.log.decisions.filter(\n      d => d.confidence === 'low' || d.confidence === 'uncertain'\n    );\n  }\n\n  /**\n   * Get decisions requiring consensus\n   */\n  getDecisionsRequiringConsensus(): DecisionEntry[] {\n    return this.log.decisions.filter(\n      d => d.consensus?.required && !d.consensus?.achieved\n    );\n  }\n\n  /**\n   * Get decision by ID\n   */\n  getDecision(id: string): DecisionEntry | undefined {\n    return this.log.decisions.find(d => d.id === id);\n  }\n\n  /**\n   * Get the full log\n   */\n  getLog(): DecisionLog {\n    return { ...this.log };\n  }\n\n  /**\n   * Get statistics\n   */\n  getStatistics(): DecisionLog['statistics'] {\n    return { ...this.log.statistics };\n  }\n\n  /**\n   * Update statistics\n   */\n  private updateStatistics(): void {\n    const decisions = this.log.decisions;\n\n    this.log.statistics = {\n      total: decisions.length,\n      approved: decisions.filter(d => d.status === 'approved').length,\n      rejected: decisions.filter(d => d.status === 'rejected').length,\n      deferred: decisions.filter(d => d.status === 'deferred').length,\n      highConfidence: decisions.filter(d => d.confidence === 'high').length,\n      lowConfidence: decisions.filter(\n        d => d.confidence === 'low' || d.confidence === 'uncertain'\n      ).length,\n      consensusRequired: decisions.filter(d => d.consensus?.required).length,\n    };\n  }\n\n  /**\n   * Save the log to disk\n   */\n  save(): void {\n    const dir = dirname(this.logPath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n\n    writeFileSync(this.logPath, JSON.stringify(this.log, null, 2));\n    logger.debug('Saved decision log', { path: this.logPath });\n  }\n\n  /**\n   * Export log as markdown\n   */\n  exportMarkdown(): string {\n    const lines: string[] = [\n      '# Decision Log',\n      '',\n      `**Plan ID:** ${this.log.planId}`,\n      `**Created:** ${this.log.createdAt.toISOString()}`,\n      `**Updated:** ${this.log.updatedAt.toISOString()}`,\n      '',\n      '## Statistics',\n      '',\n      `| Metric | Count |`,\n      `|--------|-------|`,\n      `| Total Decisions | ${this.log.statistics.total} |`,\n      `| Approved | ${this.log.statistics.approved} |`,\n      `| Rejected | ${this.log.statistics.rejected} |`,\n      `| Deferred | ${this.log.statistics.deferred} |`,\n      `| High Confidence | ${this.log.statistics.highConfidence} |`,\n      `| Low Confidence | ${this.log.statistics.lowConfidence} |`,\n      `| Consensus Required | ${this.log.statistics.consensusRequired} |`,\n      '',\n      '## Decisions',\n      '',\n    ];\n\n    // Group by phase\n    const phases: SPARCPhase[] = ['specification', 'pseudocode', 'architecture', 'refinement', 'completion'];\n\n    for (const phase of phases) {\n      const phaseDecisions = this.getDecisionsByPhase(phase);\n      if (phaseDecisions.length === 0) continue;\n\n      lines.push(`### ${phase.charAt(0).toUpperCase() + phase.slice(1)} Phase`);\n      lines.push('');\n\n      for (const decision of phaseDecisions) {\n        lines.push(`#### ${decision.title}`);\n        lines.push('');\n        lines.push(`- **ID:** ${decision.id}`);\n        lines.push(`- **Status:** ${decision.status}`);\n        lines.push(`- **Confidence:** ${decision.confidence}`);\n        lines.push(`- **Decided By:** ${decision.decidedBy}`);\n        lines.push(`- **Date:** ${decision.createdAt.toISOString()}`);\n        lines.push('');\n        lines.push('**Description:**');\n        lines.push(decision.description);\n        lines.push('');\n        lines.push('**Rationale:**');\n        lines.push(decision.rationale);\n        lines.push('');\n\n        if (decision.alternatives.length > 0) {\n          lines.push('**Alternatives Considered:**');\n          for (const alt of decision.alternatives) {\n            lines.push(`- ${alt}`);\n          }\n          lines.push('');\n        }\n\n        if (decision.impact) {\n          lines.push('**Impact:**');\n          lines.push(decision.impact);\n          lines.push('');\n        }\n\n        if (decision.consensus) {\n          lines.push('**Consensus:**');\n          lines.push(`- Required: ${decision.consensus.required}`);\n          lines.push(`- Achieved: ${decision.consensus.achieved}`);\n          lines.push(`- Method: ${decision.consensus.method}`);\n          lines.push(`- Outcome: ${decision.consensus.outcome}`);\n          lines.push('');\n        }\n\n        lines.push('---');\n        lines.push('');\n      }\n    }\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Save markdown export\n   */\n  saveMarkdown(): void {\n    const mdPath = join(this.options.outputDir, 'decision-log.md');\n    const dir = dirname(mdPath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n\n    writeFileSync(mdPath, this.exportMarkdown());\n    logger.info('Saved decision log markdown', { path: mdPath });\n  }\n}\n\n/**\n * Create a decision log manager\n */\nexport function createDecisionLogManager(options: DecisionLogManagerOptions): DecisionLogManager {\n  return new DecisionLogManager(options);\n}\n"],"names":[],"mappings":"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"}

package/dist/sparc/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SPARC Planning Module
+ *
+ * Comprehensive SPARC (Specification, Pseudocode, Architecture, Refinement, Completion)
+ * planning system with consensus building, decision logging, and review processes.
+ *
+ * @module sparc
+ */
+export * from './types.js';
+export { DecisionLogManager, createDecisionLogManager, type DecisionLogManagerOptions, type AddDecisionOptions, } from './decision-log.js';
+export { ConsensusBuilder, createConsensusBuilder, type ConsensusBuilderOptions, type AgentVote, type ConsensusOption, } from './consensus.js';
+export { ReviewProcessManager, createReviewProcess, type ReviewProcessOptions, } from './review-process.js';
+export { SPARCPlanner, createSPARCPlanner, type SPARCPlannerOptions, } from './sparc-planner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sparc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/sparc/index.js

@@ -0,0 +1,15 @@
+import { DecisionLogManager, createDecisionLogManager } from "./decision-log.js";
+import { ConsensusBuilder, createConsensusBuilder } from "./consensus.js";
+import { ReviewProcessManager, createReviewProcess } from "./review-process.js";
+import { SPARCPlanner, createSPARCPlanner } from "./sparc-planner.js";
+export {
+  ConsensusBuilder,
+  DecisionLogManager,
+  ReviewProcessManager,
+  SPARCPlanner,
+  createConsensusBuilder,
+  createDecisionLogManager,
+  createReviewProcess,
+  createSPARCPlanner
+};
+//# sourceMappingURL=index.js.map

package/dist/sparc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/sparc/review-process.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Review Process Manager
+ *
+ * Implements the 3-pass review system for SPARC plans:
+ * 1. Documentation review
+ * 2. Code review
+ * 3. SPARC specification review
+ *
+ * @module sparc/review-process
+ */
+import type { ReviewFinding, ReviewResult, FindingSeverity, SPARCPlan } from './types.js';
+/**
+ * Review process options
+ */
+export interface ReviewProcessOptions {
+    /** Plan being reviewed */
+    plan: SPARCPlan;
+    /** Number of review passes (default 3) */
+    passes?: number;
+    /** Auto-fix minor issues */
+    autoFix?: boolean;
+    /** Strict mode - fail on any finding */
+    strictMode?: boolean;
+}
+/**
+ * Review Process Manager
+ *
+ * Executes the 3-pass review system.
+ */
+export declare class ReviewProcessManager {
+    private readonly plan;
+    private readonly options;
+    private passes;
+    constructor(options: ReviewProcessOptions);
+    /**
+     * Execute the full review process
+     */
+    executeReview(): Promise<ReviewResult>;
+    /**
+     * Execute a single review pass
+     */
+    private executePass;
+    /**
+     * Compile all pass results into final result
+     */
+    private compileResults;
+    /**
+     * Deduplicate findings across passes
+     */
+    private deduplicateFindings;
+    /**
+     * Generate recommendations based on findings
+     */
+    private generateRecommendations;
+    /**
+     * Get findings by severity
+     */
+    getFindingsBySeverity(severity: FindingSeverity): ReviewFinding[];
+    /**
+     * Get all open findings
+     */
+    getOpenFindings(): ReviewFinding[];
+    /**
+     * Mark finding as resolved
+     */
+    resolveFinding(findingId: string, resolution: string): boolean;
+}
+/**
+ * Create a review process manager
+ */
+export declare function createReviewProcess(options: ReviewProcessOptions): ReviewProcessManager;
+//# sourceMappingURL=review-process.d.ts.map

package/dist/sparc/review-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-process.d.ts","sourceRoot":"","sources":["../../src/sparc/review-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAEV,aAAa,EAEb,YAAY,EACZ,eAAe,EACf,SAAS,EACV,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA+cD;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,MAAM,CAA0B;gBAE5B,OAAO,EAAE,oBAAoB;IAUzC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAsC5C;;OAEG;YACW,WAAW;IAuCzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuC/B;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa,EAAE;IAMjE;;OAEG;IACH,eAAe,IAAI,aAAa,EAAE;IAMlC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;CAW/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CAEvF"}