@open-agent-toolkit/cli 0.0.10
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/README.md +50 -0
- package/assets/agents/oat-codebase-mapper.md +275 -0
- package/assets/agents/oat-reviewer.md +350 -0
- package/assets/agents/skeptical-evaluator.md +126 -0
- package/assets/docs/contributing/code.md +95 -0
- package/assets/docs/contributing/commit-conventions.md +41 -0
- package/assets/docs/contributing/design-principles.md +124 -0
- package/assets/docs/contributing/documentation.md +69 -0
- package/assets/docs/contributing/hooks-and-safety.md +31 -0
- package/assets/docs/contributing/index.md +18 -0
- package/assets/docs/contributing/markdown-features.md +117 -0
- package/assets/docs/contributing/skills.md +68 -0
- package/assets/docs/guide/cli-reference.md +211 -0
- package/assets/docs/guide/concepts.md +88 -0
- package/assets/docs/guide/configuration.md +130 -0
- package/assets/docs/guide/documentation/commands.md +157 -0
- package/assets/docs/guide/documentation/index.md +27 -0
- package/assets/docs/guide/documentation/quickstart.md +164 -0
- package/assets/docs/guide/documentation/workflows.md +67 -0
- package/assets/docs/guide/getting-started.md +63 -0
- package/assets/docs/guide/ideas/index.md +34 -0
- package/assets/docs/guide/ideas/lifecycle.md +106 -0
- package/assets/docs/guide/index.md +20 -0
- package/assets/docs/guide/provider-sync/commands.md +100 -0
- package/assets/docs/guide/provider-sync/config.md +77 -0
- package/assets/docs/guide/provider-sync/index.md +65 -0
- package/assets/docs/guide/provider-sync/manifest-and-drift.md +55 -0
- package/assets/docs/guide/provider-sync/providers.md +67 -0
- package/assets/docs/guide/provider-sync/scope-and-surface.md +64 -0
- package/assets/docs/guide/skills/index.md +115 -0
- package/assets/docs/guide/tool-packs.md +167 -0
- package/assets/docs/guide/workflow/artifacts.md +44 -0
- package/assets/docs/guide/workflow/hill-checkpoints.md +53 -0
- package/assets/docs/guide/workflow/index.md +34 -0
- package/assets/docs/guide/workflow/lifecycle.md +207 -0
- package/assets/docs/guide/workflow/pr-flow.md +55 -0
- package/assets/docs/guide/workflow/repo-analysis.md +96 -0
- package/assets/docs/guide/workflow/reviews.md +98 -0
- package/assets/docs/guide/workflow/state-machine.md +74 -0
- package/assets/docs/index.md +45 -0
- package/assets/docs/quickstart.md +162 -0
- package/assets/docs/reference/docs-index-contract.md +53 -0
- package/assets/docs/reference/file-locations.md +109 -0
- package/assets/docs/reference/index.md +29 -0
- package/assets/docs/reference/oat-directory-structure.md +236 -0
- package/assets/docs/reference/troubleshooting.md +63 -0
- package/assets/public-package-versions.json +6 -0
- package/assets/scripts/resolve-tracking.sh +233 -0
- package/assets/skills/analyze/SKILL.md +358 -0
- package/assets/skills/compare/SKILL.md +276 -0
- package/assets/skills/create-agnostic-skill/SKILL.md +410 -0
- package/assets/skills/create-agnostic-skill/references/skill-template.md +195 -0
- package/assets/skills/deep-research/SKILL.md +350 -0
- package/assets/skills/deep-research/references/schema-analysis.md +93 -0
- package/assets/skills/deep-research/references/schema-architectural.md +75 -0
- package/assets/skills/deep-research/references/schema-base.md +70 -0
- package/assets/skills/deep-research/references/schema-comparative.md +72 -0
- package/assets/skills/deep-research/references/schema-conceptual.md +68 -0
- package/assets/skills/deep-research/references/schema-technical.md +64 -0
- package/assets/skills/oat-agent-instructions-analyze/SKILL.md +500 -0
- package/assets/skills/oat-agent-instructions-analyze/references/analysis-artifact-template.md +248 -0
- package/assets/skills/oat-agent-instructions-analyze/references/bundle-summary-template.md +31 -0
- package/assets/skills/oat-agent-instructions-analyze/references/directory-assessment-criteria.md +93 -0
- package/assets/skills/oat-agent-instructions-analyze/references/docs/agent-instruction.md +575 -0
- package/assets/skills/oat-agent-instructions-analyze/references/docs/cursor-rules-files.md +510 -0
- package/assets/skills/oat-agent-instructions-analyze/references/docs/provider-reference.md +429 -0
- package/assets/skills/oat-agent-instructions-analyze/references/docs/rules-files.md +594 -0
- package/assets/skills/oat-agent-instructions-analyze/references/file-type-discovery-checklist.md +273 -0
- package/assets/skills/oat-agent-instructions-analyze/references/quality-checklist.md +125 -0
- package/assets/skills/oat-agent-instructions-analyze/references/recommendation-pack-template.md +45 -0
- package/assets/skills/oat-agent-instructions-analyze/references/recommendations-manifest-template.yaml +27 -0
- package/assets/skills/oat-agent-instructions-analyze/scripts/resolve-instruction-files.sh +120 -0
- package/assets/skills/oat-agent-instructions-analyze/scripts/resolve-providers.sh +135 -0
- package/assets/skills/oat-agent-instructions-apply/SKILL.md +507 -0
- package/assets/skills/oat-agent-instructions-apply/references/apply-plan-template.md +80 -0
- package/assets/skills/oat-agent-instructions-apply/references/docs/agent-instruction.md +575 -0
- package/assets/skills/oat-agent-instructions-apply/references/docs/cursor-rules-files.md +510 -0
- package/assets/skills/oat-agent-instructions-apply/references/docs/provider-reference.md +429 -0
- package/assets/skills/oat-agent-instructions-apply/references/docs/rules-files.md +594 -0
- package/assets/skills/oat-agent-instructions-apply/references/instruction-file-templates/agents-md-root.md +85 -0
- package/assets/skills/oat-agent-instructions-apply/references/instruction-file-templates/agents-md-scoped.md +62 -0
- package/assets/skills/oat-agent-instructions-apply/references/instruction-file-templates/frontmatter/claude-rule.md +67 -0
- package/assets/skills/oat-agent-instructions-apply/references/instruction-file-templates/frontmatter/copilot-instruction.md +70 -0
- package/assets/skills/oat-agent-instructions-apply/references/instruction-file-templates/frontmatter/copilot-shim.md +35 -0
- package/assets/skills/oat-agent-instructions-apply/references/instruction-file-templates/frontmatter/cursor-rule.md +84 -0
- package/assets/skills/oat-agent-instructions-apply/references/instruction-file-templates/glob-scoped-rule.md +59 -0
- package/assets/skills/oat-docs/SKILL.md +214 -0
- package/assets/skills/oat-docs-analyze/SKILL.md +355 -0
- package/assets/skills/oat-docs-analyze/references/analysis-artifact-template.md +192 -0
- package/assets/skills/oat-docs-analyze/references/directory-assessment-criteria.md +46 -0
- package/assets/skills/oat-docs-analyze/references/quality-checklist.md +48 -0
- package/assets/skills/oat-docs-apply/SKILL.md +339 -0
- package/assets/skills/oat-docs-apply/references/apply-plan-template.md +69 -0
- package/assets/skills/oat-doctor/SKILL.md +293 -0
- package/assets/skills/oat-idea-ideate/SKILL.md +187 -0
- package/assets/skills/oat-idea-new/SKILL.md +152 -0
- package/assets/skills/oat-idea-scratchpad/SKILL.md +115 -0
- package/assets/skills/oat-idea-summarize/SKILL.md +172 -0
- package/assets/skills/oat-pjm-add-backlog-item/SKILL.md +155 -0
- package/assets/skills/oat-pjm-review-backlog/SKILL.md +171 -0
- package/assets/skills/oat-pjm-review-backlog/references/backlog-review-template.md +172 -0
- package/assets/skills/oat-pjm-update-repo-reference/SKILL.md +128 -0
- package/assets/skills/oat-project-capture/SKILL.md +306 -0
- package/assets/skills/oat-project-clear-active/SKILL.md +50 -0
- package/assets/skills/oat-project-complete/SKILL.md +461 -0
- package/assets/skills/oat-project-design/SKILL.md +461 -0
- package/assets/skills/oat-project-discover/SKILL.md +395 -0
- package/assets/skills/oat-project-document/SKILL.md +468 -0
- package/assets/skills/oat-project-implement/SKILL.md +736 -0
- package/assets/skills/oat-project-import-plan/SKILL.md +228 -0
- package/assets/skills/oat-project-import-plan/scripts/find-recent-provider-plans.sh +149 -0
- package/assets/skills/oat-project-new/SKILL.md +74 -0
- package/assets/skills/oat-project-next/SKILL.md +345 -0
- package/assets/skills/oat-project-open/SKILL.md +47 -0
- package/assets/skills/oat-project-plan/SKILL.md +415 -0
- package/assets/skills/oat-project-plan-writing/SKILL.md +116 -0
- package/assets/skills/oat-project-pr-final/SKILL.md +391 -0
- package/assets/skills/oat-project-pr-progress/SKILL.md +354 -0
- package/assets/skills/oat-project-progress/SKILL.md +342 -0
- package/assets/skills/oat-project-promote-spec-driven/SKILL.md +155 -0
- package/assets/skills/oat-project-quick-start/SKILL.md +363 -0
- package/assets/skills/oat-project-reconcile/SKILL.md +738 -0
- package/assets/skills/oat-project-review-provide/SKILL.md +728 -0
- package/assets/skills/oat-project-review-receive/SKILL.md +641 -0
- package/assets/skills/oat-project-review-receive-remote/SKILL.md +235 -0
- package/assets/skills/oat-project-revise/SKILL.md +316 -0
- package/assets/skills/oat-project-spec/SKILL.md +471 -0
- package/assets/skills/oat-project-subagent-implement/SKILL.md +549 -0
- package/assets/skills/oat-project-subagent-implement/examples/pattern-hill-checkpoint.md +110 -0
- package/assets/skills/oat-project-subagent-implement/examples/pattern-parallel-phases.md +118 -0
- package/assets/skills/oat-project-subagent-implement/scripts/dispatch.sh +133 -0
- package/assets/skills/oat-project-subagent-implement/scripts/reconcile.sh +182 -0
- package/assets/skills/oat-project-subagent-implement/scripts/review-gate.sh +187 -0
- package/assets/skills/oat-project-subagent-implement/tests/fixtures/sample-plan.md +234 -0
- package/assets/skills/oat-project-subagent-implement/tests/test-dry-run.sh +126 -0
- package/assets/skills/oat-project-subagent-implement/tests/test-hill-checkpoint.sh +127 -0
- package/assets/skills/oat-project-subagent-implement/tests/test-reconcile.sh +254 -0
- package/assets/skills/oat-project-subagent-implement/tests/test-review-gate.sh +220 -0
- package/assets/skills/oat-project-summary/SKILL.md +227 -0
- package/assets/skills/oat-repo-knowledge-index/SKILL.md +724 -0
- package/assets/skills/oat-repo-knowledge-index/references/templates/architecture.md +83 -0
- package/assets/skills/oat-repo-knowledge-index/references/templates/concerns.md +97 -0
- package/assets/skills/oat-repo-knowledge-index/references/templates/conventions.md +100 -0
- package/assets/skills/oat-repo-knowledge-index/references/templates/integrations.md +91 -0
- package/assets/skills/oat-repo-knowledge-index/references/templates/stack.md +86 -0
- package/assets/skills/oat-repo-knowledge-index/references/templates/structure.md +88 -0
- package/assets/skills/oat-repo-knowledge-index/references/templates/testing.md +137 -0
- package/assets/skills/oat-repo-maintainability-review/SKILL.md +198 -0
- package/assets/skills/oat-repo-maintainability-review/references/dx-checklist.md +33 -0
- package/assets/skills/oat-repo-maintainability-review/references/repo-review-artifact-template.md +72 -0
- package/assets/skills/oat-repo-maintainability-review/references/repo-review-rubric.md +66 -0
- package/assets/skills/oat-repo-maintainability-review/scripts/resolve-analysis-output.sh +162 -0
- package/assets/skills/oat-review-provide/SKILL.md +231 -0
- package/assets/skills/oat-review-provide/references/review-artifact-template.md +55 -0
- package/assets/skills/oat-review-provide/scripts/resolve-review-output.sh +124 -0
- package/assets/skills/oat-review-receive/SKILL.md +238 -0
- package/assets/skills/oat-review-receive-remote/SKILL.md +250 -0
- package/assets/skills/oat-worktree-bootstrap/SKILL.md +208 -0
- package/assets/skills/oat-worktree-bootstrap/references/worktree-conventions.md +58 -0
- package/assets/skills/oat-worktree-bootstrap-auto/SKILL.md +245 -0
- package/assets/skills/oat-worktree-bootstrap-auto/scripts/bootstrap.sh +194 -0
- package/assets/skills/skeptic/SKILL.md +261 -0
- package/assets/skills/synthesize/SKILL.md +361 -0
- package/assets/templates/backlog-item.md +24 -0
- package/assets/templates/design.md +315 -0
- package/assets/templates/discovery.md +135 -0
- package/assets/templates/docs-app-fuma/app/[[...slug]]/page.tsx +30 -0
- package/assets/templates/docs-app-fuma/app/api/search/route.ts +8 -0
- package/assets/templates/docs-app-fuma/app/globals.css +69 -0
- package/assets/templates/docs-app-fuma/app/layout.tsx +26 -0
- package/assets/templates/docs-app-fuma/docs/contributing.md +71 -0
- package/assets/templates/docs-app-fuma/docs/getting-started.md +40 -0
- package/assets/templates/docs-app-fuma/docs/index.md +13 -0
- package/assets/templates/docs-app-fuma/lib/source.ts +8 -0
- package/assets/templates/docs-app-fuma/next.config.js +6 -0
- package/assets/templates/docs-app-fuma/package.json.template +38 -0
- package/assets/templates/docs-app-fuma/postcss.config.mjs +7 -0
- package/assets/templates/docs-app-fuma/source.config.ts +14 -0
- package/assets/templates/docs-app-fuma/tsconfig.json +25 -0
- package/assets/templates/docs-app-mkdocs/docs/contributing.md +122 -0
- package/assets/templates/docs-app-mkdocs/docs/getting-started.md +28 -0
- package/assets/templates/docs-app-mkdocs/docs/index.md +8 -0
- package/assets/templates/docs-app-mkdocs/mkdocs.yml +47 -0
- package/assets/templates/docs-app-mkdocs/package.json.template +19 -0
- package/assets/templates/docs-app-mkdocs/requirements.txt +6 -0
- package/assets/templates/docs-app-mkdocs/setup-docs.sh +18 -0
- package/assets/templates/ideas/idea-discovery.md +39 -0
- package/assets/templates/ideas/idea-summary.md +42 -0
- package/assets/templates/ideas/ideas-backlog.md +21 -0
- package/assets/templates/ideas/ideas-scratchpad.md +10 -0
- package/assets/templates/implementation.md +207 -0
- package/assets/templates/plan.md +171 -0
- package/assets/templates/roadmap.md +24 -0
- package/assets/templates/spec.md +138 -0
- package/assets/templates/state.md +49 -0
- package/assets/templates/summary.md +82 -0
- package/dist/agents/canonical/index.d.ts +4 -0
- package/dist/agents/canonical/index.d.ts.map +1 -0
- package/dist/agents/canonical/index.js +2 -0
- package/dist/agents/canonical/parse.d.ts +4 -0
- package/dist/agents/canonical/parse.d.ts.map +1 -0
- package/dist/agents/canonical/parse.js +97 -0
- package/dist/agents/canonical/render.d.ts +3 -0
- package/dist/agents/canonical/render.d.ts.map +1 -0
- package/dist/agents/canonical/render.js +17 -0
- package/dist/agents/canonical/types.d.ts +22 -0
- package/dist/agents/canonical/types.d.ts.map +1 -0
- package/dist/agents/canonical/types.js +1 -0
- package/dist/app/command-context.d.ts +21 -0
- package/dist/app/command-context.d.ts.map +1 -0
- package/dist/app/command-context.js +18 -0
- package/dist/app/create-program.d.ts +3 -0
- package/dist/app/create-program.d.ts.map +1 -0
- package/dist/app/create-program.js +17 -0
- package/dist/commands/__tests__/helpers.d.ts +12 -0
- package/dist/commands/__tests__/helpers.d.ts.map +1 -0
- package/dist/commands/__tests__/helpers.js +36 -0
- package/dist/commands/backlog/index.d.ts +14 -0
- package/dist/commands/backlog/index.d.ts.map +1 -0
- package/dist/commands/backlog/index.js +80 -0
- package/dist/commands/backlog/init.d.ts +2 -0
- package/dist/commands/backlog/init.d.ts.map +1 -0
- package/dist/commands/backlog/init.js +66 -0
- package/dist/commands/backlog/regenerate-index.d.ts +2 -0
- package/dist/commands/backlog/regenerate-index.d.ts.map +1 -0
- package/dist/commands/backlog/regenerate-index.js +78 -0
- package/dist/commands/backlog/shared/generate-id.d.ts +4 -0
- package/dist/commands/backlog/shared/generate-id.d.ts.map +1 -0
- package/dist/commands/backlog/shared/generate-id.js +65 -0
- package/dist/commands/cleanup/artifacts/artifacts.d.ts +44 -0
- package/dist/commands/cleanup/artifacts/artifacts.d.ts.map +1 -0
- package/dist/commands/cleanup/artifacts/artifacts.js +381 -0
- package/dist/commands/cleanup/artifacts/artifacts.types.d.ts +13 -0
- package/dist/commands/cleanup/artifacts/artifacts.types.d.ts.map +1 -0
- package/dist/commands/cleanup/artifacts/artifacts.types.js +1 -0
- package/dist/commands/cleanup/artifacts/artifacts.utils.d.ts +14 -0
- package/dist/commands/cleanup/artifacts/artifacts.utils.d.ts.map +1 -0
- package/dist/commands/cleanup/artifacts/artifacts.utils.js +74 -0
- package/dist/commands/cleanup/cleanup.types.d.ts +26 -0
- package/dist/commands/cleanup/cleanup.types.d.ts.map +1 -0
- package/dist/commands/cleanup/cleanup.types.js +1 -0
- package/dist/commands/cleanup/cleanup.utils.d.ts +17 -0
- package/dist/commands/cleanup/cleanup.utils.d.ts.map +1 -0
- package/dist/commands/cleanup/cleanup.utils.js +44 -0
- package/dist/commands/cleanup/index.d.ts +3 -0
- package/dist/commands/cleanup/index.d.ts.map +1 -0
- package/dist/commands/cleanup/index.js +9 -0
- package/dist/commands/cleanup/project/project.d.ts +20 -0
- package/dist/commands/cleanup/project/project.d.ts.map +1 -0
- package/dist/commands/cleanup/project/project.js +263 -0
- package/dist/commands/cleanup/project/project.utils.d.ts +8 -0
- package/dist/commands/cleanup/project/project.utils.d.ts.map +1 -0
- package/dist/commands/cleanup/project/project.utils.js +48 -0
- package/dist/commands/config/index.d.ts +16 -0
- package/dist/commands/config/index.d.ts.map +1 -0
- package/dist/commands/config/index.js +700 -0
- package/dist/commands/docs/analyze.d.ts +8 -0
- package/dist/commands/docs/analyze.d.ts.map +1 -0
- package/dist/commands/docs/analyze.js +45 -0
- package/dist/commands/docs/apply.d.ts +8 -0
- package/dist/commands/docs/apply.d.ts.map +1 -0
- package/dist/commands/docs/apply.js +45 -0
- package/dist/commands/docs/index-generate/generator.d.ts +9 -0
- package/dist/commands/docs/index-generate/generator.d.ts.map +1 -0
- package/dist/commands/docs/index-generate/generator.js +114 -0
- package/dist/commands/docs/index-generate/index.d.ts +16 -0
- package/dist/commands/docs/index-generate/index.d.ts.map +1 -0
- package/dist/commands/docs/index-generate/index.js +72 -0
- package/dist/commands/docs/index.d.ts +3 -0
- package/dist/commands/docs/index.d.ts.map +1 -0
- package/dist/commands/docs/index.js +17 -0
- package/dist/commands/docs/init/index.d.ts +18 -0
- package/dist/commands/docs/init/index.d.ts.map +1 -0
- package/dist/commands/docs/init/index.js +129 -0
- package/dist/commands/docs/init/resolve-options.d.ts +41 -0
- package/dist/commands/docs/init/resolve-options.d.ts.map +1 -0
- package/dist/commands/docs/init/resolve-options.js +120 -0
- package/dist/commands/docs/init/scaffold.d.ts +18 -0
- package/dist/commands/docs/init/scaffold.d.ts.map +1 -0
- package/dist/commands/docs/init/scaffold.js +233 -0
- package/dist/commands/docs/migrate/codemod.d.ts +6 -0
- package/dist/commands/docs/migrate/codemod.d.ts.map +1 -0
- package/dist/commands/docs/migrate/codemod.js +62 -0
- package/dist/commands/docs/migrate/frontmatter.d.ts +12 -0
- package/dist/commands/docs/migrate/frontmatter.d.ts.map +1 -0
- package/dist/commands/docs/migrate/frontmatter.js +55 -0
- package/dist/commands/docs/migrate/index.d.ts +18 -0
- package/dist/commands/docs/migrate/index.d.ts.map +1 -0
- package/dist/commands/docs/migrate/index.js +138 -0
- package/dist/commands/docs/nav/contents.d.ts +14 -0
- package/dist/commands/docs/nav/contents.d.ts.map +1 -0
- package/dist/commands/docs/nav/contents.js +106 -0
- package/dist/commands/docs/nav/index.d.ts +3 -0
- package/dist/commands/docs/nav/index.d.ts.map +1 -0
- package/dist/commands/docs/nav/index.js +7 -0
- package/dist/commands/docs/nav/sync.d.ts +20 -0
- package/dist/commands/docs/nav/sync.d.ts.map +1 -0
- package/dist/commands/docs/nav/sync.js +92 -0
- package/dist/commands/doctor/index.d.ts +32 -0
- package/dist/commands/doctor/index.d.ts.map +1 -0
- package/dist/commands/doctor/index.js +373 -0
- package/dist/commands/index-cmd/index.d.ts +11 -0
- package/dist/commands/index-cmd/index.d.ts.map +1 -0
- package/dist/commands/index-cmd/index.js +62 -0
- package/dist/commands/index-cmd/thin-index.d.ts +19 -0
- package/dist/commands/index-cmd/thin-index.d.ts.map +1 -0
- package/dist/commands/index-cmd/thin-index.js +330 -0
- package/dist/commands/index.d.ts +3 -0
- package/dist/commands/index.d.ts.map +1 -0
- package/dist/commands/index.js +38 -0
- package/dist/commands/init/detect-docs.d.ts +11 -0
- package/dist/commands/init/detect-docs.d.ts.map +1 -0
- package/dist/commands/init/detect-docs.js +51 -0
- package/dist/commands/init/gitignore.d.ts +6 -0
- package/dist/commands/init/gitignore.d.ts.map +1 -0
- package/dist/commands/init/gitignore.js +41 -0
- package/dist/commands/init/index.d.ts +70 -0
- package/dist/commands/init/index.d.ts.map +1 -0
- package/dist/commands/init/index.js +570 -0
- package/dist/commands/init/tools/core/index.d.ts +12 -0
- package/dist/commands/init/tools/core/index.d.ts.map +1 -0
- package/dist/commands/init/tools/core/index.js +67 -0
- package/dist/commands/init/tools/core/install-core.d.ts +30 -0
- package/dist/commands/init/tools/core/install-core.d.ts.map +1 -0
- package/dist/commands/init/tools/core/install-core.js +50 -0
- package/dist/commands/init/tools/docs/index.d.ts +17 -0
- package/dist/commands/init/tools/docs/index.d.ts.map +1 -0
- package/dist/commands/init/tools/docs/index.js +110 -0
- package/dist/commands/init/tools/docs/install-docs.d.ts +23 -0
- package/dist/commands/init/tools/docs/install-docs.d.ts.map +1 -0
- package/dist/commands/init/tools/docs/install-docs.js +58 -0
- package/dist/commands/init/tools/ideas/index.d.ts +16 -0
- package/dist/commands/init/tools/ideas/index.d.ts.map +1 -0
- package/dist/commands/init/tools/ideas/index.js +94 -0
- package/dist/commands/init/tools/ideas/install-ideas.d.ts +25 -0
- package/dist/commands/init/tools/ideas/install-ideas.d.ts.map +1 -0
- package/dist/commands/init/tools/ideas/install-ideas.js +78 -0
- package/dist/commands/init/tools/index.d.ts +51 -0
- package/dist/commands/init/tools/index.d.ts.map +1 -0
- package/dist/commands/init/tools/index.js +387 -0
- package/dist/commands/init/tools/project-management/index.d.ts +12 -0
- package/dist/commands/init/tools/project-management/index.d.ts.map +1 -0
- package/dist/commands/init/tools/project-management/index.js +61 -0
- package/dist/commands/init/tools/project-management/install-project-management.d.ts +22 -0
- package/dist/commands/init/tools/project-management/install-project-management.d.ts.map +1 -0
- package/dist/commands/init/tools/project-management/install-project-management.js +52 -0
- package/dist/commands/init/tools/research/index.d.ts +17 -0
- package/dist/commands/init/tools/research/index.d.ts.map +1 -0
- package/dist/commands/init/tools/research/index.js +110 -0
- package/dist/commands/init/tools/research/install-research.d.ts +23 -0
- package/dist/commands/init/tools/research/install-research.d.ts.map +1 -0
- package/dist/commands/init/tools/research/install-research.js +52 -0
- package/dist/commands/init/tools/shared/copy-helpers.d.ts +12 -0
- package/dist/commands/init/tools/shared/copy-helpers.d.ts.map +1 -0
- package/dist/commands/init/tools/shared/copy-helpers.js +52 -0
- package/dist/commands/init/tools/shared/skill-manifest.d.ts +22 -0
- package/dist/commands/init/tools/shared/skill-manifest.d.ts.map +1 -0
- package/dist/commands/init/tools/shared/skill-manifest.js +102 -0
- package/dist/commands/init/tools/shared/version.d.ts +3 -0
- package/dist/commands/init/tools/shared/version.d.ts.map +1 -0
- package/dist/commands/init/tools/shared/version.js +27 -0
- package/dist/commands/init/tools/utility/index.d.ts +17 -0
- package/dist/commands/init/tools/utility/index.d.ts.map +1 -0
- package/dist/commands/init/tools/utility/index.js +109 -0
- package/dist/commands/init/tools/utility/install-utility.d.ts +20 -0
- package/dist/commands/init/tools/utility/install-utility.d.ts.map +1 -0
- package/dist/commands/init/tools/utility/install-utility.js +35 -0
- package/dist/commands/init/tools/workflows/index.d.ts +14 -0
- package/dist/commands/init/tools/workflows/index.d.ts.map +1 -0
- package/dist/commands/init/tools/workflows/index.js +84 -0
- package/dist/commands/init/tools/workflows/install-workflows.d.ts +32 -0
- package/dist/commands/init/tools/workflows/install-workflows.d.ts.map +1 -0
- package/dist/commands/init/tools/workflows/install-workflows.js +135 -0
- package/dist/commands/instructions/index.d.ts +3 -0
- package/dist/commands/instructions/index.d.ts.map +1 -0
- package/dist/commands/instructions/index.js +9 -0
- package/dist/commands/instructions/instructions.types.d.ts +52 -0
- package/dist/commands/instructions/instructions.types.d.ts.map +1 -0
- package/dist/commands/instructions/instructions.types.js +1 -0
- package/dist/commands/instructions/instructions.utils.d.ts +13 -0
- package/dist/commands/instructions/instructions.utils.d.ts.map +1 -0
- package/dist/commands/instructions/instructions.utils.js +211 -0
- package/dist/commands/instructions/sync/sync.d.ts +4 -0
- package/dist/commands/instructions/sync/sync.d.ts.map +1 -0
- package/dist/commands/instructions/sync/sync.js +142 -0
- package/dist/commands/instructions/validate/validate.d.ts +4 -0
- package/dist/commands/instructions/validate/validate.d.ts.map +1 -0
- package/dist/commands/instructions/validate/validate.js +53 -0
- package/dist/commands/internal/index.d.ts +3 -0
- package/dist/commands/internal/index.d.ts.map +1 -0
- package/dist/commands/internal/index.js +7 -0
- package/dist/commands/internal/validate-oat-skills.d.ts +10 -0
- package/dist/commands/internal/validate-oat-skills.d.ts.map +1 -0
- package/dist/commands/internal/validate-oat-skills.js +66 -0
- package/dist/commands/local/apply.d.ts +6 -0
- package/dist/commands/local/apply.d.ts.map +1 -0
- package/dist/commands/local/apply.js +56 -0
- package/dist/commands/local/expand.d.ts +8 -0
- package/dist/commands/local/expand.d.ts.map +1 -0
- package/dist/commands/local/expand.js +83 -0
- package/dist/commands/local/index.d.ts +3 -0
- package/dist/commands/local/index.d.ts.map +1 -0
- package/dist/commands/local/index.js +248 -0
- package/dist/commands/local/manage.d.ts +18 -0
- package/dist/commands/local/manage.d.ts.map +1 -0
- package/dist/commands/local/manage.js +66 -0
- package/dist/commands/local/status.d.ts +7 -0
- package/dist/commands/local/status.d.ts.map +1 -0
- package/dist/commands/local/status.js +46 -0
- package/dist/commands/local/sync.d.ts +20 -0
- package/dist/commands/local/sync.d.ts.map +1 -0
- package/dist/commands/local/sync.js +40 -0
- package/dist/commands/project/archive/archive-utils.d.ts +70 -0
- package/dist/commands/project/archive/archive-utils.d.ts.map +1 -0
- package/dist/commands/project/archive/archive-utils.js +236 -0
- package/dist/commands/project/archive/index.d.ts +20 -0
- package/dist/commands/project/archive/index.d.ts.map +1 -0
- package/dist/commands/project/archive/index.js +217 -0
- package/dist/commands/project/index.d.ts +3 -0
- package/dist/commands/project/index.d.ts.map +1 -0
- package/dist/commands/project/index.js +15 -0
- package/dist/commands/project/new/index.d.ts +17 -0
- package/dist/commands/project/new/index.d.ts.map +1 -0
- package/dist/commands/project/new/index.js +76 -0
- package/dist/commands/project/new/scaffold.d.ts +24 -0
- package/dist/commands/project/new/scaffold.d.ts.map +1 -0
- package/dist/commands/project/new/scaffold.js +177 -0
- package/dist/commands/project/open/index.d.ts +26 -0
- package/dist/commands/project/open/index.d.ts.map +1 -0
- package/dist/commands/project/open/index.js +139 -0
- package/dist/commands/project/pause/index.d.ts +27 -0
- package/dist/commands/project/pause/index.d.ts.map +1 -0
- package/dist/commands/project/pause/index.js +120 -0
- package/dist/commands/project/set-mode/index.d.ts +14 -0
- package/dist/commands/project/set-mode/index.d.ts.map +1 -0
- package/dist/commands/project/set-mode/index.js +115 -0
- package/dist/commands/providers/index.d.ts +4 -0
- package/dist/commands/providers/index.d.ts.map +1 -0
- package/dist/commands/providers/index.js +11 -0
- package/dist/commands/providers/inspect/inspect.d.ts +4 -0
- package/dist/commands/providers/inspect/inspect.d.ts.map +1 -0
- package/dist/commands/providers/inspect/inspect.js +156 -0
- package/dist/commands/providers/list/list.d.ts +4 -0
- package/dist/commands/providers/list/list.d.ts.map +1 -0
- package/dist/commands/providers/list/list.js +163 -0
- package/dist/commands/providers/providers.types.d.ts +63 -0
- package/dist/commands/providers/providers.types.d.ts.map +1 -0
- package/dist/commands/providers/providers.types.js +1 -0
- package/dist/commands/providers/set/index.d.ts +4 -0
- package/dist/commands/providers/set/index.d.ts.map +1 -0
- package/dist/commands/providers/set/index.js +138 -0
- package/dist/commands/remove/index.d.ts +3 -0
- package/dist/commands/remove/index.d.ts.map +1 -0
- package/dist/commands/remove/index.js +9 -0
- package/dist/commands/remove/skill/index.d.ts +2 -0
- package/dist/commands/remove/skill/index.d.ts.map +1 -0
- package/dist/commands/remove/skill/index.js +1 -0
- package/dist/commands/remove/skill/remove-skill.d.ts +23 -0
- package/dist/commands/remove/skill/remove-skill.d.ts.map +1 -0
- package/dist/commands/remove/skill/remove-skill.js +231 -0
- package/dist/commands/remove/skills/index.d.ts +2 -0
- package/dist/commands/remove/skills/index.d.ts.map +1 -0
- package/dist/commands/remove/skills/index.js +1 -0
- package/dist/commands/remove/skills/remove-skills.d.ts +14 -0
- package/dist/commands/remove/skills/remove-skills.d.ts.map +1 -0
- package/dist/commands/remove/skills/remove-skills.js +98 -0
- package/dist/commands/repo/index.d.ts +3 -0
- package/dist/commands/repo/index.d.ts.map +1 -0
- package/dist/commands/repo/index.js +7 -0
- package/dist/commands/repo/pr-comments/collect/collect-comments.d.ts +9 -0
- package/dist/commands/repo/pr-comments/collect/collect-comments.d.ts.map +1 -0
- package/dist/commands/repo/pr-comments/collect/collect-comments.js +284 -0
- package/dist/commands/repo/pr-comments/collect/graphql-queries.d.ts +3 -0
- package/dist/commands/repo/pr-comments/collect/graphql-queries.d.ts.map +1 -0
- package/dist/commands/repo/pr-comments/collect/graphql-queries.js +56 -0
- package/dist/commands/repo/pr-comments/collect/index.d.ts +4 -0
- package/dist/commands/repo/pr-comments/collect/index.d.ts.map +1 -0
- package/dist/commands/repo/pr-comments/collect/index.js +25 -0
- package/dist/commands/repo/pr-comments/collect/pr-comments.types.d.ts +62 -0
- package/dist/commands/repo/pr-comments/collect/pr-comments.types.d.ts.map +1 -0
- package/dist/commands/repo/pr-comments/collect/pr-comments.types.js +1 -0
- package/dist/commands/repo/pr-comments/index.d.ts +3 -0
- package/dist/commands/repo/pr-comments/index.d.ts.map +1 -0
- package/dist/commands/repo/pr-comments/index.js +9 -0
- package/dist/commands/repo/pr-comments/triage-collection/index.d.ts +4 -0
- package/dist/commands/repo/pr-comments/triage-collection/index.d.ts.map +1 -0
- package/dist/commands/repo/pr-comments/triage-collection/index.js +21 -0
- package/dist/commands/repo/pr-comments/triage-collection/triage-comments.d.ts +13 -0
- package/dist/commands/repo/pr-comments/triage-collection/triage-comments.d.ts.map +1 -0
- package/dist/commands/repo/pr-comments/triage-collection/triage-comments.js +81 -0
- package/dist/commands/shared/adopt-stray.d.ts +22 -0
- package/dist/commands/shared/adopt-stray.d.ts.map +1 -0
- package/dist/commands/shared/adopt-stray.js +135 -0
- package/dist/commands/shared/agents-md.d.ts +18 -0
- package/dist/commands/shared/agents-md.d.ts.map +1 -0
- package/dist/commands/shared/agents-md.js +81 -0
- package/dist/commands/shared/codex-strays.d.ts +16 -0
- package/dist/commands/shared/codex-strays.d.ts.map +1 -0
- package/dist/commands/shared/codex-strays.js +116 -0
- package/dist/commands/shared/frontmatter-write.d.ts +8 -0
- package/dist/commands/shared/frontmatter-write.d.ts.map +1 -0
- package/dist/commands/shared/frontmatter-write.js +27 -0
- package/dist/commands/shared/frontmatter.d.ts +6 -0
- package/dist/commands/shared/frontmatter.d.ts.map +1 -0
- package/dist/commands/shared/frontmatter.js +35 -0
- package/dist/commands/shared/messages.d.ts +2 -0
- package/dist/commands/shared/messages.d.ts.map +1 -0
- package/dist/commands/shared/messages.js +1 -0
- package/dist/commands/shared/oat-paths.d.ts +2 -0
- package/dist/commands/shared/oat-paths.d.ts.map +1 -0
- package/dist/commands/shared/oat-paths.js +13 -0
- package/dist/commands/shared/shared.prompts.d.ts +21 -0
- package/dist/commands/shared/shared.prompts.d.ts.map +1 -0
- package/dist/commands/shared/shared.prompts.js +107 -0
- package/dist/commands/shared/shared.utils.d.ts +6 -0
- package/dist/commands/shared/shared.utils.d.ts.map +1 -0
- package/dist/commands/shared/shared.utils.js +9 -0
- package/dist/commands/state/generate.d.ts +21 -0
- package/dist/commands/state/generate.d.ts.map +1 -0
- package/dist/commands/state/generate.js +440 -0
- package/dist/commands/state/index.d.ts +11 -0
- package/dist/commands/state/index.d.ts.map +1 -0
- package/dist/commands/state/index.js +58 -0
- package/dist/commands/status/index.d.ts +44 -0
- package/dist/commands/status/index.d.ts.map +1 -0
- package/dist/commands/status/index.js +340 -0
- package/dist/commands/sync/apply.d.ts +4 -0
- package/dist/commands/sync/apply.d.ts.map +1 -0
- package/dist/commands/sync/apply.js +100 -0
- package/dist/commands/sync/dry-run.d.ts +4 -0
- package/dist/commands/sync/dry-run.d.ts.map +1 -0
- package/dist/commands/sync/dry-run.js +74 -0
- package/dist/commands/sync/index.d.ts +4 -0
- package/dist/commands/sync/index.d.ts.map +1 -0
- package/dist/commands/sync/index.js +225 -0
- package/dist/commands/sync/sync.types.d.ts +80 -0
- package/dist/commands/sync/sync.types.d.ts.map +1 -0
- package/dist/commands/sync/sync.types.js +1 -0
- package/dist/commands/sync/sync.utils.d.ts +3 -0
- package/dist/commands/sync/sync.utils.d.ts.map +1 -0
- package/dist/commands/sync/sync.utils.js +8 -0
- package/dist/commands/tools/index.d.ts +3 -0
- package/dist/commands/tools/index.d.ts.map +1 -0
- package/dist/commands/tools/index.js +17 -0
- package/dist/commands/tools/info/index.d.ts +4 -0
- package/dist/commands/tools/info/index.d.ts.map +1 -0
- package/dist/commands/tools/info/index.js +74 -0
- package/dist/commands/tools/info/info-tool.d.ts +21 -0
- package/dist/commands/tools/info/info-tool.d.ts.map +1 -0
- package/dist/commands/tools/info/info-tool.js +52 -0
- package/dist/commands/tools/install/index.d.ts +4 -0
- package/dist/commands/tools/install/index.d.ts.map +1 -0
- package/dist/commands/tools/install/index.js +34 -0
- package/dist/commands/tools/list/index.d.ts +4 -0
- package/dist/commands/tools/list/index.d.ts.map +1 -0
- package/dist/commands/tools/list/index.js +25 -0
- package/dist/commands/tools/list/list-tools.d.ts +13 -0
- package/dist/commands/tools/list/list-tools.d.ts.map +1 -0
- package/dist/commands/tools/list/list-tools.js +43 -0
- package/dist/commands/tools/outdated/index.d.ts +4 -0
- package/dist/commands/tools/outdated/index.d.ts.map +1 -0
- package/dist/commands/tools/outdated/index.js +25 -0
- package/dist/commands/tools/outdated/outdated-tools.d.ts +13 -0
- package/dist/commands/tools/outdated/outdated-tools.d.ts.map +1 -0
- package/dist/commands/tools/outdated/outdated-tools.js +43 -0
- package/dist/commands/tools/remove/index.d.ts +5 -0
- package/dist/commands/tools/remove/index.d.ts.map +1 -0
- package/dist/commands/tools/remove/index.js +122 -0
- package/dist/commands/tools/remove/remove-tools.d.ts +31 -0
- package/dist/commands/tools/remove/remove-tools.d.ts.map +1 -0
- package/dist/commands/tools/remove/remove-tools.js +41 -0
- package/dist/commands/tools/shared/auto-sync.d.ts +16 -0
- package/dist/commands/tools/shared/auto-sync.d.ts.map +1 -0
- package/dist/commands/tools/shared/auto-sync.js +17 -0
- package/dist/commands/tools/shared/scan-tools.d.ts +18 -0
- package/dist/commands/tools/shared/scan-tools.d.ts.map +1 -0
- package/dist/commands/tools/shared/scan-tools.js +128 -0
- package/dist/commands/tools/shared/types.d.ts +12 -0
- package/dist/commands/tools/shared/types.d.ts.map +1 -0
- package/dist/commands/tools/shared/types.js +1 -0
- package/dist/commands/tools/update/index.d.ts +8 -0
- package/dist/commands/tools/update/index.d.ts.map +1 -0
- package/dist/commands/tools/update/index.js +149 -0
- package/dist/commands/tools/update/update-tools.d.ts +29 -0
- package/dist/commands/tools/update/update-tools.d.ts.map +1 -0
- package/dist/commands/tools/update/update-tools.js +148 -0
- package/dist/config/index.d.ts +4 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +2 -0
- package/dist/config/oat-config.d.ts +61 -0
- package/dist/config/oat-config.d.ts.map +1 -0
- package/dist/config/oat-config.js +319 -0
- package/dist/config/runtime.d.ts +2 -0
- package/dist/config/runtime.d.ts.map +1 -0
- package/dist/config/runtime.js +3 -0
- package/dist/config/sync-config.d.ts +49 -0
- package/dist/config/sync-config.d.ts.map +1 -0
- package/dist/config/sync-config.js +94 -0
- package/dist/drift/detector.d.ts +4 -0
- package/dist/drift/detector.d.ts.map +1 -0
- package/dist/drift/detector.js +69 -0
- package/dist/drift/drift.types.d.ts +17 -0
- package/dist/drift/drift.types.d.ts.map +1 -0
- package/dist/drift/drift.types.js +1 -0
- package/dist/drift/index.d.ts +4 -0
- package/dist/drift/index.d.ts.map +1 -0
- package/dist/drift/index.js +2 -0
- package/dist/drift/strays.d.ts +7 -0
- package/dist/drift/strays.d.ts.map +1 -0
- package/dist/drift/strays.js +153 -0
- package/dist/engine/compute-plan.d.ts +16 -0
- package/dist/engine/compute-plan.d.ts.map +1 -0
- package/dist/engine/compute-plan.js +234 -0
- package/dist/engine/engine.types.d.ts +28 -0
- package/dist/engine/engine.types.d.ts.map +1 -0
- package/dist/engine/engine.types.js +8 -0
- package/dist/engine/execute-plan.d.ts +5 -0
- package/dist/engine/execute-plan.d.ts.map +1 -0
- package/dist/engine/execute-plan.js +141 -0
- package/dist/engine/hook.d.ts +23 -0
- package/dist/engine/hook.d.ts.map +1 -0
- package/dist/engine/hook.js +254 -0
- package/dist/engine/index.d.ts +9 -0
- package/dist/engine/index.d.ts.map +1 -0
- package/dist/engine/index.js +6 -0
- package/dist/engine/markers.d.ts +6 -0
- package/dist/engine/markers.d.ts.map +1 -0
- package/dist/engine/markers.js +24 -0
- package/dist/engine/scanner.d.ts +11 -0
- package/dist/engine/scanner.d.ts.map +1 -0
- package/dist/engine/scanner.js +65 -0
- package/dist/engine/test-helpers.d.ts +3 -0
- package/dist/engine/test-helpers.d.ts.map +1 -0
- package/dist/engine/test-helpers.js +31 -0
- package/dist/errors/cli-error.d.ts +5 -0
- package/dist/errors/cli-error.d.ts.map +1 -0
- package/dist/errors/cli-error.js +8 -0
- package/dist/errors/index.d.ts +2 -0
- package/dist/errors/index.d.ts.map +1 -0
- package/dist/errors/index.js +1 -0
- package/dist/fs/assets.d.ts +2 -0
- package/dist/fs/assets.d.ts.map +1 -0
- package/dist/fs/assets.js +22 -0
- package/dist/fs/index.d.ts +4 -0
- package/dist/fs/index.d.ts.map +1 -0
- package/dist/fs/index.js +3 -0
- package/dist/fs/io.d.ts +9 -0
- package/dist/fs/io.d.ts.map +1 -0
- package/dist/fs/io.js +74 -0
- package/dist/fs/paths.d.ts +9 -0
- package/dist/fs/paths.d.ts.map +1 -0
- package/dist/fs/paths.js +42 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +48 -0
- package/dist/manifest/hash.d.ts +5 -0
- package/dist/manifest/hash.d.ts.map +1 -0
- package/dist/manifest/hash.js +75 -0
- package/dist/manifest/index.d.ts +5 -0
- package/dist/manifest/index.d.ts.map +1 -0
- package/dist/manifest/index.js +3 -0
- package/dist/manifest/manager.d.ts +8 -0
- package/dist/manifest/manager.d.ts.map +1 -0
- package/dist/manifest/manager.js +86 -0
- package/dist/manifest/manifest.types.d.ts +157 -0
- package/dist/manifest/manifest.types.d.ts.map +1 -0
- package/dist/manifest/manifest.types.js +56 -0
- package/dist/providers/claude/adapter.d.ts +3 -0
- package/dist/providers/claude/adapter.d.ts.map +1 -0
- package/dist/providers/claude/adapter.js +20 -0
- package/dist/providers/claude/index.d.ts +3 -0
- package/dist/providers/claude/index.d.ts.map +1 -0
- package/dist/providers/claude/index.js +2 -0
- package/dist/providers/claude/paths.d.ts +4 -0
- package/dist/providers/claude/paths.d.ts.map +1 -0
- package/dist/providers/claude/paths.js +38 -0
- package/dist/providers/claude/rule-transform.d.ts +3 -0
- package/dist/providers/claude/rule-transform.d.ts.map +1 -0
- package/dist/providers/claude/rule-transform.js +22 -0
- package/dist/providers/codex/adapter.d.ts +3 -0
- package/dist/providers/codex/adapter.d.ts.map +1 -0
- package/dist/providers/codex/adapter.js +20 -0
- package/dist/providers/codex/codec/config-merge.d.ts +17 -0
- package/dist/providers/codex/codec/config-merge.d.ts.map +1 -0
- package/dist/providers/codex/codec/config-merge.js +61 -0
- package/dist/providers/codex/codec/export-to-codex.d.ts +9 -0
- package/dist/providers/codex/codec/export-to-codex.d.ts.map +1 -0
- package/dist/providers/codex/codec/export-to-codex.js +45 -0
- package/dist/providers/codex/codec/import-from-codex.d.ts +9 -0
- package/dist/providers/codex/codec/import-from-codex.d.ts.map +1 -0
- package/dist/providers/codex/codec/import-from-codex.js +52 -0
- package/dist/providers/codex/codec/shared.d.ts +7 -0
- package/dist/providers/codex/codec/shared.d.ts.map +1 -0
- package/dist/providers/codex/codec/shared.js +21 -0
- package/dist/providers/codex/codec/sync-extension.d.ts +32 -0
- package/dist/providers/codex/codec/sync-extension.d.ts.map +1 -0
- package/dist/providers/codex/codec/sync-extension.js +227 -0
- package/dist/providers/codex/index.d.ts +6 -0
- package/dist/providers/codex/index.d.ts.map +1 -0
- package/dist/providers/codex/index.js +5 -0
- package/dist/providers/codex/paths.d.ts +4 -0
- package/dist/providers/codex/paths.d.ts.map +1 -0
- package/dist/providers/codex/paths.js +28 -0
- package/dist/providers/copilot/adapter.d.ts +3 -0
- package/dist/providers/copilot/adapter.d.ts.map +1 -0
- package/dist/providers/copilot/adapter.js +30 -0
- package/dist/providers/copilot/index.d.ts +3 -0
- package/dist/providers/copilot/index.d.ts.map +1 -0
- package/dist/providers/copilot/index.js +2 -0
- package/dist/providers/copilot/paths.d.ts +4 -0
- package/dist/providers/copilot/paths.d.ts.map +1 -0
- package/dist/providers/copilot/paths.js +38 -0
- package/dist/providers/copilot/rule-transform.d.ts +3 -0
- package/dist/providers/copilot/rule-transform.d.ts.map +1 -0
- package/dist/providers/copilot/rule-transform.js +58 -0
- package/dist/providers/cursor/adapter.d.ts +3 -0
- package/dist/providers/cursor/adapter.d.ts.map +1 -0
- package/dist/providers/cursor/adapter.js +20 -0
- package/dist/providers/cursor/index.d.ts +3 -0
- package/dist/providers/cursor/index.d.ts.map +1 -0
- package/dist/providers/cursor/index.js +2 -0
- package/dist/providers/cursor/paths.d.ts +4 -0
- package/dist/providers/cursor/paths.d.ts.map +1 -0
- package/dist/providers/cursor/paths.js +38 -0
- package/dist/providers/cursor/rule-transform.d.ts +3 -0
- package/dist/providers/cursor/rule-transform.d.ts.map +1 -0
- package/dist/providers/cursor/rule-transform.js +48 -0
- package/dist/providers/gemini/adapter.d.ts +3 -0
- package/dist/providers/gemini/adapter.d.ts.map +1 -0
- package/dist/providers/gemini/adapter.js +20 -0
- package/dist/providers/gemini/index.d.ts +3 -0
- package/dist/providers/gemini/index.d.ts.map +1 -0
- package/dist/providers/gemini/index.js +2 -0
- package/dist/providers/gemini/paths.d.ts +4 -0
- package/dist/providers/gemini/paths.d.ts.map +1 -0
- package/dist/providers/gemini/paths.js +28 -0
- package/dist/providers/shared/adapter.types.d.ts +21 -0
- package/dist/providers/shared/adapter.types.d.ts.map +1 -0
- package/dist/providers/shared/adapter.types.js +1 -0
- package/dist/providers/shared/adapter.utils.d.ts +12 -0
- package/dist/providers/shared/adapter.utils.d.ts.map +1 -0
- package/dist/providers/shared/adapter.utils.js +57 -0
- package/dist/providers/shared/agent-codec.types.d.ts +13 -0
- package/dist/providers/shared/agent-codec.types.d.ts.map +1 -0
- package/dist/providers/shared/agent-codec.types.js +1 -0
- package/dist/providers/shared/index.d.ts +6 -0
- package/dist/providers/shared/index.d.ts.map +1 -0
- package/dist/providers/shared/index.js +2 -0
- package/dist/providers/shared/markdown-agent-codec.d.ts +5 -0
- package/dist/providers/shared/markdown-agent-codec.d.ts.map +1 -0
- package/dist/providers/shared/markdown-agent-codec.js +12 -0
- package/dist/release/public-package-contract.d.ts +14 -0
- package/dist/release/public-package-contract.d.ts.map +1 -0
- package/dist/release/public-package-contract.js +97 -0
- package/dist/rules/canonical/index.d.ts +6 -0
- package/dist/rules/canonical/index.d.ts.map +1 -0
- package/dist/rules/canonical/index.js +4 -0
- package/dist/rules/canonical/parse.d.ts +9 -0
- package/dist/rules/canonical/parse.d.ts.map +1 -0
- package/dist/rules/canonical/parse.js +103 -0
- package/dist/rules/canonical/provider-filenames.d.ts +3 -0
- package/dist/rules/canonical/provider-filenames.d.ts.map +1 -0
- package/dist/rules/canonical/provider-filenames.js +13 -0
- package/dist/rules/canonical/render.d.ts +5 -0
- package/dist/rules/canonical/render.d.ts.map +1 -0
- package/dist/rules/canonical/render.js +32 -0
- package/dist/rules/canonical/types.d.ts +16 -0
- package/dist/rules/canonical/types.d.ts.map +1 -0
- package/dist/rules/canonical/types.js +6 -0
- package/dist/shared/index.d.ts +3 -0
- package/dist/shared/index.d.ts.map +1 -0
- package/dist/shared/index.js +1 -0
- package/dist/shared/types.d.ts +10 -0
- package/dist/shared/types.d.ts.map +1 -0
- package/dist/shared/types.js +14 -0
- package/dist/ui/ansi.d.ts +2 -0
- package/dist/ui/ansi.d.ts.map +1 -0
- package/dist/ui/ansi.js +19 -0
- package/dist/ui/index.d.ts +7 -0
- package/dist/ui/index.d.ts.map +1 -0
- package/dist/ui/index.js +3 -0
- package/dist/ui/logger.d.ts +15 -0
- package/dist/ui/logger.d.ts.map +1 -0
- package/dist/ui/logger.js +52 -0
- package/dist/ui/output.d.ts +16 -0
- package/dist/ui/output.d.ts.map +1 -0
- package/dist/ui/output.js +135 -0
- package/dist/ui/spinner.d.ts +16 -0
- package/dist/ui/spinner.d.ts.map +1 -0
- package/dist/ui/spinner.js +46 -0
- package/dist/validation/index.d.ts +3 -0
- package/dist/validation/index.d.ts.map +1 -0
- package/dist/validation/index.js +1 -0
- package/dist/validation/skills.d.ts +10 -0
- package/dist/validation/skills.d.ts.map +1 -0
- package/dist/validation/skills.js +166 -0
- package/package.json +62 -0
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
import { basename, join } from 'node:path';
|
|
2
|
+
import { dirExists, fileExists } from '../../../fs/io.js';
|
|
3
|
+
const FRAMEWORK_CHOICES = [
|
|
4
|
+
{ label: 'Fumadocs (Next.js + MDX, static export)', value: 'fumadocs' },
|
|
5
|
+
{ label: 'MkDocs (Python, Material theme)', value: 'mkdocs' },
|
|
6
|
+
];
|
|
7
|
+
const LINT_CHOICES = [
|
|
8
|
+
{ label: 'none', value: 'none' },
|
|
9
|
+
];
|
|
10
|
+
const FORMAT_CHOICES = [
|
|
11
|
+
{ label: 'oxfmt', value: 'oxfmt' },
|
|
12
|
+
{ label: 'none', value: 'none' },
|
|
13
|
+
];
|
|
14
|
+
export function getDefaultDocsAppName(repoRoot, repoShape) {
|
|
15
|
+
if (repoShape === 'monorepo') {
|
|
16
|
+
return `${basename(repoRoot)}-docs`;
|
|
17
|
+
}
|
|
18
|
+
return 'docs';
|
|
19
|
+
}
|
|
20
|
+
export function getDefaultDocsTargetDir(repoShape, appName) {
|
|
21
|
+
if (repoShape === 'monorepo') {
|
|
22
|
+
return join('apps', appName);
|
|
23
|
+
}
|
|
24
|
+
return appName;
|
|
25
|
+
}
|
|
26
|
+
function hasWorkspaceConfig(rawPackageJson) {
|
|
27
|
+
try {
|
|
28
|
+
const parsed = JSON.parse(rawPackageJson);
|
|
29
|
+
if (Array.isArray(parsed.workspaces)) {
|
|
30
|
+
return parsed.workspaces.length > 0;
|
|
31
|
+
}
|
|
32
|
+
return (Array.isArray(parsed.workspaces?.packages) &&
|
|
33
|
+
parsed.workspaces.packages.length > 0);
|
|
34
|
+
}
|
|
35
|
+
catch {
|
|
36
|
+
return false;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
export async function detectDocsRepoShape(repoRoot, dependencies) {
|
|
40
|
+
if (await dependencies.fileExists(join(repoRoot, 'pnpm-workspace.yaml'))) {
|
|
41
|
+
return 'monorepo';
|
|
42
|
+
}
|
|
43
|
+
const packageJsonPath = join(repoRoot, 'package.json');
|
|
44
|
+
if (await dependencies.fileExists(packageJsonPath)) {
|
|
45
|
+
const rawPackageJson = await dependencies.readFile(packageJsonPath, 'utf8');
|
|
46
|
+
if (hasWorkspaceConfig(rawPackageJson)) {
|
|
47
|
+
return 'monorepo';
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
if ((await dependencies.dirExists(join(repoRoot, 'apps'))) &&
|
|
51
|
+
(await dependencies.dirExists(join(repoRoot, 'packages')))) {
|
|
52
|
+
return 'monorepo';
|
|
53
|
+
}
|
|
54
|
+
return 'single-package';
|
|
55
|
+
}
|
|
56
|
+
export function getTemplateDir(framework) {
|
|
57
|
+
return framework === 'fumadocs' ? 'docs-app-fuma' : 'docs-app-mkdocs';
|
|
58
|
+
}
|
|
59
|
+
export async function resolveDocsInitOptions(input) {
|
|
60
|
+
const ctx = { interactive: input.interactive };
|
|
61
|
+
const framework = input.providedFramework ||
|
|
62
|
+
(input.interactive && !input.acceptDefaults
|
|
63
|
+
? await input.selectWithAbort('Documentation framework', FRAMEWORK_CHOICES, ctx)
|
|
64
|
+
: 'fumadocs');
|
|
65
|
+
if (!framework) {
|
|
66
|
+
return null;
|
|
67
|
+
}
|
|
68
|
+
const defaultAppName = getDefaultDocsAppName(input.repoRoot, input.repoShape);
|
|
69
|
+
const appName = input.providedAppName?.trim() ||
|
|
70
|
+
(input.interactive && !input.acceptDefaults
|
|
71
|
+
? await input.inputWithDefault('Docs app name', defaultAppName, ctx)
|
|
72
|
+
: defaultAppName);
|
|
73
|
+
if (!appName) {
|
|
74
|
+
return null;
|
|
75
|
+
}
|
|
76
|
+
const defaultTargetDir = getDefaultDocsTargetDir(input.repoShape, appName);
|
|
77
|
+
const targetDir = input.providedTargetDir?.trim() ||
|
|
78
|
+
(input.interactive && !input.acceptDefaults
|
|
79
|
+
? await input.inputWithDefault('Docs app target directory', defaultTargetDir, ctx)
|
|
80
|
+
: defaultTargetDir);
|
|
81
|
+
if (!targetDir) {
|
|
82
|
+
return null;
|
|
83
|
+
}
|
|
84
|
+
const siteDescription = input.providedSiteDescription ??
|
|
85
|
+
(input.interactive && !input.acceptDefaults
|
|
86
|
+
? ((await input.inputWithDefault('Site description', '', ctx)) ?? '')
|
|
87
|
+
: '');
|
|
88
|
+
const lint = input.providedLint ||
|
|
89
|
+
(input.interactive && !input.acceptDefaults
|
|
90
|
+
? await input.selectWithAbort('Markdown lint mode', LINT_CHOICES, ctx)
|
|
91
|
+
: 'none');
|
|
92
|
+
if (!lint) {
|
|
93
|
+
return null;
|
|
94
|
+
}
|
|
95
|
+
const format = input.providedFormat ||
|
|
96
|
+
(input.interactive && !input.acceptDefaults
|
|
97
|
+
? await input.selectWithAbort('Markdown format mode', FORMAT_CHOICES, ctx)
|
|
98
|
+
: 'oxfmt');
|
|
99
|
+
if (!format) {
|
|
100
|
+
return null;
|
|
101
|
+
}
|
|
102
|
+
return {
|
|
103
|
+
repoRoot: input.repoRoot,
|
|
104
|
+
repoShape: input.repoShape,
|
|
105
|
+
framework,
|
|
106
|
+
appName,
|
|
107
|
+
targetDir,
|
|
108
|
+
siteDescription,
|
|
109
|
+
lint,
|
|
110
|
+
format,
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
export const DEFAULT_DOCS_REPO_SHAPE_DEPENDENCIES = {
|
|
114
|
+
fileExists,
|
|
115
|
+
dirExists,
|
|
116
|
+
readFile: async (path, encoding) => {
|
|
117
|
+
const { readFile } = await import('node:fs/promises');
|
|
118
|
+
return readFile(path, encoding);
|
|
119
|
+
},
|
|
120
|
+
};
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { OatDocumentationConfig } from '../../../config/oat-config.js';
|
|
2
|
+
import type { DocsInitResolvedOptions } from './resolve-options.js';
|
|
3
|
+
export interface ScaffoldDocsAppOptions extends DocsInitResolvedOptions {
|
|
4
|
+
assetsRoot: string;
|
|
5
|
+
}
|
|
6
|
+
export interface ScaffoldDocsAppResult {
|
|
7
|
+
appRoot: string;
|
|
8
|
+
createdFiles: string[];
|
|
9
|
+
documentationConfig: OatDocumentationConfig;
|
|
10
|
+
}
|
|
11
|
+
export interface OatDepContext {
|
|
12
|
+
isOatRepo: boolean;
|
|
13
|
+
oatPackageVersions: Record<string, string>;
|
|
14
|
+
}
|
|
15
|
+
export declare function detectIsOatRepo(repoRoot: string): Promise<boolean>;
|
|
16
|
+
export declare function resolveOatDepContext(repoRoot: string, assetsRoot: string): Promise<OatDepContext>;
|
|
17
|
+
export declare function scaffoldDocsApp(options: ScaffoldDocsAppOptions): Promise<ScaffoldDocsAppResult>;
|
|
18
|
+
//# sourceMappingURL=scaffold.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/scaffold.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,KAAK,EAGV,uBAAuB,EAExB,MAAM,mBAAmB,CAAC;AA+E3B,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,EAAE,sBAAsB,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAWD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAsCD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAYxB;AAiID,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAoChC"}
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
import { readdir, readFile, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { basename, dirname, join } from 'node:path';
|
|
3
|
+
import { dirExists, ensureDir, fileExists } from '../../../fs/io.js';
|
|
4
|
+
import { getTemplateDir } from './resolve-options.js';
|
|
5
|
+
const MKDOCS_TEMPLATE_FILES = [
|
|
6
|
+
{ source: '.gitignore', destination: '.gitignore' },
|
|
7
|
+
{ source: 'mkdocs.yml', destination: 'mkdocs.yml' },
|
|
8
|
+
{ source: 'package.json.template', destination: 'package.json' },
|
|
9
|
+
{ source: 'requirements.txt', destination: 'requirements.txt' },
|
|
10
|
+
{ source: 'setup-docs.sh', destination: 'setup-docs.sh' },
|
|
11
|
+
{ source: join('docs', 'index.md'), destination: join('docs', 'index.md') },
|
|
12
|
+
{
|
|
13
|
+
source: join('docs', 'getting-started.md'),
|
|
14
|
+
destination: join('docs', 'getting-started.md'),
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
source: join('docs', 'contributing.md'),
|
|
18
|
+
destination: join('docs', 'contributing.md'),
|
|
19
|
+
},
|
|
20
|
+
];
|
|
21
|
+
const FUMA_TEMPLATE_FILES = [
|
|
22
|
+
{ source: '.gitignore', destination: '.gitignore' },
|
|
23
|
+
{ source: 'next.config.js', destination: 'next.config.js' },
|
|
24
|
+
{ source: 'postcss.config.mjs', destination: 'postcss.config.mjs' },
|
|
25
|
+
{ source: 'source.config.ts', destination: 'source.config.ts' },
|
|
26
|
+
{ source: 'tsconfig.json', destination: 'tsconfig.json' },
|
|
27
|
+
{ source: 'package.json.template', destination: 'package.json' },
|
|
28
|
+
{
|
|
29
|
+
source: join('lib', 'source.ts'),
|
|
30
|
+
destination: join('lib', 'source.ts'),
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
source: join('app', 'globals.css'),
|
|
34
|
+
destination: join('app', 'globals.css'),
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
source: join('app', 'layout.tsx'),
|
|
38
|
+
destination: join('app', 'layout.tsx'),
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
source: join('app', '[[...slug]]', 'page.tsx'),
|
|
42
|
+
destination: join('app', '[[...slug]]', 'page.tsx'),
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
source: join('app', 'api', 'search', 'route.ts'),
|
|
46
|
+
destination: join('app', 'api', 'search', 'route.ts'),
|
|
47
|
+
},
|
|
48
|
+
{ source: join('docs', 'index.md'), destination: join('docs', 'index.md') },
|
|
49
|
+
{
|
|
50
|
+
source: join('docs', 'getting-started.md'),
|
|
51
|
+
destination: join('docs', 'getting-started.md'),
|
|
52
|
+
},
|
|
53
|
+
{
|
|
54
|
+
source: join('docs', 'contributing.md'),
|
|
55
|
+
destination: join('docs', 'contributing.md'),
|
|
56
|
+
},
|
|
57
|
+
];
|
|
58
|
+
const FRAMEWORK_CONFIGS = {
|
|
59
|
+
mkdocs: {
|
|
60
|
+
templateFiles: MKDOCS_TEMPLATE_FILES,
|
|
61
|
+
sentinelFile: 'mkdocs.yml',
|
|
62
|
+
},
|
|
63
|
+
fumadocs: {
|
|
64
|
+
templateFiles: FUMA_TEMPLATE_FILES,
|
|
65
|
+
sentinelFile: 'next.config.js',
|
|
66
|
+
},
|
|
67
|
+
};
|
|
68
|
+
const OAT_DEP_PACKAGES = [
|
|
69
|
+
'cli',
|
|
70
|
+
'docs-config',
|
|
71
|
+
'docs-theme',
|
|
72
|
+
'docs-transforms',
|
|
73
|
+
];
|
|
74
|
+
const DEFAULT_OAT_PUBLISHED_VERSION = '0.0.8';
|
|
75
|
+
const PUBLIC_PACKAGE_VERSIONS_FILE = 'public-package-versions.json';
|
|
76
|
+
export async function detectIsOatRepo(repoRoot) {
|
|
77
|
+
for (const pkg of OAT_DEP_PACKAGES) {
|
|
78
|
+
if (!(await fileExists(join(repoRoot, 'packages', pkg, 'package.json')))) {
|
|
79
|
+
return false;
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
return true;
|
|
83
|
+
}
|
|
84
|
+
async function readCliVersion(assetsRoot) {
|
|
85
|
+
const cliRoot = dirname(assetsRoot);
|
|
86
|
+
try {
|
|
87
|
+
const content = await readFile(join(cliRoot, 'package.json'), 'utf8');
|
|
88
|
+
const pkg = JSON.parse(content);
|
|
89
|
+
return pkg.version ?? DEFAULT_OAT_PUBLISHED_VERSION;
|
|
90
|
+
}
|
|
91
|
+
catch {
|
|
92
|
+
return DEFAULT_OAT_PUBLISHED_VERSION;
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
async function readBundledOatPackageVersions(assetsRoot) {
|
|
96
|
+
try {
|
|
97
|
+
const content = await readFile(join(assetsRoot, PUBLIC_PACKAGE_VERSIONS_FILE), 'utf8');
|
|
98
|
+
const parsed = JSON.parse(content);
|
|
99
|
+
return Object.fromEntries(OAT_DEP_PACKAGES.flatMap((name) => typeof parsed[name] === 'string' ? [[name, parsed[name]]] : []));
|
|
100
|
+
}
|
|
101
|
+
catch {
|
|
102
|
+
return {};
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
function buildFallbackOatPackageVersions(version) {
|
|
106
|
+
return Object.fromEntries(OAT_DEP_PACKAGES.map((name) => [name, version]));
|
|
107
|
+
}
|
|
108
|
+
export async function resolveOatDepContext(repoRoot, assetsRoot) {
|
|
109
|
+
const isOatRepo = await detectIsOatRepo(repoRoot);
|
|
110
|
+
if (isOatRepo) {
|
|
111
|
+
return { isOatRepo, oatPackageVersions: {} };
|
|
112
|
+
}
|
|
113
|
+
const cliVersion = await readCliVersion(assetsRoot);
|
|
114
|
+
const oatPackageVersions = {
|
|
115
|
+
...buildFallbackOatPackageVersions(cliVersion),
|
|
116
|
+
...(await readBundledOatPackageVersions(assetsRoot)),
|
|
117
|
+
};
|
|
118
|
+
return { isOatRepo, oatPackageVersions };
|
|
119
|
+
}
|
|
120
|
+
function humanizeAppName(appName) {
|
|
121
|
+
return appName
|
|
122
|
+
.split(/[-_]/g)
|
|
123
|
+
.filter(Boolean)
|
|
124
|
+
.map((part) => part.charAt(0).toUpperCase() + part.slice(1))
|
|
125
|
+
.join(' ');
|
|
126
|
+
}
|
|
127
|
+
function buildDevDependencies(lint, format) {
|
|
128
|
+
const entries = [];
|
|
129
|
+
if (format === 'oxfmt') {
|
|
130
|
+
entries.push(' "oxfmt": "^0.36.0"');
|
|
131
|
+
}
|
|
132
|
+
return entries.join(',\n');
|
|
133
|
+
}
|
|
134
|
+
function buildFumaDevDependencies(lint, format) {
|
|
135
|
+
const entries = [];
|
|
136
|
+
if (format === 'oxfmt') {
|
|
137
|
+
entries.push(' "oxfmt": "^0.36.0"');
|
|
138
|
+
}
|
|
139
|
+
if (entries.length === 0) {
|
|
140
|
+
return '';
|
|
141
|
+
}
|
|
142
|
+
return `,\n${entries.join(',\n')}`;
|
|
143
|
+
}
|
|
144
|
+
function buildGenerateIndexCmd(isOatRepo, targetDir) {
|
|
145
|
+
if (isOatRepo) {
|
|
146
|
+
return `pnpm -w run cli -- docs generate-index --docs-dir ${targetDir}/docs --output ${targetDir}/index.md`;
|
|
147
|
+
}
|
|
148
|
+
return '(oat docs generate-index --docs-dir docs --output index.md || true)';
|
|
149
|
+
}
|
|
150
|
+
function oatDepVersion(depContext, packageName) {
|
|
151
|
+
if (depContext.isOatRepo) {
|
|
152
|
+
return 'workspace:*';
|
|
153
|
+
}
|
|
154
|
+
return `^${depContext.oatPackageVersions[packageName] ?? DEFAULT_OAT_PUBLISHED_VERSION}`;
|
|
155
|
+
}
|
|
156
|
+
function renderTemplate(template, options, depContext) {
|
|
157
|
+
const repoName = basename(options.repoRoot);
|
|
158
|
+
const siteName = `${humanizeAppName(options.appName)} Documentation`;
|
|
159
|
+
const replacements = {
|
|
160
|
+
'{{APP_NAME}}': options.appName,
|
|
161
|
+
'{{PACKAGE_NAME}}': options.appName,
|
|
162
|
+
'{{SITE_NAME}}': siteName,
|
|
163
|
+
'{{SITE_DESCRIPTION}}': options.siteDescription,
|
|
164
|
+
'{{DOCS_LINT_SCRIPT}}': "echo 'docs lint disabled'",
|
|
165
|
+
'{{DOCS_FORMAT_SCRIPT}}': options.format === 'oxfmt'
|
|
166
|
+
? "oxfmt 'docs/**/*.md'"
|
|
167
|
+
: "echo 'docs formatting disabled'",
|
|
168
|
+
'{{DOCS_FORMAT_CHECK_SCRIPT}}': options.format === 'oxfmt'
|
|
169
|
+
? "oxfmt --check 'docs/**/*.md'"
|
|
170
|
+
: "echo 'docs format check disabled'",
|
|
171
|
+
'{{DEV_DEPENDENCIES}}': buildDevDependencies(options.lint, options.format),
|
|
172
|
+
'{{FUMA_DEV_DEPENDENCIES}}': buildFumaDevDependencies(options.lint, options.format),
|
|
173
|
+
'{{REPO_NAME}}': repoName,
|
|
174
|
+
'{{APP_DIR}}': options.targetDir,
|
|
175
|
+
'{{GENERATE_INDEX_CMD}}': buildGenerateIndexCmd(depContext.isOatRepo, options.targetDir),
|
|
176
|
+
'{{OAT_DOCS_CONFIG_DEP}}': oatDepVersion(depContext, 'docs-config'),
|
|
177
|
+
'{{OAT_DOCS_THEME_DEP}}': oatDepVersion(depContext, 'docs-theme'),
|
|
178
|
+
'{{OAT_DOCS_TRANSFORMS_DEP}}': oatDepVersion(depContext, 'docs-transforms'),
|
|
179
|
+
'{{OAT_CLI_DEP}}': oatDepVersion(depContext, 'cli'),
|
|
180
|
+
};
|
|
181
|
+
return Object.entries(replacements).reduce((content, [token, value]) => content.replaceAll(token, value), template);
|
|
182
|
+
}
|
|
183
|
+
function buildDocumentationConfig(framework, targetDir) {
|
|
184
|
+
if (framework === 'fumadocs') {
|
|
185
|
+
return {
|
|
186
|
+
root: targetDir,
|
|
187
|
+
tooling: 'fumadocs',
|
|
188
|
+
index: join(targetDir, 'index.md'),
|
|
189
|
+
};
|
|
190
|
+
}
|
|
191
|
+
return {
|
|
192
|
+
root: targetDir,
|
|
193
|
+
tooling: 'mkdocs',
|
|
194
|
+
config: join(targetDir, 'mkdocs.yml'),
|
|
195
|
+
index: join(targetDir, 'mkdocs.yml'),
|
|
196
|
+
};
|
|
197
|
+
}
|
|
198
|
+
async function ensureTargetWritable(appRoot) {
|
|
199
|
+
if (!(await dirExists(appRoot))) {
|
|
200
|
+
return;
|
|
201
|
+
}
|
|
202
|
+
const entries = await readdir(appRoot);
|
|
203
|
+
if (entries.length > 0) {
|
|
204
|
+
throw new Error(`Docs app target directory is not empty: ${appRoot}`);
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
export async function scaffoldDocsApp(options) {
|
|
208
|
+
const appRoot = join(options.repoRoot, options.targetDir);
|
|
209
|
+
const templateDir = getTemplateDir(options.framework);
|
|
210
|
+
const templateRoot = join(options.assetsRoot, 'templates', templateDir);
|
|
211
|
+
const frameworkConfig = FRAMEWORK_CONFIGS[options.framework];
|
|
212
|
+
const createdFiles = [];
|
|
213
|
+
const depContext = await resolveOatDepContext(options.repoRoot, options.assetsRoot);
|
|
214
|
+
if (!(await fileExists(join(templateRoot, frameworkConfig.sentinelFile)))) {
|
|
215
|
+
throw new Error(`Docs app templates not found under ${templateRoot}`);
|
|
216
|
+
}
|
|
217
|
+
await ensureTargetWritable(appRoot);
|
|
218
|
+
await ensureDir(appRoot);
|
|
219
|
+
for (const templateFile of frameworkConfig.templateFiles) {
|
|
220
|
+
const source = join(templateRoot, templateFile.source);
|
|
221
|
+
const destination = join(appRoot, templateFile.destination);
|
|
222
|
+
const template = await readFile(source, 'utf8');
|
|
223
|
+
const rendered = renderTemplate(template, options, depContext);
|
|
224
|
+
await ensureDir(dirname(destination));
|
|
225
|
+
await writeFile(destination, rendered, 'utf8');
|
|
226
|
+
createdFiles.push(templateFile.destination);
|
|
227
|
+
}
|
|
228
|
+
return {
|
|
229
|
+
appRoot,
|
|
230
|
+
createdFiles,
|
|
231
|
+
documentationConfig: buildDocumentationConfig(options.framework, options.targetDir),
|
|
232
|
+
};
|
|
233
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codemod.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/migrate/codemod.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAqBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA8CjE"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
const ADMONITION_TYPE_MAP = {
|
|
2
|
+
note: 'NOTE',
|
|
3
|
+
info: 'NOTE',
|
|
4
|
+
abstract: 'NOTE',
|
|
5
|
+
question: 'NOTE',
|
|
6
|
+
quote: 'NOTE',
|
|
7
|
+
warning: 'WARNING',
|
|
8
|
+
tip: 'TIP',
|
|
9
|
+
success: 'TIP',
|
|
10
|
+
example: 'TIP',
|
|
11
|
+
important: 'IMPORTANT',
|
|
12
|
+
caution: 'CAUTION',
|
|
13
|
+
danger: 'CAUTION',
|
|
14
|
+
failure: 'CAUTION',
|
|
15
|
+
bug: 'CAUTION',
|
|
16
|
+
};
|
|
17
|
+
const ADMONITION_RE = /^(?:!!!|\?\?\?)\s+(\w+)(?:\s+"([^"]*)")?\s*$/;
|
|
18
|
+
export function convertAdmonitions(content) {
|
|
19
|
+
const lines = content.split('\n');
|
|
20
|
+
const output = [];
|
|
21
|
+
let admonitionsConverted = 0;
|
|
22
|
+
let i = 0;
|
|
23
|
+
while (i < lines.length) {
|
|
24
|
+
const match = ADMONITION_RE.exec(lines[i]);
|
|
25
|
+
if (!match) {
|
|
26
|
+
output.push(lines[i]);
|
|
27
|
+
i++;
|
|
28
|
+
continue;
|
|
29
|
+
}
|
|
30
|
+
const typeName = match[1].toLowerCase();
|
|
31
|
+
const title = match[2] ?? undefined;
|
|
32
|
+
const gfmType = ADMONITION_TYPE_MAP[typeName] ?? 'NOTE';
|
|
33
|
+
const header = title ? `> [!${gfmType}] ${title}` : `> [!${gfmType}]`;
|
|
34
|
+
output.push(header);
|
|
35
|
+
admonitionsConverted++;
|
|
36
|
+
i++;
|
|
37
|
+
while (i < lines.length) {
|
|
38
|
+
const line = lines[i];
|
|
39
|
+
if (line.startsWith(' ')) {
|
|
40
|
+
output.push(`> ${line.slice(4)}`);
|
|
41
|
+
i++;
|
|
42
|
+
}
|
|
43
|
+
else if (line === '') {
|
|
44
|
+
// Check if next line is indented (continuation)
|
|
45
|
+
if (i + 1 < lines.length && lines[i + 1].startsWith(' ')) {
|
|
46
|
+
output.push('>');
|
|
47
|
+
i++;
|
|
48
|
+
}
|
|
49
|
+
else {
|
|
50
|
+
break;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
else {
|
|
54
|
+
break;
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
return {
|
|
59
|
+
content: output.join('\n'),
|
|
60
|
+
admonitionsConverted,
|
|
61
|
+
};
|
|
62
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export interface FrontmatterResult {
|
|
2
|
+
content: string;
|
|
3
|
+
titleInjected: boolean;
|
|
4
|
+
descriptionSeeded: boolean;
|
|
5
|
+
}
|
|
6
|
+
interface FrontmatterOptions {
|
|
7
|
+
mkdocsTitle?: string;
|
|
8
|
+
fileName: string;
|
|
9
|
+
}
|
|
10
|
+
export declare function injectFrontmatter(content: string, options: FrontmatterOptions): FrontmatterResult;
|
|
11
|
+
export {};
|
|
12
|
+
//# sourceMappingURL=frontmatter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/migrate/frontmatter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,UAAU,kBAAkB;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA2BD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CA4CnB"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n/;
|
|
2
|
+
const HEADING_RE = /^#\s+(.+)$/m;
|
|
3
|
+
function fileNameToTitle(fileName) {
|
|
4
|
+
return fileName
|
|
5
|
+
.replace(/\.md$/, '')
|
|
6
|
+
.split(/[-_]/g)
|
|
7
|
+
.filter(Boolean)
|
|
8
|
+
.map((part) => part.charAt(0).toUpperCase() + part.slice(1))
|
|
9
|
+
.join(' ');
|
|
10
|
+
}
|
|
11
|
+
function resolveTitle(content, options) {
|
|
12
|
+
if (options.mkdocsTitle) {
|
|
13
|
+
return options.mkdocsTitle;
|
|
14
|
+
}
|
|
15
|
+
const headingMatch = HEADING_RE.exec(content);
|
|
16
|
+
if (headingMatch) {
|
|
17
|
+
return headingMatch[1].trim();
|
|
18
|
+
}
|
|
19
|
+
return fileNameToTitle(options.fileName);
|
|
20
|
+
}
|
|
21
|
+
export function injectFrontmatter(content, options) {
|
|
22
|
+
const frontmatterMatch = FRONTMATTER_RE.exec(content);
|
|
23
|
+
if (frontmatterMatch) {
|
|
24
|
+
const frontmatter = frontmatterMatch[1];
|
|
25
|
+
const hasTitle = /^title:/m.test(frontmatter);
|
|
26
|
+
const hasDescription = /^description:/m.test(frontmatter);
|
|
27
|
+
if (hasTitle && hasDescription) {
|
|
28
|
+
return { content, titleInjected: false, descriptionSeeded: false };
|
|
29
|
+
}
|
|
30
|
+
let updatedFrontmatter = frontmatter;
|
|
31
|
+
let titleInjected = false;
|
|
32
|
+
let descriptionSeeded = false;
|
|
33
|
+
if (!hasTitle) {
|
|
34
|
+
const title = resolveTitle(content, options);
|
|
35
|
+
updatedFrontmatter = `title: ${title}\n${updatedFrontmatter}`;
|
|
36
|
+
titleInjected = true;
|
|
37
|
+
}
|
|
38
|
+
if (!hasDescription) {
|
|
39
|
+
updatedFrontmatter = `${updatedFrontmatter}\ndescription: ""`;
|
|
40
|
+
descriptionSeeded = true;
|
|
41
|
+
}
|
|
42
|
+
return {
|
|
43
|
+
content: content.replace(frontmatterMatch[0], `---\n${updatedFrontmatter}\n---\n`),
|
|
44
|
+
titleInjected,
|
|
45
|
+
descriptionSeeded,
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
// No frontmatter — create one
|
|
49
|
+
const title = resolveTitle(content, options);
|
|
50
|
+
return {
|
|
51
|
+
content: `---\ntitle: ${title}\ndescription: ""\n---\n\n${content}`,
|
|
52
|
+
titleInjected: true,
|
|
53
|
+
descriptionSeeded: true,
|
|
54
|
+
};
|
|
55
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
|
|
2
|
+
import { Command } from 'commander';
|
|
3
|
+
interface MigrateFileDependencies {
|
|
4
|
+
readFile: (path: string, encoding: BufferEncoding) => Promise<string>;
|
|
5
|
+
writeFile: (path: string, content: string, encoding: BufferEncoding) => Promise<void>;
|
|
6
|
+
readdir: (path: string, options: {
|
|
7
|
+
withFileTypes: true;
|
|
8
|
+
recursive: true;
|
|
9
|
+
}) => Promise<import('node:fs').Dirent[]>;
|
|
10
|
+
fileExists: (path: string) => Promise<boolean>;
|
|
11
|
+
}
|
|
12
|
+
interface MigrateDependencies {
|
|
13
|
+
buildCommandContext: (options: GlobalOptions) => CommandContext;
|
|
14
|
+
fileDeps: MigrateFileDependencies;
|
|
15
|
+
}
|
|
16
|
+
export declare function createDocsMigrateCommand(overrides?: Partial<MigrateDependencies>): Command;
|
|
17
|
+
export {};
|
|
18
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/migrate/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAW5C,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,SAAS,EAAE,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,aAAa,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,KAC9C,OAAO,CAAC,OAAO,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED,UAAU,mBAAmB;IAC3B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,QAAQ,EAAE,uBAAuB,CAAC;CACnC;AA0JD,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC3C,OAAO,CAyBT"}
|