@shrkcrft/cli 0.1.0-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +15 -0
- package/dist/asset-preview/apply-action-hint-stub.d.ts +28 -0
- package/dist/asset-preview/apply-action-hint-stub.d.ts.map +1 -0
- package/dist/asset-preview/apply-action-hint-stub.js +170 -0
- package/dist/asset-preview/apply-asset-preview.d.ts +31 -0
- package/dist/asset-preview/apply-asset-preview.d.ts.map +1 -0
- package/dist/asset-preview/apply-asset-preview.js +210 -0
- package/dist/asset-preview/apply-knowledge-stale-fix.d.ts +37 -0
- package/dist/asset-preview/apply-knowledge-stale-fix.d.ts.map +1 -0
- package/dist/asset-preview/apply-knowledge-stale-fix.js +344 -0
- package/dist/asset-preview/apply-missing-barrel.d.ts +15 -0
- package/dist/asset-preview/apply-missing-barrel.d.ts.map +1 -0
- package/dist/asset-preview/apply-missing-barrel.js +65 -0
- package/dist/asset-preview/apply-template-drift-fix.d.ts +21 -0
- package/dist/asset-preview/apply-template-drift-fix.d.ts.map +1 -0
- package/dist/asset-preview/apply-template-drift-fix.js +125 -0
- package/dist/asset-preview/apply-template-update.d.ts +43 -0
- package/dist/asset-preview/apply-template-update.d.ts.map +1 -0
- package/dist/asset-preview/apply-template-update.js +257 -0
- package/dist/asset-preview/entry-mutator.d.ts +106 -0
- package/dist/asset-preview/entry-mutator.d.ts.map +1 -0
- package/dist/asset-preview/entry-mutator.js +428 -0
- package/dist/authoring/authoring-kit.d.ts +36 -0
- package/dist/authoring/authoring-kit.d.ts.map +1 -0
- package/dist/authoring/authoring-kit.js +106 -0
- package/dist/command-registry.d.ts +158 -0
- package/dist/command-registry.d.ts.map +1 -0
- package/dist/command-registry.js +348 -0
- package/dist/commands/apply.command.d.ts +3 -0
- package/dist/commands/apply.command.d.ts.map +1 -0
- package/dist/commands/apply.command.js +879 -0
- package/dist/commands/architecture.command.d.ts +5 -0
- package/dist/commands/architecture.command.d.ts.map +1 -0
- package/dist/commands/architecture.command.js +141 -0
- package/dist/commands/ask.command.d.ts +3 -0
- package/dist/commands/ask.command.d.ts.map +1 -0
- package/dist/commands/ask.command.js +58 -0
- package/dist/commands/audit.command.d.ts +3 -0
- package/dist/commands/audit.command.d.ts.map +1 -0
- package/dist/commands/audit.command.js +141 -0
- package/dist/commands/biome.command.d.ts +7 -0
- package/dist/commands/biome.command.d.ts.map +1 -0
- package/dist/commands/biome.command.js +350 -0
- package/dist/commands/boundaries.command.d.ts +9 -0
- package/dist/commands/boundaries.command.d.ts.map +1 -0
- package/dist/commands/boundaries.command.js +314 -0
- package/dist/commands/brief.command.d.ts +3 -0
- package/dist/commands/brief.command.d.ts.map +1 -0
- package/dist/commands/brief.command.js +206 -0
- package/dist/commands/bundle.command.d.ts +3 -0
- package/dist/commands/bundle.command.d.ts.map +1 -0
- package/dist/commands/bundle.command.js +1183 -0
- package/dist/commands/changes.command.d.ts +3 -0
- package/dist/commands/changes.command.d.ts.map +1 -0
- package/dist/commands/changes.command.js +155 -0
- package/dist/commands/check.command.d.ts +3 -0
- package/dist/commands/check.command.d.ts.map +1 -0
- package/dist/commands/check.command.js +553 -0
- package/dist/commands/checks.command.d.ts +29 -0
- package/dist/commands/checks.command.d.ts.map +1 -0
- package/dist/commands/checks.command.js +521 -0
- package/dist/commands/ci.command.d.ts +3 -0
- package/dist/commands/ci.command.d.ts.map +1 -0
- package/dist/commands/ci.command.js +680 -0
- package/dist/commands/codemod.command.d.ts +3 -0
- package/dist/commands/codemod.command.d.ts.map +1 -0
- package/dist/commands/codemod.command.js +130 -0
- package/dist/commands/command-catalog.d.ts +265 -0
- package/dist/commands/command-catalog.d.ts.map +1 -0
- package/dist/commands/command-catalog.js +3242 -0
- package/dist/commands/commands.command.d.ts +92 -0
- package/dist/commands/commands.command.d.ts.map +1 -0
- package/dist/commands/commands.command.js +1208 -0
- package/dist/commands/constructs.command.d.ts +15 -0
- package/dist/commands/constructs.command.d.ts.map +1 -0
- package/dist/commands/constructs.command.js +669 -0
- package/dist/commands/context.command.d.ts +3 -0
- package/dist/commands/context.command.d.ts.map +1 -0
- package/dist/commands/context.command.js +120 -0
- package/dist/commands/contract-gate.command.d.ts +5 -0
- package/dist/commands/contract-gate.command.d.ts.map +1 -0
- package/dist/commands/contract-gate.command.js +208 -0
- package/dist/commands/contract-templates.command.d.ts +8 -0
- package/dist/commands/contract-templates.command.d.ts.map +1 -0
- package/dist/commands/contract-templates.command.js +151 -0
- package/dist/commands/contract.command.d.ts +3 -0
- package/dist/commands/contract.command.d.ts.map +1 -0
- package/dist/commands/contract.command.js +105 -0
- package/dist/commands/conventions.command.d.ts +8 -0
- package/dist/commands/conventions.command.d.ts.map +1 -0
- package/dist/commands/conventions.command.js +169 -0
- package/dist/commands/coverage.command.d.ts +3 -0
- package/dist/commands/coverage.command.d.ts.map +1 -0
- package/dist/commands/coverage.command.js +56 -0
- package/dist/commands/daily.commands.d.ts +5 -0
- package/dist/commands/daily.commands.d.ts.map +1 -0
- package/dist/commands/daily.commands.js +224 -0
- package/dist/commands/dashboard-export.command.d.ts +4 -0
- package/dist/commands/dashboard-export.command.d.ts.map +1 -0
- package/dist/commands/dashboard-export.command.js +86 -0
- package/dist/commands/dashboard.command.d.ts +3 -0
- package/dist/commands/dashboard.command.d.ts.map +1 -0
- package/dist/commands/dashboard.command.js +106 -0
- package/dist/commands/dev.command.d.ts +3 -0
- package/dist/commands/dev.command.d.ts.map +1 -0
- package/dist/commands/dev.command.js +1392 -0
- package/dist/commands/diagnostics.command.d.ts +5 -0
- package/dist/commands/diagnostics.command.d.ts.map +1 -0
- package/dist/commands/diagnostics.command.js +97 -0
- package/dist/commands/docs.command.d.ts +4 -0
- package/dist/commands/docs.command.d.ts.map +1 -0
- package/dist/commands/docs.command.js +34 -0
- package/dist/commands/doctor.command.d.ts +7 -0
- package/dist/commands/doctor.command.d.ts.map +1 -0
- package/dist/commands/doctor.command.js +681 -0
- package/dist/commands/drift.command.d.ts +3 -0
- package/dist/commands/drift.command.d.ts.map +1 -0
- package/dist/commands/drift.command.js +124 -0
- package/dist/commands/eslint.command.d.ts +7 -0
- package/dist/commands/eslint.command.d.ts.map +1 -0
- package/dist/commands/eslint.command.js +423 -0
- package/dist/commands/explore.command.d.ts +3 -0
- package/dist/commands/explore.command.d.ts.map +1 -0
- package/dist/commands/explore.command.js +65 -0
- package/dist/commands/export-bundle.command.d.ts +6 -0
- package/dist/commands/export-bundle.command.d.ts.map +1 -0
- package/dist/commands/export-bundle.command.js +96 -0
- package/dist/commands/export.command.d.ts +3 -0
- package/dist/commands/export.command.d.ts.map +1 -0
- package/dist/commands/export.command.js +83 -0
- package/dist/commands/feedback-dispatch.command.d.ts +12 -0
- package/dist/commands/feedback-dispatch.command.d.ts.map +1 -0
- package/dist/commands/feedback-dispatch.command.js +63 -0
- package/dist/commands/feedback.command.d.ts +11 -0
- package/dist/commands/feedback.command.d.ts.map +1 -0
- package/dist/commands/feedback.command.js +336 -0
- package/dist/commands/fix.command.d.ts +3 -0
- package/dist/commands/fix.command.d.ts.map +1 -0
- package/dist/commands/fix.command.js +776 -0
- package/dist/commands/gen.command.d.ts +3 -0
- package/dist/commands/gen.command.d.ts.map +1 -0
- package/dist/commands/gen.command.js +136 -0
- package/dist/commands/git.command.d.ts +6 -0
- package/dist/commands/git.command.d.ts.map +1 -0
- package/dist/commands/git.command.js +81 -0
- package/dist/commands/graph.command.d.ts +3 -0
- package/dist/commands/graph.command.d.ts.map +1 -0
- package/dist/commands/graph.command.js +287 -0
- package/dist/commands/grounding.command.d.ts +7 -0
- package/dist/commands/grounding.command.d.ts.map +1 -0
- package/dist/commands/grounding.command.js +54 -0
- package/dist/commands/help.command.d.ts +20 -0
- package/dist/commands/help.command.d.ts.map +1 -0
- package/dist/commands/help.command.js +127 -0
- package/dist/commands/helper.command.d.ts +6 -0
- package/dist/commands/helper.command.d.ts.map +1 -0
- package/dist/commands/helper.command.js +170 -0
- package/dist/commands/ide.command.d.ts +6 -0
- package/dist/commands/ide.command.d.ts.map +1 -0
- package/dist/commands/ide.command.js +340 -0
- package/dist/commands/impact.command.d.ts +3 -0
- package/dist/commands/impact.command.d.ts.map +1 -0
- package/dist/commands/impact.command.js +819 -0
- package/dist/commands/import.command.d.ts +3 -0
- package/dist/commands/import.command.d.ts.map +1 -0
- package/dist/commands/import.command.js +115 -0
- package/dist/commands/infer.command.d.ts +3 -0
- package/dist/commands/infer.command.d.ts.map +1 -0
- package/dist/commands/infer.command.js +227 -0
- package/dist/commands/ingest.command.d.ts +6 -0
- package/dist/commands/ingest.command.d.ts.map +1 -0
- package/dist/commands/ingest.command.js +532 -0
- package/dist/commands/init.command.d.ts +3 -0
- package/dist/commands/init.command.d.ts.map +1 -0
- package/dist/commands/init.command.js +301 -0
- package/dist/commands/inspect.command.d.ts +3 -0
- package/dist/commands/inspect.command.d.ts.map +1 -0
- package/dist/commands/inspect.command.js +122 -0
- package/dist/commands/knowledge-author.command.d.ts +22 -0
- package/dist/commands/knowledge-author.command.d.ts.map +1 -0
- package/dist/commands/knowledge-author.command.js +366 -0
- package/dist/commands/knowledge-propose.command.d.ts +3 -0
- package/dist/commands/knowledge-propose.command.d.ts.map +1 -0
- package/dist/commands/knowledge-propose.command.js +125 -0
- package/dist/commands/knowledge.command.d.ts +18 -0
- package/dist/commands/knowledge.command.d.ts.map +1 -0
- package/dist/commands/knowledge.command.js +538 -0
- package/dist/commands/languages.command.d.ts +3 -0
- package/dist/commands/languages.command.d.ts.map +1 -0
- package/dist/commands/languages.command.js +300 -0
- package/dist/commands/lint.command.d.ts +15 -0
- package/dist/commands/lint.command.d.ts.map +1 -0
- package/dist/commands/lint.command.js +194 -0
- package/dist/commands/mcp.command.d.ts +3 -0
- package/dist/commands/mcp.command.d.ts.map +1 -0
- package/dist/commands/mcp.command.js +74 -0
- package/dist/commands/memory.command.d.ts +11 -0
- package/dist/commands/memory.command.d.ts.map +1 -0
- package/dist/commands/memory.command.js +264 -0
- package/dist/commands/onboard.command.d.ts +3 -0
- package/dist/commands/onboard.command.d.ts.map +1 -0
- package/dist/commands/onboard.command.js +650 -0
- package/dist/commands/orchestrate.command.d.ts +3 -0
- package/dist/commands/orchestrate.command.d.ts.map +1 -0
- package/dist/commands/orchestrate.command.js +49 -0
- package/dist/commands/owners.command.d.ts +5 -0
- package/dist/commands/owners.command.d.ts.map +1 -0
- package/dist/commands/owners.command.js +113 -0
- package/dist/commands/ownership.command.d.ts +5 -0
- package/dist/commands/ownership.command.d.ts.map +1 -0
- package/dist/commands/ownership.command.js +117 -0
- package/dist/commands/pack-author.command.d.ts +30 -0
- package/dist/commands/pack-author.command.d.ts.map +1 -0
- package/dist/commands/pack-author.command.js +242 -0
- package/dist/commands/packs-new.d.ts +27 -0
- package/dist/commands/packs-new.d.ts.map +1 -0
- package/dist/commands/packs-new.js +805 -0
- package/dist/commands/packs.command.d.ts +15 -0
- package/dist/commands/packs.command.d.ts.map +1 -0
- package/dist/commands/packs.command.js +958 -0
- package/dist/commands/paths.command.d.ts +6 -0
- package/dist/commands/paths.command.d.ts.map +1 -0
- package/dist/commands/paths.command.js +97 -0
- package/dist/commands/pipelines.command.d.ts +9 -0
- package/dist/commands/pipelines.command.d.ts.map +1 -0
- package/dist/commands/pipelines.command.js +308 -0
- package/dist/commands/plan-check.command.d.ts +27 -0
- package/dist/commands/plan-check.command.d.ts.map +1 -0
- package/dist/commands/plan-check.command.js +150 -0
- package/dist/commands/plan-simulate.command.d.ts +3 -0
- package/dist/commands/plan-simulate.command.d.ts.map +1 -0
- package/dist/commands/plan-simulate.command.js +60 -0
- package/dist/commands/plan.command.d.ts +8 -0
- package/dist/commands/plan.command.d.ts.map +1 -0
- package/dist/commands/plan.command.js +139 -0
- package/dist/commands/playbooks.command.d.ts +10 -0
- package/dist/commands/playbooks.command.d.ts.map +1 -0
- package/dist/commands/playbooks.command.js +296 -0
- package/dist/commands/plugin.command.d.ts +11 -0
- package/dist/commands/plugin.command.d.ts.map +1 -0
- package/dist/commands/plugin.command.js +394 -0
- package/dist/commands/policy.command.d.ts +8 -0
- package/dist/commands/policy.command.d.ts.map +1 -0
- package/dist/commands/policy.command.js +451 -0
- package/dist/commands/pr.command.d.ts +3 -0
- package/dist/commands/pr.command.d.ts.map +1 -0
- package/dist/commands/pr.command.js +132 -0
- package/dist/commands/preflight.command.d.ts +3 -0
- package/dist/commands/preflight.command.d.ts.map +1 -0
- package/dist/commands/preflight.command.js +102 -0
- package/dist/commands/presets.command.d.ts +17 -0
- package/dist/commands/presets.command.d.ts.map +1 -0
- package/dist/commands/presets.command.js +647 -0
- package/dist/commands/profiles.command.d.ts +7 -0
- package/dist/commands/profiles.command.d.ts.map +1 -0
- package/dist/commands/profiles.command.js +151 -0
- package/dist/commands/provenance.command.d.ts +26 -0
- package/dist/commands/provenance.command.d.ts.map +1 -0
- package/dist/commands/provenance.command.js +237 -0
- package/dist/commands/quality.command.d.ts +5 -0
- package/dist/commands/quality.command.d.ts.map +1 -0
- package/dist/commands/quality.command.js +69 -0
- package/dist/commands/recommend.command.d.ts +4 -0
- package/dist/commands/recommend.command.d.ts.map +1 -0
- package/dist/commands/recommend.command.js +270 -0
- package/dist/commands/registrations.command.d.ts +3 -0
- package/dist/commands/registrations.command.d.ts.map +1 -0
- package/dist/commands/registrations.command.js +300 -0
- package/dist/commands/registry.command.d.ts +4 -0
- package/dist/commands/registry.command.d.ts.map +1 -0
- package/dist/commands/registry.command.js +37 -0
- package/dist/commands/release.command.d.ts +4 -0
- package/dist/commands/release.command.d.ts.map +1 -0
- package/dist/commands/release.command.js +639 -0
- package/dist/commands/repo.command.d.ts +3 -0
- package/dist/commands/repo.command.d.ts.map +1 -0
- package/dist/commands/repo.command.js +24 -0
- package/dist/commands/report.command.d.ts +3 -0
- package/dist/commands/report.command.d.ts.map +1 -0
- package/dist/commands/report.command.js +511 -0
- package/dist/commands/reposet.command.d.ts +6 -0
- package/dist/commands/reposet.command.d.ts.map +1 -0
- package/dist/commands/reposet.command.js +120 -0
- package/dist/commands/review.command.d.ts +3 -0
- package/dist/commands/review.command.d.ts.map +1 -0
- package/dist/commands/review.command.js +354 -0
- package/dist/commands/risk.command.d.ts +3 -0
- package/dist/commands/risk.command.d.ts.map +1 -0
- package/dist/commands/risk.command.js +56 -0
- package/dist/commands/rounds.command.d.ts +8 -0
- package/dist/commands/rounds.command.d.ts.map +1 -0
- package/dist/commands/rounds.command.js +180 -0
- package/dist/commands/rules.command.d.ts +49 -0
- package/dist/commands/rules.command.d.ts.map +1 -0
- package/dist/commands/rules.command.js +435 -0
- package/dist/commands/runtime.command.d.ts +3 -0
- package/dist/commands/runtime.command.d.ts.map +1 -0
- package/dist/commands/runtime.command.js +56 -0
- package/dist/commands/safety.command.d.ts +3 -0
- package/dist/commands/safety.command.d.ts.map +1 -0
- package/dist/commands/safety.command.js +117 -0
- package/dist/commands/scaffolds.command.d.ts +5 -0
- package/dist/commands/scaffolds.command.d.ts.map +1 -0
- package/dist/commands/scaffolds.command.js +122 -0
- package/dist/commands/schemas.command.d.ts +21 -0
- package/dist/commands/schemas.command.d.ts.map +1 -0
- package/dist/commands/schemas.command.js +296 -0
- package/dist/commands/search.command.d.ts +12 -0
- package/dist/commands/search.command.d.ts.map +1 -0
- package/dist/commands/search.command.js +275 -0
- package/dist/commands/self-config.command.d.ts +7 -0
- package/dist/commands/self-config.command.d.ts.map +1 -0
- package/dist/commands/self-config.command.js +156 -0
- package/dist/commands/self.command.d.ts +3 -0
- package/dist/commands/self.command.d.ts.map +1 -0
- package/dist/commands/self.command.js +117 -0
- package/dist/commands/simulate.command.d.ts +3 -0
- package/dist/commands/simulate.command.d.ts.map +1 -0
- package/dist/commands/simulate.command.js +54 -0
- package/dist/commands/spec.command.d.ts +29 -0
- package/dist/commands/spec.command.d.ts.map +1 -0
- package/dist/commands/spec.command.js +985 -0
- package/dist/commands/start-here.command.d.ts +3 -0
- package/dist/commands/start-here.command.d.ts.map +1 -0
- package/dist/commands/start-here.command.js +35 -0
- package/dist/commands/stats.command.d.ts +3 -0
- package/dist/commands/stats.command.d.ts.map +1 -0
- package/dist/commands/stats.command.js +88 -0
- package/dist/commands/surface.command.d.ts +15 -0
- package/dist/commands/surface.command.d.ts.map +1 -0
- package/dist/commands/surface.command.js +328 -0
- package/dist/commands/task-context.command.d.ts +7 -0
- package/dist/commands/task-context.command.d.ts.map +1 -0
- package/dist/commands/task-context.command.js +646 -0
- package/dist/commands/task.command.d.ts +3 -0
- package/dist/commands/task.command.d.ts.map +1 -0
- package/dist/commands/task.command.js +301 -0
- package/dist/commands/template-quality.command.d.ts +5 -0
- package/dist/commands/template-quality.command.d.ts.map +1 -0
- package/dist/commands/template-quality.command.js +128 -0
- package/dist/commands/templates.command.d.ts +26 -0
- package/dist/commands/templates.command.d.ts.map +1 -0
- package/dist/commands/templates.command.js +964 -0
- package/dist/commands/test.command.d.ts +3 -0
- package/dist/commands/test.command.d.ts.map +1 -0
- package/dist/commands/test.command.js +262 -0
- package/dist/commands/tests.command.d.ts +5 -0
- package/dist/commands/tests.command.d.ts.map +1 -0
- package/dist/commands/tests.command.js +97 -0
- package/dist/commands/trace.command.d.ts +3 -0
- package/dist/commands/trace.command.d.ts.map +1 -0
- package/dist/commands/trace.command.js +121 -0
- package/dist/commands/upgrade.command.d.ts +4 -0
- package/dist/commands/upgrade.command.d.ts.map +1 -0
- package/dist/commands/upgrade.command.js +43 -0
- package/dist/commands/version.command.d.ts +3 -0
- package/dist/commands/version.command.d.ts.map +1 -0
- package/dist/commands/version.command.js +10 -0
- package/dist/commands/why.command.d.ts +24 -0
- package/dist/commands/why.command.d.ts.map +1 -0
- package/dist/commands/why.command.js +119 -0
- package/dist/dashboard/dashboard-api-server.d.ts +21 -0
- package/dist/dashboard/dashboard-api-server.d.ts.map +1 -0
- package/dist/dashboard/dashboard-api-server.js +410 -0
- package/dist/dashboard/live-session-server.d.ts +18 -0
- package/dist/dashboard/live-session-server.d.ts.map +1 -0
- package/dist/dashboard/live-session-server.js +133 -0
- package/dist/diff/collect-changed-paths.d.ts +27 -0
- package/dist/diff/collect-changed-paths.d.ts.map +1 -0
- package/dist/diff/collect-changed-paths.js +68 -0
- package/dist/doctor/doctor-tags.d.ts +63 -0
- package/dist/doctor/doctor-tags.d.ts.map +1 -0
- package/dist/doctor/doctor-tags.js +146 -0
- package/dist/export/export-formats.d.ts +22 -0
- package/dist/export/export-formats.d.ts.map +1 -0
- package/dist/export/export-formats.js +135 -0
- package/dist/index.d.ts +22 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +21 -0
- package/dist/init/detected-block.d.ts +57 -0
- package/dist/init/detected-block.d.ts.map +1 -0
- package/dist/init/detected-block.js +197 -0
- package/dist/init/gitignore.d.ts +30 -0
- package/dist/init/gitignore.d.ts.map +1 -0
- package/dist/init/gitignore.js +110 -0
- package/dist/init/init-templates.d.ts +6 -0
- package/dist/init/init-templates.d.ts.map +1 -0
- package/dist/init/init-templates.js +413 -0
- package/dist/main.d.ts +18 -0
- package/dist/main.d.ts.map +1 -0
- package/dist/main.js +699 -0
- package/dist/output/failure-hints.d.ts +55 -0
- package/dist/output/failure-hints.d.ts.map +1 -0
- package/dist/output/failure-hints.js +159 -0
- package/dist/output/format-output.d.ts +9 -0
- package/dist/output/format-output.d.ts.map +1 -0
- package/dist/output/format-output.js +26 -0
- package/dist/output/print-error.d.ts +3 -0
- package/dist/output/print-error.d.ts.map +1 -0
- package/dist/output/print-error.js +14 -0
- package/dist/output/watch-loop.d.ts +37 -0
- package/dist/output/watch-loop.d.ts.map +1 -0
- package/dist/output/watch-loop.js +115 -0
- package/dist/schemas/json-schemas.d.ts +1630 -0
- package/dist/schemas/json-schemas.d.ts.map +1 -0
- package/dist/schemas/json-schemas.js +811 -0
- package/dist/surface/about.d.ts +10 -0
- package/dist/surface/about.d.ts.map +1 -0
- package/dist/surface/about.js +53 -0
- package/dist/surface/load-surface-context.d.ts +34 -0
- package/dist/surface/load-surface-context.d.ts.map +1 -0
- package/dist/surface/load-surface-context.js +100 -0
- package/dist/surface/no-args-landing.d.ts +7 -0
- package/dist/surface/no-args-landing.d.ts.map +1 -0
- package/dist/surface/no-args-landing.js +36 -0
- package/dist/surface/not-enabled-error.d.ts +24 -0
- package/dist/surface/not-enabled-error.d.ts.map +1 -0
- package/dist/surface/not-enabled-error.js +36 -0
- package/dist/surface/profiles.d.ts +37 -0
- package/dist/surface/profiles.d.ts.map +1 -0
- package/dist/surface/profiles.js +151 -0
- package/dist/surface/shape-defaults.d.ts +21 -0
- package/dist/surface/shape-defaults.d.ts.map +1 -0
- package/dist/surface/shape-defaults.js +50 -0
- package/dist/surface/spine-extractor.d.ts +38 -0
- package/dist/surface/spine-extractor.d.ts.map +1 -0
- package/dist/surface/spine-extractor.js +100 -0
- package/dist/surface/surface-config-writer.d.ts +59 -0
- package/dist/surface/surface-config-writer.d.ts.map +1 -0
- package/dist/surface/surface-config-writer.js +135 -0
- package/dist/surface/surface-summary.d.ts +66 -0
- package/dist/surface/surface-summary.d.ts.map +1 -0
- package/dist/surface/surface-summary.js +162 -0
- package/dist/surface/tier.d.ts +100 -0
- package/dist/surface/tier.d.ts.map +1 -0
- package/dist/surface/tier.js +172 -0
- package/dist/task-next/apply-batch-runner.d.ts +42 -0
- package/dist/task-next/apply-batch-runner.d.ts.map +1 -0
- package/dist/task-next/apply-batch-runner.js +192 -0
- package/dist/task-next/task-next-ranker.d.ts +75 -0
- package/dist/task-next/task-next-ranker.d.ts.map +1 -0
- package/dist/task-next/task-next-ranker.js +179 -0
- package/dist/usage/usage-log.d.ts +54 -0
- package/dist/usage/usage-log.d.ts.map +1 -0
- package/dist/usage/usage-log.js +105 -0
- package/dist/validation/run-validation-loop.d.ts +38 -0
- package/dist/validation/run-validation-loop.d.ts.map +1 -0
- package/dist/validation/run-validation-loop.js +100 -0
- package/package.json +73 -0
|
@@ -0,0 +1,532 @@
|
|
|
1
|
+
import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
|
|
2
|
+
import * as nodePath from 'node:path';
|
|
3
|
+
import { applyIngestPlan, buildContradictionReport, buildGeneratedCodeReport, buildIngestAdoptionPlan, buildIngestApplyPlan, buildRepositoryKnowledgeModel, buildStabilityMap, inspectSharkcraft, IngestAdoptionStatus, IngestDepth, IngestSection, loadIngestApplyPlan, renderContradictionReportHtml, renderContradictionReportJson, renderContradictionReportMarkdown, renderContradictionReportText, renderGeneratedCodeReportJson, renderGeneratedCodeReportMarkdown, renderGeneratedCodeReportText, renderIngestAdoptionPatch, renderIngestAdoptionPlanMarkdown, renderIngestApplyReviewMarkdown, renderRepositoryKnowledgeModelHtml, renderRepositoryKnowledgeModelJson, renderRepositoryKnowledgeModelMarkdown, renderRepositoryKnowledgeModelText, renderStabilityMapJson, renderStabilityMapMarkdown, renderStabilityMapText, saveIngestApplyPlan, signIngestApplyPlan, writeIngestAdoption, writeIngestDrafts, } from '@shrkcrft/inspector';
|
|
4
|
+
import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
|
|
5
|
+
import { asJson, header, kv } from "../output/format-output.js";
|
|
6
|
+
const INGEST_BASE = nodePath.join('sharkcraft', 'ingestion');
|
|
7
|
+
export const ingestCommand = {
|
|
8
|
+
name: 'ingest',
|
|
9
|
+
description: 'Deeply ingest a repository into a SharkCraft repository knowledge model. Dry-run by default; writes drafts under sharkcraft/ingestion/. `repository` (default sub-verb) builds the knowledge model; `status` / `report` / `diff` / `adopt` / `clean` / `refresh` manage the lifecycle.',
|
|
10
|
+
usage: 'shrk [--cwd <dir>] ingest [repository|refresh|status|report|adopt|diff|clean] [options]',
|
|
11
|
+
async run(args) {
|
|
12
|
+
const sub = args.positional[0] ?? 'repository';
|
|
13
|
+
const rest = { ...args, positional: args.positional.slice(1) };
|
|
14
|
+
switch (sub) {
|
|
15
|
+
case 'repository':
|
|
16
|
+
return runRepository(rest);
|
|
17
|
+
case 'refresh':
|
|
18
|
+
return runRefresh(rest);
|
|
19
|
+
case 'status':
|
|
20
|
+
return runStatus(rest);
|
|
21
|
+
case 'report':
|
|
22
|
+
return runReport(rest);
|
|
23
|
+
case 'adopt':
|
|
24
|
+
return runAdopt(rest);
|
|
25
|
+
case 'diff':
|
|
26
|
+
return runDiff(rest);
|
|
27
|
+
case 'clean':
|
|
28
|
+
return runClean(rest);
|
|
29
|
+
default:
|
|
30
|
+
return runRepository(args);
|
|
31
|
+
}
|
|
32
|
+
},
|
|
33
|
+
};
|
|
34
|
+
async function buildModel(args, cwd) {
|
|
35
|
+
const depthRaw = (flagString(args, 'depth') ?? 'standard').toLowerCase();
|
|
36
|
+
const depthMap = {
|
|
37
|
+
shallow: IngestDepth.Shallow,
|
|
38
|
+
standard: IngestDepth.Standard,
|
|
39
|
+
deep: IngestDepth.Deep,
|
|
40
|
+
extreme: IngestDepth.Extreme,
|
|
41
|
+
};
|
|
42
|
+
const depth = depthMap[depthRaw] ?? IngestDepth.Standard;
|
|
43
|
+
const include = flagList(args, 'include').map(parseSection).filter(Boolean);
|
|
44
|
+
const exclude = flagList(args, 'exclude').map(parseSection).filter(Boolean);
|
|
45
|
+
const forcedPresets = flagList(args, 'preset');
|
|
46
|
+
const task = flagString(args, 'task');
|
|
47
|
+
const docsFirst = flagBool(args, 'docs-first');
|
|
48
|
+
const inspection = await inspectSharkcraft({ cwd });
|
|
49
|
+
const model = await buildRepositoryKnowledgeModel({
|
|
50
|
+
inspection,
|
|
51
|
+
depth,
|
|
52
|
+
selectedSections: include.length > 0 ? include : undefined,
|
|
53
|
+
excludedSections: exclude.length > 0 ? exclude : undefined,
|
|
54
|
+
forcedPresetIds: forcedPresets,
|
|
55
|
+
...(task ? { task } : {}),
|
|
56
|
+
docsFirst: docsFirst || undefined,
|
|
57
|
+
});
|
|
58
|
+
return { inspection, model };
|
|
59
|
+
}
|
|
60
|
+
async function runRepository(args) {
|
|
61
|
+
const cwd = resolveCwd(args);
|
|
62
|
+
const writeDrafts = flagBool(args, 'write-drafts');
|
|
63
|
+
const adopt = flagBool(args, 'adopt');
|
|
64
|
+
const json = flagBool(args, 'json');
|
|
65
|
+
const format = parseFormat(flagString(args, 'format'));
|
|
66
|
+
const output = flagString(args, 'output');
|
|
67
|
+
const profile = flagString(args, 'profile');
|
|
68
|
+
const { model } = await buildModel(args, cwd);
|
|
69
|
+
let writtenDrafts;
|
|
70
|
+
if (writeDrafts) {
|
|
71
|
+
writtenDrafts = writeIngestDrafts(model, { projectRoot: cwd });
|
|
72
|
+
}
|
|
73
|
+
let adoption;
|
|
74
|
+
let writtenAdoption;
|
|
75
|
+
if (adopt) {
|
|
76
|
+
adoption = buildIngestAdoptionPlan({ model });
|
|
77
|
+
writtenAdoption = writeIngestAdoption({ plan: adoption });
|
|
78
|
+
}
|
|
79
|
+
const payload = {
|
|
80
|
+
mode: writeDrafts ? (adopt ? 'write-drafts+adopt' : 'write-drafts') : (adopt ? 'adopt-only' : 'dry-run'),
|
|
81
|
+
profile,
|
|
82
|
+
sections: model.selectedSections,
|
|
83
|
+
presets: model.presets.map((p) => ({
|
|
84
|
+
id: p.preset.id,
|
|
85
|
+
score: p.score,
|
|
86
|
+
confidence: p.confidence,
|
|
87
|
+
reasons: p.reasons,
|
|
88
|
+
})),
|
|
89
|
+
transformationalIntents: model.transformationalIntents,
|
|
90
|
+
confidence: model.confidence.overall,
|
|
91
|
+
contradictions: model.contradictions.findings.length,
|
|
92
|
+
riskAreas: model.riskAreas.length,
|
|
93
|
+
generatedRoots: model.generatedVsHandwritten.generatedRoots.length,
|
|
94
|
+
stabilityAreas: model.stableExperimentalDeprecated.areas.length,
|
|
95
|
+
written: writtenDrafts
|
|
96
|
+
? {
|
|
97
|
+
outDir: writtenDrafts.outDir,
|
|
98
|
+
files: writtenDrafts.files.map((f) => ({ path: f.path, bytes: f.bytes })),
|
|
99
|
+
}
|
|
100
|
+
: undefined,
|
|
101
|
+
adoption: adoption
|
|
102
|
+
? {
|
|
103
|
+
counts: adoption.counts,
|
|
104
|
+
reviewRequired: adoption.reviewRequired,
|
|
105
|
+
adoptionOutDir: writtenAdoption?.outDir,
|
|
106
|
+
}
|
|
107
|
+
: undefined,
|
|
108
|
+
};
|
|
109
|
+
if (json || format === 'json') {
|
|
110
|
+
const body = format === 'json'
|
|
111
|
+
? renderRepositoryKnowledgeModelJson(model)
|
|
112
|
+
: asJson(payload);
|
|
113
|
+
if (output)
|
|
114
|
+
writeOutput(cwd, output, body);
|
|
115
|
+
else
|
|
116
|
+
process.stdout.write(body + '\n');
|
|
117
|
+
return 0;
|
|
118
|
+
}
|
|
119
|
+
if (format === 'markdown') {
|
|
120
|
+
const body = renderRepositoryKnowledgeModelMarkdown(model);
|
|
121
|
+
if (output)
|
|
122
|
+
writeOutput(cwd, output, body);
|
|
123
|
+
else
|
|
124
|
+
process.stdout.write(body + '\n');
|
|
125
|
+
return 0;
|
|
126
|
+
}
|
|
127
|
+
if (format === 'html') {
|
|
128
|
+
const body = renderRepositoryKnowledgeModelHtml(model);
|
|
129
|
+
if (output)
|
|
130
|
+
writeOutput(cwd, output, body);
|
|
131
|
+
else
|
|
132
|
+
process.stdout.write(body + '\n');
|
|
133
|
+
return 0;
|
|
134
|
+
}
|
|
135
|
+
// Human-readable summary.
|
|
136
|
+
process.stdout.write(header('SharkCraft ingest'));
|
|
137
|
+
process.stdout.write(kv('mode', payload.mode) + '\n');
|
|
138
|
+
process.stdout.write(kv('depth', model.depth) + '\n');
|
|
139
|
+
process.stdout.write(kv('project', model.repositoryOverview.projectName) + '\n');
|
|
140
|
+
process.stdout.write(kv('confidence', `${model.confidence.overall}/100`) + '\n');
|
|
141
|
+
process.stdout.write(kv('contradictions', model.contradictions.findings.length) + '\n');
|
|
142
|
+
process.stdout.write(kv('risk areas', model.riskAreas.length) + '\n');
|
|
143
|
+
process.stdout.write(kv('generated roots', model.generatedVsHandwritten.generatedRoots.length) + '\n');
|
|
144
|
+
process.stdout.write(kv('stability areas', model.stableExperimentalDeprecated.areas.length) + '\n');
|
|
145
|
+
process.stdout.write('\n');
|
|
146
|
+
process.stdout.write(renderRepositoryKnowledgeModelText(model));
|
|
147
|
+
process.stdout.write('\n');
|
|
148
|
+
if (writtenDrafts) {
|
|
149
|
+
process.stdout.write(`\nWrote ${writtenDrafts.files.length} draft files under ${writtenDrafts.outDir}\n`);
|
|
150
|
+
}
|
|
151
|
+
if (writtenAdoption) {
|
|
152
|
+
process.stdout.write(`\nWrote adoption plan under ${writtenAdoption.outDir} (review required: ${adoption?.reviewRequired ? 'yes' : 'no'})\n`);
|
|
153
|
+
}
|
|
154
|
+
if (model.transformationalIntents.length > 0) {
|
|
155
|
+
process.stdout.write('\nTransformational intents:\n');
|
|
156
|
+
for (const t of model.transformationalIntents)
|
|
157
|
+
process.stdout.write(` - ${t}\n`);
|
|
158
|
+
}
|
|
159
|
+
process.stdout.write('\nNext steps:\n');
|
|
160
|
+
process.stdout.write(' • shrk ingest report --format markdown\n');
|
|
161
|
+
process.stdout.write(' • shrk ingest diff\n');
|
|
162
|
+
if (!writeDrafts)
|
|
163
|
+
process.stdout.write(' • Re-run with --write-drafts to materialise drafts under sharkcraft/ingestion/\n');
|
|
164
|
+
if (!adopt)
|
|
165
|
+
process.stdout.write(' • Re-run with --adopt to produce an adoption patch under sharkcraft/ingestion/adoption/\n');
|
|
166
|
+
return 0;
|
|
167
|
+
}
|
|
168
|
+
async function runRefresh(args) {
|
|
169
|
+
// Same as repository but always reads the cache fresh; alias for now.
|
|
170
|
+
return runRepository(args);
|
|
171
|
+
}
|
|
172
|
+
async function runStatus(args) {
|
|
173
|
+
const cwd = resolveCwd(args);
|
|
174
|
+
const json = flagBool(args, 'json');
|
|
175
|
+
const ingestDir = nodePath.join(cwd, INGEST_BASE);
|
|
176
|
+
const modelPath = nodePath.join(ingestDir, 'repository-knowledge-model.json');
|
|
177
|
+
const adoptionPath = nodePath.join(ingestDir, 'adoption', 'ingest-adoption-state.json');
|
|
178
|
+
const status = {
|
|
179
|
+
ingestDirExists: existsSync(ingestDir),
|
|
180
|
+
modelExists: existsSync(modelPath),
|
|
181
|
+
adoptionExists: existsSync(adoptionPath),
|
|
182
|
+
modelPath,
|
|
183
|
+
adoptionPath,
|
|
184
|
+
files: existsSync(ingestDir) ? listFilesRecursive(ingestDir).map((f) => nodePath.relative(cwd, f)) : [],
|
|
185
|
+
};
|
|
186
|
+
if (json) {
|
|
187
|
+
process.stdout.write(asJson(status) + '\n');
|
|
188
|
+
return 0;
|
|
189
|
+
}
|
|
190
|
+
process.stdout.write(header('SharkCraft ingest status'));
|
|
191
|
+
process.stdout.write(kv('ingest dir', status.ingestDirExists ? 'present' : 'missing') + '\n');
|
|
192
|
+
process.stdout.write(kv('model', status.modelExists ? 'present' : 'missing') + '\n');
|
|
193
|
+
process.stdout.write(kv('adoption', status.adoptionExists ? 'present' : 'missing') + '\n');
|
|
194
|
+
if (status.files.length > 0) {
|
|
195
|
+
process.stdout.write(`\nFiles (${status.files.length}):\n`);
|
|
196
|
+
for (const f of status.files.slice(0, 30))
|
|
197
|
+
process.stdout.write(` - ${f}\n`);
|
|
198
|
+
if (status.files.length > 30)
|
|
199
|
+
process.stdout.write(` ... ${status.files.length - 30} more\n`);
|
|
200
|
+
}
|
|
201
|
+
return 0;
|
|
202
|
+
}
|
|
203
|
+
async function runReport(args) {
|
|
204
|
+
const cwd = resolveCwd(args);
|
|
205
|
+
const format = parseFormat(flagString(args, 'format'));
|
|
206
|
+
const modelPath = nodePath.join(cwd, INGEST_BASE, 'repository-knowledge-model.json');
|
|
207
|
+
if (!existsSync(modelPath)) {
|
|
208
|
+
process.stderr.write(`No saved model — run \`shrk ingest repository --write-drafts\` first.\n`);
|
|
209
|
+
return 1;
|
|
210
|
+
}
|
|
211
|
+
const body = readFileSync(modelPath, 'utf8');
|
|
212
|
+
if (format === 'json') {
|
|
213
|
+
process.stdout.write(body);
|
|
214
|
+
return 0;
|
|
215
|
+
}
|
|
216
|
+
// Rebuild a renderable model from the JSON shape.
|
|
217
|
+
const model = JSON.parse(body);
|
|
218
|
+
if (format === 'markdown')
|
|
219
|
+
process.stdout.write(renderRepositoryKnowledgeModelMarkdown(model) + '\n');
|
|
220
|
+
else if (format === 'html')
|
|
221
|
+
process.stdout.write(renderRepositoryKnowledgeModelHtml(model) + '\n');
|
|
222
|
+
else
|
|
223
|
+
process.stdout.write(renderRepositoryKnowledgeModelText(model) + '\n');
|
|
224
|
+
return 0;
|
|
225
|
+
}
|
|
226
|
+
async function runAdopt(args) {
|
|
227
|
+
// `ingest adopt plan|review|apply` removed; use `onboard adopt`.
|
|
228
|
+
const sub = args.positional[0];
|
|
229
|
+
if (sub === 'plan' || sub === 'review' || sub === 'apply') {
|
|
230
|
+
process.stderr.write('`ingest adopt ' + sub + '` was removed. Use `shrk onboard adopt` (the canonical adoption surface).\n');
|
|
231
|
+
return 2;
|
|
232
|
+
}
|
|
233
|
+
const cwd = resolveCwd(args);
|
|
234
|
+
const json = flagBool(args, 'json');
|
|
235
|
+
const writePatch = flagBool(args, 'write-patch');
|
|
236
|
+
const { model } = await buildModel(args, cwd);
|
|
237
|
+
const plan = buildIngestAdoptionPlan({ model });
|
|
238
|
+
let written;
|
|
239
|
+
if (writePatch)
|
|
240
|
+
written = writeIngestAdoption({ plan });
|
|
241
|
+
if (json) {
|
|
242
|
+
process.stdout.write(asJson({
|
|
243
|
+
plan: {
|
|
244
|
+
counts: plan.counts,
|
|
245
|
+
reviewRequired: plan.reviewRequired,
|
|
246
|
+
},
|
|
247
|
+
written: written?.outDir,
|
|
248
|
+
}) + '\n');
|
|
249
|
+
return 0;
|
|
250
|
+
}
|
|
251
|
+
process.stdout.write(header('Ingest adopt'));
|
|
252
|
+
process.stdout.write(kv('review required', plan.reviewRequired ? 'yes' : 'no') + '\n');
|
|
253
|
+
process.stdout.write(`\n${renderIngestAdoptionPlanMarkdown(plan)}\n`);
|
|
254
|
+
if (written)
|
|
255
|
+
process.stdout.write(`\nWrote adoption files to ${written.outDir}\n`);
|
|
256
|
+
return 0;
|
|
257
|
+
}
|
|
258
|
+
async function runAdoptPlan(args) {
|
|
259
|
+
const cwd = resolveCwd(args);
|
|
260
|
+
const includeFlag = flagList(args, 'include');
|
|
261
|
+
const outputFlag = flagString(args, 'output');
|
|
262
|
+
const includeManualReview = flagBool(args, 'include-manual-review');
|
|
263
|
+
const includeBody = flagBool(args, 'include-body');
|
|
264
|
+
const { model } = await buildModel(args, cwd);
|
|
265
|
+
const adoption = buildIngestAdoptionPlan({ model });
|
|
266
|
+
const include = includeFlag.length > 0
|
|
267
|
+
? includeFlag.map((s) => s)
|
|
268
|
+
: [IngestAdoptionStatus.SafeAppend];
|
|
269
|
+
const built = buildIngestApplyPlan({
|
|
270
|
+
plan: adoption,
|
|
271
|
+
include,
|
|
272
|
+
includeManualReview,
|
|
273
|
+
...(includeBody ? { includeBody: true } : {}),
|
|
274
|
+
note: 'Generated by `shrk ingest adopt plan`.',
|
|
275
|
+
});
|
|
276
|
+
const secret = process.env.SHARKCRAFT_PLAN_SECRET;
|
|
277
|
+
const finalPlan = secret ? signIngestApplyPlan(built.plan, secret) : built.plan;
|
|
278
|
+
const outFile = outputFlag
|
|
279
|
+
? (nodePath.isAbsolute(outputFlag) ? outputFlag : nodePath.join(cwd, outputFlag))
|
|
280
|
+
: nodePath.join(cwd, INGEST_BASE, 'adoption', 'ingest-adopt-plan.json');
|
|
281
|
+
saveIngestApplyPlan(finalPlan, outFile);
|
|
282
|
+
process.stdout.write(`Wrote ${outFile}\n`);
|
|
283
|
+
process.stdout.write(` changes: ${finalPlan.expectedChanges.length}\n`);
|
|
284
|
+
process.stdout.write(` signed: ${finalPlan.signature ? 'yes' : 'no — set SHARKCRAFT_PLAN_SECRET to sign'}\n`);
|
|
285
|
+
process.stdout.write(` skipped: ${built.skipped.length}\n`);
|
|
286
|
+
if (built.bodyStatuses && built.bodyStatuses.length > 0) {
|
|
287
|
+
const m = built.bodyStatuses.filter((b) => b.status === 'materialised').length;
|
|
288
|
+
const s = built.bodyStatuses.filter((b) => b.status === 'stubbed').length;
|
|
289
|
+
const sk = built.bodyStatuses.filter((b) => b.status === 'skipped').length;
|
|
290
|
+
const c = built.bodyStatuses.filter((b) => b.status === 'conflict').length;
|
|
291
|
+
process.stdout.write(` bodies: ${m} materialised, ${s} stubbed, ${sk} skipped, ${c} conflict\n`);
|
|
292
|
+
}
|
|
293
|
+
process.stdout.write(`\nNext: shrk ingest adopt review ${outFile}\n`);
|
|
294
|
+
return 0;
|
|
295
|
+
}
|
|
296
|
+
async function runAdoptReview(args) {
|
|
297
|
+
const cwd = resolveCwd(args);
|
|
298
|
+
const planFile = args.positional[0] ?? nodePath.join(cwd, INGEST_BASE, 'adoption', 'ingest-adopt-plan.json');
|
|
299
|
+
const plan = loadIngestApplyPlan(nodePath.isAbsolute(planFile) ? planFile : nodePath.join(cwd, planFile));
|
|
300
|
+
if (!plan) {
|
|
301
|
+
process.stderr.write(`Plan not found or invalid: ${planFile}\n`);
|
|
302
|
+
return 1;
|
|
303
|
+
}
|
|
304
|
+
process.stdout.write(renderIngestApplyReviewMarkdown(plan) + '\n');
|
|
305
|
+
return 0;
|
|
306
|
+
}
|
|
307
|
+
async function runAdoptApply(args) {
|
|
308
|
+
const cwd = resolveCwd(args);
|
|
309
|
+
const verifySignature = flagBool(args, 'verify-signature');
|
|
310
|
+
const planFile = args.positional[0] ?? nodePath.join(cwd, INGEST_BASE, 'adoption', 'ingest-adopt-plan.json');
|
|
311
|
+
const planAbs = nodePath.isAbsolute(planFile) ? planFile : nodePath.join(cwd, planFile);
|
|
312
|
+
const plan = loadIngestApplyPlan(planAbs);
|
|
313
|
+
if (!plan) {
|
|
314
|
+
process.stderr.write(`Plan not found or invalid: ${planFile}\n`);
|
|
315
|
+
return 1;
|
|
316
|
+
}
|
|
317
|
+
const secret = process.env.SHARKCRAFT_PLAN_SECRET;
|
|
318
|
+
if (verifySignature && !secret) {
|
|
319
|
+
process.stderr.write('--verify-signature requested but SHARKCRAFT_PLAN_SECRET is not set.\n');
|
|
320
|
+
return 1;
|
|
321
|
+
}
|
|
322
|
+
// Rebuild the bodies from the adoption state — keeps `apply` deterministic.
|
|
323
|
+
const { model } = await buildModel(args, cwd);
|
|
324
|
+
const adoption = buildIngestAdoptionPlan({ model });
|
|
325
|
+
const include = plan.expectedChanges.length > 0 ? [IngestAdoptionStatus.SafeAppend] : [IngestAdoptionStatus.SafeAppend];
|
|
326
|
+
const built = buildIngestApplyPlan({ plan: adoption, include });
|
|
327
|
+
const result = applyIngestPlan({
|
|
328
|
+
plan,
|
|
329
|
+
files: built.files,
|
|
330
|
+
requireSignature: verifySignature,
|
|
331
|
+
...(secret ? { secret } : {}),
|
|
332
|
+
});
|
|
333
|
+
process.stdout.write(`Applied ${result.applied.length} change(s).\n`);
|
|
334
|
+
for (const a of result.applied)
|
|
335
|
+
process.stdout.write(` - wrote ${a.path} (+${a.bytesWritten}B)\n`);
|
|
336
|
+
if (result.skipped.length > 0) {
|
|
337
|
+
process.stdout.write(`\nSkipped:\n`);
|
|
338
|
+
for (const s of result.skipped)
|
|
339
|
+
process.stdout.write(` - ${s.path}: ${s.reason}\n`);
|
|
340
|
+
}
|
|
341
|
+
return 0;
|
|
342
|
+
}
|
|
343
|
+
async function runDiff(args) {
|
|
344
|
+
const cwd = resolveCwd(args);
|
|
345
|
+
const format = parseFormat(flagString(args, 'format'));
|
|
346
|
+
const json = flagBool(args, 'json');
|
|
347
|
+
const { model } = await buildModel(args, cwd);
|
|
348
|
+
const plan = buildIngestAdoptionPlan({ model });
|
|
349
|
+
if (json) {
|
|
350
|
+
process.stdout.write(asJson({ counts: plan.counts, entries: plan.entries }) + '\n');
|
|
351
|
+
return 0;
|
|
352
|
+
}
|
|
353
|
+
const body = format === 'markdown' ? renderIngestAdoptionPlanMarkdown(plan) : renderIngestAdoptionPatch(plan);
|
|
354
|
+
process.stdout.write(body + '\n');
|
|
355
|
+
return 0;
|
|
356
|
+
}
|
|
357
|
+
async function runClean(args) {
|
|
358
|
+
const cwd = resolveCwd(args);
|
|
359
|
+
const write = flagBool(args, 'write');
|
|
360
|
+
const dryRun = flagBool(args, 'dry-run') || !write;
|
|
361
|
+
const ingestDir = nodePath.join(cwd, INGEST_BASE);
|
|
362
|
+
if (!existsSync(ingestDir)) {
|
|
363
|
+
process.stdout.write('Nothing to clean — sharkcraft/ingestion/ does not exist.\n');
|
|
364
|
+
return 0;
|
|
365
|
+
}
|
|
366
|
+
const files = listFilesRecursive(ingestDir);
|
|
367
|
+
if (dryRun) {
|
|
368
|
+
process.stdout.write(`Would remove ${files.length} files from ${ingestDir}\n`);
|
|
369
|
+
for (const f of files.slice(0, 30))
|
|
370
|
+
process.stdout.write(` - ${nodePath.relative(cwd, f)}\n`);
|
|
371
|
+
if (files.length > 30)
|
|
372
|
+
process.stdout.write(` ... ${files.length - 30} more\n`);
|
|
373
|
+
process.stdout.write('\nRe-run with --write to actually delete.\n');
|
|
374
|
+
return 0;
|
|
375
|
+
}
|
|
376
|
+
rmSync(ingestDir, { recursive: true, force: true });
|
|
377
|
+
process.stdout.write(`Removed ${ingestDir}\n`);
|
|
378
|
+
return 0;
|
|
379
|
+
}
|
|
380
|
+
function parseFormat(raw) {
|
|
381
|
+
switch ((raw ?? 'text').toLowerCase()) {
|
|
382
|
+
case 'markdown':
|
|
383
|
+
case 'md':
|
|
384
|
+
return 'markdown';
|
|
385
|
+
case 'html':
|
|
386
|
+
return 'html';
|
|
387
|
+
case 'json':
|
|
388
|
+
return 'json';
|
|
389
|
+
default:
|
|
390
|
+
return 'text';
|
|
391
|
+
}
|
|
392
|
+
}
|
|
393
|
+
function parseSection(raw) {
|
|
394
|
+
for (const s of Object.values(IngestSection)) {
|
|
395
|
+
if (s === raw)
|
|
396
|
+
return s;
|
|
397
|
+
}
|
|
398
|
+
return undefined;
|
|
399
|
+
}
|
|
400
|
+
function writeOutput(cwd, relOrAbs, body) {
|
|
401
|
+
const full = nodePath.isAbsolute(relOrAbs) ? relOrAbs : nodePath.join(cwd, relOrAbs);
|
|
402
|
+
const dir = nodePath.dirname(full);
|
|
403
|
+
if (!existsSync(dir))
|
|
404
|
+
mkdirSync(dir, { recursive: true });
|
|
405
|
+
writeFileSync(full, body, 'utf8');
|
|
406
|
+
process.stderr.write(`wrote ${full}\n`);
|
|
407
|
+
}
|
|
408
|
+
function listFilesRecursive(dir) {
|
|
409
|
+
const out = [];
|
|
410
|
+
const visit = (d) => {
|
|
411
|
+
let entries;
|
|
412
|
+
try {
|
|
413
|
+
entries = readdirSync(d);
|
|
414
|
+
}
|
|
415
|
+
catch {
|
|
416
|
+
return;
|
|
417
|
+
}
|
|
418
|
+
for (const e of entries) {
|
|
419
|
+
const full = nodePath.join(d, e);
|
|
420
|
+
let st;
|
|
421
|
+
try {
|
|
422
|
+
st = statSync(full);
|
|
423
|
+
}
|
|
424
|
+
catch {
|
|
425
|
+
continue;
|
|
426
|
+
}
|
|
427
|
+
if (st.isDirectory())
|
|
428
|
+
visit(full);
|
|
429
|
+
else
|
|
430
|
+
out.push(full);
|
|
431
|
+
}
|
|
432
|
+
};
|
|
433
|
+
visit(dir);
|
|
434
|
+
return out;
|
|
435
|
+
}
|
|
436
|
+
// Companion top-level commands that share the same backbone.
|
|
437
|
+
export const contradictionsCommand = {
|
|
438
|
+
name: 'contradictions',
|
|
439
|
+
description: 'Detect contradictions between docs/configs and the actual repo (missing paths, deprecated CLI usage, missing commands). Read-only.',
|
|
440
|
+
usage: 'shrk [--cwd <dir>] contradictions [--format text|markdown|html|json]',
|
|
441
|
+
async run(args) {
|
|
442
|
+
const cwd = resolveCwd(args);
|
|
443
|
+
const format = parseFormat(flagString(args, 'format'));
|
|
444
|
+
const inspection = await inspectSharkcraft({ cwd });
|
|
445
|
+
const report = buildContradictionReport({ inspection });
|
|
446
|
+
if (format === 'json')
|
|
447
|
+
process.stdout.write(renderContradictionReportJson(report) + '\n');
|
|
448
|
+
else if (format === 'markdown')
|
|
449
|
+
process.stdout.write(renderContradictionReportMarkdown(report) + '\n');
|
|
450
|
+
else if (format === 'html')
|
|
451
|
+
process.stdout.write(renderContradictionReportHtml(report) + '\n');
|
|
452
|
+
else
|
|
453
|
+
process.stdout.write(renderContradictionReportText(report) + '\n');
|
|
454
|
+
return 0;
|
|
455
|
+
},
|
|
456
|
+
};
|
|
457
|
+
export const generatedCommand = {
|
|
458
|
+
name: 'generated',
|
|
459
|
+
description: 'Generated-code classifier. Subcommands: `report` (default), `protect --write-drafts`. Read-only by default.',
|
|
460
|
+
usage: 'shrk [--cwd <dir>] generated [report|protect] [--format text|markdown|json] [--write-drafts]',
|
|
461
|
+
async run(args) {
|
|
462
|
+
const sub = args.positional[0] === 'protect' ? 'protect' : 'report';
|
|
463
|
+
const rest = { ...args, positional: args.positional.slice(args.positional[0] === 'report' || args.positional[0] === 'protect' ? 1 : 0) };
|
|
464
|
+
const cwd = resolveCwd(rest);
|
|
465
|
+
const format = parseFormat(flagString(rest, 'format'));
|
|
466
|
+
const inspection = await inspectSharkcraft({ cwd });
|
|
467
|
+
const report = buildGeneratedCodeReport({ inspection });
|
|
468
|
+
if (sub === 'protect') {
|
|
469
|
+
const writeDrafts = flagBool(rest, 'write-drafts');
|
|
470
|
+
const outDir = nodePath.join(cwd, INGEST_BASE);
|
|
471
|
+
if (writeDrafts) {
|
|
472
|
+
if (!existsSync(outDir))
|
|
473
|
+
mkdirSync(outDir, { recursive: true });
|
|
474
|
+
const target = nodePath.join(outDir, 'GENERATED_PROTECT.md');
|
|
475
|
+
writeFileSync(target, renderGeneratedCodeReportMarkdown(report), 'utf8');
|
|
476
|
+
process.stdout.write(`Wrote ${target}\n`);
|
|
477
|
+
return 0;
|
|
478
|
+
}
|
|
479
|
+
process.stdout.write(renderGeneratedCodeReportMarkdown(report) + '\n');
|
|
480
|
+
process.stdout.write('\nRe-run with --write-drafts to save the recommended protect rules under sharkcraft/ingestion/.\n');
|
|
481
|
+
return 0;
|
|
482
|
+
}
|
|
483
|
+
if (format === 'json')
|
|
484
|
+
process.stdout.write(renderGeneratedCodeReportJson(report) + '\n');
|
|
485
|
+
else if (format === 'markdown')
|
|
486
|
+
process.stdout.write(renderGeneratedCodeReportMarkdown(report) + '\n');
|
|
487
|
+
else
|
|
488
|
+
process.stdout.write(renderGeneratedCodeReportText(report) + '\n');
|
|
489
|
+
return 0;
|
|
490
|
+
},
|
|
491
|
+
};
|
|
492
|
+
export const stabilityCommand = {
|
|
493
|
+
name: 'stability',
|
|
494
|
+
description: 'Stability classification (stable/experimental/deprecated/legacy/generated/internal/public-api/high-risk). Read-only.',
|
|
495
|
+
usage: 'shrk [--cwd <dir>] stability [map|area <id>] [--format text|markdown|json]',
|
|
496
|
+
async run(args) {
|
|
497
|
+
const sub = args.positional[0];
|
|
498
|
+
const cwd = resolveCwd(args);
|
|
499
|
+
const format = parseFormat(flagString(args, 'format'));
|
|
500
|
+
const inspection = await inspectSharkcraft({ cwd });
|
|
501
|
+
const generated = buildGeneratedCodeReport({ inspection });
|
|
502
|
+
const map = buildStabilityMap({
|
|
503
|
+
inspection,
|
|
504
|
+
generatedRoots: generated.generatedRoots.map((r) => r.path),
|
|
505
|
+
});
|
|
506
|
+
if (sub === 'area') {
|
|
507
|
+
const id = args.positional[1];
|
|
508
|
+
if (!id) {
|
|
509
|
+
process.stderr.write('Usage: shrk stability area <id>\n');
|
|
510
|
+
return 1;
|
|
511
|
+
}
|
|
512
|
+
const area = map.areas.find((a) => a.id === id || a.path === id);
|
|
513
|
+
if (!area) {
|
|
514
|
+
process.stderr.write(`No stability area found for "${id}".\n`);
|
|
515
|
+
return 1;
|
|
516
|
+
}
|
|
517
|
+
if (format === 'json')
|
|
518
|
+
process.stdout.write(asJson(area) + '\n');
|
|
519
|
+
else
|
|
520
|
+
process.stdout.write(`${area.kind} (${area.confidence})\n path: ${area.path}\n signals: ${area.signals.join(', ')}\n` + (area.note ? ` note: ${area.note}\n` : ''));
|
|
521
|
+
return 0;
|
|
522
|
+
}
|
|
523
|
+
if (format === 'json')
|
|
524
|
+
process.stdout.write(renderStabilityMapJson(map) + '\n');
|
|
525
|
+
else if (format === 'markdown')
|
|
526
|
+
process.stdout.write(renderStabilityMapMarkdown(map) + '\n');
|
|
527
|
+
else
|
|
528
|
+
process.stdout.write(renderStabilityMapText(map) + '\n');
|
|
529
|
+
return 0;
|
|
530
|
+
},
|
|
531
|
+
};
|
|
532
|
+
void parseFormat;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"init.command.d.ts","sourceRoot":"","sources":["../../src/commands/init.command.ts"],"names":[],"mappings":"AAeA,OAAO,EAAwB,KAAK,eAAe,EAA+B,MAAM,wBAAwB,CAAC;AAuQjH,eAAO,MAAM,WAAW,EAAE,eA2FzB,CAAC"}
|