openlore 2.0.0

package/dist/core/decisions/consolidator.js

@@ -0,0 +1,169 @@
+/**
+ * Decision consolidator
+ *
+ * Calls LLM to merge/resolve draft decisions from a session into a clean set.
+ * Resolves contradictions and collapses superseded decisions.
+ */
+import { DECISIONS_CONSOLIDATION_MAX_TOKENS, } from '../../constants.js';
+import { logger } from '../../utils/logger.js';
+import { makeDecisionId } from './store.js';
+import { parseJSON } from '../../utils/misc.js';
+import { matchFileToDomains } from '../drift/spec-mapper.js';
+const SYSTEM_PROMPT = `You are an architectural decision consolidator for a software project.
+
+You receive a list of architectural decision drafts recorded by an AI agent during a coding session, plus the set of decisions already recorded in prior sessions (with their stable IDs). Some decisions may contradict each other or be superseded by later decisions. Your task is to produce a clean, consolidated set representing the final architectural state after the session.
+
+Rules:
+- Keep only decisions that represent the FINAL state (most recent wins for contradictions)
+- If a decision has a "supersedes" field, mark the referenced decision as resolved
+- Merge related decisions about the same topic into one when they are complementary
+- Typically produce 1-3 consolidated decisions; never more than 5
+- Preserve the original rationale and consequences from the drafts
+- proposedRequirement should be a single sentence starting with "The system SHALL", or null
+
+ID REUSE (critical for traceability):
+- If a consolidated decision covers the same concept as an existing decision (provided in the "existing" section of the input), set "id" to that decision's exact ID string
+- Only reuse an ID if you are confident the concept is the same — same architectural choice, same affected area
+- If the consolidated decision is genuinely new, omit "id" entirely
+- Never invent a new ID — either reuse an existing one or omit the field
+
+Keep a decision if it describes ANY of:
+- A new feature, command, flag, or capability added to the system
+- A change to where responsibility lives (which module/command owns what)
+- A choice between two viable approaches (even if the choice seems obvious in hindsight)
+- A behaviour that would surprise a future developer reading the code
+- A constraint or limitation deliberately introduced
+
+Only discard decisions that are ALL of:
+- Pure refactors with no behaviour change (rename, extract helper, fix types)
+- AND already obvious from the surrounding code without explanation
+- AND recorded no rationale beyond "follow existing patterns"
+
+Good examples: "Move hook installation from decisions to setup command", "Use system prompt injection instead of tool-output blocking for completion guard", "Prefer local dist/cli/index.js over global openlore in pre-commit hook"
+Bad examples: "Use TypeScript interfaces for type safety", "Add error handling", "Follow existing service pattern"
+
+SCOPE CLASSIFICATION (required):
+Classify each consolidated decision with one of these scopes:
+- "local": single file, no cross-cutting concern (refactors, extractions, renames)
+- "component": single component/service/module, no cross-boundary contract impact
+- "cross-domain": touches multiple spec domains AND changes behavioral contracts or public interfaces
+- "system": global architectural constraint (auth strategy, data model, infra, API protocol)
+
+Only "cross-domain" and "system" decisions will generate ADR files. Be conservative.
+
+DO NOT classify as "cross-domain" when:
+- multiple files changed but within one logical module
+- helper utilities were extracted to a shared file
+- tests were updated alongside implementation
+- config/constants changed
+- middleware was added inside a single service
+- internal refactors touched shared code without changing contracts
+
+Respond with a JSON array only. Each element:
+{
+  "id": string (optional — only set when reusing an existing decision ID),
+  "title": string,
+  "rationale": string,
+  "consequences": string,
+  "affectedDomains": string[],
+  "affectedFiles": string[],
+  "proposedRequirement": string | null,
+  "supersededIds": string[],
+  "scope": string
+}
+
+If there are genuinely no decisions worth keeping, return [].`;
+export async function consolidateDrafts(store, llm, specMap) {
+    const drafts = store.decisions.filter((d) => d.status === 'draft');
+    if (drafts.length === 0)
+        return { decisions: [], supersededIds: [] };
+    // Non-draft decisions passed to LLM so it can reuse their IDs when the same concept recurs.
+    // Includes 'synced' intentionally — if a synced concept resurfaces in a new session, the LLM
+    // should reuse the stable ID for traceability rather than minting a duplicate. Synced decisions
+    // are purged from the store after sync, so this set is empty in the common case.
+    const existing = store.decisions.filter((d) => d.status !== 'draft' && d.status !== 'rejected' && d.status !== 'phantom');
+    const existingIds = new Set(existing.map((d) => d.id));
+    const userContent = JSON.stringify({
+        drafts: drafts.map((d) => ({
+            id: d.id,
+            title: d.title,
+            rationale: d.rationale,
+            consequences: d.consequences,
+            affectedDomains: d.affectedDomains,
+            affectedFiles: d.affectedFiles,
+            supersedes: d.supersedes,
+            recordedAt: d.recordedAt,
+        })),
+        existing: existing.map((d) => ({
+            id: d.id,
+            title: d.title,
+            rationale: d.rationale,
+            status: d.status,
+        })),
+    }, null, 2);
+    const response = await llm.complete({
+        systemPrompt: SYSTEM_PROMPT,
+        userPrompt: userContent,
+        maxTokens: DECISIONS_CONSOLIDATION_MAX_TOKENS,
+        temperature: 0.1,
+    });
+    const raw = response.content;
+    const consolidated = parseJSON(raw, []);
+    if (consolidated.length === 0 && drafts.length > 0) {
+        logger.warning(`consolidation returned 0 decisions from ${drafts.length} drafts — LLM response: ${raw.slice(0, 300)}`);
+    }
+    const now = new Date().toISOString();
+    const allSupersededIds = consolidated.flatMap((c) => c.supersededIds ?? []);
+    const decisions = consolidated.map((c) => {
+        // Remap LLM-produced domain names to spec-map ground truth using affectedFiles.
+        // Falls back to LLM names if specMap is absent or files yield no match.
+        const resolvedDomains = resolveDomainsFromFiles(c.affectedFiles, c.affectedDomains, specMap);
+        const domain = resolvedDomains[0] ?? 'unknown';
+        // Prefer LLM-supplied ID when it matches a known existing decision — this is the
+        // traceability anchor that prevents duplicate IDs across consolidation runs.
+        const id = c.id && existingIds.has(c.id)
+            ? c.id
+            : makeDecisionId(store.sessionId, domain, c.title);
+        return {
+            id,
+            status: 'consolidated',
+            title: c.title,
+            rationale: c.rationale,
+            consequences: c.consequences,
+            proposedRequirement: c.proposedRequirement,
+            affectedDomains: resolvedDomains,
+            affectedFiles: c.affectedFiles,
+            scope: c.scope ?? 'component',
+            confidence: 'medium',
+            sessionId: store.sessionId,
+            recordedAt: now,
+            consolidatedAt: now,
+            syncedToSpecs: [],
+        };
+    });
+    return { decisions, supersededIds: allSupersededIds };
+}
+/**
+ * Remap LLM-produced domain names to spec-map ground truth.
+ * Uses affectedFiles as the anchor: if files can be matched to known spec domains,
+ * those names take precedence over whatever the LLM suggested.
+ */
+function resolveDomainsFromFiles(files, llmDomains, specMap) {
+    if (!specMap || files.length === 0)
+        return llmDomains.length > 0 ? llmDomains : ['unknown'];
+    const matched = new Set();
+    for (const file of files) {
+        for (const domain of matchFileToDomains(file, specMap)) {
+            matched.add(domain);
+        }
+    }
+    if (matched.size > 0)
+        return [...matched];
+    // Files didn't match — try normalising LLM names against known domains
+    const knownDomains = [...specMap.byDomain.keys()];
+    const normalised = llmDomains
+        .map((d) => knownDomains.find((k) => k.toLowerCase() === d.toLowerCase()) ?? null)
+        .filter((d) => d !== null);
+    return normalised.length > 0 ? normalised : llmDomains.length > 0 ? llmDomains : ['unknown'];
+}
+//# sourceMappingURL=consolidator.js.map

package/dist/core/decisions/consolidator.js.map

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

package/dist/core/decisions/extractor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Decision extractor — fallback path
+ *
+ * When an agent hasn't called record_decision during development,
+ * this module extracts architectural decisions directly from the git diff.
+ * Produces decisions at status 'consolidated' (lower confidence than
+ * manually recorded drafts, but immediately ready for verification).
+ */
+import type { LLMService } from '../services/llm-service.js';
+import type { PendingDecision, SpecMap } from '../../types/index.js';
+export interface ExtractFromDiffOptions {
+    rootPath: string;
+    baseRef?: string;
+    /** When true, use git diff --cached (staged changes only). Overrides baseRef. */
+    stagedOnly?: boolean;
+    specMap: SpecMap;
+    sessionId: string;
+    llm: LLMService;
+}
+/**
+ * Extract architectural decisions from the current git diff.
+ * Used as fallback when the agent produced no record_decision drafts.
+ * Returns decisions at status 'consolidated', ready for verification.
+ */
+export declare function extractFromDiff(options: ExtractFromDiffOptions): Promise<PendingDecision[]>;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/core/decisions/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/core/decisions/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAiB,MAAM,sBAAsB,CAAC;AA4CpF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,UAAU,CAAC;CACjB;AA8BD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAgFjG"}

package/dist/core/decisions/extractor.js

@@ -0,0 +1,156 @@
+/**
+ * Decision extractor — fallback path
+ *
+ * When an agent hasn't called record_decision during development,
+ * this module extracts architectural decisions directly from the git diff.
+ * Produces decisions at status 'consolidated' (lower confidence than
+ * manually recorded drafts, but immediately ready for verification).
+ */
+import { DECISIONS_EXTRACTION_MAX_FILES, DECISIONS_DIFF_MAX_CHARS, DECISIONS_CONSOLIDATION_MAX_TOKENS, } from '../../constants.js';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { getChangedFiles, getFileDiff, resolveBaseRef } from '../drift/git-diff.js';
+const execFileAsync = promisify(execFile);
+import { matchFileToDomains, getSpecContent } from '../drift/spec-mapper.js';
+import { makeDecisionId } from './store.js';
+import { parseJSON } from '../../utils/misc.js';
+const SYSTEM_PROMPT = `You are an architectural decision extractor for a software project.
+
+You receive git diffs for source files belonging to one spec domain, along with the existing requirements for that domain.
+
+Your task: identify architectural decisions embedded in these changes — choices about structure, technology, contracts, or behavior that a future developer should understand.
+
+Rules:
+- Only surface decisions with architectural significance (not style fixes, typo patches, comment changes, test updates)
+- A single diff may yield 0, 1, or 2 decisions
+- For trivial changes return []
+- proposedRequirement: one sentence in imperative form ("The system SHALL …"), or null
+
+SCOPE CLASSIFICATION (required):
+Each extraction call processes one spec domain at a time, so cross-domain scope cannot be
+determined here. Classify only within the local/component axis:
+- "local": single file, no cross-cutting concern (refactors, extractions, renames)
+- "component": this component/service/module, may affect its public interface
+
+Scope upgrade to "cross-domain" or "system" happens at consolidation time when the full
+session context across all domains is visible.
+
+Respond with a JSON array only. Each element:
+{
+  "title": string,
+  "rationale": string,
+  "consequences": string,
+  "affectedFiles": string[],
+  "proposedRequirement": string | null,
+  "scope": string
+}`;
+function isRelevantStagedFile(filePath) {
+    const ext = filePath.includes('.') ? filePath.slice(filePath.lastIndexOf('.')) : '';
+    if (ext === '.md' || ext === '.txt' || ext === '.json' || ext === '.lock')
+        return false;
+    if (filePath.startsWith('openspec/') || filePath.startsWith('.openlore/'))
+        return false;
+    if (filePath.includes('.test.') || filePath.includes('.spec.') || filePath.includes('/__tests__/'))
+        return false;
+    if (filePath.includes('/dist/') || filePath.includes('/node_modules/'))
+        return false;
+    return true;
+}
+async function getStagedFiles(rootPath) {
+    const { stdout } = await execFileAsync('git', ['diff', '--cached', '--name-status', '--diff-filter=ACDMR'], { cwd: rootPath });
+    return stdout.trim().split('\n').filter(Boolean).map((line) => {
+        const [status, ...rest] = line.split('\t');
+        return { path: rest.join('\t'), status: status ?? 'M' };
+    });
+}
+async function getStagedFileDiff(rootPath, filePath, maxChars) {
+    const { stdout } = await execFileAsync('git', ['diff', '--cached', '--', filePath], { cwd: rootPath });
+    return stdout.length > maxChars ? stdout.slice(0, maxChars) + '\n... (truncated)' : stdout;
+}
+/**
+ * Extract architectural decisions from the current git diff.
+ * Used as fallback when the agent produced no record_decision drafts.
+ * Returns decisions at status 'consolidated', ready for verification.
+ */
+export async function extractFromDiff(options) {
+    const { rootPath, specMap, sessionId, llm, stagedOnly } = options;
+    let files;
+    let getDiff;
+    if (stagedOnly) {
+        files = await getStagedFiles(rootPath);
+        getDiff = (f) => getStagedFileDiff(rootPath, f, DECISIONS_DIFF_MAX_CHARS);
+    }
+    else {
+        const baseRef = await resolveBaseRef(rootPath, options.baseRef ?? 'auto');
+        const gitResult = await getChangedFiles({ rootPath, baseRef, includeUnstaged: false });
+        files = gitResult.files;
+        getDiff = (f) => getFileDiff(rootPath, f, baseRef, DECISIONS_DIFF_MAX_CHARS);
+    }
+    const relevant = files
+        .filter((f) => isRelevantStagedFile(f.path))
+        .slice(0, DECISIONS_EXTRACTION_MAX_FILES);
+    if (relevant.length === 0)
+        return [];
+    // Group files by domain for coherent LLM calls
+    const byDomain = new Map();
+    for (const file of relevant) {
+        const domains = matchFileToDomains(file.path, specMap);
+        const key = domains[0] ?? 'unknown';
+        if (!byDomain.has(key))
+            byDomain.set(key, []);
+        byDomain.get(key).push(file);
+    }
+    const results = [];
+    const now = new Date().toISOString();
+    for (const [domain, domainFiles] of byDomain) {
+        const diffs = await Promise.all(domainFiles.map((f) => getDiff(f.path)));
+        const specExcerpt = await getSpecContent(domain, specMap, rootPath, 2_000) ?? '';
+        const requirementsExcerpt = extractRequirements(specExcerpt);
+        const userContent = [
+            `Domain: ${domain}`,
+            requirementsExcerpt ? `Existing requirements (excerpt):\n${requirementsExcerpt}` : '',
+            '',
+            ...domainFiles.map((f, i) => `=== ${f.path} ===\n${diffs[i]}`),
+        ].filter(Boolean).join('\n\n');
+        const response = await llm.complete({
+            systemPrompt: SYSTEM_PROMPT,
+            userPrompt: userContent,
+            maxTokens: DECISIONS_CONSOLIDATION_MAX_TOKENS,
+            temperature: 0.1,
+        });
+        const extracted = parseJSON(response.content, []);
+        for (const e of extracted) {
+            const id = makeDecisionId(sessionId, domain, e.title);
+            results.push({
+                id,
+                status: 'consolidated',
+                title: e.title,
+                rationale: e.rationale,
+                consequences: e.consequences,
+                proposedRequirement: e.proposedRequirement,
+                scope: e.scope ?? 'component',
+                affectedDomains: [domain],
+                affectedFiles: e.affectedFiles.length ? e.affectedFiles : domainFiles.map((f) => f.path),
+                sessionId,
+                recordedAt: now,
+                consolidatedAt: now,
+                confidence: 'medium',
+                syncedToSpecs: [],
+            });
+        }
+    }
+    return results;
+}
+function extractRequirements(specContent) {
+    const lines = specContent.split('\n');
+    const reqLines = [];
+    for (const line of lines) {
+        if (line.startsWith('### Requirement:') || (reqLines.length > 0 && line.startsWith('  '))) {
+            reqLines.push(line);
+            if (reqLines.length > 30)
+                break;
+        }
+    }
+    return reqLines.join('\n');
+}
+//# sourceMappingURL=extractor.js.map

package/dist/core/decisions/extractor.js.map

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

package/dist/core/decisions/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Decisions module — agent-recorded architectural decisions
+ *
+ * Workflow:
+ *   1. Agent calls record_decision() (MCP) during dev → draft stored in pending.json
+ *   2. At commit: consolidateDrafts() merges/resolves contradictions via LLM
+ *   3. verifyDecisions() cross-checks consolidated set against git diff
+ *   4. Human/agent approves via CLI or MCP
+ *   5. syncApprovedDecisions() writes to spec.md + creates ADRs
+ */
+export { loadDecisionStore, saveDecisionStore, upsertDecisions, patchDecision, getDecisionsByStatus, makeDecisionId, newSessionId, decisionsDir } from './store.js';
+export { consolidateDrafts } from './consolidator.js';
+export { extractFromDiff } from './extractor.js';
+export type { ExtractFromDiffOptions } from './extractor.js';
+export { verifyDecisions } from './verifier.js';
+export type { VerificationResult } from './verifier.js';
+export { syncApprovedDecisions } from './syncer.js';
+export type { SyncOptions, SyncResult } from './syncer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/decisions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/decisions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACpK,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/decisions/index.js

@@ -0,0 +1,16 @@
+/**
+ * Decisions module — agent-recorded architectural decisions
+ *
+ * Workflow:
+ *   1. Agent calls record_decision() (MCP) during dev → draft stored in pending.json
+ *   2. At commit: consolidateDrafts() merges/resolves contradictions via LLM
+ *   3. verifyDecisions() cross-checks consolidated set against git diff
+ *   4. Human/agent approves via CLI or MCP
+ *   5. syncApprovedDecisions() writes to spec.md + creates ADRs
+ */
+export { loadDecisionStore, saveDecisionStore, upsertDecisions, patchDecision, getDecisionsByStatus, makeDecisionId, newSessionId, decisionsDir } from './store.js';
+export { consolidateDrafts } from './consolidator.js';
+export { extractFromDiff } from './extractor.js';
+export { verifyDecisions } from './verifier.js';
+export { syncApprovedDecisions } from './syncer.js';
+//# sourceMappingURL=index.js.map

package/dist/core/decisions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/decisions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACpK,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/decisions/store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Decision store — CRUD for .openlore/decisions/pending.json
+ */
+import type { PendingDecision, DecisionStore, DecisionStatus } from '../../types/index.js';
+export declare function decisionsDir(rootPath: string): string;
+export declare function loadDecisionStore(rootPath: string): Promise<DecisionStore>;
+export declare function saveDecisionStore(rootPath: string, store: DecisionStore): Promise<void>;
+/**
+ * Merge incoming decisions into the store, deduplicating by id.
+ * Existing decisions are never overwritten.
+ */
+export declare function upsertDecisions(store: DecisionStore, incoming: PendingDecision[]): DecisionStore;
+/**
+ * Merge incoming decisions into the store, always overwriting by id.
+ * Use this for consolidation output — consolidated decisions share IDs with
+ * their original drafts (makeDecisionId is deterministic), so upsertDecisions
+ * would silently no-op after patchDecision marks the originals rejected.
+ */
+export declare function replaceDecisions(store: DecisionStore, incoming: PendingDecision[]): DecisionStore;
+/** Patch a single decision by id. Returns the updated store (not yet saved). */
+export declare function patchDecision(store: DecisionStore, id: string, patch: Partial<PendingDecision>): DecisionStore;
+export declare function getDecisionsByStatus(store: DecisionStore, status: DecisionStatus): PendingDecision[];
+export declare function getDecisionCount(store: DecisionStore): number;
+/** Status blocks the commit gate until resolved. */
+export declare function isBlockingStatus(status: DecisionStatus): boolean;
+/** Status requires a --sync run before committing. */
+export declare function requiresSync(status: DecisionStatus): boolean;
+/** Statuses excluded from the "activeDecisions" gate guard. */
+export declare const INACTIVE_STATUSES: ReadonlySet<DecisionStatus>;
+/** Drop all inactive decisions — their content is already in ADRs / spec.md. */
+export declare function purgeInactiveDecisions(store: DecisionStore): DecisionStore;
+/** Stable 8-char ID derived from session + domain + title. */
+export declare function makeDecisionId(sessionId: string, domain: string, title: string): string;
+/** Generate a new session ID for a commit cycle. */
+export declare function newSessionId(): string;
+//# sourceMappingURL=store.d.ts.map

package/dist/core/decisions/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/core/decisions/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiBhF;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,aAAa,CAMhG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,aAAa,CAMjG;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAC9B,aAAa,CAKf;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,cAAc,GACrB,eAAe,EAAE,CAEnB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE7D;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEhE;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAE5D;AAED,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,cAAc,CAExD,CAAC;AAEH,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAK1E;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,oDAAoD;AACpD,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/core/decisions/store.js

@@ -0,0 +1,109 @@
+/**
+ * Decision store — CRUD for .openlore/decisions/pending.json
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { logger } from '../../utils/logger.js';
+import { OPENLORE_DIR, OPENLORE_DECISIONS_SUBDIR, DECISIONS_PENDING_FILE, } from '../../constants.js';
+import { fileExists } from '../../utils/command-helpers.js';
+export function decisionsDir(rootPath) {
+    return join(rootPath, OPENLORE_DIR, OPENLORE_DECISIONS_SUBDIR);
+}
+export async function loadDecisionStore(rootPath) {
+    const path = join(decisionsDir(rootPath), DECISIONS_PENDING_FILE);
+    if (!(await fileExists(path))) {
+        return emptyStore();
+    }
+    try {
+        const raw = await readFile(path, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code !== 'ENOENT') {
+            logger.warning(`decisions store: failed to read ${path} (${err.message}) — starting fresh`);
+        }
+        return emptyStore();
+    }
+}
+export async function saveDecisionStore(rootPath, store) {
+    const dir = decisionsDir(rootPath);
+    await mkdir(dir, { recursive: true });
+    const updated = { ...store, updatedAt: new Date().toISOString() };
+    await writeFile(join(dir, DECISIONS_PENDING_FILE), JSON.stringify(updated, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Merge incoming decisions into the store, deduplicating by id.
+ * Existing decisions are never overwritten.
+ */
+export function upsertDecisions(store, incoming) {
+    const byId = new Map(store.decisions.map((d) => [d.id, d]));
+    for (const d of incoming) {
+        if (!byId.has(d.id))
+            byId.set(d.id, d);
+    }
+    return { ...store, decisions: [...byId.values()] };
+}
+/**
+ * Merge incoming decisions into the store, always overwriting by id.
+ * Use this for consolidation output — consolidated decisions share IDs with
+ * their original drafts (makeDecisionId is deterministic), so upsertDecisions
+ * would silently no-op after patchDecision marks the originals rejected.
+ */
+export function replaceDecisions(store, incoming) {
+    const byId = new Map(store.decisions.map((d) => [d.id, d]));
+    for (const d of incoming) {
+        byId.set(d.id, d);
+    }
+    return { ...store, decisions: [...byId.values()] };
+}
+/** Patch a single decision by id. Returns the updated store (not yet saved). */
+export function patchDecision(store, id, patch) {
+    return {
+        ...store,
+        decisions: store.decisions.map((d) => (d.id === id ? { ...d, ...patch } : d)),
+    };
+}
+export function getDecisionsByStatus(store, status) {
+    return store.decisions.filter((d) => d.status === status);
+}
+export function getDecisionCount(store) {
+    return store.decisions.length;
+}
+/** Status blocks the commit gate until resolved. */
+export function isBlockingStatus(status) {
+    return status === 'verified' || status === 'approved';
+}
+/** Status requires a --sync run before committing. */
+export function requiresSync(status) {
+    return status === 'approved';
+}
+/** Statuses excluded from the "activeDecisions" gate guard. */
+export const INACTIVE_STATUSES = new Set([
+    'rejected', 'synced', 'phantom',
+]);
+/** Drop all inactive decisions — their content is already in ADRs / spec.md. */
+export function purgeInactiveDecisions(store) {
+    return {
+        ...store,
+        decisions: store.decisions.filter((d) => !INACTIVE_STATUSES.has(d.status)),
+    };
+}
+/** Stable 8-char ID derived from session + domain + title. */
+export function makeDecisionId(sessionId, domain, title) {
+    return createHash('sha256').update(`${sessionId}:${domain}:${title}`).digest('hex').slice(0, 8);
+}
+/** Generate a new session ID for a commit cycle. */
+export function newSessionId() {
+    return createHash('sha256').update(`${Date.now()}-${Math.random()}`).digest('hex').slice(0, 12);
+}
+function emptyStore() {
+    return {
+        version: '1',
+        sessionId: newSessionId(),
+        updatedAt: new Date().toISOString(),
+        decisions: [],
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/core/decisions/store.js.map

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

package/dist/core/decisions/syncer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Decision syncer
+ *
+ * Writes approved decisions into OpenSpec spec.md files (append-only)
+ * and creates ADR files for architectural decisions.
+ * Never rewrites existing content.
+ */
+import type { PendingDecision, DecisionStore, SpecMap } from '../../types/index.js';
+export interface SyncOptions {
+    rootPath: string;
+    openspecPath: string;
+    specMap: SpecMap;
+    dryRun?: boolean;
+}
+export interface SyncResult {
+    synced: PendingDecision[];
+    errors: Array<{
+        id: string;
+        error: string;
+    }>;
+    modifiedSpecs: string[];
+}
+export declare function syncApprovedDecisions(store: DecisionStore, options: SyncOptions): Promise<{
+    store: DecisionStore;
+    result: SyncResult;
+}>;
+//# sourceMappingURL=syncer.d.ts.map

package/dist/core/decisions/syncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncer.d.ts","sourceRoot":"","sources":["../../../src/core/decisions/syncer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAiB,MAAM,sBAAsB,CAAC;AAcnG,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAoCvD"}