claude-code-workflow 6.3.54 → 7.0.0

package/ccw/dist/core/memory-consolidation-pipeline.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Memory Consolidation Pipeline - Phase 2 Global Consolidation
+ *
+ * Orchestrates the global memory consolidation process:
+ *   Lock -> Materialize -> Agent -> Monitor -> Done
+ *
+ * Phase 1 outputs (per-session extractions stored in stage1_outputs DB table)
+ * are materialized to disk as rollout_summaries/*.md + raw_memories.md,
+ * then a CLI agent (--mode write) reads those files and produces MEMORY.md.
+ *
+ * The pipeline uses lease-based locking via MemoryJobScheduler to ensure
+ * only one consolidation runs at a time, with heartbeat-based lease renewal.
+ */
+import { type ClaimResult } from './memory-job-scheduler.js';
+import { type Stage1Output } from './core-memory-store.js';
+export interface ConsolidationStatus {
+    status: 'idle' | 'running' | 'completed' | 'error';
+    lastRun?: number;
+    memoryMdExists: boolean;
+    inputCount: number;
+    lastError?: string;
+}
+export interface MaterializationResult {
+    summariesWritten: number;
+    summariesPruned: number;
+    rawMemoriesSize: number;
+}
+/**
+ * Write one .md file per stage1_output to rollout_summaries/, prune orphans.
+ *
+ * Each file is named {sanitized_thread_id}.md and contains the rollout_summary.
+ * Files in the directory that do not correspond to any DB row are deleted.
+ */
+export declare function syncRolloutSummaries(memoryHome: string, outputs: Stage1Output[]): MaterializationResult;
+/**
+ * Concatenate the latest raw_memory entries into raw_memories.md with thread headers.
+ *
+ * Entries are sorted by generated_at descending, limited to maxCount.
+ * Format per entry:
+ *   ## Thread: {thread_id}
+ *   {raw_memory content}
+ *   ---
+ *
+ * @returns The byte size of the written raw_memories.md file.
+ */
+export declare function rebuildRawMemories(memoryHome: string, outputs: Stage1Output[], maxCount: number): number;
+/**
+ * Read MEMORY.md content for session prompt injection.
+ *
+ * @param projectPath - Project root path (used to resolve storage paths)
+ * @returns MEMORY.md content string, or null if the file does not exist
+ */
+export declare function getMemoryMdContent(projectPath: string): string | null;
+/**
+ * MemoryConsolidationPipeline orchestrates global memory consolidation:
+ *   1. Claim global lock via job scheduler
+ *   2. Materialize Phase 1 outputs to disk (rollout_summaries/ + raw_memories.md)
+ *   3. Invoke consolidation agent via executeCliTool --mode write
+ *   4. Monitor with heartbeat lease renewal
+ *   5. Mark job as succeeded or failed
+ */
+export declare class MemoryConsolidationPipeline {
+    private projectPath;
+    private store;
+    private scheduler;
+    private memoryHome;
+    private cliTool;
+    constructor(projectPath: string, cliTool?: string);
+    /**
+     * Attempt to claim the global consolidation lock.
+     *
+     * Before claiming, ensures the job row exists and checks dirtiness.
+     * The job scheduler handles the actual concurrency control.
+     */
+    claimGlobalLock(): ClaimResult;
+    /**
+     * Materialize rollout summaries from DB to disk.
+     * Writes one .md file per stage1_output row, prunes orphan files.
+     */
+    materializeSummaries(): MaterializationResult;
+    /**
+     * Rebuild raw_memories.md from DB entries.
+     * Concatenates the latest entries up to MAX_RAW_MEMORIES_FOR_GLOBAL.
+     */
+    materializeRawMemories(): number;
+    /**
+     * Run the consolidation agent via executeCliTool with --mode write.
+     * Starts a heartbeat timer to keep the lease alive during agent execution.
+     *
+     * @param token - Ownership token from claimGlobalLock
+     * @returns true if agent completed successfully, false otherwise
+     */
+    runConsolidationAgent(token: string): Promise<boolean>;
+    /**
+     * Verify that Phase 1 artifacts were not modified by the agent.
+     * Compares file count in rollout_summaries/ before and after agent run.
+     *
+     * @param expectedSummaryCount - Number of summaries before agent run
+     * @returns true if artifacts are intact
+     */
+    verifyPhase1Integrity(expectedSummaryCount: number): boolean;
+    /**
+     * Get the current consolidation status.
+     */
+    getStatus(): ConsolidationStatus;
+    /**
+     * Read MEMORY.md content for session prompt injection.
+     * Convenience method that delegates to the standalone function.
+     */
+    getMemoryMdContent(): string | null;
+    /**
+     * Run the full consolidation pipeline.
+     *
+     * Pipeline flow:
+     *   1. Check if there are inputs to process
+     *   2. Claim global lock
+     *   3. Materialize Phase 1 outputs to disk
+     *   4. Run consolidation agent with heartbeat
+     *   5. Verify Phase 1 integrity
+     *   6. Mark job as succeeded or failed
+     *
+     * @returns Final consolidation status
+     */
+    runConsolidation(): Promise<ConsolidationStatus>;
+}
+//# sourceMappingURL=memory-consolidation-pipeline.d.ts.map

package/ccw/dist/core/memory-consolidation-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-consolidation-pipeline.d.ts","sourceRoot":"","sources":["../../src/core/memory-consolidation-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAa/E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAsBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,EAAE,GACtB,qBAAqB,CAyCvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,CA0BR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAarE;AAID;;;;;;;GAOG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;gBAEZ,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAQjD;;;;;OAKG;IACH,eAAe,IAAI,WAAW;IAI9B;;;OAGG;IACH,oBAAoB,IAAI,qBAAqB;IAK7C;;;OAGG;IACH,sBAAsB,IAAI,MAAM;IAShC;;;;;;OAMG;IACG,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqD5D;;;;;;OAMG;IACH,qBAAqB,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO;IAQ5D;;OAEG;IACH,SAAS,IAAI,mBAAmB;IA6BhC;;;OAGG;IACH,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAInC;;;;;;;;;;;;OAYG;IACG,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC;CA4GvD"}

package/ccw/dist/core/memory-consolidation-pipeline.js

@@ -0,0 +1,364 @@
+/**
+ * Memory Consolidation Pipeline - Phase 2 Global Consolidation
+ *
+ * Orchestrates the global memory consolidation process:
+ *   Lock -> Materialize -> Agent -> Monitor -> Done
+ *
+ * Phase 1 outputs (per-session extractions stored in stage1_outputs DB table)
+ * are materialized to disk as rollout_summaries/*.md + raw_memories.md,
+ * then a CLI agent (--mode write) reads those files and produces MEMORY.md.
+ *
+ * The pipeline uses lease-based locking via MemoryJobScheduler to ensure
+ * only one consolidation runs at a time, with heartbeat-based lease renewal.
+ */
+import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { MemoryJobScheduler } from './memory-job-scheduler.js';
+import { getCoreMemoryStore } from './core-memory-store.js';
+import { getProjectPaths, ensureStorageDir } from '../config/storage-paths.js';
+import { HEARTBEAT_INTERVAL_SECONDS, MAX_RAW_MEMORIES_FOR_GLOBAL, } from './memory-v2-config.js';
+import { CONSOLIDATION_SYSTEM_PROMPT, buildConsolidationPrompt, } from './memory-consolidation-prompts.js';
+// -- Constants --
+const JOB_KIND = 'memory_consolidate_global';
+const JOB_KEY = 'global';
+const MAX_CONCURRENT = 1;
+const AGENT_TIMEOUT_MS = 300_000; // 5 minutes
+const DEFAULT_CLI_TOOL = 'gemini';
+// -- Utility --
+/**
+ * Sanitize a thread ID for use as a filename.
+ * Replaces filesystem-unsafe characters with underscores.
+ */
+function sanitizeFilename(name) {
+    return name.replace(/[<>:"/\\|?*\x00-\x1f]/g, '_');
+}
+// -- Standalone Functions --
+/**
+ * Write one .md file per stage1_output to rollout_summaries/, prune orphans.
+ *
+ * Each file is named {sanitized_thread_id}.md and contains the rollout_summary.
+ * Files in the directory that do not correspond to any DB row are deleted.
+ */
+export function syncRolloutSummaries(memoryHome, outputs) {
+    const summariesDir = join(memoryHome, 'rollout_summaries');
+    ensureStorageDir(summariesDir);
+    // Build set of expected filenames
+    const expectedFiles = new Set();
+    let summariesWritten = 0;
+    for (const output of outputs) {
+        const filename = `${sanitizeFilename(output.thread_id)}.md`;
+        expectedFiles.add(filename);
+        const filePath = join(summariesDir, filename);
+        // Write summary content with thread header
+        const content = [
+            `# Session: ${output.thread_id}`,
+            `> Generated: ${new Date(output.generated_at * 1000).toISOString()}`,
+            `> Source updated: ${new Date(output.source_updated_at * 1000).toISOString()}`,
+            '',
+            output.rollout_summary,
+        ].join('\n');
+        writeFileSync(filePath, content, 'utf-8');
+        summariesWritten++;
+    }
+    // Prune orphan files not in DB
+    let summariesPruned = 0;
+    const existingFiles = readdirSync(summariesDir);
+    for (const file of existingFiles) {
+        if (file.endsWith('.md') && !expectedFiles.has(file)) {
+            unlinkSync(join(summariesDir, file));
+            summariesPruned++;
+        }
+    }
+    return {
+        summariesWritten,
+        summariesPruned,
+        rawMemoriesSize: 0, // Not applicable for this function
+    };
+}
+/**
+ * Concatenate the latest raw_memory entries into raw_memories.md with thread headers.
+ *
+ * Entries are sorted by generated_at descending, limited to maxCount.
+ * Format per entry:
+ *   ## Thread: {thread_id}
+ *   {raw_memory content}
+ *   ---
+ *
+ * @returns The byte size of the written raw_memories.md file.
+ */
+export function rebuildRawMemories(memoryHome, outputs, maxCount) {
+    ensureStorageDir(memoryHome);
+    // Sort by generated_at descending, take up to maxCount
+    const sorted = [...outputs]
+        .sort((a, b) => b.generated_at - a.generated_at)
+        .slice(0, maxCount);
+    const sections = [];
+    for (const output of sorted) {
+        sections.push(`## Thread: ${output.thread_id}`, `> Generated: ${new Date(output.generated_at * 1000).toISOString()}`, '', output.raw_memory, '', '---', '');
+    }
+    const content = sections.join('\n');
+    const filePath = join(memoryHome, 'raw_memories.md');
+    writeFileSync(filePath, content, 'utf-8');
+    return Buffer.byteLength(content, 'utf-8');
+}
+/**
+ * Read MEMORY.md content for session prompt injection.
+ *
+ * @param projectPath - Project root path (used to resolve storage paths)
+ * @returns MEMORY.md content string, or null if the file does not exist
+ */
+export function getMemoryMdContent(projectPath) {
+    const paths = getProjectPaths(projectPath);
+    const memoryMdPath = paths.memoryV2.memoryMd;
+    if (!existsSync(memoryMdPath)) {
+        return null;
+    }
+    try {
+        return readFileSync(memoryMdPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+// -- Pipeline Class --
+/**
+ * MemoryConsolidationPipeline orchestrates global memory consolidation:
+ *   1. Claim global lock via job scheduler
+ *   2. Materialize Phase 1 outputs to disk (rollout_summaries/ + raw_memories.md)
+ *   3. Invoke consolidation agent via executeCliTool --mode write
+ *   4. Monitor with heartbeat lease renewal
+ *   5. Mark job as succeeded or failed
+ */
+export class MemoryConsolidationPipeline {
+    projectPath;
+    store;
+    scheduler;
+    memoryHome;
+    cliTool;
+    constructor(projectPath, cliTool) {
+        this.projectPath = projectPath;
+        this.store = getCoreMemoryStore(projectPath);
+        this.scheduler = new MemoryJobScheduler(this.store.getDb());
+        this.memoryHome = getProjectPaths(projectPath).memoryV2.root;
+        this.cliTool = cliTool || DEFAULT_CLI_TOOL;
+    }
+    /**
+     * Attempt to claim the global consolidation lock.
+     *
+     * Before claiming, ensures the job row exists and checks dirtiness.
+     * The job scheduler handles the actual concurrency control.
+     */
+    claimGlobalLock() {
+        return this.scheduler.claimJob(JOB_KIND, JOB_KEY, MAX_CONCURRENT);
+    }
+    /**
+     * Materialize rollout summaries from DB to disk.
+     * Writes one .md file per stage1_output row, prunes orphan files.
+     */
+    materializeSummaries() {
+        const outputs = this.store.listStage1Outputs();
+        return syncRolloutSummaries(this.memoryHome, outputs);
+    }
+    /**
+     * Rebuild raw_memories.md from DB entries.
+     * Concatenates the latest entries up to MAX_RAW_MEMORIES_FOR_GLOBAL.
+     */
+    materializeRawMemories() {
+        const outputs = this.store.listStage1Outputs();
+        return rebuildRawMemories(this.memoryHome, outputs, MAX_RAW_MEMORIES_FOR_GLOBAL);
+    }
+    /**
+     * Run the consolidation agent via executeCliTool with --mode write.
+     * Starts a heartbeat timer to keep the lease alive during agent execution.
+     *
+     * @param token - Ownership token from claimGlobalLock
+     * @returns true if agent completed successfully, false otherwise
+     */
+    async runConsolidationAgent(token) {
+        // Lazy import to avoid circular dependencies at module load time
+        const { executeCliTool } = await import('../tools/cli-executor-core.js');
+        // Determine input state for prompt
+        const summariesDir = join(this.memoryHome, 'rollout_summaries');
+        let summaryCount = 0;
+        if (existsSync(summariesDir)) {
+            summaryCount = readdirSync(summariesDir).filter(f => f.endsWith('.md')).length;
+        }
+        const hasExistingMemoryMd = existsSync(join(this.memoryHome, 'MEMORY.md'));
+        // Ensure skills directory exists
+        ensureStorageDir(join(this.memoryHome, 'skills'));
+        // Build the full prompt
+        const userPrompt = buildConsolidationPrompt(summaryCount, hasExistingMemoryMd);
+        const fullPrompt = `${CONSOLIDATION_SYSTEM_PROMPT}\n\n${userPrompt}`;
+        // Start heartbeat timer
+        const heartbeatMs = HEARTBEAT_INTERVAL_SECONDS * 1000;
+        const heartbeatTimer = setInterval(() => {
+            const renewed = this.scheduler.heartbeat(JOB_KIND, JOB_KEY, token);
+            if (!renewed) {
+                // Heartbeat rejected - lease was lost
+                clearInterval(heartbeatTimer);
+            }
+        }, heartbeatMs);
+        try {
+            // Execute the consolidation agent
+            const result = await Promise.race([
+                executeCliTool({
+                    tool: this.cliTool,
+                    prompt: fullPrompt,
+                    mode: 'write',
+                    cd: this.memoryHome,
+                    category: 'internal',
+                }),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Consolidation agent timed out')), AGENT_TIMEOUT_MS)),
+            ]);
+            return result.success;
+        }
+        finally {
+            clearInterval(heartbeatTimer);
+        }
+    }
+    /**
+     * Verify that Phase 1 artifacts were not modified by the agent.
+     * Compares file count in rollout_summaries/ before and after agent run.
+     *
+     * @param expectedSummaryCount - Number of summaries before agent run
+     * @returns true if artifacts are intact
+     */
+    verifyPhase1Integrity(expectedSummaryCount) {
+        const summariesDir = join(this.memoryHome, 'rollout_summaries');
+        if (!existsSync(summariesDir))
+            return expectedSummaryCount === 0;
+        const currentCount = readdirSync(summariesDir).filter(f => f.endsWith('.md')).length;
+        return currentCount === expectedSummaryCount;
+    }
+    /**
+     * Get the current consolidation status.
+     */
+    getStatus() {
+        const jobStatus = this.scheduler.getJobStatus(JOB_KIND, JOB_KEY);
+        const inputCount = this.store.countStage1Outputs();
+        const memoryMdExists = existsSync(join(this.memoryHome, 'MEMORY.md'));
+        if (!jobStatus) {
+            return {
+                status: 'idle',
+                memoryMdExists,
+                inputCount,
+            };
+        }
+        const statusMap = {
+            pending: 'idle',
+            running: 'running',
+            done: 'completed',
+            error: 'error',
+        };
+        return {
+            status: statusMap[jobStatus.status] || 'idle',
+            lastRun: jobStatus.finished_at,
+            memoryMdExists,
+            inputCount,
+            lastError: jobStatus.last_error,
+        };
+    }
+    /**
+     * Read MEMORY.md content for session prompt injection.
+     * Convenience method that delegates to the standalone function.
+     */
+    getMemoryMdContent() {
+        return getMemoryMdContent(this.projectPath);
+    }
+    /**
+     * Run the full consolidation pipeline.
+     *
+     * Pipeline flow:
+     *   1. Check if there are inputs to process
+     *   2. Claim global lock
+     *   3. Materialize Phase 1 outputs to disk
+     *   4. Run consolidation agent with heartbeat
+     *   5. Verify Phase 1 integrity
+     *   6. Mark job as succeeded or failed
+     *
+     * @returns Final consolidation status
+     */
+    async runConsolidation() {
+        // Step 1: Check inputs
+        const inputCount = this.store.countStage1Outputs();
+        if (inputCount === 0) {
+            return {
+                status: 'idle',
+                memoryMdExists: existsSync(join(this.memoryHome, 'MEMORY.md')),
+                inputCount: 0,
+            };
+        }
+        // Step 2: Claim global lock
+        const claim = this.claimGlobalLock();
+        if (!claim.claimed || !claim.ownership_token) {
+            return {
+                status: claim.reason === 'already_running' ? 'running' : 'idle',
+                memoryMdExists: existsSync(join(this.memoryHome, 'MEMORY.md')),
+                inputCount,
+                lastError: claim.reason
+                    ? `Lock not acquired: ${claim.reason}`
+                    : undefined,
+            };
+        }
+        const token = claim.ownership_token;
+        try {
+            // Step 3: Materialize Phase 1 outputs to disk
+            const matResult = this.materializeSummaries();
+            const rawMemoriesSize = this.materializeRawMemories();
+            const expectedSummaryCount = matResult.summariesWritten;
+            // Step 4: Run consolidation agent with heartbeat
+            const agentSuccess = await this.runConsolidationAgent(token);
+            if (!agentSuccess) {
+                this.scheduler.markFailed(JOB_KIND, JOB_KEY, token, 'Consolidation agent returned failure');
+                return {
+                    status: 'error',
+                    memoryMdExists: existsSync(join(this.memoryHome, 'MEMORY.md')),
+                    inputCount,
+                    lastError: 'Consolidation agent returned failure',
+                };
+            }
+            // Step 5: Verify Phase 1 integrity
+            if (!this.verifyPhase1Integrity(expectedSummaryCount)) {
+                this.scheduler.markFailed(JOB_KIND, JOB_KEY, token, 'Phase 1 artifacts were modified during consolidation');
+                return {
+                    status: 'error',
+                    memoryMdExists: existsSync(join(this.memoryHome, 'MEMORY.md')),
+                    inputCount,
+                    lastError: 'Phase 1 artifacts were modified during consolidation',
+                };
+            }
+            // Step 6: Check that MEMORY.md was actually produced
+            const memoryMdExists = existsSync(join(this.memoryHome, 'MEMORY.md'));
+            if (!memoryMdExists) {
+                this.scheduler.markFailed(JOB_KIND, JOB_KEY, token, 'Agent completed but MEMORY.md was not produced');
+                return {
+                    status: 'error',
+                    memoryMdExists: false,
+                    inputCount,
+                    lastError: 'Agent completed but MEMORY.md was not produced',
+                };
+            }
+            // Step 7: Mark success with watermark
+            // Use the current input count as the success watermark
+            const watermark = inputCount;
+            this.scheduler.markSucceeded(JOB_KIND, JOB_KEY, token, watermark);
+            return {
+                status: 'completed',
+                lastRun: Math.floor(Date.now() / 1000),
+                memoryMdExists: true,
+                inputCount,
+            };
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            this.scheduler.markFailed(JOB_KIND, JOB_KEY, token, errorMessage);
+            return {
+                status: 'error',
+                memoryMdExists: existsSync(join(this.memoryHome, 'MEMORY.md')),
+                inputCount,
+                lastError: errorMessage,
+            };
+        }
+    }
+}
+//# sourceMappingURL=memory-consolidation-pipeline.js.map

package/ccw/dist/core/memory-consolidation-pipeline.js.map

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

package/ccw/dist/core/memory-consolidation-prompts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Memory Consolidation Prompts - Phase 2 LLM Agent Prompt Templates
+ *
+ * System prompt and instruction templates for the consolidation agent that
+ * reads Phase 1 outputs (rollout_summaries/ + raw_memories.md) and produces
+ * MEMORY.md (and optional skills/ files).
+ *
+ * Design: The agent runs with --mode write in the MEMORY_HOME directory,
+ * using standard file read/write tools to produce output.
+ */
+/**
+ * System-level instructions for the consolidation agent.
+ * This is prepended to every consolidation prompt.
+ */
+export declare const CONSOLIDATION_SYSTEM_PROMPT = "You are a memory consolidation agent. Your job is to read phase-1 extraction artifacts and produce a consolidated MEMORY.md file that captures the most important, actionable knowledge from recent coding sessions.\n\n## CRITICAL RULES\n\n1. **Do NOT modify phase-1 artifacts.** The files in rollout_summaries/ and raw_memories.md are READ-ONLY inputs. Never edit, delete, or overwrite them.\n2. **Output only to MEMORY.md** (and optionally skills/ directory). Do not create files outside these paths.\n3. **Be concise and actionable.** Every line in MEMORY.md should help a future coding session be more productive.\n4. **Resolve conflicts.** When rollout summaries and raw memories disagree, prefer the more recent or more specific information.\n5. **Deduplicate.** Merge overlapping knowledge from different sessions into single authoritative entries.\n6. **Preserve attribution.** When a piece of knowledge comes from a specific session thread, note it briefly.";
+/**
+ * Build the full consolidation prompt given the MEMORY_HOME directory path.
+ *
+ * The agent will be invoked with --cd pointing to memoryHome, so all file
+ * references are relative to that directory.
+ *
+ * @param inputSummaryCount - Number of rollout summary files available
+ * @param hasExistingMemoryMd - Whether a previous MEMORY.md exists to update
+ * @returns Complete prompt string for executeCliTool
+ */
+export declare function buildConsolidationPrompt(inputSummaryCount: number, hasExistingMemoryMd: boolean): string;
+//# sourceMappingURL=memory-consolidation-prompts.d.ts.map

package/ccw/dist/core/memory-consolidation-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-consolidation-prompts.d.ts","sourceRoot":"","sources":["../../src/core/memory-consolidation-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,eAAO,MAAM,2BAA2B,w8BASsE,CAAC;AAE/G;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,iBAAiB,EAAE,MAAM,EACzB,mBAAmB,EAAE,OAAO,GAC3B,MAAM,CAoER"}

package/ccw/dist/core/memory-consolidation-prompts.js

@@ -0,0 +1,103 @@
+/**
+ * Memory Consolidation Prompts - Phase 2 LLM Agent Prompt Templates
+ *
+ * System prompt and instruction templates for the consolidation agent that
+ * reads Phase 1 outputs (rollout_summaries/ + raw_memories.md) and produces
+ * MEMORY.md (and optional skills/ files).
+ *
+ * Design: The agent runs with --mode write in the MEMORY_HOME directory,
+ * using standard file read/write tools to produce output.
+ */
+/**
+ * System-level instructions for the consolidation agent.
+ * This is prepended to every consolidation prompt.
+ */
+export const CONSOLIDATION_SYSTEM_PROMPT = `You are a memory consolidation agent. Your job is to read phase-1 extraction artifacts and produce a consolidated MEMORY.md file that captures the most important, actionable knowledge from recent coding sessions.
+
+## CRITICAL RULES
+
+1. **Do NOT modify phase-1 artifacts.** The files in rollout_summaries/ and raw_memories.md are READ-ONLY inputs. Never edit, delete, or overwrite them.
+2. **Output only to MEMORY.md** (and optionally skills/ directory). Do not create files outside these paths.
+3. **Be concise and actionable.** Every line in MEMORY.md should help a future coding session be more productive.
+4. **Resolve conflicts.** When rollout summaries and raw memories disagree, prefer the more recent or more specific information.
+5. **Deduplicate.** Merge overlapping knowledge from different sessions into single authoritative entries.
+6. **Preserve attribution.** When a piece of knowledge comes from a specific session thread, note it briefly.`;
+/**
+ * Build the full consolidation prompt given the MEMORY_HOME directory path.
+ *
+ * The agent will be invoked with --cd pointing to memoryHome, so all file
+ * references are relative to that directory.
+ *
+ * @param inputSummaryCount - Number of rollout summary files available
+ * @param hasExistingMemoryMd - Whether a previous MEMORY.md exists to update
+ * @returns Complete prompt string for executeCliTool
+ */
+export function buildConsolidationPrompt(inputSummaryCount, hasExistingMemoryMd) {
+    const action = hasExistingMemoryMd ? 'UPDATE' : 'CREATE';
+    return `## Task: ${action} MEMORY.md
+
+You have access to the following phase-1 artifacts in the current directory:
+
+### Input Files (READ-ONLY - do NOT modify these)
+- **rollout_summaries/*.md** - ${inputSummaryCount} per-session summary files. Each contains a concise summary of what was accomplished in that coding session. Use these for high-level routing and prioritization.
+- **raw_memories.md** - Concatenated detailed memories from recent sessions, organized by thread. Use this for detailed knowledge extraction and cross-referencing.
+${hasExistingMemoryMd ? '- **MEMORY.md** - The existing consolidated memory file. Update it with new knowledge while preserving still-relevant existing content.' : ''}
+
+### Your Process
+1. Read all files in rollout_summaries/ to understand the scope and themes of recent sessions.
+2. Read raw_memories.md to extract detailed, actionable knowledge.
+3. Cross-reference summaries with raw memories to identify:
+   - High-signal patterns and conventions discovered
+   - Architecture decisions and their rationale
+   - Common pitfalls and their solutions
+   - Key APIs, interfaces, and integration points
+   - Testing patterns and debugging approaches
+${hasExistingMemoryMd ? '4. Read the existing MEMORY.md and merge new knowledge, removing stale entries.' : '4. Organize extracted knowledge into the output structure below.'}
+5. Write the consolidated MEMORY.md file.
+6. Optionally, if there are reusable code patterns or workflows worth extracting, create files in the skills/ directory.
+
+### Output: MEMORY.md Structure
+
+Write MEMORY.md with the following sections. Omit any section that has no relevant content.
+
+\`\`\`markdown
+# Project Memory
+
+> Auto-generated by memory consolidation. Last updated: [current date]
+> Sources: [number] session summaries, [number] raw memory entries
+
+## Architecture & Structure
+<!-- Key architectural decisions, module boundaries, data flow patterns -->
+
+## Code Conventions
+<!-- Naming conventions, import patterns, error handling approaches, formatting rules -->
+
+## Common Patterns
+<!-- Reusable patterns discovered across sessions: state management, API calls, testing approaches -->
+
+## Key APIs & Interfaces
+<!-- Important interfaces, function signatures, configuration schemas that are frequently referenced -->
+
+## Known Issues & Gotchas
+<!-- Pitfalls, edge cases, platform-specific behaviors, workarounds -->
+
+## Recent Decisions
+<!-- Decisions made in recent sessions with brief rationale. Remove when no longer relevant. -->
+
+## Session Insights
+<!-- High-value observations from individual sessions worth preserving -->
+\`\`\`
+
+### Output: skills/ Directory (Optional)
+
+If you identify reusable code snippets, shell commands, or workflow templates that appear across multiple sessions, create files in the skills/ directory:
+- skills/[name].md - Each file should be a self-contained, copy-paste ready reference
+
+### Quality Criteria
+- Every entry should be actionable (helps write better code or avoid mistakes)
+- No vague platitudes - be specific with file paths, function names, config values
+- Prefer concrete examples over abstract descriptions
+- Keep total MEMORY.md under 5000 words - be ruthlessly concise
+- Remove outdated information that contradicts newer findings`;
+}
+//# sourceMappingURL=memory-consolidation-prompts.js.map

package/ccw/dist/core/memory-consolidation-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-consolidation-prompts.js","sourceRoot":"","sources":["../../src/core/memory-consolidation-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;8GASmE,CAAC;AAE/G;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CACtC,iBAAyB,EACzB,mBAA4B;IAE5B,MAAM,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEzD,OAAO,YAAY,MAAM;;;;;iCAKM,iBAAiB;;EAEhD,mBAAmB,CAAC,CAAC,CAAC,yIAAyI,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;EAWpK,mBAAmB,CAAC,CAAC,CAAC,iFAAiF,CAAC,CAAC,CAAC,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DA8ChH,CAAC;AAC/D,CAAC"}