@decibelsystems/tools 2.0.0

package/dist/tools/lateral.d.ts

@@ -0,0 +1,114 @@
+export type Technique = 'six_hats' | 'provocation' | 'random_entry' | 'challenge' | 'alternatives' | 'reversal';
+export declare const VALID_TECHNIQUES: Technique[];
+export type HatColor = 'white' | 'red' | 'black' | 'yellow' | 'green' | 'blue';
+export declare const VALID_HATS: HatColor[];
+export interface LateralError {
+    error: string;
+    message: string;
+    hint?: string;
+}
+export declare function isLateralError(result: unknown): result is LateralError;
+export interface SixHatsInput {
+    hat: HatColor;
+    thinking: string;
+}
+export interface ProvocationInput {
+    po_statement: string;
+    movement: string;
+    insights: string[];
+}
+export interface RandomEntryInput {
+    stimulus?: string;
+    connections: string[];
+    promising_leads: string[];
+}
+export interface ChallengeInput {
+    assumption: string;
+    why_exists: string;
+    what_if_false: string;
+    alternative_framing: string;
+}
+export interface AlternativesInput {
+    focus: string;
+    concept_level: string;
+    alternatives: Array<{
+        idea: string;
+        approach: string;
+    }>;
+}
+export interface ReversalInput {
+    original: string;
+    reversed: string;
+    insights_from_reversal: string[];
+}
+export type TechniqueInput = SixHatsInput | ProvocationInput | RandomEntryInput | ChallengeInput | AlternativesInput | ReversalInput;
+export interface TechniqueEntry {
+    entry_id: string;
+    technique: Technique;
+    timestamp: string;
+    data: TechniqueInput;
+}
+export interface LateralSession {
+    session_id: string;
+    project_id: string;
+    problem: string;
+    context?: string;
+    status: 'open' | 'closed';
+    created_at: string;
+    closed_at?: string;
+    entries: TechniqueEntry[];
+    synthesis?: string;
+    action_items?: string[];
+    linked_to?: string[];
+}
+export interface StartSessionInput {
+    projectId?: string;
+    session_id?: string;
+    problem?: string;
+    context?: string;
+}
+export interface StartSessionOutput {
+    session_id: string;
+    problem: string;
+    status: 'open' | 'closed';
+    techniques_applied: string[];
+    path: string;
+}
+export interface ApplyTechniqueInput {
+    projectId?: string;
+    session_id: string;
+    technique: Technique;
+    input: Record<string, unknown>;
+}
+export interface ApplyTechniqueOutput {
+    entry_id: string;
+    recorded: boolean;
+    guidance: string;
+    session_progress: {
+        techniques_applied: string[];
+        entry_count: number;
+    };
+}
+export interface CloseSessionInput {
+    projectId?: string;
+    session_id: string;
+    synthesis: string;
+    action_items?: string[];
+    link_to?: string[];
+}
+export interface CloseSessionOutput {
+    session_id: string;
+    path: string;
+    summary_path: string;
+    techniques_applied: number;
+}
+/** Recommended Six Hats sequence: Blue > White > Red > Black > Yellow > Green > Blue */
+export declare const HAT_ORDER: HatColor[];
+/** Guidance for each hat color (de Bono's parallel thinking) */
+export declare const HAT_GUIDANCE: Record<HatColor, string>;
+/** ~100 concrete nouns for random entry technique */
+export declare const RANDOM_STIMULI: string[];
+export declare function startSession(input: StartSessionInput): Promise<StartSessionOutput | LateralError>;
+export declare function applyTechnique(input: ApplyTechniqueInput): Promise<ApplyTechniqueOutput | LateralError>;
+export declare function closeSession(input: CloseSessionInput): Promise<CloseSessionOutput | LateralError>;
+//# sourceMappingURL=lateral.d.ts.map

package/dist/tools/lateral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lateral.d.ts","sourceRoot":"","sources":["../../src/tools/lateral.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,aAAa,GACb,cAAc,GACd,WAAW,GACX,cAAc,GACd,UAAU,CAAC;AAEf,eAAO,MAAM,gBAAgB,EAAE,SAAS,EAEvC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/E,eAAO,MAAM,UAAU,EAAE,QAAQ,EAAyD,CAAC;AAE3F,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,YAAY,CAEtE;AAID,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,QAAQ,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,iBAAiB,GACjB,aAAa,CAAC;AAIlB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAID,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE;QAChB,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAMD,wFAAwF;AACxF,eAAO,MAAM,SAAS,EAAE,QAAQ,EAAiE,CAAC;AAElG,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAOjD,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,cAAc,EAAE,MAAM,EAelC,CAAC;AAoHF,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,GAAG,YAAY,CAAC,CAiE5C;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,GAAG,YAAY,CAAC,CA4H9C;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,GAAG,YAAY,CAAC,CA2D5C"}

package/dist/tools/lateral.js

@@ -0,0 +1,536 @@
+// ============================================================================
+// Lateral Design Thinking
+// ============================================================================
+// Structured lateral thinking sessions inspired by Edward de Bono's methods.
+// Sessions persist as YAML artifacts in .decibel/designer/lateral/.
+// ============================================================================
+import fs from 'fs/promises';
+import path from 'path';
+import YAML from 'yaml';
+import { log } from '../config.js';
+import { ensureDir } from '../dataRoot.js';
+import { resolveProjectPaths, validateWritePath } from '../projectRegistry.js';
+import { emitCreateProvenance } from './provenance.js';
+export const VALID_TECHNIQUES = [
+    'six_hats', 'provocation', 'random_entry', 'challenge', 'alternatives', 'reversal',
+];
+export const VALID_HATS = ['white', 'red', 'black', 'yellow', 'green', 'blue'];
+export function isLateralError(result) {
+    return typeof result === 'object' && result !== null && 'error' in result && 'message' in result;
+}
+// ============================================================================
+// Constants
+// ============================================================================
+/** Recommended Six Hats sequence: Blue > White > Red > Black > Yellow > Green > Blue */
+export const HAT_ORDER = ['blue', 'white', 'red', 'black', 'yellow', 'green', 'blue'];
+/** Guidance for each hat color (de Bono's parallel thinking) */
+export const HAT_GUIDANCE = {
+    blue: 'PROCESS: Define the focus, set the agenda, summarise, and decide next steps. What are we thinking about? What sequence of hats should we use?',
+    white: 'FACTS: State known information and data neutrally. No opinions or interpretations. What do we know? What data is missing? What questions do we need answered?',
+    red: 'FEELINGS: Share gut feelings, emotions, and intuitions without justification. What does your instinct say? What feels right or wrong? No need to explain why.',
+    black: 'CAUTION: Identify risks, weaknesses, and reasons something may fail. Be specific about dangers. What could go wrong? What are the logical flaws? Where are the vulnerabilities?',
+    yellow: 'VALUE: Find benefits, value, and feasibility optimistically but logically. What are the advantages? Why could this work? What is the best-case outcome?',
+    green: 'CREATIVITY: Generate new ideas, alternatives, and possibilities. No judgement. Propose modifications, variations, and entirely new approaches. Use "po" provocations freely.',
+};
+/** ~100 concrete nouns for random entry technique */
+export const RANDOM_STIMULI = [
+    'bridge', 'mirror', 'seed', 'clock', 'river', 'ladder', 'envelope', 'compass',
+    'anchor', 'lantern', 'thread', 'volcano', 'puzzle', 'telescope', 'mushroom',
+    'cathedral', 'iceberg', 'nest', 'waterfall', 'prism', 'anvil', 'lighthouse',
+    'fossil', 'tapestry', 'pendulum', 'canyon', 'beehive', 'circuit', 'origami',
+    'glacier', 'mosaic', 'windmill', 'coral', 'blueprint', 'hourglass', 'labyrinth',
+    'aurora', 'root', 'constellation', 'furnace', 'kaleidoscope', 'membrane',
+    'reservoir', 'scaffold', 'tide', 'valve', 'web', 'yeast', 'zipper', 'arch',
+    'bamboo', 'canopy', 'delta', 'ember', 'feather', 'gateway', 'hinge', 'island',
+    'junction', 'keystone', 'lens', 'magnet', 'nucleus', 'orbit', 'pillar',
+    'quarry', 'ripple', 'sieve', 'threshold', 'umbrella', 'vortex', 'wheel',
+    'crystal', 'drum', 'echo', 'flame', 'grove', 'harbor', 'inkwell', 'jewel',
+    'knot', 'leaf', 'mountain', 'needle', 'oasis', 'parachute', 'quilt', 'rope',
+    'satellite', 'tunnel', 'urn', 'vine', 'wave', 'xylophone', 'yarn', 'zenith',
+    'bell', 'chimney', 'dome', 'engine', 'fountain',
+];
+// ============================================================================
+// Helpers
+// ============================================================================
+function makeProjectError(operation) {
+    return {
+        error: 'PROJECT_NOT_FOUND',
+        message: `Cannot ${operation}: No project context available.`,
+        hint: 'Specify projectId parameter, set DECIBEL_PROJECT_ROOT env var, or run from a directory with .decibel/',
+    };
+}
+function generateSessionId() {
+    const now = new Date();
+    const ts = now.toISOString().replace(/[-:]/g, '').replace(/\.\d{3}Z$/, '');
+    return `LAT-${ts}`;
+}
+function generateEntryId(sessionId, technique, data) {
+    const suffix = technique === 'six_hats' ? data.hat : '';
+    return suffix ? `${sessionId}-${technique.replace('_', '-')}-${suffix}` : `${sessionId}-${technique.replace('_', '-')}-${Date.now()}`;
+}
+function lateralDir(resolved) {
+    return resolved.subPath('designer', 'lateral');
+}
+function sessionFilePath(dir, sessionId) {
+    return path.join(dir, `${sessionId}.yaml`);
+}
+function summaryFilePath(dir, sessionId) {
+    return path.join(dir, `${sessionId}-summary.md`);
+}
+function pickRandomStimulus() {
+    return RANDOM_STIMULI[Math.floor(Math.random() * RANDOM_STIMULI.length)];
+}
+async function loadSession(filePath) {
+    const content = await fs.readFile(filePath, 'utf-8');
+    return YAML.parse(content);
+}
+async function saveSession(filePath, session, resolved) {
+    validateWritePath(filePath, resolved);
+    await fs.writeFile(filePath, YAML.stringify(session, { lineWidth: 0 }), 'utf-8');
+}
+function techniquesApplied(session) {
+    const seen = new Set();
+    for (const entry of session.entries) {
+        if (entry.technique === 'six_hats') {
+            seen.add(`six_hats:${entry.data.hat}`);
+        }
+        else {
+            seen.add(entry.technique);
+        }
+    }
+    return [...seen];
+}
+// ============================================================================
+// Guidance Generators
+// ============================================================================
+function guidanceForSixHats(hat, session) {
+    const hatsUsed = session.entries
+        .filter(e => e.technique === 'six_hats')
+        .map(e => e.data.hat);
+    const currentIndex = HAT_ORDER.indexOf(hat);
+    const nextHats = HAT_ORDER.filter((h, i) => i > currentIndex && !hatsUsed.includes(h));
+    const nextSuggestion = nextHats.length > 0
+        ? `Suggested next hat: ${nextHats[0]} (${HAT_GUIDANCE[nextHats[0]].split(':')[0]})`
+        : 'All hats explored. Consider closing with blue hat summary or applying another technique.';
+    return `${HAT_GUIDANCE[hat]}\n\n${nextSuggestion}`;
+}
+function guidanceForProvocation() {
+    return 'PROVOCATION recorded. Now apply "movement" — don\'t judge the Po statement, instead extract useful concepts from it. Look for: what principle is operating? What happens at the boundary? What would the world need to look like for this to make sense?';
+}
+function guidanceForRandomEntry(stimulus) {
+    return `Random stimulus: "${stimulus}". Force connections between this word and your problem. What properties does "${stimulus}" have? How do those properties relate to your design challenge? List at least 3 associations, then identify which connections open new avenues.`;
+}
+function guidanceForChallenge() {
+    return 'CHALLENGE recorded. You\'ve questioned an assumption. Now explore: What designs become possible if this assumption is removed? What new constraints emerge? Consider using the "alternatives" technique to fan out from this new framing.';
+}
+function guidanceForAlternatives() {
+    return 'ALTERNATIVES captured. You\'ve broadened the concept fan. Before narrowing, ask: Are there concepts at a higher abstraction level we haven\'t explored? Can any two ideas be combined? Consider applying "reversal" to your top candidate.';
+}
+function guidanceForReversal() {
+    return 'REVERSAL recorded. The flipped perspective often reveals hidden assumptions. Look for insights that wouldn\'t have surfaced from the original framing. Consider: which insights from the reversal can be integrated back into the original direction?';
+}
+function getGuidance(technique, data, session, stimulus) {
+    switch (technique) {
+        case 'six_hats': return guidanceForSixHats(data.hat, session);
+        case 'provocation': return guidanceForProvocation();
+        case 'random_entry': return guidanceForRandomEntry(stimulus || data.stimulus || 'unknown');
+        case 'challenge': return guidanceForChallenge();
+        case 'alternatives': return guidanceForAlternatives();
+        case 'reversal': return guidanceForReversal();
+    }
+}
+// ============================================================================
+// Core Functions
+// ============================================================================
+export async function startSession(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeProjectError('start lateral session');
+    }
+    const dir = lateralDir(resolved);
+    ensureDir(dir);
+    // Resume existing session
+    if (input.session_id) {
+        const fp = sessionFilePath(dir, input.session_id);
+        try {
+            const session = await loadSession(fp);
+            return {
+                session_id: session.session_id,
+                problem: session.problem,
+                status: session.status,
+                techniques_applied: techniquesApplied(session),
+                path: fp,
+            };
+        }
+        catch {
+            return {
+                error: 'SESSION_NOT_FOUND',
+                message: `Session ${input.session_id} not found.`,
+                hint: 'Check the session_id or create a new session by providing a problem statement.',
+            };
+        }
+    }
+    // New session requires problem
+    if (!input.problem) {
+        return {
+            error: 'MISSING_PROBLEM',
+            message: 'A problem statement is required to start a new session.',
+            hint: 'Provide the "problem" field describing the design challenge.',
+        };
+    }
+    const sessionId = generateSessionId();
+    const now = new Date().toISOString();
+    const session = {
+        session_id: sessionId,
+        project_id: resolved.id,
+        problem: input.problem,
+        context: input.context,
+        status: 'open',
+        created_at: now,
+        entries: [],
+    };
+    const fp = sessionFilePath(dir, sessionId);
+    await saveSession(fp, session, resolved);
+    log(`Lateral: Created session ${sessionId} at ${fp}`);
+    return {
+        session_id: sessionId,
+        problem: input.problem,
+        status: 'open',
+        techniques_applied: [],
+        path: fp,
+    };
+}
+export async function applyTechnique(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeProjectError('apply lateral technique');
+    }
+    const dir = lateralDir(resolved);
+    const fp = sessionFilePath(dir, input.session_id);
+    let session;
+    try {
+        session = await loadSession(fp);
+    }
+    catch {
+        return {
+            error: 'SESSION_NOT_FOUND',
+            message: `Session ${input.session_id} not found.`,
+            hint: 'Start a session first with designer_lateral_session.',
+        };
+    }
+    if (session.status === 'closed') {
+        return {
+            error: 'SESSION_CLOSED',
+            message: `Session ${input.session_id} is already closed.`,
+            hint: 'Start a new session to continue lateral thinking.',
+        };
+    }
+    // Build technique-specific data with validation
+    let data;
+    let effectiveStimulus;
+    const raw = input.input;
+    switch (input.technique) {
+        case 'six_hats': {
+            const hat = raw.hat;
+            if (!hat || !VALID_HATS.includes(hat)) {
+                return { error: 'INVALID_INPUT', message: `Invalid hat color. Must be one of: ${VALID_HATS.join(', ')}` };
+            }
+            if (!raw.thinking) {
+                return { error: 'INVALID_INPUT', message: 'six_hats requires "thinking" field.' };
+            }
+            data = { hat: hat, thinking: raw.thinking };
+            break;
+        }
+        case 'provocation': {
+            if (!raw.po_statement)
+                return { error: 'INVALID_INPUT', message: 'provocation requires "po_statement" field.' };
+            if (!raw.movement)
+                return { error: 'INVALID_INPUT', message: 'provocation requires "movement" field.' };
+            data = {
+                po_statement: raw.po_statement,
+                movement: raw.movement,
+                insights: raw.insights || [],
+            };
+            break;
+        }
+        case 'random_entry': {
+            effectiveStimulus = raw.stimulus || pickRandomStimulus();
+            data = {
+                stimulus: effectiveStimulus,
+                connections: raw.connections || [],
+                promising_leads: raw.promising_leads || [],
+            };
+            break;
+        }
+        case 'challenge': {
+            if (!raw.assumption)
+                return { error: 'INVALID_INPUT', message: 'challenge requires "assumption" field.' };
+            if (!raw.why_exists)
+                return { error: 'INVALID_INPUT', message: 'challenge requires "why_exists" field.' };
+            if (!raw.what_if_false)
+                return { error: 'INVALID_INPUT', message: 'challenge requires "what_if_false" field.' };
+            if (!raw.alternative_framing)
+                return { error: 'INVALID_INPUT', message: 'challenge requires "alternative_framing" field.' };
+            data = {
+                assumption: raw.assumption,
+                why_exists: raw.why_exists,
+                what_if_false: raw.what_if_false,
+                alternative_framing: raw.alternative_framing,
+            };
+            break;
+        }
+        case 'alternatives': {
+            if (!raw.focus)
+                return { error: 'INVALID_INPUT', message: 'alternatives requires "focus" field.' };
+            if (!raw.concept_level)
+                return { error: 'INVALID_INPUT', message: 'alternatives requires "concept_level" field.' };
+            data = {
+                focus: raw.focus,
+                concept_level: raw.concept_level,
+                alternatives: raw.alternatives || [],
+            };
+            break;
+        }
+        case 'reversal': {
+            if (!raw.original)
+                return { error: 'INVALID_INPUT', message: 'reversal requires "original" field.' };
+            if (!raw.reversed)
+                return { error: 'INVALID_INPUT', message: 'reversal requires "reversed" field.' };
+            data = {
+                original: raw.original,
+                reversed: raw.reversed,
+                insights_from_reversal: raw.insights_from_reversal || [],
+            };
+            break;
+        }
+    }
+    const entryId = generateEntryId(input.session_id, input.technique, data);
+    const entry = {
+        entry_id: entryId,
+        technique: input.technique,
+        timestamp: new Date().toISOString(),
+        data,
+    };
+    session.entries.push(entry);
+    await saveSession(fp, session, resolved);
+    const guidance = getGuidance(input.technique, data, session, effectiveStimulus);
+    log(`Lateral: Applied ${input.technique} to session ${input.session_id} (entry ${entryId})`);
+    return {
+        entry_id: entryId,
+        recorded: true,
+        guidance,
+        session_progress: {
+            techniques_applied: techniquesApplied(session),
+            entry_count: session.entries.length,
+        },
+    };
+}
+export async function closeSession(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeProjectError('close lateral session');
+    }
+    const dir = lateralDir(resolved);
+    const fp = sessionFilePath(dir, input.session_id);
+    let session;
+    try {
+        session = await loadSession(fp);
+    }
+    catch {
+        return {
+            error: 'SESSION_NOT_FOUND',
+            message: `Session ${input.session_id} not found.`,
+        };
+    }
+    if (session.status === 'closed') {
+        return {
+            error: 'SESSION_ALREADY_CLOSED',
+            message: `Session ${input.session_id} is already closed.`,
+        };
+    }
+    // Update session
+    session.status = 'closed';
+    session.closed_at = new Date().toISOString();
+    session.synthesis = input.synthesis;
+    session.action_items = input.action_items;
+    session.linked_to = input.link_to;
+    await saveSession(fp, session, resolved);
+    // Generate markdown summary
+    const summaryPath = summaryFilePath(dir, input.session_id);
+    const markdown = generateSummaryMarkdown(session);
+    validateWritePath(summaryPath, resolved);
+    await fs.writeFile(summaryPath, markdown, 'utf-8');
+    // Emit provenance
+    await emitCreateProvenance(`designer:lateral:${input.session_id}`, markdown, `Closed lateral thinking session: ${session.problem}`, input.projectId);
+    log(`Lateral: Closed session ${input.session_id}, summary at ${summaryPath}`);
+    return {
+        session_id: input.session_id,
+        path: fp,
+        summary_path: summaryPath,
+        techniques_applied: session.entries.length,
+    };
+}
+// ============================================================================
+// Summary Markdown Generator
+// ============================================================================
+function generateSummaryMarkdown(session) {
+    const lines = [];
+    // Frontmatter
+    lines.push('---');
+    lines.push(`session_id: ${session.session_id}`);
+    lines.push(`project_id: ${session.project_id}`);
+    lines.push(`status: ${session.status}`);
+    lines.push(`created_at: ${session.created_at}`);
+    if (session.closed_at)
+        lines.push(`closed_at: ${session.closed_at}`);
+    lines.push(`techniques_count: ${session.entries.length}`);
+    if (session.linked_to?.length)
+        lines.push(`linked_to: [${session.linked_to.join(', ')}]`);
+    lines.push('---');
+    lines.push('');
+    // Title
+    lines.push(`# Lateral Thinking Session: ${session.session_id}`);
+    lines.push('');
+    lines.push(`**Problem:** ${session.problem}`);
+    if (session.context) {
+        lines.push('');
+        lines.push(`**Context:** ${session.context}`);
+    }
+    lines.push('');
+    // Group entries by technique
+    const grouped = new Map();
+    for (const entry of session.entries) {
+        const key = entry.technique;
+        if (!grouped.has(key))
+            grouped.set(key, []);
+        grouped.get(key).push(entry);
+    }
+    for (const [technique, entries] of grouped) {
+        lines.push(`## ${formatTechniqueName(technique)}`);
+        lines.push('');
+        for (const entry of entries) {
+            lines.push(`### ${entry.entry_id}`);
+            lines.push(`*${entry.timestamp}*`);
+            lines.push('');
+            lines.push(formatEntryData(entry));
+            lines.push('');
+        }
+    }
+    // Synthesis
+    if (session.synthesis) {
+        lines.push('## Synthesis');
+        lines.push('');
+        lines.push(session.synthesis);
+        lines.push('');
+    }
+    // Action items
+    if (session.action_items?.length) {
+        lines.push('## Action Items');
+        lines.push('');
+        for (const item of session.action_items) {
+            lines.push(`- [ ] ${item}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatTechniqueName(technique) {
+    const names = {
+        six_hats: 'Six Thinking Hats',
+        provocation: 'Provocation (Po)',
+        random_entry: 'Random Entry',
+        challenge: 'Challenge',
+        alternatives: 'Alternatives (Concept Fan)',
+        reversal: 'Reversal',
+    };
+    return names[technique] || technique;
+}
+function formatEntryData(entry) {
+    const lines = [];
+    switch (entry.technique) {
+        case 'six_hats': {
+            const d = entry.data;
+            lines.push(`**Hat:** ${d.hat.toUpperCase()}`);
+            lines.push('');
+            lines.push(d.thinking);
+            break;
+        }
+        case 'provocation': {
+            const d = entry.data;
+            lines.push(`**Po:** ${d.po_statement}`);
+            lines.push('');
+            lines.push(`**Movement:** ${d.movement}`);
+            if (d.insights.length) {
+                lines.push('');
+                lines.push('**Insights:**');
+                for (const i of d.insights)
+                    lines.push(`- ${i}`);
+            }
+            break;
+        }
+        case 'random_entry': {
+            const d = entry.data;
+            lines.push(`**Stimulus:** ${d.stimulus}`);
+            if (d.connections.length) {
+                lines.push('');
+                lines.push('**Connections:**');
+                for (const c of d.connections)
+                    lines.push(`- ${c}`);
+            }
+            if (d.promising_leads.length) {
+                lines.push('');
+                lines.push('**Promising Leads:**');
+                for (const l of d.promising_leads)
+                    lines.push(`- ${l}`);
+            }
+            break;
+        }
+        case 'challenge': {
+            const d = entry.data;
+            lines.push(`**Assumption:** ${d.assumption}`);
+            lines.push('');
+            lines.push(`**Why it exists:** ${d.why_exists}`);
+            lines.push('');
+            lines.push(`**What if false:** ${d.what_if_false}`);
+            lines.push('');
+            lines.push(`**Alternative framing:** ${d.alternative_framing}`);
+            break;
+        }
+        case 'alternatives': {
+            const d = entry.data;
+            lines.push(`**Focus:** ${d.focus}`);
+            lines.push(`**Concept level:** ${d.concept_level}`);
+            if (d.alternatives.length) {
+                lines.push('');
+                for (const a of d.alternatives) {
+                    lines.push(`- **${a.idea}**: ${a.approach}`);
+                }
+            }
+            break;
+        }
+        case 'reversal': {
+            const d = entry.data;
+            lines.push(`**Original:** ${d.original}`);
+            lines.push('');
+            lines.push(`**Reversed:** ${d.reversed}`);
+            if (d.insights_from_reversal.length) {
+                lines.push('');
+                lines.push('**Insights from reversal:**');
+                for (const i of d.insights_from_reversal)
+                    lines.push(`- ${i}`);
+            }
+            break;
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=lateral.js.map