contextpro-mcp 0.0.0-stage → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +416 -0
- package/INSTALL.md +128 -0
- package/INSTRUCTIONS.md +33 -0
- package/LICENSE +21 -0
- package/NOTICE +12 -0
- package/README.md +164 -2
- package/SECURITY.md +27 -0
- package/agent-guide.md +323 -0
- package/agent-instructions.md +1 -0
- package/build/core/agent-setup.d.ts +5 -0
- package/build/core/agent-setup.d.ts.map +1 -0
- package/build/core/agent-setup.js +94 -0
- package/build/core/agent-setup.js.map +1 -0
- package/build/core/artifacts.d.ts +64 -0
- package/build/core/artifacts.d.ts.map +1 -0
- package/build/core/artifacts.js +370 -0
- package/build/core/artifacts.js.map +1 -0
- package/build/core/bounded-source.d.ts +15 -0
- package/build/core/bounded-source.d.ts.map +1 -0
- package/build/core/bounded-source.js +78 -0
- package/build/core/bounded-source.js.map +1 -0
- package/build/core/changed-since.d.ts +20 -0
- package/build/core/changed-since.d.ts.map +1 -0
- package/build/core/changed-since.js +43 -0
- package/build/core/changed-since.js.map +1 -0
- package/build/core/chat-model.d.ts +8 -0
- package/build/core/chat-model.d.ts.map +1 -0
- package/build/core/chat-model.js +135 -0
- package/build/core/chat-model.js.map +1 -0
- package/build/core/clustering.d.ts +6 -0
- package/build/core/clustering.d.ts.map +1 -0
- package/build/core/clustering.js +201 -0
- package/build/core/clustering.js.map +1 -0
- package/build/core/context-metadata.d.ts +50 -0
- package/build/core/context-metadata.d.ts.map +1 -0
- package/build/core/context-metadata.js +118 -0
- package/build/core/context-metadata.js.map +1 -0
- package/build/core/data-dir.d.ts +5 -0
- package/build/core/data-dir.d.ts.map +1 -0
- package/build/core/data-dir.js +53 -0
- package/build/core/data-dir.js.map +1 -0
- package/build/core/db-native.d.ts +28 -0
- package/build/core/db-native.d.ts.map +1 -0
- package/build/core/db-native.js +120 -0
- package/build/core/db-native.js.map +1 -0
- package/build/core/db.d.ts +294 -0
- package/build/core/db.d.ts.map +1 -0
- package/build/core/db.js +1047 -0
- package/build/core/db.js.map +1 -0
- package/build/core/doctor.d.ts +13 -0
- package/build/core/doctor.d.ts.map +1 -0
- package/build/core/doctor.js +55 -0
- package/build/core/doctor.js.map +1 -0
- package/build/core/efficiency.d.ts +16 -0
- package/build/core/efficiency.d.ts.map +1 -0
- package/build/core/efficiency.js +170 -0
- package/build/core/efficiency.js.map +1 -0
- package/build/core/embedding-tracker.d.ts +25 -0
- package/build/core/embedding-tracker.d.ts.map +1 -0
- package/build/core/embedding-tracker.js +228 -0
- package/build/core/embedding-tracker.js.map +1 -0
- package/build/core/embeddings.d.ts +90 -0
- package/build/core/embeddings.d.ts.map +1 -0
- package/build/core/embeddings.js +693 -0
- package/build/core/embeddings.js.map +1 -0
- package/build/core/evidence-state.d.ts +42 -0
- package/build/core/evidence-state.d.ts.map +1 -0
- package/build/core/evidence-state.js +153 -0
- package/build/core/evidence-state.js.map +1 -0
- package/build/core/extractor-stamp.d.ts +10 -0
- package/build/core/extractor-stamp.d.ts.map +1 -0
- package/build/core/extractor-stamp.js +51 -0
- package/build/core/extractor-stamp.js.map +1 -0
- package/build/core/feature-brief-cache.d.ts +37 -0
- package/build/core/feature-brief-cache.d.ts.map +1 -0
- package/build/core/feature-brief-cache.js +100 -0
- package/build/core/feature-brief-cache.js.map +1 -0
- package/build/core/file-fingerprint.d.ts +15 -0
- package/build/core/file-fingerprint.d.ts.map +1 -0
- package/build/core/file-fingerprint.js +24 -0
- package/build/core/file-fingerprint.js.map +1 -0
- package/build/core/graph-analytics.d.ts +46 -0
- package/build/core/graph-analytics.d.ts.map +1 -0
- package/build/core/graph-analytics.js +371 -0
- package/build/core/graph-analytics.js.map +1 -0
- package/build/core/hub.d.ts +23 -0
- package/build/core/hub.d.ts.map +1 -0
- package/build/core/hub.js +123 -0
- package/build/core/hub.js.map +1 -0
- package/build/core/ignore-dirs.d.ts +7 -0
- package/build/core/ignore-dirs.d.ts.map +1 -0
- package/build/core/ignore-dirs.js +84 -0
- package/build/core/ignore-dirs.js.map +1 -0
- package/build/core/index-freshness.d.ts +15 -0
- package/build/core/index-freshness.d.ts.map +1 -0
- package/build/core/index-freshness.js +96 -0
- package/build/core/index-freshness.js.map +1 -0
- package/build/core/index-reconcile.d.ts +28 -0
- package/build/core/index-reconcile.d.ts.map +1 -0
- package/build/core/index-reconcile.js +129 -0
- package/build/core/index-reconcile.js.map +1 -0
- package/build/core/local-daemon.d.ts +5 -0
- package/build/core/local-daemon.d.ts.map +1 -0
- package/build/core/local-daemon.js +282 -0
- package/build/core/local-daemon.js.map +1 -0
- package/build/core/memory-graph.d.ts +68 -0
- package/build/core/memory-graph.d.ts.map +1 -0
- package/build/core/memory-graph.js +152 -0
- package/build/core/memory-graph.js.map +1 -0
- package/build/core/native-repair.d.ts +12 -0
- package/build/core/native-repair.d.ts.map +1 -0
- package/build/core/native-repair.js +167 -0
- package/build/core/native-repair.js.map +1 -0
- package/build/core/native-runtime.d.ts +12 -0
- package/build/core/native-runtime.d.ts.map +1 -0
- package/build/core/native-runtime.js +38 -0
- package/build/core/native-runtime.js.map +1 -0
- package/build/core/pagerank.d.ts +29 -0
- package/build/core/pagerank.d.ts.map +1 -0
- package/build/core/pagerank.js +90 -0
- package/build/core/pagerank.js.map +1 -0
- package/build/core/parser-process.d.ts +21 -0
- package/build/core/parser-process.d.ts.map +1 -0
- package/build/core/parser-process.js +103 -0
- package/build/core/parser-process.js.map +1 -0
- package/build/core/parser-worker.d.ts +2 -0
- package/build/core/parser-worker.d.ts.map +1 -0
- package/build/core/parser-worker.js +17 -0
- package/build/core/parser-worker.js.map +1 -0
- package/build/core/parser.d.ts +66 -0
- package/build/core/parser.d.ts.map +1 -0
- package/build/core/parser.js +750 -0
- package/build/core/parser.js.map +1 -0
- package/build/core/path-guard.d.ts +6 -0
- package/build/core/path-guard.d.ts.map +1 -0
- package/build/core/path-guard.js +55 -0
- package/build/core/path-guard.js.map +1 -0
- package/build/core/process-lifecycle.d.ts +30 -0
- package/build/core/process-lifecycle.d.ts.map +1 -0
- package/build/core/process-lifecycle.js +129 -0
- package/build/core/process-lifecycle.js.map +1 -0
- package/build/core/project-config.d.ts +83 -0
- package/build/core/project-config.d.ts.map +1 -0
- package/build/core/project-config.js +302 -0
- package/build/core/project-config.js.map +1 -0
- package/build/core/project-graph.d.ts +69 -0
- package/build/core/project-graph.d.ts.map +1 -0
- package/build/core/project-graph.js +874 -0
- package/build/core/project-graph.js.map +1 -0
- package/build/core/provider-config.d.ts +15 -0
- package/build/core/provider-config.d.ts.map +1 -0
- package/build/core/provider-config.js +67 -0
- package/build/core/provider-config.js.map +1 -0
- package/build/core/provider-usage.d.ts +21 -0
- package/build/core/provider-usage.d.ts.map +1 -0
- package/build/core/provider-usage.js +52 -0
- package/build/core/provider-usage.js.map +1 -0
- package/build/core/python-language-server.d.ts +23 -0
- package/build/core/python-language-server.d.ts.map +1 -0
- package/build/core/python-language-server.js +217 -0
- package/build/core/python-language-server.js.map +1 -0
- package/build/core/python-runtime-identity.d.ts +3 -0
- package/build/core/python-runtime-identity.d.ts.map +1 -0
- package/build/core/python-runtime-identity.js +53 -0
- package/build/core/python-runtime-identity.js.map +1 -0
- package/build/core/reconcile-scheduler.d.ts +20 -0
- package/build/core/reconcile-scheduler.d.ts.map +1 -0
- package/build/core/reconcile-scheduler.js +58 -0
- package/build/core/reconcile-scheduler.js.map +1 -0
- package/build/core/request-context.d.ts +7 -0
- package/build/core/request-context.d.ts.map +1 -0
- package/build/core/request-context.js +17 -0
- package/build/core/request-context.js.map +1 -0
- package/build/core/request-root.d.ts +19 -0
- package/build/core/request-root.d.ts.map +1 -0
- package/build/core/request-root.js +26 -0
- package/build/core/request-root.js.map +1 -0
- package/build/core/root-guard.d.ts +8 -0
- package/build/core/root-guard.d.ts.map +1 -0
- package/build/core/root-guard.js +53 -0
- package/build/core/root-guard.js.map +1 -0
- package/build/core/roots-detect.d.ts +17 -0
- package/build/core/roots-detect.d.ts.map +1 -0
- package/build/core/roots-detect.js +63 -0
- package/build/core/roots-detect.js.map +1 -0
- package/build/core/runtime-session.d.ts +5 -0
- package/build/core/runtime-session.d.ts.map +1 -0
- package/build/core/runtime-session.js +10 -0
- package/build/core/runtime-session.js.map +1 -0
- package/build/core/scip-index.d.ts +71 -0
- package/build/core/scip-index.d.ts.map +1 -0
- package/build/core/scip-index.js +343 -0
- package/build/core/scip-index.js.map +1 -0
- package/build/core/semantic-diff.d.ts +32 -0
- package/build/core/semantic-diff.d.ts.map +1 -0
- package/build/core/semantic-diff.js +259 -0
- package/build/core/semantic-diff.js.map +1 -0
- package/build/core/source-context.d.ts +3 -0
- package/build/core/source-context.d.ts.map +1 -0
- package/build/core/source-context.js +86 -0
- package/build/core/source-context.js.map +1 -0
- package/build/core/source-mask.d.ts +8 -0
- package/build/core/source-mask.d.ts.map +1 -0
- package/build/core/source-mask.js +156 -0
- package/build/core/source-mask.js.map +1 -0
- package/build/core/source-mutation.d.ts +16 -0
- package/build/core/source-mutation.d.ts.map +1 -0
- package/build/core/source-mutation.js +193 -0
- package/build/core/source-mutation.js.map +1 -0
- package/build/core/sql-schema.d.ts +59 -0
- package/build/core/sql-schema.d.ts.map +1 -0
- package/build/core/sql-schema.js +218 -0
- package/build/core/sql-schema.js.map +1 -0
- package/build/core/startup-health.d.ts +40 -0
- package/build/core/startup-health.d.ts.map +1 -0
- package/build/core/startup-health.js +132 -0
- package/build/core/startup-health.js.map +1 -0
- package/build/core/team-ledger.d.ts +60 -0
- package/build/core/team-ledger.d.ts.map +1 -0
- package/build/core/team-ledger.js +171 -0
- package/build/core/team-ledger.js.map +1 -0
- package/build/core/test-impact.d.ts +23 -0
- package/build/core/test-impact.d.ts.map +1 -0
- package/build/core/test-impact.js +131 -0
- package/build/core/test-impact.js.map +1 -0
- package/build/core/tool-metrics.d.ts +29 -0
- package/build/core/tool-metrics.d.ts.map +1 -0
- package/build/core/tool-metrics.js +74 -0
- package/build/core/tool-metrics.js.map +1 -0
- package/build/core/tool-profile.d.ts +12 -0
- package/build/core/tool-profile.d.ts.map +1 -0
- package/build/core/tool-profile.js +102 -0
- package/build/core/tool-profile.js.map +1 -0
- package/build/core/tool-trace.d.ts +8 -0
- package/build/core/tool-trace.d.ts.map +1 -0
- package/build/core/tool-trace.js +70 -0
- package/build/core/tool-trace.js.map +1 -0
- package/build/core/tree-sitter-runtime.d.ts +20 -0
- package/build/core/tree-sitter-runtime.d.ts.map +1 -0
- package/build/core/tree-sitter-runtime.js +324 -0
- package/build/core/tree-sitter-runtime.js.map +1 -0
- package/build/core/tree-sitter.d.ts +6 -0
- package/build/core/tree-sitter.d.ts.map +1 -0
- package/build/core/tree-sitter.js +24 -0
- package/build/core/tree-sitter.js.map +1 -0
- package/build/core/typescript-reference-process.d.ts +30 -0
- package/build/core/typescript-reference-process.d.ts.map +1 -0
- package/build/core/typescript-reference-process.js +124 -0
- package/build/core/typescript-reference-process.js.map +1 -0
- package/build/core/typescript-reference-worker.d.ts +2 -0
- package/build/core/typescript-reference-worker.d.ts.map +1 -0
- package/build/core/typescript-reference-worker.js +14 -0
- package/build/core/typescript-reference-worker.js.map +1 -0
- package/build/core/typescript-references.d.ts +71 -0
- package/build/core/typescript-references.d.ts.map +1 -0
- package/build/core/typescript-references.js +392 -0
- package/build/core/typescript-references.js.map +1 -0
- package/build/core/typescript-skeleton.d.ts +5 -0
- package/build/core/typescript-skeleton.d.ts.map +1 -0
- package/build/core/typescript-skeleton.js +49 -0
- package/build/core/typescript-skeleton.js.map +1 -0
- package/build/core/walker.d.ts +16 -0
- package/build/core/walker.d.ts.map +1 -0
- package/build/core/walker.js +152 -0
- package/build/core/walker.js.map +1 -0
- package/build/core/workspace-router.d.ts +28 -0
- package/build/core/workspace-router.d.ts.map +1 -0
- package/build/core/workspace-router.js +93 -0
- package/build/core/workspace-router.js.map +1 -0
- package/build/core/worktree-gc.d.ts +16 -0
- package/build/core/worktree-gc.d.ts.map +1 -0
- package/build/core/worktree-gc.js +69 -0
- package/build/core/worktree-gc.js.map +1 -0
- package/build/core/worktree-overlay.d.ts +22 -0
- package/build/core/worktree-overlay.d.ts.map +1 -0
- package/build/core/worktree-overlay.js +84 -0
- package/build/core/worktree-overlay.js.map +1 -0
- package/build/core/worktree-root-guard.d.ts +8 -0
- package/build/core/worktree-root-guard.d.ts.map +1 -0
- package/build/core/worktree-root-guard.js +82 -0
- package/build/core/worktree-root-guard.js.map +1 -0
- package/build/core/worktree-seed.d.ts +14 -0
- package/build/core/worktree-seed.d.ts.map +1 -0
- package/build/core/worktree-seed.js +98 -0
- package/build/core/worktree-seed.js.map +1 -0
- package/build/git/shadow.d.ts +40 -0
- package/build/git/shadow.d.ts.map +1 -0
- package/build/git/shadow.js +298 -0
- package/build/git/shadow.js.map +1 -0
- package/build/index.d.ts +3 -0
- package/build/index.d.ts.map +1 -0
- package/build/index.js +599 -0
- package/build/index.js.map +1 -0
- package/build/tools/agentic-context.d.ts +86 -0
- package/build/tools/agentic-context.d.ts.map +1 -0
- package/build/tools/agentic-context.js +1546 -0
- package/build/tools/agentic-context.js.map +1 -0
- package/build/tools/blast-radius.d.ts +24 -0
- package/build/tools/blast-radius.d.ts.map +1 -0
- package/build/tools/blast-radius.js +231 -0
- package/build/tools/blast-radius.js.map +1 -0
- package/build/tools/changed-since.d.ts +7 -0
- package/build/tools/changed-since.d.ts.map +1 -0
- package/build/tools/changed-since.js +68 -0
- package/build/tools/changed-since.js.map +1 -0
- package/build/tools/compiler-actions.d.ts +26 -0
- package/build/tools/compiler-actions.d.ts.map +1 -0
- package/build/tools/compiler-actions.js +121 -0
- package/build/tools/compiler-actions.js.map +1 -0
- package/build/tools/context-tree.d.ts +9 -0
- package/build/tools/context-tree.d.ts.map +1 -0
- package/build/tools/context-tree.js +131 -0
- package/build/tools/context-tree.js.map +1 -0
- package/build/tools/context.d.ts +37 -0
- package/build/tools/context.d.ts.map +1 -0
- package/build/tools/context.js +800 -0
- package/build/tools/context.js.map +1 -0
- package/build/tools/diff.d.ts +9 -0
- package/build/tools/diff.d.ts.map +1 -0
- package/build/tools/diff.js +176 -0
- package/build/tools/diff.js.map +1 -0
- package/build/tools/directory-prior.d.ts +16 -0
- package/build/tools/directory-prior.d.ts.map +1 -0
- package/build/tools/directory-prior.js +121 -0
- package/build/tools/directory-prior.js.map +1 -0
- package/build/tools/discovery-documents.d.ts +11 -0
- package/build/tools/discovery-documents.d.ts.map +1 -0
- package/build/tools/discovery-documents.js +71 -0
- package/build/tools/discovery-documents.js.map +1 -0
- package/build/tools/discovery-hints.d.ts +25 -0
- package/build/tools/discovery-hints.d.ts.map +1 -0
- package/build/tools/discovery-hints.js +329 -0
- package/build/tools/discovery-hints.js.map +1 -0
- package/build/tools/efficiency-report.d.ts +13 -0
- package/build/tools/efficiency-report.d.ts.map +1 -0
- package/build/tools/efficiency-report.js +78 -0
- package/build/tools/efficiency-report.js.map +1 -0
- package/build/tools/evidence-retrieval.d.ts +33 -0
- package/build/tools/evidence-retrieval.d.ts.map +1 -0
- package/build/tools/evidence-retrieval.js +200 -0
- package/build/tools/evidence-retrieval.js.map +1 -0
- package/build/tools/exact-references.d.ts +10 -0
- package/build/tools/exact-references.d.ts.map +1 -0
- package/build/tools/exact-references.js +349 -0
- package/build/tools/exact-references.js.map +1 -0
- package/build/tools/explain.d.ts +14 -0
- package/build/tools/explain.d.ts.map +1 -0
- package/build/tools/explain.js +370 -0
- package/build/tools/explain.js.map +1 -0
- package/build/tools/feature-brief.d.ts +7 -0
- package/build/tools/feature-brief.d.ts.map +1 -0
- package/build/tools/feature-brief.js +89 -0
- package/build/tools/feature-brief.js.map +1 -0
- package/build/tools/feature-hub.d.ts +15 -0
- package/build/tools/feature-hub.d.ts.map +1 -0
- package/build/tools/feature-hub.js +404 -0
- package/build/tools/feature-hub.js.map +1 -0
- package/build/tools/file-skeleton.d.ts +7 -0
- package/build/tools/file-skeleton.d.ts.map +1 -0
- package/build/tools/file-skeleton.js +190 -0
- package/build/tools/file-skeleton.js.map +1 -0
- package/build/tools/grep.d.ts +25 -0
- package/build/tools/grep.d.ts.map +1 -0
- package/build/tools/grep.js +341 -0
- package/build/tools/grep.js.map +1 -0
- package/build/tools/impact-delta.d.ts +7 -0
- package/build/tools/impact-delta.d.ts.map +1 -0
- package/build/tools/impact-delta.js +102 -0
- package/build/tools/impact-delta.js.map +1 -0
- package/build/tools/memory-tools.d.ts +69 -0
- package/build/tools/memory-tools.d.ts.map +1 -0
- package/build/tools/memory-tools.js +366 -0
- package/build/tools/memory-tools.js.map +1 -0
- package/build/tools/planning-helpers.d.ts +26 -0
- package/build/tools/planning-helpers.d.ts.map +1 -0
- package/build/tools/planning-helpers.js +269 -0
- package/build/tools/planning-helpers.js.map +1 -0
- package/build/tools/project-graph.d.ts +19 -0
- package/build/tools/project-graph.d.ts.map +1 -0
- package/build/tools/project-graph.js +259 -0
- package/build/tools/project-graph.js.map +1 -0
- package/build/tools/propose-commit.d.ts +9 -0
- package/build/tools/propose-commit.d.ts.map +1 -0
- package/build/tools/propose-commit.js +156 -0
- package/build/tools/propose-commit.js.map +1 -0
- package/build/tools/register-tools.d.ts +18 -0
- package/build/tools/register-tools.d.ts.map +1 -0
- package/build/tools/register-tools.js +1131 -0
- package/build/tools/register-tools.js.map +1 -0
- package/build/tools/reindex.d.ts +76 -0
- package/build/tools/reindex.d.ts.map +1 -0
- package/build/tools/reindex.js +871 -0
- package/build/tools/reindex.js.map +1 -0
- package/build/tools/related.d.ts +6 -0
- package/build/tools/related.d.ts.map +1 -0
- package/build/tools/related.js +143 -0
- package/build/tools/related.js.map +1 -0
- package/build/tools/repo-map.d.ts +59 -0
- package/build/tools/repo-map.d.ts.map +1 -0
- package/build/tools/repo-map.js +270 -0
- package/build/tools/repo-map.js.map +1 -0
- package/build/tools/resolve-symbol.d.ts +41 -0
- package/build/tools/resolve-symbol.d.ts.map +1 -0
- package/build/tools/resolve-symbol.js +250 -0
- package/build/tools/resolve-symbol.js.map +1 -0
- package/build/tools/retrieval-helpers.d.ts +35 -0
- package/build/tools/retrieval-helpers.d.ts.map +1 -0
- package/build/tools/retrieval-helpers.js +302 -0
- package/build/tools/retrieval-helpers.js.map +1 -0
- package/build/tools/scip-index.d.ts +12 -0
- package/build/tools/scip-index.d.ts.map +1 -0
- package/build/tools/scip-index.js +66 -0
- package/build/tools/scip-index.js.map +1 -0
- package/build/tools/scoped-discovery.d.ts +7 -0
- package/build/tools/scoped-discovery.d.ts.map +1 -0
- package/build/tools/scoped-discovery.js +89 -0
- package/build/tools/scoped-discovery.js.map +1 -0
- package/build/tools/search.d.ts +62 -0
- package/build/tools/search.d.ts.map +1 -0
- package/build/tools/search.js +419 -0
- package/build/tools/search.js.map +1 -0
- package/build/tools/semantic-diff.d.ts +7 -0
- package/build/tools/semantic-diff.d.ts.map +1 -0
- package/build/tools/semantic-diff.js +45 -0
- package/build/tools/semantic-diff.js.map +1 -0
- package/build/tools/semantic-identifiers.d.ts +51 -0
- package/build/tools/semantic-identifiers.d.ts.map +1 -0
- package/build/tools/semantic-identifiers.js +522 -0
- package/build/tools/semantic-identifiers.js.map +1 -0
- package/build/tools/semantic-navigate.d.ts +18 -0
- package/build/tools/semantic-navigate.d.ts.map +1 -0
- package/build/tools/semantic-navigate.js +413 -0
- package/build/tools/semantic-navigate.js.map +1 -0
- package/build/tools/semantic-search.d.ts +30 -0
- package/build/tools/semantic-search.d.ts.map +1 -0
- package/build/tools/semantic-search.js +466 -0
- package/build/tools/semantic-search.js.map +1 -0
- package/build/tools/sql-schema.d.ts +23 -0
- package/build/tools/sql-schema.d.ts.map +1 -0
- package/build/tools/sql-schema.js +155 -0
- package/build/tools/sql-schema.js.map +1 -0
- package/build/tools/static-analysis.d.ts +7 -0
- package/build/tools/static-analysis.d.ts.map +1 -0
- package/build/tools/static-analysis.js +331 -0
- package/build/tools/static-analysis.js.map +1 -0
- package/build/tools/status.d.ts +74 -0
- package/build/tools/status.d.ts.map +1 -0
- package/build/tools/status.js +227 -0
- package/build/tools/status.js.map +1 -0
- package/build/tools/symbolic-edit.d.ts +57 -0
- package/build/tools/symbolic-edit.d.ts.map +1 -0
- package/build/tools/symbolic-edit.js +500 -0
- package/build/tools/symbolic-edit.js.map +1 -0
- package/build/tools/test-impact.d.ts +7 -0
- package/build/tools/test-impact.d.ts.map +1 -0
- package/build/tools/test-impact.js +34 -0
- package/build/tools/test-impact.js.map +1 -0
- package/build/tools/test-map.d.ts +8 -0
- package/build/tools/test-map.d.ts.map +1 -0
- package/build/tools/test-map.js +75 -0
- package/build/tools/test-map.js.map +1 -0
- package/docs/README.md +26 -0
- package/docs/architecture.md +35 -0
- package/docs/configuration.md +178 -0
- package/docs/maintenance.md +77 -0
- package/package.json +80 -4
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
// Compiler edits are previewed as immutable artifacts, then hash-checked at application.
|
|
2
|
+
import { createHash } from "node:crypto";
|
|
3
|
+
import { realpath } from "node:fs/promises";
|
|
4
|
+
import { extname } from "node:path";
|
|
5
|
+
import { getDB } from "../core/db.js";
|
|
6
|
+
import { resolveProjectPath } from "../core/path-guard.js";
|
|
7
|
+
import { workspaceState } from "../core/evidence-state.js";
|
|
8
|
+
import { persistArtifact, readArtifact, buildArtifactId } from "../core/artifacts.js";
|
|
9
|
+
import { queryTypeScriptCompiler } from "../core/typescript-reference-process.js";
|
|
10
|
+
import { pythonOperation } from "../core/python-language-server.js";
|
|
11
|
+
import { captureSource, assertSourceUnchanged, publishSource, withSourceMutation } from "../core/source-mutation.js";
|
|
12
|
+
import { createRestorePoint } from "../git/shadow.js";
|
|
13
|
+
import { assertRenameName } from "./symbolic-edit.js";
|
|
14
|
+
import { invalidateSearchCache } from "./semantic-search.js";
|
|
15
|
+
import { invalidateIdentifierSearchCache } from "./semantic-identifiers.js";
|
|
16
|
+
const typescript = (file) => /\.(?:[cm]?[jt]s|[jt]sx)$/.test(file);
|
|
17
|
+
const digest = (value) => createHash("sha256").update(JSON.stringify(value)).digest("hex");
|
|
18
|
+
async function languageFiles(root, python) {
|
|
19
|
+
return (await getDB(root)).getAllFiles().filter(file => python ? file.path.endsWith(".py") : typescript(file.path))
|
|
20
|
+
.map(file => resolveProjectPath(root, file.path));
|
|
21
|
+
}
|
|
22
|
+
export async function compilerDiagnostics(options) {
|
|
23
|
+
const tsFiles = options.files.filter(typescript).map(file => resolveProjectPath(options.rootDir, file));
|
|
24
|
+
const pyFiles = options.files.filter(file => file.endsWith(".py")).map(file => resolveProjectPath(options.rootDir, file));
|
|
25
|
+
const unsupported = options.files.filter(file => !typescript(file) && !file.endsWith(".py"));
|
|
26
|
+
const results = [];
|
|
27
|
+
if (tsFiles.length)
|
|
28
|
+
results.push(await queryTypeScriptCompiler({ rootDir: options.rootDir, files: tsFiles, operation: "diagnostics" }));
|
|
29
|
+
if (pyFiles.length)
|
|
30
|
+
results.push(await pythonOperation({ rootDir: options.rootDir, files: pyFiles, operation: "diagnostics" }));
|
|
31
|
+
return { results, unsupported, execution: "compiler diagnostics only; tests were not executed" };
|
|
32
|
+
}
|
|
33
|
+
export async function previewRename(options) {
|
|
34
|
+
const root = await realpath(options.rootDir), file = resolveProjectPath(root, options.file);
|
|
35
|
+
const python = extname(file) === ".py";
|
|
36
|
+
if (!python && !typescript(file))
|
|
37
|
+
throw new Error("Compiler rename supports TS/JS and Python. Other languages retain the explicit textual rename tool.");
|
|
38
|
+
assertRenameName(options.newName, file);
|
|
39
|
+
const state = await workspaceState(root);
|
|
40
|
+
const input = { rootDir: root, files: await languageFiles(root, python), file, line: options.line, column: options.column, newName: options.newName, operation: "rename" };
|
|
41
|
+
const result = python ? await pythonOperation(input) : await queryTypeScriptCompiler(input);
|
|
42
|
+
const current = await workspaceState(root);
|
|
43
|
+
if (state.digest !== current.digest || state.revision !== current.revision)
|
|
44
|
+
throw new Error("Workspace changed during rename analysis; retry.");
|
|
45
|
+
const files = [];
|
|
46
|
+
const paths = [...new Set(result.edits?.map(edit => edit.file) ?? [])];
|
|
47
|
+
if (paths.length > 100 || (result.edits?.length ?? 0) > 5000)
|
|
48
|
+
throw new Error("Rename exceeds 100 files or 5,000 edits; narrow the operation.");
|
|
49
|
+
for (const path of paths) {
|
|
50
|
+
const snapshot = captureSource(root, path);
|
|
51
|
+
if (snapshot.content === null || !snapshot.hash)
|
|
52
|
+
throw new Error(`Missing rename source: ${path}`);
|
|
53
|
+
const before = state.files.find(item => item.file === path);
|
|
54
|
+
if (!before || before.hash !== snapshot.hash)
|
|
55
|
+
throw new Error(`Rename touches excluded or changed source: ${path}`);
|
|
56
|
+
const edits = result.edits.filter(edit => edit.file === path).sort((a, b) => b.start - a.start);
|
|
57
|
+
let next = snapshot.content, boundary = next.length;
|
|
58
|
+
for (const edit of edits) {
|
|
59
|
+
if (edit.start < 0 || edit.length < 0 || edit.start + edit.length > boundary)
|
|
60
|
+
throw new Error("Overlapping or invalid compiler edits.");
|
|
61
|
+
next = next.slice(0, edit.start) + edit.text + next.slice(edit.start + edit.length);
|
|
62
|
+
boundary = edit.start;
|
|
63
|
+
}
|
|
64
|
+
files.push({ file: path, hash: snapshot.hash, next, edits: edits.map(({ start, length, text }) => ({ start, length, text })) });
|
|
65
|
+
}
|
|
66
|
+
if (!files.length)
|
|
67
|
+
throw new Error("No compiler rename edits.");
|
|
68
|
+
const payload = { root, stateDigest: state.digest, revision: state.revision, engine: result.engine, warnings: result.warnings, files };
|
|
69
|
+
if (Buffer.byteLength(JSON.stringify(payload)) > 8 * 1024 * 1024)
|
|
70
|
+
throw new Error("Rename preview exceeds 8 MiB; narrow the operation.");
|
|
71
|
+
const artifact = await persistArtifact({ rootDir: root, kind: "rename_preview", key: digest(payload), payload, immutable: true });
|
|
72
|
+
const summary = { artifact, engine: result.engine, warnings: result.warnings, files: files.map(({ file, hash, edits }) => ({ file, hash, edits })) };
|
|
73
|
+
const text = JSON.stringify(summary);
|
|
74
|
+
const budget = (options.maxTokens ?? 4000) * 4;
|
|
75
|
+
if (Buffer.byteLength(text) <= budget)
|
|
76
|
+
return text;
|
|
77
|
+
const compact = { artifact: { id: artifact.id }, engine: result.engine, fileCount: files.length, files: [], omittedFileCount: files.length,
|
|
78
|
+
omitted: "Edit details and additional paths may exceed the response budget; inspect artifact_read before applying." };
|
|
79
|
+
for (const { file } of files) {
|
|
80
|
+
const next = { ...compact, files: [...compact.files, file], omittedFileCount: compact.omittedFileCount - 1 };
|
|
81
|
+
if (Buffer.byteLength(JSON.stringify(next)) > budget)
|
|
82
|
+
break;
|
|
83
|
+
Object.assign(compact, next);
|
|
84
|
+
}
|
|
85
|
+
return JSON.stringify(compact);
|
|
86
|
+
}
|
|
87
|
+
export async function applyRename(options) {
|
|
88
|
+
const root = await realpath(options.rootDir);
|
|
89
|
+
return withSourceMutation(root, async () => {
|
|
90
|
+
const artifact = await readArtifact(root, options.previewId);
|
|
91
|
+
if (!artifact || artifact.kind !== "rename_preview" || artifact.payload.root !== root
|
|
92
|
+
|| artifact.id !== buildArtifactId("rename_preview", digest(artifact.payload)))
|
|
93
|
+
throw new Error("Invalid rename preview for this workspace.");
|
|
94
|
+
const state = await workspaceState(root);
|
|
95
|
+
if (state.digest !== artifact.payload.stateDigest || state.revision !== artifact.payload.revision)
|
|
96
|
+
throw new Error("Rename preview is stale; create a new preview.");
|
|
97
|
+
const staged = artifact.payload.files.map(file => ({ ...file, snapshot: captureSource(root, file.file) }));
|
|
98
|
+
for (const item of staged)
|
|
99
|
+
if (item.snapshot.hash !== item.hash)
|
|
100
|
+
throw new Error(`Rename source changed: ${item.file}`);
|
|
101
|
+
const restore = await createRestorePoint(root, staged.map(item => item.file), `Compiler rename ${artifact.id}`);
|
|
102
|
+
for (const item of staged)
|
|
103
|
+
assertSourceUnchanged(root, item.snapshot);
|
|
104
|
+
const completed = [];
|
|
105
|
+
try {
|
|
106
|
+
for (const item of staged) {
|
|
107
|
+
await publishSource(root, item.snapshot, item.next);
|
|
108
|
+
completed.push(item.file);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
catch (error) {
|
|
112
|
+
throw new Error(`Rename stopped: ${error.message}. Updated: ${completed.join(", ") || "none"}. Restore point: ${restore.id}`);
|
|
113
|
+
}
|
|
114
|
+
finally {
|
|
115
|
+
invalidateSearchCache();
|
|
116
|
+
invalidateIdentifierSearchCache();
|
|
117
|
+
}
|
|
118
|
+
return { updated: completed, restorePoint: restore.id, engine: artifact.payload.engine, verification: "Run validate_scope and the recommended checks; applying edits does not prove correctness." };
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
//# sourceMappingURL=compiler-actions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compiler-actions.js","sourceRoot":"","sources":["../../src/tools/compiler-actions.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export interface ContextTreeOptions {
|
|
2
|
+
rootDir: string;
|
|
3
|
+
targetPath?: string;
|
|
4
|
+
depthLimit?: number;
|
|
5
|
+
includeSymbols?: boolean;
|
|
6
|
+
maxTokens?: number;
|
|
7
|
+
}
|
|
8
|
+
export declare function getContextTree(options: ContextTreeOptions): Promise<string>;
|
|
9
|
+
//# sourceMappingURL=context-tree.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context-tree.d.ts","sourceRoot":"","sources":["../../src/tools/context-tree.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2HD,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBjF"}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
// Structural tree generator with file headers, symbols, and depth control
|
|
2
|
+
// Dynamic token-aware pruning: Level 0 (files only) to Level 2 (deep context)
|
|
3
|
+
import { walkDirectory } from "../core/walker.js";
|
|
4
|
+
import { analyzeFile, formatSymbol, isSupportedFile } from "../core/parser.js";
|
|
5
|
+
const CHARS_PER_TOKEN = 4;
|
|
6
|
+
function estimateTokens(text) {
|
|
7
|
+
return Math.ceil(text.length / CHARS_PER_TOKEN);
|
|
8
|
+
}
|
|
9
|
+
async function buildTree(entries, _rootDir, includeSymbols) {
|
|
10
|
+
const root = { name: ".", relativePath: ".", isDirectory: true, children: [] };
|
|
11
|
+
const dirMap = new Map();
|
|
12
|
+
dirMap.set(".", root);
|
|
13
|
+
const sortedEntries = entries.sort((a, b) => a.depth - b.depth || a.relativePath.localeCompare(b.relativePath));
|
|
14
|
+
for (const entry of sortedEntries) {
|
|
15
|
+
const parts = entry.relativePath.split("/");
|
|
16
|
+
const parentPath = parts.length > 1 ? parts.slice(0, -1).join("/") : ".";
|
|
17
|
+
let parent = dirMap.get(parentPath);
|
|
18
|
+
if (!parent) {
|
|
19
|
+
parent = root;
|
|
20
|
+
}
|
|
21
|
+
const node = {
|
|
22
|
+
name: parts[parts.length - 1],
|
|
23
|
+
relativePath: entry.relativePath,
|
|
24
|
+
isDirectory: entry.isDirectory,
|
|
25
|
+
children: [],
|
|
26
|
+
};
|
|
27
|
+
if (!entry.isDirectory && isSupportedFile(entry.path)) {
|
|
28
|
+
try {
|
|
29
|
+
const analysis = await analyzeFile(entry.path);
|
|
30
|
+
node.header = analysis.header || undefined;
|
|
31
|
+
if (includeSymbols && analysis.symbols.length > 0) {
|
|
32
|
+
node.symbols = analysis.symbols.map((s) => formatSymbol(s, 0)).join("\n");
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
catch { }
|
|
36
|
+
}
|
|
37
|
+
parent.children.push(node);
|
|
38
|
+
if (entry.isDirectory) {
|
|
39
|
+
dirMap.set(entry.relativePath, node);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
return root;
|
|
43
|
+
}
|
|
44
|
+
function renderTree(node, indent = 0) {
|
|
45
|
+
let result = "";
|
|
46
|
+
const pad = " ".repeat(indent);
|
|
47
|
+
if (indent === 0) {
|
|
48
|
+
result = `${node.name}/\n`;
|
|
49
|
+
}
|
|
50
|
+
else if (node.isDirectory) {
|
|
51
|
+
result = `${pad}${node.name}/\n`;
|
|
52
|
+
}
|
|
53
|
+
else {
|
|
54
|
+
result = `${pad}${node.name}`;
|
|
55
|
+
if (node.header)
|
|
56
|
+
result += ` | ${node.header}`;
|
|
57
|
+
result += "\n";
|
|
58
|
+
if (node.symbols) {
|
|
59
|
+
for (const line of node.symbols.split("\n")) {
|
|
60
|
+
result += `${pad} ${line}\n`;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
for (const child of node.children) {
|
|
65
|
+
result += renderTree(child, indent + 1);
|
|
66
|
+
}
|
|
67
|
+
return result;
|
|
68
|
+
}
|
|
69
|
+
function pruneSymbols(node) {
|
|
70
|
+
node.symbols = undefined;
|
|
71
|
+
for (const child of node.children)
|
|
72
|
+
pruneSymbols(child);
|
|
73
|
+
}
|
|
74
|
+
function pruneHeaders(node) {
|
|
75
|
+
node.header = undefined;
|
|
76
|
+
node.symbols = undefined;
|
|
77
|
+
for (const child of node.children)
|
|
78
|
+
pruneHeaders(child);
|
|
79
|
+
}
|
|
80
|
+
async function resolveTargetPathFuzzy(rootDir, targetPath) {
|
|
81
|
+
if (!targetPath)
|
|
82
|
+
return { resolved: undefined, note: null };
|
|
83
|
+
// First try the literal path. If walker returns at least one entry, accept.
|
|
84
|
+
const literalEntries = await walkDirectory({ rootDir, targetPath, depthLimit: 1 }).catch(() => []);
|
|
85
|
+
if (literalEntries.length > 0)
|
|
86
|
+
return { resolved: targetPath, note: null };
|
|
87
|
+
// Fuzzy: try common prefixes (src/, app/, lib/, packages/) and look for the trailing
|
|
88
|
+
// component as a directory under them.
|
|
89
|
+
const trimmed = targetPath.replace(/\/+$/, "");
|
|
90
|
+
const segment = trimmed.split("/").pop() ?? trimmed;
|
|
91
|
+
const candidates = [
|
|
92
|
+
`src/${trimmed}`,
|
|
93
|
+
`src/${segment}`,
|
|
94
|
+
`app/${trimmed}`,
|
|
95
|
+
`app/${segment}`,
|
|
96
|
+
`lib/${trimmed}`,
|
|
97
|
+
`lib/${segment}`,
|
|
98
|
+
`packages/${trimmed}`,
|
|
99
|
+
`packages/${segment}`,
|
|
100
|
+
];
|
|
101
|
+
for (const candidate of candidates) {
|
|
102
|
+
const entries = await walkDirectory({ rootDir, targetPath: candidate, depthLimit: 1 }).catch(() => []);
|
|
103
|
+
if (entries.length > 0) {
|
|
104
|
+
return { resolved: candidate, note: `Fuzzy-resolved "${targetPath}" → "${candidate}". Pass the full project-relative path next time to skip this guess.` };
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
return { resolved: targetPath, note: `target_path "${targetPath}" did not match any indexed directory. Showing empty result. Tried: ${candidates.join(", ")}` };
|
|
108
|
+
}
|
|
109
|
+
export async function getContextTree(options) {
|
|
110
|
+
const { resolved, note } = await resolveTargetPathFuzzy(options.rootDir, options.targetPath);
|
|
111
|
+
const entries = await walkDirectory({
|
|
112
|
+
rootDir: options.rootDir,
|
|
113
|
+
targetPath: resolved,
|
|
114
|
+
depthLimit: options.depthLimit,
|
|
115
|
+
});
|
|
116
|
+
const includeSymbols = options.includeSymbols !== false;
|
|
117
|
+
const tree = await buildTree(entries, options.rootDir, includeSymbols);
|
|
118
|
+
const maxTokens = options.maxTokens ?? 20000;
|
|
119
|
+
const prefix = note ? `[${note}]\n\n` : "";
|
|
120
|
+
let rendered = renderTree(tree);
|
|
121
|
+
if (estimateTokens(rendered) <= maxTokens)
|
|
122
|
+
return prefix + rendered;
|
|
123
|
+
pruneSymbols(tree);
|
|
124
|
+
rendered = renderTree(tree);
|
|
125
|
+
if (estimateTokens(rendered) <= maxTokens)
|
|
126
|
+
return `${prefix}[Level 1: Headers only, symbols pruned to fit ${maxTokens} tokens]\n\n${rendered}`;
|
|
127
|
+
pruneHeaders(tree);
|
|
128
|
+
rendered = renderTree(tree);
|
|
129
|
+
return `${prefix}[Level 0: File names only, project too large for ${maxTokens} tokens]\n\n${rendered}`;
|
|
130
|
+
}
|
|
131
|
+
//# sourceMappingURL=context-tree.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context-tree.js","sourceRoot":"","sources":["../../src/tools/context-tree.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { retrieveEvidence } from "./evidence-retrieval.js";
|
|
2
|
+
export interface ContextTarget {
|
|
3
|
+
file: string;
|
|
4
|
+
symbol?: string;
|
|
5
|
+
start?: number;
|
|
6
|
+
end?: number;
|
|
7
|
+
}
|
|
8
|
+
export interface ContextOptions {
|
|
9
|
+
rootDir: string;
|
|
10
|
+
query?: string;
|
|
11
|
+
targets?: ContextTarget[];
|
|
12
|
+
maxTokens?: number;
|
|
13
|
+
previousContextId?: string;
|
|
14
|
+
intent?: "auto" | "lookup" | "change" | "debug" | "review" | "overview";
|
|
15
|
+
/** Internal evaluation override; the MCP surface uses configured defaults. */
|
|
16
|
+
retrievalPreset?: "balanced" | "keyword_only" | "semantic_only";
|
|
17
|
+
connected?: boolean;
|
|
18
|
+
retrieved?: Awaited<ReturnType<typeof retrieveEvidence>>;
|
|
19
|
+
}
|
|
20
|
+
export interface Excerpt {
|
|
21
|
+
file: string;
|
|
22
|
+
start: number;
|
|
23
|
+
end: number;
|
|
24
|
+
text: string;
|
|
25
|
+
}
|
|
26
|
+
export interface SourceEvidence {
|
|
27
|
+
text: string;
|
|
28
|
+
ranges: Excerpt[];
|
|
29
|
+
hashes: Record<string, string>;
|
|
30
|
+
notices: string[];
|
|
31
|
+
/** Delivery completeness, not a claim of exhaustive repository coverage. */
|
|
32
|
+
complete: boolean;
|
|
33
|
+
settings: string;
|
|
34
|
+
}
|
|
35
|
+
export declare function getContext(options: ContextOptions): Promise<string>;
|
|
36
|
+
export declare function collectSourceEvidence(options: ContextOptions): Promise<SourceEvidence>;
|
|
37
|
+
//# sourceMappingURL=context.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAkBA,OAAO,EAA6B,gBAAgB,EAA0B,MAAM,yBAAyB,CAAC;AAO9G,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxE,8EAA8E;IAC9E,eAAe,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,eAAe,CAAC;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;CAC1D;AACD,MAAM,WAAW,OAAO;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AACpF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IACnF,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CACrC;AA0CD,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAKzE;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAgkB5F"}
|