@rsaglobaltech/specgate 0.8.1
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 +1016 -0
- package/README.md +148 -0
- package/bin/specgate.js +2 -0
- package/bin/specgate.ts +383 -0
- package/dist/bin/specgate.js +342 -0
- package/dist/bin/specgate.js.map +1 -0
- package/dist/packages/core/src/application/AddRequirementUseCase.js +24 -0
- package/dist/packages/core/src/application/AddRequirementUseCase.js.map +1 -0
- package/dist/packages/core/src/application/ArchiveChangeUseCase.js +185 -0
- package/dist/packages/core/src/application/ArchiveChangeUseCase.js.map +1 -0
- package/dist/packages/core/src/application/CheckAgainstLockUseCase.js +134 -0
- package/dist/packages/core/src/application/CheckAgainstLockUseCase.js.map +1 -0
- package/dist/packages/core/src/application/GenerateAgentPromptUseCase.js +25 -0
- package/dist/packages/core/src/application/GenerateAgentPromptUseCase.js.map +1 -0
- package/dist/packages/core/src/application/GeneratePlanUseCase.js +135 -0
- package/dist/packages/core/src/application/GeneratePlanUseCase.js.map +1 -0
- package/dist/packages/core/src/application/LinkRequirementUseCase.js +25 -0
- package/dist/packages/core/src/application/LinkRequirementUseCase.js.map +1 -0
- package/dist/packages/core/src/application/RemovePackUseCase.js +28 -0
- package/dist/packages/core/src/application/RemovePackUseCase.js.map +1 -0
- package/dist/packages/core/src/application/UpdateRequirementStatusUseCase.js +37 -0
- package/dist/packages/core/src/application/UpdateRequirementStatusUseCase.js.map +1 -0
- package/dist/packages/core/src/application/ValidateChangeUseCase.js +86 -0
- package/dist/packages/core/src/application/ValidateChangeUseCase.js.map +1 -0
- package/dist/packages/core/src/application/ValidateProjectUseCase.js +101 -0
- package/dist/packages/core/src/application/ValidateProjectUseCase.js.map +1 -0
- package/dist/packages/core/src/application/ports/IDomainPackRepository.js +3 -0
- package/dist/packages/core/src/application/ports/IDomainPackRepository.js.map +1 -0
- package/dist/packages/core/src/application/ports/IHarnessConfigRepository.js +3 -0
- package/dist/packages/core/src/application/ports/IHarnessConfigRepository.js.map +1 -0
- package/dist/packages/core/src/application/ports/ILockfileRepository.js +3 -0
- package/dist/packages/core/src/application/ports/ILockfileRepository.js.map +1 -0
- package/dist/packages/core/src/application/ports/IManifestRepository.js +3 -0
- package/dist/packages/core/src/application/ports/IManifestRepository.js.map +1 -0
- package/dist/packages/core/src/application/ports/IProjectRepository.js +3 -0
- package/dist/packages/core/src/application/ports/IProjectRepository.js.map +1 -0
- package/dist/packages/core/src/application/ports/IRequirementGraphRepository.js +3 -0
- package/dist/packages/core/src/application/ports/IRequirementGraphRepository.js.map +1 -0
- package/dist/packages/core/src/application/ports/ITraceabilityRepository.js +3 -0
- package/dist/packages/core/src/application/ports/ITraceabilityRepository.js.map +1 -0
- package/dist/packages/core/src/domain/AgentPrompt.js +79 -0
- package/dist/packages/core/src/domain/AgentPrompt.js.map +1 -0
- package/dist/packages/core/src/domain/ArchivePlan.js +26 -0
- package/dist/packages/core/src/domain/ArchivePlan.js.map +1 -0
- package/dist/packages/core/src/domain/AuthoringScope.js +48 -0
- package/dist/packages/core/src/domain/AuthoringScope.js.map +1 -0
- package/dist/packages/core/src/domain/ChangeTemplates.js +133 -0
- package/dist/packages/core/src/domain/ChangeTemplates.js.map +1 -0
- package/dist/packages/core/src/domain/CucumberMessages.js +256 -0
- package/dist/packages/core/src/domain/CucumberMessages.js.map +1 -0
- package/dist/packages/core/src/domain/DeclaredArtifacts.js +117 -0
- package/dist/packages/core/src/domain/DeclaredArtifacts.js.map +1 -0
- package/dist/packages/core/src/domain/DeltaSpec.js +219 -0
- package/dist/packages/core/src/domain/DeltaSpec.js.map +1 -0
- package/dist/packages/core/src/domain/Diagnostic.js +75 -0
- package/dist/packages/core/src/domain/Diagnostic.js.map +1 -0
- package/dist/packages/core/src/domain/DomainPack.js +62 -0
- package/dist/packages/core/src/domain/DomainPack.js.map +1 -0
- package/dist/packages/core/src/domain/EmptyAttempt.js +60 -0
- package/dist/packages/core/src/domain/EmptyAttempt.js.map +1 -0
- package/dist/packages/core/src/domain/FileChangeSet.js +37 -0
- package/dist/packages/core/src/domain/FileChangeSet.js.map +1 -0
- package/dist/packages/core/src/domain/Gherkin.js +272 -0
- package/dist/packages/core/src/domain/Gherkin.js.map +1 -0
- package/dist/packages/core/src/domain/GherkinDialects.js +97 -0
- package/dist/packages/core/src/domain/GherkinDialects.js.map +1 -0
- package/dist/packages/core/src/domain/GherkinQuality.js +160 -0
- package/dist/packages/core/src/domain/GherkinQuality.js.map +1 -0
- package/dist/packages/core/src/domain/GherkinTags.js +119 -0
- package/dist/packages/core/src/domain/GherkinTags.js.map +1 -0
- package/dist/packages/core/src/domain/GitSafety.js +77 -0
- package/dist/packages/core/src/domain/GitSafety.js.map +1 -0
- package/dist/packages/core/src/domain/HarnessConfig.js +58 -0
- package/dist/packages/core/src/domain/HarnessConfig.js.map +1 -0
- package/dist/packages/core/src/domain/HarnessReport.js +162 -0
- package/dist/packages/core/src/domain/HarnessReport.js.map +1 -0
- package/dist/packages/core/src/domain/HarnessRun.js +154 -0
- package/dist/packages/core/src/domain/HarnessRun.js.map +1 -0
- package/dist/packages/core/src/domain/InboundChange.js +127 -0
- package/dist/packages/core/src/domain/InboundChange.js.map +1 -0
- package/dist/packages/core/src/domain/Language.js +112 -0
- package/dist/packages/core/src/domain/Language.js.map +1 -0
- package/dist/packages/core/src/domain/Lockfile.js +64 -0
- package/dist/packages/core/src/domain/Lockfile.js.map +1 -0
- package/dist/packages/core/src/domain/PackContribution.js +106 -0
- package/dist/packages/core/src/domain/PackContribution.js.map +1 -0
- package/dist/packages/core/src/domain/PackDelta.js +298 -0
- package/dist/packages/core/src/domain/PackDelta.js.map +1 -0
- package/dist/packages/core/src/domain/PackSpec.js +481 -0
- package/dist/packages/core/src/domain/PackSpec.js.map +1 -0
- package/dist/packages/core/src/domain/ProfileMatch.js +87 -0
- package/dist/packages/core/src/domain/ProfileMatch.js.map +1 -0
- package/dist/packages/core/src/domain/Reconciliation.js +72 -0
- package/dist/packages/core/src/domain/Reconciliation.js.map +1 -0
- package/dist/packages/core/src/domain/RequirementGraph.js +197 -0
- package/dist/packages/core/src/domain/RequirementGraph.js.map +1 -0
- package/dist/packages/core/src/domain/RequirementPlan.js +85 -0
- package/dist/packages/core/src/domain/RequirementPlan.js.map +1 -0
- package/dist/packages/core/src/domain/RequirementReadiness.js +115 -0
- package/dist/packages/core/src/domain/RequirementReadiness.js.map +1 -0
- package/dist/packages/core/src/domain/RequirementSyntax.js +91 -0
- package/dist/packages/core/src/domain/RequirementSyntax.js.map +1 -0
- package/dist/packages/core/src/domain/ResumeState.js +115 -0
- package/dist/packages/core/src/domain/ResumeState.js.map +1 -0
- package/dist/packages/core/src/domain/RunBudget.js +103 -0
- package/dist/packages/core/src/domain/RunBudget.js.map +1 -0
- package/dist/packages/core/src/domain/SpecDiff.js +48 -0
- package/dist/packages/core/src/domain/SpecDiff.js.map +1 -0
- package/dist/packages/core/src/domain/SpecParser.js +406 -0
- package/dist/packages/core/src/domain/SpecParser.js.map +1 -0
- package/dist/packages/core/src/domain/SpecopsManifest.js +90 -0
- package/dist/packages/core/src/domain/SpecopsManifest.js.map +1 -0
- package/dist/packages/core/src/domain/TraceabilityFormat.js +317 -0
- package/dist/packages/core/src/domain/TraceabilityFormat.js.map +1 -0
- package/dist/packages/core/src/domain/TraceabilityMatrix.js +200 -0
- package/dist/packages/core/src/domain/TraceabilityMatrix.js.map +1 -0
- package/dist/packages/core/src/domain/TraceabilityMerge.js +180 -0
- package/dist/packages/core/src/domain/TraceabilityMerge.js.map +1 -0
- package/dist/packages/core/src/domain/ValidationReport.js +53 -0
- package/dist/packages/core/src/domain/ValidationReport.js.map +1 -0
- package/dist/packages/core/src/domain/ValueAnnotations.js +138 -0
- package/dist/packages/core/src/domain/ValueAnnotations.js.map +1 -0
- package/dist/packages/core/src/domain/WriteScope.js +155 -0
- package/dist/packages/core/src/domain/WriteScope.js.map +1 -0
- package/dist/packages/core/src/domain/YamlLite.js +226 -0
- package/dist/packages/core/src/domain/YamlLite.js.map +1 -0
- package/dist/packages/core/src/index.js +120 -0
- package/dist/packages/core/src/index.js.map +1 -0
- package/dist/packages/core/src/infrastructure/ChangeWorkspace.js +276 -0
- package/dist/packages/core/src/infrastructure/ChangeWorkspace.js.map +1 -0
- package/dist/packages/core/src/infrastructure/ConsoleReporter.js +19 -0
- package/dist/packages/core/src/infrastructure/ConsoleReporter.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DirectorySnapshot.js +106 -0
- package/dist/packages/core/src/infrastructure/DirectorySnapshot.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskDomainPackRepository.js +57 -0
- package/dist/packages/core/src/infrastructure/DiskDomainPackRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskHarnessConfigRepository.js +58 -0
- package/dist/packages/core/src/infrastructure/DiskHarnessConfigRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskLanguageRepository.js +69 -0
- package/dist/packages/core/src/infrastructure/DiskLanguageRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskLockfileRepository.js +64 -0
- package/dist/packages/core/src/infrastructure/DiskLockfileRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskManifestRepository.js +88 -0
- package/dist/packages/core/src/infrastructure/DiskManifestRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskPackDeltaRepository.js +138 -0
- package/dist/packages/core/src/infrastructure/DiskPackDeltaRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskPackRepository.js +130 -0
- package/dist/packages/core/src/infrastructure/DiskPackRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskProjectRepository.js +127 -0
- package/dist/packages/core/src/infrastructure/DiskProjectRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskRequirementGraphRepository.js +124 -0
- package/dist/packages/core/src/infrastructure/DiskRequirementGraphRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/DiskTraceabilityRepository.js +53 -0
- package/dist/packages/core/src/infrastructure/DiskTraceabilityRepository.js.map +1 -0
- package/dist/packages/core/src/infrastructure/GitContributionStager.js +99 -0
- package/dist/packages/core/src/infrastructure/GitContributionStager.js.map +1 -0
- package/dist/packages/core/src/infrastructure/GitMergeDriver.js +103 -0
- package/dist/packages/core/src/infrastructure/GitMergeDriver.js.map +1 -0
- package/dist/packages/core/src/infrastructure/HarnessConfigFile.js +348 -0
- package/dist/packages/core/src/infrastructure/HarnessConfigFile.js.map +1 -0
- package/dist/packages/core/src/infrastructure/PackChangeDeposit.js +106 -0
- package/dist/packages/core/src/infrastructure/PackChangeDeposit.js.map +1 -0
- package/dist/packages/core/src/infrastructure/RemotePackResolver.js +181 -0
- package/dist/packages/core/src/infrastructure/RemotePackResolver.js.map +1 -0
- package/dist/packages/core/src/infrastructure/SpecopsConfigFile.js +94 -0
- package/dist/packages/core/src/infrastructure/SpecopsConfigFile.js.map +1 -0
- package/dist/packages/core/test/unit/authoring-scope.test.js +102 -0
- package/dist/packages/core/test/unit/authoring-scope.test.js.map +1 -0
- package/dist/packages/core/test/unit/change-templates.test.js +96 -0
- package/dist/packages/core/test/unit/change-templates.test.js.map +1 -0
- package/dist/packages/core/test/unit/cucumber-messages.test.js +232 -0
- package/dist/packages/core/test/unit/cucumber-messages.test.js.map +1 -0
- package/dist/packages/core/test/unit/declared-artifacts.test.js +124 -0
- package/dist/packages/core/test/unit/declared-artifacts.test.js.map +1 -0
- package/dist/packages/core/test/unit/empty-attempt.test.js +79 -0
- package/dist/packages/core/test/unit/empty-attempt.test.js.map +1 -0
- package/dist/packages/core/test/unit/gherkin-dialects.test.js +115 -0
- package/dist/packages/core/test/unit/gherkin-dialects.test.js.map +1 -0
- package/dist/packages/core/test/unit/gherkin-keyword-case.test.js +110 -0
- package/dist/packages/core/test/unit/gherkin-keyword-case.test.js.map +1 -0
- package/dist/packages/core/test/unit/gherkin-quality.test.js +151 -0
- package/dist/packages/core/test/unit/gherkin-quality.test.js.map +1 -0
- package/dist/packages/core/test/unit/gherkin-tags.test.js +127 -0
- package/dist/packages/core/test/unit/gherkin-tags.test.js.map +1 -0
- package/dist/packages/core/test/unit/git-safety.test.js +104 -0
- package/dist/packages/core/test/unit/git-safety.test.js.map +1 -0
- package/dist/packages/core/test/unit/harness-report.test.js +192 -0
- package/dist/packages/core/test/unit/harness-report.test.js.map +1 -0
- package/dist/packages/core/test/unit/harness-roles.test.js +86 -0
- package/dist/packages/core/test/unit/harness-roles.test.js.map +1 -0
- package/dist/packages/core/test/unit/inbound-change.test.js +145 -0
- package/dist/packages/core/test/unit/inbound-change.test.js.map +1 -0
- package/dist/packages/core/test/unit/matrix-dependencies.test.js +100 -0
- package/dist/packages/core/test/unit/matrix-dependencies.test.js.map +1 -0
- package/dist/packages/core/test/unit/profile-match.test.js +115 -0
- package/dist/packages/core/test/unit/profile-match.test.js.map +1 -0
- package/dist/packages/core/test/unit/reconciliation.test.js +112 -0
- package/dist/packages/core/test/unit/reconciliation.test.js.map +1 -0
- package/dist/packages/core/test/unit/requirement-readiness.test.js +161 -0
- package/dist/packages/core/test/unit/requirement-readiness.test.js.map +1 -0
- package/dist/packages/core/test/unit/resume-state.test.js +124 -0
- package/dist/packages/core/test/unit/resume-state.test.js.map +1 -0
- package/dist/packages/core/test/unit/run-budget.test.js +113 -0
- package/dist/packages/core/test/unit/run-budget.test.js.map +1 -0
- package/dist/packages/core/test/unit/traceability-merge.test.js +159 -0
- package/dist/packages/core/test/unit/traceability-merge.test.js.map +1 -0
- package/dist/packages/core/test/unit/validate-project.test.js +156 -0
- package/dist/packages/core/test/unit/validate-project.test.js.map +1 -0
- package/dist/packages/core/test/unit/value-annotations.test.js +149 -0
- package/dist/packages/core/test/unit/value-annotations.test.js.map +1 -0
- package/dist/packages/core/test/unit/write-scope.test.js +165 -0
- package/dist/packages/core/test/unit/write-scope.test.js.map +1 -0
- package/dist/packages/core/test/unit/yaml-lite.test.js +78 -0
- package/dist/packages/core/test/unit/yaml-lite.test.js.map +1 -0
- package/dist/scripts/adopt_project.js +11 -0
- package/dist/scripts/adopt_project.js.map +1 -0
- package/dist/scripts/agents/commands.js +100 -0
- package/dist/scripts/agents/commands.js.map +1 -0
- package/dist/scripts/agents/init.js +482 -0
- package/dist/scripts/agents/init.js.map +1 -0
- package/dist/scripts/alm/cli.js +154 -0
- package/dist/scripts/alm/cli.js.map +1 -0
- package/dist/scripts/alm/clients.js +30 -0
- package/dist/scripts/alm/clients.js.map +1 -0
- package/dist/scripts/alm/core.js +258 -0
- package/dist/scripts/alm/core.js.map +1 -0
- package/dist/scripts/alm/port.js +116 -0
- package/dist/scripts/alm/port.js.map +1 -0
- package/dist/scripts/alm/providers/azure.js +79 -0
- package/dist/scripts/alm/providers/azure.js.map +1 -0
- package/dist/scripts/alm/providers/github.js +124 -0
- package/dist/scripts/alm/providers/github.js.map +1 -0
- package/dist/scripts/alm/providers/http-client.js +47 -0
- package/dist/scripts/alm/providers/http-client.js.map +1 -0
- package/dist/scripts/alm/providers/index.js +107 -0
- package/dist/scripts/alm/providers/index.js.map +1 -0
- package/dist/scripts/alm/providers/jira.js +129 -0
- package/dist/scripts/alm/providers/jira.js.map +1 -0
- package/dist/scripts/bundle_pack.js +10 -0
- package/dist/scripts/bundle_pack.js.map +1 -0
- package/dist/scripts/change/archive.js +68 -0
- package/dist/scripts/change/archive.js.map +1 -0
- package/dist/scripts/change/artifacts.js +143 -0
- package/dist/scripts/change/artifacts.js.map +1 -0
- package/dist/scripts/change/cli.js +39 -0
- package/dist/scripts/change/cli.js.map +1 -0
- package/dist/scripts/change/delta.js +20 -0
- package/dist/scripts/change/delta.js.map +1 -0
- package/dist/scripts/change/instructions.js +339 -0
- package/dist/scripts/change/instructions.js.map +1 -0
- package/dist/scripts/ci_init.js +12 -0
- package/dist/scripts/ci_init.js.map +1 -0
- package/dist/scripts/cli/commands/alm/PullCommand.js +238 -0
- package/dist/scripts/cli/commands/alm/PullCommand.js.map +1 -0
- package/dist/scripts/cli/commands/change/ChangeCommand.js +867 -0
- package/dist/scripts/cli/commands/change/ChangeCommand.js.map +1 -0
- package/dist/scripts/cli/commands/config/CiInitCommand.js +144 -0
- package/dist/scripts/cli/commands/config/CiInitCommand.js.map +1 -0
- package/dist/scripts/cli/commands/config/CompletionCommand.js +160 -0
- package/dist/scripts/cli/commands/config/CompletionCommand.js.map +1 -0
- package/dist/scripts/cli/commands/config/ConfigInitCommand.js +108 -0
- package/dist/scripts/cli/commands/config/ConfigInitCommand.js.map +1 -0
- package/dist/scripts/cli/commands/config/ConfigSetCommand.js +166 -0
- package/dist/scripts/cli/commands/config/ConfigSetCommand.js.map +1 -0
- package/dist/scripts/cli/commands/config/GenAgentContractCommand.js +212 -0
- package/dist/scripts/cli/commands/config/GenAgentContractCommand.js.map +1 -0
- package/dist/scripts/cli/commands/harness/RunCommand.js +1922 -0
- package/dist/scripts/cli/commands/harness/RunCommand.js.map +1 -0
- package/dist/scripts/cli/commands/mcp/McpInstallCommand.js +114 -0
- package/dist/scripts/cli/commands/mcp/McpInstallCommand.js.map +1 -0
- package/dist/scripts/cli/commands/mcp/index.js +29 -0
- package/dist/scripts/cli/commands/mcp/index.js.map +1 -0
- package/dist/scripts/cli/commands/pack/BundlePackCommand.js +59 -0
- package/dist/scripts/cli/commands/pack/BundlePackCommand.js.map +1 -0
- package/dist/scripts/cli/commands/pack/ExpandDomainPackCommand.js +559 -0
- package/dist/scripts/cli/commands/pack/ExpandDomainPackCommand.js.map +1 -0
- package/dist/scripts/cli/commands/pack/InferPackCommand.js +304 -0
- package/dist/scripts/cli/commands/pack/InferPackCommand.js.map +1 -0
- package/dist/scripts/cli/commands/pack/InitPackCommand.js +368 -0
- package/dist/scripts/cli/commands/pack/InitPackCommand.js.map +1 -0
- package/dist/scripts/cli/commands/pack/LintPackCommand.js +631 -0
- package/dist/scripts/cli/commands/pack/LintPackCommand.js.map +1 -0
- package/dist/scripts/cli/commands/pack/pack-args.js +83 -0
- package/dist/scripts/cli/commands/pack/pack-args.js.map +1 -0
- package/dist/scripts/cli/commands/project/AdoptCommand.js +414 -0
- package/dist/scripts/cli/commands/project/AdoptCommand.js.map +1 -0
- package/dist/scripts/cli/commands/project/InitFromPackCommand.js +188 -0
- package/dist/scripts/cli/commands/project/InitFromPackCommand.js.map +1 -0
- package/dist/scripts/cli/commands/project/InitProjectCommand.js +791 -0
- package/dist/scripts/cli/commands/project/InitProjectCommand.js.map +1 -0
- package/dist/scripts/cli/commands/project/OnboardCommand.js +655 -0
- package/dist/scripts/cli/commands/project/OnboardCommand.js.map +1 -0
- package/dist/scripts/cli/commands/project/UpdateCommand.js +206 -0
- package/dist/scripts/cli/commands/project/UpdateCommand.js.map +1 -0
- package/dist/scripts/cli/commands/project/WizardCommand.js +166 -0
- package/dist/scripts/cli/commands/project/WizardCommand.js.map +1 -0
- package/dist/scripts/cli/commands/quality/DoctorCommand.js +553 -0
- package/dist/scripts/cli/commands/quality/DoctorCommand.js.map +1 -0
- package/dist/scripts/cli/commands/quality/FixCommand.js +201 -0
- package/dist/scripts/cli/commands/quality/FixCommand.js.map +1 -0
- package/dist/scripts/cli/commands/quality/LicenseCheckCommand.js +187 -0
- package/dist/scripts/cli/commands/quality/LicenseCheckCommand.js.map +1 -0
- package/dist/scripts/cli/commands/quality/ReportCommand.js +557 -0
- package/dist/scripts/cli/commands/quality/ReportCommand.js.map +1 -0
- package/dist/scripts/cli/commands/quality/ValidateSpecsCommand.js +764 -0
- package/dist/scripts/cli/commands/quality/ValidateSpecsCommand.js.map +1 -0
- package/dist/scripts/cli/commands/spec/DoneCommand.js +116 -0
- package/dist/scripts/cli/commands/spec/DoneCommand.js.map +1 -0
- package/dist/scripts/cli/commands/spec/PlanCommand.js +397 -0
- package/dist/scripts/cli/commands/spec/PlanCommand.js.map +1 -0
- package/dist/scripts/cli/commands/spec/ReqCommand.js +303 -0
- package/dist/scripts/cli/commands/spec/ReqCommand.js.map +1 -0
- package/dist/scripts/cli/commands/spec/StatusCommand.js +206 -0
- package/dist/scripts/cli/commands/spec/StatusCommand.js.map +1 -0
- package/dist/scripts/cli/commands/spec/StudioCommand.js +241 -0
- package/dist/scripts/cli/commands/spec/StudioCommand.js.map +1 -0
- package/dist/scripts/cli/commands/specops/ContributeCommand.js +313 -0
- package/dist/scripts/cli/commands/specops/ContributeCommand.js.map +1 -0
- package/dist/scripts/cli/commands/specops/DiffCommand.js +394 -0
- package/dist/scripts/cli/commands/specops/DiffCommand.js.map +1 -0
- package/dist/scripts/cli/commands/specops/SyncCommand.js +380 -0
- package/dist/scripts/cli/commands/specops/SyncCommand.js.map +1 -0
- package/dist/scripts/completion.js +24 -0
- package/dist/scripts/completion.js.map +1 -0
- package/dist/scripts/config_init.js +12 -0
- package/dist/scripts/config_init.js.map +1 -0
- package/dist/scripts/config_set.js +20 -0
- package/dist/scripts/config_set.js.map +1 -0
- package/dist/scripts/docs/blocks.js +137 -0
- package/dist/scripts/docs/blocks.js.map +1 -0
- package/dist/scripts/docs/build-site.js +425 -0
- package/dist/scripts/docs/build-site.js.map +1 -0
- package/dist/scripts/docs/nav.js +198 -0
- package/dist/scripts/docs/nav.js.map +1 -0
- package/dist/scripts/docs/record-terminal.js +477 -0
- package/dist/scripts/docs/record-terminal.js.map +1 -0
- package/dist/scripts/docs/terminal-storyboard.js +121 -0
- package/dist/scripts/docs/terminal-storyboard.js.map +1 -0
- package/dist/scripts/doctor.js +14 -0
- package/dist/scripts/doctor.js.map +1 -0
- package/dist/scripts/done.js +17 -0
- package/dist/scripts/done.js.map +1 -0
- package/dist/scripts/expand_domain_pack.js +18 -0
- package/dist/scripts/expand_domain_pack.js.map +1 -0
- package/dist/scripts/fix.js +12 -0
- package/dist/scripts/fix.js.map +1 -0
- package/dist/scripts/gen_agent_contract.js +14 -0
- package/dist/scripts/gen_agent_contract.js.map +1 -0
- package/dist/scripts/gen_mcp_tools.js +264 -0
- package/dist/scripts/gen_mcp_tools.js.map +1 -0
- package/dist/scripts/harness/init.js +358 -0
- package/dist/scripts/harness/init.js.map +1 -0
- package/dist/scripts/harness/prompt.js +18 -0
- package/dist/scripts/harness/prompt.js.map +1 -0
- package/dist/scripts/harness/report.js +323 -0
- package/dist/scripts/harness/report.js.map +1 -0
- package/dist/scripts/harness/run.js +33 -0
- package/dist/scripts/harness/run.js.map +1 -0
- package/dist/scripts/infer_pack.js +17 -0
- package/dist/scripts/infer_pack.js.map +1 -0
- package/dist/scripts/init_from_pack.js +16 -0
- package/dist/scripts/init_from_pack.js.map +1 -0
- package/dist/scripts/init_pack.js +16 -0
- package/dist/scripts/init_pack.js.map +1 -0
- package/dist/scripts/init_project.js +17 -0
- package/dist/scripts/init_project.js.map +1 -0
- package/dist/scripts/lib/agent.js +99 -0
- package/dist/scripts/lib/agent.js.map +1 -0
- package/dist/scripts/lib/capability-specs.js +80 -0
- package/dist/scripts/lib/capability-specs.js.map +1 -0
- package/dist/scripts/lib/command.js +17 -0
- package/dist/scripts/lib/command.js.map +1 -0
- package/dist/scripts/lib/diagnostics.js +62 -0
- package/dist/scripts/lib/diagnostics.js.map +1 -0
- package/dist/scripts/lib/monorepo-fanout.js +118 -0
- package/dist/scripts/lib/monorepo-fanout.js.map +1 -0
- package/dist/scripts/lib/placeholders.js +190 -0
- package/dist/scripts/lib/placeholders.js.map +1 -0
- package/dist/scripts/lib/project-root.js +124 -0
- package/dist/scripts/lib/project-root.js.map +1 -0
- package/dist/scripts/lib/requirement-graph.js +31 -0
- package/dist/scripts/lib/requirement-graph.js.map +1 -0
- package/dist/scripts/lib/surface.js +609 -0
- package/dist/scripts/lib/surface.js.map +1 -0
- package/dist/scripts/license_check.js +15 -0
- package/dist/scripts/license_check.js.map +1 -0
- package/dist/scripts/lint_pack.js +18 -0
- package/dist/scripts/lint_pack.js.map +1 -0
- package/dist/scripts/merge-traceability.js +106 -0
- package/dist/scripts/merge-traceability.js.map +1 -0
- package/dist/scripts/onboard.js +22 -0
- package/dist/scripts/onboard.js.map +1 -0
- package/dist/scripts/plan.js +17 -0
- package/dist/scripts/plan.js.map +1 -0
- package/dist/scripts/plugin/gate-hook.js +171 -0
- package/dist/scripts/plugin/gate-hook.js.map +1 -0
- package/dist/scripts/report.js +17 -0
- package/dist/scripts/report.js.map +1 -0
- package/dist/scripts/req.js +22 -0
- package/dist/scripts/req.js.map +1 -0
- package/dist/scripts/schema/cli.js +215 -0
- package/dist/scripts/schema/cli.js.map +1 -0
- package/dist/scripts/schema/registry.js +264 -0
- package/dist/scripts/schema/registry.js.map +1 -0
- package/dist/scripts/specops/add.js +180 -0
- package/dist/scripts/specops/add.js.map +1 -0
- package/dist/scripts/specops/against_lock.js +100 -0
- package/dist/scripts/specops/against_lock.js.map +1 -0
- package/dist/scripts/specops/as_change.js +49 -0
- package/dist/scripts/specops/as_change.js.map +1 -0
- package/dist/scripts/specops/contribute.js +24 -0
- package/dist/scripts/specops/contribute.js.map +1 -0
- package/dist/scripts/specops/diff.js +32 -0
- package/dist/scripts/specops/diff.js.map +1 -0
- package/dist/scripts/specops/lock.js +39 -0
- package/dist/scripts/specops/lock.js.map +1 -0
- package/dist/scripts/specops/manifest.js +90 -0
- package/dist/scripts/specops/manifest.js.map +1 -0
- package/dist/scripts/specops/remove.js +102 -0
- package/dist/scripts/specops/remove.js.map +1 -0
- package/dist/scripts/specops/sync.js +27 -0
- package/dist/scripts/specops/sync.js.map +1 -0
- package/dist/scripts/specops/verify.js +149 -0
- package/dist/scripts/specops/verify.js.map +1 -0
- package/dist/scripts/status.js +17 -0
- package/dist/scripts/status.js.map +1 -0
- package/dist/scripts/studio.js +14 -0
- package/dist/scripts/studio.js.map +1 -0
- package/dist/scripts/update.js +17 -0
- package/dist/scripts/update.js.map +1 -0
- package/dist/scripts/validate_specs.js +10 -0
- package/dist/scripts/validate_specs.js.map +1 -0
- package/examples/project.config.example +19 -0
- package/examples/project.yaml.example +17 -0
- package/package.json +105 -0
- package/templates/adopt/AI_RULES.md.tpl +27 -0
- package/templates/adopt/adr-readme.md.tpl +5 -0
- package/templates/adopt/baseline.feature.tpl +9 -0
- package/templates/adopt/spec.md.tpl +25 -0
- package/templates/adopt/traceability.md.tpl +11 -0
- package/templates/backend/AI_RULES.md.tpl +35 -0
- package/templates/backend/features/core/health.feature.tpl +7 -0
- package/templates/base/.devcontainer/devcontainer.json.tpl +18 -0
- package/templates/base/.dockerignore.tpl +11 -0
- package/templates/base/.env.dev.app.tpl +13 -0
- package/templates/base/.env.dev.infra.tpl +6 -0
- package/templates/base/.env.dev.tpl +16 -0
- package/templates/base/.env.example.tpl +17 -0
- package/templates/base/.env.feature.app.tpl +11 -0
- package/templates/base/.env.feature.infra.tpl +4 -0
- package/templates/base/.env.feature.tpl +16 -0
- package/templates/base/.env.prod.app.tpl +13 -0
- package/templates/base/.env.prod.infra.tpl +6 -0
- package/templates/base/.env.prod.tpl +16 -0
- package/templates/base/.github/workflows/specs.yml.tpl +26 -0
- package/templates/base/.gitignore.tpl +9 -0
- package/templates/base/.pre-commit-config.yaml.tpl +10 -0
- package/templates/base/AGENTS.md.tpl +32 -0
- package/templates/base/README.md.tpl +32 -0
- package/templates/base/docker-compose.yml.tpl +13 -0
- package/templates/base/docs/specs/adr/README.md.tpl +10 -0
- package/templates/base/docs/specs/aggregates.md.tpl +5 -0
- package/templates/base/docs/specs/commands.md.tpl +13 -0
- package/templates/base/docs/specs/domain-model.md.tpl +30 -0
- package/templates/base/docs/specs/events.md.tpl +5 -0
- package/templates/base/docs/specs/review-checklist.md.tpl +18 -0
- package/templates/base/docs/specs/runtime-environments.md.tpl +26 -0
- package/templates/base/docs/specs/status-model.md.tpl +16 -0
- package/templates/base/docs/specs/traceability.md.tpl +7 -0
- package/templates/base/docs/specs/use-cases.md.tpl +5 -0
- package/templates/base/spec.md.tpl +63 -0
- package/templates/ci/azure.yml.tpl +40 -0
- package/templates/ci/github.yml.tpl +40 -0
- package/templates/ci/gitlab.yml.tpl +21 -0
- package/templates/ci/jenkins.tpl +35 -0
- package/templates/contracts/AI_RULES.md.tpl +55 -0
- package/templates/contracts/asyncapi-stub.yaml.tpl +24 -0
- package/templates/contracts/contract-traceability.md.tpl +10 -0
- package/templates/contracts/openapi-stub.yaml.tpl +29 -0
- package/templates/contracts/pacts-gitkeep.tpl +0 -0
- package/templates/contracts/test-strategy.md.tpl +94 -0
- package/templates/frontend/AI_RULES.md.tpl +34 -0
- package/templates/frontend/features/core/health.feature.tpl +6 -0
- package/templates/harness/harness.config.yaml.tpl +74 -0
- package/templates/harness/prompt-prefix.md.tpl +60 -0
- package/templates/mobile/AI_RULES.md.tpl +56 -0
- package/templates/mobile/features/core/health.feature.tpl +7 -0
- package/templates/modules/auth/backend/registration_and_login.feature.tpl +10 -0
- package/templates/modules/auth/frontend/login.feature.tpl +5 -0
- package/templates/modules/billing/backend/billing_settlement.feature.tpl +5 -0
- package/templates/modules/billing/frontend/billing_summary.feature.tpl +5 -0
- package/templates/modules/dashboard/backend/dashboard_kpi.feature.tpl +5 -0
- package/templates/modules/dashboard/frontend/dashboard.feature.tpl +5 -0
- package/vendor/mermaid.min.js +3636 -0
|
@@ -0,0 +1,380 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
"use strict";
|
|
3
|
+
/**
|
|
4
|
+
* `specops sync` — re-expands every pack recorded in `.specops.lock` and
|
|
5
|
+
* reconciles the result with the project using three-way merge.
|
|
6
|
+
*
|
|
7
|
+
* Falls back to `specops.config.yaml` when no lockfile exists, allowing
|
|
8
|
+
* fresh clones to bootstrap before the first lock is written.
|
|
9
|
+
*
|
|
10
|
+
* Conflict detection (vs. the old blind-overwrite behaviour):
|
|
11
|
+
* For each file the pack renders, sync compares three versions —
|
|
12
|
+
* base = what the pack rendered last sync (.specops/baseline/<pack>)
|
|
13
|
+
* local = what is in the project now (possibly hand-edited by a
|
|
14
|
+
* human or an AI agent)
|
|
15
|
+
* incoming = what the pack renders at the target version
|
|
16
|
+
* and classifies the file as added / unchanged / updated / kept /
|
|
17
|
+
* merged / conflict. Local edits are preserved; genuine conflicts get
|
|
18
|
+
* git-style merge markers (or are skipped with --abort-on-conflict).
|
|
19
|
+
*
|
|
20
|
+
* Exit code is non-zero when any file is left in a conflicted state, so
|
|
21
|
+
* CI and agent harnesses can detect that a human needs to intervene.
|
|
22
|
+
*/
|
|
23
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
24
|
+
if (k2 === undefined) k2 = k;
|
|
25
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
26
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
27
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
28
|
+
}
|
|
29
|
+
Object.defineProperty(o, k2, desc);
|
|
30
|
+
}) : (function(o, m, k, k2) {
|
|
31
|
+
if (k2 === undefined) k2 = k;
|
|
32
|
+
o[k2] = m[k];
|
|
33
|
+
}));
|
|
34
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
35
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
36
|
+
}) : function(o, v) {
|
|
37
|
+
o["default"] = v;
|
|
38
|
+
});
|
|
39
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
40
|
+
var ownKeys = function(o) {
|
|
41
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
42
|
+
var ar = [];
|
|
43
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
44
|
+
return ar;
|
|
45
|
+
};
|
|
46
|
+
return ownKeys(o);
|
|
47
|
+
};
|
|
48
|
+
return function (mod) {
|
|
49
|
+
if (mod && mod.__esModule) return mod;
|
|
50
|
+
var result = {};
|
|
51
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
52
|
+
__setModuleDefault(result, mod);
|
|
53
|
+
return result;
|
|
54
|
+
};
|
|
55
|
+
})();
|
|
56
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
57
|
+
exports.SyncCommand = void 0;
|
|
58
|
+
exports.parseArgs = parseArgs;
|
|
59
|
+
exports.buildExpandArgs = buildExpandArgs;
|
|
60
|
+
exports.resolvePacks = resolvePacks;
|
|
61
|
+
exports.reconcileFile = reconcileFile;
|
|
62
|
+
const fs = __importStar(require("node:fs"));
|
|
63
|
+
const os = __importStar(require("node:os"));
|
|
64
|
+
const path = __importStar(require("node:path"));
|
|
65
|
+
const node_child_process_1 = require("node:child_process");
|
|
66
|
+
const command_1 = require("../../../lib/command");
|
|
67
|
+
const lock_1 = require("../../../specops/lock");
|
|
68
|
+
const SpecopsConfigFile_1 = require("../../../../packages/core/src/infrastructure/SpecopsConfigFile");
|
|
69
|
+
const DirectorySnapshot_1 = require("../../../../packages/core/src/infrastructure/DirectorySnapshot");
|
|
70
|
+
const manifest_1 = require("../../../specops/manifest");
|
|
71
|
+
const GitMergeDriver_1 = require("../../../../packages/core/src/infrastructure/GitMergeDriver");
|
|
72
|
+
const Reconciliation_1 = require("../../../../packages/core/src/domain/Reconciliation");
|
|
73
|
+
const project_root_1 = require("../../../lib/project-root");
|
|
74
|
+
const RemotePackResolver_1 = require("../../../../packages/core/src/infrastructure/RemotePackResolver");
|
|
75
|
+
const PackChangeDeposit_1 = require("../../../../packages/core/src/infrastructure/PackChangeDeposit");
|
|
76
|
+
// Three levels up from dist/scripts/cli/commands/specops is dist/scripts.
|
|
77
|
+
const EXPAND_SCRIPT = path.join(__dirname, "..", "..", "..", "expand_domain_pack.js");
|
|
78
|
+
function info(msg) {
|
|
79
|
+
process.stdout.write(`ℹ️ [INFO] ${msg}\n`);
|
|
80
|
+
}
|
|
81
|
+
function warn(msg) {
|
|
82
|
+
process.stdout.write(`⚠️ [WARN] ${msg}\n`);
|
|
83
|
+
}
|
|
84
|
+
function error(msg) {
|
|
85
|
+
process.stderr.write(`❌ [ERROR] ${msg}\n`);
|
|
86
|
+
}
|
|
87
|
+
function usage() {
|
|
88
|
+
process.stdout.write("Usage:\n" +
|
|
89
|
+
" specgate specops sync [--project-dir <path>] [--pack <pack-id>] [--pack-version <tag>] [--cache-dir <path>] [--var KEY=VALUE]... [--dry-run] [--force] [--abort-on-conflict]\n\n" +
|
|
90
|
+
"Re-expands packs recorded in .specops.lock (or specops.config.yaml if no\n" +
|
|
91
|
+
"lockfile exists) and three-way merges the result into the project,\n" +
|
|
92
|
+
"preserving local edits. With --pack-version, bumps the matching pack(s)\n" +
|
|
93
|
+
"to a new tag/SHA.\n\n" +
|
|
94
|
+
" --var KEY=VALUE Extra template variable (repeatable). Use it when a\n" +
|
|
95
|
+
" newer pack version requires a variable the lockfile\n" +
|
|
96
|
+
" predates; the value is persisted back to .specops.lock.\n" +
|
|
97
|
+
" --force Overwrite locally-edited files with the pack version.\n" +
|
|
98
|
+
" --abort-on-conflict Leave conflicting files untouched instead of writing markers.\n" +
|
|
99
|
+
" --dry-run Report what would change without writing anything.\n");
|
|
100
|
+
}
|
|
101
|
+
function parseArgs(argv) {
|
|
102
|
+
const args = {
|
|
103
|
+
projectDir: ".",
|
|
104
|
+
pack: "",
|
|
105
|
+
packVersion: "",
|
|
106
|
+
cacheDir: "",
|
|
107
|
+
dryRun: false,
|
|
108
|
+
force: false,
|
|
109
|
+
abortOnConflict: false,
|
|
110
|
+
vars: {},
|
|
111
|
+
};
|
|
112
|
+
for (let i = 0; i < argv.length; i += 1) {
|
|
113
|
+
const token = argv[i];
|
|
114
|
+
if (token === "--project-dir") {
|
|
115
|
+
args.projectDir = argv[++i] || "";
|
|
116
|
+
continue;
|
|
117
|
+
}
|
|
118
|
+
if (token === "--pack") {
|
|
119
|
+
args.pack = argv[++i] || "";
|
|
120
|
+
continue;
|
|
121
|
+
}
|
|
122
|
+
if (token === "--pack-version") {
|
|
123
|
+
args.packVersion = argv[++i] || "";
|
|
124
|
+
continue;
|
|
125
|
+
}
|
|
126
|
+
if (token === "--cache-dir") {
|
|
127
|
+
args.cacheDir = argv[++i] || "";
|
|
128
|
+
continue;
|
|
129
|
+
}
|
|
130
|
+
if (token === "--var") {
|
|
131
|
+
const pair = argv[++i] || "";
|
|
132
|
+
const eq = pair.indexOf("=");
|
|
133
|
+
if (eq <= 0)
|
|
134
|
+
throw new Error(`Invalid --var (expected KEY=VALUE): ${pair}`);
|
|
135
|
+
args.vars[pair.slice(0, eq)] = pair.slice(eq + 1);
|
|
136
|
+
continue;
|
|
137
|
+
}
|
|
138
|
+
if (token === "--dry-run") {
|
|
139
|
+
args.dryRun = true;
|
|
140
|
+
continue;
|
|
141
|
+
}
|
|
142
|
+
if (token === "--force") {
|
|
143
|
+
args.force = true;
|
|
144
|
+
continue;
|
|
145
|
+
}
|
|
146
|
+
if (token === "--abort-on-conflict") {
|
|
147
|
+
args.abortOnConflict = true;
|
|
148
|
+
continue;
|
|
149
|
+
}
|
|
150
|
+
if (token === "--help" || token === "-h") {
|
|
151
|
+
usage();
|
|
152
|
+
process.exit(0);
|
|
153
|
+
}
|
|
154
|
+
throw new Error(`Unknown argument: ${token}`);
|
|
155
|
+
}
|
|
156
|
+
if (args.force && args.abortOnConflict) {
|
|
157
|
+
throw new Error("--force and --abort-on-conflict are mutually exclusive.");
|
|
158
|
+
}
|
|
159
|
+
return args;
|
|
160
|
+
}
|
|
161
|
+
function buildExpandArgs(entry, version, projectDir, cacheDir, dryRun, extraVars = {}) {
|
|
162
|
+
const out = [
|
|
163
|
+
"--pack-repo",
|
|
164
|
+
entry.repo,
|
|
165
|
+
"--pack-version",
|
|
166
|
+
version,
|
|
167
|
+
"--pack",
|
|
168
|
+
entry.pack_id,
|
|
169
|
+
"--project-dir",
|
|
170
|
+
projectDir,
|
|
171
|
+
];
|
|
172
|
+
if (cacheDir) {
|
|
173
|
+
out.push("--cache-dir", cacheDir);
|
|
174
|
+
}
|
|
175
|
+
// CLI --var values extend/override the lockfile's recorded vars — needed
|
|
176
|
+
// when a newer pack version requires a variable the lockfile predates.
|
|
177
|
+
const vars = { ...(entry.vars || {}), ...extraVars };
|
|
178
|
+
for (const [key, value] of Object.entries(vars)) {
|
|
179
|
+
out.push("--var", `${key}=${value}`);
|
|
180
|
+
}
|
|
181
|
+
if (dryRun)
|
|
182
|
+
out.push("--dry-run");
|
|
183
|
+
return out;
|
|
184
|
+
}
|
|
185
|
+
function resolvePacks(projectDir) {
|
|
186
|
+
const lock = (0, lock_1.readLock)(projectDir);
|
|
187
|
+
if (lock) {
|
|
188
|
+
if (!Array.isArray(lock.packs) || lock.packs.length === 0) {
|
|
189
|
+
throw new Error(".specops.lock has no pack entries.");
|
|
190
|
+
}
|
|
191
|
+
return { packs: lock.packs, source: ".specops.lock" };
|
|
192
|
+
}
|
|
193
|
+
const config = (0, SpecopsConfigFile_1.readConfig)(projectDir);
|
|
194
|
+
if (config) {
|
|
195
|
+
return { packs: (0, SpecopsConfigFile_1.configToPacks)(config), source: SpecopsConfigFile_1.CONFIG_FILE };
|
|
196
|
+
}
|
|
197
|
+
throw new Error(`No .specops.lock or ${SpecopsConfigFile_1.CONFIG_FILE} found in ${projectDir}.\n` +
|
|
198
|
+
`Run 'expand --pack-repo ...' first, or create a ${SpecopsConfigFile_1.CONFIG_FILE}.`);
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Classify a single file and (unless dryRun) apply the chosen action.
|
|
202
|
+
* Returns { outcome, baselineContent } where baselineContent is what should
|
|
203
|
+
* be recorded as the next merge base for this file.
|
|
204
|
+
*/
|
|
205
|
+
function reconcileFile(rel, incoming, projectDir, packId, args) {
|
|
206
|
+
const localPath = path.join(projectDir, rel);
|
|
207
|
+
const local = fs.existsSync(localPath) ? fs.readFileSync(localPath, "utf8") : null;
|
|
208
|
+
const base = (0, manifest_1.readBaseline)(projectDir, packId, rel);
|
|
209
|
+
const decision = (0, Reconciliation_1.reconcile)(base, local, incoming, args, GitMergeDriver_1.threeWayMerge);
|
|
210
|
+
if (decision.write !== null && !args.dryRun) {
|
|
211
|
+
fs.mkdirSync(path.dirname(localPath), { recursive: true });
|
|
212
|
+
fs.writeFileSync(localPath, decision.write, "utf8");
|
|
213
|
+
}
|
|
214
|
+
return { outcome: decision.outcome, baselineContent: decision.baselineContent };
|
|
215
|
+
}
|
|
216
|
+
/**
|
|
217
|
+
* Where the pack's own source tree lives, for reading anything `expand` does
|
|
218
|
+
* not render — currently the `changes/` a pack may ship.
|
|
219
|
+
*
|
|
220
|
+
* Remote packs come from the resolver's cache (already populated by the expand
|
|
221
|
+
* that just ran, so this costs nothing); local packs are read in place.
|
|
222
|
+
* Returns null when neither applies, and the caller simply skips the step.
|
|
223
|
+
*/
|
|
224
|
+
function resolvePackRootForChanges(entry, version, args) {
|
|
225
|
+
if (entry.pack_root)
|
|
226
|
+
return entry.pack_root;
|
|
227
|
+
if (!entry.repo)
|
|
228
|
+
return null;
|
|
229
|
+
try {
|
|
230
|
+
const resolved = (0, RemotePackResolver_1.resolveRemotePack)({
|
|
231
|
+
repo: entry.repo,
|
|
232
|
+
version,
|
|
233
|
+
cacheDir: args.cacheDir || undefined,
|
|
234
|
+
});
|
|
235
|
+
return resolved.packRoot;
|
|
236
|
+
}
|
|
237
|
+
catch {
|
|
238
|
+
return null;
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
function syncPack(entry, args, projectDir) {
|
|
242
|
+
const version = args.packVersion || entry.version;
|
|
243
|
+
const bumping = args.packVersion && args.packVersion !== entry.version;
|
|
244
|
+
info(`Syncing ${entry.pack_id} @ ${version}` + (bumping ? ` (was ${entry.version})` : ""));
|
|
245
|
+
const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "specops-sync-"));
|
|
246
|
+
try {
|
|
247
|
+
// Always render into a throwaway dir (never --dry-run: we need the bytes).
|
|
248
|
+
const expandArgs = buildExpandArgs(entry, version, tmpDir, args.cacheDir, false, args.vars);
|
|
249
|
+
const result = (0, node_child_process_1.spawnSync)(process.execPath, [EXPAND_SCRIPT, ...expandArgs], {
|
|
250
|
+
encoding: "utf8",
|
|
251
|
+
});
|
|
252
|
+
if (result.status !== 0) {
|
|
253
|
+
error(`expand failed for ${entry.pack_id}:\n${result.stderr || result.stdout}`);
|
|
254
|
+
return { ok: false, conflicts: 0 };
|
|
255
|
+
}
|
|
256
|
+
const tmpLock = (0, lock_1.readLock)(tmpDir);
|
|
257
|
+
const resolvedEntry = (tmpLock && tmpLock.packs.find((p) => p.pack_id === entry.pack_id)) || null;
|
|
258
|
+
const renderedFiles = (0, DirectorySnapshot_1.walkFiles)(tmpDir);
|
|
259
|
+
const counts = {};
|
|
260
|
+
const conflictFiles = [];
|
|
261
|
+
const baselineEntries = [];
|
|
262
|
+
for (const rel of renderedFiles) {
|
|
263
|
+
const incoming = fs.readFileSync(path.join(tmpDir, rel), "utf8");
|
|
264
|
+
const { outcome, baselineContent } = reconcileFile(rel, incoming, projectDir, entry.pack_id, args);
|
|
265
|
+
counts[outcome] = (counts[outcome] || 0) + 1;
|
|
266
|
+
if (Reconciliation_1.CONFLICT_OUTCOMES.has(outcome))
|
|
267
|
+
conflictFiles.push({ rel, outcome });
|
|
268
|
+
if (baselineContent !== null)
|
|
269
|
+
baselineEntries.push({ rel, content: baselineContent });
|
|
270
|
+
}
|
|
271
|
+
printPackSummary(entry.pack_id, version, counts, conflictFiles);
|
|
272
|
+
// A pack may ship `changes/`. They land as proposed changes — never
|
|
273
|
+
// applied — so the consuming team reviews them like any other change.
|
|
274
|
+
// Additive: a change id already present locally is skipped, not replaced.
|
|
275
|
+
try {
|
|
276
|
+
const resolved = resolvePackRootForChanges(entry, version, args);
|
|
277
|
+
if (resolved) {
|
|
278
|
+
const { deposited, skipped } = (0, PackChangeDeposit_1.depositPackChanges)(projectDir, resolved, entry.pack_id, {
|
|
279
|
+
dryRun: args.dryRun,
|
|
280
|
+
});
|
|
281
|
+
for (const id of deposited) {
|
|
282
|
+
info(` proposed change from pack: ${id}${args.dryRun ? " (dry-run)" : ""}`);
|
|
283
|
+
}
|
|
284
|
+
for (const id of skipped) {
|
|
285
|
+
warn(` pack change '${id}' skipped — a local change with that id already exists`);
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
catch (err) {
|
|
290
|
+
warn(` could not read changes shipped by ${entry.pack_id}: ${err.message}`);
|
|
291
|
+
}
|
|
292
|
+
if (!args.dryRun) {
|
|
293
|
+
(0, manifest_1.snapshotBaseline)(projectDir, entry.pack_id, baselineEntries, { version: (resolvedEntry && resolvedEntry.version) || version }, { dryRun: false });
|
|
294
|
+
}
|
|
295
|
+
return {
|
|
296
|
+
ok: true,
|
|
297
|
+
conflicts: conflictFiles.length,
|
|
298
|
+
resolvedEntry,
|
|
299
|
+
version,
|
|
300
|
+
};
|
|
301
|
+
}
|
|
302
|
+
finally {
|
|
303
|
+
fs.rmSync(tmpDir, { recursive: true, force: true });
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
function printPackSummary(packId, version, counts, conflictFiles) {
|
|
307
|
+
const parts = Object.keys(Reconciliation_1.OUTCOME_LABEL)
|
|
308
|
+
.filter((k) => counts[k])
|
|
309
|
+
.map((k) => `${counts[k]} ${Reconciliation_1.OUTCOME_LABEL[k]}`);
|
|
310
|
+
process.stdout.write(`\n── ${packId} @ ${version} ──\n`);
|
|
311
|
+
process.stdout.write(` ${parts.length ? parts.join(" · ") : "no files"}\n`);
|
|
312
|
+
for (const { rel, outcome } of conflictFiles) {
|
|
313
|
+
warn(` ${rel} — ${Reconciliation_1.OUTCOME_LABEL[outcome]}`);
|
|
314
|
+
}
|
|
315
|
+
}
|
|
316
|
+
class SyncCommand extends command_1.BaseCommand {
|
|
317
|
+
execute() {
|
|
318
|
+
try {
|
|
319
|
+
const args = parseArgs(this.args);
|
|
320
|
+
const projectDir = (0, project_root_1.resolveProjectDir)(args.projectDir);
|
|
321
|
+
const { packs, source } = resolvePacks(projectDir);
|
|
322
|
+
info(`Reading pack list from ${source}`);
|
|
323
|
+
if (args.dryRun)
|
|
324
|
+
info("Dry run — no files will be written.");
|
|
325
|
+
let matched = 0;
|
|
326
|
+
let totalConflicts = 0;
|
|
327
|
+
let anyFailure = false;
|
|
328
|
+
const lockUpdates = [];
|
|
329
|
+
for (const entry of packs) {
|
|
330
|
+
if (args.pack && entry.pack_id !== args.pack)
|
|
331
|
+
continue;
|
|
332
|
+
matched += 1;
|
|
333
|
+
const res = syncPack(entry, args, projectDir);
|
|
334
|
+
if (!res.ok) {
|
|
335
|
+
anyFailure = true;
|
|
336
|
+
continue;
|
|
337
|
+
}
|
|
338
|
+
totalConflicts += res.conflicts;
|
|
339
|
+
if (res.resolvedEntry)
|
|
340
|
+
lockUpdates.push(res.resolvedEntry);
|
|
341
|
+
}
|
|
342
|
+
if (matched === 0) {
|
|
343
|
+
error(`No packs matched${args.pack ? ` --pack ${args.pack}` : ""}.`);
|
|
344
|
+
process.exit(1);
|
|
345
|
+
}
|
|
346
|
+
// Persist resolved versions/commits to the project lockfile.
|
|
347
|
+
if (!args.dryRun && lockUpdates.length > 0) {
|
|
348
|
+
let lock = (0, lock_1.readLock)(projectDir) || (0, lock_1.newLock)();
|
|
349
|
+
for (const resolved of lockUpdates) {
|
|
350
|
+
lock = (0, lock_1.upsertPackEntry)(lock, {
|
|
351
|
+
repo: resolved.repo,
|
|
352
|
+
version: resolved.version,
|
|
353
|
+
commit: resolved.commit,
|
|
354
|
+
pack_id: resolved.pack_id,
|
|
355
|
+
expanded_at: resolved.expanded_at || new Date().toISOString(),
|
|
356
|
+
vars: resolved.vars || {},
|
|
357
|
+
});
|
|
358
|
+
}
|
|
359
|
+
(0, lock_1.writeLock)(projectDir, lock);
|
|
360
|
+
}
|
|
361
|
+
if (anyFailure) {
|
|
362
|
+
error("One or more packs failed to expand.");
|
|
363
|
+
process.exit(1);
|
|
364
|
+
}
|
|
365
|
+
if (totalConflicts > 0) {
|
|
366
|
+
process.stdout.write("\n");
|
|
367
|
+
error(`Sync completed with ${totalConflicts} conflicting file(s). ` +
|
|
368
|
+
`Resolve them, then re-run 'specops sync'.`);
|
|
369
|
+
process.exit(1);
|
|
370
|
+
}
|
|
371
|
+
info(`Sync completed for ${matched} pack(s) with no conflicts.`);
|
|
372
|
+
}
|
|
373
|
+
catch (err) {
|
|
374
|
+
error(err.message);
|
|
375
|
+
process.exit(1);
|
|
376
|
+
}
|
|
377
|
+
}
|
|
378
|
+
}
|
|
379
|
+
exports.SyncCommand = SyncCommand;
|
|
380
|
+
//# sourceMappingURL=SyncCommand.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"SyncCommand.js","sourceRoot":"","sources":["../../../../../scripts/cli/commands/specops/SyncCommand.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
"use strict";
|
|
3
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
+
exports.GENERATORS = exports.installTarget = exports.fishScript = exports.zshScript = exports.bashScript = exports.SUBCOMMANDS = exports.COMMANDS = exports.CompletionCommand = void 0;
|
|
5
|
+
exports.main = main;
|
|
6
|
+
/**
|
|
7
|
+
* Supported shells: "bash", "zsh", "fish"
|
|
8
|
+
*/
|
|
9
|
+
const CompletionCommand_1 = require("./cli/commands/config/CompletionCommand");
|
|
10
|
+
Object.defineProperty(exports, "CompletionCommand", { enumerable: true, get: function () { return CompletionCommand_1.CompletionCommand; } });
|
|
11
|
+
Object.defineProperty(exports, "COMMANDS", { enumerable: true, get: function () { return CompletionCommand_1.COMMANDS; } });
|
|
12
|
+
Object.defineProperty(exports, "SUBCOMMANDS", { enumerable: true, get: function () { return CompletionCommand_1.SUBCOMMANDS; } });
|
|
13
|
+
Object.defineProperty(exports, "bashScript", { enumerable: true, get: function () { return CompletionCommand_1.bashScript; } });
|
|
14
|
+
Object.defineProperty(exports, "zshScript", { enumerable: true, get: function () { return CompletionCommand_1.zshScript; } });
|
|
15
|
+
Object.defineProperty(exports, "fishScript", { enumerable: true, get: function () { return CompletionCommand_1.fishScript; } });
|
|
16
|
+
Object.defineProperty(exports, "installTarget", { enumerable: true, get: function () { return CompletionCommand_1.installTarget; } });
|
|
17
|
+
Object.defineProperty(exports, "GENERATORS", { enumerable: true, get: function () { return CompletionCommand_1.GENERATORS; } });
|
|
18
|
+
function main(argv) {
|
|
19
|
+
new CompletionCommand_1.CompletionCommand(argv).execute();
|
|
20
|
+
}
|
|
21
|
+
if (require.main === module) {
|
|
22
|
+
new CompletionCommand_1.CompletionCommand(process.argv.slice(2)).execute();
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=completion.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../scripts/completion.ts"],"names":[],"mappings":";;;;AA0BA,oBAEC;AA3BD;;GAEG;AACH,+EASiD;AAG/C,kGAXA,qCAAiB,OAWA;AACjB,yFAXA,4BAAQ,OAWA;AACR,4FAXA,+BAAW,OAWA;AACX,2FAXA,8BAAU,OAWA;AACV,0FAXA,6BAAS,OAWA;AACT,2FAXA,8BAAU,OAWA;AACV,8FAXA,iCAAa,OAWA;AACb,2FAXA,8BAAU,OAWA;AAGZ,SAAgB,IAAI,CAAC,IAAc;IACjC,IAAI,qCAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,qCAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACzD,CAAC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
"use strict";
|
|
3
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
+
exports.TEMPLATE = exports.parseArgs = exports.ConfigInitCommand = void 0;
|
|
5
|
+
const ConfigInitCommand_1 = require("./cli/commands/config/ConfigInitCommand");
|
|
6
|
+
Object.defineProperty(exports, "ConfigInitCommand", { enumerable: true, get: function () { return ConfigInitCommand_1.ConfigInitCommand; } });
|
|
7
|
+
Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return ConfigInitCommand_1.parseArgs; } });
|
|
8
|
+
Object.defineProperty(exports, "TEMPLATE", { enumerable: true, get: function () { return ConfigInitCommand_1.TEMPLATE; } });
|
|
9
|
+
if (require.main === module) {
|
|
10
|
+
new ConfigInitCommand_1.ConfigInitCommand(process.argv.slice(2)).execute();
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=config_init.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config_init.js","sourceRoot":"","sources":["../../scripts/config_init.ts"],"names":[],"mappings":";;;;AACA,+EAKiD;AAExC,kGANP,qCAAiB,OAMO;AAAE,0FAL1B,6BAAS,OAK0B;AAAE,yFAJrC,4BAAQ,OAIqC;AAE/C,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,qCAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACzD,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
"use strict";
|
|
3
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
+
exports.write = exports.read = exports.configPath = exports.KEYS = exports.CONFIG_FILE = exports.CONFIG_DIR = exports.ConfigSetCommand = void 0;
|
|
5
|
+
exports.main = main;
|
|
6
|
+
const ConfigSetCommand_1 = require("./cli/commands/config/ConfigSetCommand");
|
|
7
|
+
Object.defineProperty(exports, "ConfigSetCommand", { enumerable: true, get: function () { return ConfigSetCommand_1.ConfigSetCommand; } });
|
|
8
|
+
Object.defineProperty(exports, "CONFIG_DIR", { enumerable: true, get: function () { return ConfigSetCommand_1.CONFIG_DIR; } });
|
|
9
|
+
Object.defineProperty(exports, "CONFIG_FILE", { enumerable: true, get: function () { return ConfigSetCommand_1.CONFIG_FILE; } });
|
|
10
|
+
Object.defineProperty(exports, "KEYS", { enumerable: true, get: function () { return ConfigSetCommand_1.KEYS; } });
|
|
11
|
+
Object.defineProperty(exports, "configPath", { enumerable: true, get: function () { return ConfigSetCommand_1.configPath; } });
|
|
12
|
+
Object.defineProperty(exports, "read", { enumerable: true, get: function () { return ConfigSetCommand_1.read; } });
|
|
13
|
+
Object.defineProperty(exports, "write", { enumerable: true, get: function () { return ConfigSetCommand_1.write; } });
|
|
14
|
+
function main(argv) {
|
|
15
|
+
new ConfigSetCommand_1.ConfigSetCommand(argv).execute();
|
|
16
|
+
}
|
|
17
|
+
if (require.main === module) {
|
|
18
|
+
new ConfigSetCommand_1.ConfigSetCommand(process.argv.slice(2)).execute();
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=config_set.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config_set.js","sourceRoot":"","sources":["../../scripts/config_set.ts"],"names":[],"mappings":";;;;AAaA,oBAEC;AAdD,6EAQgD;AAEvC,iGATP,mCAAgB,OASO;AAAE,2FARzB,6BAAU,OAQyB;AAAE,4FAPrC,8BAAW,OAOqC;AAAE,qFANlD,uBAAI,OAMkD;AAAE,2FALxD,6BAAU,OAKwD;AAAE,qFAJpE,uBAAI,OAIoE;AAAE,sFAH1E,wBAAK,OAG0E;AAEjF,SAAgB,IAAI,CAAC,IAAc;IACjC,IAAI,mCAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,mCAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACxD,CAAC"}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Generated blocks inside hand-written files.
|
|
4
|
+
*
|
|
5
|
+
* Two things on this site are produced by a script and live inside a file a
|
|
6
|
+
* person edits: the diagrams, and the recorded terminal transcript. Both need
|
|
7
|
+
* the same three operations — find the block, read it, replace it — and both
|
|
8
|
+
* need the replacement to be idempotent, because a generator that appends on
|
|
9
|
+
* every run is a generator nobody runs twice.
|
|
10
|
+
*
|
|
11
|
+
* The sentinels are HTML comments so the block survives in `index.html`, which
|
|
12
|
+
* is published byte for byte, and in markdown, which passes HTML through.
|
|
13
|
+
*/
|
|
14
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
15
|
+
if (k2 === undefined) k2 = k;
|
|
16
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
17
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
18
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
19
|
+
}
|
|
20
|
+
Object.defineProperty(o, k2, desc);
|
|
21
|
+
}) : (function(o, m, k, k2) {
|
|
22
|
+
if (k2 === undefined) k2 = k;
|
|
23
|
+
o[k2] = m[k];
|
|
24
|
+
}));
|
|
25
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
26
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
27
|
+
}) : function(o, v) {
|
|
28
|
+
o["default"] = v;
|
|
29
|
+
});
|
|
30
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
31
|
+
var ownKeys = function(o) {
|
|
32
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
33
|
+
var ar = [];
|
|
34
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
35
|
+
return ar;
|
|
36
|
+
};
|
|
37
|
+
return ownKeys(o);
|
|
38
|
+
};
|
|
39
|
+
return function (mod) {
|
|
40
|
+
if (mod && mod.__esModule) return mod;
|
|
41
|
+
var result = {};
|
|
42
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
43
|
+
__setModuleDefault(result, mod);
|
|
44
|
+
return result;
|
|
45
|
+
};
|
|
46
|
+
})();
|
|
47
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
48
|
+
exports.DIAGRAM_DIR = void 0;
|
|
49
|
+
exports.beginMarker = beginMarker;
|
|
50
|
+
exports.endMarker = endMarker;
|
|
51
|
+
exports.readBlock = readBlock;
|
|
52
|
+
exports.replaceBlock = replaceBlock;
|
|
53
|
+
exports.diagrams = diagrams;
|
|
54
|
+
exports.inlineDiagrams = inlineDiagrams;
|
|
55
|
+
const fs = __importStar(require("node:fs"));
|
|
56
|
+
const path = __importStar(require("node:path"));
|
|
57
|
+
/**
|
|
58
|
+
* Where the diagram sources live. One directory, one mechanism.
|
|
59
|
+
*
|
|
60
|
+
* Outside `assets/`, which is published wholesale: these are sources that get
|
|
61
|
+
* inlined, so shipping them as separate files would be three more requests
|
|
62
|
+
* nobody makes.
|
|
63
|
+
*/
|
|
64
|
+
exports.DIAGRAM_DIR = "diagrams";
|
|
65
|
+
function beginMarker(name) {
|
|
66
|
+
return `<!-- csda:${name}:begin — generated; edit the source, not this block -->`;
|
|
67
|
+
}
|
|
68
|
+
function endMarker(name) {
|
|
69
|
+
return `<!-- csda:${name}:end -->`;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* The contents of a named block, or `null` if the file has no such block.
|
|
73
|
+
*
|
|
74
|
+
* Returns the text between the sentinels with the surrounding newlines trimmed,
|
|
75
|
+
* which is what a comparison wants; `replaceBlock` puts them back.
|
|
76
|
+
*/
|
|
77
|
+
function readBlock(source, name) {
|
|
78
|
+
const begin = source.indexOf(beginMarker(name));
|
|
79
|
+
if (begin === -1)
|
|
80
|
+
return null;
|
|
81
|
+
const from = begin + beginMarker(name).length;
|
|
82
|
+
const to = source.indexOf(endMarker(name), from);
|
|
83
|
+
if (to === -1)
|
|
84
|
+
throw new Error(`block "${name}" opens and never closes`);
|
|
85
|
+
return source.slice(from, to).trim();
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* The same file with one block's contents replaced.
|
|
89
|
+
*
|
|
90
|
+
* Throws rather than appending when the block is absent: a missing sentinel
|
|
91
|
+
* means the file was edited in a way the generator does not understand, and
|
|
92
|
+
* guessing where the block should go is how generated markup ends up in two
|
|
93
|
+
* places at once.
|
|
94
|
+
*/
|
|
95
|
+
function replaceBlock(source, name, content) {
|
|
96
|
+
const begin = source.indexOf(beginMarker(name));
|
|
97
|
+
if (begin === -1) {
|
|
98
|
+
throw new Error(`no "${name}" block to replace — expected ${beginMarker(name)}`);
|
|
99
|
+
}
|
|
100
|
+
const from = begin + beginMarker(name).length;
|
|
101
|
+
const to = source.indexOf(endMarker(name), from);
|
|
102
|
+
if (to === -1)
|
|
103
|
+
throw new Error(`block "${name}" opens and never closes`);
|
|
104
|
+
return `${source.slice(0, from)}\n${content.trim()}\n${source.slice(to)}`;
|
|
105
|
+
}
|
|
106
|
+
/** Every diagram source, by name. */
|
|
107
|
+
function diagrams(docsDir) {
|
|
108
|
+
const dir = path.join(docsDir, exports.DIAGRAM_DIR);
|
|
109
|
+
const out = new Map();
|
|
110
|
+
if (!fs.existsSync(dir))
|
|
111
|
+
return out;
|
|
112
|
+
for (const file of fs.readdirSync(dir).sort()) {
|
|
113
|
+
if (!file.endsWith(".html"))
|
|
114
|
+
continue;
|
|
115
|
+
out.set(file.slice(0, -5), fs.readFileSync(path.join(dir, file), "utf8").trim());
|
|
116
|
+
}
|
|
117
|
+
return out;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Markdown with `<!-- csda:diagram NAME -->` replaced by the diagram itself.
|
|
121
|
+
*
|
|
122
|
+
* Inline rather than `<img src>` on purpose: these diagrams are coloured with
|
|
123
|
+
* the site's tokens, and a var does not cross into an externally loaded SVG. An
|
|
124
|
+
* `<img>` diagram would follow `prefers-color-scheme` and ignore the theme
|
|
125
|
+
* toggle, which is the one case where it would visibly disagree with the page
|
|
126
|
+
* around it.
|
|
127
|
+
*/
|
|
128
|
+
function inlineDiagrams(source, available) {
|
|
129
|
+
return source.replace(/<!--\s*csda:diagram\s+([a-z0-9-]+)\s*-->/g, (_match, name) => {
|
|
130
|
+
const svg = available.get(name);
|
|
131
|
+
if (!svg) {
|
|
132
|
+
throw new Error(`no diagram named "${name}" in docs/${exports.DIAGRAM_DIR}/`);
|
|
133
|
+
}
|
|
134
|
+
return svg;
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
//# sourceMappingURL=blocks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../scripts/docs/blocks.ts"],"names":[],"mappings":"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"}
|