@hongmaple0820/scale-engine 0.18.0 → 0.20.0

package/dist/memory/MemoryFabric.d.ts

@@ -0,0 +1,118 @@
+import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
+import { RuntimeEvidenceLedger } from '../runtime/RuntimeEvidenceLedger.js';
+import { SessionLedger, type RuntimeSessionLevel } from '../runtime/SessionLedger.js';
+export interface MemoryFabricOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    evidenceLedger?: RuntimeEvidenceLedger;
+    sessionLedger?: SessionLedger;
+    knowledgeBase?: Pick<IKnowledgeBase, 'recall' | 'recallByVector'>;
+}
+export interface ContextPackInput {
+    task: string;
+    taskId?: string;
+    sessionId?: string;
+    level?: RuntimeSessionLevel;
+    files?: string[];
+    budgetTokens?: number;
+    knowledgeTopK?: number;
+}
+export interface ContextPackTask {
+    task: string;
+    taskId?: string;
+    sessionId?: string;
+    level: RuntimeSessionLevel;
+    files: string[];
+}
+export interface ContextPackBudget {
+    limit: number;
+    used: number;
+    remaining: number;
+    overBudget: boolean;
+}
+export interface ContextPackSection {
+    id: string;
+    title: string;
+    priority: number;
+    estimatedTokens: number;
+    included: boolean;
+    reason?: string;
+    items: ContextPackItem[];
+}
+export interface ContextPackOmittedSection {
+    id: string;
+    title: string;
+    reason: string;
+    estimatedTokens: number;
+}
+export interface ContextPack {
+    version: '1.0';
+    generatedAt: string;
+    task: ContextPackTask;
+    budget: ContextPackBudget;
+    sections: ContextPackSection[];
+    omittedSections: ContextPackOmittedSection[];
+}
+export type ContextPackItem = RuntimeEvidenceContextItem | RuntimeSessionContextItem | KnowledgeContextItem | GraphContextItem;
+export interface RuntimeEvidenceContextItem {
+    type: 'runtime-evidence';
+    id: string;
+    kind: string;
+    title: string;
+    status: string;
+    command?: string;
+    exitCode?: number;
+    summary: string;
+    createdAt: string;
+    artifacts?: string[];
+}
+export interface RuntimeSessionContextItem {
+    type: 'session-event';
+    id: string;
+    eventType: string;
+    phase?: string;
+    message?: string;
+    createdAt: string;
+}
+export interface KnowledgeContextItem {
+    type: 'knowledge';
+    id: string;
+    title: string;
+    tags: string[];
+    contentRef: string;
+    verified: boolean;
+    relevance: number;
+    preview?: string;
+}
+export interface GraphContextItem {
+    type: 'graph';
+    path: string;
+    kind: 'graph-report' | 'graph-manifest';
+    summary: string;
+}
+export declare class MemoryFabric {
+    private projectDir;
+    private scaleRoot;
+    private evidenceLedger;
+    private sessionLedger;
+    private knowledgeBase?;
+    constructor(options?: MemoryFabricOptions);
+    createContextPack(input: ContextPackInput): Promise<ContextPack>;
+    private runtimeEvidenceSection;
+    private sessionEventsSection;
+    private knowledgeSection;
+    private graphSection;
+    private toKnowledgeItem;
+}
+export interface MemoryDoctorCheck {
+    name: string;
+    status: 'ok' | 'warn' | 'fail';
+    message: string;
+}
+export interface MemoryDoctorReport {
+    ok: boolean;
+    checks: MemoryDoctorCheck[];
+    pack: ContextPack;
+}
+export declare function doctorMemoryFabric(options: MemoryFabricOptions, input: ContextPackInput): Promise<MemoryDoctorReport>;
+export declare function renderContextPackMarkdown(pack: ContextPack): string;

package/dist/memory/MemoryFabric.js

@@ -0,0 +1,281 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, join, relative, resolve } from 'node:path';
+import { RuntimeEvidenceLedger } from '../runtime/RuntimeEvidenceLedger.js';
+import { SessionLedger } from '../runtime/SessionLedger.js';
+import { redactEvidenceText } from '../tools/ToolEvidenceStore.js';
+const DEFAULT_BUDGET_TOKENS = 4_000;
+const DEFAULT_KNOWLEDGE_TOP_K = 5;
+export class MemoryFabric {
+    constructor(options = {}) {
+        this.projectDir = resolve(options.projectDir ?? process.cwd());
+        this.scaleRoot = isAbsolute(options.scaleDir ?? '')
+            ? options.scaleDir
+            : join(this.projectDir, options.scaleDir ?? '.scale');
+        this.evidenceLedger = options.evidenceLedger ?? new RuntimeEvidenceLedger({
+            projectDir: this.projectDir,
+            scaleDir: this.scaleRoot,
+            createDirs: false,
+        });
+        this.sessionLedger = options.sessionLedger ?? new SessionLedger({
+            projectDir: this.projectDir,
+            scaleDir: this.scaleRoot,
+            createDirs: false,
+        });
+        this.knowledgeBase = options.knowledgeBase;
+    }
+    async createContextPack(input) {
+        const currentSession = this.sessionLedger.current();
+        const task = {
+            task: input.task,
+            taskId: input.taskId ?? currentSession?.taskId,
+            sessionId: input.sessionId ?? currentSession?.sessionId,
+            level: input.level ?? currentSession?.level ?? 'M',
+            files: input.files ?? [],
+        };
+        const budgetLimit = Math.max(1, Math.floor(input.budgetTokens ?? DEFAULT_BUDGET_TOKENS));
+        const baseTokens = estimateTokens(JSON.stringify(task));
+        const drafts = [
+            this.runtimeEvidenceSection(task),
+            this.sessionEventsSection(task),
+            await this.knowledgeSection(task, input.knowledgeTopK ?? DEFAULT_KNOWLEDGE_TOP_K),
+            this.graphSection(),
+        ];
+        let used = baseTokens;
+        const sections = [];
+        const omittedSections = [];
+        for (const draft of drafts.sort((a, b) => b.priority - a.priority)) {
+            const estimatedTokens = estimateTokens(JSON.stringify(draft.items));
+            if (draft.items.length === 0) {
+                const reason = 'no data available';
+                sections.push({ ...draft, estimatedTokens, included: false, reason });
+                omittedSections.push({ id: draft.id, title: draft.title, reason, estimatedTokens });
+                continue;
+            }
+            if (used + estimatedTokens <= budgetLimit) {
+                used += estimatedTokens;
+                sections.push({ ...draft, estimatedTokens, included: true });
+                continue;
+            }
+            const reason = `omitted by token budget (${used + estimatedTokens}/${budgetLimit})`;
+            sections.push({ ...draft, estimatedTokens, included: false, reason, items: [] });
+            omittedSections.push({ id: draft.id, title: draft.title, reason, estimatedTokens });
+        }
+        const overBudget = used > budgetLimit;
+        return {
+            version: '1.0',
+            generatedAt: new Date().toISOString(),
+            task,
+            budget: {
+                limit: budgetLimit,
+                used,
+                remaining: Math.max(0, budgetLimit - used),
+                overBudget,
+            },
+            sections,
+            omittedSections,
+        };
+    }
+    runtimeEvidenceSection(task) {
+        const records = this.evidenceLedger.list({
+            taskId: task.taskId,
+            sessionId: task.sessionId,
+            limit: 8,
+        });
+        const items = prioritizeEvidence(records).map(toRuntimeEvidenceItem);
+        return {
+            id: 'runtime-evidence',
+            title: 'Runtime Evidence',
+            priority: 100,
+            items,
+        };
+    }
+    sessionEventsSection(task) {
+        const sessionId = task.sessionId;
+        const events = sessionId ? this.sessionLedger.listEvents(sessionId).slice(-12) : [];
+        return {
+            id: 'session-events',
+            title: 'Session Events',
+            priority: 80,
+            items: events.map(toSessionEventItem),
+        };
+    }
+    async knowledgeSection(task, topK) {
+        if (!this.knowledgeBase) {
+            return { id: 'knowledge', title: 'Knowledge Recall', priority: 60, items: [] };
+        }
+        const query = [task.task, task.files.join(' ')].filter(Boolean).join('\n');
+        const entries = this.knowledgeBase.recallByVector
+            ? await this.knowledgeBase.recallByVector(query, topK)
+            : await this.knowledgeBase.recall({ verifiedOnly: true, limit: topK });
+        return {
+            id: 'knowledge',
+            title: 'Knowledge Recall',
+            priority: 60,
+            items: entries.map(entry => this.toKnowledgeItem(entry)),
+        };
+    }
+    graphSection() {
+        const candidates = [
+            { path: join(this.projectDir, 'graphify-out', 'GRAPH_REPORT.md'), kind: 'graph-report' },
+            { path: join(this.scaleRoot, 'graph', 'manifest.json'), kind: 'graph-manifest' },
+        ];
+        const items = candidates
+            .filter(candidate => existsSync(candidate.path))
+            .map(candidate => ({
+            type: 'graph',
+            path: normalizeProjectPath(this.projectDir, candidate.path),
+            kind: candidate.kind,
+            summary: previewFile(candidate.path, 220),
+        }));
+        return {
+            id: 'graph',
+            title: 'Project Graph',
+            priority: 40,
+            items,
+        };
+    }
+    toKnowledgeItem(entry) {
+        const contentPath = isAbsolute(entry.contentRef)
+            ? entry.contentRef
+            : join(this.projectDir, entry.contentRef);
+        return {
+            type: 'knowledge',
+            id: entry.id,
+            title: entry.title,
+            tags: entry.tags,
+            contentRef: entry.contentRef,
+            verified: entry.verified,
+            relevance: Number(entry.relevance.toFixed(3)),
+            preview: safePreviewProjectFile(this.projectDir, contentPath, 240),
+        };
+    }
+}
+export async function doctorMemoryFabric(options, input) {
+    const pack = await new MemoryFabric(options).createContextPack(input);
+    const checks = [
+        pack.budget.overBudget
+            ? {
+                name: 'Context budget',
+                status: 'fail',
+                message: `Base context uses ${pack.budget.used}/${pack.budget.limit} estimated tokens; raise budget or narrow task scope.`,
+            }
+            : {
+                name: 'Context budget',
+                status: 'ok',
+                message: `Context pack uses ${pack.budget.used}/${pack.budget.limit} estimated tokens.`,
+            },
+    ];
+    const budgetOmissions = pack.omittedSections.filter(section => section.reason.includes('budget'));
+    if (budgetOmissions.length > 0) {
+        checks.push({
+            name: 'Budget omissions',
+            status: 'warn',
+            message: `${budgetOmissions.length} lower-priority section(s) omitted by token budget.`,
+        });
+    }
+    const evidence = pack.sections.find(section => section.id === 'runtime-evidence');
+    checks.push(evidence?.included
+        ? { name: 'Runtime evidence', status: 'ok', message: `${evidence.items.length} evidence item(s) included.` }
+        : { name: 'Runtime evidence', status: 'warn', message: evidence?.reason ?? 'No runtime evidence included.' });
+    return {
+        ok: !checks.some(check => check.status === 'fail'),
+        checks,
+        pack,
+    };
+}
+export function renderContextPackMarkdown(pack) {
+    const lines = [
+        '# SCALE Memory Context Pack',
+        '',
+        `- Task: ${pack.task.task}`,
+        `- Task ID: ${pack.task.taskId ?? 'n/a'}`,
+        `- Session ID: ${pack.task.sessionId ?? 'n/a'}`,
+        `- Level: ${pack.task.level}`,
+        `- Budget: ${pack.budget.used}/${pack.budget.limit} estimated tokens`,
+        '',
+    ];
+    for (const section of pack.sections) {
+        lines.push(`## ${section.title}`);
+        lines.push(`- Status: ${section.included ? 'included' : 'omitted'}`);
+        if (section.reason)
+            lines.push(`- Reason: ${section.reason}`);
+        for (const item of section.items) {
+            lines.push(`- ${renderItemSummary(item)}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function prioritizeEvidence(records) {
+    return [...records].sort((a, b) => evidenceStatusRank(b.status) - evidenceStatusRank(a.status));
+}
+function evidenceStatusRank(status) {
+    if (status === 'failed')
+        return 3;
+    if (status === 'passed')
+        return 2;
+    return 1;
+}
+function toRuntimeEvidenceItem(record) {
+    return {
+        type: 'runtime-evidence',
+        id: record.id,
+        kind: record.kind,
+        title: record.title,
+        status: record.status,
+        command: record.command,
+        exitCode: record.exitCode,
+        summary: truncate(record.summary, 220),
+        createdAt: record.createdAt,
+        artifacts: record.artifacts,
+    };
+}
+function toSessionEventItem(event) {
+    return {
+        type: 'session-event',
+        id: event.id,
+        eventType: event.type,
+        phase: event.phase,
+        message: event.message ? truncate(event.message, 220) : undefined,
+        createdAt: event.createdAt,
+    };
+}
+function renderItemSummary(item) {
+    if (item.type === 'runtime-evidence')
+        return `[${item.status}] ${item.title}: ${item.summary}`;
+    if (item.type === 'session-event')
+        return `${item.eventType}${item.phase ? `/${item.phase}` : ''}: ${item.message ?? item.createdAt}`;
+    if (item.type === 'knowledge')
+        return `${item.title} (${item.tags.join(', ') || 'no tags'})`;
+    return `${item.kind}: ${item.path}`;
+}
+function estimateTokens(text) {
+    return Math.max(1, Math.ceil(text.length / 4));
+}
+function previewFile(path, maxChars) {
+    try {
+        const preview = truncate(readFileSync(path, 'utf-8').replace(/\s+/g, ' ').trim(), maxChars);
+        return redactEvidenceText(preview).value;
+    }
+    catch {
+        return '';
+    }
+}
+function safePreviewProjectFile(projectDir, filePath, maxChars) {
+    const resolvedProject = resolve(projectDir);
+    const resolvedFile = resolve(filePath);
+    const rel = relative(resolvedProject, resolvedFile);
+    if (rel.startsWith('..') || isAbsolute(rel))
+        return undefined;
+    if (!existsSync(resolvedFile))
+        return undefined;
+    return previewFile(resolvedFile, maxChars);
+}
+function truncate(value, maxChars) {
+    return value.length > maxChars ? `${value.slice(0, maxChars - 3)}...` : value;
+}
+function normalizeProjectPath(projectDir, filePath) {
+    const rel = relative(projectDir, filePath);
+    return rel && !rel.startsWith('..') ? rel.replace(/\\/g, '/') : filePath;
+}
+//# sourceMappingURL=MemoryFabric.js.map

package/dist/memory/MemoryFabric.js.map

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

package/dist/memory/MemoryLearning.d.ts

@@ -0,0 +1,61 @@
+import type { ContextPack } from './MemoryFabric.js';
+export type MemoryLearningCandidateStatus = 'candidate';
+export type MemoryLearningRecommendedAction = 'review-for-knowledge-base' | 'resolve-failures-first' | 'record-more-evidence';
+export interface MemoryLearningEvidenceSummary {
+    id: string;
+    status: string;
+    title: string;
+    summary: string;
+    command?: string;
+    exitCode?: number;
+}
+export interface MemoryLearningSessionSummary {
+    id: string;
+    eventType: string;
+    phase?: string;
+    message?: string;
+}
+export interface MemoryLearningCandidate {
+    version: '1.0';
+    id: string;
+    status: MemoryLearningCandidateStatus;
+    generatedAt: string;
+    title: string;
+    task: string;
+    taskId?: string;
+    sessionId?: string;
+    level: string;
+    summary: string;
+    recommendedAction: MemoryLearningRecommendedAction;
+    promotable: boolean;
+    tags: string[];
+    evidenceIds: string[];
+    sessionEventIds: string[];
+    knowledgeIds: string[];
+    graphRefs: string[];
+    evidenceSummaries: MemoryLearningEvidenceSummary[];
+    sessionSummaries: MemoryLearningSessionSummary[];
+    warnings: string[];
+    contextBudget: {
+        used: number;
+        limit: number;
+        remaining: number;
+        overBudget: boolean;
+    };
+    contentRef: string;
+}
+export interface MemoryLearningSettlement {
+    candidate: MemoryLearningCandidate;
+    files: {
+        json: string;
+        markdown: string;
+    };
+}
+export interface SettleMemoryLearningOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    pack: ContextPack;
+    now?: () => Date;
+}
+export declare function settleMemoryLearning(options: SettleMemoryLearningOptions): MemoryLearningSettlement;
+export declare function renderMemoryLearningCandidateMarkdown(candidate: MemoryLearningCandidate): string;

package/dist/memory/MemoryLearning.js

@@ -0,0 +1,203 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { isAbsolute, join, relative, resolve } from 'node:path';
+import { redactEvidenceText, redactEvidenceValue } from '../tools/ToolEvidenceStore.js';
+export function settleMemoryLearning(options) {
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const scaleRoot = resolveScaleRoot(projectDir, options.scaleDir);
+    const now = options.now ?? (() => new Date());
+    const generatedAt = now().toISOString();
+    const runtimeEvidence = includedItems(options.pack, 'runtime-evidence');
+    const sessionEvents = includedItems(options.pack, 'session-event');
+    const knowledgeItems = includedItems(options.pack, 'knowledge');
+    const graphRefs = options.pack.sections
+        .flatMap(section => section.items)
+        .filter(item => item.type === 'graph')
+        .map(item => item.path);
+    const failed = runtimeEvidence.filter(item => item.status === 'failed');
+    const passed = runtimeEvidence.filter(item => item.status === 'passed');
+    const warnings = buildWarnings(options.pack, runtimeEvidence, failed);
+    const recommendedAction = chooseRecommendedAction(runtimeEvidence, failed, passed);
+    const promotable = recommendedAction === 'review-for-knowledge-base';
+    const baseId = options.pack.task.taskId ?? options.pack.task.sessionId ?? options.pack.task.task;
+    const id = `MLC-${safePathSegment(baseId)}`;
+    const jsonPath = join(scaleRoot, 'memory', 'learning-candidates', `${id}.json`);
+    const markdownPath = join(scaleRoot, 'memory', 'learning-candidates', `${id}.md`);
+    const contentRef = normalizeProjectPath(projectDir, markdownPath);
+    const candidate = sanitizeCandidate({
+        version: '1.0',
+        id,
+        status: 'candidate',
+        generatedAt,
+        title: `Learning candidate: ${options.pack.task.task}`,
+        task: options.pack.task.task,
+        taskId: options.pack.task.taskId,
+        sessionId: options.pack.task.sessionId,
+        level: options.pack.task.level,
+        summary: buildSummary(options.pack, runtimeEvidence, failed, passed),
+        recommendedAction,
+        promotable,
+        tags: buildTags(options.pack, runtimeEvidence),
+        evidenceIds: runtimeEvidence.map(item => item.id),
+        sessionEventIds: sessionEvents.map(item => item.id),
+        knowledgeIds: knowledgeItems.map(item => item.id),
+        graphRefs,
+        evidenceSummaries: runtimeEvidence.map(item => ({
+            id: item.id,
+            status: item.status,
+            title: item.title,
+            summary: item.summary,
+            command: item.command,
+            exitCode: item.exitCode,
+        })),
+        sessionSummaries: sessionEvents.map(item => ({
+            id: item.id,
+            eventType: item.eventType,
+            phase: item.phase,
+            message: item.message,
+        })),
+        warnings,
+        contextBudget: { ...options.pack.budget },
+        contentRef,
+    });
+    ensureDir(join(scaleRoot, 'memory', 'learning-candidates'));
+    writeFileSync(jsonPath, JSON.stringify(candidate, null, 2), 'utf-8');
+    writeFileSync(markdownPath, renderMemoryLearningCandidateMarkdown(candidate), 'utf-8');
+    return {
+        candidate,
+        files: {
+            json: jsonPath,
+            markdown: markdownPath,
+        },
+    };
+}
+export function renderMemoryLearningCandidateMarkdown(candidate) {
+    const lines = [
+        `# ${candidate.title}`,
+        '',
+        `- Status: ${candidate.status}`,
+        `- Task ID: ${candidate.taskId ?? 'n/a'}`,
+        `- Session ID: ${candidate.sessionId ?? 'n/a'}`,
+        `- Level: ${candidate.level}`,
+        `- Recommended action: ${candidate.recommendedAction}`,
+        `- Promotable: ${candidate.promotable ? 'yes' : 'no'}`,
+        '',
+        '## Summary',
+        '',
+        candidate.summary,
+        '',
+        '## Runtime Evidence',
+        '',
+    ];
+    for (const evidence of candidate.evidenceSummaries) {
+        lines.push(`- [${evidence.status}] ${evidence.title} (${evidence.id})`);
+        lines.push(`  - Summary: ${evidence.summary}`);
+        if (evidence.command)
+            lines.push(`  - Command: \`${evidence.command}\``);
+        if (evidence.exitCode !== undefined)
+            lines.push(`  - Exit code: ${evidence.exitCode}`);
+    }
+    if (candidate.evidenceSummaries.length === 0)
+        lines.push('- none');
+    lines.push('', '## Session Events', '');
+    for (const event of candidate.sessionSummaries) {
+        lines.push(`- ${event.eventType}${event.phase ? `/${event.phase}` : ''}: ${event.message ?? event.id}`);
+    }
+    if (candidate.sessionSummaries.length === 0)
+        lines.push('- none');
+    lines.push('', '## Warnings', '');
+    for (const warning of candidate.warnings)
+        lines.push(`- ${warning}`);
+    if (candidate.warnings.length === 0)
+        lines.push('- none');
+    lines.push('');
+    return lines.join('\n');
+}
+function includedItems(pack, type) {
+    return pack.sections
+        .filter(section => section.included)
+        .flatMap(section => section.items)
+        .filter(item => item.type === type);
+}
+function buildWarnings(pack, runtimeEvidence, failed) {
+    const warnings = [];
+    if (failed.length > 0)
+        warnings.push(`${failed.length} failed runtime evidence item(s) must be resolved before promotion.`);
+    if (runtimeEvidence.length === 0)
+        warnings.push('No runtime evidence was included; record verification before promoting this candidate.');
+    for (const section of pack.omittedSections) {
+        warnings.push(`Context section omitted: ${section.title} (${section.reason}).`);
+    }
+    return warnings;
+}
+function chooseRecommendedAction(runtimeEvidence, failed, passed) {
+    if (failed.length > 0)
+        return 'resolve-failures-first';
+    if (runtimeEvidence.length === 0 || passed.length === 0)
+        return 'record-more-evidence';
+    return 'review-for-knowledge-base';
+}
+function buildSummary(pack, runtimeEvidence, failed, passed) {
+    if (failed.length > 0) {
+        return `Task "${pack.task.task}" produced ${failed.length} failed runtime evidence item(s); keep this as a learning candidate but do not promote it yet.`;
+    }
+    if (passed.length > 0) {
+        return `Task "${pack.task.task}" has ${passed.length}/${runtimeEvidence.length} passed runtime evidence item(s) and can be reviewed for durable knowledge promotion.`;
+    }
+    return `Task "${pack.task.task}" has no passed runtime evidence yet; use this candidate as a reminder to collect verification before long-term promotion.`;
+}
+function buildTags(pack, runtimeEvidence) {
+    const tags = new Set([
+        'runtime-learning',
+        `level-${pack.task.level.toLowerCase()}`,
+    ]);
+    if (runtimeEvidence.some(item => item.status === 'passed'))
+        tags.add('verified-evidence');
+    if (runtimeEvidence.some(item => item.status === 'failed'))
+        tags.add('failed-evidence');
+    return [...tags];
+}
+function sanitizeCandidate(candidate) {
+    const redacted = redactEvidenceValue(candidate).value;
+    return redactCandidateText(redacted);
+}
+function redactCandidateText(candidate) {
+    const redact = (value) => {
+        if (value === undefined)
+            return undefined;
+        return redactEvidenceText(value).value;
+    };
+    return {
+        ...candidate,
+        title: redact(candidate.title) ?? candidate.title,
+        task: redact(candidate.task) ?? candidate.task,
+        summary: redact(candidate.summary) ?? candidate.summary,
+        evidenceSummaries: candidate.evidenceSummaries.map(item => ({
+            ...item,
+            title: redact(item.title) ?? item.title,
+            summary: redact(item.summary) ?? item.summary,
+            command: redact(item.command),
+        })),
+        sessionSummaries: candidate.sessionSummaries.map(item => ({
+            ...item,
+            message: redact(item.message),
+        })),
+        warnings: candidate.warnings.map(item => redact(item) ?? item),
+    };
+}
+function ensureDir(dir) {
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function resolveScaleRoot(projectDir, scaleDir) {
+    return isAbsolute(scaleDir ?? '') ? scaleDir : join(projectDir, scaleDir ?? '.scale');
+}
+function safePathSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]/g, '-').slice(0, 120) || 'memory-learning';
+}
+function normalizeProjectPath(projectDir, filePath) {
+    const rel = relative(projectDir, filePath);
+    return rel && !rel.startsWith('..') && !isAbsolute(rel)
+        ? rel.replace(/\\/g, '/')
+        : filePath;
+}
+//# sourceMappingURL=MemoryLearning.js.map