@hongmaple0820/med-scale-research-os 0.43.0

package/dist/context/ContextBuilder.js

@@ -0,0 +1,372 @@
+// SCALE Engine — Context Builder (v0.5.0 完整实现)
+// 分层上下文加载 + Token 预算 + SCALE v10.0 哲学 P1 层 + 场景模式感知
+// 设计参考：docs/03-CORE-MODULES.md §3.6
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ============================================================================
+// SCALE v10.0 Philosophy — P1 system_rules layer content
+// ============================================================================
+const SCALE_V10_PHILOSOPHY = `## SCALE Engine v10.0 — System Rules
+
+You are operating under SCALE Engine governance. These rules are PHYSICALLY ENFORCED — you cannot bypass them by choice.
+
+### Core Philosophy
+- **S**caffold — Every action is scaffolded by artifacts (Spec→Plan→Task→Change→Evidence)
+- **C**ontrol — Guardrails physically block dangerous actions; no "soft" suggestions
+- **A**rtifact — All work products are tracked artifacts with FSM state machines
+- **L**earn — Defects auto-extract to Lessons → Rules → Hooks (evolution loop)
+- **E**volve — The system improves itself from mistakes
+
+### Physical Constraints (cannot be bypassed)
+🔴 **Dangerous commands** (rm -rf, DROP TABLE, format) are BLOCKED at the gate
+🔴 **Hardcoded secrets** (AWS keys, passwords, tokens) are BLOCKED on Edit/Write
+🔴 **Unapproved code** — Cannot implement until Spec is FROZEN and Plan is APPROVED
+🟡 **Brute retry** — 3+ identical retries detected → forced pause + context injection
+🟡 **Premature completion** — Cannot claim "done" without running tests
+🟡 **Blame shift** — Detected when AI blames environment without evidence
+
+### Mandatory Workflow
+1. **Explore** (role: explorer) — Read/Grep only, no edits
+2. **Plan** (role: planner) — Create Spec → refine → approve (guard: ambiguity ≤ 0.2)
+3. **Implement** (role: implementer) — Edit/Write/Bash unlocked only after Plan APPROVED
+4. **Verify** — Must run build+lint+test before marking task complete
+5. **Learn** — Defects auto-extract → lessons → rules → hooks
+
+### Artifact Lifecycle
+- Every piece of work is an Artifact with typed FSM transitions
+- Guards check quality gates at each transition (ambiguity score, test coverage, etc.)
+- Artifacts form a DAG: Need→Insight→Spec→Plan→Task→Change→Evidence
+- Challenging a FROZEN Spec invalidates downstream Plans and Tasks
+
+### Self-Evolution
+- Defect → Lesson (auto-extracted from root cause)
+- Lesson → Rule (promoted by access count + verification)
+- Rule → Hook (auto-generated enforcement code)
+- The system gets stricter over time, not weaker`;
+// ============================================================================
+// mattpoclock/skills style: Deep Modules + Vertical Slices TDD (Phase 15)
+// ============================================================================
+const DEEP_MODULES_PRINCIPLE = `## Deep Modules 原则
+
+接口深度 = 调用者杠杆 + 维护者局部性
+
+**删除测试**：如果删除这个模块，调用者需要写多少代码补偿？
+- 补偿代码越多 = 模块价值越大
+- 补偿代码越少 = 模块可删除
+
+**设计决策**：
+- 抓杠杆：接口应该让调用者一次调用完成复杂操作
+- 保局部：复杂逻辑隐藏在模块内部，不在接口暴露
+
+**判断标准**：
+- 好模块：简单接口，隐藏复杂性（如 fs.readFile(path) vs 手写文件系统）
+- 坏模块：复杂接口，暴露内部复杂性（如 10 个参数的 init 函数）
+
+**设计时问自己**：
+1. 调用者需要了解多少才能使用？
+2. 如果删除，调用者需要补偿多少？
+3. 内部实现变更，接口需要变吗？`;
+const VERTICAL_SLICES_TDD = `## Vertical Slices TDD（Tracer Bullets）
+
+**Wrong（Horizontal）**：
+1. 写所有测试
+2. 实现所有功能
+3. 运行所有测试
+
+**Right（Vertical）**：
+1. 选一个行为
+2. 写该行为的测试
+3. 实现该行为
+4. 验证测试通过
+5. 下一个行为
+
+**优势**：
+- 每个切片独立可验证
+- 失败时定位精确
+- 避免大爆炸集成
+- 早期发现设计问题
+
+**Tracer Bullets 原则**：
+- 先打通端到端骨架（可能不完整但可运行）
+- 再逐层填充细节
+- 每一步都有可验证的产出
+
+**TDD 防幻觉铁律**：
+- 绝不能同时写代码和测试！
+- 如果先写了有 Bug 的代码，再写测试，会写出"验证错误逻辑"的测试
+- 正确做法：测试先行，独立验证
+- 测试文件一旦写完，后续实现中禁止修改测试（除非测试本身有错）`;
+// ============================================================================
+// Karpathy Guidelines (andrej-karpathy-skills style)
+// ============================================================================
+const KARPATHY_PRINCIPLES = `## Karpathy Guidelines — LLM 编码行为准则
+
+源自 Andrej Karpathy 对 LLM 编码陷阱的观察。**倾向谨慎而非速度**。
+
+### 1. Think Before Coding（编码前先思考）
+**不做假设。不隐藏困惑。呈现权衡。**
+
+- 显式陈述假设。不确定就问。
+- 存在多种解释时全部呈现 — 不要默默选择。
+- 如果有更简单方案，说出来。该反驳就反驳。
+- 不清楚时停下。命名困惑点。询问。
+
+### 2. Simplicity First（简单优先）
+**解决问题的最少代码。拒绝投机性功能。**
+
+- 不写超出需求的功能。
+- 单用途代码不抽象化。
+- 不添加未请求的"灵活性"或"可配置性"。
+- 不处理不可能发生的错误场景。
+- 如果 200 行可以写成 50 行，重写它。
+
+**测试**：资深工程师会说"这过度复杂了吗？"如果是，简化。
+
+### 3. Surgical Changes（手术式修改）
+**只动必须动的。只清理自己制造的垃圾。**
+
+编辑现有代码时：
+- 不要"改进"相邻代码、注释或格式。
+- 不要重构未损坏的东西。
+- 匹配现有风格，即使你偏好不同写法。
+- 注意到无关死代码时提及 — 不要删除。
+
+你的修改产生孤儿时：
+- 删除 YOUR 修改导致未使用的导入/变量/函数。
+- 不要删除预先存在的死代码（除非被要求）。
+
+**测试**：每行改动应能追溯到用户请求。
+
+### 4. Goal-Driven Execution（目标驱动执行）
+**定义成功标准。循环直到验证。**
+
+将任务转化为可验证目标：
+- "添加验证" → "为无效输入写测试，然后使测试通过"
+- "修复 bug" → "写一个复现它的测试，然后使测试通过"
+- "重构 X" → "确保前后测试都通过"
+
+多步骤任务格式：
+\`\`\`
+1. [步骤] → verify: [检查]
+2. [步骤] → verify: [检查]
+3. [步骤] → verify: [检查]
+\`\`\`
+
+强成功标准让你独立循环。弱标准（"让它工作"）需要频繁澄清。`;
+// ============================================================================
+// Scenario Mode Context Additions
+// ============================================================================
+const SCENARIO_CONTEXT = {
+    sandbox: `### Scenario Mode: SANDBOX 🏖️
+- Lower detector sensitivity — exploratory work allowed
+- Verification NOT required before completion
+- Human confirmation NOT required
+- Audit trail disabled (lighter weight)
+- Max retries: 10 (freedom to experiment)
+- Use for: prototyping, exploration, learning`,
+    standard: `### Scenario Mode: STANDARD ⚙️
+- Medium detector sensitivity — production-quality required
+- Verification REQUIRED before completion
+- Human confirmation NOT required (trust the process)
+- Audit trail ENABLED
+- Max retries: 5 (balanced)
+- Use for: feature development, bug fixes, regular work`,
+    critical: `### Scenario Mode: CRITICAL 🔒
+- Maximum detector sensitivity — zero tolerance for errors
+- Verification REQUIRED before completion
+- Human confirmation REQUIRED for key transitions
+- Audit trail ENABLED (comprehensive)
+- Max retries: 3 (fail fast, escalate)
+- Use for: security changes, production deployments, data migrations`,
+};
+// ============================================================================
+// ContextBuilder
+// ============================================================================
+export class ContextBuilder {
+    constructor(store, kb, eventBus) {
+        this.store = store;
+        this.kb = kb;
+        this.eventBus = eventBus;
+        this.budget = { total: 200_000, reserved: 30_000 };
+    }
+    async build(opts) {
+        const scenarioMode = opts.scenarioMode ?? 'standard';
+        const layers = [];
+        // P1: System Rules — SCALE v10.0 Philosophy (always present, highest priority)
+        layers.push({
+            name: 'system_rules',
+            content: SCALE_V10_PHILOSOPHY,
+            priority: 1,
+            estimatedTokens: 3500,
+        });
+        // P1.5: Scenario Mode awareness
+        layers.push({
+            name: 'scenario_mode',
+            content: SCENARIO_CONTEXT[scenarioMode],
+            priority: 1,
+            estimatedTokens: 800,
+        });
+        // P1.6: Deep Modules Principle (mattpoclock/skills style)
+        layers.push({
+            name: 'deep_modules',
+            content: DEEP_MODULES_PRINCIPLE,
+            priority: 1,
+            estimatedTokens: 1200,
+        });
+        // P1.7: Vertical Slices TDD (mattpoclock/skills style)
+        layers.push({
+            name: 'vertical_slices_tdd',
+            content: VERTICAL_SLICES_TDD,
+            priority: 1,
+            estimatedTokens: 1500,
+        });
+        // P1.8: Karpathy Guidelines (andrej-karpathy-skills style)
+        layers.push({
+            name: 'karpathy_guidelines',
+            content: KARPATHY_PRINCIPLES,
+            priority: 1,
+            estimatedTokens: 2000,
+        });
+        // P1.9: Project Glossary (mattpocock/skills CONTEXT.md style)
+        // Reads .scale/GLOSSARY.md for domain terminology injection
+        try {
+            const glossaryPath = join(process.env.SCALE_DIR ?? '.scale', 'GLOSSARY.md');
+            if (existsSync(glossaryPath)) {
+                const glossaryContent = readFileSync(glossaryPath, 'utf-8');
+                const terms = glossaryContent
+                    .split('## Language')[1]
+                    ?.split('## ')[0]
+                    ?.split('\n')
+                    ?.filter(l => l.startsWith('**') && l.includes(':'))
+                    ?.map(l => l.replace(/\*\*/g, '').trim())
+                    ?.slice(0, 12)
+                    .join('\n') ?? '';
+                if (terms) {
+                    layers.push({
+                        name: 'project_glossary',
+                        content: `## Project Glossary\n${terms}\n\nUse these domain terms exactly. Do not substitute synonyms.`,
+                        priority: 1,
+                        estimatedTokens: 600,
+                    });
+                }
+            }
+        }
+        catch { /* glossary optional */ }
+        // P2: Role prompt
+        if (opts.roleId) {
+            layers.push({ name: 'role_prompt', content: `## Active Role: ${opts.roleId}\n...`, priority: 2, estimatedTokens: 1500 });
+        }
+        // P3: Current artifact context
+        if (opts.currentArtifactId) {
+            const artifact = await this.store.get(opts.currentArtifactId);
+            if (artifact) {
+                layers.push({ name: 'current_artifact', content: `## ${artifact.title}\n${JSON.stringify(artifact.payload, null, 2)}`, priority: 3, estimatedTokens: 5000 });
+            }
+        }
+        // P5: 召回 lessons (W7 集成)
+        // Enhanced: Always recall relevant lessons based on tags or artifact context
+        const lessons = await this.recallRelevantLessons(opts.currentArtifactId, opts.roleId);
+        if (lessons.length > 0) {
+            const content = '## 相关历史经验\n' + lessons.map((l) => `- ${l.title} (${l.tags.join(', ')})`).join('\n');
+            layers.push({ name: 'recalled_lessons', content, priority: 5, estimatedTokens: 1500 });
+        }
+        const available = this.budget.total - this.budget.reserved;
+        const selected = [];
+        let used = 0;
+        for (const layer of layers.sort((a, b) => a.priority - b.priority)) {
+            if (used + layer.estimatedTokens > available)
+                break;
+            selected.push(layer);
+            used += layer.estimatedTokens;
+        }
+        this.eventBus.emit('context.built', { layers: selected.map((l) => l.name), totalTokens: used, scenarioMode }, { sessionId: opts.sessionId });
+        return {
+            system: selected.map((l) => l.content).join('\n\n---\n\n'),
+            metadata: { totalTokens: used, layers: selected.map((l) => l.name), scenarioMode },
+        };
+    }
+    /**
+     * Enhanced lesson recall: based on artifact tags + role context
+     */
+    async recallRelevantLessons(currentArtifactId, roleId) {
+        const tagsToMatch = [];
+        // 1. Extract tags from current artifact
+        if (currentArtifactId) {
+            const artifact = await this.store.get(currentArtifactId);
+            if (artifact?.tags) {
+                tagsToMatch.push(...artifact.tags);
+            }
+            // Also match on artifact type
+            if (artifact?.type) {
+                tagsToMatch.push(artifact.type);
+            }
+        }
+        // 2. Add role-specific tags
+        if (roleId) {
+            tagsToMatch.push(`role:${roleId}`);
+        }
+        // 3. Query verified lessons
+        const allLessons = await this.kb.recall({ type: 'lesson', verifiedOnly: true, limit: 10 });
+        // 4. If we have tags to match, try to filter by tag overlap
+        if (tagsToMatch.length > 0) {
+            const scored = allLessons.map(l => ({
+                lesson: l,
+                score: l.tags.filter(t => tagsToMatch.includes(t)).length
+            })).filter(s => s.score > 0);
+            scored.sort((a, b) => b.score - a.score);
+            // If we found matching lessons, return them
+            if (scored.length > 0) {
+                return scored.slice(0, 5).map(s => s.lesson);
+            }
+            // Otherwise, fallback to all verified lessons
+        }
+        // 5. Fallback: return top verified lessons
+        return allLessons.slice(0, 5);
+    }
+    async getStatus(sessionId, roleGate) {
+        const role = roleGate.getRole();
+        // Query active artifacts for this session (linked via events)
+        const events = await this.eventBus.query({
+            sessionId,
+            types: ['artifact.created', 'artifact.transitioned'],
+            limit: 50
+        });
+        const artifactIds = new Set();
+        for (const event of events) {
+            if (event.artifactId) {
+                artifactIds.add(event.artifactId);
+            }
+        }
+        const activeArtifacts = await Promise.all(Array.from(artifactIds).map(async (id) => {
+            const artifact = await this.store.get(id);
+            return artifact ? {
+                id: artifact.id,
+                type: artifact.type,
+                status: artifact.status,
+            } : null;
+        }));
+        const validArtifacts = activeArtifacts.filter((a) => a !== null);
+        // Extract constraints from artifacts and FSM definitions
+        const constraints = [];
+        for (const artifact of validArtifacts) {
+            if (artifact.type === 'Spec' && artifact.status !== 'FROZEN') {
+                constraints.push(`Spec must be FROZEN before writing code (current: ${artifact.status})`);
+            }
+            if (artifact.type === 'Plan' && artifact.status === 'DRAFT') {
+                constraints.push(`Plan must be approved before implementation`);
+            }
+            if (artifact.type === 'Task' && artifact.status === 'TODO') {
+                constraints.push(`Task must be READY before implementation`);
+            }
+        }
+        return {
+            sessionId,
+            role: role.id,
+            allowedTools: role.allowedTools,
+            deniedTools: role.deniedTools ?? [],
+            activeArtifacts: validArtifacts,
+            constraints,
+        };
+    }
+}
+//# sourceMappingURL=ContextBuilder.js.map

package/dist/context/ContextBuilder.js.map

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

package/dist/context/ContextCompiler.d.ts

@@ -0,0 +1,34 @@
+import type { ContextBudgetCategory } from './ContextBudget.js';
+export interface ContextCompilerCandidate {
+    id: string;
+    category: ContextBudgetCategory;
+    estimatedTokens: number;
+    reason: string;
+    paths: string[];
+    required?: boolean;
+    basePriority?: number;
+}
+export interface ContextCompilerInput {
+    task: string;
+    level: string;
+    files: string[];
+    budget: number;
+    candidates: ContextCompilerCandidate[];
+}
+export interface CompiledContextItem extends ContextCompilerCandidate {
+    included: boolean;
+    score: number;
+    matchedSignals: string[];
+    inclusionReason?: string;
+    omissionReason?: string;
+}
+export interface CompiledContext {
+    strategy: 'relevance-budget-v1';
+    generatedAt: string;
+    budget: number;
+    totalCandidateTokens: number;
+    totalEstimatedTokens: number;
+    estimatedTokenSavings: number;
+    items: CompiledContextItem[];
+}
+export declare function compileContext(input: ContextCompilerInput): CompiledContext;

package/dist/context/ContextCompiler.js

@@ -0,0 +1,120 @@
+const CATEGORY_PRIORITY = {
+    always: 500,
+    evidence: 220,
+    'on-demand': 160,
+    archive: 80,
+    generated: 20,
+};
+export function compileContext(input) {
+    const budget = Math.max(0, Math.floor(input.budget));
+    const taskSignals = taskSignalSet(input.task, input.files, input.level);
+    const ranked = input.candidates
+        .map(candidate => scoreCandidate(candidate, taskSignals, input))
+        .sort((a, b) => Number(Boolean(b.required)) - Number(Boolean(a.required)) || b.score - a.score || a.estimatedTokens - b.estimatedTokens || a.id.localeCompare(b.id));
+    let totalEstimatedTokens = 0;
+    const items = [];
+    for (const candidate of ranked) {
+        const nextTotal = totalEstimatedTokens + candidate.estimatedTokens;
+        if (candidate.estimatedTokens <= 0) {
+            items.push({
+                ...candidate,
+                included: false,
+                omissionReason: 'empty-candidate',
+            });
+            continue;
+        }
+        if (nextTotal > budget) {
+            items.push({
+                ...candidate,
+                included: false,
+                omissionReason: candidate.required ? 'required-over-budget' : 'budget-exceeded',
+            });
+            continue;
+        }
+        totalEstimatedTokens = nextTotal;
+        items.push({
+            ...candidate,
+            included: true,
+            inclusionReason: inclusionReason(candidate),
+        });
+    }
+    const totalCandidateTokens = input.candidates.reduce((sum, candidate) => sum + Math.max(0, candidate.estimatedTokens), 0);
+    return {
+        strategy: 'relevance-budget-v1',
+        generatedAt: new Date().toISOString(),
+        budget,
+        totalCandidateTokens,
+        totalEstimatedTokens,
+        estimatedTokenSavings: Math.max(0, totalCandidateTokens - totalEstimatedTokens),
+        items,
+    };
+}
+function scoreCandidate(candidate, taskSignals, input) {
+    const matchedSignals = [];
+    let score = CATEGORY_PRIORITY[candidate.category] + (candidate.basePriority ?? 0);
+    if (candidate.required)
+        score += 1000;
+    const haystack = `${candidate.id} ${candidate.reason} ${candidate.paths.join(' ')}`.toLowerCase();
+    for (const signal of taskSignals) {
+        if (haystack.includes(signal)) {
+            score += 12;
+            if (matchedSignals.length < 12)
+                matchedSignals.push(signal);
+        }
+    }
+    const normalizedFiles = input.files.map(normalizePath).filter(Boolean);
+    for (const file of normalizedFiles) {
+        if (candidate.paths.some(path => path === file || path.endsWith(`/${file}`) || basename(path) === basename(file))) {
+            score += 220;
+            matchedSignals.push(`file:${file}`);
+        }
+    }
+    const level = input.level.toUpperCase();
+    if ((level === 'L' || level === 'CRITICAL') && candidate.category === 'evidence') {
+        score += 60;
+        matchedSignals.push('high-risk-evidence');
+    }
+    if ((level === 'L' || level === 'CRITICAL') && candidate.category === 'archive') {
+        score += 35;
+        matchedSignals.push('high-risk-archive');
+    }
+    if (candidate.category === 'generated' && matchedSignals.length === 0)
+        score -= 120;
+    return {
+        ...candidate,
+        score,
+        matchedSignals: unique(matchedSignals),
+    };
+}
+function inclusionReason(candidate) {
+    if (candidate.required)
+        return `${candidate.reason} Required context within budget.`;
+    if (candidate.matchedSignals.length > 0)
+        return `${candidate.reason} Matched: ${candidate.matchedSignals.join(', ')}.`;
+    return `${candidate.reason} Selected by category priority and token budget.`;
+}
+function taskSignalSet(task, files, level) {
+    const signals = new Set();
+    for (const value of [task, level, ...files]) {
+        const normalized = normalizePath(value).toLowerCase();
+        for (const part of normalized.split(/[^a-z0-9_.\-/]+/i)) {
+            const trimmed = part.trim();
+            if (trimmed.length >= 3)
+                signals.add(trimmed);
+        }
+        const base = basename(normalized);
+        if (base.length >= 3)
+            signals.add(base);
+    }
+    return signals;
+}
+function normalizePath(path) {
+    return path.replace(/\\/g, '/').replace(/^\.\//, '');
+}
+function basename(path) {
+    return path.split('/').filter(Boolean).pop() ?? path;
+}
+function unique(items) {
+    return [...new Set(items)];
+}
+//# sourceMappingURL=ContextCompiler.js.map

package/dist/context/ContextCompiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextCompiler.js","sourceRoot":"","sources":["../../src/context/ContextCompiler.ts"],"names":[],"mappings":"AAsCA,MAAM,iBAAiB,GAA0C;IAC/D,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,GAAG;IACb,WAAW,EAAE,GAAG;IAChB,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,EAAE;CACd,CAAA;AAED,MAAM,UAAU,cAAc,CAAC,KAA2B;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACpD,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACvE,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU;SAC5B,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;SAC/D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAEtK,IAAI,oBAAoB,GAAG,CAAC,CAAA;IAC5B,MAAM,KAAK,GAA0B,EAAE,CAAA;IAEvC,KAAK,MAAM,SAAS,IAAI,MAAM,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,oBAAoB,GAAG,SAAS,CAAC,eAAe,CAAA;QAClE,IAAI,SAAS,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,SAAS;gBACZ,QAAQ,EAAE,KAAK;gBACf,cAAc,EAAE,iBAAiB;aAClC,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QACD,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,SAAS;gBACZ,QAAQ,EAAE,KAAK;gBACf,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,iBAAiB;aAChF,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QACD,oBAAoB,GAAG,SAAS,CAAA;QAChC,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,SAAS;YACZ,QAAQ,EAAE,IAAI;YACd,eAAe,EAAE,eAAe,CAAC,SAAS,CAAC;SAC5C,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,oBAAoB,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAA;IAEzH,OAAO;QACL,QAAQ,EAAE,qBAAqB;QAC/B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,MAAM;QACN,oBAAoB;QACpB,oBAAoB;QACpB,qBAAqB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;QAC/E,KAAK;KACN,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CACrB,SAAmC,EACnC,WAAwB,EACxB,KAA2B;IAE3B,MAAM,cAAc,GAAa,EAAE,CAAA;IACnC,IAAI,KAAK,GAAG,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,IAAI,CAAC,CAAC,CAAA;IACjF,IAAI,SAAS,CAAC,QAAQ;QAAE,KAAK,IAAI,IAAI,CAAA;IAErC,MAAM,QAAQ,GAAG,GAAG,SAAS,CAAC,EAAE,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAA;IACjG,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,KAAK,IAAI,EAAE,CAAA;YACX,IAAI,cAAc,CAAC,MAAM,GAAG,EAAE;gBAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtE,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAClH,KAAK,IAAI,GAAG,CAAA;YACZ,cAAc,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;IACvC,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,UAAU,CAAC,IAAI,SAAS,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACjF,KAAK,IAAI,EAAE,CAAA;QACX,cAAc,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;IAC3C,CAAC;IACD,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,UAAU,CAAC,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChF,KAAK,IAAI,EAAE,CAAA;QACX,cAAc,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;IAC1C,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,KAAK,WAAW,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,IAAI,GAAG,CAAA;IAEnF,OAAO;QACL,GAAG,SAAS;QACZ,KAAK;QACL,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC;KACvC,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,SAAgD;IACvE,IAAI,SAAS,CAAC,QAAQ;QAAE,OAAO,GAAG,SAAS,CAAC,MAAM,kCAAkC,CAAA;IACpF,IAAI,SAAS,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,SAAS,CAAC,MAAM,aAAa,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA;IACtH,OAAO,GAAG,SAAS,CAAC,MAAM,kDAAkD,CAAA;AAC9E,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,KAAe,EAAE,KAAa;IACjE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;QACrD,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;YAC3B,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAC/C,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;QACjC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACzC,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;AACtD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAA;AACtD,CAAC;AAED,SAAS,MAAM,CAAI,KAAU;IAC3B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;AAC5B,CAAC"}

package/dist/context/ProjectAnatomy.d.ts

@@ -0,0 +1,18 @@
+export interface AnatomyEntry {
+    file: string;
+    description: string;
+    tokens: number;
+}
+export declare class ProjectAnatomy {
+    scan(projectDir: string, opts?: {
+        maxFiles?: number;
+        excludePatterns?: string[];
+    }): Map<string, AnatomyEntry[]>;
+    serialize(sections: Map<string, AnatomyEntry[]>): string;
+    parse(content: string): Map<string, AnatomyEntry[]>;
+    updateEntry(sections: Map<string, AnatomyEntry[]>, relPath: string, fileContent: string, action: 'upsert' | 'delete'): void;
+    extractDescription(filePath: string): string;
+    extractDescriptionFromContent(content: string, filePath: string): string;
+    private walkDir;
+    private shouldExclude;
+}