onto-mcp 0.3.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/.onto/authority/core-lens-registry.yaml +134 -0
- package/.onto/authority/core-lexicon.yaml +1562 -0
- package/.onto/authority/diagnostic-codes.yaml +94 -0
- package/.onto/domains/accounting/competency_qs.md +384 -0
- package/.onto/domains/accounting/concepts.md +186 -0
- package/.onto/domains/accounting/conciseness_rules.md +160 -0
- package/.onto/domains/accounting/dependency_rules.md +239 -0
- package/.onto/domains/accounting/domain_scope.md +213 -0
- package/.onto/domains/accounting/extension_cases.md +416 -0
- package/.onto/domains/accounting/logic_rules.md +226 -0
- package/.onto/domains/accounting/structure_spec.md +298 -0
- package/.onto/domains/accounting-kr/competency_qs.md +562 -0
- package/.onto/domains/accounting-kr/concepts.md +187 -0
- package/.onto/domains/accounting-kr/conciseness_rules.md +125 -0
- package/.onto/domains/accounting-kr/dependency_rules.md +93 -0
- package/.onto/domains/accounting-kr/domain_scope.md +140 -0
- package/.onto/domains/accounting-kr/extension_cases.md +343 -0
- package/.onto/domains/accounting-kr/logic_rules.md +160 -0
- package/.onto/domains/accounting-kr/structure_spec.md +85 -0
- package/.onto/domains/business/competency_qs.md +263 -0
- package/.onto/domains/business/concepts.md +200 -0
- package/.onto/domains/business/conciseness_rules.md +135 -0
- package/.onto/domains/business/dependency_rules.md +113 -0
- package/.onto/domains/business/domain_scope.md +240 -0
- package/.onto/domains/business/extension_cases.md +249 -0
- package/.onto/domains/business/logic_rules.md +134 -0
- package/.onto/domains/business/structure_spec.md +114 -0
- package/.onto/domains/finance/competency_qs.md +362 -0
- package/.onto/domains/finance/concepts.md +194 -0
- package/.onto/domains/finance/conciseness_rules.md +155 -0
- package/.onto/domains/finance/dependency_rules.md +171 -0
- package/.onto/domains/finance/domain_scope.md +215 -0
- package/.onto/domains/finance/extension_cases.md +350 -0
- package/.onto/domains/finance/logic_rules.md +191 -0
- package/.onto/domains/finance/structure_spec.md +182 -0
- package/.onto/domains/llm-native-development/competency_qs.md +430 -0
- package/.onto/domains/llm-native-development/concepts.md +242 -0
- package/.onto/domains/llm-native-development/conciseness_rules.md +163 -0
- package/.onto/domains/llm-native-development/dependency_rules.md +216 -0
- package/.onto/domains/llm-native-development/domain_scope.md +197 -0
- package/.onto/domains/llm-native-development/extension_cases.md +474 -0
- package/.onto/domains/llm-native-development/logic_rules.md +123 -0
- package/.onto/domains/llm-native-development/prompt_interface.md +49 -0
- package/.onto/domains/llm-native-development/structure_spec.md +245 -0
- package/.onto/domains/market-intelligence/competency_qs.md +274 -0
- package/.onto/domains/market-intelligence/concepts.md +233 -0
- package/.onto/domains/market-intelligence/conciseness_rules.md +165 -0
- package/.onto/domains/market-intelligence/dependency_rules.md +197 -0
- package/.onto/domains/market-intelligence/domain_scope.md +231 -0
- package/.onto/domains/market-intelligence/extension_cases.md +425 -0
- package/.onto/domains/market-intelligence/logic_rules.md +247 -0
- package/.onto/domains/market-intelligence/structure_spec.md +209 -0
- package/.onto/domains/ontology/competency_qs.md +394 -0
- package/.onto/domains/ontology/concepts.md +172 -0
- package/.onto/domains/ontology/conciseness_rules.md +134 -0
- package/.onto/domains/ontology/dependency_rules.md +125 -0
- package/.onto/domains/ontology/domain_scope.md +114 -0
- package/.onto/domains/ontology/extension_cases.md +501 -0
- package/.onto/domains/ontology/logic_rules.md +114 -0
- package/.onto/domains/ontology/problem_framing_profile.md +67 -0
- package/.onto/domains/ontology/structure_spec.md +115 -0
- package/.onto/domains/palantir-foundry/RESEARCH_NOTES.md +911 -0
- package/.onto/domains/palantir-foundry/competency_qs.md +191 -0
- package/.onto/domains/palantir-foundry/competitive_comparison.md +329 -0
- package/.onto/domains/palantir-foundry/concepts.md +197 -0
- package/.onto/domains/palantir-foundry/conciseness_rules.md +245 -0
- package/.onto/domains/palantir-foundry/dependency_rules.md +135 -0
- package/.onto/domains/palantir-foundry/domain_scope.md +395 -0
- package/.onto/domains/palantir-foundry/extension_cases.md +210 -0
- package/.onto/domains/palantir-foundry/logic_rules.md +172 -0
- package/.onto/domains/palantir-foundry/structure_spec.md +291 -0
- package/.onto/domains/software-engineering/competency_qs.md +538 -0
- package/.onto/domains/software-engineering/concepts.md +238 -0
- package/.onto/domains/software-engineering/conciseness_rules.md +167 -0
- package/.onto/domains/software-engineering/dependency_rules.md +216 -0
- package/.onto/domains/software-engineering/domain_scope.md +183 -0
- package/.onto/domains/software-engineering/extension_cases.md +551 -0
- package/.onto/domains/software-engineering/logic_rules.md +240 -0
- package/.onto/domains/software-engineering/problem_framing_profile.md +68 -0
- package/.onto/domains/software-engineering/structure_spec.md +185 -0
- package/.onto/domains/ui-design/competency_qs.md +567 -0
- package/.onto/domains/ui-design/concepts.md +194 -0
- package/.onto/domains/ui-design/conciseness_rules.md +190 -0
- package/.onto/domains/ui-design/dependency_rules.md +323 -0
- package/.onto/domains/ui-design/domain_scope.md +340 -0
- package/.onto/domains/ui-design/extension_cases.md +563 -0
- package/.onto/domains/ui-design/logic_rules.md +349 -0
- package/.onto/domains/ui-design/structure_spec.md +252 -0
- package/.onto/domains/visual-design/competency_qs.md +472 -0
- package/.onto/domains/visual-design/concepts.md +147 -0
- package/.onto/domains/visual-design/conciseness_rules.md +186 -0
- package/.onto/domains/visual-design/dependency_rules.md +282 -0
- package/.onto/domains/visual-design/domain_scope.md +290 -0
- package/.onto/domains/visual-design/extension_cases.md +480 -0
- package/.onto/domains/visual-design/logic_rules.md +232 -0
- package/.onto/domains/visual-design/structure_spec.md +213 -0
- package/.onto/principles/llm-native-development-guideline.md +401 -0
- package/.onto/principles/llm-runtime-interface-principles.md +665 -0
- package/.onto/principles/non-specialist-communication-guideline.md +74 -0
- package/.onto/principles/ontology-as-code-guideline.md +243 -0
- package/.onto/principles/ontology-as-code-naming-charter.md +130 -0
- package/.onto/principles/product-locality-principle.md +129 -0
- package/.onto/principles/productization-charter.md +569 -0
- package/.onto/processes/evolve/material-kind-adapter-contract.md +113 -0
- package/.onto/processes/reconstruct/reconstruct-boundary-contract.md +366 -0
- package/.onto/processes/reconstruct/source-profile-contract.md +107 -0
- package/.onto/processes/reconstruct/source-profiles/code.md +72 -0
- package/.onto/processes/reconstruct/source-profiles/database.md +74 -0
- package/.onto/processes/reconstruct/source-profiles/document.md +71 -0
- package/.onto/processes/reconstruct/source-profiles/spreadsheet.md +79 -0
- package/.onto/processes/review/binding-contract.md +270 -0
- package/.onto/processes/review/execution-preparation-artifacts.md +281 -0
- package/.onto/processes/review/interpretation-contract.md +245 -0
- package/.onto/processes/review/issue-stance-deliberation-contract.md +761 -0
- package/.onto/processes/review/lens-prompt-contract.md +402 -0
- package/.onto/processes/review/lens-registry.md +127 -0
- package/.onto/processes/review/pre-dispatch-contracts.md +428 -0
- package/.onto/processes/review/productized-live-path.md +398 -0
- package/.onto/processes/review/prompt-execution-runner-contract.md +187 -0
- package/.onto/processes/review/record-contract.md +427 -0
- package/.onto/processes/review/record-field-mapping.md +337 -0
- package/.onto/processes/review/review-context-manifest-contract.md +356 -0
- package/.onto/processes/review/review-execution-ux-contract.md +809 -0
- package/.onto/processes/review/review-target-profile-contract.md +259 -0
- package/.onto/processes/review/shared-phenomenon-contract.md +129 -0
- package/.onto/processes/review/synthesize-prompt-contract.md +343 -0
- package/.onto/processes/shared/target-material-kind-contract.md +198 -0
- package/.onto/roles/axiology.md +81 -0
- package/.onto/roles/conciseness.md +36 -0
- package/.onto/roles/coverage.md +34 -0
- package/.onto/roles/dependency.md +37 -0
- package/.onto/roles/evolution.md +35 -0
- package/.onto/roles/logic.md +104 -0
- package/.onto/roles/pragmatics.md +32 -0
- package/.onto/roles/semantics.md +36 -0
- package/.onto/roles/structure.md +33 -0
- package/.onto/roles/synthesize.md +92 -0
- package/AGENTS.md +240 -0
- package/CLAUDE.md +39 -0
- package/README.md +287 -0
- package/bin/onto +92 -0
- package/dist/cli.js +101 -0
- package/dist/core-api/reconstruct-api.js +222 -0
- package/dist/core-api/review-api.js +1271 -0
- package/dist/core-runtime/cli/assemble-review-record.js +431 -0
- package/dist/core-runtime/cli/bootstrap-review-binding.js +186 -0
- package/dist/core-runtime/cli/codex-nested-dispatch.js +226 -0
- package/dist/core-runtime/cli/codex-nested-dispatch.test.js +390 -0
- package/dist/core-runtime/cli/codex-nested-teamlead-executor.js +464 -0
- package/dist/core-runtime/cli/codex-nested-teamlead-executor.test.js +335 -0
- package/dist/core-runtime/cli/codex-review-unit-executor.js +228 -0
- package/dist/core-runtime/cli/complete-review-session.js +64 -0
- package/dist/core-runtime/cli/complexity-assessment.js +153 -0
- package/dist/core-runtime/cli/coordinator-helpers.js +583 -0
- package/dist/core-runtime/cli/coordinator-state-machine-deliberation.test.js +167 -0
- package/dist/core-runtime/cli/coordinator-state-machine.js +794 -0
- package/dist/core-runtime/cli/e2e-codex-multi-agent-fixes.test.js +615 -0
- package/dist/core-runtime/cli/e2e-start-review-session.test.js +312 -0
- package/dist/core-runtime/cli/health.js +44 -0
- package/dist/core-runtime/cli/inline-http-review-unit-executor.js +656 -0
- package/dist/core-runtime/cli/inline-http-review-unit-executor.test.js +567 -0
- package/dist/core-runtime/cli/materialize-review-execution-preparation.js +104 -0
- package/dist/core-runtime/cli/materialize-review-prompt-packets.js +952 -0
- package/dist/core-runtime/cli/migrate-session-roots.js +118 -0
- package/dist/core-runtime/cli/mock-review-unit-executor.js +285 -0
- package/dist/core-runtime/cli/onto-tools.js +369 -0
- package/dist/core-runtime/cli/prepare-review-session.js +272 -0
- package/dist/core-runtime/cli/render-review-final-output.js +350 -0
- package/dist/core-runtime/cli/repo-layout-migration-replace.smoke.test.js +106 -0
- package/dist/core-runtime/cli/review-invoke-auto-resolution.test.js +268 -0
- package/dist/core-runtime/cli/review-invoke-coordinator-topology.test.js +136 -0
- package/dist/core-runtime/cli/review-invoke-resolver-caching.test.js +201 -0
- package/dist/core-runtime/cli/review-invoke-topology-dispatch.test.js +192 -0
- package/dist/core-runtime/cli/review-invoke.js +2030 -0
- package/dist/core-runtime/cli/run-review-prompt-execution.js +2152 -0
- package/dist/core-runtime/cli/session-root-guard.js +168 -0
- package/dist/core-runtime/cli/spawn-watcher.js +173 -0
- package/dist/core-runtime/cli/spawn-watcher.test.js +457 -0
- package/dist/core-runtime/cli/start-review-session.js +68 -0
- package/dist/core-runtime/cli/strip-wrapping-code-fence.js +56 -0
- package/dist/core-runtime/cli/strip-wrapping-code-fence.test.js +79 -0
- package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.js +412 -0
- package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.test.js +351 -0
- package/dist/core-runtime/cli/topology-executor-mapping.js +139 -0
- package/dist/core-runtime/cli/topology-executor-mapping.test.js +173 -0
- package/dist/core-runtime/cli/write-review-interpretation.js +81 -0
- package/dist/core-runtime/config/onto-config-cli.js +278 -0
- package/dist/core-runtime/config/onto-config-key-path.js +288 -0
- package/dist/core-runtime/config/onto-config-key-path.test.js +195 -0
- package/dist/core-runtime/config/onto-config-preview.js +108 -0
- package/dist/core-runtime/config/onto-config-preview.test.js +132 -0
- package/dist/core-runtime/discovery/config-chain.js +118 -0
- package/dist/core-runtime/discovery/config-chain.test.js +103 -0
- package/dist/core-runtime/discovery/config-profile.js +199 -0
- package/dist/core-runtime/discovery/config-profile.test.js +233 -0
- package/dist/core-runtime/discovery/host-detection.js +33 -0
- package/dist/core-runtime/discovery/host-detection.test.js +186 -0
- package/dist/core-runtime/discovery/installation-paths.js +21 -0
- package/dist/core-runtime/discovery/installation-paths.test.js +65 -0
- package/dist/core-runtime/discovery/lens-registry.js +60 -0
- package/dist/core-runtime/discovery/lens-registry.test.js +81 -0
- package/dist/core-runtime/discovery/onto-home.js +71 -0
- package/dist/core-runtime/discovery/path-normalization.js +28 -0
- package/dist/core-runtime/discovery/path-normalization.test.js +22 -0
- package/dist/core-runtime/discovery/plugin-path.js +72 -0
- package/dist/core-runtime/discovery/plugin-path.test.js +95 -0
- package/dist/core-runtime/discovery/project-root.js +47 -0
- package/dist/core-runtime/discovery/settings-chain.js +353 -0
- package/dist/core-runtime/discovery/walk-up.js +17 -0
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.js +344 -0
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.test.js +915 -0
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile.js +564 -0
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile.test.js +708 -0
- package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.js +165 -0
- package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.test.js +227 -0
- package/dist/core-runtime/evolve/adapters/code-product/validators/validate.js +59 -0
- package/dist/core-runtime/evolve/adapters/code-product/validators/validate.test.js +205 -0
- package/dist/core-runtime/evolve/adapters/methodology/adapter.js +16 -0
- package/dist/core-runtime/evolve/adapters/methodology/adapter.test.js +9 -0
- package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.js +298 -0
- package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.test.js +70 -0
- package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.js +46 -0
- package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.test.js +73 -0
- package/dist/core-runtime/evolve/adapters/registry.js +47 -0
- package/dist/core-runtime/evolve/adapters/registry.test.js +67 -0
- package/dist/core-runtime/evolve/cli.js +256 -0
- package/dist/core-runtime/evolve/commands/align.js +194 -0
- package/dist/core-runtime/evolve/commands/align.test.js +82 -0
- package/dist/core-runtime/evolve/commands/apply.js +161 -0
- package/dist/core-runtime/evolve/commands/apply.test.js +138 -0
- package/dist/core-runtime/evolve/commands/close.js +39 -0
- package/dist/core-runtime/evolve/commands/close.test.js +99 -0
- package/dist/core-runtime/evolve/commands/defer.js +40 -0
- package/dist/core-runtime/evolve/commands/defer.test.js +134 -0
- package/dist/core-runtime/evolve/commands/draft.js +323 -0
- package/dist/core-runtime/evolve/commands/draft.test.js +178 -0
- package/dist/core-runtime/evolve/commands/e2e-evolve-full-cycle.test.js +208 -0
- package/dist/core-runtime/evolve/commands/error-messages.js +125 -0
- package/dist/core-runtime/evolve/commands/error-messages.test.js +167 -0
- package/dist/core-runtime/evolve/commands/propose-align.js +222 -0
- package/dist/core-runtime/evolve/commands/propose-align.test.js +136 -0
- package/dist/core-runtime/evolve/commands/reconstruct.js +330 -0
- package/dist/core-runtime/evolve/commands/reconstruct.test.js +278 -0
- package/dist/core-runtime/evolve/commands/shared.js +22 -0
- package/dist/core-runtime/evolve/commands/stale-check.js +103 -0
- package/dist/core-runtime/evolve/commands/stale-check.test.js +84 -0
- package/dist/core-runtime/evolve/commands/start.js +887 -0
- package/dist/core-runtime/evolve/commands/start.test.js +396 -0
- package/dist/core-runtime/evolve/config/project-config.js +99 -0
- package/dist/core-runtime/evolve/config/project-config.test.js +170 -0
- package/dist/core-runtime/evolve/renderers/align-packet.js +280 -0
- package/dist/core-runtime/evolve/renderers/align-packet.test.js +332 -0
- package/dist/core-runtime/evolve/renderers/draft-packet.js +303 -0
- package/dist/core-runtime/evolve/renderers/draft-packet.test.js +377 -0
- package/dist/core-runtime/evolve/renderers/format.js +5 -0
- package/dist/core-runtime/evolve/renderers/scope-md.js +237 -0
- package/dist/core-runtime/evolve/renderers/scope-md.test.js +306 -0
- package/dist/core-runtime/govern/cli.js +369 -0
- package/dist/core-runtime/govern/cli.test.js +314 -0
- package/dist/core-runtime/govern/drift-engine.js +103 -0
- package/dist/core-runtime/govern/drift-engine.test.js +319 -0
- package/dist/core-runtime/govern/promote-principle.js +206 -0
- package/dist/core-runtime/govern/promote-principle.test.js +368 -0
- package/dist/core-runtime/govern/queue.js +81 -0
- package/dist/core-runtime/govern/types.js +16 -0
- package/dist/core-runtime/install/cli.js +530 -0
- package/dist/core-runtime/install/detect.js +128 -0
- package/dist/core-runtime/install/detect.test.js +155 -0
- package/dist/core-runtime/install/gitignore-update.js +74 -0
- package/dist/core-runtime/install/gitignore-update.test.js +64 -0
- package/dist/core-runtime/install/install-integration.test.js +373 -0
- package/dist/core-runtime/install/prompts.js +389 -0
- package/dist/core-runtime/install/prompts.test.js +293 -0
- package/dist/core-runtime/install/types.js +26 -0
- package/dist/core-runtime/install/validation.js +295 -0
- package/dist/core-runtime/install/validation.test.js +313 -0
- package/dist/core-runtime/install/writer.js +254 -0
- package/dist/core-runtime/install/writer.test.js +218 -0
- package/dist/core-runtime/learning/extractor.js +461 -0
- package/dist/core-runtime/learning/feedback.js +179 -0
- package/dist/core-runtime/learning/health-report.js +165 -0
- package/dist/core-runtime/learning/health-report.test.js +169 -0
- package/dist/core-runtime/learning/loader.js +388 -0
- package/dist/core-runtime/learning/loader.test.js +102 -0
- package/dist/core-runtime/learning/promote/apply-state.js +240 -0
- package/dist/core-runtime/learning/promote/audit-obligation.js +195 -0
- package/dist/core-runtime/learning/promote/collector.js +432 -0
- package/dist/core-runtime/learning/promote/degraded-state.js +125 -0
- package/dist/core-runtime/learning/promote/domain-doc-proposer.js +166 -0
- package/dist/core-runtime/learning/promote/e2e-promote.test.js +6385 -0
- package/dist/core-runtime/learning/promote/health-snapshot.js +150 -0
- package/dist/core-runtime/learning/promote/insight-reclassifier.js +544 -0
- package/dist/core-runtime/learning/promote/judgment-auditor.js +517 -0
- package/dist/core-runtime/learning/promote/panel-reviewer.js +1158 -0
- package/dist/core-runtime/learning/promote/promote-executor.js +1675 -0
- package/dist/core-runtime/learning/promote/promoter.js +307 -0
- package/dist/core-runtime/learning/promote/retirement.js +122 -0
- package/dist/core-runtime/learning/promote/types.js +23 -0
- package/dist/core-runtime/learning/prompt-sections.js +51 -0
- package/dist/core-runtime/learning/shared/artifact-registry-init.js +45 -0
- package/dist/core-runtime/learning/shared/artifact-registry.js +254 -0
- package/dist/core-runtime/learning/shared/audit-obligation-kernel.js +73 -0
- package/dist/core-runtime/learning/shared/audit-state.js +99 -0
- package/dist/core-runtime/learning/shared/duplicate-check.js +28 -0
- package/dist/core-runtime/learning/shared/llm-caller.js +831 -0
- package/dist/core-runtime/learning/shared/llm-caller.test.js +601 -0
- package/dist/core-runtime/learning/shared/llm-tool-loop.js +393 -0
- package/dist/core-runtime/learning/shared/mode.js +25 -0
- package/dist/core-runtime/learning/shared/paths.js +84 -0
- package/dist/core-runtime/learning/shared/paths.test.js +79 -0
- package/dist/core-runtime/learning/shared/patterns.js +37 -0
- package/dist/core-runtime/learning/shared/recoverability.js +355 -0
- package/dist/core-runtime/learning/shared/recovery-context.js +374 -0
- package/dist/core-runtime/learning/shared/scope.js +1 -0
- package/dist/core-runtime/learning/shared/semantic-classifier.js +94 -0
- package/dist/core-runtime/learning/shared/specs/apply-execution-state-spec.js +42 -0
- package/dist/core-runtime/learning/shared/specs/audit-state-spec.js +37 -0
- package/dist/core-runtime/learning/shared/specs/backup-metadata-spec.js +39 -0
- package/dist/core-runtime/learning/shared/specs/emergency-log-spec.js +41 -0
- package/dist/core-runtime/learning/shared/specs/layout-version-spec.js +38 -0
- package/dist/core-runtime/learning/shared/specs/promote-decisions-spec.js +43 -0
- package/dist/core-runtime/learning/shared/specs/promote-report-spec.js +113 -0
- package/dist/core-runtime/learning/shared/specs/prune-log-spec.js +36 -0
- package/dist/core-runtime/learning/shared/specs/recovery-resolution-spec.js +48 -0
- package/dist/core-runtime/learning/shared/specs/restore-manifest-spec.js +43 -0
- package/dist/core-runtime/learning/shared/specs/spec-helpers.js +64 -0
- package/dist/core-runtime/learning/usage-tracker.js +190 -0
- package/dist/core-runtime/learning/usage-tracker.test.js +176 -0
- package/dist/core-runtime/llm/llm-caller.js +649 -0
- package/dist/core-runtime/llm/llm-tool-loop.js +401 -0
- package/dist/core-runtime/llm/model-switcher.js +62 -0
- package/dist/core-runtime/logger.js +22 -0
- package/dist/core-runtime/onboard/detect-review-axes.js +122 -0
- package/dist/core-runtime/onboard/detect-review-axes.test.js +127 -0
- package/dist/core-runtime/onboard/write-review-block.js +188 -0
- package/dist/core-runtime/onboard/write-review-block.test.js +240 -0
- package/dist/core-runtime/readers/brownfield-builder.js +150 -0
- package/dist/core-runtime/readers/brownfield-builder.test.js +136 -0
- package/dist/core-runtime/readers/code-chunk-collector.js +53 -0
- package/dist/core-runtime/readers/code-chunk-collector.test.js +136 -0
- package/dist/core-runtime/readers/file-utils.js +240 -0
- package/dist/core-runtime/readers/file-utils.test.js +146 -0
- package/dist/core-runtime/readers/lexicon-citation-check.js +93 -0
- package/dist/core-runtime/readers/lexicon-citation-check.test.js +77 -0
- package/dist/core-runtime/readers/mcp-figma.js +30 -0
- package/dist/core-runtime/readers/mcp-figma.test.js +82 -0
- package/dist/core-runtime/readers/mcp-generic.js +31 -0
- package/dist/core-runtime/readers/mcp-generic.test.js +76 -0
- package/dist/core-runtime/readers/ontology-index.js +148 -0
- package/dist/core-runtime/readers/ontology-index.test.js +245 -0
- package/dist/core-runtime/readers/ontology-query.js +168 -0
- package/dist/core-runtime/readers/ontology-query.test.js +311 -0
- package/dist/core-runtime/readers/ontology-resolve.js +48 -0
- package/dist/core-runtime/readers/ontology-resolve.test.js +48 -0
- package/dist/core-runtime/readers/patterns/index.js +7 -0
- package/dist/core-runtime/readers/review-log.js +213 -0
- package/dist/core-runtime/readers/review-log.test.js +313 -0
- package/dist/core-runtime/readers/scan-local.js +102 -0
- package/dist/core-runtime/readers/scan-local.test.js +102 -0
- package/dist/core-runtime/readers/scan-tarball.js +121 -0
- package/dist/core-runtime/readers/scan-tarball.test.js +283 -0
- package/dist/core-runtime/readers/scan-vault.js +34 -0
- package/dist/core-runtime/readers/scan-vault.test.js +81 -0
- package/dist/core-runtime/readers/types.js +42 -0
- package/dist/core-runtime/readers/types.test.js +94 -0
- package/dist/core-runtime/readers/viewpoint-collectors.js +229 -0
- package/dist/core-runtime/reconstruct/artifact-types.js +1 -0
- package/dist/core-runtime/reconstruct/directive-validation.js +123 -0
- package/dist/core-runtime/reconstruct/materialize-preparation.js +251 -0
- package/dist/core-runtime/reconstruct/record.js +198 -0
- package/dist/core-runtime/reconstruct/run.js +578 -0
- package/dist/core-runtime/reconstruct/seed-candidate-validation.js +356 -0
- package/dist/core-runtime/reconstruct/source-observations.js +62 -0
- package/dist/core-runtime/reconstruct/source-profiles.js +73 -0
- package/dist/core-runtime/release-channel/release-channel.js +90 -0
- package/dist/core-runtime/review/artifact-types.js +13 -0
- package/dist/core-runtime/review/citation-audit.js +204 -0
- package/dist/core-runtime/review/citation-audit.test.js +165 -0
- package/dist/core-runtime/review/controlled-lens-deliberation.js +125 -0
- package/dist/core-runtime/review/execution-plan-resolver.js +247 -0
- package/dist/core-runtime/review/execution-plan-resolver.test.js +243 -0
- package/dist/core-runtime/review/execution-topology-resolver-axis-first.test.js +246 -0
- package/dist/core-runtime/review/execution-topology-resolver.js +401 -0
- package/dist/core-runtime/review/execution-topology-resolver.test.js +315 -0
- package/dist/core-runtime/review/failure-records.js +57 -0
- package/dist/core-runtime/review/inline-context-embedder.js +141 -0
- package/dist/core-runtime/review/inline-context-embedder.test.js +154 -0
- package/dist/core-runtime/review/issue-artifact-runtime.js +859 -0
- package/dist/core-runtime/review/legacy-mode-policy.js +88 -0
- package/dist/core-runtime/review/lens-completion-policy.js +17 -0
- package/dist/core-runtime/review/materializers-effort-persist.test.js +79 -0
- package/dist/core-runtime/review/materializers.js +963 -0
- package/dist/core-runtime/review/ontology-path-classifier.js +179 -0
- package/dist/core-runtime/review/ontology-path-classifier.test.js +216 -0
- package/dist/core-runtime/review/packet-boundary-policy.js +215 -0
- package/dist/core-runtime/review/packet-boundary-policy.test.js +107 -0
- package/dist/core-runtime/review/participating-lens-paths.js +61 -0
- package/dist/core-runtime/review/participating-lens-paths.test.js +73 -0
- package/dist/core-runtime/review/review-artifact-utils.js +287 -0
- package/dist/core-runtime/review/review-config-legacy-translate.js +244 -0
- package/dist/core-runtime/review/review-config-legacy-translate.test.js +161 -0
- package/dist/core-runtime/review/review-config-validator.js +289 -0
- package/dist/core-runtime/review/review-config-validator.test.js +236 -0
- package/dist/core-runtime/review/review-execution-profile.js +193 -0
- package/dist/core-runtime/review/review-execution-route.js +52 -0
- package/dist/core-runtime/review/review-progress-contract.js +123 -0
- package/dist/core-runtime/review/review-record-validation.js +251 -0
- package/dist/core-runtime/review/review-result-classification.js +379 -0
- package/dist/core-runtime/review/review-state-machine.js +39 -0
- package/dist/core-runtime/review/route-visibility.js +125 -0
- package/dist/core-runtime/review/shape-pipeline-audit.test.js +311 -0
- package/dist/core-runtime/review/shape-to-topology-id.js +117 -0
- package/dist/core-runtime/review/shape-to-topology-id.test.js +132 -0
- package/dist/core-runtime/review/topology-shape-derivation.js +155 -0
- package/dist/core-runtime/review/topology-shape-derivation.test.js +195 -0
- package/dist/core-runtime/scope-runtime/constants.js +12 -0
- package/dist/core-runtime/scope-runtime/constraint-pool.js +166 -0
- package/dist/core-runtime/scope-runtime/constraint-pool.test.js +674 -0
- package/dist/core-runtime/scope-runtime/domain-validation-log.js +135 -0
- package/dist/core-runtime/scope-runtime/domain-validation-log.test.js +156 -0
- package/dist/core-runtime/scope-runtime/eval-persistence.js +65 -0
- package/dist/core-runtime/scope-runtime/eval-persistence.test.js +84 -0
- package/dist/core-runtime/scope-runtime/event-pipeline.js +64 -0
- package/dist/core-runtime/scope-runtime/event-pipeline.test.js +450 -0
- package/dist/core-runtime/scope-runtime/event-store.js +39 -0
- package/dist/core-runtime/scope-runtime/event-store.test.js +95 -0
- package/dist/core-runtime/scope-runtime/gate-guard.js +348 -0
- package/dist/core-runtime/scope-runtime/gate-guard.test.js +1047 -0
- package/dist/core-runtime/scope-runtime/hash.js +4 -0
- package/dist/core-runtime/scope-runtime/hash.test.js +33 -0
- package/dist/core-runtime/scope-runtime/id.js +4 -0
- package/dist/core-runtime/scope-runtime/id.test.js +17 -0
- package/dist/core-runtime/scope-runtime/reducer.js +297 -0
- package/dist/core-runtime/scope-runtime/reducer.test.js +759 -0
- package/dist/core-runtime/scope-runtime/scope-manager.js +161 -0
- package/dist/core-runtime/scope-runtime/state-machine.js +309 -0
- package/dist/core-runtime/scope-runtime/state-machine.test.js +704 -0
- package/dist/core-runtime/scope-runtime/types.js +116 -0
- package/dist/core-runtime/scope-runtime/types.test.js +69 -0
- package/dist/core-runtime/target-material-kind.js +256 -0
- package/dist/core-runtime/translate/render-for-user.js +169 -0
- package/dist/core-runtime/translate/render-for-user.test.js +122 -0
- package/dist/mcp/server.js +1011 -0
- package/dist/mcp/tool-schemas.js +93 -0
- package/dist/providers/capability-contract.js +1 -0
- package/package.json +68 -0
- package/settings.example.json +33 -0
|
@@ -0,0 +1,563 @@
|
|
|
1
|
+
---
|
|
2
|
+
version: 2
|
|
3
|
+
last_updated: "2026-03-31"
|
|
4
|
+
source: manual
|
|
5
|
+
status: established
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# UI Design Domain — Extension Cases
|
|
9
|
+
|
|
10
|
+
Classification axis: **change trigger** — cases classified by the type of change that triggers structural evolution of the UI. Cases cover both growth triggers (Cases 1–10) and shrinkage triggers (Cases 11–14).
|
|
11
|
+
|
|
12
|
+
The evolution agent simulates each scenario to verify whether the existing UI design structure breaks.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Case 1: Large-Scale Feature Addition
|
|
17
|
+
|
|
18
|
+
### Situation
|
|
19
|
+
|
|
20
|
+
Adding a new major feature requiring IA changes, navigation updates, and new screen states.
|
|
21
|
+
|
|
22
|
+
### Case Study: Slack — Clips (2021)
|
|
23
|
+
|
|
24
|
+
Slack added async audio/video messaging (Clips) to its text workspace. By scoping Clips as a message type — entry point in the composer, playback inline in the timeline — the existing IA and global navigation were unchanged. New empty/error states (permission denied, transcription failure) were required.
|
|
25
|
+
|
|
26
|
+
### Impact Analysis
|
|
27
|
+
|
|
28
|
+
| Principle | Impact |
|
|
29
|
+
|---|---|
|
|
30
|
+
| Information architecture | Must fit within existing IA or justify a new top-level section (5–7 item limit) |
|
|
31
|
+
| Screen state completeness | All states (ideal/empty/loading/error) must be defined for new screens |
|
|
32
|
+
| Pattern reuse | Must reuse design system patterns; new patterns must be consistent |
|
|
33
|
+
| CTA hierarchy | Must not conflict with existing CTA hierarchy |
|
|
34
|
+
|
|
35
|
+
### Verification Checklist
|
|
36
|
+
|
|
37
|
+
- [ ] Does the IA accommodate the feature within navigation thresholds? → structure_spec.md §Navigation Structure Patterns
|
|
38
|
+
- [ ] Are all states (ideal/first-use/loading/error/no-results) defined? → structure_spec.md §Screen State Matrix
|
|
39
|
+
- [ ] Does the feature reuse design system patterns? → dependency_rules.md §Referential Integrity (Component–Design System References)
|
|
40
|
+
- [ ] Does the CTA not conflict with existing hierarchy? → logic_rules.md §Action Guidance Logic (Primary Action Singularity)
|
|
41
|
+
- [ ] Are async operations covered with loading/success/failure? → structure_spec.md §Required Relationships (Async State Completeness)
|
|
42
|
+
|
|
43
|
+
### Affected Files
|
|
44
|
+
|
|
45
|
+
| File | Impact | Section |
|
|
46
|
+
|---|---|---|
|
|
47
|
+
| structure_spec.md | Verify | §Navigation Structure Patterns, §Screen State Matrix |
|
|
48
|
+
| logic_rules.md | Verify | §Navigation Logic, §Action Guidance Logic |
|
|
49
|
+
| dependency_rules.md | Verify | §Information Architecture–Navigation Dependency, §Referential Integrity |
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Case 2: New Mobile App Launch
|
|
54
|
+
|
|
55
|
+
### Situation
|
|
56
|
+
|
|
57
|
+
Extending the existing web interface to a mobile app (iOS/Android) with responsive adaptations and touch optimization.
|
|
58
|
+
|
|
59
|
+
### Case Study: Airbnb — Mobile-First Redesign (2014–2016)
|
|
60
|
+
|
|
61
|
+
Airbnb shifted from desktop adaptation to mobile-first: search became full-screen vertical, tables became cards, hover map became tap-to-select, sidebar became 5-item bottom bar. Touch targets standardized to 48×48dp. Platform-specific: iOS used swipe-back; Android used Material bottom sheets.
|
|
62
|
+
|
|
63
|
+
### Impact Analysis
|
|
64
|
+
|
|
65
|
+
| Principle | Impact |
|
|
66
|
+
|---|---|
|
|
67
|
+
| Component transitions | Transition rules required (table → card, sidebar → bottom nav) |
|
|
68
|
+
| Touch targets | All elements must meet 44×44px minimum (WCAG 2.5.5) |
|
|
69
|
+
| Hover alternatives | Touch alternatives required for hover-dependent interactions |
|
|
70
|
+
| Platform conventions | Convention conflicts must have resolution criteria |
|
|
71
|
+
|
|
72
|
+
### Verification Checklist
|
|
73
|
+
|
|
74
|
+
- [ ] Are desktop-to-mobile transition rules defined? → structure_spec.md §Responsive Component Transition Rules
|
|
75
|
+
- [ ] Do all touch targets meet 44×44px minimum? → logic_rules.md §Action Guidance Logic (Fitts's Law Application)
|
|
76
|
+
- [ ] Are touch alternatives defined for hover interactions? → dependency_rules.md §Responsive–Component Dependency (Touch Environment → Hover Alternative)
|
|
77
|
+
- [ ] Are platform convention conflicts resolved? → domain_scope.md §Normative System Classification (Tier-1b)
|
|
78
|
+
- [ ] Is content priority preserved in responsive transitions? → dependency_rules.md §Responsive–Component Dependency (Screen Reduction → Content Priority)
|
|
79
|
+
|
|
80
|
+
### Affected Files
|
|
81
|
+
|
|
82
|
+
| File | Impact | Section |
|
|
83
|
+
|---|---|---|
|
|
84
|
+
| structure_spec.md | Modify | §Responsive Component Transition Rules, §Navigation Structure Patterns |
|
|
85
|
+
| dependency_rules.md | Verify | §Responsive–Component Dependency |
|
|
86
|
+
| logic_rules.md | Verify | §Navigation Logic (Mobile Navigation Discoverability) |
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## Case 3: User Type Diversification
|
|
91
|
+
|
|
92
|
+
### Situation
|
|
93
|
+
|
|
94
|
+
Expanding from a single user type to multiple types (general, admin, power user) with role-based UI variations.
|
|
95
|
+
|
|
96
|
+
### Case Study: Notion — Team Plans and Permission Tiers (2020–2022)
|
|
97
|
+
|
|
98
|
+
Notion expanded from personal tool to team workspace with Members, Admins, and Guests. Each role saw different sidebar content; inaccessible features were disabled with tooltips; out-of-scope features were hidden. Admins had dense settings; Members saw simplified views. A sidebar role indicator communicated permission context.
|
|
99
|
+
|
|
100
|
+
### Impact Analysis
|
|
101
|
+
|
|
102
|
+
| Principle | Impact |
|
|
103
|
+
|---|---|
|
|
104
|
+
| Information density | Dense for admins, concise for general users |
|
|
105
|
+
| Permission-based display | Hide vs disable vs upgrade prompt must be consistent |
|
|
106
|
+
| Navigation adjustment | Must adjust per user type without breaking wayfinding |
|
|
107
|
+
| Role context | Users must know which role they operate under |
|
|
108
|
+
|
|
109
|
+
### Verification Checklist
|
|
110
|
+
|
|
111
|
+
- [ ] Are density variations designed per user type? → logic_rules.md §Constraint Conflict Checks (Information Density vs Cognitive Load)
|
|
112
|
+
- [ ] Is unpermitted feature handling consistent? → structure_spec.md §Screen State Matrix (No Permission state)
|
|
113
|
+
- [ ] Are admin-only features not exposed to general users? → dependency_rules.md §Referential Integrity (Cross-Screen References)
|
|
114
|
+
- [ ] Is navigation adjusted per user type? → dependency_rules.md §Information Architecture–Navigation Dependency
|
|
115
|
+
- [ ] Is the current role visible? → logic_rules.md §Navigation Logic (Wayfinding Completeness)
|
|
116
|
+
|
|
117
|
+
### Affected Files
|
|
118
|
+
|
|
119
|
+
| File | Impact | Section |
|
|
120
|
+
|---|---|---|
|
|
121
|
+
| structure_spec.md | Modify | §Screen State Matrix, §Classification Criteria Design |
|
|
122
|
+
| logic_rules.md | Verify | §Constraint Conflict Checks, §Navigation Logic |
|
|
123
|
+
| dependency_rules.md | Verify | §Referential Integrity, §Information Architecture–Navigation Dependency |
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## Case 4: Complex Form Addition
|
|
128
|
+
|
|
129
|
+
### Situation
|
|
130
|
+
|
|
131
|
+
Expanding from simple inputs to complex forms (20+ fields) with multi-step division, conditional logic, and cross-step validation.
|
|
132
|
+
|
|
133
|
+
### Case Study: TurboTax — Tax Filing Form Redesign (2019)
|
|
134
|
+
|
|
135
|
+
Intuit restructured TurboTax (100+ fields) from linear flow to a topic-based hub: sections completable in any order with status indicators. Conditional branching was pervasive ("Self-employment?" → Yes revealed 15+ fields). Auto-save persisted every change. Cross-step validation surfaced errors with links to the conflicting field in another section.
|
|
136
|
+
|
|
137
|
+
### Impact Analysis
|
|
138
|
+
|
|
139
|
+
| Principle | Impact |
|
|
140
|
+
|---|---|
|
|
141
|
+
| Multi-step division | Divide into logical, conceptually complete steps |
|
|
142
|
+
| Progress indication | Current step, total steps, inter-step navigation visible |
|
|
143
|
+
| Conditional fields | Show/hide logic based on previous answers defined |
|
|
144
|
+
| Draft saving | Automatic preservation to prevent data loss |
|
|
145
|
+
| Cross-step errors | Errors in another step require navigation to source |
|
|
146
|
+
|
|
147
|
+
### Verification Checklist
|
|
148
|
+
|
|
149
|
+
- [ ] Is the form divided into logical multi-step units? → logic_rules.md §Form Design Logic (Multi-Step Form Coherence)
|
|
150
|
+
- [ ] Are progress indicators present? → structure_spec.md §Form Structure Principles (Multi-Step Forms)
|
|
151
|
+
- [ ] Is conditional field logic defined? → dependency_rules.md §Form–Validation Dependency (Multi-Step Form Dependencies)
|
|
152
|
+
- [ ] Is cross-step error navigation defined? → dependency_rules.md §Form–Validation Dependency (Validation → Error Display)
|
|
153
|
+
- [ ] Are all field validation rules defined? → dependency_rules.md §Form–Validation Dependency (Input Field → Validation Rules)
|
|
154
|
+
|
|
155
|
+
### Affected Files
|
|
156
|
+
|
|
157
|
+
| File | Impact | Section |
|
|
158
|
+
|---|---|---|
|
|
159
|
+
| logic_rules.md | Modify | §Form Design Logic |
|
|
160
|
+
| dependency_rules.md | Modify | §Form–Validation Dependency |
|
|
161
|
+
| structure_spec.md | Verify | §Form Structure Principles |
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## Case 5: Real-Time Collaboration Feature Addition
|
|
166
|
+
|
|
167
|
+
### Situation
|
|
168
|
+
|
|
169
|
+
Expanding from single-user to multi-user real-time collaboration with presence, conflict resolution, and notification management.
|
|
170
|
+
|
|
171
|
+
### Case Study: Figma — Multiplayer Design (2016–2019)
|
|
172
|
+
|
|
173
|
+
Figma pioneered real-time multiplayer design: colored cursors with avatars, concurrent edits resolved via operational transform (no conflict dialogs), connection status indicator (green/yellow/red). Notifications used a sidebar panel rather than popups to prevent fatigue.
|
|
174
|
+
|
|
175
|
+
### Impact Analysis
|
|
176
|
+
|
|
177
|
+
| Principle | Impact |
|
|
178
|
+
|---|---|
|
|
179
|
+
| Presence indicators | Visible without disrupting the current user |
|
|
180
|
+
| Conflict resolution | Display/resolution for simultaneous edits defined |
|
|
181
|
+
| Disconnection handling | Offline display and reconnection guidance |
|
|
182
|
+
| Notification management | Change notifications must not cause fatigue |
|
|
183
|
+
|
|
184
|
+
### Verification Checklist
|
|
185
|
+
|
|
186
|
+
- [ ] Is a presence indicator designed? → structure_spec.md §UI Design Required Elements (Feedback System)
|
|
187
|
+
- [ ] Are concurrent edit conflict methods defined? → structure_spec.md §Screen State Matrix
|
|
188
|
+
- [ ] Are disconnection/reconnection states defined? → structure_spec.md §Screen State Matrix (Offline state)
|
|
189
|
+
- [ ] Are notifications managed to prevent fatigue? → logic_rules.md §Feedback Logic (Notification Fatigue Management)
|
|
190
|
+
- [ ] Are live regions used for screen reader announcements? → dependency_rules.md §Accessibility–Interaction Dependency (Dynamic Content → Live Region)
|
|
191
|
+
|
|
192
|
+
### Affected Files
|
|
193
|
+
|
|
194
|
+
| File | Impact | Section |
|
|
195
|
+
|---|---|---|
|
|
196
|
+
| structure_spec.md | Modify | §Screen State Matrix, §UI Design Required Elements (Feedback System) |
|
|
197
|
+
| logic_rules.md | Verify | §Feedback Logic |
|
|
198
|
+
| dependency_rules.md | Verify | §Action–Feedback Dependency, §Accessibility–Interaction Dependency |
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
## Case 6: Comprehensive Accessibility Improvement
|
|
203
|
+
|
|
204
|
+
### Situation
|
|
205
|
+
|
|
206
|
+
Full application of WCAG 2.2 AA to a previously accessibility-deficient interface.
|
|
207
|
+
|
|
208
|
+
### Case Study: Gov.uk — GDS Accessibility Overhaul (2018–2020)
|
|
209
|
+
|
|
210
|
+
UK GDS mandated WCAG 2.1 AA for all services. Custom components replaced with native HTML where possible; unavoidable ones received full ARIA specification. The error summary pattern (linked list at form top) became widely adopted. Skip links added to every page; time limits included 20-second warnings with extension buttons.
|
|
211
|
+
|
|
212
|
+
### Impact Analysis
|
|
213
|
+
|
|
214
|
+
| Principle | Impact |
|
|
215
|
+
|---|---|
|
|
216
|
+
| Keyboard access | All interactive elements keyboard accessible with logical tab order |
|
|
217
|
+
| Focus management | Traps for modals, restoration on close, management for dynamic content |
|
|
218
|
+
| ARIA specification | Custom components must have roles/states/properties |
|
|
219
|
+
| Time limits | Extension mechanisms required (WCAG 2.2.1) |
|
|
220
|
+
|
|
221
|
+
### Verification Checklist
|
|
222
|
+
|
|
223
|
+
- [ ] Is keyboard access available for all interactive elements? → logic_rules.md §Accessible Interaction Logic (Tab Order Integrity)
|
|
224
|
+
- [ ] Are focus traps and restoration applied to modals? → dependency_rules.md §Modal–Focus Dependency
|
|
225
|
+
- [ ] Are ARIA live regions applied to dynamic content? → dependency_rules.md §Accessibility–Interaction Dependency (Dynamic Content → Live Region)
|
|
226
|
+
- [ ] Are ARIA roles/states assigned to custom components? → dependency_rules.md §Accessibility–Interaction Dependency (Custom Component → ARIA Specification)
|
|
227
|
+
- [ ] Are keyboard alternatives provided for drag-and-drop? → dependency_rules.md §Accessibility–Interaction Dependency (Drag-and-Drop → Keyboard Alternative)
|
|
228
|
+
- [ ] Are extension mechanisms provided for time limits? → dependency_rules.md §Accessibility–Interaction Dependency (Time Limit → Extension Mechanism)
|
|
229
|
+
|
|
230
|
+
### Affected Files
|
|
231
|
+
|
|
232
|
+
| File | Impact | Section |
|
|
233
|
+
|---|---|---|
|
|
234
|
+
| dependency_rules.md | Modify | §Accessibility–Interaction Dependency, §Modal–Focus Dependency |
|
|
235
|
+
| logic_rules.md | Modify | §Accessible Interaction Logic |
|
|
236
|
+
| structure_spec.md | Verify | §UI Design Required Elements (Accessible Interaction) |
|
|
237
|
+
| domain_scope.md | Verify | §Normative System Classification (Tier-1a) |
|
|
238
|
+
|
|
239
|
+
---
|
|
240
|
+
|
|
241
|
+
## Case 7: Dashboard/Analytics Screen Addition
|
|
242
|
+
|
|
243
|
+
### Situation
|
|
244
|
+
|
|
245
|
+
Adding data dashboards to an existing CRUD interface with visualization patterns and per-widget state management.
|
|
246
|
+
|
|
247
|
+
### Case Study: Shopify — Analytics Dashboard (2019–2021)
|
|
248
|
+
|
|
249
|
+
Shopify added analytics dashboards to its CRUD-focused merchant admin. Each widget loaded independently with its own skeleton and error states. Responsive: desktop 2×3 grid → tablet 2×2 → mobile single-column by merchant priority. New stores saw sample data with a disclosure banner.
|
|
250
|
+
|
|
251
|
+
### Impact Analysis
|
|
252
|
+
|
|
253
|
+
| Principle | Impact |
|
|
254
|
+
|---|---|
|
|
255
|
+
| Information hierarchy | Metric priority defines dashboard layout |
|
|
256
|
+
| Chart interactions | Hover, drill-down, filter integration designed |
|
|
257
|
+
| Per-widget states | Loading/error/empty independent per widget |
|
|
258
|
+
| Responsive behavior | Chart rearrangement defined per breakpoint |
|
|
259
|
+
|
|
260
|
+
### Verification Checklist
|
|
261
|
+
|
|
262
|
+
- [ ] Is metric priority defined? → structure_spec.md §UI Design Required Elements (Data Display System)
|
|
263
|
+
- [ ] Are chart interactions designed? → logic_rules.md §Data Display Logic
|
|
264
|
+
- [ ] Are per-widget loading/error/empty states defined? → structure_spec.md §Required Relationships (Async State Completeness)
|
|
265
|
+
- [ ] Is responsive layout defined per breakpoint? → structure_spec.md §Responsive Component Transition Rules
|
|
266
|
+
- [ ] Is data freshness indicated? → dependency_rules.md §Referential Integrity (State References)
|
|
267
|
+
|
|
268
|
+
### Affected Files
|
|
269
|
+
|
|
270
|
+
| File | Impact | Section |
|
|
271
|
+
|---|---|---|
|
|
272
|
+
| structure_spec.md | Modify | §UI Design Required Elements (Data Display System), §Responsive Component Transition Rules |
|
|
273
|
+
| logic_rules.md | Verify | §Data Display Logic, §Feedback Logic (Loading State Representation) |
|
|
274
|
+
| dependency_rules.md | Verify | §Data–Display Dependency, §Referential Integrity |
|
|
275
|
+
|
|
276
|
+
---
|
|
277
|
+
|
|
278
|
+
## Case 8: Internationalization (i18n) Extension
|
|
279
|
+
|
|
280
|
+
### Situation
|
|
281
|
+
|
|
282
|
+
Extending from single-language to multi-language support with text expansion, RTL, and locale-specific formatting.
|
|
283
|
+
|
|
284
|
+
### Case Study: Spotify — Global Expansion to 60+ Markets (2018–2020)
|
|
285
|
+
|
|
286
|
+
Spotify expanded from 65 to 178 markets: Arabic (RTL), Japanese, German (+30–40% expansion). Fixed-width containers became flexible. RTL: full mirroring (sidebar, progress bars, icons) except media elements. Date/time/number formatting localized per region.
|
|
287
|
+
|
|
288
|
+
### Impact Analysis
|
|
289
|
+
|
|
290
|
+
| Principle | Impact |
|
|
291
|
+
|---|---|
|
|
292
|
+
| Text expansion | Accommodate length changes (German +30–40%, Chinese -30%) |
|
|
293
|
+
| RTL support | Layout, icons, progress indicators mirror for RTL |
|
|
294
|
+
| Format localization | Date/time/number/currency accept regional formats |
|
|
295
|
+
| Translation completeness | All user-facing text in translation scope |
|
|
296
|
+
|
|
297
|
+
### Verification Checklist
|
|
298
|
+
|
|
299
|
+
- [ ] Does layout accommodate text expansion? → structure_spec.md §Form Structure Principles (Field Width)
|
|
300
|
+
- [ ] Are layout/icons/progress mirrored for RTL? → structure_spec.md §Responsive Component Transition Rules
|
|
301
|
+
- [ ] Do fields accept regional formats? → logic_rules.md §Form Design Logic
|
|
302
|
+
- [ ] Are navigation labels contained after translation? → structure_spec.md §Navigation Structure Patterns
|
|
303
|
+
- [ ] Are all user-facing texts in translation scope? → structure_spec.md §UI Design Required Elements
|
|
304
|
+
|
|
305
|
+
### Affected Files
|
|
306
|
+
|
|
307
|
+
| File | Impact | Section |
|
|
308
|
+
|---|---|---|
|
|
309
|
+
| structure_spec.md | Modify | §Form Structure Principles, §Navigation Structure Patterns |
|
|
310
|
+
| logic_rules.md | Verify | §Navigation Logic (Label Clarity) |
|
|
311
|
+
| domain_scope.md | Verify | §Bias Detection Criteria (internationalization absence) |
|
|
312
|
+
|
|
313
|
+
---
|
|
314
|
+
|
|
315
|
+
## Case 9: Design System Adoption/Migration
|
|
316
|
+
|
|
317
|
+
### Situation
|
|
318
|
+
|
|
319
|
+
Migrating from ad-hoc components to a formalized design system, or between design systems.
|
|
320
|
+
|
|
321
|
+
### Case Study: Salesforce — Lightning Design System (2015–2018)
|
|
322
|
+
|
|
323
|
+
Salesforce migrated 200+ screens from Classic UI (23 button styles, 7 modal implementations) to SLDS with 80+ design tokens. Strategy: audit → compatibility layers → screen-by-screen migration with A/B testing → 12-month sunset. "Lightning Ready" badges marked migrated pages. Adoption enforced via automated linting.
|
|
324
|
+
|
|
325
|
+
### Impact Analysis
|
|
326
|
+
|
|
327
|
+
| Principle | Impact |
|
|
328
|
+
|---|---|
|
|
329
|
+
| Component audit | Inventory and map existing patterns to design system equivalents |
|
|
330
|
+
| Token standardization | Replace ad-hoc values with design tokens |
|
|
331
|
+
| Migration coexistence | Old and new patterns coexist without confusing users |
|
|
332
|
+
| Governance | Contribution model, versioning, adoption enforcement defined |
|
|
333
|
+
|
|
334
|
+
### Verification Checklist
|
|
335
|
+
|
|
336
|
+
- [ ] Is a component audit mapping to design system equivalents complete? → dependency_rules.md §Referential Integrity (Component–Design System References)
|
|
337
|
+
- [ ] Are design tokens the single source of truth? → domain_scope.md §Key Sub-Areas > Design System Architecture (Token System)
|
|
338
|
+
- [ ] Is a migration strategy with coexistence defined? → structure_spec.md §UI Design Required Elements
|
|
339
|
+
- [ ] Are deprecated patterns documented with timelines? → domain_scope.md §Key Sub-Areas > Design System Architecture (Governance)
|
|
340
|
+
- [ ] Is adoption enforced via tooling? → domain_scope.md §Normative System Classification (Tier-2 enforcement)
|
|
341
|
+
- [ ] Are accessibility requirements preserved during migration? → domain_scope.md §Normative System Classification (Tier-1a overrides Tier-2)
|
|
342
|
+
|
|
343
|
+
### Affected Files
|
|
344
|
+
|
|
345
|
+
| File | Impact | Section |
|
|
346
|
+
|---|---|---|
|
|
347
|
+
| domain_scope.md | Modify | §Key Sub-Areas > Design System Architecture, §Normative System Classification |
|
|
348
|
+
| dependency_rules.md | Modify | §Referential Integrity, §Source of Truth Management |
|
|
349
|
+
| structure_spec.md | Verify | §Isolated Node Prohibition |
|
|
350
|
+
| logic_rules.md | Verify | §Constraint Conflict Checks (Consistency vs Contextual Appropriateness) |
|
|
351
|
+
|
|
352
|
+
---
|
|
353
|
+
|
|
354
|
+
## Case 10: Dark Mode / Theming Addition
|
|
355
|
+
|
|
356
|
+
### Situation
|
|
357
|
+
|
|
358
|
+
Adding dark mode or a theming system to a light-only interface.
|
|
359
|
+
|
|
360
|
+
### Case Study: Apple — iOS 13 System-Wide Dark Mode (2019)
|
|
361
|
+
|
|
362
|
+
Apple built dark mode on semantic colors (`systemBackground`, `label`) resolving per mode. Elevated surfaces used lighter backgrounds in dark (opposite of light-mode shadows). Contrast verified against WCAG AA in both modes. System respected `prefers-color-scheme`; transitions used cross-dissolve to avoid flashes.
|
|
363
|
+
|
|
364
|
+
### Impact Analysis
|
|
365
|
+
|
|
366
|
+
| Principle | Impact |
|
|
367
|
+
|---|---|
|
|
368
|
+
| Semantic tokens | Hardcoded colors become semantic tokens resolving per theme |
|
|
369
|
+
| Contrast ratios | WCAG AA maintained in every theme variant |
|
|
370
|
+
| Elevation model | Light uses shadows, dark uses surface brightness |
|
|
371
|
+
| User preference | Persist and respect system-level settings |
|
|
372
|
+
|
|
373
|
+
### Verification Checklist
|
|
374
|
+
|
|
375
|
+
- [ ] Are all colors expressed as semantic tokens? → domain_scope.md §Key Sub-Areas > Design System Architecture (Token System)
|
|
376
|
+
- [ ] Do all variants maintain WCAG AA contrast? → domain_scope.md §Normative System Classification (Tier-1a)
|
|
377
|
+
- [ ] Does the system respect `prefers-color-scheme`? → dependency_rules.md §Source of Truth Management (External Source of Truth)
|
|
378
|
+
- [ ] Is mode transition smooth without flash? → domain_scope.md §Key Sub-Areas > Micro-interaction & Animation (Transition Design)
|
|
379
|
+
|
|
380
|
+
### Affected Files
|
|
381
|
+
|
|
382
|
+
| File | Impact | Section |
|
|
383
|
+
|---|---|---|
|
|
384
|
+
| domain_scope.md | Modify | §Key Sub-Areas > Design System Architecture, §Key Sub-Areas > Micro-interaction & Animation |
|
|
385
|
+
| dependency_rules.md | Verify | §Source of Truth Management |
|
|
386
|
+
| logic_rules.md | Verify | §Constraint Conflict Checks (Accessibility vs Visual Simplicity) |
|
|
387
|
+
|
|
388
|
+
---
|
|
389
|
+
|
|
390
|
+
## Case 11: Navigation Simplification (Menu Consolidation/Removal)
|
|
391
|
+
|
|
392
|
+
### Situation
|
|
393
|
+
|
|
394
|
+
Reducing top-level navigation by consolidating or removing sections. A shrinkage trigger.
|
|
395
|
+
|
|
396
|
+
### Case Study: Google — Gmail Navigation Consolidation (2022)
|
|
397
|
+
|
|
398
|
+
Google consolidated Gmail's separate Mail/Chat/Spaces/Meet navigation into a unified sidebar. Chat and Spaces merged; Meet reduced to an icon; Labs features moved to a side panel. Mitigation: reorientation tooltip, redirects from old URLs, settings to restore layout choices.
|
|
399
|
+
|
|
400
|
+
### Impact Analysis
|
|
401
|
+
|
|
402
|
+
| Principle | Impact |
|
|
403
|
+
|---|---|
|
|
404
|
+
| Navigation reduction | Removed items must not leave users stranded |
|
|
405
|
+
| URL integrity | Old URLs redirect, not 404 |
|
|
406
|
+
| User reorientation | Established workflows need migration guidance |
|
|
407
|
+
| Secondary navigation | Breadcrumbs, sitemaps, footer links update synchronously |
|
|
408
|
+
|
|
409
|
+
### Verification Checklist
|
|
410
|
+
|
|
411
|
+
- [ ] Are all functions still reachable through the new structure? → logic_rules.md §Navigation Logic (Wayfinding Completeness)
|
|
412
|
+
- [ ] Are old URLs redirected? → dependency_rules.md §Referential Integrity (Navigation–URL References)
|
|
413
|
+
- [ ] Are secondary navigation elements updated? → dependency_rules.md §Information Architecture–Navigation Dependency (Navigation Change → Secondary Navigation Update)
|
|
414
|
+
- [ ] Is reorientation guidance provided? → logic_rules.md §Action Guidance Logic (Progressive Disclosure of Guidance)
|
|
415
|
+
- [ ] Are search scope categories updated? → dependency_rules.md §Information Architecture–Navigation Dependency (IA → Search)
|
|
416
|
+
|
|
417
|
+
### Affected Files
|
|
418
|
+
|
|
419
|
+
| File | Impact | Section |
|
|
420
|
+
|---|---|---|
|
|
421
|
+
| structure_spec.md | Modify | §Navigation Structure Patterns |
|
|
422
|
+
| dependency_rules.md | Modify | §Information Architecture–Navigation Dependency, §Referential Integrity |
|
|
423
|
+
| logic_rules.md | Verify | §Navigation Logic |
|
|
424
|
+
|
|
425
|
+
---
|
|
426
|
+
|
|
427
|
+
## Case 12: Component Consolidation/Retirement
|
|
428
|
+
|
|
429
|
+
### Situation
|
|
430
|
+
|
|
431
|
+
Retiring legacy patterns and consolidating multiple implementations into a single approved component.
|
|
432
|
+
|
|
433
|
+
### Case Study: Atlassian — Atlaskit Consolidation (2020–2022)
|
|
434
|
+
|
|
435
|
+
Atlassian's products had 5 date pickers, 4 modals, 3 dropdowns with different behavior. Consolidation: cross-product audit → canonical version → 6–12 month deprecation → migration guides → lint rules. The canonical date picker unified Jira/Confluence/Bitbucket use cases via configuration API. Zero-usage components removed; others got "legacy" with console warnings.
|
|
436
|
+
|
|
437
|
+
### Impact Analysis
|
|
438
|
+
|
|
439
|
+
| Principle | Impact |
|
|
440
|
+
|---|---|
|
|
441
|
+
| Component audit | All legacy instances identified across the product |
|
|
442
|
+
| Canonical selection | One implementation covers all use cases it replaces |
|
|
443
|
+
| Migration path | Deprecated components need documentation |
|
|
444
|
+
| Deprecation enforcement | Tooling (lint, warnings) enforces migration |
|
|
445
|
+
|
|
446
|
+
### Verification Checklist
|
|
447
|
+
|
|
448
|
+
- [ ] Are all legacy pattern instances identified? → dependency_rules.md §Referential Integrity (Component–Design System References)
|
|
449
|
+
- [ ] Does the canonical component cover all use cases? → structure_spec.md §UI Design Required Elements
|
|
450
|
+
- [ ] Is deprecation timeline defined with documentation? → domain_scope.md §Key Sub-Areas > Design System Architecture (Governance)
|
|
451
|
+
- [ ] Is enforcement automated? → domain_scope.md §Normative System Classification (Tier-2 enforcement)
|
|
452
|
+
- [ ] Is accessibility preserved or improved? → logic_rules.md §Accessible Interaction Logic (Native HTML Preference)
|
|
453
|
+
- [ ] Are deprecated components eventually removed? → structure_spec.md §Isolated Node Prohibition
|
|
454
|
+
|
|
455
|
+
### Affected Files
|
|
456
|
+
|
|
457
|
+
| File | Impact | Section |
|
|
458
|
+
|---|---|---|
|
|
459
|
+
| dependency_rules.md | Modify | §Referential Integrity, §Source of Truth Management |
|
|
460
|
+
| structure_spec.md | Verify | §Isolated Node Prohibition |
|
|
461
|
+
| domain_scope.md | Verify | §Key Sub-Areas > Design System Architecture (Governance) |
|
|
462
|
+
|
|
463
|
+
---
|
|
464
|
+
|
|
465
|
+
## Case 13: Platform Support Discontinuation
|
|
466
|
+
|
|
467
|
+
### Situation
|
|
468
|
+
|
|
469
|
+
Dropping support for a platform, browser, or device category. Removes constraints and enables new patterns.
|
|
470
|
+
|
|
471
|
+
### Case Study: Microsoft — Dropping IE 11 for Microsoft 365 (2021)
|
|
472
|
+
|
|
473
|
+
IE 11 blocked CSS Grid, Custom Properties, and `IntersectionObserver`, adding 50KB+ polyfills. After dropping: Teams adopted CSS Grid, Outlook enabled theming via Custom Properties, polyfills removed. Migration: 6-month notice, IE-specific banner, degraded read-only in the final month.
|
|
474
|
+
|
|
475
|
+
### Impact Analysis
|
|
476
|
+
|
|
477
|
+
| Principle | Impact |
|
|
478
|
+
|---|---|
|
|
479
|
+
| Constraint removal | Enables previously blocked modern patterns |
|
|
480
|
+
| User notification | Advance notice and migration path required |
|
|
481
|
+
| Pattern enablement | Previously impossible patterns available |
|
|
482
|
+
| Dead code removal | Platform-specific workarounds cleaned up |
|
|
483
|
+
|
|
484
|
+
### Verification Checklist
|
|
485
|
+
|
|
486
|
+
- [ ] Are users notified with timeline and migration path? → logic_rules.md §Feedback Logic (Feedback Duration by Urgency)
|
|
487
|
+
- [ ] Are platform-specific workarounds removed? → structure_spec.md §Isolated Node Prohibition
|
|
488
|
+
- [ ] Are newly enabled patterns evaluated? → domain_scope.md §Key Sub-Areas > Design System Architecture
|
|
489
|
+
- [ ] Is support documentation updated? → domain_scope.md §Reference Standards/Frameworks
|
|
490
|
+
|
|
491
|
+
### Affected Files
|
|
492
|
+
|
|
493
|
+
| File | Impact | Section |
|
|
494
|
+
|---|---|---|
|
|
495
|
+
| structure_spec.md | Modify | §Responsive Component Transition Rules, §Isolated Node Prohibition |
|
|
496
|
+
| domain_scope.md | Verify | §Reference Standards/Frameworks |
|
|
497
|
+
| logic_rules.md | Verify | §Feedback Logic |
|
|
498
|
+
|
|
499
|
+
---
|
|
500
|
+
|
|
501
|
+
## Case 14: Feature Simplification (Power User → General User Pivot)
|
|
502
|
+
|
|
503
|
+
### Situation
|
|
504
|
+
|
|
505
|
+
Simplifying a feature-rich interface for a broader audience by reducing complexity and restructuring information density.
|
|
506
|
+
|
|
507
|
+
### Case Study: Microsoft — Simplified Ribbon for Office 365 (2018–2020)
|
|
508
|
+
|
|
509
|
+
Telemetry showed 80% of users used <20% of Ribbon commands (50+ buttons, 7+ tabs). Simplified Ribbon: 10–15 commands in one row, "..." overflow, toggle to restore classic. Context-sensitive: selecting text showed formatting; selecting an image showed image tools.
|
|
510
|
+
|
|
511
|
+
### Impact Analysis
|
|
512
|
+
|
|
513
|
+
| Principle | Impact |
|
|
514
|
+
|---|---|
|
|
515
|
+
| Feature prioritization | Classify by usage frequency for visibility decisions |
|
|
516
|
+
| Progressive disclosure | Advanced features accessible but not prominent |
|
|
517
|
+
| Default experience | Optimize for the majority user |
|
|
518
|
+
| Reversibility | Power users can restore the full view |
|
|
519
|
+
|
|
520
|
+
### Verification Checklist
|
|
521
|
+
|
|
522
|
+
- [ ] Are features classified by usage frequency? → logic_rules.md §Constraint Conflict Checks (Simplicity vs Discoverability)
|
|
523
|
+
- [ ] Is progressive disclosure used for non-core features? → logic_rules.md §Action Guidance Logic (Progressive Disclosure of Guidance)
|
|
524
|
+
- [ ] Does the default optimize for the majority? → logic_rules.md §Constraint Conflict Checks (Information Density vs Cognitive Load)
|
|
525
|
+
- [ ] Can power users restore the full view? → structure_spec.md §UI Design Required Elements (Action Guidance System)
|
|
526
|
+
- [ ] Are hidden features still discoverable? → logic_rules.md §Constraint Conflict Checks (Simplicity vs Discoverability)
|
|
527
|
+
- [ ] Is wayfinding completeness maintained? → logic_rules.md §Navigation Logic (Wayfinding Completeness)
|
|
528
|
+
|
|
529
|
+
### Affected Files
|
|
530
|
+
|
|
531
|
+
| File | Impact | Section |
|
|
532
|
+
|---|---|---|
|
|
533
|
+
| logic_rules.md | Modify | §Constraint Conflict Checks |
|
|
534
|
+
| structure_spec.md | Verify | §UI Design Required Elements, §Navigation Structure Patterns |
|
|
535
|
+
| dependency_rules.md | Verify | §Information Architecture–Navigation Dependency |
|
|
536
|
+
|
|
537
|
+
---
|
|
538
|
+
|
|
539
|
+
## Scenario Interconnections
|
|
540
|
+
|
|
541
|
+
| Scenario | Triggers / Interacts With | Reason |
|
|
542
|
+
|---|---|---|
|
|
543
|
+
| Case 1 (Feature Addition) | → Case 9 (Design System) | New features may require new design system components |
|
|
544
|
+
| Case 2 (Mobile Launch) | → Case 6 (Accessibility) | Mobile introduces touch accessibility requirements |
|
|
545
|
+
| Case 2 (Mobile Launch) | → Case 8 (i18n) | Global mobile launches often coincide with i18n |
|
|
546
|
+
| Case 3 (User Diversification) | → Case 14 (Simplification) | Adding general users often requires simplifying the power-user UI |
|
|
547
|
+
| Case 4 (Complex Forms) | → Case 6 (Accessibility) | Complex forms have the highest accessibility failure rate |
|
|
548
|
+
| Case 5 (Collaboration) | → Case 1 (Feature Addition) | Collaboration is itself a large feature addition |
|
|
549
|
+
| Case 7 (Dashboard) | → Case 2 (Mobile) | Dashboards need responsive strategies different from forms |
|
|
550
|
+
| Case 8 (i18n) | → Case 10 (Theming) | RTL and theming share token architecture concerns |
|
|
551
|
+
| Case 9 (Design System) | → Case 12 (Consolidation) | Adoption necessitates retiring legacy components |
|
|
552
|
+
| Case 10 (Theming) | → Case 9 (Design System) | Theming requires a token-based design system |
|
|
553
|
+
| Case 11 (Nav Simplification) | → Case 14 (Simplification) | Nav simplification is often part of broader simplification |
|
|
554
|
+
| Case 13 (Platform Drop) | → Case 10 (Theming) | Dropping old browsers enables CSS Custom Properties |
|
|
555
|
+
| Case 14 (Simplification) | → Case 11 (Nav Simplification) | Feature simplification often includes navigation reduction |
|
|
556
|
+
|
|
557
|
+
---
|
|
558
|
+
|
|
559
|
+
## Related Documents
|
|
560
|
+
- structure_spec.md — Navigation structure, screen state matrix, responsive transitions, required relationships, form structure, isolated node prohibition
|
|
561
|
+
- dependency_rules.md — IA–navigation, action–feedback, form–validation, modal–focus, responsive–component, accessibility–interaction dependencies, referential integrity, source of truth
|
|
562
|
+
- logic_rules.md — Navigation/form/feedback/modal/action/data display/accessibility logic, constraint conflict checks
|
|
563
|
+
- domain_scope.md — Key sub-areas, normative system classification, reference standards, cross-cutting concerns, bias detection
|