phasegate 0.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +107 -0
- package/LICENSE +215 -0
- package/README.ja.md +888 -0
- package/README.md +254 -0
- package/bin/harness +18 -0
- package/docs/ADR/ADR-001-four-layer-defense-model.md +34 -0
- package/docs/ADR/ADR-002-pre-commit-validators.md +35 -0
- package/docs/ADR/ADR-003-ci-validators.md +36 -0
- package/docs/ADR/ADR-004-scheduled-validators.md +35 -0
- package/docs/ADR/ADR-005-hexagonal-architecture.md +39 -0
- package/docs/ADR/ADR-006-agent-independence.md +34 -0
- package/docs/ADR/ADR-007-harness-config-single-source.md +39 -0
- package/docs/ADR/ADR-008-quick-mode.md +46 -0
- package/docs/ADR/ADR-009-ddd-tactical-patterns.md +40 -0
- package/docs/ADR/ADR-010-harness-error-fix-example.md +42 -0
- package/docs/ADR/ADR-011-archgate-pattern.md +62 -0
- package/docs/ADR/ADR-012-two-phase-execution.md +38 -0
- package/docs/guide/cli-reference.md +122 -0
- package/docs/guide/configuration.md +199 -0
- package/docs/guide/hooks-integration.md +105 -0
- package/docs/guide/installation.md +84 -0
- package/docs/guide/layer-model.md +170 -0
- package/docs/guide/skills-overview.md +107 -0
- package/docs/principles/architecture-philosophy.md +64 -0
- package/docs/principles/model-routing.md +176 -0
- package/docs/principles/testing-rules.md +670 -0
- package/package.json +72 -0
- package/scripts/harness/adr-foundation/application/dto/adr-detail-dto.ts +30 -0
- package/scripts/harness/adr-foundation/application/dto/adr-list-item-dto.ts +12 -0
- package/scripts/harness/adr-foundation/application/dto/adr-list-summary-dto.ts +11 -0
- package/scripts/harness/adr-foundation/application/dto/adr-template-dto.ts +21 -0
- package/scripts/harness/adr-foundation/application/dto/adr-validation-result-dto.ts +27 -0
- package/scripts/harness/adr-foundation/application/dto/application-errors.ts +59 -0
- package/scripts/harness/adr-foundation/application/dto/archgate-search-result-dto.ts +11 -0
- package/scripts/harness/adr-foundation/application/dto/change-adr-status-command.ts +9 -0
- package/scripts/harness/adr-foundation/application/dto/seed-adr-definition.ts +21 -0
- package/scripts/harness/adr-foundation/application/mappers/adr-to-detail-dto-mapper.ts +41 -0
- package/scripts/harness/adr-foundation/application/mappers/adr-to-list-item-dto-mapper.ts +19 -0
- package/scripts/harness/adr-foundation/application/mappers/adr-validation-to-harness-error-mapper.ts +31 -0
- package/scripts/harness/adr-foundation/application/usecases/change-adr-status-use-case.ts +67 -0
- package/scripts/harness/adr-foundation/application/usecases/create-adr-template-use-case.ts +97 -0
- package/scripts/harness/adr-foundation/application/usecases/get-adr-by-ref-use-case.ts +26 -0
- package/scripts/harness/adr-foundation/application/usecases/list-adrs-use-case.ts +39 -0
- package/scripts/harness/adr-foundation/application/usecases/search-archgate-mappings-use-case.ts +55 -0
- package/scripts/harness/adr-foundation/application/usecases/seed-initial-adrs-use-case.ts +84 -0
- package/scripts/harness/adr-foundation/application/usecases/validate-adr-frontmatter-use-case.ts +86 -0
- package/scripts/harness/adr-foundation/application/usecases/validate-all-adrs-use-case.ts +47 -0
- package/scripts/harness/adr-foundation/composition-root.ts +47 -0
- package/scripts/harness/adr-foundation/domain/aggregates/adr.ts +177 -0
- package/scripts/harness/adr-foundation/domain/ports/adr-document-parser-port.ts +11 -0
- package/scripts/harness/adr-foundation/domain/ports/adr-frontmatter-parser-port.ts +6 -0
- package/scripts/harness/adr-foundation/domain/ports/adr-repository-port.ts +15 -0
- package/scripts/harness/adr-foundation/domain/services/adr-validation-service.ts +27 -0
- package/scripts/harness/adr-foundation/domain/value-objects/adr-body.ts +90 -0
- package/scripts/harness/adr-foundation/domain/value-objects/adr-file-path.ts +60 -0
- package/scripts/harness/adr-foundation/domain/value-objects/adr-frontmatter.ts +236 -0
- package/scripts/harness/adr-foundation/domain/value-objects/adr-id.ts +57 -0
- package/scripts/harness/adr-foundation/domain/value-objects/adr-status.ts +65 -0
- package/scripts/harness/adr-foundation/domain/value-objects/archgate-entry.ts +69 -0
- package/scripts/harness/adr-foundation/domain/value-objects/archgate-mapping.ts +94 -0
- package/scripts/harness/adr-foundation/domain/value-objects/superseded-by-ref.ts +26 -0
- package/scripts/harness/adr-foundation/index.ts +13 -0
- package/scripts/harness/adr-foundation/infrastructure/parsers/adr-markdown-document-parser.ts +121 -0
- package/scripts/harness/adr-foundation/infrastructure/parsers/regex-adr-frontmatter-parser.ts +147 -0
- package/scripts/harness/adr-foundation/infrastructure/repositories/file-system-adr-repository.ts +115 -0
- package/scripts/harness/adr-foundation/infrastructure/seeds/initial-adr-definitions.ts +161 -0
- package/scripts/harness/adr-foundation/infrastructure/serializers/adr-markdown-serializer.ts +41 -0
- package/scripts/harness/adr-foundation/presentation/cli/list-adrs-command-handler.ts +78 -0
- package/scripts/harness/adr-foundation/presentation/cli/validate-adr-command-handler.ts +113 -0
- package/scripts/harness/agent-integration/application/dto/handle-post-tool-use-dto.ts +24 -0
- package/scripts/harness/agent-integration/application/dto/handle-pre-tool-use-dto.ts +18 -0
- package/scripts/harness/agent-integration/application/dto/handle-stop-dto.ts +17 -0
- package/scripts/harness/agent-integration/application/dto/verify-fallback-capability-dto.ts +18 -0
- package/scripts/harness/agent-integration/application/usecases/handle-post-tool-use-usecase.ts +72 -0
- package/scripts/harness/agent-integration/application/usecases/handle-pre-tool-use-usecase.ts +164 -0
- package/scripts/harness/agent-integration/application/usecases/handle-stop-usecase.ts +81 -0
- package/scripts/harness/agent-integration/application/usecases/verify-fallback-capability-usecase.ts +52 -0
- package/scripts/harness/agent-integration/domain/entities/reentry-guard.ts +34 -0
- package/scripts/harness/agent-integration/domain/errors/project-paths-invariant-error.ts +10 -0
- package/scripts/harness/agent-integration/domain/errors/write-target-scope-invariant-error.ts +10 -0
- package/scripts/harness/agent-integration/domain/ports/cli-command-registry-port.ts +9 -0
- package/scripts/harness/agent-integration/domain/ports/config-query-port.ts +12 -0
- package/scripts/harness/agent-integration/domain/ports/import-analyzer-port.ts +13 -0
- package/scripts/harness/agent-integration/domain/ports/phase-gate-query-port.ts +9 -0
- package/scripts/harness/agent-integration/domain/ports/reentry-guard-state-port.ts +10 -0
- package/scripts/harness/agent-integration/domain/services/fallback-verification-service.ts +142 -0
- package/scripts/harness/agent-integration/domain/services/hook-to-cli-translator.ts +300 -0
- package/scripts/harness/agent-integration/domain/types/phase-gate-level.ts +4 -0
- package/scripts/harness/agent-integration/domain/value-objects/fallback-capability-spec.ts +53 -0
- package/scripts/harness/agent-integration/domain/value-objects/hook-event.ts +134 -0
- package/scripts/harness/agent-integration/domain/value-objects/hook-translation-result.ts +128 -0
- package/scripts/harness/agent-integration/domain/value-objects/phase-gate-query-result.ts +67 -0
- package/scripts/harness/agent-integration/domain/value-objects/project-paths.ts +53 -0
- package/scripts/harness/agent-integration/domain/value-objects/protected-file-list.ts +89 -0
- package/scripts/harness/agent-integration/domain/value-objects/write-target-scope.ts +148 -0
- package/scripts/harness/agent-integration/index.ts +42 -0
- package/scripts/harness/agent-integration/infrastructure/adapters/child-process-cli-executor-adapter.ts +92 -0
- package/scripts/harness/agent-integration/infrastructure/adapters/env-file-reentry-guard-state-adapter.ts +67 -0
- package/scripts/harness/agent-integration/infrastructure/adapters/harness-api-cli-command-registry-adapter.ts +35 -0
- package/scripts/harness/agent-integration/infrastructure/adapters/harness-config-config-query-adapter.ts +92 -0
- package/scripts/harness/agent-integration/infrastructure/adapters/phase-gate-query-adapter.ts +32 -0
- package/scripts/harness/agent-integration/infrastructure/adapters/regex-import-analyzer-adapter.ts +69 -0
- package/scripts/harness/agent-integration/infrastructure/ports/cli-executor-port.ts +29 -0
- package/scripts/harness/agent-integration/presentation/post-tool-use-hook.ts +104 -0
- package/scripts/harness/agent-integration/presentation/pre-tool-use-hook.ts +119 -0
- package/scripts/harness/agent-integration/presentation/stop-hook.ts +106 -0
- package/scripts/harness/biome-ast-engine/application/dto/analyze-import-graph-input.ts +8 -0
- package/scripts/harness/biome-ast-engine/application/dto/analyze-import-graph-output.ts +14 -0
- package/scripts/harness/biome-ast-engine/application/dto/build-harness-error-payload-input.ts +10 -0
- package/scripts/harness/biome-ast-engine/application/dto/build-harness-error-payload-output.ts +17 -0
- package/scripts/harness/biome-ast-engine/application/dto/execute-lint-input.ts +9 -0
- package/scripts/harness/biome-ast-engine/application/dto/execute-lint-output.ts +12 -0
- package/scripts/harness/biome-ast-engine/application/dto/register-rule-catalog-output.ts +10 -0
- package/scripts/harness/biome-ast-engine/application/dto/resolve-enabled-rules-input.ts +8 -0
- package/scripts/harness/biome-ast-engine/application/dto/resolve-enabled-rules-output.ts +12 -0
- package/scripts/harness/biome-ast-engine/application/dto/verify-eslint-removal-input.ts +8 -0
- package/scripts/harness/biome-ast-engine/application/dto/verify-eslint-removal-output.ts +10 -0
- package/scripts/harness/biome-ast-engine/application/mappers/analyze-import-graph-output-mapper.ts +20 -0
- package/scripts/harness/biome-ast-engine/application/mappers/build-harness-error-payload-output-mapper.ts +55 -0
- package/scripts/harness/biome-ast-engine/application/mappers/execute-lint-output-mapper.ts +17 -0
- package/scripts/harness/biome-ast-engine/application/mappers/register-rule-catalog-output-mapper.ts +14 -0
- package/scripts/harness/biome-ast-engine/application/mappers/resolve-enabled-rules-output-mapper.ts +17 -0
- package/scripts/harness/biome-ast-engine/application/mappers/verify-eslint-removal-output-mapper.ts +16 -0
- package/scripts/harness/biome-ast-engine/application/usecases/analyze-import-graph-usecase.ts +41 -0
- package/scripts/harness/biome-ast-engine/application/usecases/build-harness-error-payload-usecase.ts +51 -0
- package/scripts/harness/biome-ast-engine/application/usecases/execute-lint-usecase.ts +75 -0
- package/scripts/harness/biome-ast-engine/application/usecases/register-rule-catalog-usecase.ts +33 -0
- package/scripts/harness/biome-ast-engine/application/usecases/resolve-enabled-rules-usecase.ts +43 -0
- package/scripts/harness/biome-ast-engine/application/usecases/verify-eslint-removal-usecase.ts +49 -0
- package/scripts/harness/biome-ast-engine/composition-root.ts +91 -0
- package/scripts/harness/biome-ast-engine/domain/ports/biome-executor-port.ts +10 -0
- package/scripts/harness/biome-ast-engine/domain/ports/clock-port.ts +8 -0
- package/scripts/harness/biome-ast-engine/domain/ports/rule-config-provider-port.ts +11 -0
- package/scripts/harness/biome-ast-engine/domain/ports/source-module-analyzer-port.ts +11 -0
- package/scripts/harness/biome-ast-engine/domain/ports/violation-formatter-port.ts +19 -0
- package/scripts/harness/biome-ast-engine/domain/ports/workspace-file-port.ts +12 -0
- package/scripts/harness/biome-ast-engine/domain/ports/workspace-inventory-port.ts +11 -0
- package/scripts/harness/biome-ast-engine/domain/services/import-graph-builder.ts +37 -0
- package/scripts/harness/biome-ast-engine/domain/services/lint-runner.ts +266 -0
- package/scripts/harness/biome-ast-engine/domain/services/rule-definition-registry.ts +204 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/file-path.ts +101 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/import-cycle.ts +39 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/import-edge.ts +59 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/import-graph.ts +217 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/layer-boundary.ts +58 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/layer-name.ts +67 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/lint-report.ts +67 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/required-input.ts +48 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/rule-definition.ts +133 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/rule-name.ts +71 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/rule-type.ts +47 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/rule-violation.ts +118 -0
- package/scripts/harness/biome-ast-engine/domain/value-objects/source-module-snapshot.ts +133 -0
- package/scripts/harness/biome-ast-engine/index.ts +12 -0
- package/scripts/harness/biome-ast-engine/infrastructure/adapters/biome-cli-executor-adapter.ts +62 -0
- package/scripts/harness/biome-ast-engine/infrastructure/adapters/harness-config-provider-adapter.ts +38 -0
- package/scripts/harness/biome-ast-engine/infrastructure/adapters/harness-error-formatter-adapter.ts +67 -0
- package/scripts/harness/biome-ast-engine/infrastructure/adapters/node-workspace-file-adapter.ts +110 -0
- package/scripts/harness/biome-ast-engine/infrastructure/adapters/system-clock-adapter.ts +16 -0
- package/scripts/harness/biome-ast-engine/infrastructure/adapters/typescript-source-module-analyzer-adapter.ts +235 -0
- package/scripts/harness/biome-ast-engine/infrastructure/adapters/workspace-inventory-adapter.ts +98 -0
- package/scripts/harness/biome-ast-engine/infrastructure/mappers/rule-violation-code-mapper.ts +50 -0
- package/scripts/harness/biome-ast-engine/infrastructure/mappers/source-module-snapshot-mapper.ts +66 -0
- package/scripts/harness/biome-ast-engine/infrastructure/parsers/comment-density-parser.ts +109 -0
- package/scripts/harness/biome-ast-engine/infrastructure/parsers/layer-comment-parser.ts +26 -0
- package/scripts/harness/biome-ast-engine/infrastructure/parsers/unit-comment-parser.ts +26 -0
- package/scripts/harness/biome-ast-engine/presentation/cli/harness-lint-command-handler.ts +129 -0
- package/scripts/harness/biome-ast-engine/presentation/cli/lint-command-parser.ts +48 -0
- package/scripts/harness/ci-governance/application/dto/aggregate-lessons-input.ts +8 -0
- package/scripts/harness/ci-governance/application/dto/aggregate-lessons-output.ts +10 -0
- package/scripts/harness/ci-governance/application/dto/check-escalation-input.ts +8 -0
- package/scripts/harness/ci-governance/application/dto/check-escalation-output.ts +10 -0
- package/scripts/harness/ci-governance/application/dto/generate-ci-template-input.ts +11 -0
- package/scripts/harness/ci-governance/application/dto/generate-ci-template-output.ts +16 -0
- package/scripts/harness/ci-governance/application/dto/migrate-agents-md-input.ts +8 -0
- package/scripts/harness/ci-governance/application/dto/migrate-agents-md-output.ts +13 -0
- package/scripts/harness/ci-governance/application/dto/record-error-occurrence-input.ts +9 -0
- package/scripts/harness/ci-governance/application/dto/record-error-occurrence-output.ts +10 -0
- package/scripts/harness/ci-governance/application/dto/render-ci-template-input.ts +11 -0
- package/scripts/harness/ci-governance/application/dto/render-ci-template-output.ts +10 -0
- package/scripts/harness/ci-governance/application/dto/reset-repetition-input.ts +9 -0
- package/scripts/harness/ci-governance/application/dto/reset-repetition-output.ts +9 -0
- package/scripts/harness/ci-governance/application/dto/validate-pointers-input.ts +8 -0
- package/scripts/harness/ci-governance/application/dto/validate-pointers-output.ts +13 -0
- package/scripts/harness/ci-governance/application/usecases/aggregate-lessons-usecase.ts +52 -0
- package/scripts/harness/ci-governance/application/usecases/check-escalation-usecase.ts +34 -0
- package/scripts/harness/ci-governance/application/usecases/generate-ci-template-usecase.ts +60 -0
- package/scripts/harness/ci-governance/application/usecases/migrate-agents-md-usecase.ts +94 -0
- package/scripts/harness/ci-governance/application/usecases/record-error-occurrence-usecase.ts +42 -0
- package/scripts/harness/ci-governance/application/usecases/render-ci-template-usecase.ts +62 -0
- package/scripts/harness/ci-governance/application/usecases/reset-repetition-usecase.ts +64 -0
- package/scripts/harness/ci-governance/application/usecases/validate-pointers-usecase.ts +62 -0
- package/scripts/harness/ci-governance/composition-root.ts +100 -0
- package/scripts/harness/ci-governance/domain/aggregates/agents-md-pointer.ts +96 -0
- package/scripts/harness/ci-governance/domain/aggregates/ci-template.ts +75 -0
- package/scripts/harness/ci-governance/domain/aggregates/error-repetition.ts +138 -0
- package/scripts/harness/ci-governance/domain/errors/ci-governance-domain-error.ts +16 -0
- package/scripts/harness/ci-governance/domain/ports/adr-existence-port.ts +8 -0
- package/scripts/harness/ci-governance/domain/ports/agents-md-port.ts +16 -0
- package/scripts/harness/ci-governance/domain/ports/command-existence-port.ts +8 -0
- package/scripts/harness/ci-governance/domain/ports/error-repetition-repository-port.ts +11 -0
- package/scripts/harness/ci-governance/domain/ports/escalation-executor-port.ts +10 -0
- package/scripts/harness/ci-governance/domain/ports/file-existence-port.ts +8 -0
- package/scripts/harness/ci-governance/domain/ports/lesson-artifact-reader-port.ts +11 -0
- package/scripts/harness/ci-governance/domain/ports/preset-config-port.ts +12 -0
- package/scripts/harness/ci-governance/domain/ports/template-renderer-port.ts +15 -0
- package/scripts/harness/ci-governance/domain/ports/validator-id-registry-port.ts +8 -0
- package/scripts/harness/ci-governance/domain/result.ts +58 -0
- package/scripts/harness/ci-governance/domain/services/lesson-aggregator.ts +46 -0
- package/scripts/harness/ci-governance/domain/services/pointer-validator.ts +71 -0
- package/scripts/harness/ci-governance/domain/services/repetition-detector.ts +51 -0
- package/scripts/harness/ci-governance/domain/services/template-generator.ts +67 -0
- package/scripts/harness/ci-governance/domain/types/escalation-log-level.ts +17 -0
- package/scripts/harness/ci-governance/domain/types/lesson-artifact.ts +25 -0
- package/scripts/harness/ci-governance/domain/types/lesson-category.ts +8 -0
- package/scripts/harness/ci-governance/domain/types/pointer-type.ts +24 -0
- package/scripts/harness/ci-governance/domain/types/template-type.ts +18 -0
- package/scripts/harness/ci-governance/domain/types/trigger-condition.ts +18 -0
- package/scripts/harness/ci-governance/domain/value-objects/escalation-action.ts +44 -0
- package/scripts/harness/ci-governance/domain/value-objects/pointer-entry.ts +80 -0
- package/scripts/harness/ci-governance/domain/value-objects/repetition-reset-condition.ts +30 -0
- package/scripts/harness/ci-governance/domain/value-objects/template-config.ts +46 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/adr-foundation-existence-adapter.ts +16 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/agents-md-file-adapter.ts +109 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/error-repetition-json-repository.ts +73 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/escalation-log-executor-adapter.ts +20 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/file-system-existence-adapter.ts +26 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/harness-api-command-existence-adapter.ts +20 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/lesson-artifact-file-reader-adapter.ts +48 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/preset-config-adapter.ts +24 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/validator-id-registry-adapter.ts +18 -0
- package/scripts/harness/ci-governance/infrastructure/adapters/yaml-template-renderer-adapter.ts +53 -0
- package/scripts/harness/ci-governance/infrastructure/schema/error-history-schema.ts +18 -0
- package/scripts/harness/ci-governance/presentation/dto/ci-governance-render-options.ts +9 -0
- package/scripts/harness/ci-governance/presentation/formatters/ci-template-formatter.ts +32 -0
- package/scripts/harness/ci-governance/presentation/formatters/error-repetition-formatter.ts +26 -0
- package/scripts/harness/ci-governance/presentation/handlers/check-repetition-handler.ts +68 -0
- package/scripts/harness/ci-governance/presentation/handlers/generate-ci-template-handler.ts +51 -0
- package/scripts/harness/ci-governance/presentation/handlers/migrate-agents-md-handler.ts +68 -0
- package/scripts/harness/config-foundation/application/dto/available-feature-item.ts +8 -0
- package/scripts/harness/config-foundation/application/dto/feature-toggle-result.ts +9 -0
- package/scripts/harness/config-foundation/application/dto/resolved-config-output.ts +10 -0
- package/scripts/harness/config-foundation/application/dto/validate-config-result.ts +10 -0
- package/scripts/harness/config-foundation/application/facades/load-config-facade.ts +28 -0
- package/scripts/harness/config-foundation/application/usecases/disable-feature-use-case.ts +71 -0
- package/scripts/harness/config-foundation/application/usecases/enable-feature-use-case.ts +71 -0
- package/scripts/harness/config-foundation/application/usecases/list-available-features-use-case.ts +61 -0
- package/scripts/harness/config-foundation/application/usecases/load-resolved-config-use-case.ts +131 -0
- package/scripts/harness/config-foundation/application/usecases/validate-config-use-case.ts +98 -0
- package/scripts/harness/config-foundation/composition-root.ts +76 -0
- package/scripts/harness/config-foundation/domain/errors/config-foundation-domain-error.ts +16 -0
- package/scripts/harness/config-foundation/domain/errors/config-validation-error.ts +14 -0
- package/scripts/harness/config-foundation/domain/errors/invalid-harnesses-config-error.ts +14 -0
- package/scripts/harness/config-foundation/domain/errors/invalid-preset-error.ts +17 -0
- package/scripts/harness/config-foundation/domain/errors/unsupported-feature-error.ts +14 -0
- package/scripts/harness/config-foundation/domain/harness-config.ts +373 -0
- package/scripts/harness/config-foundation/domain/ports/config-repository-port.ts +8 -0
- package/scripts/harness/config-foundation/domain/ports/config-schema-validator-port.ts +9 -0
- package/scripts/harness/config-foundation/domain/ports/feature-registry-port.ts +7 -0
- package/scripts/harness/config-foundation/domain/services/feature-registry.ts +42 -0
- package/scripts/harness/config-foundation/domain/services/preset-resolution-service.ts +197 -0
- package/scripts/harness/config-foundation/domain/value-objects/custom-phase-rule.ts +42 -0
- package/scripts/harness/config-foundation/domain/value-objects/feature-name.ts +39 -0
- package/scripts/harness/config-foundation/domain/value-objects/feature-toggle.ts +34 -0
- package/scripts/harness/config-foundation/domain/value-objects/harnesses-config.ts +113 -0
- package/scripts/harness/config-foundation/domain/value-objects/l1-config.ts +57 -0
- package/scripts/harness/config-foundation/domain/value-objects/l2-config.ts +46 -0
- package/scripts/harness/config-foundation/domain/value-objects/l3-config.ts +64 -0
- package/scripts/harness/config-foundation/domain/value-objects/l4-config.ts +55 -0
- package/scripts/harness/config-foundation/domain/value-objects/layers-config.ts +86 -0
- package/scripts/harness/config-foundation/domain/value-objects/paths-config.ts +50 -0
- package/scripts/harness/config-foundation/domain/value-objects/phase-dependencies-config.ts +46 -0
- package/scripts/harness/config-foundation/domain/value-objects/planning-mode-config.ts +65 -0
- package/scripts/harness/config-foundation/domain/value-objects/preset.ts +42 -0
- package/scripts/harness/config-foundation/domain/value-objects/project-config.ts +44 -0
- package/scripts/harness/config-foundation/domain/value-objects/quick-mode-config.ts +64 -0
- package/scripts/harness/config-foundation/domain/value-objects/reporting-config.ts +40 -0
- package/scripts/harness/config-foundation/index.ts +26 -0
- package/scripts/harness/config-foundation/infrastructure/preset-definition-store.ts +28 -0
- package/scripts/harness/config-foundation/infrastructure/presets/minimal.json +50 -0
- package/scripts/harness/config-foundation/infrastructure/presets/standard.json +50 -0
- package/scripts/harness/config-foundation/infrastructure/presets/strict.json +50 -0
- package/scripts/harness/config-foundation/infrastructure/registries/composite-feature-registry-adapter.ts +22 -0
- package/scripts/harness/config-foundation/infrastructure/registries/static-feature-registry-adapter.ts +18 -0
- package/scripts/harness/config-foundation/infrastructure/repositories/file-system-config-repository.ts +106 -0
- package/scripts/harness/config-foundation/infrastructure/schemas/harness-config-v2.schema.json +254 -0
- package/scripts/harness/config-foundation/infrastructure/validators/ajv-config-schema-validator.ts +114 -0
- package/scripts/harness/config-foundation/presentation/cli/disable-feature-command-handler.ts +93 -0
- package/scripts/harness/config-foundation/presentation/cli/enable-feature-command-handler.ts +93 -0
- package/scripts/harness/harness-api/application/dto/command-dispatch-input.ts +7 -0
- package/scripts/harness/harness-api/application/dto/command-dispatch-output.ts +9 -0
- package/scripts/harness/harness-api/application/dto/exit-code-decision-input.ts +8 -0
- package/scripts/harness/harness-api/application/dto/exit-code-decision-output.ts +8 -0
- package/scripts/harness/harness-api/application/dto/harness-api-response-contract.ts +10 -0
- package/scripts/harness/harness-api/application/dto/initialize-registry-input.ts +11 -0
- package/scripts/harness/harness-api/application/dto/registry-summary-output.ts +9 -0
- package/scripts/harness/harness-api/application/dto/status-derivation-input.ts +6 -0
- package/scripts/harness/harness-api/application/mappers/harness-api-response-mapper.ts +16 -0
- package/scripts/harness/harness-api/application/usecases/decide-exit-code-usecase.ts +27 -0
- package/scripts/harness/harness-api/application/usecases/derive-harness-status-usecase.ts +72 -0
- package/scripts/harness/harness-api/application/usecases/dispatch-command-usecase.ts +79 -0
- package/scripts/harness/harness-api/application/usecases/initialize-command-registry-usecase.ts +43 -0
- package/scripts/harness/harness-api/composition-root.ts +96 -0
- package/scripts/harness/harness-api/domain/ports/artifact-scanner-port.ts +7 -0
- package/scripts/harness/harness-api/domain/ports/biome-lint-port.ts +11 -0
- package/scripts/harness/harness-api/domain/ports/config-query-port.ts +9 -0
- package/scripts/harness/harness-api/domain/ports/impact-analysis-port.ts +12 -0
- package/scripts/harness/harness-api/domain/ports/phase-gate-query-port.ts +9 -0
- package/scripts/harness/harness-api/domain/ports/validator-execution-port.ts +10 -0
- package/scripts/harness/harness-api/domain/services/command-dispatch-service.ts +230 -0
- package/scripts/harness/harness-api/domain/services/command-registry.ts +44 -0
- package/scripts/harness/harness-api/domain/services/status-derivation-service.ts +121 -0
- package/scripts/harness/harness-api/domain/value-objects/artifact-scan-result.ts +35 -0
- package/scripts/harness/harness-api/domain/value-objects/check-ready-result.ts +42 -0
- package/scripts/harness/harness-api/domain/value-objects/ci-check-result.ts +56 -0
- package/scripts/harness/harness-api/domain/value-objects/cli-command-definition.ts +99 -0
- package/scripts/harness/harness-api/domain/value-objects/command-input-spec.ts +39 -0
- package/scripts/harness/harness-api/domain/value-objects/drift-report-summary.ts +46 -0
- package/scripts/harness/harness-api/domain/value-objects/exit-code-spec.ts +29 -0
- package/scripts/harness/harness-api/domain/value-objects/harness-api-response.ts +91 -0
- package/scripts/harness/harness-api/domain/value-objects/harness-status-summary.ts +73 -0
- package/scripts/harness/harness-api/domain/value-objects/layer-health.ts +44 -0
- package/scripts/harness/harness-api/domain/value-objects/phase-info.ts +37 -0
- package/scripts/harness/harness-api/index.ts +29 -0
- package/scripts/harness/harness-api/infrastructure/adapters/biome-ast-engine-lint-adapter.ts +84 -0
- package/scripts/harness/harness-api/infrastructure/adapters/file-system-artifact-scanner-adapter.ts +131 -0
- package/scripts/harness/harness-api/infrastructure/adapters/harness-config-query-adapter.ts +66 -0
- package/scripts/harness/harness-api/infrastructure/adapters/nyquist-validation-impact-analysis-adapter.ts +61 -0
- package/scripts/harness/harness-api/infrastructure/adapters/phase-dependency-model-query-adapter.ts +86 -0
- package/scripts/harness/harness-api/infrastructure/adapters/validator-system-execution-adapter.ts +74 -0
- package/scripts/harness/harness-api/presentation/dto/cli-output-options.ts +7 -0
- package/scripts/harness/harness-api/presentation/formatters/harness-api-json-formatter.ts +13 -0
- package/scripts/harness/harness-api/presentation/handlers/check-phase-handler.ts +42 -0
- package/scripts/harness/harness-api/presentation/handlers/check-ready-handler.ts +29 -0
- package/scripts/harness/harness-api/presentation/handlers/ci-check-handler.ts +29 -0
- package/scripts/harness/harness-api/presentation/handlers/complete-check-handler.ts +29 -0
- package/scripts/harness/harness-api/presentation/handlers/detect-drift-handler.ts +29 -0
- package/scripts/harness/harness-api/presentation/handlers/impact-analysis-handler.ts +45 -0
- package/scripts/harness/harness-api/presentation/handlers/lint-handler.ts +29 -0
- package/scripts/harness/harness-api/presentation/handlers/status-handler.ts +38 -0
- package/scripts/harness/harness-error/application/dto/create-harness-error-input.ts +15 -0
- package/scripts/harness/harness-error/application/dto/error-definition-summary.ts +15 -0
- package/scripts/harness/harness-error/application/dto/harness-error-contract.ts +14 -0
- package/scripts/harness/harness-error/application/dto/list-error-definitions-query.ts +11 -0
- package/scripts/harness/harness-error/application/dto/severity-contract-check-input.ts +10 -0
- package/scripts/harness/harness-error/application/dto/validate-fix-example-input.ts +10 -0
- package/scripts/harness/harness-error/application/dto/validate-fix-example-output.ts +12 -0
- package/scripts/harness/harness-error/application/dto/validator-issue-draft.ts +15 -0
- package/scripts/harness/harness-error/application/mappers/harness-error-contract-mapper.ts +27 -0
- package/scripts/harness/harness-error/application/usecases/assert-severity-contract-use-case.ts +51 -0
- package/scripts/harness/harness-error/application/usecases/create-harness-error-use-case.ts +41 -0
- package/scripts/harness/harness-error/application/usecases/list-error-definitions-use-case.ts +56 -0
- package/scripts/harness/harness-error/application/usecases/normalize-validator-errors-use-case.ts +62 -0
- package/scripts/harness/harness-error/application/usecases/validate-all-fix-examples-use-case.ts +83 -0
- package/scripts/harness/harness-error/application/usecases/validate-fix-example-use-case.ts +56 -0
- package/scripts/harness/harness-error/composition-root.ts +140 -0
- package/scripts/harness/harness-error/domain/errors/adr-reference-not-found-error.ts +16 -0
- package/scripts/harness/harness-error/domain/errors/duplicate-error-code-error.ts +16 -0
- package/scripts/harness/harness-error/domain/errors/empty-message-error.ts +14 -0
- package/scripts/harness/harness-error/domain/errors/empty-suggestion-error.ts +14 -0
- package/scripts/harness/harness-error/domain/errors/harness-error-domain-error.ts +13 -0
- package/scripts/harness/harness-error/domain/errors/invalid-adr-ref-error.ts +16 -0
- package/scripts/harness/harness-error/domain/errors/invalid-error-code-error.ts +16 -0
- package/scripts/harness/harness-error/domain/errors/invalid-error-definition-error.ts +14 -0
- package/scripts/harness/harness-error/domain/errors/invalid-fix-example-error.ts +14 -0
- package/scripts/harness/harness-error/domain/errors/invalid-fix-example-validation-result-error.ts +14 -0
- package/scripts/harness/harness-error/domain/errors/invalid-severity-error.ts +16 -0
- package/scripts/harness/harness-error/domain/errors/missing-adr-ref-error.ts +16 -0
- package/scripts/harness/harness-error/domain/errors/missing-fix-example-error.ts +16 -0
- package/scripts/harness/harness-error/domain/errors/severity-downgrade-violation-error.ts +16 -0
- package/scripts/harness/harness-error/domain/errors/unknown-error-definition-error.ts +16 -0
- package/scripts/harness/harness-error/domain/ports/adr-existence-checker-port.ts +12 -0
- package/scripts/harness/harness-error/domain/ports/fix-example-validator-port.ts +18 -0
- package/scripts/harness/harness-error/domain/services/error-definition-registry.ts +59 -0
- package/scripts/harness/harness-error/domain/services/harness-error-factory.ts +134 -0
- package/scripts/harness/harness-error/domain/services/severity-contract-enforcer.ts +37 -0
- package/scripts/harness/harness-error/domain/value-objects/adr-ref.ts +34 -0
- package/scripts/harness/harness-error/domain/value-objects/error-code.ts +41 -0
- package/scripts/harness/harness-error/domain/value-objects/error-definition.ts +128 -0
- package/scripts/harness/harness-error/domain/value-objects/fix-example-validation-result.ts +64 -0
- package/scripts/harness/harness-error/domain/value-objects/fix-example.ts +34 -0
- package/scripts/harness/harness-error/domain/value-objects/harness-error.ts +94 -0
- package/scripts/harness/harness-error/domain/value-objects/severity.ts +46 -0
- package/scripts/harness/harness-error/index.ts +16 -0
- package/scripts/harness/harness-error/infrastructure/adapters/file-system-adr-existence-checker-adapter.ts +46 -0
- package/scripts/harness/harness-error/infrastructure/adapters/legacy-error-reporter-adapter.ts +54 -0
- package/scripts/harness/harness-error/infrastructure/adapters/type-script-snippet-syntax-adapter.ts +59 -0
- package/scripts/harness/harness-error/infrastructure/adapters/validator-execution-fix-example-validator-adapter.ts +141 -0
- package/scripts/harness/harness-error/infrastructure/adapters/validator-registry-bridge-adapter.ts +101 -0
- package/scripts/harness/harness-error/infrastructure/registry/build-error-definition-registry.ts +40 -0
- package/scripts/harness/harness-error/infrastructure/registry/l1-error-definitions.ts +90 -0
- package/scripts/harness/harness-error/infrastructure/registry/l2-error-definitions.ts +56 -0
- package/scripts/harness/harness-error/infrastructure/registry/l3-error-definitions.ts +61 -0
- package/scripts/harness/harness-error/infrastructure/registry/l4-error-definitions.ts +53 -0
- package/scripts/harness/harness-error/presentation/formatters/agent-error-formatter.ts +54 -0
- package/scripts/harness/harness-error/presentation/formatters/ci-error-formatter.ts +27 -0
- package/scripts/harness/harness-error/presentation/formatters/human-error-formatter.ts +40 -0
- package/scripts/harness/harness-error/presentation/handlers/list-error-definitions-handler.ts +76 -0
- package/scripts/harness/harness-error/presentation/handlers/render-harness-errors-handler.ts +67 -0
- package/scripts/harness/harness-error/presentation/handlers/validate-fix-example-handler.ts +128 -0
- package/scripts/harness/integrations/pre-commit.ts +163 -0
- package/scripts/harness/main.ts +880 -0
- package/scripts/harness/nyquist-validation/application/dto/analyze-impact-input.ts +11 -0
- package/scripts/harness/nyquist-validation/application/dto/analyze-impact-output.ts +18 -0
- package/scripts/harness/nyquist-validation/application/dto/calculate-coverage-input.ts +11 -0
- package/scripts/harness/nyquist-validation/application/dto/calculate-coverage-output.ts +15 -0
- package/scripts/harness/nyquist-validation/application/dto/check-ac-coverage-gate-input.ts +10 -0
- package/scripts/harness/nyquist-validation/application/dto/check-ac-coverage-gate-output.ts +14 -0
- package/scripts/harness/nyquist-validation/application/dto/validate-matrix-input.ts +11 -0
- package/scripts/harness/nyquist-validation/application/dto/validate-matrix-output.ts +15 -0
- package/scripts/harness/nyquist-validation/application/mappers/coverage-result-mapper.ts +25 -0
- package/scripts/harness/nyquist-validation/application/mappers/impact-analysis-result-mapper.ts +22 -0
- package/scripts/harness/nyquist-validation/application/usecases/analyze-impact-usecase.ts +82 -0
- package/scripts/harness/nyquist-validation/application/usecases/calculate-coverage-usecase.ts +91 -0
- package/scripts/harness/nyquist-validation/application/usecases/check-ac-coverage-gate-usecase.ts +100 -0
- package/scripts/harness/nyquist-validation/application/usecases/validate-matrix-usecase.ts +69 -0
- package/scripts/harness/nyquist-validation/composition-root.ts +108 -0
- package/scripts/harness/nyquist-validation/domain/aggregates/requirement-test-matrix.ts +57 -0
- package/scripts/harness/nyquist-validation/domain/entities/story-mapping.ts +46 -0
- package/scripts/harness/nyquist-validation/domain/errors/duplicate-story-mapping-error.ts +14 -0
- package/scripts/harness/nyquist-validation/domain/errors/empty-file-path-error.ts +14 -0
- package/scripts/harness/nyquist-validation/domain/errors/invalid-ac-id-format-error.ts +14 -0
- package/scripts/harness/nyquist-validation/domain/errors/invalid-test-type-error.ts +14 -0
- package/scripts/harness/nyquist-validation/domain/errors/matrix-validation-failed-error.ts +14 -0
- package/scripts/harness/nyquist-validation/domain/errors/nyquist-domain-error.ts +14 -0
- package/scripts/harness/nyquist-validation/domain/errors/story-not-found-error.ts +14 -0
- package/scripts/harness/nyquist-validation/domain/ports/coverage-threshold-port.ts +16 -0
- package/scripts/harness/nyquist-validation/domain/ports/matrix-file-port.ts +11 -0
- package/scripts/harness/nyquist-validation/domain/ports/story-registry-port.ts +10 -0
- package/scripts/harness/nyquist-validation/domain/services/ac-coverage-gate-policy.ts +40 -0
- package/scripts/harness/nyquist-validation/domain/services/coverage-calculation-service.ts +37 -0
- package/scripts/harness/nyquist-validation/domain/services/impact-analysis-service.ts +27 -0
- package/scripts/harness/nyquist-validation/domain/services/matrix-validation-service.ts +71 -0
- package/scripts/harness/nyquist-validation/domain/value-objects/ac-mapping.ts +48 -0
- package/scripts/harness/nyquist-validation/domain/value-objects/coverage-result.ts +58 -0
- package/scripts/harness/nyquist-validation/domain/value-objects/impact-analysis-result.ts +48 -0
- package/scripts/harness/nyquist-validation/domain/value-objects/test-reference.ts +47 -0
- package/scripts/harness/nyquist-validation/index.ts +26 -0
- package/scripts/harness/nyquist-validation/infrastructure/adapters/ajv-json-schema-validator-adapter.ts +67 -0
- package/scripts/harness/nyquist-validation/infrastructure/adapters/config-foundation-coverage-threshold-adapter.ts +45 -0
- package/scripts/harness/nyquist-validation/infrastructure/adapters/file-system-matrix-file-adapter.ts +25 -0
- package/scripts/harness/nyquist-validation/infrastructure/adapters/traceability-model-story-registry-adapter.ts +25 -0
- package/scripts/harness/nyquist-validation/infrastructure/schema/matrix-schema-loader.ts +27 -0
- package/scripts/harness/nyquist-validation/presentation/dto/cli-render-options.ts +12 -0
- package/scripts/harness/nyquist-validation/presentation/formatters/agent-matrix-formatter.ts +84 -0
- package/scripts/harness/nyquist-validation/presentation/formatters/human-matrix-formatter.ts +69 -0
- package/scripts/harness/nyquist-validation/presentation/formatters/json-matrix-formatter.ts +28 -0
- package/scripts/harness/nyquist-validation/presentation/handlers/analyze-impact-handler.ts +58 -0
- package/scripts/harness/nyquist-validation/presentation/handlers/calculate-coverage-handler.ts +56 -0
- package/scripts/harness/nyquist-validation/presentation/handlers/check-ac-coverage-gate-handler.ts +56 -0
- package/scripts/harness/nyquist-validation/presentation/handlers/validate-matrix-handler.ts +58 -0
- package/scripts/harness/phase-dependency-model/application/dto/customization-validation-result-dto.ts +11 -0
- package/scripts/harness/phase-dependency-model/application/dto/phase-dependency-graph-dto.ts +22 -0
- package/scripts/harness/phase-dependency-model/application/dto/phase-gate-result-dto.ts +12 -0
- package/scripts/harness/phase-dependency-model/application/dto/phase-info-dto.ts +13 -0
- package/scripts/harness/phase-dependency-model/application/services/evidence-bundle-assembler.ts +71 -0
- package/scripts/harness/phase-dependency-model/application/services/phase-gate-result-mapper.ts +25 -0
- package/scripts/harness/phase-dependency-model/application/services/phase-info-resolver.ts +156 -0
- package/scripts/harness/phase-dependency-model/application/usecases/build-phase-dependency-graph-usecase.ts +55 -0
- package/scripts/harness/phase-dependency-model/application/usecases/check-phase-gate-usecase.ts +80 -0
- package/scripts/harness/phase-dependency-model/application/usecases/get-phase-info-usecase.ts +62 -0
- package/scripts/harness/phase-dependency-model/application/usecases/record-phase-override-audit-usecase.ts +53 -0
- package/scripts/harness/phase-dependency-model/application/usecases/validate-customization-policy-usecase.ts +62 -0
- package/scripts/harness/phase-dependency-model/composition-root.ts +76 -0
- package/scripts/harness/phase-dependency-model/domain/definitions/default-phase-dependencies.ts +48 -0
- package/scripts/harness/phase-dependency-model/domain/definitions/default-phase-nodes.ts +195 -0
- package/scripts/harness/phase-dependency-model/domain/models/phase-structure.ts +489 -0
- package/scripts/harness/phase-dependency-model/domain/ports/artifact-existence-checker-port.ts +13 -0
- package/scripts/harness/phase-dependency-model/domain/ports/phase-audit-logger-port.ts +14 -0
- package/scripts/harness/phase-dependency-model/domain/ports/phase-config-provider-port.ts +13 -0
- package/scripts/harness/phase-dependency-model/domain/ports/plan-document-reader-port.ts +16 -0
- package/scripts/harness/phase-dependency-model/domain/values/artifact.ts +89 -0
- package/scripts/harness/phase-dependency-model/domain/values/custom-rule.ts +64 -0
- package/scripts/harness/phase-dependency-model/domain/values/phase-customization-policy.ts +57 -0
- package/scripts/harness/phase-dependency-model/domain/values/phase-dependency.ts +62 -0
- package/scripts/harness/phase-dependency-model/domain/values/phase-gate-result.ts +71 -0
- package/scripts/harness/phase-dependency-model/domain/values/phase-level.ts +42 -0
- package/scripts/harness/phase-dependency-model/domain/values/phase-node.ts +72 -0
- package/scripts/harness/phase-dependency-model/domain/values/plan-evidence.ts +43 -0
- package/scripts/harness/phase-dependency-model/domain/values/planning-mode.ts +60 -0
- package/scripts/harness/phase-dependency-model/index.ts +13 -0
- package/scripts/harness/phase-dependency-model/infrastructure/config/harness-config-phase-config-provider.ts +98 -0
- package/scripts/harness/phase-dependency-model/infrastructure/filesystem/file-system-artifact-existence-checker.ts +54 -0
- package/scripts/harness/phase-dependency-model/infrastructure/filesystem/markdown-plan-document-reader.ts +134 -0
- package/scripts/harness/phase-dependency-model/infrastructure/logging/phase-override-audit-logger.ts +37 -0
- package/scripts/harness/phase-dependency-model/presentation/cli/check-phase-gate-command-handler.ts +95 -0
- package/scripts/harness/phase2-extensions/application/dto/check-doc-freshness-input.ts +9 -0
- package/scripts/harness/phase2-extensions/application/dto/check-doc-freshness-output.ts +17 -0
- package/scripts/harness/phase2-extensions/application/dto/generate-e2e-template-input.ts +9 -0
- package/scripts/harness/phase2-extensions/application/dto/generate-e2e-template-output.ts +13 -0
- package/scripts/harness/phase2-extensions/application/dto/validate-doc-pointers-input.ts +9 -0
- package/scripts/harness/phase2-extensions/application/dto/validate-doc-pointers-output.ts +25 -0
- package/scripts/harness/phase2-extensions/application/usecases/check-doc-freshness-usecase.ts +68 -0
- package/scripts/harness/phase2-extensions/application/usecases/generate-e2e-template-usecase.ts +39 -0
- package/scripts/harness/phase2-extensions/application/usecases/validate-doc-pointers-usecase.ts +98 -0
- package/scripts/harness/phase2-extensions/composition-root.ts +52 -0
- package/scripts/harness/phase2-extensions/domain/aggregates/doc-freshness-rule.ts +82 -0
- package/scripts/harness/phase2-extensions/domain/aggregates/pointer-rule.ts +38 -0
- package/scripts/harness/phase2-extensions/domain/errors/phase2-extensions-domain-error.ts +13 -0
- package/scripts/harness/phase2-extensions/domain/ports/document-age-port.ts +9 -0
- package/scripts/harness/phase2-extensions/domain/ports/document-scanner-port.ts +7 -0
- package/scripts/harness/phase2-extensions/domain/ports/freshness-config-port.ts +11 -0
- package/scripts/harness/phase2-extensions/domain/ports/pointer-extractor-port.ts +9 -0
- package/scripts/harness/phase2-extensions/domain/ports/pointer-resolver-port.ts +9 -0
- package/scripts/harness/phase2-extensions/domain/services/freshness-check-service.ts +46 -0
- package/scripts/harness/phase2-extensions/domain/services/pointer-resolution-service.ts +31 -0
- package/scripts/harness/phase2-extensions/domain/value-objects/document-age.ts +44 -0
- package/scripts/harness/phase2-extensions/domain/value-objects/e2e-strategy-template.ts +61 -0
- package/scripts/harness/phase2-extensions/domain/value-objects/freshness-threshold.ts +42 -0
- package/scripts/harness/phase2-extensions/domain/value-objects/pointer-validation-result.ts +52 -0
- package/scripts/harness/phase2-extensions/domain/value-objects/pointer.ts +47 -0
- package/scripts/harness/phase2-extensions/infrastructure/adapters/file-system-document-scanner-adapter.ts +77 -0
- package/scripts/harness/phase2-extensions/infrastructure/adapters/file-system-pointer-resolver-adapter.ts +25 -0
- package/scripts/harness/phase2-extensions/infrastructure/adapters/git-log-document-age-adapter.ts +47 -0
- package/scripts/harness/phase2-extensions/infrastructure/adapters/harness-config-freshness-adapter.ts +77 -0
- package/scripts/harness/phase2-extensions/infrastructure/adapters/playwright-template-generator-adapter.ts +154 -0
- package/scripts/harness/phase2-extensions/infrastructure/adapters/regex-pointer-extractor-adapter.ts +53 -0
- package/scripts/harness/phase2-extensions/presentation/formatters/freshness-result-formatter.ts +18 -0
- package/scripts/harness/phase2-extensions/presentation/formatters/pointer-result-formatter.ts +18 -0
- package/scripts/harness/phase2-extensions/presentation/handlers/check-freshness-handler.ts +37 -0
- package/scripts/harness/phase2-extensions/presentation/handlers/generate-e2e-template-handler.ts +43 -0
- package/scripts/harness/phase2-extensions/presentation/handlers/validate-pointers-handler.ts +33 -0
- package/scripts/harness/quick-mode/application/dto/build-relaxation-profile-input.ts +12 -0
- package/scripts/harness/quick-mode/application/dto/execute-quick-ci-check-input.ts +11 -0
- package/scripts/harness/quick-mode/application/dto/judge-quick-mode-eligibility-input.ts +10 -0
- package/scripts/harness/quick-mode/application/dto/quick-mode-decision-contract.ts +14 -0
- package/scripts/harness/quick-mode/application/dto/quick-mode-eligibility-contract.ts +13 -0
- package/scripts/harness/quick-mode/application/dto/validator-relaxation-profile-contract.ts +21 -0
- package/scripts/harness/quick-mode/application/mappers/quick-mode-decision-contract-mapper.ts +73 -0
- package/scripts/harness/quick-mode/application/ports/changed-files-port.ts +8 -0
- package/scripts/harness/quick-mode/application/ports/quick-mode-config-port.ts +13 -0
- package/scripts/harness/quick-mode/application/ports/validator-execution-port.ts +12 -0
- package/scripts/harness/quick-mode/application/ports/validator-id-registry-port.ts +11 -0
- package/scripts/harness/quick-mode/application/usecases/build-relaxation-profile-usecase.ts +76 -0
- package/scripts/harness/quick-mode/application/usecases/execute-quick-ci-check-usecase.ts +63 -0
- package/scripts/harness/quick-mode/application/usecases/judge-quick-mode-eligibility-usecase.ts +57 -0
- package/scripts/harness/quick-mode/composition-root.ts +74 -0
- package/scripts/harness/quick-mode/domain/ports/changed-files-port.ts +12 -0
- package/scripts/harness/quick-mode/domain/ports/quick-mode-config-port.ts +12 -0
- package/scripts/harness/quick-mode/domain/ports/validator-id-registry-port.ts +10 -0
- package/scripts/harness/quick-mode/domain/services/quick-mode-judgment-engine.ts +148 -0
- package/scripts/harness/quick-mode/domain/services/validator-relaxation-service.ts +47 -0
- package/scripts/harness/quick-mode/domain/types/change-kind.ts +14 -0
- package/scripts/harness/quick-mode/domain/types/rejection-rule.ts +8 -0
- package/scripts/harness/quick-mode/domain/value-objects/change-category.ts +60 -0
- package/scripts/harness/quick-mode/domain/value-objects/change-classification.ts +68 -0
- package/scripts/harness/quick-mode/domain/value-objects/changed-file.ts +56 -0
- package/scripts/harness/quick-mode/domain/value-objects/quick-mode-config.ts +69 -0
- package/scripts/harness/quick-mode/domain/value-objects/quick-mode-decision.ts +47 -0
- package/scripts/harness/quick-mode/domain/value-objects/quick-mode-eligibility.ts +62 -0
- package/scripts/harness/quick-mode/domain/value-objects/validator-relaxation-profile.ts +116 -0
- package/scripts/harness/quick-mode/index.ts +43 -0
- package/scripts/harness/quick-mode/infrastructure/adapters/git-diff-changed-files-adapter.ts +92 -0
- package/scripts/harness/quick-mode/infrastructure/adapters/harness-config-quick-mode-config-adapter.ts +75 -0
- package/scripts/harness/quick-mode/infrastructure/adapters/validator-system-validator-id-registry-adapter.ts +23 -0
- package/scripts/harness/quick-mode/presentation/dto/quick-mode-render-options.ts +14 -0
- package/scripts/harness/quick-mode/presentation/formatters/agent-quick-mode-formatter.ts +56 -0
- package/scripts/harness/quick-mode/presentation/formatters/human-quick-mode-formatter.ts +48 -0
- package/scripts/harness/quick-mode/presentation/formatters/json-quick-mode-formatter.ts +14 -0
- package/scripts/harness/quick-mode/presentation/handlers/ci-check-quick-mode-handler.ts +63 -0
- package/scripts/harness/regression-suite/application/dto/analyze-migration-input.ts +5 -0
- package/scripts/harness/regression-suite/application/dto/analyze-migration-output.ts +6 -0
- package/scripts/harness/regression-suite/application/dto/configure-ci-gate-input.ts +8 -0
- package/scripts/harness/regression-suite/application/dto/configure-ci-gate-output.ts +8 -0
- package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-input.ts +5 -0
- package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-output.ts +18 -0
- package/scripts/harness/regression-suite/application/dto/run-regression-suite-input.ts +7 -0
- package/scripts/harness/regression-suite/application/dto/run-regression-suite-output.ts +15 -0
- package/scripts/harness/regression-suite/application/mappers/migration-mapping-mapper.ts +23 -0
- package/scripts/harness/regression-suite/application/mappers/test-execution-summary-mapper.ts +25 -0
- package/scripts/harness/regression-suite/application/usecases/analyze-v0-migration-usecase.ts +38 -0
- package/scripts/harness/regression-suite/application/usecases/configure-ci-gate-usecase.ts +29 -0
- package/scripts/harness/regression-suite/application/usecases/migrate-v0-tests-usecase.ts +44 -0
- package/scripts/harness/regression-suite/application/usecases/run-agent-independence-guard-usecase.ts +66 -0
- package/scripts/harness/regression-suite/application/usecases/run-gng-gate-regression-usecase.ts +41 -0
- package/scripts/harness/regression-suite/application/usecases/run-k-requirements-regression-usecase.ts +59 -0
- package/scripts/harness/regression-suite/application/usecases/run-k14-k15-regression-usecase.ts +46 -0
- package/scripts/harness/regression-suite/composition-root.ts +98 -0
- package/scripts/harness/regression-suite/domain/aggregates/v0-test-migration.ts +94 -0
- package/scripts/harness/regression-suite/domain/ports/ci-gate-result-writer-port.ts +6 -0
- package/scripts/harness/regression-suite/domain/ports/config-query-port.ts +3 -0
- package/scripts/harness/regression-suite/domain/ports/import-analyzer-port.ts +3 -0
- package/scripts/harness/regression-suite/domain/ports/migration-mapping-repository-port.ts +9 -0
- package/scripts/harness/regression-suite/domain/ports/suite-registry-port.ts +6 -0
- package/scripts/harness/regression-suite/domain/ports/test-runner-port.ts +16 -0
- package/scripts/harness/regression-suite/domain/ports/v0-spec-reader-port.ts +5 -0
- package/scripts/harness/regression-suite/domain/services/import-guard-service.ts +38 -0
- package/scripts/harness/regression-suite/domain/services/migration-analyzer.ts +72 -0
- package/scripts/harness/regression-suite/domain/services/regression-runner.ts +90 -0
- package/scripts/harness/regression-suite/domain/value-objects/agent-independence-test.ts +35 -0
- package/scripts/harness/regression-suite/domain/value-objects/biome-modification-spec.ts +38 -0
- package/scripts/harness/regression-suite/domain/value-objects/ci-gate-config.ts +47 -0
- package/scripts/harness/regression-suite/domain/value-objects/coverage-rate.ts +27 -0
- package/scripts/harness/regression-suite/domain/value-objects/gng-condition-test.ts +41 -0
- package/scripts/harness/regression-suite/domain/value-objects/import-violation.ts +38 -0
- package/scripts/harness/regression-suite/domain/value-objects/k-requirement-test.ts +44 -0
- package/scripts/harness/regression-suite/domain/value-objects/migration-mapping.ts +37 -0
- package/scripts/harness/regression-suite/domain/value-objects/regression-suite-definition.ts +40 -0
- package/scripts/harness/regression-suite/domain/value-objects/suite-id.ts +32 -0
- package/scripts/harness/regression-suite/domain/value-objects/test-execution-summary.ts +55 -0
- package/scripts/harness/regression-suite/domain/value-objects/test-failure-detail.ts +32 -0
- package/scripts/harness/regression-suite/domain/value-objects/v0-test-id.ts +23 -0
- package/scripts/harness/regression-suite/domain/value-objects/v1-test-path.ts +23 -0
- package/scripts/harness/regression-suite/infrastructure/adapters/biome-ast-import-analyzer-adapter.ts +17 -0
- package/scripts/harness/regression-suite/infrastructure/adapters/file-system-v0-spec-reader-adapter.ts +20 -0
- package/scripts/harness/regression-suite/infrastructure/adapters/harness-config-query-adapter.ts +9 -0
- package/scripts/harness/regression-suite/infrastructure/adapters/json-ci-gate-result-writer-adapter.ts +30 -0
- package/scripts/harness/regression-suite/infrastructure/adapters/markdown-migration-mapping-repository-adapter.ts +40 -0
- package/scripts/harness/regression-suite/infrastructure/adapters/static-suite-registry-adapter.ts +24 -0
- package/scripts/harness/regression-suite/infrastructure/adapters/vitest-test-runner-adapter.ts +104 -0
- package/scripts/harness/regression-suite/infrastructure/registry/agent-independence-suite-definition.ts +31 -0
- package/scripts/harness/regression-suite/infrastructure/registry/gng-gate-suite-definition.ts +19 -0
- package/scripts/harness/regression-suite/infrastructure/registry/k-requirements-suite-definition.ts +32 -0
- package/scripts/harness/regression-suite/infrastructure/registry/v0-migration-suite-definition.ts +23 -0
- package/scripts/harness/setup/skill-deployer.ts +217 -0
- package/scripts/harness/shared-kernel/harness-api.ts +5 -0
- package/scripts/harness/shared-kernel/quick-mode.ts +15 -0
- package/scripts/harness/shared-kernel/validator-system.ts +14 -0
- package/scripts/harness/skill-quality/application/dto/apply-cascade-update-input.ts +8 -0
- package/scripts/harness/skill-quality/application/dto/apply-cascade-update-output.ts +9 -0
- package/scripts/harness/skill-quality/application/dto/check-coverage-input.ts +7 -0
- package/scripts/harness/skill-quality/application/dto/check-coverage-output.ts +12 -0
- package/scripts/harness/skill-quality/application/dto/collect-lessons-input.ts +7 -0
- package/scripts/harness/skill-quality/application/dto/collect-lessons-output.ts +11 -0
- package/scripts/harness/skill-quality/application/dto/execute-tdd-cycle-input.ts +11 -0
- package/scripts/harness/skill-quality/application/dto/execute-tdd-cycle-output.ts +11 -0
- package/scripts/harness/skill-quality/application/dto/run-plan-checker-loop-input.ts +8 -0
- package/scripts/harness/skill-quality/application/dto/run-plan-checker-loop-output.ts +12 -0
- package/scripts/harness/skill-quality/application/dto/validate-skill-structure-input.ts +7 -0
- package/scripts/harness/skill-quality/application/dto/validate-skill-structure-output.ts +9 -0
- package/scripts/harness/skill-quality/application/dto/write-lesson-artifact-input.ts +10 -0
- package/scripts/harness/skill-quality/application/dto/write-lesson-artifact-output.ts +8 -0
- package/scripts/harness/skill-quality/application/mappers/cascade-update-result-mapper.ts +16 -0
- package/scripts/harness/skill-quality/application/mappers/coverage-report-mapper.ts +37 -0
- package/scripts/harness/skill-quality/application/mappers/lesson-artifact-mapper.ts +11 -0
- package/scripts/harness/skill-quality/application/usecases/apply-cascade-update-usecase.ts +61 -0
- package/scripts/harness/skill-quality/application/usecases/check-coverage-usecase.ts +39 -0
- package/scripts/harness/skill-quality/application/usecases/collect-lessons-usecase.ts +34 -0
- package/scripts/harness/skill-quality/application/usecases/execute-tdd-cycle-usecase.ts +26 -0
- package/scripts/harness/skill-quality/application/usecases/run-plan-checker-loop-usecase.ts +38 -0
- package/scripts/harness/skill-quality/application/usecases/validate-skill-structure-usecase.ts +16 -0
- package/scripts/harness/skill-quality/application/usecases/write-lesson-artifact-usecase.ts +37 -0
- package/scripts/harness/skill-quality/composition-root.ts +120 -0
- package/scripts/harness/skill-quality/domain/aggregates/lesson-artifact.ts +59 -0
- package/scripts/harness/skill-quality/domain/aggregates/plan-checker-loop.ts +58 -0
- package/scripts/harness/skill-quality/domain/errors/skill-quality-error.ts +40 -0
- package/scripts/harness/skill-quality/domain/ports/commit-executor-port.ts +9 -0
- package/scripts/harness/skill-quality/domain/ports/config-query-port.ts +10 -0
- package/scripts/harness/skill-quality/domain/ports/coverage-runner-port.ts +9 -0
- package/scripts/harness/skill-quality/domain/ports/file-system-port.ts +10 -0
- package/scripts/harness/skill-quality/domain/ports/l1-validator-port.ts +10 -0
- package/scripts/harness/skill-quality/domain/ports/l2-validator-port.ts +10 -0
- package/scripts/harness/skill-quality/domain/ports/lesson-artifact-schema-port.ts +9 -0
- package/scripts/harness/skill-quality/domain/ports/lesson-artifact-writer-port.ts +9 -0
- package/scripts/harness/skill-quality/domain/ports/lesson-source-reader-port.ts +16 -0
- package/scripts/harness/skill-quality/domain/ports/plan-check-executor-port.ts +15 -0
- package/scripts/harness/skill-quality/domain/ports/requirement-test-matrix-port.ts +15 -0
- package/scripts/harness/skill-quality/domain/ports/skill-file-reader-port.ts +9 -0
- package/scripts/harness/skill-quality/domain/ports/validator-id-registry-port.ts +8 -0
- package/scripts/harness/skill-quality/domain/services/atomic-commit-service.ts +38 -0
- package/scripts/harness/skill-quality/domain/services/cascade-update-service.ts +36 -0
- package/scripts/harness/skill-quality/domain/services/lesson-collector.ts +26 -0
- package/scripts/harness/skill-quality/domain/services/lesson-deduplicator.ts +17 -0
- package/scripts/harness/skill-quality/domain/services/skill-structure-validator.ts +72 -0
- package/scripts/harness/skill-quality/domain/types/iso-date-string.ts +5 -0
- package/scripts/harness/skill-quality/domain/types/loop-status.ts +5 -0
- package/scripts/harness/skill-quality/domain/types/section-name.ts +5 -0
- package/scripts/harness/skill-quality/domain/types/tdd-phase.ts +5 -0
- package/scripts/harness/skill-quality/domain/types/unit-name.ts +5 -0
- package/scripts/harness/skill-quality/domain/types/validation-violation.ts +9 -0
- package/scripts/harness/skill-quality/domain/value-objects/cascade-update-result.ts +35 -0
- package/scripts/harness/skill-quality/domain/value-objects/cascade-update-target.ts +28 -0
- package/scripts/harness/skill-quality/domain/value-objects/code-coverage-result.ts +31 -0
- package/scripts/harness/skill-quality/domain/value-objects/commit-message.ts +33 -0
- package/scripts/harness/skill-quality/domain/value-objects/commit-readiness.ts +34 -0
- package/scripts/harness/skill-quality/domain/value-objects/coverage-report.ts +36 -0
- package/scripts/harness/skill-quality/domain/value-objects/lesson-fingerprint.ts +29 -0
- package/scripts/harness/skill-quality/domain/value-objects/lesson.ts +57 -0
- package/scripts/harness/skill-quality/domain/value-objects/loop-attempt.ts +38 -0
- package/scripts/harness/skill-quality/domain/value-objects/requirement-coverage-result.ts +29 -0
- package/scripts/harness/skill-quality/domain/value-objects/skill-structure.ts +36 -0
- package/scripts/harness/skill-quality/domain/value-objects/skill-validation-result.ts +38 -0
- package/scripts/harness/skill-quality/domain/value-objects/source-context.ts +25 -0
- package/scripts/harness/skill-quality/domain/value-objects/tdd-cycle.ts +28 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/ajv-lesson-artifact-schema-adapter.ts +37 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/file-system-lesson-artifact-writer-adapter.ts +19 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/file-system-lesson-source-reader-adapter.ts +30 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/file-system-requirement-test-matrix-adapter.ts +28 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/file-system-skill-file-reader-adapter.ts +26 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/git-commit-executor-adapter.ts +31 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/harness-config-query-adapter.ts +19 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/l1-biome-validator-adapter.ts +25 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/l2-validator-system-adapter.ts +30 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/validator-id-registry-bridge-adapter.ts +19 -0
- package/scripts/harness/skill-quality/infrastructure/adapters/vitest-coverage-runner-adapter.ts +70 -0
- package/scripts/harness/skill-quality/presentation/handlers/apply-cascade-update-handler.ts +32 -0
- package/scripts/harness/skill-quality/presentation/handlers/check-coverage-handler.ts +36 -0
- package/scripts/harness/skill-quality/presentation/handlers/collect-lessons-handler.ts +38 -0
- package/scripts/harness/skill-quality/presentation/handlers/execute-tdd-cycle-handler.ts +37 -0
- package/scripts/harness/skill-quality/presentation/handlers/run-plan-checker-loop-handler.ts +34 -0
- package/scripts/harness/skill-quality/presentation/handlers/validate-skill-structure-handler.ts +35 -0
- package/scripts/harness/traceability-model/application/dto/metadata-validation-input.ts +12 -0
- package/scripts/harness/traceability-model/application/dto/metadata-validation-output.ts +13 -0
- package/scripts/harness/traceability-model/application/dto/traceability-chain-output.ts +20 -0
- package/scripts/harness/traceability-model/application/dto/traceability-coverage-output.ts +14 -0
- package/scripts/harness/traceability-model/application/usecases/build-traceability-chain-usecase.ts +64 -0
- package/scripts/harness/traceability-model/application/usecases/resolve-legacy-story-id-usecase.ts +34 -0
- package/scripts/harness/traceability-model/application/usecases/validate-design-story-annotations-usecase.ts +83 -0
- package/scripts/harness/traceability-model/application/usecases/validate-implementation-metadata-usecase.ts +76 -0
- package/scripts/harness/traceability-model/application/usecases/validate-test-story-metadata-usecase.ts +76 -0
- package/scripts/harness/traceability-model/application/usecases/verify-traceability-coverage-usecase.ts +60 -0
- package/scripts/harness/traceability-model/composition-root.ts +61 -0
- package/scripts/harness/traceability-model/domain/constants/layer-names.ts +14 -0
- package/scripts/harness/traceability-model/domain/constants/metadata-tag-types.ts +14 -0
- package/scripts/harness/traceability-model/domain/constants/traceability-link-types.ts +14 -0
- package/scripts/harness/traceability-model/domain/ports/design-document-port.ts +24 -0
- package/scripts/harness/traceability-model/domain/ports/inception-plan-port.ts +16 -0
- package/scripts/harness/traceability-model/domain/ports/metadata-reader-port.ts +22 -0
- package/scripts/harness/traceability-model/domain/ports/story-catalog-port.ts +14 -0
- package/scripts/harness/traceability-model/domain/ports/unit-definition-port.ts +14 -0
- package/scripts/harness/traceability-model/domain/services/metadata-validator.ts +252 -0
- package/scripts/harness/traceability-model/domain/services/story-id-alias-resolver.ts +48 -0
- package/scripts/harness/traceability-model/domain/services/traceability-chain-builder.ts +293 -0
- package/scripts/harness/traceability-model/domain/value-objects/chain-link.ts +79 -0
- package/scripts/harness/traceability-model/domain/value-objects/design-document-flags.ts +40 -0
- package/scripts/harness/traceability-model/domain/value-objects/layer-reference.ts +41 -0
- package/scripts/harness/traceability-model/domain/value-objects/metadata-tag.ts +93 -0
- package/scripts/harness/traceability-model/domain/value-objects/metadata-validation-result.ts +97 -0
- package/scripts/harness/traceability-model/domain/value-objects/project-relative-path.ts +96 -0
- package/scripts/harness/traceability-model/domain/value-objects/story-id-annotation.ts +49 -0
- package/scripts/harness/traceability-model/domain/value-objects/story-id.ts +58 -0
- package/scripts/harness/traceability-model/domain/value-objects/story-reference.ts +40 -0
- package/scripts/harness/traceability-model/domain/value-objects/traceability-chain.ts +66 -0
- package/scripts/harness/traceability-model/domain/value-objects/unit-reference.ts +70 -0
- package/scripts/harness/traceability-model/index.ts +16 -0
- package/scripts/harness/traceability-model/infrastructure/gateways/file-system-inception-plan-gateway.ts +86 -0
- package/scripts/harness/traceability-model/infrastructure/gateways/file-system-metadata-reader.ts +101 -0
- package/scripts/harness/traceability-model/infrastructure/gateways/markdown-design-document-gateway.ts +122 -0
- package/scripts/harness/traceability-model/infrastructure/gateways/markdown-story-catalog-gateway.ts +98 -0
- package/scripts/harness/traceability-model/infrastructure/gateways/markdown-unit-definition-gateway.ts +95 -0
- package/scripts/harness/traceability-model/infrastructure/parsers/frontmatter-flag-parser.ts +52 -0
- package/scripts/harness/traceability-model/infrastructure/parsers/markdown-story-annotation-parser.ts +59 -0
- package/scripts/harness/traceability-model/infrastructure/parsers/source-metadata-parser.ts +103 -0
- package/scripts/harness/traceability-model/infrastructure/parsers/story-catalog-parser.ts +78 -0
- package/scripts/harness/traceability-model/presentation/cli/validate-metadata-command-handler.ts +87 -0
- package/scripts/harness/validator-system/application/dto/aggregate-results-input.ts +12 -0
- package/scripts/harness/validator-system/application/dto/aggregated-validation-report.ts +28 -0
- package/scripts/harness/validator-system/application/dto/run-full-validation-input.ts +16 -0
- package/scripts/harness/validator-system/application/dto/run-l0-validators-input.ts +9 -0
- package/scripts/harness/validator-system/application/dto/run-l1-validators-input.ts +12 -0
- package/scripts/harness/validator-system/application/dto/run-l2-validators-input.ts +12 -0
- package/scripts/harness/validator-system/application/dto/run-l3-validators-input.ts +12 -0
- package/scripts/harness/validator-system/application/dto/run-l4-validators-input.ts +11 -0
- package/scripts/harness/validator-system/application/dto/run-quick-mode-input.ts +14 -0
- package/scripts/harness/validator-system/application/dto/validation-result-contract.ts +21 -0
- package/scripts/harness/validator-system/application/dto/validator-relaxation-profile.ts +21 -0
- package/scripts/harness/validator-system/application/mappers/validation-result-contract-mapper.ts +29 -0
- package/scripts/harness/validator-system/application/use-cases/aggregate-validation-results-usecase.ts +87 -0
- package/scripts/harness/validator-system/application/use-cases/run-full-validation-usecase.ts +63 -0
- package/scripts/harness/validator-system/application/use-cases/run-l0-validators-usecase.ts +60 -0
- package/scripts/harness/validator-system/application/use-cases/run-l1-validators-usecase.ts +152 -0
- package/scripts/harness/validator-system/application/use-cases/run-l2-validators-usecase.ts +130 -0
- package/scripts/harness/validator-system/application/use-cases/run-l3-validators-usecase.ts +156 -0
- package/scripts/harness/validator-system/application/use-cases/run-l4-validators-usecase.ts +124 -0
- package/scripts/harness/validator-system/application/use-cases/run-quick-mode-usecase.ts +91 -0
- package/scripts/harness/validator-system/composition-root.ts +234 -0
- package/scripts/harness/validator-system/domain/ports/ac-coverage-policy-port.ts +14 -0
- package/scripts/harness/validator-system/domain/ports/adr-reference-port.ts +17 -0
- package/scripts/harness/validator-system/domain/ports/cli-command-registry-port.ts +15 -0
- package/scripts/harness/validator-system/domain/ports/coverage-report-port.ts +13 -0
- package/scripts/harness/validator-system/domain/ports/design-document-port.ts +27 -0
- package/scripts/harness/validator-system/domain/ports/e2e-test-file-registry-port.ts +15 -0
- package/scripts/harness/validator-system/domain/ports/it-test-file-analyzer-port.ts +21 -0
- package/scripts/harness/validator-system/domain/ports/metadata-policy-port.ts +17 -0
- package/scripts/harness/validator-system/domain/ports/performance-scanner-port.ts +14 -0
- package/scripts/harness/validator-system/domain/ports/phase-gate-policy-port.ts +14 -0
- package/scripts/harness/validator-system/domain/ports/security-pattern-scanner-port.ts +14 -0
- package/scripts/harness/validator-system/domain/ports/source-analysis-port.ts +18 -0
- package/scripts/harness/validator-system/domain/ports/source-code-analyzer-port.ts +19 -0
- package/scripts/harness/validator-system/domain/ports/source-file-text-scanner-port.ts +21 -0
- package/scripts/harness/validator-system/domain/ports/test-quality-analyzer-port.ts +17 -0
- package/scripts/harness/validator-system/domain/ports/validator-config-port.ts +11 -0
- package/scripts/harness/validator-system/domain/services/cli-e2e-test-existence-service.ts +27 -0
- package/scripts/harness/validator-system/domain/services/it-test-mock-detection-service.ts +44 -0
- package/scripts/harness/validator-system/domain/services/l4/consistency-check-service.ts +79 -0
- package/scripts/harness/validator-system/domain/services/l4/dead-code-detection-service.ts +49 -0
- package/scripts/harness/validator-system/domain/services/l4/drift-detection-service.ts +75 -0
- package/scripts/harness/validator-system/domain/services/stub-comment-detection-service.ts +25 -0
- package/scripts/harness/validator-system/domain/services/validator-execution-service.ts +153 -0
- package/scripts/harness/validator-system/domain/services/validator-registry.ts +62 -0
- package/scripts/harness/validator-system/domain/value-objects/cli-e2e-test-coverage-report.ts +45 -0
- package/scripts/harness/validator-system/domain/value-objects/consistency-report.ts +54 -0
- package/scripts/harness/validator-system/domain/value-objects/dead-code-report.ts +61 -0
- package/scripts/harness/validator-system/domain/value-objects/drift-report.ts +61 -0
- package/scripts/harness/validator-system/domain/value-objects/it-test-mock-violation-report.ts +43 -0
- package/scripts/harness/validator-system/domain/value-objects/layer-config.ts +61 -0
- package/scripts/harness/validator-system/domain/value-objects/stub-comment-report.ts +42 -0
- package/scripts/harness/validator-system/domain/value-objects/validation-result.ts +89 -0
- package/scripts/harness/validator-system/domain/value-objects/validation-rule.ts +48 -0
- package/scripts/harness/validator-system/domain/value-objects/validator-definition.ts +74 -0
- package/scripts/harness/validator-system/domain/value-objects/validator-id.ts +93 -0
- package/scripts/harness/validator-system/index.ts +51 -0
- package/scripts/harness/validator-system/infrastructure/adapters/adr-foundation-reference-adapter.ts +57 -0
- package/scripts/harness/validator-system/infrastructure/adapters/ast-performance-scanner-adapter.ts +140 -0
- package/scripts/harness/validator-system/infrastructure/adapters/biome-ast-source-code-analyzer-adapter.ts +142 -0
- package/scripts/harness/validator-system/infrastructure/adapters/biome-ast-test-quality-analyzer-adapter.ts +71 -0
- package/scripts/harness/validator-system/infrastructure/adapters/cli-command-registry-adapter.ts +26 -0
- package/scripts/harness/validator-system/infrastructure/adapters/e2e-test-file-registry-adapter.ts +48 -0
- package/scripts/harness/validator-system/infrastructure/adapters/file-system-security-pattern-scanner-adapter.ts +47 -0
- package/scripts/harness/validator-system/infrastructure/adapters/harness-config-validator-config-adapter.ts +73 -0
- package/scripts/harness/validator-system/infrastructure/adapters/import-graph-source-analysis-adapter.ts +71 -0
- package/scripts/harness/validator-system/infrastructure/adapters/it-test-file-analyzer-adapter.ts +85 -0
- package/scripts/harness/validator-system/infrastructure/adapters/json-coverage-report-adapter.ts +50 -0
- package/scripts/harness/validator-system/infrastructure/adapters/markdown-design-document-adapter.ts +75 -0
- package/scripts/harness/validator-system/infrastructure/adapters/nyquist-ac-coverage-policy-adapter.ts +41 -0
- package/scripts/harness/validator-system/infrastructure/adapters/phase-dependency-phase-gate-policy-adapter.ts +46 -0
- package/scripts/harness/validator-system/infrastructure/adapters/source-file-text-scanner-adapter.ts +90 -0
- package/scripts/harness/validator-system/infrastructure/adapters/traceability-metadata-policy-adapter.ts +42 -0
- package/scripts/harness/validator-system/presentation/formatters/agent-validation-result-formatter.ts +34 -0
- package/scripts/harness/validator-system/presentation/formatters/ci-validation-result-formatter.ts +21 -0
- package/scripts/harness/validator-system/presentation/formatters/human-validation-result-formatter.ts +28 -0
- package/scripts/harness/validator-system/presentation/handlers/report-validation-results-handler.ts +68 -0
- package/scripts/harness/validator-system/presentation/handlers/run-quick-mode-handler.ts +63 -0
- package/scripts/harness/validator-system/presentation/handlers/run-validators-handler.ts +137 -0
- package/skills/README.md +21 -0
- package/skills/cascade-updater/SKILL.md +127 -0
- package/skills/cascade-updater/references//345/261/244/345/210/245/345/210/244/345/256/232/343/202/254/343/202/244/343/203/211.md +58 -0
- package/skills/codebase-mapper/SKILL.md +151 -0
- package/skills/codex-delegator/SKILL.md +312 -0
- package/skills/codex-delegator/references/prompt-patterns.md +165 -0
- package/skills/codex-delegator/references/review-dimensions.md +116 -0
- package/skills/consistency-checker/SKILL.md +155 -0
- package/skills/consistency-checker/references//343/203/201/343/202/247/343/203/203/343/202/257/343/203/252/343/202/271/343/203/210.md +60 -0
- package/skills/doc-freshness-checker/SKILL.md +131 -0
- package/skills/domain-designer/SKILL.md +152 -0
- package/skills/engineering-perspective/SKILL.md +136 -0
- package/skills/engineering-perspective/references/domain-model.md +363 -0
- package/skills/engineering-perspective/references/glossary.md +261 -0
- package/skills/environment-designer/SKILL.md +187 -0
- package/skills/implementation-planner/SKILL.md +156 -0
- package/skills/implementation-planner/references/document-structure.md +116 -0
- package/skills/implementation-planner/references/plan-template.md +177 -0
- package/skills/implementation-planner/references/workflow.md +164 -0
- package/skills/implementation-readiness-checker/SKILL.md +250 -0
- package/skills/it-test-designer/SKILL.md +334 -0
- package/skills/it-test-logic-designer/SKILL.md +627 -0
- package/skills/logical-designer/SKILL.md +186 -0
- package/skills/mock-designer/SKILL.md +189 -0
- package/skills/pointer-validator/SKILL.md +96 -0
- package/skills/product-architect/SKILL.md +131 -0
- package/skills/quick-implementor/SKILL.md +103 -0
- package/skills/scenario-test-designer/SKILL.md +307 -0
- package/skills/scenario-test-logic-designer/SKILL.md +504 -0
- package/skills/skill-creator/SKILL.md +371 -0
- package/skills/skill-creator/license.txt +202 -0
- package/skills/skill-creator/scripts/__pycache__/quick_validate.cpython-312.pyc +0 -0
- package/skills/skill-creator/scripts/init_skill.py +378 -0
- package/skills/skill-creator/scripts/package_skill.py +111 -0
- package/skills/skill-creator/scripts/quick_validate.py +101 -0
- package/skills/story-implementor/SKILL.md +254 -0
- package/skills/story-mapper/SKILL.md +217 -0
- package/skills/story-writer/SKILL.md +142 -0
- package/skills/test-coverage-checker/SKILL.md +450 -0
- package/skills/uiux-designer/SKILL.md +292 -0
- package/skills/unit-designer/SKILL.md +183 -0
- package/skills/unit-test-designer/SKILL.md +326 -0
- package/skills/unit-test-logic-designer/SKILL.md +429 -0
- package/templates/.claude/scripts/analyze-errors-hook.sh +125 -0
- package/templates/.claude/scripts/deny-check.sh +55 -0
- package/templates/.claude/scripts/format-settings-hook.sh +36 -0
- package/templates/.claude/scripts/format-typescript-hook.sh +82 -0
- package/templates/.claude/scripts/hook-config.json +5 -0
- package/templates/.claude/settings.json +83 -0
- package/templates/.husky/pre-commit +2 -0
- package/templates/phasegate.config.json +30 -0
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: consistency-checker
|
|
3
|
+
description: AIDLC設計文書群のレイヤー間整合性チェック・矛盾/漏れ検出
|
|
4
|
+
model: sonnet
|
|
5
|
+
review: opus
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Consistency Checker
|
|
9
|
+
|
|
10
|
+
AIDLCプロセスの全レイヤー設計文書を横断的に検証し、矛盾・漏れ・不整合を検出するスキル。
|
|
11
|
+
|
|
12
|
+
## 前提条件チェック
|
|
13
|
+
|
|
14
|
+
### 必須インプット
|
|
15
|
+
- **チェック対象の設計文書群** — 存在するレイヤーのみチェック。存在しないレイヤーはスキップ
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## ⚠️ 3フェーズ実行ルール
|
|
20
|
+
|
|
21
|
+
**このスキルは3フェーズで実行する。**
|
|
22
|
+
- **Phase 1(計画)**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
|
|
23
|
+
- **Phase 2(実行)**: Sonnet 4.6 に委任して成果物を生成する(`scripts/delegate-sonnet.sh` 経由)
|
|
24
|
+
- **Phase 3(レビュー)**: Opus が成果物を検証し、問題があれば直接修正する
|
|
25
|
+
|
|
26
|
+
**Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Phase 1: チェック計画(plan)
|
|
31
|
+
|
|
32
|
+
### 目的
|
|
33
|
+
チェック対象・範囲を確認し、人間の承認を得る。
|
|
34
|
+
|
|
35
|
+
### 出力
|
|
36
|
+
会話内で以下を報告する:
|
|
37
|
+
|
|
38
|
+
```markdown
|
|
39
|
+
# 整合性チェック計画
|
|
40
|
+
|
|
41
|
+
## 1. チェック対象ファイル一覧
|
|
42
|
+
| # | レイヤー | ファイルパス | 存在 |
|
|
43
|
+
|---|---------|-----------|------|
|
|
44
|
+
|
|
45
|
+
## 2. 実行するチェック項目
|
|
46
|
+
(存在するレイヤーのみ対象)
|
|
47
|
+
- [ ] ストーリー↔Unit
|
|
48
|
+
- [ ] Unit↔Domain
|
|
49
|
+
- [ ] ...
|
|
50
|
+
|
|
51
|
+
## 3. スキップするチェック項目
|
|
52
|
+
(文書が存在しないため)
|
|
53
|
+
- ...
|
|
54
|
+
|
|
55
|
+
## 4. QA(不明点・確認事項)
|
|
56
|
+
|
|
57
|
+
### [Question] Q1: {質問タイトル}
|
|
58
|
+
{質問の詳細と背景}
|
|
59
|
+
**推奨案:** {AIの推奨案}
|
|
60
|
+
|
|
61
|
+
[Answer]
|
|
62
|
+
(人間が回答を記入)
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Phase 1 完了条件
|
|
66
|
+
- チェック計画を報告した
|
|
67
|
+
- 不明点がある場合は`[Question]`セクションに記載した
|
|
68
|
+
- **人間にボールを渡した**
|
|
69
|
+
- **チェック結果はまだ報告していない**
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## Phase 2: 実行(execution)
|
|
74
|
+
|
|
75
|
+
### 開始条件
|
|
76
|
+
- 人間がPhase 1のチェック計画を承認した
|
|
77
|
+
|
|
78
|
+
### チェック項目
|
|
79
|
+
|
|
80
|
+
以下を上位→下位の順で検証する。各チェックの具体的な検証手法は [references/チェックリスト.md](references/チェックリスト.md) を参照。
|
|
81
|
+
|
|
82
|
+
1. **ストーリー↔Unit** — 全ストーリーがいずれかのUnitに所属しているか
|
|
83
|
+
2. **Unit↔Domain** — 全Unitの業務概念がドメインモデルに定義されているか
|
|
84
|
+
3. **Domain↔論理設計** — 全集約/リポジトリに対応するコンポーネントがあるか
|
|
85
|
+
4. **論理設計↔環境設計** — 全サービス/DB変更が環境設計に列挙されているか
|
|
86
|
+
5. **環境設計↔実装** — 環境設計の制約が実装に反映されているか
|
|
87
|
+
6. **マイグレーション台帳↔実ファイル** — 台帳のエントリと実ファイルが一致しているか
|
|
88
|
+
7. **制約集↔実装** — フレームワーク制約集のルールがコードで遵守されているか
|
|
89
|
+
|
|
90
|
+
### Phase 2 最低出力基準(Sonnet委任時の品質制約)
|
|
91
|
+
|
|
92
|
+
以下の基準を満たさない出力は不完全とみなし、Phase 3レビューでBLOCKとする。
|
|
93
|
+
|
|
94
|
+
| 基準 | 最低要件 |
|
|
95
|
+
|------|---------|
|
|
96
|
+
| チェック項目網羅 | Phase 1で計画した全チェック項目が実行されていること |
|
|
97
|
+
| 具体的な不整合記述 | 検出された不整合に具体的なファイル名・行・内容が記載されていること |
|
|
98
|
+
| 重要度判定 | 各不整合に重要度(高/中/低)が付与されていること |
|
|
99
|
+
| 推奨アクション | 各不整合に対する具体的な修正アクションが提案されていること |
|
|
100
|
+
| スキップ理由 | スキップしたチェック項目にスキップ理由が記載されていること |
|
|
101
|
+
|
|
102
|
+
### 出力フォーマット
|
|
103
|
+
|
|
104
|
+
```markdown
|
|
105
|
+
# 整合性チェック結果
|
|
106
|
+
|
|
107
|
+
## 検出された不整合
|
|
108
|
+
|
|
109
|
+
| # | レイヤー間 | 不整合内容 | 重要度 | 推奨アクション |
|
|
110
|
+
|---|----------|----------|--------|-------------|
|
|
111
|
+
|
|
112
|
+
## チェック対象外(スキップ)
|
|
113
|
+
- ...
|
|
114
|
+
|
|
115
|
+
## サマリー
|
|
116
|
+
- チェック対象レイヤー数: N
|
|
117
|
+
- 不整合件数: N
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## Phase 3: レビュー(Opus review)
|
|
125
|
+
|
|
126
|
+
### 実行主体
|
|
127
|
+
メインセッション(Opus 4.6)が実行する。Sonnetへの再委任は行わない。
|
|
128
|
+
|
|
129
|
+
### レビュー手順
|
|
130
|
+
1. Sonnetが出力したファイルを読み込む
|
|
131
|
+
2. `docs/principles/model-routing.md` のレビュー観点 R1〜R7 に沿って検証する
|
|
132
|
+
3. **スキル固有レビュー観点**を検証する
|
|
133
|
+
4. 判定結果を出力する
|
|
134
|
+
|
|
135
|
+
### スキル固有レビュー観点(BLOCK基準)
|
|
136
|
+
- [ ] Phase 1で計画した全チェック項目が実行されているか
|
|
137
|
+
- [ ] 不整合の記述が具体的か(曖昧な「不一致あり」だけでないか)
|
|
138
|
+
- [ ] 重要度の判定基準が一貫しているか
|
|
139
|
+
- [ ] 推奨アクションが実行可能か(対応スキル名が明記されているか)
|
|
140
|
+
- [ ] 偽陰性がないか(明らかな不整合を見逃していないか)
|
|
141
|
+
|
|
142
|
+
### engineering-perspective レビュー観点(WARN基準)
|
|
143
|
+
- [ ] ドメインスメル(責務混在・言語の乖離・境界不明確)がレイヤー横断で検出されているか
|
|
144
|
+
- [ ] SOLID違反(SRP・DIP)が設計レイヤー間で見逃されていないか
|
|
145
|
+
- [ ] コードスメル(Shotgun Surgery等)の兆候が設計変更の波及パターンから検出されているか
|
|
146
|
+
|
|
147
|
+
### 判定と修正
|
|
148
|
+
- **BLOCK項目にFAIL** → Opusが直接修正してから完了とする
|
|
149
|
+
- **WARNのみFAIL** → Opusが直接修正してから完了とする
|
|
150
|
+
- **全PASS** → 完了
|
|
151
|
+
|
|
152
|
+
## 注意事項
|
|
153
|
+
|
|
154
|
+
- 不整合の修正は行わず、検出と推奨アクションの提示に徹する
|
|
155
|
+
- 技術スタック固有の用語は使わず、汎用的な表現でチェックする
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# 整合性チェック 検証手法ガイド
|
|
2
|
+
|
|
3
|
+
各チェック項目の汎用的な検証手法。技術スタックに依存しない。
|
|
4
|
+
|
|
5
|
+
## 1. ストーリー ↔ Unit
|
|
6
|
+
|
|
7
|
+
**手法:** ストーリーIDの全数マッチング
|
|
8
|
+
|
|
9
|
+
1. ストーリー一覧からストーリーIDを全て抽出する
|
|
10
|
+
2. 各Unit定義ファイルからストーリーID参照を全て抽出する
|
|
11
|
+
3. ストーリー一覧にあるがUnit定義に無いID = 孤立ストーリー
|
|
12
|
+
|
|
13
|
+
## 2. Unit ↔ Domain
|
|
14
|
+
|
|
15
|
+
**手法:** 業務概念のクロスリファレンス
|
|
16
|
+
|
|
17
|
+
1. 各Unit定義から主要な業務名詞(エンティティ候補)を抽出する
|
|
18
|
+
2. ドメインモデルの集約・エンティティ・値オブジェクト名と照合する
|
|
19
|
+
3. Unit定義に登場するがドメインモデルに未定義の業務名詞 = 漏れ
|
|
20
|
+
|
|
21
|
+
## 3. Domain ↔ 論理設計
|
|
22
|
+
|
|
23
|
+
**手法:** 集約→コンポーネント対応表の照合
|
|
24
|
+
|
|
25
|
+
1. ドメインモデルから集約名・リポジトリインターフェース名を抽出する
|
|
26
|
+
2. 論理設計からコンポーネント名(コントローラ、ユースケース、リポジトリ実装等)を抽出する
|
|
27
|
+
3. ドメインモデルの集約に対応するコンポーネントが論理設計に無い = 漏れ
|
|
28
|
+
|
|
29
|
+
## 4. 論理設計 ↔ 環境設計
|
|
30
|
+
|
|
31
|
+
**手法:** インフラ要件の突合
|
|
32
|
+
|
|
33
|
+
1. 論理設計から以下を抽出する:
|
|
34
|
+
- 新規サービス/関数の定義
|
|
35
|
+
- 新規テーブル/ビュー/マイグレーションの定義
|
|
36
|
+
- 外部連携・認証に関する記述
|
|
37
|
+
2. 環境設計の各セクションと突合する:
|
|
38
|
+
- サービス構成マニフェストに全サービスが列挙されているか
|
|
39
|
+
- マイグレーション台帳に全DB変更が記載されているか
|
|
40
|
+
|
|
41
|
+
## 5. 環境設計 ↔ 実装
|
|
42
|
+
|
|
43
|
+
**手法:** 設定ファイルとコードの機械的照合
|
|
44
|
+
|
|
45
|
+
1. 環境設計のマイグレーション台帳からファイル名を抽出 → 実ファイルの存在確認
|
|
46
|
+
2. 環境設計のサービス構成から設定項目を抽出 → 設定ファイルとの照合
|
|
47
|
+
3. 環境設計のフレームワーク制約集からルールを抽出 → コード内のパターン検索
|
|
48
|
+
|
|
49
|
+
## 汎用検索パターン例
|
|
50
|
+
|
|
51
|
+
```
|
|
52
|
+
# ストーリーID抽出(マークダウンテーブルから)
|
|
53
|
+
grep -oE 'US-[0-9]+|US-DEV-[0-9]+' docs/product/user_stories.md
|
|
54
|
+
|
|
55
|
+
# Unit内のストーリー参照抽出
|
|
56
|
+
grep -oE 'US-[0-9]+|US-DEV-[0-9]+' docs/product/units/*.md
|
|
57
|
+
|
|
58
|
+
# ドメインモデルの集約名抽出
|
|
59
|
+
grep -E '^### .+集約|Aggregate' docs/product/construction/*/domain_model.md
|
|
60
|
+
```
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: doc-freshness-checker
|
|
3
|
+
description: 設計文書の鮮度チェック(L4バリデータ拡張)。`p2:check-freshness` CLIを使い、設計文書の最終更新日が閾値を超えていないか、コード変更と設計文書の乖離がないかを検出する。使用タイミング: 「設計文書が古くなっていないか確認して」「ドキュメントの鮮度チェックを実行して」「L4 freshness チェック」「設計とコードの乖離を調べて」など。
|
|
4
|
+
model: sonnet
|
|
5
|
+
review: opus
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Doc Freshness Checker
|
|
9
|
+
|
|
10
|
+
設計文書の鮮度(freshness)を検証し、古くなった文書や対応コードとの乖離を検出するスキル。
|
|
11
|
+
`phase2-extensions` Unit の `p2:check-freshness` CLIをラップし、結果を解釈・対処する。
|
|
12
|
+
|
|
13
|
+
## 前提条件
|
|
14
|
+
|
|
15
|
+
- `phasegate.config.json` に `docFreshnessThresholds` が設定されていること(未設定時はデフォルト値使用)
|
|
16
|
+
- git リポジトリ内で実行すること(最終更新日は `git log` で判定)
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## ⚠️ 2フェーズ実行ルール
|
|
21
|
+
|
|
22
|
+
- **Phase 1(計画)**: チェック対象スコープを確認し、人間の承認を得る
|
|
23
|
+
- **Phase 2(実行)**: CLIを実行し、結果を解釈してアクションを提案する
|
|
24
|
+
|
|
25
|
+
**Phase 1/2を同時に実行してはならない。**
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Phase 1: チェック計画(plan)
|
|
30
|
+
|
|
31
|
+
### 出力(会話内のみ)
|
|
32
|
+
|
|
33
|
+
```markdown
|
|
34
|
+
# Doc Freshness チェック計画
|
|
35
|
+
|
|
36
|
+
## チェック対象スコープ
|
|
37
|
+
- ディレクトリ: {デフォルト: docs/product/construction/}
|
|
38
|
+
- 閾値: {phasegate.config.json の値 or デフォルト 30日}
|
|
39
|
+
|
|
40
|
+
## 実行コマンド
|
|
41
|
+
pnpm run p2:check-freshness [--dir {path}] [--threshold {days}]
|
|
42
|
+
|
|
43
|
+
## QA
|
|
44
|
+
[Question] Q1: ...
|
|
45
|
+
[Answer]
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### Phase 1 完了条件
|
|
49
|
+
- スコープを報告した
|
|
50
|
+
- 人間にボールを渡した
|
|
51
|
+
- **CLIはまだ実行していない**
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## Phase 2: 実行(execution)
|
|
56
|
+
|
|
57
|
+
### Step 1: CLIの実行
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
pnpm run p2:check-freshness
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
オプション:
|
|
64
|
+
- `--dir <path>` — チェック対象ディレクトリ(デフォルト: `docs/product/construction/`)
|
|
65
|
+
- `--threshold <days>` — 警告閾値(日数)
|
|
66
|
+
|
|
67
|
+
### Step 2: 結果の解釈
|
|
68
|
+
|
|
69
|
+
`CheckDocFreshnessOutput` の構造:
|
|
70
|
+
|
|
71
|
+
| フィールド | 意味 |
|
|
72
|
+
|-----------|------|
|
|
73
|
+
| `results[].status` | `ok` / `warn` / `error` |
|
|
74
|
+
| `results[].documentPath` | チェック対象ファイルパス |
|
|
75
|
+
| `results[].daysSinceUpdate` | 最終更新からの日数 |
|
|
76
|
+
| `results[].threshold` | 設定閾値 |
|
|
77
|
+
| `summary.error` | エラー件数(即対応必要) |
|
|
78
|
+
| `summary.warn` | 警告件数(確認推奨) |
|
|
79
|
+
|
|
80
|
+
### Step 3: アクションの提案
|
|
81
|
+
|
|
82
|
+
| 状態 | 推奨アクション |
|
|
83
|
+
|------|--------------|
|
|
84
|
+
| `error`(閾値超過) | cascade-updater で上位設計文書を更新 |
|
|
85
|
+
| `warn`(閾値近接) | 設計文書の内容確認・必要に応じて更新 |
|
|
86
|
+
| `ok` | 対応不要 |
|
|
87
|
+
|
|
88
|
+
### 出力フォーマット
|
|
89
|
+
|
|
90
|
+
```markdown
|
|
91
|
+
# Doc Freshness チェック結果
|
|
92
|
+
|
|
93
|
+
## サマリー
|
|
94
|
+
- 総ドキュメント数: N
|
|
95
|
+
- ok: N / warn: N / error: N
|
|
96
|
+
|
|
97
|
+
## 要対応(error)
|
|
98
|
+
| ファイル | 最終更新 | 閾値超過日数 | 推奨アクション |
|
|
99
|
+
|---------|---------|------------|--------------|
|
|
100
|
+
|
|
101
|
+
## 要確認(warn)
|
|
102
|
+
| ファイル | 最終更新 | 残り日数 |
|
|
103
|
+
|---------|---------|---------|
|
|
104
|
+
|
|
105
|
+
## 次のアクション
|
|
106
|
+
(errorがある場合は `cascade-updater` の実行を提案)
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## phasegate.config.json 設定例
|
|
112
|
+
|
|
113
|
+
```json
|
|
114
|
+
{
|
|
115
|
+
"docFreshnessThresholds": {
|
|
116
|
+
"domain_model.md": 90,
|
|
117
|
+
"logical_design.md": 60,
|
|
118
|
+
"unit_test_design.md": 30,
|
|
119
|
+
"default": 30
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
## 関連スキル
|
|
127
|
+
|
|
128
|
+
| スキル | 用途 |
|
|
129
|
+
|-------|------|
|
|
130
|
+
| `cascade-updater` | errorが検出された設計文書の更新 |
|
|
131
|
+
| `consistency-checker` | 文書間整合性の検証(freshness修正後の確認) |
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: domain-designer
|
|
3
|
+
description: DDD戦術パターンでドメインモデル(集約・エンティティ・VO・イベント)を設計(AIDLC Step 2.1)
|
|
4
|
+
model: opus
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Domain Designer
|
|
8
|
+
|
|
9
|
+
DDD戦術パターンを用いてドメインモデルを設計するスキル。AIDLCプロセスのStep 2.1に対応。
|
|
10
|
+
|
|
11
|
+
## 前提条件チェック
|
|
12
|
+
|
|
13
|
+
### 必須インプット(存在しなければ`[Question]`で提供を要求)
|
|
14
|
+
- **Unit定義** — 対象Unitの担当ストーリー・機能要件
|
|
15
|
+
- **統合契約** — Unit間のAPI仕様
|
|
16
|
+
|
|
17
|
+
### 任意インプット(あれば参照)
|
|
18
|
+
- **既存ドメインモデル** — 既にある場合はフォーマットに準拠する
|
|
19
|
+
- **プロダクト概要** — ユビキタス言語やコアドメインの理解
|
|
20
|
+
- **Shared Kernel** — 複数Unitが共有するドメインモデル
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## ⚠️ 上位レイヤー存在チェック
|
|
25
|
+
|
|
26
|
+
**このスキルは AIDLC Step 4「Domainの設計」に対応します。実行前に上位設計の存在を確認してください。**
|
|
27
|
+
|
|
28
|
+
### 依存する上位設計文書
|
|
29
|
+
|
|
30
|
+
| ファイル | 必須 | チェック方法 |
|
|
31
|
+
|---------|------|------------|
|
|
32
|
+
| `docs/product/units/{対象unit}.md` | ✅ 必須 | 対象Unitのファイル存在を確認 |
|
|
33
|
+
| `docs/product/units/integration_contract.md` | ✅ 必須 | ファイルの存在を確認 |
|
|
34
|
+
|
|
35
|
+
### 上位設計が存在しない場合のアクション
|
|
36
|
+
|
|
37
|
+
上位設計文書が存在しない場合、**設計を開始せず**、以下を行う:
|
|
38
|
+
|
|
39
|
+
1. **状況報告** — ユーザーに不足している設計文書を明示
|
|
40
|
+
2. **選択肢提示** — 以下の選択肢を提示
|
|
41
|
+
- 上位設計(unit-designer)を先に実行する
|
|
42
|
+
- 上位設計をスキップして進める(非推奨)
|
|
43
|
+
3. **ユーザー指示待ち** — 独自判断で設計を開始しない
|
|
44
|
+
|
|
45
|
+
**報告テンプレート:**
|
|
46
|
+
```markdown
|
|
47
|
+
## ⚠️ 上位レイヤー設計が見つかりません
|
|
48
|
+
|
|
49
|
+
以下の設計文書が存在しないため、ドメイン設計を開始できません:
|
|
50
|
+
- `docs/product/units/{unit}.md` ❌ 未作成
|
|
51
|
+
- `docs/product/units/integration_contract.md` ❌ 未作成
|
|
52
|
+
|
|
53
|
+
### 推奨アクション
|
|
54
|
+
`unit-designer` スキルを使用してUnit設計を作成してください。
|
|
55
|
+
|
|
56
|
+
### 選択肢
|
|
57
|
+
1. **unit-designerを先に実行する**(推奨)
|
|
58
|
+
2. **このまま進める**(上位設計なしで進める場合、整合性リスクあり)
|
|
59
|
+
|
|
60
|
+
どちらを選択しますか?
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## ⚠️ 2フェーズ実行ルール
|
|
66
|
+
|
|
67
|
+
**このスキルは必ず2フェーズに分けて実行する。Phase 1で計画を作成し、人間の承認を得てからPhase 2で成果物を作成する。Phase 1とPhase 2を同時に実行してはならない。**
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Phase 1: 計画(plan)
|
|
72
|
+
|
|
73
|
+
### 目的
|
|
74
|
+
ドメインモデリングの方針・集約の特定方針・不明点を整理し、人間の承認を得る。
|
|
75
|
+
|
|
76
|
+
### 出力ファイル
|
|
77
|
+
`docs/inception/{unit}/domain_model_plan.md`
|
|
78
|
+
|
|
79
|
+
### 計画ファイルの構成
|
|
80
|
+
|
|
81
|
+
```markdown
|
|
82
|
+
# ドメインモデル設計計画: {Unit名}
|
|
83
|
+
|
|
84
|
+
## 1. スコープ
|
|
85
|
+
- 対象Unitと担当ストーリー
|
|
86
|
+
- 他Unitとの境界
|
|
87
|
+
|
|
88
|
+
## 2. 集約候補の分析
|
|
89
|
+
- ストーリーから抽出した業務名詞一覧
|
|
90
|
+
- 集約候補とその根拠
|
|
91
|
+
|
|
92
|
+
## 3. 設計方針
|
|
93
|
+
- 集約の粒度方針
|
|
94
|
+
- 値オブジェクト vs エンティティの判断基準
|
|
95
|
+
- Shared Kernelとの関係
|
|
96
|
+
|
|
97
|
+
## 4. QA(不明点・確認事項)
|
|
98
|
+
|
|
99
|
+
### [Question] Q1: {質問タイトル}
|
|
100
|
+
{質問の詳細と背景}
|
|
101
|
+
**推奨案:** {AIの推奨案}
|
|
102
|
+
|
|
103
|
+
[Answer]
|
|
104
|
+
(人間が回答を記入)
|
|
105
|
+
|
|
106
|
+
## 5. 前提条件・リスク
|
|
107
|
+
- ...
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### Phase 1 完了条件
|
|
111
|
+
- 計画ファイルを出力した
|
|
112
|
+
- 不明点がある場合は`[Question]`セクションに記載した
|
|
113
|
+
- **人間にボールを渡した**
|
|
114
|
+
- **成果物(ドメインモデル本体)はまだ作成していない**
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## Phase 2: 実行(execution)
|
|
119
|
+
|
|
120
|
+
### 開始条件
|
|
121
|
+
- 人間がPhase 1の計画を承認した
|
|
122
|
+
- QAセクションの全[Question]に[Answer]が記入されている(QAがある場合)
|
|
123
|
+
|
|
124
|
+
### ワークフロー
|
|
125
|
+
|
|
126
|
+
1. **集約の特定** — ライフサイクルが一致する業務名詞を集約にまとめ、集約ルートを決定
|
|
127
|
+
2. **エンティティ・値オブジェクトの設計** — 各集約内部の構造、メソッド、設計ルールに沿った配置
|
|
128
|
+
3. **不変条件の定義** — 各集約のビジネスルール制約を列挙
|
|
129
|
+
4. **状態遷移の定義** — 状態遷移表の作成
|
|
130
|
+
5. **ドメインイベントの定義** — 集約が発行するイベントを列挙
|
|
131
|
+
6. **クラス図の作成** — Mermaid形式で関係を図示
|
|
132
|
+
7. **品質評価(engineering-perspective)** — 設計完了後、以下の観点で自己評価し、問題があれば修正してから成果物を確定する
|
|
133
|
+
- **ドメインスメル**: 責務混在・不適切なVO・言語の乖離・境界不明確がないか
|
|
134
|
+
- **SOLID**: 集約がSRPに従っているか、集約間の依存方向が正しいか
|
|
135
|
+
- **シンプルさ**: 過度に複雑なモデルになっていないか、各集約を簡潔に説明できるか
|
|
136
|
+
|
|
137
|
+
### 出力ファイル
|
|
138
|
+
|
|
139
|
+
| 種別 | 配置先 |
|
|
140
|
+
|------|--------|
|
|
141
|
+
| 成果物 | `docs/product/construction/{unit}/domain_model.md` |
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
## 注意事項
|
|
146
|
+
|
|
147
|
+
- **ファイル配置は `docs/folder_management_rules.md` に従うこと**
|
|
148
|
+
- **コードスニペットは生成しない**(設計文書のみ)
|
|
149
|
+
- ユビキタス言語がある場合、命名はそれに準拠する
|
|
150
|
+
- 既存のShared Kernelがある場合は、共有モデルとの整合性を保つ
|
|
151
|
+
- ビジネスロジックは集約・エンティティ・値オブジェクトに配置する(ユースケースは調整役に徹する)
|
|
152
|
+
- 集約間の参照はIDのみ(直接参照禁止)
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: engineering-perspective
|
|
3
|
+
description: |
|
|
4
|
+
ケント・ベック + マーティン・ファウラー + アンクル・ボブ + エリック・エヴァンスの視点を統合したエンジニアリング思考フレームワーク。
|
|
5
|
+
以下の場面で使用:
|
|
6
|
+
(1) 設計・コードレビュー時に品質を多角的に評価したい
|
|
7
|
+
(2) 要件や仕様を整理・明確化したい
|
|
8
|
+
(3) コードスメル・SOLID違反・ドメインスメルを検知したい
|
|
9
|
+
(4) TDD/リファクタリング/DDDのベストプラクティスを適用したい
|
|
10
|
+
(5) チーム議論で共通認識を構築したい
|
|
11
|
+
トリガー例: 「レビューして」「これどう思う?」「設計見て」「SOLID的にどう?」「リファクタ必要?」「ドメイン的に正しい?」
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
# Engineering Perspective
|
|
15
|
+
|
|
16
|
+
4人の巨匠の視点を統合し、実用性・シンプルさ・説明責任の観点でレビュー・設計・議論を行う。
|
|
17
|
+
|
|
18
|
+
## 視点一覧
|
|
19
|
+
|
|
20
|
+
| 視点 | 専門 | キーワード |
|
|
21
|
+
|------|------|------------|
|
|
22
|
+
| **統合視点** | 統合・実用性 | 前提確認, シンプルさ, 説明責任 |
|
|
23
|
+
| **ケント・ベック** | XP・TDD | Red-Green-Refactor, YAGNI, 小さなステップ |
|
|
24
|
+
| **マーティン・ファウラー** | リファクタリング | コードスメル, Extract Method, 読みやすさ |
|
|
25
|
+
| **アンクル・ボブ** | Clean Code | SOLID, 依存性逆転, プロフェッショナリズム |
|
|
26
|
+
| **エリック・エヴァンス** | DDD | ユビキタス言語, 境界づけられたコンテキスト, 集約 |
|
|
27
|
+
|
|
28
|
+
## 統合思考フロー
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
問題 → 前提確認(統合視点) → 並行評価(4視点) → 統合判断(統合視点) → ガイダンス
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### 1. 前提確認(統合視点)
|
|
35
|
+
|
|
36
|
+
まず確認:
|
|
37
|
+
- **コンテキスト**: どの文脈での話か
|
|
38
|
+
- **境界**: どこまでが対象範囲か
|
|
39
|
+
- **目的**: 何を達成したいのか
|
|
40
|
+
|
|
41
|
+
### 2. 並行評価(4視点)
|
|
42
|
+
|
|
43
|
+
| 視点 | 評価観点 |
|
|
44
|
+
|------|----------|
|
|
45
|
+
| ケント・ベック | テストある? YAGNI守ってる? |
|
|
46
|
+
| ファウラー | コードスメルない? リファクタ必要? |
|
|
47
|
+
| アンクル・ボブ | SOLID守ってる? 依存の方向正しい? |
|
|
48
|
+
| エヴァンス | ドメイン表現してる? 言語一致してる? |
|
|
49
|
+
|
|
50
|
+
### 3. 統合判断(統合視点)
|
|
51
|
+
|
|
52
|
+
各視点の結果を統合し、実用性を考慮してシンプルな改善案を選択。
|
|
53
|
+
|
|
54
|
+
## スメル検知
|
|
55
|
+
|
|
56
|
+
### コードスメル(ファウラー視点)
|
|
57
|
+
|
|
58
|
+
| スメル | 兆候 | 対処 |
|
|
59
|
+
|--------|------|------|
|
|
60
|
+
| Long Method | メソッドが長い | Extract Method |
|
|
61
|
+
| Feature Envy | 他クラスのデータ多用 | Move Method |
|
|
62
|
+
| Primitive Obsession | 基本型の過剰使用 | Value Objectに置換 |
|
|
63
|
+
| Shotgun Surgery | 変更が多クラスに波及 | Move Method/Field |
|
|
64
|
+
|
|
65
|
+
### SOLID違反(アンクル・ボブ視点)
|
|
66
|
+
|
|
67
|
+
| 原則 | 違反の兆候 | 対処 |
|
|
68
|
+
|------|------------|------|
|
|
69
|
+
| SRP | 変更理由が複数 | クラス分割 |
|
|
70
|
+
| OCP | 変更時に既存コード修正 | 抽象化 |
|
|
71
|
+
| LSP | 派生型で例外発生 | 継承の見直し |
|
|
72
|
+
| ISP | 使わないメソッドに依存 | IF分割 |
|
|
73
|
+
| DIP | 具象に依存 | 抽象に依存 |
|
|
74
|
+
|
|
75
|
+
### ドメインスメル(エヴァンス + 統合視点)
|
|
76
|
+
|
|
77
|
+
| スメル | 兆候 | 対処 |
|
|
78
|
+
|--------|------|------|
|
|
79
|
+
| 責務混在 | 集約に複数責務 | 概念を分離 |
|
|
80
|
+
| 不適切なVO | nullable値オブジェクト | ドメイン的に分解 |
|
|
81
|
+
| 言語の乖離 | コードと用語が不一致 | 命名統一 |
|
|
82
|
+
| 境界不明確 | コンテキストが混在 | 境界を明確化 |
|
|
83
|
+
|
|
84
|
+
## 評価基準
|
|
85
|
+
|
|
86
|
+
### Good判定(すべて満たす)
|
|
87
|
+
|
|
88
|
+
- [ ] シンプル・説明可能・実用的(統合視点)
|
|
89
|
+
- [ ] テストがある・YAGNIに従う(ケント・ベック)
|
|
90
|
+
- [ ] コードスメルがない(ファウラー)
|
|
91
|
+
- [ ] SOLID原則に従う・依存が内向き(アンクル・ボブ)
|
|
92
|
+
- [ ] ドメインを適切に表現・言語が一致(エヴァンス)
|
|
93
|
+
|
|
94
|
+
### NG判定(いずれかに該当)
|
|
95
|
+
|
|
96
|
+
- [ ] 複雑・目的不明・説明不能
|
|
97
|
+
- [ ] テストなし・過剰設計
|
|
98
|
+
- [ ] 重大なコードスメル
|
|
99
|
+
- [ ] SOLID違反・依存が外向き
|
|
100
|
+
- [ ] モデル不一致・言語の乖離
|
|
101
|
+
|
|
102
|
+
## 表現パターン
|
|
103
|
+
|
|
104
|
+
### 質問
|
|
105
|
+
|
|
106
|
+
| 視点 | パターン | 場面 |
|
|
107
|
+
|------|----------|------|
|
|
108
|
+
| 統合視点 | 「前提は?」 | 議論開始時 |
|
|
109
|
+
| 統合視点 | 「具体例にすると?」 | 抽象的な話 |
|
|
110
|
+
| ケント・ベック | 「テストは書いた?」 | 実装レビュー |
|
|
111
|
+
| ファウラー | 「これ匂う?」 | コードレビュー |
|
|
112
|
+
| アンクル・ボブ | 「依存の方向は?」 | 設計レビュー |
|
|
113
|
+
| エヴァンス | 「ドメインエキスパートはこう呼ぶ?」 | 命名議論 |
|
|
114
|
+
|
|
115
|
+
### 指摘
|
|
116
|
+
|
|
117
|
+
| 視点 | パターン | 場面 |
|
|
118
|
+
|------|----------|------|
|
|
119
|
+
| 統合視点 | 「それって違くない?」 | スメル検知 |
|
|
120
|
+
| ケント・ベック | 「今必要ないなら作らない」 | 過剰設計 |
|
|
121
|
+
| ファウラー | 「リファクタしてから機能追加」 | 変更前 |
|
|
122
|
+
| アンクル・ボブ | 「責務が複数ある」 | SRP違反 |
|
|
123
|
+
| エヴァンス | 「コンテキストが混ざってる」 | 境界不明確 |
|
|
124
|
+
|
|
125
|
+
### 開発アプローチ
|
|
126
|
+
|
|
127
|
+
- 「バーティカルスライスでまず価値提供」(統合視点)
|
|
128
|
+
- 「Make it work, make it right, make it fast」(ケント・ベック)
|
|
129
|
+
- 「2回目で抽象化を検討」(ファウラー)
|
|
130
|
+
- 「ボーイスカウトルール: 来た時より美しく」(アンクル・ボブ)
|
|
131
|
+
- 「モデルとコードを一致させる」(エヴァンス)
|
|
132
|
+
|
|
133
|
+
## 参照ドキュメント
|
|
134
|
+
|
|
135
|
+
- **統合モデル**: [references/domain-model.md](references/domain-model.md) - 完全なドメインモデル図
|
|
136
|
+
- **用語集**: [references/glossary.md](references/glossary.md) - 各視点のユビキタス言語
|