@documentation-robotics/cli 0.1.0 → 0.1.5
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/LICENSE +21 -0
- package/README.md +466 -693
- package/dist/analysis/data-model-analyzer.js +189 -0
- package/dist/analysis/data-model-analyzer.js.map +7 -0
- package/dist/analysis/index.js +3 -0
- package/dist/analysis/index.js.map +7 -0
- package/dist/analysis/relationship-classifier.js +181 -0
- package/dist/analysis/relationship-classifier.js.map +7 -0
- package/dist/analyzers/base-analyzer.js +1 -0
- package/dist/analyzers/base-analyzer.js.map +7 -0
- package/dist/analyzers/call-graph-utils.js +39 -0
- package/dist/analyzers/call-graph-utils.js.map +7 -0
- package/dist/analyzers/cbm-analyzer.js +1205 -0
- package/dist/analyzers/cbm-analyzer.js.map +7 -0
- package/dist/analyzers/heuristic-utils.js +55 -0
- package/dist/analyzers/heuristic-utils.js.map +7 -0
- package/dist/analyzers/mapping-loader.js +146 -0
- package/dist/analyzers/mapping-loader.js.map +7 -0
- package/dist/analyzers/registry.js +124 -0
- package/dist/analyzers/registry.js.map +7 -0
- package/dist/analyzers/session-state.js +176 -0
- package/dist/analyzers/session-state.js.map +7 -0
- package/dist/analyzers/stdio-client.js +206 -0
- package/dist/analyzers/stdio-client.js.map +7 -0
- package/dist/analyzers/types.js +15 -0
- package/dist/analyzers/types.js.map +7 -0
- package/dist/analyzers/verify-engine.js +209 -0
- package/dist/analyzers/verify-engine.js.map +7 -0
- package/dist/analyzers/verify-ignore.js +130 -0
- package/dist/analyzers/verify-ignore.js.map +7 -0
- package/dist/analyzers/version.js +8 -0
- package/dist/analyzers/version.js.map +7 -0
- package/dist/audit/ai/runner.js +41 -0
- package/dist/audit/ai/runner.js.map +7 -0
- package/dist/audit/differential-analyzer.js +183 -0
- package/dist/audit/differential-analyzer.js.map +7 -0
- package/dist/audit/index.js +32 -0
- package/dist/audit/index.js.map +7 -0
- package/dist/audit/nodes/ai/evaluator.js +49 -0
- package/dist/audit/nodes/ai/evaluator.js.map +7 -0
- package/dist/audit/nodes/ai/parser.js +55 -0
- package/dist/audit/nodes/ai/parser.js.map +7 -0
- package/dist/audit/nodes/ai/prompts.js +103 -0
- package/dist/audit/nodes/ai/prompts.js.map +7 -0
- package/dist/audit/nodes/analysis/node-completeness-checker.js +32 -0
- package/dist/audit/nodes/analysis/node-completeness-checker.js.map +7 -0
- package/dist/audit/nodes/analysis/node-definition-analyzer.js +47 -0
- package/dist/audit/nodes/analysis/node-definition-analyzer.js.map +7 -0
- package/dist/audit/nodes/analysis/node-overlap-detector.js +79 -0
- package/dist/audit/nodes/analysis/node-overlap-detector.js.map +7 -0
- package/dist/audit/nodes/model/orchestrator.js +82 -0
- package/dist/audit/nodes/model/orchestrator.js.map +7 -0
- package/dist/audit/nodes/spec/loader.js +116 -0
- package/dist/audit/nodes/spec/loader.js.map +7 -0
- package/dist/audit/nodes/spec/orchestrator.js +68 -0
- package/dist/audit/nodes/spec/orchestrator.js.map +7 -0
- package/dist/audit/nodes/types.js +1 -0
- package/dist/audit/nodes/types.js.map +7 -0
- package/dist/audit/pipeline/index.js +5 -0
- package/dist/audit/pipeline/index.js.map +7 -0
- package/dist/audit/pipeline/pipeline-orchestrator.js +218 -0
- package/dist/audit/pipeline/pipeline-orchestrator.js.map +7 -0
- package/dist/audit/relationships/ai/evaluator.js +235 -0
- package/dist/audit/relationships/ai/evaluator.js.map +7 -0
- package/dist/audit/relationships/ai/parser.js +197 -0
- package/dist/audit/relationships/ai/parser.js.map +7 -0
- package/dist/audit/relationships/ai/prompts.js +274 -0
- package/dist/audit/relationships/ai/prompts.js.map +7 -0
- package/dist/audit/relationships/analysis/balance-assessor.js +115 -0
- package/dist/audit/relationships/analysis/balance-assessor.js.map +7 -0
- package/dist/audit/relationships/analysis/coverage-analyzer.js +99 -0
- package/dist/audit/relationships/analysis/coverage-analyzer.js.map +7 -0
- package/dist/audit/relationships/analysis/duplicate-detector.js +95 -0
- package/dist/audit/relationships/analysis/duplicate-detector.js.map +7 -0
- package/dist/audit/relationships/analysis/gap-analyzer.js +99 -0
- package/dist/audit/relationships/analysis/gap-analyzer.js.map +7 -0
- package/dist/audit/relationships/analysis/layer-templates.js +294 -0
- package/dist/audit/relationships/analysis/layer-templates.js.map +7 -0
- package/dist/audit/relationships/graph/connectivity.js +129 -0
- package/dist/audit/relationships/graph/connectivity.js.map +7 -0
- package/dist/audit/relationships/graph/relationship-graph.js +179 -0
- package/dist/audit/relationships/graph/relationship-graph.js.map +7 -0
- package/dist/audit/relationships/model/balance-assessor.js +49 -0
- package/dist/audit/relationships/model/balance-assessor.js.map +7 -0
- package/dist/audit/relationships/model/coverage-analyzer.js +34 -0
- package/dist/audit/relationships/model/coverage-analyzer.js.map +7 -0
- package/dist/audit/relationships/model/duplicate-detector.js +68 -0
- package/dist/audit/relationships/model/duplicate-detector.js.map +7 -0
- package/dist/audit/relationships/model/gap-analyzer.js +41 -0
- package/dist/audit/relationships/model/gap-analyzer.js.map +7 -0
- package/dist/audit/relationships/model/orchestrator.js +126 -0
- package/dist/audit/relationships/model/orchestrator.js.map +7 -0
- package/dist/audit/relationships/spec/orchestrator.js +157 -0
- package/dist/audit/relationships/spec/orchestrator.js.map +7 -0
- package/dist/audit/reports/index.js +5 -0
- package/dist/audit/reports/index.js.map +7 -0
- package/dist/audit/reports/report-generator.js +118 -0
- package/dist/audit/reports/report-generator.js.map +7 -0
- package/dist/audit/snapshot-storage.js +163 -0
- package/dist/audit/snapshot-storage.js.map +7 -0
- package/dist/audit/types.js +21 -0
- package/dist/audit/types.js.map +7 -0
- package/dist/cli.js +223 -92
- package/dist/cli.js.map +3 -3
- package/dist/coding-agents/agents/claude-code.js +147 -0
- package/dist/coding-agents/agents/claude-code.js.map +7 -0
- package/dist/coding-agents/agents/index.js +5 -0
- package/dist/coding-agents/agents/index.js.map +7 -0
- package/dist/coding-agents/agents/types.js +1 -0
- package/dist/coding-agents/agents/types.js.map +7 -0
- package/dist/coding-agents/base-chat-client.js +45 -0
- package/dist/coding-agents/base-chat-client.js.map +7 -0
- package/dist/coding-agents/chat-utils.js +23 -0
- package/dist/coding-agents/chat-utils.js.map +7 -0
- package/dist/coding-agents/claude-code-client.js +246 -0
- package/dist/coding-agents/claude-code-client.js.map +7 -0
- package/dist/coding-agents/copilot-client.js +209 -0
- package/dist/coding-agents/copilot-client.js.map +7 -0
- package/dist/commands/add.js +95 -33
- package/dist/commands/add.js.map +2 -2
- package/dist/commands/analyzer.js +511 -0
- package/dist/commands/analyzer.js.map +7 -0
- package/dist/commands/audit-diff.js +49 -0
- package/dist/commands/audit-diff.js.map +7 -0
- package/dist/commands/audit-snapshots.js +62 -0
- package/dist/commands/audit-snapshots.js.map +7 -0
- package/dist/commands/audit.js +81 -0
- package/dist/commands/audit.js.map +7 -0
- package/dist/commands/catalog.js +248 -0
- package/dist/commands/catalog.js.map +7 -0
- package/dist/commands/changeset.js +577 -66
- package/dist/commands/changeset.js.map +2 -2
- package/dist/commands/chat.js +106 -83
- package/dist/commands/chat.js.map +2 -2
- package/dist/commands/claude.js +74 -0
- package/dist/commands/claude.js.map +7 -0
- package/dist/commands/conformance.js +71 -68
- package/dist/commands/conformance.js.map +2 -2
- package/dist/commands/copilot.js +75 -0
- package/dist/commands/copilot.js.map +7 -0
- package/dist/commands/delete.js +125 -11
- package/dist/commands/delete.js.map +3 -3
- package/dist/commands/discover-logic.js +44 -0
- package/dist/commands/discover-logic.js.map +7 -0
- package/dist/commands/docs.js +87 -0
- package/dist/commands/docs.js.map +7 -0
- package/dist/commands/element.js +14 -20
- package/dist/commands/element.js.map +2 -2
- package/dist/commands/export.js +13 -3
- package/dist/commands/export.js.map +2 -2
- package/dist/commands/import.js +51 -0
- package/dist/commands/import.js.map +7 -0
- package/dist/commands/info.js +30 -24
- package/dist/commands/info.js.map +2 -2
- package/dist/commands/init.js +27 -11
- package/dist/commands/init.js.map +2 -2
- package/dist/commands/list.js +63 -13
- package/dist/commands/list.js.map +3 -3
- package/dist/commands/relationship.js +225 -37
- package/dist/commands/relationship.js.map +2 -2
- package/dist/commands/report.js +54 -0
- package/dist/commands/report.js.map +7 -0
- package/dist/commands/reports.js +45 -0
- package/dist/commands/reports.js.map +7 -0
- package/dist/commands/schema.js +135 -0
- package/dist/commands/schema.js.map +7 -0
- package/dist/commands/search.js +40 -12
- package/dist/commands/search.js.map +2 -2
- package/dist/commands/show.js +58 -27
- package/dist/commands/show.js.map +2 -2
- package/dist/commands/stats.js +35 -0
- package/dist/commands/stats.js.map +7 -0
- package/dist/commands/trace.js +39 -16
- package/dist/commands/trace.js.map +2 -2
- package/dist/commands/update.js +141 -14
- package/dist/commands/update.js.map +2 -2
- package/dist/commands/upgrade.js +210 -46
- package/dist/commands/upgrade.js.map +3 -3
- package/dist/commands/validate.js +142 -23
- package/dist/commands/validate.js.map +3 -3
- package/dist/commands/version.js +8 -12
- package/dist/commands/version.js.map +2 -2
- package/dist/commands/visualize.js +155 -25
- package/dist/commands/visualize.js.map +2 -2
- package/dist/core/base-snapshot-manager.js +84 -0
- package/dist/core/base-snapshot-manager.js.map +7 -0
- package/dist/core/changeset-exporter.js +305 -0
- package/dist/core/changeset-exporter.js.map +7 -0
- package/dist/core/changeset-validator.js +41 -0
- package/dist/core/changeset-validator.js.map +7 -0
- package/dist/core/changeset.js +88 -173
- package/dist/core/changeset.js.map +2 -2
- package/dist/core/dependency-tracker.js +4 -2
- package/dist/core/dependency-tracker.js.map +2 -2
- package/dist/core/element.js +98 -27
- package/dist/core/element.js.map +2 -2
- package/dist/core/golden-copy-cache.js +290 -0
- package/dist/core/golden-copy-cache.js.map +7 -0
- package/dist/core/graph-model.js +266 -0
- package/dist/core/graph-model.js.map +7 -0
- package/dist/core/layer.js +159 -16
- package/dist/core/layer.js.map +2 -2
- package/dist/core/layers.js +32 -0
- package/dist/core/layers.js.map +7 -0
- package/dist/core/manifest.js +32 -11
- package/dist/core/manifest.js.map +2 -2
- package/dist/core/migration-registry.js +56 -1
- package/dist/core/migration-registry.js.map +2 -2
- package/dist/core/model.js +424 -217
- package/dist/core/model.js.map +3 -3
- package/dist/core/mutation-handler.js +179 -0
- package/dist/core/mutation-handler.js.map +7 -0
- package/dist/core/reference-registry.js +29 -21
- package/dist/core/reference-registry.js.map +2 -2
- package/dist/core/relationship-catalog.js +189 -0
- package/dist/core/relationship-catalog.js.map +7 -0
- package/dist/core/relationship-registry.js.map +2 -2
- package/dist/core/relationships.js.map +1 -1
- package/dist/core/report-data-model.js +285 -0
- package/dist/core/report-data-model.js.map +7 -0
- package/dist/core/spec-data-service.js +185 -0
- package/dist/core/spec-data-service.js.map +7 -0
- package/dist/core/spec-loader-types.js +1 -0
- package/dist/core/spec-loader-types.js.map +7 -0
- package/dist/core/spec-loader.js +234 -0
- package/dist/core/spec-loader.js.map +7 -0
- package/dist/core/staged-changeset-storage.js +282 -0
- package/dist/core/staged-changeset-storage.js.map +7 -0
- package/dist/core/staging-area.js +1002 -0
- package/dist/core/staging-area.js.map +7 -0
- package/dist/core/stats-collector.js +169 -0
- package/dist/core/stats-collector.js.map +7 -0
- package/dist/core/virtual-projection.js +443 -0
- package/dist/core/virtual-projection.js.map +7 -0
- package/dist/export/archimate-exporter.js +99 -60
- package/dist/export/archimate-exporter.js.map +2 -2
- package/dist/export/audit-formatters.js +479 -0
- package/dist/export/audit-formatters.js.map +7 -0
- package/dist/export/diff-formatters.js +99 -0
- package/dist/export/diff-formatters.js.map +7 -0
- package/dist/export/export-manager.js.map +2 -2
- package/dist/export/graphml-exporter.js +44 -27
- package/dist/export/graphml-exporter.js.map +2 -2
- package/dist/export/index.js +4 -0
- package/dist/export/index.js.map +2 -2
- package/dist/export/json-schema-exporter.js +55 -42
- package/dist/export/json-schema-exporter.js.map +2 -2
- package/dist/export/markdown-exporter.js +92 -70
- package/dist/export/markdown-exporter.js.map +2 -2
- package/dist/export/markdown-generator.js +248 -0
- package/dist/export/markdown-generator.js.map +7 -0
- package/dist/export/markdown-utils.js +30 -0
- package/dist/export/markdown-utils.js.map +7 -0
- package/dist/export/mermaid-markdown-exporter.js +37 -0
- package/dist/export/mermaid-markdown-exporter.js.map +7 -0
- package/dist/export/openapi-exporter.js +119 -71
- package/dist/export/openapi-exporter.js.map +2 -2
- package/dist/export/plantuml-exporter.js +104 -39
- package/dist/export/plantuml-exporter.js.map +2 -2
- package/dist/export/report-formatters.js +111 -0
- package/dist/export/report-formatters.js.map +7 -0
- package/dist/export/stats-formatters.js +98 -0
- package/dist/export/stats-formatters.js.map +7 -0
- package/dist/export/types.js +2 -14
- package/dist/export/types.js.map +2 -2
- package/dist/export/verify-formatters.js +153 -0
- package/dist/export/verify-formatters.js.map +7 -0
- package/dist/generated/compiled-validators.js +17 -0
- package/dist/generated/compiled-validators.js.map +7 -0
- package/dist/generated/index.js +31 -0
- package/dist/generated/index.js.map +7 -0
- package/dist/generated/layer-registry.js +190 -0
- package/dist/generated/layer-registry.js.map +7 -0
- package/dist/generated/layer-types.js +7 -0
- package/dist/generated/layer-types.js.map +7 -0
- package/dist/generated/node-types.js +1719 -0
- package/dist/generated/node-types.js.map +7 -0
- package/dist/generated/relationship-index.js +14552 -0
- package/dist/generated/relationship-index.js.map +7 -0
- package/dist/import/archimate-importer.js +166 -0
- package/dist/import/archimate-importer.js.map +7 -0
- package/dist/import/index.js +47 -0
- package/dist/import/index.js.map +7 -0
- package/dist/import/openapi-importer.js +143 -0
- package/dist/import/openapi-importer.js.map +7 -0
- package/dist/import/types.js +1 -0
- package/dist/import/types.js.map +7 -0
- package/dist/integrations/base-manager.js +311 -0
- package/dist/integrations/base-manager.js.map +7 -0
- package/dist/integrations/claude-manager.js +360 -0
- package/dist/integrations/claude-manager.js.map +7 -0
- package/dist/integrations/claude_code/agents/dr-advisor.md +253 -0
- package/dist/integrations/claude_code/agents/dr-architect.md +278 -0
- package/dist/integrations/claude_code/agents/dr-extractor.md +286 -0
- package/dist/integrations/claude_code/commands/dr-changeset.md +657 -0
- package/dist/integrations/claude_code/commands/dr-design.md +373 -0
- package/dist/integrations/claude_code/commands/dr-info.md +132 -0
- package/dist/integrations/claude_code/commands/dr-init.md +251 -0
- package/dist/integrations/claude_code/commands/dr-map.md +936 -0
- package/dist/integrations/claude_code/commands/dr-model.md +493 -0
- package/dist/integrations/claude_code/commands/dr-relate.md +814 -0
- package/dist/integrations/claude_code/commands/dr-sync.md +279 -0
- package/dist/integrations/claude_code/commands/dr-validate.md +654 -0
- package/dist/integrations/claude_code/commands/dr-verify.md +559 -0
- package/dist/integrations/claude_code/docs/END_TO_END_WALKTHROUGH.md +903 -0
- package/dist/integrations/claude_code/docs/QUICK_START.md +271 -0
- package/dist/integrations/claude_code/docs/README.md +347 -0
- package/dist/integrations/claude_code/skills/dr_01_motivation_layer/SKILL.md +550 -0
- package/dist/integrations/claude_code/skills/dr_02_business_layer/SKILL.md +620 -0
- package/dist/integrations/claude_code/skills/dr_03_security_layer/SKILL.md +642 -0
- package/dist/integrations/claude_code/skills/dr_04_application_layer/SKILL.md +911 -0
- package/dist/integrations/claude_code/skills/dr_05_technology_layer/SKILL.md +836 -0
- package/dist/integrations/claude_code/skills/dr_06_api_layer/SKILL.md +933 -0
- package/dist/integrations/claude_code/skills/dr_07_data_model_layer/SKILL.md +210 -0
- package/dist/integrations/claude_code/skills/dr_08_dataset_layer/SKILL.md +319 -0
- package/dist/integrations/claude_code/skills/dr_09_ux_layer/SKILL.md +319 -0
- package/dist/integrations/claude_code/skills/dr_10_navigation_layer/SKILL.md +318 -0
- package/dist/integrations/claude_code/skills/dr_11_apm_layer/SKILL.md +273 -0
- package/dist/integrations/claude_code/skills/dr_12_testing_layer/SKILL.md +273 -0
- package/dist/integrations/claude_code/skills/dr_changeset_reviewer/SKILL.md +187 -0
- package/dist/integrations/claude_code/skills/dr_codebase_memory/SKILL.md +590 -0
- package/dist/integrations/claude_code/skills/dr_engineering_guide/SKILL.md +295 -0
- package/dist/integrations/copilot-manager.js +328 -0
- package/dist/integrations/copilot-manager.js.map +7 -0
- package/dist/integrations/github_copilot/agents/dr-advisor.md +243 -0
- package/dist/integrations/github_copilot/agents/dr-architect.md +1567 -0
- package/dist/integrations/github_copilot/skills/dr_01_motivation_layer/SKILL.md +491 -0
- package/dist/integrations/github_copilot/skills/dr_02_business_layer/SKILL.md +539 -0
- package/dist/integrations/github_copilot/skills/dr_03_security_layer/SKILL.md +667 -0
- package/dist/integrations/github_copilot/skills/dr_04_application_layer/SKILL.md +670 -0
- package/dist/integrations/github_copilot/skills/dr_05_technology_layer/SKILL.md +660 -0
- package/dist/integrations/github_copilot/skills/dr_06_api_layer/SKILL.md +855 -0
- package/dist/integrations/github_copilot/skills/dr_07_data_model_layer/SKILL.md +171 -0
- package/dist/integrations/github_copilot/skills/dr_08_dataset_layer/SKILL.md +216 -0
- package/dist/integrations/github_copilot/skills/dr_09_ux_layer/SKILL.md +230 -0
- package/dist/integrations/github_copilot/skills/dr_10_navigation_layer/SKILL.md +228 -0
- package/dist/integrations/github_copilot/skills/dr_11_apm_layer/SKILL.md +234 -0
- package/dist/integrations/github_copilot/skills/dr_12_testing_layer/SKILL.md +230 -0
- package/dist/integrations/github_copilot/skills/dr_changeset_reviewer/SKILL.md +187 -0
- package/dist/integrations/hash-utils.js +51 -0
- package/dist/integrations/hash-utils.js.map +7 -0
- package/dist/integrations/types.js +16 -0
- package/dist/integrations/types.js.map +7 -0
- package/dist/reports/model-layer-report-generator.js +278 -0
- package/dist/reports/model-layer-report-generator.js.map +7 -0
- package/dist/reports/model-report-data.js +57 -0
- package/dist/reports/model-report-data.js.map +7 -0
- package/dist/reports/model-report-orchestrator.js +103 -0
- package/dist/reports/model-report-orchestrator.js.map +7 -0
- package/dist/schemas/bundled/analyzers/cbm.json +595 -0
- package/dist/schemas/bundled/analyzers/manifest.json +9 -0
- package/dist/schemas/bundled/api.json +3411 -0
- package/dist/schemas/bundled/apm.json +2371 -0
- package/dist/schemas/bundled/application.json +1253 -0
- package/dist/schemas/bundled/base.json +1622 -0
- package/dist/schemas/bundled/business.json +1279 -0
- package/dist/schemas/bundled/data-model.json +1298 -0
- package/dist/schemas/bundled/data-store.json +2025 -0
- package/dist/schemas/bundled/manifest.json +93 -0
- package/dist/schemas/bundled/motivation.json +1360 -0
- package/dist/schemas/bundled/navigation.json +1874 -0
- package/dist/schemas/bundled/security.json +3488 -0
- package/dist/schemas/bundled/technology.json +2067 -0
- package/dist/schemas/bundled/testing.json +3120 -0
- package/dist/schemas/bundled/ux.json +3592 -0
- package/dist/server/schemas.js +202 -0
- package/dist/server/schemas.js.map +7 -0
- package/dist/server/server.js +1336 -252
- package/dist/server/server.js.map +3 -3
- package/dist/server/telemetry-middleware.js +22 -15
- package/dist/server/telemetry-middleware.js.map +2 -2
- package/dist/server-entry.js +65 -0
- package/dist/server-entry.js.map +7 -0
- package/dist/telemetry/config.js +89 -0
- package/dist/telemetry/config.js.map +7 -0
- package/dist/telemetry/console-interceptor.js.map +1 -1
- package/dist/telemetry/detect.js +24 -0
- package/dist/telemetry/detect.js.map +7 -0
- package/dist/telemetry/fetch-otlp-exporter.js +112 -0
- package/dist/telemetry/fetch-otlp-exporter.js.map +7 -0
- package/dist/telemetry/index.js +153 -3
- package/dist/telemetry/index.js.map +2 -2
- package/dist/telemetry/resilient-exporter.js +22 -8
- package/dist/telemetry/resilient-exporter.js.map +2 -2
- package/dist/telemetry/resilient-log-exporter.js +17 -8
- package/dist/telemetry/resilient-log-exporter.js.map +2 -2
- package/dist/telemetry/test-instrumentation.js.map +2 -2
- package/dist/types/index.js +84 -0
- package/dist/types/index.js.map +3 -3
- package/dist/types/source-reference.js +1 -0
- package/dist/types/source-reference.js.map +7 -0
- package/dist/utils/chat-logger.js +292 -0
- package/dist/utils/chat-logger.js.map +7 -0
- package/dist/utils/claude-stream.js +8 -0
- package/dist/utils/claude-stream.js.map +7 -0
- package/dist/utils/date-utils.js +7 -0
- package/dist/utils/date-utils.js.map +7 -0
- package/dist/utils/element-utils.js.map +1 -1
- package/dist/utils/errors.js +88 -15
- package/dist/utils/errors.js.map +3 -3
- package/dist/utils/export-python-annotations.js +82 -0
- package/dist/utils/export-python-annotations.js.map +7 -0
- package/dist/utils/file-io.js +7 -2
- package/dist/utils/file-io.js.map +2 -2
- package/dist/utils/file-lock.js +156 -0
- package/dist/utils/file-lock.js.map +7 -0
- package/dist/utils/id-generator.js +18 -0
- package/dist/utils/id-generator.js.map +7 -0
- package/dist/utils/layer-name-formatter.js +16 -0
- package/dist/utils/layer-name-formatter.js.map +7 -0
- package/dist/utils/markdown-anchor.js +7 -0
- package/dist/utils/markdown-anchor.js.map +7 -0
- package/dist/utils/markdown-link.js +12 -0
- package/dist/utils/markdown-link.js.map +7 -0
- package/dist/utils/markdown-table.js +17 -0
- package/dist/utils/markdown-table.js.map +7 -0
- package/dist/utils/mermaid-utils.js +11 -0
- package/dist/utils/mermaid-utils.js.map +7 -0
- package/dist/utils/project-paths.js.map +2 -2
- package/dist/utils/source-reference.js +52 -0
- package/dist/utils/source-reference.js.map +7 -0
- package/dist/utils/spec-installer.js +40 -53
- package/dist/utils/spec-installer.js.map +2 -2
- package/dist/utils/spec-version.js +5 -1
- package/dist/utils/spec-version.js.map +2 -2
- package/dist/utils/string-utils.js +12 -0
- package/dist/utils/string-utils.js.map +7 -0
- package/dist/utils/table-formatting.js +19 -0
- package/dist/utils/table-formatting.js.map +7 -0
- package/dist/validators/index.js +4 -0
- package/dist/validators/index.js.map +2 -2
- package/dist/validators/naming-validator.js +20 -23
- package/dist/validators/naming-validator.js.map +2 -2
- package/dist/validators/reference-validator.js +23 -38
- package/dist/validators/reference-validator.js.map +2 -2
- package/dist/validators/relationship-schema-validator.js +243 -0
- package/dist/validators/relationship-schema-validator.js.map +7 -0
- package/dist/validators/schema-validator.js +168 -68
- package/dist/validators/schema-validator.js.map +2 -2
- package/dist/validators/semantic-validator.js +36 -60
- package/dist/validators/semantic-validator.js.map +2 -2
- package/dist/validators/types.js.map +2 -2
- package/dist/validators/validation-formatter.js +159 -0
- package/dist/validators/validation-formatter.js.map +7 -0
- package/dist/validators/validator.js +24 -38
- package/dist/validators/validator.js.map +2 -2
- package/dist/viewer/README.md +139 -0
- package/dist/viewer/assets/main-CY0Xufuj.css +1 -0
- package/dist/viewer/assets/main-DtgErnwF.js +81 -0
- package/dist/viewer/assets/vendor-CxKvDp2x.js +17 -0
- package/dist/viewer/favicon.svg +11 -0
- package/dist/viewer/fonts/inter/Inter-Black.woff2 +0 -0
- package/dist/viewer/fonts/inter/Inter-Bold.woff2 +0 -0
- package/dist/viewer/fonts/inter/Inter-ExtraBold.woff2 +0 -0
- package/dist/viewer/fonts/inter/Inter-Light.woff2 +0 -0
- package/dist/viewer/fonts/inter/Inter-Medium.woff2 +0 -0
- package/dist/viewer/fonts/inter/Inter-Regular.woff2 +0 -0
- package/dist/viewer/fonts/inter/Inter-SemiBold.woff2 +0 -0
- package/dist/viewer/fonts/jetbrains-mono/JetBrainsMono-Medium.woff2 +0 -0
- package/dist/viewer/fonts/jetbrains-mono/JetBrainsMono-Regular.woff2 +0 -0
- package/dist/viewer/fonts/jetbrains-mono/JetBrainsMono-SemiBold.woff2 +0 -0
- package/dist/viewer/index.html +15 -0
- package/dist/viewer/manifest.json +99 -0
- package/dist/viewer/version.json +1 -0
- package/package.json +37 -13
- package/PYTHON_CLI_PARITY.md +0 -265
- package/PYTHON_CLI_STRUCTURE_UPDATE.md +0 -246
- package/biome.json +0 -42
- package/bunfig.toml +0 -3
- package/dist/ai/claude-client.js +0 -71
- package/dist/ai/claude-client.js.map +0 -7
- package/dist/ai/context-provider.js +0 -129
- package/dist/ai/context-provider.js.map +0 -7
- package/dist/ai/tools.js +0 -231
- package/dist/ai/tools.js.map +0 -7
- package/dist/commands/migrate.js +0 -36
- package/dist/commands/migrate.js.map +0 -7
- package/dist/commands/project.js +0 -74
- package/dist/commands/project.js.map +0 -7
- package/dist/core/active-changeset.js +0 -52
- package/dist/core/active-changeset.js.map +0 -7
- package/dist/core/projection-engine.js +0 -288
- package/dist/core/projection-engine.js.map +0 -7
- package/dist/schemas/bundled/01-motivation-layer.schema.json +0 -942
- package/dist/schemas/bundled/02-business-layer.schema.json +0 -1293
- package/dist/schemas/bundled/03-security-layer.schema.json +0 -2177
- package/dist/schemas/bundled/04-application-layer.schema.json +0 -1328
- package/dist/schemas/bundled/05-technology-layer.schema.json +0 -1465
- package/dist/schemas/bundled/06-api-layer.schema.json +0 -1743
- package/dist/schemas/bundled/07-data-model-layer.schema.json +0 -1253
- package/dist/schemas/bundled/08-datastore-layer.schema.json +0 -892
- package/dist/schemas/bundled/09-ux-layer.schema.json +0 -1506
- package/dist/schemas/bundled/10-navigation-layer.schema.json +0 -843
- package/dist/schemas/bundled/11-apm-observability-layer.schema.json +0 -1430
- package/dist/schemas/bundled/12-testing-layer.schema.json +0 -1091
- package/dist/schemas/bundled/common/layer-extensions.schema.json +0 -266
- package/dist/schemas/bundled/common/predicates.schema.json +0 -493
- package/dist/schemas/bundled/common/relationships.schema.json +0 -791
- package/dist/schemas/bundled/common/source-references.schema.json +0 -71
- package/dist/schemas/bundled/link-registry.json +0 -1839
- package/dist/schemas/bundled/link-registry.schema.json +0 -339
- package/dist/schemas/bundled/relationship-catalog.json +0 -1302
- package/dist/schemas/bundled/relationship-type.schema.json +0 -221
- package/dist/utils/model-path.js +0 -22
- package/dist/utils/model-path.js.map +0 -7
- package/docs/TEST-INSTRUMENTATION.md +0 -405
- package/docs/telemetry.md +0 -427
- package/test-debug.js +0 -33
- package/test-special.mjs +0 -46
- package/test_runner.ts +0 -7
|
@@ -0,0 +1,443 @@
|
|
|
1
|
+
import { Layer as LayerClass } from "./layer.js";
|
|
2
|
+
import { Element as ElementClass } from "./element.js";
|
|
3
|
+
import { StagedChangesetStorage } from "./staged-changeset-storage.js";
|
|
4
|
+
class VirtualProjectionEngine {
|
|
5
|
+
stagingAreaManager;
|
|
6
|
+
projectionCache;
|
|
7
|
+
/**
|
|
8
|
+
* Create a new projection engine.
|
|
9
|
+
*
|
|
10
|
+
* @param rootPath - Root path to the model (used by StagedChangesetStorage)
|
|
11
|
+
*/
|
|
12
|
+
constructor(rootPath) {
|
|
13
|
+
this.stagingAreaManager = new StagedChangesetStorage(rootPath), this.projectionCache = {
|
|
14
|
+
cache: /* @__PURE__ */ new Map(),
|
|
15
|
+
metrics: /* @__PURE__ */ new Map(),
|
|
16
|
+
maxAge: 5 * 60 * 1e3,
|
|
17
|
+
// 5-minute TTL for cached projections
|
|
18
|
+
lastCleanup: Date.now()
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Project a single element by applying staged changes to it.
|
|
23
|
+
* Merges the element's base state with staged changes to compute its projected state.
|
|
24
|
+
*
|
|
25
|
+
* @param baseModel - The base model to project from
|
|
26
|
+
* @param changesetId - ID of the changeset containing staged changes
|
|
27
|
+
* @param elementId - ID of the element to project
|
|
28
|
+
* @returns Projected element with staged changes applied, or null if element is deleted
|
|
29
|
+
* @throws Error if changeset not found
|
|
30
|
+
*
|
|
31
|
+
* @remarks
|
|
32
|
+
* If multiple changes exist for the element, the last change determines final state.
|
|
33
|
+
* For 'delete' operations, returns null.
|
|
34
|
+
* For 'add' operations without base element, creates new element from staged data.
|
|
35
|
+
* For 'update' operations, merges staged changes with base element attributes.
|
|
36
|
+
*/
|
|
37
|
+
async projectElement(baseModel, changesetId, elementId) {
|
|
38
|
+
const changeset = await this.stagingAreaManager.load(changesetId);
|
|
39
|
+
if (!changeset)
|
|
40
|
+
throw new Error(`Changeset '${changesetId}' not found`);
|
|
41
|
+
const elementChanges = changeset.changes.filter((c) => c.elementId === elementId);
|
|
42
|
+
if (elementChanges.length === 0)
|
|
43
|
+
return baseModel.getElementById(elementId) || null;
|
|
44
|
+
const lastChange = elementChanges[elementChanges.length - 1];
|
|
45
|
+
if (lastChange.type === "delete")
|
|
46
|
+
return null;
|
|
47
|
+
const baseElement = baseModel.getElementById(elementId), projectedData = lastChange.after || {};
|
|
48
|
+
if (baseElement) {
|
|
49
|
+
const projectedAttributes = typeof projectedData.attributes == "object" ? projectedData.attributes : {}, mergedData = {
|
|
50
|
+
id: baseElement.id,
|
|
51
|
+
path: baseElement.path,
|
|
52
|
+
spec_node_id: baseElement.spec_node_id,
|
|
53
|
+
type: typeof projectedData.type == "string" ? projectedData.type : baseElement.type,
|
|
54
|
+
layer_id: baseElement.layer_id,
|
|
55
|
+
name: typeof projectedData.name == "string" ? projectedData.name : baseElement.name,
|
|
56
|
+
description: typeof projectedData.description == "string" ? projectedData.description : baseElement.description,
|
|
57
|
+
attributes: {
|
|
58
|
+
...baseElement.attributes,
|
|
59
|
+
...projectedAttributes
|
|
60
|
+
},
|
|
61
|
+
references: Array.isArray(projectedData.references) ? projectedData.references : baseElement.references,
|
|
62
|
+
relationships: Array.isArray(projectedData.relationships) ? projectedData.relationships : baseElement.relationships,
|
|
63
|
+
source_reference: baseElement.source_reference,
|
|
64
|
+
metadata: baseElement.metadata
|
|
65
|
+
};
|
|
66
|
+
return new ElementClass(mergedData);
|
|
67
|
+
} else if (lastChange.type === "add")
|
|
68
|
+
return new ElementClass({
|
|
69
|
+
id: lastChange.after?.id || elementId,
|
|
70
|
+
path: lastChange.after?.path || elementId,
|
|
71
|
+
spec_node_id: lastChange.after?.spec_node_id || "",
|
|
72
|
+
type: projectedData.type || "unknown",
|
|
73
|
+
layer_id: lastChange.layerName,
|
|
74
|
+
name: projectedData.name || elementId,
|
|
75
|
+
description: projectedData.description || "",
|
|
76
|
+
attributes: typeof projectedData.attributes == "object" ? projectedData.attributes : {},
|
|
77
|
+
references: Array.isArray(projectedData.references) ? projectedData.references : [],
|
|
78
|
+
relationships: Array.isArray(projectedData.relationships) ? projectedData.relationships : [],
|
|
79
|
+
source_reference: projectedData.source_reference,
|
|
80
|
+
metadata: projectedData.metadata,
|
|
81
|
+
layer: lastChange.layerName
|
|
82
|
+
});
|
|
83
|
+
return null;
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* Project a layer by applying staged changes to a clone of the base layer.
|
|
87
|
+
* Checks cache first; computes and caches result if not found or expired.
|
|
88
|
+
*
|
|
89
|
+
* @param baseModel - The base model to project from
|
|
90
|
+
* @param changesetId - ID of the changeset containing staged changes
|
|
91
|
+
* @param layerName - Name of the layer to project
|
|
92
|
+
* @returns Projected layer with staged changes applied
|
|
93
|
+
* @throws Error if changeset or base layer not found
|
|
94
|
+
*
|
|
95
|
+
* @remarks
|
|
96
|
+
* Computation process:
|
|
97
|
+
* 1. Check projection cache (returns if found and not expired)
|
|
98
|
+
* 2. Clone base layer to avoid mutations
|
|
99
|
+
* 3. Load staged changes filtered to this layer
|
|
100
|
+
* 4. Apply changes in sequence number order (add/update/delete)
|
|
101
|
+
* 5. Cache result with timestamp for TTL tracking
|
|
102
|
+
* 6. Trigger periodic cache cleanup
|
|
103
|
+
*/
|
|
104
|
+
async projectLayer(baseModel, changesetId, layerName) {
|
|
105
|
+
const cacheKey = `${changesetId}:${layerName}`, cached = this.projectionCache.cache.get(cacheKey);
|
|
106
|
+
if (cached) {
|
|
107
|
+
if (Date.now() - new Date(cached.computedAt).getTime() < this.projectionCache.maxAge)
|
|
108
|
+
return this.recordCacheHit(changesetId), cached.layer;
|
|
109
|
+
this.projectionCache.cache.delete(cacheKey);
|
|
110
|
+
}
|
|
111
|
+
this.recordCacheMiss(changesetId);
|
|
112
|
+
const baseLayer = await baseModel.getBaseLayer(layerName), projectedLayer = baseLayer ? this.cloneLayer(baseLayer) : new LayerClass(layerName), changeset = await this.stagingAreaManager.load(changesetId);
|
|
113
|
+
if (!changeset)
|
|
114
|
+
throw new Error(`Changeset '${changesetId}' not found`);
|
|
115
|
+
const layerChanges = changeset.changes.filter((c) => c.layerName === layerName).sort((a, b) => a.sequenceNumber - b.sequenceNumber);
|
|
116
|
+
for (const change of layerChanges)
|
|
117
|
+
switch (change.type) {
|
|
118
|
+
case "add":
|
|
119
|
+
if (change.after) {
|
|
120
|
+
const newElement = new ElementClass({
|
|
121
|
+
id: change.after.id || change.elementId,
|
|
122
|
+
path: change.after.path || change.elementId,
|
|
123
|
+
spec_node_id: change.after.spec_node_id || "",
|
|
124
|
+
type: change.after.type || "unknown",
|
|
125
|
+
layer_id: layerName,
|
|
126
|
+
name: change.after.name || change.elementId,
|
|
127
|
+
description: change.after.description || "",
|
|
128
|
+
attributes: typeof change.after.attributes == "object" ? change.after.attributes : {},
|
|
129
|
+
references: Array.isArray(change.after.references) ? change.after.references : [],
|
|
130
|
+
relationships: Array.isArray(change.after.relationships) ? change.after.relationships : [],
|
|
131
|
+
source_reference: change.after.source_reference,
|
|
132
|
+
metadata: change.after.metadata,
|
|
133
|
+
layer: layerName
|
|
134
|
+
});
|
|
135
|
+
projectedLayer.addElement(newElement);
|
|
136
|
+
}
|
|
137
|
+
break;
|
|
138
|
+
case "update":
|
|
139
|
+
if (change.after) {
|
|
140
|
+
const existing = projectedLayer.getElement(change.elementId);
|
|
141
|
+
if (existing) {
|
|
142
|
+
const afterAttributes = typeof change.after.attributes == "object" ? change.after.attributes : {}, mergedAttributes = {
|
|
143
|
+
...existing.attributes,
|
|
144
|
+
...afterAttributes
|
|
145
|
+
}, updatedElement = new ElementClass({
|
|
146
|
+
id: existing.id,
|
|
147
|
+
path: existing.path,
|
|
148
|
+
spec_node_id: existing.spec_node_id,
|
|
149
|
+
layer_id: existing.layer_id,
|
|
150
|
+
type: typeof change.after.type == "string" ? change.after.type : existing.type,
|
|
151
|
+
name: typeof change.after.name == "string" ? change.after.name : existing.name,
|
|
152
|
+
description: typeof change.after.description == "string" ? change.after.description : existing.description,
|
|
153
|
+
attributes: mergedAttributes,
|
|
154
|
+
references: Array.isArray(change.after.references) ? change.after.references : existing.references,
|
|
155
|
+
relationships: Array.isArray(change.after.relationships) ? change.after.relationships : existing.relationships,
|
|
156
|
+
layer: layerName,
|
|
157
|
+
source_reference: existing.source_reference,
|
|
158
|
+
metadata: existing.metadata
|
|
159
|
+
});
|
|
160
|
+
projectedLayer.updateElement(updatedElement);
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
break;
|
|
164
|
+
case "delete":
|
|
165
|
+
const existingForDelete = projectedLayer.getElement(change.elementId);
|
|
166
|
+
existingForDelete && projectedLayer.deleteElement(existingForDelete.path || existingForDelete.id);
|
|
167
|
+
break;
|
|
168
|
+
case "relationship-add":
|
|
169
|
+
case "relationship-delete":
|
|
170
|
+
break;
|
|
171
|
+
}
|
|
172
|
+
const cacheEntry = {
|
|
173
|
+
layer: projectedLayer,
|
|
174
|
+
computedAt: (/* @__PURE__ */ new Date()).toISOString()
|
|
175
|
+
};
|
|
176
|
+
return this.projectionCache.cache.set(cacheKey, cacheEntry), this.cleanupExpiredCache(), projectedLayer;
|
|
177
|
+
}
|
|
178
|
+
/**
|
|
179
|
+
* Project entire model by applying staged changes to all layers.
|
|
180
|
+
* Creates a complete projected model view that includes both changed and unchanged layers.
|
|
181
|
+
*
|
|
182
|
+
* @param baseModel - The base model to project from
|
|
183
|
+
* @param changesetId - ID of the changeset containing staged changes
|
|
184
|
+
* @returns ProjectedModel with isProjection=true flag (prevents accidental saves)
|
|
185
|
+
* @throws Error if changeset not found
|
|
186
|
+
*
|
|
187
|
+
* @remarks
|
|
188
|
+
* Projection includes:
|
|
189
|
+
* - All layers mentioned in changeset changes
|
|
190
|
+
* - All layers from base model (to have complete model state)
|
|
191
|
+
* - Base model's manifest (unchanged)
|
|
192
|
+
* Returned model has isProjection=true to prevent accidental persistence.
|
|
193
|
+
*/
|
|
194
|
+
async projectModel(baseModel, changesetId) {
|
|
195
|
+
const changeset = await this.stagingAreaManager.load(changesetId);
|
|
196
|
+
if (!changeset)
|
|
197
|
+
throw new Error(`Changeset '${changesetId}' not found`);
|
|
198
|
+
const projectedLayers = /* @__PURE__ */ new Map(), layerNames = /* @__PURE__ */ new Set();
|
|
199
|
+
for (const change of changeset.changes)
|
|
200
|
+
layerNames.add(change.layerName);
|
|
201
|
+
for (const baseLayerName of baseModel.getLayerNames())
|
|
202
|
+
layerNames.add(baseLayerName);
|
|
203
|
+
for (const layerName of layerNames) {
|
|
204
|
+
const projectedLayer = await this.projectLayer(baseModel, changesetId, layerName);
|
|
205
|
+
projectedLayers.set(layerName, projectedLayer);
|
|
206
|
+
}
|
|
207
|
+
return {
|
|
208
|
+
manifest: baseModel.manifest,
|
|
209
|
+
layers: projectedLayers,
|
|
210
|
+
relationships: baseModel.relationships,
|
|
211
|
+
isProjection: !0
|
|
212
|
+
};
|
|
213
|
+
}
|
|
214
|
+
/**
|
|
215
|
+
* Compute diff by categorizing changeset changes by type.
|
|
216
|
+
* Extracts the staged changes and organizes them into additions, modifications, and deletions.
|
|
217
|
+
*
|
|
218
|
+
* @param _baseModel - The base model (unused; included for interface compatibility)
|
|
219
|
+
* @param changesetId - ID of the changeset to compute diff for
|
|
220
|
+
* @returns ModelDiff with changes categorized by type
|
|
221
|
+
* @throws Error if changeset not found
|
|
222
|
+
*
|
|
223
|
+
* @remarks
|
|
224
|
+
* Diff is computed directly from changeset changes; does not perform deep comparison.
|
|
225
|
+
* Each change's before/after snapshots are included for detailed display.
|
|
226
|
+
*/
|
|
227
|
+
async computeDiff(_baseModel, changesetId) {
|
|
228
|
+
const changeset = await this.stagingAreaManager.load(changesetId);
|
|
229
|
+
if (!changeset)
|
|
230
|
+
throw new Error(`Changeset '${changesetId}' not found`);
|
|
231
|
+
const changes = changeset.changes;
|
|
232
|
+
return {
|
|
233
|
+
additions: changes.filter((c) => c.type === "add").map((c) => ({
|
|
234
|
+
elementId: c.elementId,
|
|
235
|
+
layerName: c.layerName,
|
|
236
|
+
data: c.after || {}
|
|
237
|
+
})),
|
|
238
|
+
modifications: changes.filter((c) => c.type === "update").map((c) => ({
|
|
239
|
+
elementId: c.elementId,
|
|
240
|
+
layerName: c.layerName,
|
|
241
|
+
before: c.before || {},
|
|
242
|
+
after: c.after || {}
|
|
243
|
+
})),
|
|
244
|
+
deletions: changes.filter((c) => c.type === "delete").map((c) => ({
|
|
245
|
+
elementId: c.elementId,
|
|
246
|
+
layerName: c.layerName,
|
|
247
|
+
data: c.before || {}
|
|
248
|
+
}))
|
|
249
|
+
};
|
|
250
|
+
}
|
|
251
|
+
/**
|
|
252
|
+
* Get affected layers for an element in a changeset.
|
|
253
|
+
* Returns all layers that have cached projections and contain changes for the element.
|
|
254
|
+
*
|
|
255
|
+
* @param changesetId - ID of the changeset
|
|
256
|
+
* @param elementId - ID of the element being unstaged
|
|
257
|
+
* @returns Set of affected layer names
|
|
258
|
+
*
|
|
259
|
+
* @remarks
|
|
260
|
+
* When unstaging an element, only the layers where that element was modified
|
|
261
|
+
* need cache invalidation. This enables granular invalidation instead of
|
|
262
|
+
* invalidating the entire changeset cache.
|
|
263
|
+
*/
|
|
264
|
+
async getAffectedLayers(changesetId, elementId) {
|
|
265
|
+
const affectedLayers = /* @__PURE__ */ new Set();
|
|
266
|
+
try {
|
|
267
|
+
const changeset = await this.stagingAreaManager.load(changesetId);
|
|
268
|
+
if (!changeset)
|
|
269
|
+
return affectedLayers;
|
|
270
|
+
for (const change of changeset.changes)
|
|
271
|
+
change.elementId === elementId && affectedLayers.add(change.layerName);
|
|
272
|
+
} catch {
|
|
273
|
+
}
|
|
274
|
+
return affectedLayers;
|
|
275
|
+
}
|
|
276
|
+
/**
|
|
277
|
+
* Record a cache hit for metrics tracking.
|
|
278
|
+
*
|
|
279
|
+
* @param changesetId - ID of the changeset
|
|
280
|
+
*/
|
|
281
|
+
recordCacheHit(changesetId) {
|
|
282
|
+
const metrics = this.projectionCache.metrics.get(changesetId) || {
|
|
283
|
+
hits: 0,
|
|
284
|
+
misses: 0,
|
|
285
|
+
invalidations: 0
|
|
286
|
+
};
|
|
287
|
+
metrics.hits++, this.projectionCache.metrics.set(changesetId, metrics);
|
|
288
|
+
}
|
|
289
|
+
/**
|
|
290
|
+
* Record a cache miss for metrics tracking.
|
|
291
|
+
*
|
|
292
|
+
* @param changesetId - ID of the changeset
|
|
293
|
+
*/
|
|
294
|
+
recordCacheMiss(changesetId) {
|
|
295
|
+
const metrics = this.projectionCache.metrics.get(changesetId) || {
|
|
296
|
+
hits: 0,
|
|
297
|
+
misses: 0,
|
|
298
|
+
invalidations: 0
|
|
299
|
+
};
|
|
300
|
+
metrics.misses++, this.projectionCache.metrics.set(changesetId, metrics);
|
|
301
|
+
}
|
|
302
|
+
/**
|
|
303
|
+
* Record a cache invalidation for metrics tracking.
|
|
304
|
+
*
|
|
305
|
+
* @param changesetId - ID of the changeset
|
|
306
|
+
*/
|
|
307
|
+
recordInvalidation(changesetId) {
|
|
308
|
+
const metrics = this.projectionCache.metrics.get(changesetId) || {
|
|
309
|
+
hits: 0,
|
|
310
|
+
misses: 0,
|
|
311
|
+
invalidations: 0
|
|
312
|
+
};
|
|
313
|
+
metrics.invalidations++, metrics.lastInvalidation = (/* @__PURE__ */ new Date()).toISOString(), this.projectionCache.metrics.set(changesetId, metrics);
|
|
314
|
+
}
|
|
315
|
+
/**
|
|
316
|
+
* Get cache metrics for a changeset (for monitoring and debugging).
|
|
317
|
+
*
|
|
318
|
+
* @param changesetId - ID of the changeset
|
|
319
|
+
* @returns Cache metrics or undefined if no metrics exist
|
|
320
|
+
*/
|
|
321
|
+
getCacheMetrics(changesetId) {
|
|
322
|
+
return this.projectionCache.metrics.get(changesetId);
|
|
323
|
+
}
|
|
324
|
+
/**
|
|
325
|
+
* Invalidate projection cache when changes are staged.
|
|
326
|
+
* Removes cached projections to ensure fresh computation next time.
|
|
327
|
+
*
|
|
328
|
+
* @param changesetId - ID of the changeset being modified
|
|
329
|
+
* @param layerName - Optional: specific layer to invalidate (all if omitted)
|
|
330
|
+
*
|
|
331
|
+
* @remarks
|
|
332
|
+
* If layerName is provided, only that layer's projection is invalidated.
|
|
333
|
+
* Otherwise, all projections for the changeset are invalidated.
|
|
334
|
+
*/
|
|
335
|
+
invalidateOnStage(changesetId, layerName) {
|
|
336
|
+
if (layerName) {
|
|
337
|
+
const cacheKey = `${changesetId}:${layerName}`;
|
|
338
|
+
this.projectionCache.cache.delete(cacheKey), this.recordInvalidation(changesetId);
|
|
339
|
+
} else {
|
|
340
|
+
for (const key of this.projectionCache.cache.keys())
|
|
341
|
+
key.startsWith(`${changesetId}:`) && this.projectionCache.cache.delete(key);
|
|
342
|
+
this.recordInvalidation(changesetId);
|
|
343
|
+
}
|
|
344
|
+
}
|
|
345
|
+
/**
|
|
346
|
+
* Invalidate projection cache when changes are unstaged.
|
|
347
|
+
* Uses layer-specific invalidation for the affected element's layers.
|
|
348
|
+
*
|
|
349
|
+
* @param changesetId - ID of the changeset being modified
|
|
350
|
+
* @param elementId - Optional: ID of element being unstaged (enables granular invalidation)
|
|
351
|
+
*
|
|
352
|
+
* @remarks
|
|
353
|
+
* If elementId is provided, only the layers containing that element are invalidated.
|
|
354
|
+
* This is more efficient than invalidating the entire changeset cache when
|
|
355
|
+
* unstaging elements from a multi-layer changeset.
|
|
356
|
+
* If elementId is omitted, invalidates all projections for the changeset.
|
|
357
|
+
*/
|
|
358
|
+
async invalidateOnUnstage(changesetId, elementId) {
|
|
359
|
+
if (elementId) {
|
|
360
|
+
const affectedLayers = await this.getAffectedLayers(changesetId, elementId);
|
|
361
|
+
for (const layerName of affectedLayers) {
|
|
362
|
+
const cacheKey = `${changesetId}:${layerName}`;
|
|
363
|
+
this.projectionCache.cache.delete(cacheKey);
|
|
364
|
+
}
|
|
365
|
+
affectedLayers.size > 0 && this.recordInvalidation(changesetId);
|
|
366
|
+
} else {
|
|
367
|
+
for (const key of this.projectionCache.cache.keys())
|
|
368
|
+
key.startsWith(`${changesetId}:`) && this.projectionCache.cache.delete(key);
|
|
369
|
+
this.recordInvalidation(changesetId);
|
|
370
|
+
}
|
|
371
|
+
}
|
|
372
|
+
/**
|
|
373
|
+
* Invalidate all projections for a changeset when it's discarded.
|
|
374
|
+
* Clears all cached projections for this changeset to free memory.
|
|
375
|
+
*
|
|
376
|
+
* @param changesetId - ID of the changeset being discarded
|
|
377
|
+
*/
|
|
378
|
+
invalidateOnDiscard(changesetId) {
|
|
379
|
+
for (const key of this.projectionCache.cache.keys())
|
|
380
|
+
key.startsWith(`${changesetId}:`) && this.projectionCache.cache.delete(key);
|
|
381
|
+
}
|
|
382
|
+
/**
|
|
383
|
+
* Clone a layer to create an independent copy.
|
|
384
|
+
* Shallow clones all elements and metadata to avoid mutations.
|
|
385
|
+
* Cloned layer is marked clean to prevent unintended saves.
|
|
386
|
+
*
|
|
387
|
+
* @param layer - The layer to clone
|
|
388
|
+
* @returns New layer with cloned elements and metadata
|
|
389
|
+
*
|
|
390
|
+
* @remarks
|
|
391
|
+
* Cloning strategy:
|
|
392
|
+
* 1. Create new Layer with same name
|
|
393
|
+
* 2. Clone each element: shallow copy attributes object and array references
|
|
394
|
+
* 3. Copy layer metadata if present
|
|
395
|
+
* 4. Mark cloned layer as clean to prevent automatic saves
|
|
396
|
+
* This ensures changes to projection don't affect base layer.
|
|
397
|
+
* Note: Shallow cloning is sufficient since attributes are read-only in projections.
|
|
398
|
+
*/
|
|
399
|
+
cloneLayer(layer) {
|
|
400
|
+
const cloned = new LayerClass(layer.name);
|
|
401
|
+
for (const element of layer.listElements()) {
|
|
402
|
+
const elementClone = new ElementClass({
|
|
403
|
+
id: element.id,
|
|
404
|
+
path: element.path,
|
|
405
|
+
spec_node_id: element.spec_node_id,
|
|
406
|
+
type: element.type,
|
|
407
|
+
layer_id: element.layer_id,
|
|
408
|
+
name: element.name,
|
|
409
|
+
description: element.description,
|
|
410
|
+
attributes: { ...element.attributes },
|
|
411
|
+
references: [...element.references || []],
|
|
412
|
+
relationships: [...element.relationships || []],
|
|
413
|
+
layer: element.layer,
|
|
414
|
+
source_reference: element.source_reference,
|
|
415
|
+
metadata: element.metadata
|
|
416
|
+
});
|
|
417
|
+
cloned.addElement(elementClone);
|
|
418
|
+
}
|
|
419
|
+
return layer.metadata && (cloned.metadata = { ...layer.metadata }), cloned.markClean(), cloned;
|
|
420
|
+
}
|
|
421
|
+
/**
|
|
422
|
+
* Clean up expired cache entries periodically (every 60 seconds).
|
|
423
|
+
* Removes entries that exceed the maxAge TTL.
|
|
424
|
+
* Runs at most once per minute to limit overhead.
|
|
425
|
+
*
|
|
426
|
+
* @remarks
|
|
427
|
+
* Cleanup is triggered after each projection computation.
|
|
428
|
+
* Early exit if last cleanup was less than 60 seconds ago.
|
|
429
|
+
* Entries are marked for deletion based on age calculation from computedAt timestamp.
|
|
430
|
+
*/
|
|
431
|
+
cleanupExpiredCache() {
|
|
432
|
+
const now = Date.now();
|
|
433
|
+
if (!(now - this.projectionCache.lastCleanup < 60 * 1e3)) {
|
|
434
|
+
for (const [key, entry] of this.projectionCache.cache.entries())
|
|
435
|
+
now - new Date(entry.computedAt).getTime() >= this.projectionCache.maxAge && this.projectionCache.cache.delete(key);
|
|
436
|
+
this.projectionCache.lastCleanup = now;
|
|
437
|
+
}
|
|
438
|
+
}
|
|
439
|
+
}
|
|
440
|
+
export {
|
|
441
|
+
VirtualProjectionEngine
|
|
442
|
+
};
|
|
443
|
+
//# sourceMappingURL=virtual-projection.js.map
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../../src/core/virtual-projection.ts"],
|
|
4
|
+
"sourcesContent": ["/**\n * VirtualProjectionEngine - Computes merged model views by applying staged changes.\n *\n * Creates virtual (temporary) projections of the base model with staged changes applied,\n * without modifying or persisting the base model. Enables safe preview and validation\n * of changes before commit. Includes projection caching with TTL-based expiration.\n *\n * Staging changes are applied in sequence order to compute accurate merged views.\n */\n\nimport type { Model } from \"./model.js\";\nimport type { Layer } from \"./layer.js\";\nimport type { Element } from \"./element.js\";\nimport type { SourceReference, ElementMetadata } from \"../types/index.js\";\nimport type { Manifest } from \"./manifest.js\";\nimport type { Relationships } from \"./relationships.js\";\nimport { Layer as LayerClass } from \"./layer.js\";\nimport { Element as ElementClass } from \"./element.js\";\nimport type { StagedChange, Change } from \"./changeset.js\";\nimport { StagedChangesetStorage } from \"./staged-changeset-storage.js\";\n\n/**\n * Projected model with isProjection flag to prevent accidental saves.\n * This marker interface ensures that projected models are recognized as temporary\n * and cannot be persisted to disk without explicit commit of the underlying changeset.\n */\nexport interface ProjectedModel {\n manifest: Manifest;\n layers: Map<string, Layer>;\n relationships: Relationships;\n isProjection: true; // Always true; marks this as a temporary virtual projection\n}\n\n/**\n * Model diff categorizing changeset changes by type.\n * Separates staged changes into additions (new elements), modifications (updated attributes),\n * and deletions (removed elements). Used for preview and diff display operations.\n */\nexport interface ModelDiff {\n additions: Array<{\n elementId: string;\n layerName: string;\n data: Record<string, unknown>; // Complete element state (from change.after)\n }>;\n modifications: Array<{\n elementId: string;\n layerName: string;\n before: Record<string, unknown>; // Previous state (from change.before)\n after: Record<string, unknown>; // New state (from change.after)\n }>;\n deletions: Array<{\n elementId: string;\n layerName: string;\n data: Record<string, unknown>; // Element state before deletion (from change.before)\n }>;\n}\n\n/**\n * Single cached layer projection.\n * Stores the computed projected layer and timestamp for cache expiration.\n */\ninterface CacheEntry {\n layer: Layer;\n computedAt: string; // ISO timestamp for age calculation\n}\n\n/**\n * Cache hit/miss metrics for monitoring cache performance.\n * Tracks successful cache hits, misses, and invalidations per changeset.\n */\ninterface CacheMetrics {\n hits: number; // Number of successful cache hits\n misses: number; // Number of cache misses (required computation)\n invalidations: number; // Number of invalidation operations\n lastInvalidation?: string; // ISO timestamp of last invalidation\n}\n\n/**\n * Projection cache for storing computed layer projections.\n * Uses TTL-based expiration to prevent stale projections.\n * Entries are lazily removed when expired on access or during periodic cleanup.\n */\ninterface ProjectionCache {\n cache: Map<string, CacheEntry>; // Key format: `${changesetId}:${layerName}`\n metrics: Map<string, CacheMetrics>; // Cache metrics keyed by changesetId\n maxAge: number; // Cache entry TTL in milliseconds (5 minutes default)\n lastCleanup: number; // Timestamp of last cleanup to limit cleanup frequency\n}\n\n/**\n * VirtualProjectionEngine - Computes merged model views without persisting.\n * Applies staged changes to a cloned base model to compute projections.\n * Uses caching with TTL-based expiration to optimize repeated projections.\n */\nexport class VirtualProjectionEngine {\n private stagingAreaManager: StagedChangesetStorage;\n private projectionCache: ProjectionCache;\n\n /**\n * Create a new projection engine.\n *\n * @param rootPath - Root path to the model (used by StagedChangesetStorage)\n */\n constructor(rootPath: string) {\n this.stagingAreaManager = new StagedChangesetStorage(rootPath);\n this.projectionCache = {\n cache: new Map(),\n metrics: new Map(),\n maxAge: 5 * 60 * 1000, // 5-minute TTL for cached projections\n lastCleanup: Date.now(),\n };\n }\n\n /**\n * Project a single element by applying staged changes to it.\n * Merges the element's base state with staged changes to compute its projected state.\n *\n * @param baseModel - The base model to project from\n * @param changesetId - ID of the changeset containing staged changes\n * @param elementId - ID of the element to project\n * @returns Projected element with staged changes applied, or null if element is deleted\n * @throws Error if changeset not found\n *\n * @remarks\n * If multiple changes exist for the element, the last change determines final state.\n * For 'delete' operations, returns null.\n * For 'add' operations without base element, creates new element from staged data.\n * For 'update' operations, merges staged changes with base element attributes.\n */\n async projectElement(\n baseModel: Model,\n changesetId: string,\n elementId: string\n ): Promise<Element | null> {\n const changeset = await this.stagingAreaManager.load(changesetId);\n if (!changeset) {\n throw new Error(`Changeset '${changesetId}' not found`);\n }\n\n // Find all changes for this element across all layers\n const elementChanges = changeset.changes.filter(\n (c: Change) => c.elementId === elementId\n ) as StagedChange[];\n\n if (elementChanges.length === 0) {\n // No changes, return base element if it exists\n return baseModel.getElementById(elementId) || null;\n }\n\n // Get the last change to determine the element's final state\n const lastChange = elementChanges[elementChanges.length - 1];\n\n if (lastChange.type === \"delete\") {\n return null;\n }\n\n // For add or update, construct the projected element\n const baseElement = baseModel.getElementById(elementId);\n const projectedData = lastChange.after || {};\n\n if (baseElement) {\n // Create a new element with projected data merged with base\n const projectedAttributes =\n typeof projectedData.attributes === \"object\" ? projectedData.attributes : {};\n\n const mergedData = {\n id: baseElement.id,\n path: baseElement.path,\n spec_node_id: baseElement.spec_node_id,\n type: typeof projectedData.type === \"string\" ? projectedData.type : baseElement.type,\n layer_id: baseElement.layer_id,\n name: typeof projectedData.name === \"string\" ? projectedData.name : baseElement.name,\n description:\n typeof projectedData.description === \"string\"\n ? projectedData.description\n : baseElement.description,\n attributes: {\n ...baseElement.attributes,\n ...projectedAttributes,\n },\n references: Array.isArray(projectedData.references)\n ? projectedData.references\n : baseElement.references,\n relationships: Array.isArray(projectedData.relationships)\n ? projectedData.relationships\n : baseElement.relationships,\n source_reference: baseElement.source_reference,\n metadata: baseElement.metadata,\n };\n\n return new ElementClass(mergedData);\n } else if (lastChange.type === \"add\") {\n // New element being added\n return new ElementClass({\n id: (lastChange.after?.id as string) || elementId,\n path: (lastChange.after?.path as string) || elementId,\n spec_node_id: (lastChange.after?.spec_node_id as string) || \"\",\n type: (projectedData.type as string) || \"unknown\",\n layer_id: lastChange.layerName,\n name: (projectedData.name as string) || elementId,\n description: (projectedData.description as string) || \"\",\n attributes: (typeof projectedData.attributes === \"object\"\n ? projectedData.attributes\n : {}) as Record<string, unknown>,\n references: Array.isArray(projectedData.references) ? projectedData.references : [],\n relationships: Array.isArray(projectedData.relationships)\n ? projectedData.relationships\n : [],\n source_reference: projectedData.source_reference as SourceReference | undefined,\n metadata: projectedData.metadata as ElementMetadata | undefined,\n layer: lastChange.layerName,\n });\n }\n\n return null;\n }\n\n /**\n * Project a layer by applying staged changes to a clone of the base layer.\n * Checks cache first; computes and caches result if not found or expired.\n *\n * @param baseModel - The base model to project from\n * @param changesetId - ID of the changeset containing staged changes\n * @param layerName - Name of the layer to project\n * @returns Projected layer with staged changes applied\n * @throws Error if changeset or base layer not found\n *\n * @remarks\n * Computation process:\n * 1. Check projection cache (returns if found and not expired)\n * 2. Clone base layer to avoid mutations\n * 3. Load staged changes filtered to this layer\n * 4. Apply changes in sequence number order (add/update/delete)\n * 5. Cache result with timestamp for TTL tracking\n * 6. Trigger periodic cache cleanup\n */\n async projectLayer(baseModel: Model, changesetId: string, layerName: string): Promise<Layer> {\n // Check cache first\n const cacheKey = `${changesetId}:${layerName}`;\n const cached = this.projectionCache.cache.get(cacheKey);\n\n if (cached) {\n const age = Date.now() - new Date(cached.computedAt).getTime();\n if (age < this.projectionCache.maxAge) {\n // Record cache hit\n this.recordCacheHit(changesetId);\n return cached.layer;\n } else {\n // Invalidate expired entry\n this.projectionCache.cache.delete(cacheKey);\n }\n }\n\n // Record cache miss\n this.recordCacheMiss(changesetId);\n\n // Load the committed base layer \u2014 must use getBaseLayer() (not getLayer()) to avoid\n // infinite recursion: getLayer() calls projectLayer(), which would call getLayer() again.\n const baseLayer = await baseModel.getBaseLayer(layerName);\n const projectedLayer = baseLayer\n ? this.cloneLayer(baseLayer)\n : new LayerClass(layerName);\n\n // Load staged changes for this layer\n const changeset = await this.stagingAreaManager.load(changesetId);\n if (!changeset) {\n throw new Error(`Changeset '${changesetId}' not found`);\n }\n\n const layerChanges = (changeset.changes as StagedChange[])\n .filter((c: StagedChange) => c.layerName === layerName)\n .sort((a: StagedChange, b: StagedChange) => a.sequenceNumber - b.sequenceNumber);\n\n // Apply changes in sequence order\n for (const change of layerChanges) {\n switch (change.type) {\n case \"add\":\n if (change.after) {\n const newElement = new ElementClass({\n id: (change.after.id as string) || change.elementId,\n path: (change.after.path as string) || change.elementId,\n spec_node_id: (change.after.spec_node_id as string) || \"\",\n type: (change.after.type as string) || \"unknown\",\n layer_id: layerName,\n name: (change.after.name as string) || change.elementId,\n description: (change.after.description as string) || \"\",\n attributes: (typeof change.after.attributes === \"object\"\n ? change.after.attributes\n : {}) as Record<string, unknown>,\n references: Array.isArray(change.after.references) ? change.after.references : [],\n relationships: Array.isArray(change.after.relationships)\n ? change.after.relationships\n : [],\n source_reference: change.after.source_reference as SourceReference | undefined,\n metadata: change.after.metadata as ElementMetadata | undefined,\n layer: layerName,\n });\n projectedLayer.addElement(newElement);\n }\n break;\n\n case \"update\":\n if (change.after) {\n // Get the existing element to preserve all state\n const existing = projectedLayer.getElement(change.elementId);\n if (existing) {\n // Create updated element with merged attributes\n const afterAttributes =\n typeof change.after.attributes === \"object\" ? change.after.attributes : {};\n\n const mergedAttributes: Record<string, unknown> = {\n ...existing.attributes,\n ...afterAttributes,\n };\n\n const updatedElement = new ElementClass({\n id: existing.id,\n path: existing.path,\n spec_node_id: existing.spec_node_id,\n layer_id: existing.layer_id,\n type: typeof change.after.type === \"string\" ? change.after.type : existing.type,\n name: typeof change.after.name === \"string\" ? change.after.name : existing.name,\n description:\n typeof change.after.description === \"string\"\n ? change.after.description\n : existing.description,\n attributes: mergedAttributes,\n references: Array.isArray(change.after.references)\n ? change.after.references\n : existing.references,\n relationships: Array.isArray(change.after.relationships)\n ? change.after.relationships\n : existing.relationships,\n layer: layerName,\n source_reference: existing.source_reference,\n metadata: existing.metadata,\n });\n\n projectedLayer.updateElement(updatedElement);\n }\n }\n break;\n\n case \"delete\":\n const existingForDelete = projectedLayer.getElement(change.elementId);\n if (existingForDelete) {\n projectedLayer.deleteElement(existingForDelete.path || existingForDelete.id);\n }\n break;\n\n case \"relationship-add\":\n case \"relationship-delete\":\n // Relationship changes are handled at the model level (model.relationships),\n // not the layer level. Skip here; no layer mutation needed.\n break;\n }\n }\n\n // Cache the result\n const cacheEntry: CacheEntry = {\n layer: projectedLayer,\n computedAt: new Date().toISOString(),\n };\n this.projectionCache.cache.set(cacheKey, cacheEntry);\n\n // Periodic cleanup of expired entries\n this.cleanupExpiredCache();\n\n return projectedLayer;\n }\n\n /**\n * Project entire model by applying staged changes to all layers.\n * Creates a complete projected model view that includes both changed and unchanged layers.\n *\n * @param baseModel - The base model to project from\n * @param changesetId - ID of the changeset containing staged changes\n * @returns ProjectedModel with isProjection=true flag (prevents accidental saves)\n * @throws Error if changeset not found\n *\n * @remarks\n * Projection includes:\n * - All layers mentioned in changeset changes\n * - All layers from base model (to have complete model state)\n * - Base model's manifest (unchanged)\n * Returned model has isProjection=true to prevent accidental persistence.\n */\n async projectModel(baseModel: Model, changesetId: string): Promise<ProjectedModel> {\n const changeset = await this.stagingAreaManager.load(changesetId);\n if (!changeset) {\n throw new Error(`Changeset '${changesetId}' not found`);\n }\n\n const projectedLayers = new Map<string, Layer>();\n\n // Project all layers mentioned in the changeset\n const layerNames = new Set<string>();\n for (const change of changeset.changes) {\n layerNames.add(change.layerName);\n }\n\n // Also include all base layers to get complete model\n for (const baseLayerName of baseModel.getLayerNames()) {\n layerNames.add(baseLayerName);\n }\n\n // Project each layer\n for (const layerName of layerNames) {\n const projectedLayer = await this.projectLayer(baseModel, changesetId, layerName);\n projectedLayers.set(layerName, projectedLayer);\n }\n\n // Create projected model with isProjection flag\n const projectedModel: ProjectedModel = {\n manifest: baseModel.manifest,\n layers: projectedLayers,\n relationships: baseModel.relationships,\n isProjection: true,\n };\n\n return projectedModel;\n }\n\n /**\n * Compute diff by categorizing changeset changes by type.\n * Extracts the staged changes and organizes them into additions, modifications, and deletions.\n *\n * @param _baseModel - The base model (unused; included for interface compatibility)\n * @param changesetId - ID of the changeset to compute diff for\n * @returns ModelDiff with changes categorized by type\n * @throws Error if changeset not found\n *\n * @remarks\n * Diff is computed directly from changeset changes; does not perform deep comparison.\n * Each change's before/after snapshots are included for detailed display.\n */\n async computeDiff(_baseModel: Model, changesetId: string): Promise<ModelDiff> {\n const changeset = await this.stagingAreaManager.load(changesetId);\n if (!changeset) {\n throw new Error(`Changeset '${changesetId}' not found`);\n }\n\n const changes = changeset.changes as StagedChange[];\n\n return {\n additions: changes\n .filter((c: StagedChange) => c.type === \"add\")\n .map((c: StagedChange) => ({\n elementId: c.elementId,\n layerName: c.layerName,\n data: c.after || {},\n })),\n\n modifications: changes\n .filter((c: StagedChange) => c.type === \"update\")\n .map((c: StagedChange) => ({\n elementId: c.elementId,\n layerName: c.layerName,\n before: c.before || {},\n after: c.after || {},\n })),\n\n deletions: changes\n .filter((c: StagedChange) => c.type === \"delete\")\n .map((c: StagedChange) => ({\n elementId: c.elementId,\n layerName: c.layerName,\n data: c.before || {},\n })),\n };\n }\n\n /**\n * Get affected layers for an element in a changeset.\n * Returns all layers that have cached projections and contain changes for the element.\n *\n * @param changesetId - ID of the changeset\n * @param elementId - ID of the element being unstaged\n * @returns Set of affected layer names\n *\n * @remarks\n * When unstaging an element, only the layers where that element was modified\n * need cache invalidation. This enables granular invalidation instead of\n * invalidating the entire changeset cache.\n */\n private async getAffectedLayers(changesetId: string, elementId: string): Promise<Set<string>> {\n const affectedLayers = new Set<string>();\n\n try {\n const changeset = await this.stagingAreaManager.load(changesetId);\n if (!changeset) {\n return affectedLayers;\n }\n\n // Find all layers that have changes for this element\n for (const change of changeset.changes) {\n if (change.elementId === elementId) {\n affectedLayers.add(change.layerName);\n }\n }\n } catch {\n // If changeset can't be loaded, return empty set (no invalidation needed)\n // This handles the case where changeset is deleted or corrupted\n }\n\n return affectedLayers;\n }\n\n /**\n * Record a cache hit for metrics tracking.\n *\n * @param changesetId - ID of the changeset\n */\n private recordCacheHit(changesetId: string): void {\n const metrics = this.projectionCache.metrics.get(changesetId) || {\n hits: 0,\n misses: 0,\n invalidations: 0,\n };\n metrics.hits++;\n this.projectionCache.metrics.set(changesetId, metrics);\n }\n\n /**\n * Record a cache miss for metrics tracking.\n *\n * @param changesetId - ID of the changeset\n */\n private recordCacheMiss(changesetId: string): void {\n const metrics = this.projectionCache.metrics.get(changesetId) || {\n hits: 0,\n misses: 0,\n invalidations: 0,\n };\n metrics.misses++;\n this.projectionCache.metrics.set(changesetId, metrics);\n }\n\n /**\n * Record a cache invalidation for metrics tracking.\n *\n * @param changesetId - ID of the changeset\n */\n private recordInvalidation(changesetId: string): void {\n const metrics = this.projectionCache.metrics.get(changesetId) || {\n hits: 0,\n misses: 0,\n invalidations: 0,\n };\n metrics.invalidations++;\n metrics.lastInvalidation = new Date().toISOString();\n this.projectionCache.metrics.set(changesetId, metrics);\n }\n\n /**\n * Get cache metrics for a changeset (for monitoring and debugging).\n *\n * @param changesetId - ID of the changeset\n * @returns Cache metrics or undefined if no metrics exist\n */\n getCacheMetrics(changesetId: string): CacheMetrics | undefined {\n return this.projectionCache.metrics.get(changesetId);\n }\n\n /**\n * Invalidate projection cache when changes are staged.\n * Removes cached projections to ensure fresh computation next time.\n *\n * @param changesetId - ID of the changeset being modified\n * @param layerName - Optional: specific layer to invalidate (all if omitted)\n *\n * @remarks\n * If layerName is provided, only that layer's projection is invalidated.\n * Otherwise, all projections for the changeset are invalidated.\n */\n invalidateOnStage(changesetId: string, layerName?: string): void {\n if (layerName) {\n // Invalidate specific layer projection\n const cacheKey = `${changesetId}:${layerName}`;\n this.projectionCache.cache.delete(cacheKey);\n this.recordInvalidation(changesetId);\n } else {\n // Invalidate all projections for this changeset\n for (const key of this.projectionCache.cache.keys()) {\n if (key.startsWith(`${changesetId}:`)) {\n this.projectionCache.cache.delete(key);\n }\n }\n this.recordInvalidation(changesetId);\n }\n }\n\n /**\n * Invalidate projection cache when changes are unstaged.\n * Uses layer-specific invalidation for the affected element's layers.\n *\n * @param changesetId - ID of the changeset being modified\n * @param elementId - Optional: ID of element being unstaged (enables granular invalidation)\n *\n * @remarks\n * If elementId is provided, only the layers containing that element are invalidated.\n * This is more efficient than invalidating the entire changeset cache when\n * unstaging elements from a multi-layer changeset.\n * If elementId is omitted, invalidates all projections for the changeset.\n */\n async invalidateOnUnstage(changesetId: string, elementId?: string): Promise<void> {\n if (elementId) {\n // Layer-specific invalidation: only invalidate affected layers\n const affectedLayers = await this.getAffectedLayers(changesetId, elementId);\n for (const layerName of affectedLayers) {\n const cacheKey = `${changesetId}:${layerName}`;\n this.projectionCache.cache.delete(cacheKey);\n }\n if (affectedLayers.size > 0) {\n this.recordInvalidation(changesetId);\n }\n } else {\n // Full invalidation: clear all projections for this changeset\n for (const key of this.projectionCache.cache.keys()) {\n if (key.startsWith(`${changesetId}:`)) {\n this.projectionCache.cache.delete(key);\n }\n }\n this.recordInvalidation(changesetId);\n }\n }\n\n /**\n * Invalidate all projections for a changeset when it's discarded.\n * Clears all cached projections for this changeset to free memory.\n *\n * @param changesetId - ID of the changeset being discarded\n */\n invalidateOnDiscard(changesetId: string): void {\n for (const key of this.projectionCache.cache.keys()) {\n if (key.startsWith(`${changesetId}:`)) {\n this.projectionCache.cache.delete(key);\n }\n }\n }\n\n /**\n * Clone a layer to create an independent copy.\n * Shallow clones all elements and metadata to avoid mutations.\n * Cloned layer is marked clean to prevent unintended saves.\n *\n * @param layer - The layer to clone\n * @returns New layer with cloned elements and metadata\n *\n * @remarks\n * Cloning strategy:\n * 1. Create new Layer with same name\n * 2. Clone each element: shallow copy attributes object and array references\n * 3. Copy layer metadata if present\n * 4. Mark cloned layer as clean to prevent automatic saves\n * This ensures changes to projection don't affect base layer.\n * Note: Shallow cloning is sufficient since attributes are read-only in projections.\n */\n private cloneLayer(layer: Layer): Layer {\n const cloned = new LayerClass(layer.name);\n\n // Clone all elements (shallow copy - read-only in projection)\n for (const element of layer.listElements()) {\n const elementClone = new ElementClass({\n id: element.id,\n path: element.path,\n spec_node_id: element.spec_node_id,\n type: element.type,\n layer_id: element.layer_id,\n name: element.name,\n description: element.description,\n attributes: { ...element.attributes },\n references: [...(element.references || [])],\n relationships: [...(element.relationships || [])],\n layer: element.layer,\n source_reference: element.source_reference,\n metadata: element.metadata,\n });\n cloned.addElement(elementClone);\n }\n\n // Preserve layer metadata if present\n if (layer.metadata) {\n cloned.metadata = { ...layer.metadata };\n }\n\n // Mark as clean to prevent projection from being saved\n cloned.markClean();\n return cloned;\n }\n\n /**\n * Clean up expired cache entries periodically (every 60 seconds).\n * Removes entries that exceed the maxAge TTL.\n * Runs at most once per minute to limit overhead.\n *\n * @remarks\n * Cleanup is triggered after each projection computation.\n * Early exit if last cleanup was less than 60 seconds ago.\n * Entries are marked for deletion based on age calculation from computedAt timestamp.\n */\n private cleanupExpiredCache(): void {\n const now = Date.now();\n\n // Limit cleanup frequency to at most every 60 seconds\n if (now - this.projectionCache.lastCleanup < 60 * 1000) {\n return;\n }\n\n // Remove entries that have exceeded their TTL\n for (const [key, entry] of this.projectionCache.cache.entries()) {\n const age = now - new Date(entry.computedAt).getTime();\n if (age >= this.projectionCache.maxAge) {\n this.projectionCache.cache.delete(key);\n }\n }\n\n this.projectionCache.lastCleanup = now;\n }\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": []
|
|
7
|
+
}
|