groundwork-method 0.0.1 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +781 -0
- package/LICENSE +21 -0
- package/README.md +44 -29
- package/bin/groundwork.js +1654 -0
- package/dist/src/generators/add-capability/generator.d.ts +8 -0
- package/dist/src/generators/add-capability/generator.js +60 -0
- package/dist/src/generators/add-capability/generator.js.map +1 -0
- package/dist/src/generators/cli-app/generator.d.ts +9 -0
- package/dist/src/generators/cli-app/generator.js +140 -0
- package/dist/src/generators/cli-app/generator.js.map +1 -0
- package/dist/src/generators/docs-site/generator.d.ts +5 -0
- package/dist/src/generators/docs-site/generator.js +441 -0
- package/dist/src/generators/docs-site/generator.js.map +1 -0
- package/dist/src/generators/electron-app/generator.d.ts +6 -0
- package/dist/src/generators/electron-app/generator.js +261 -0
- package/dist/src/generators/electron-app/generator.js.map +1 -0
- package/dist/src/generators/flutter-app/generator.d.ts +6 -0
- package/dist/src/generators/flutter-app/generator.js +314 -0
- package/dist/src/generators/flutter-app/generator.js.map +1 -0
- package/dist/src/generators/go-microservice/generator.d.ts +8 -0
- package/dist/src/generators/go-microservice/generator.js +232 -0
- package/dist/src/generators/go-microservice/generator.js.map +1 -0
- package/dist/src/generators/nextjs-app/generator.d.ts +8 -0
- package/dist/src/generators/nextjs-app/generator.js +294 -0
- package/dist/src/generators/nextjs-app/generator.js.map +1 -0
- package/dist/src/generators/python-microservice/generator.d.ts +13 -0
- package/dist/src/generators/python-microservice/generator.js +265 -0
- package/dist/src/generators/python-microservice/generator.js.map +1 -0
- package/dist/src/generators/shared/brand-tokens.d.ts +89 -0
- package/dist/src/generators/shared/brand-tokens.js +308 -0
- package/dist/src/generators/shared/brand-tokens.js.map +1 -0
- package/dist/src/generators/shared/capabilities.d.ts +101 -0
- package/dist/src/generators/shared/capabilities.js +279 -0
- package/dist/src/generators/shared/capabilities.js.map +1 -0
- package/dist/src/generators/shared/provenance.d.ts +2 -0
- package/dist/src/generators/shared/provenance.js +85 -0
- package/dist/src/generators/shared/provenance.js.map +1 -0
- package/dist/src/generators/shared/scaffold-helpers.d.ts +72 -0
- package/dist/src/generators/shared/scaffold-helpers.js +309 -0
- package/dist/src/generators/shared/scaffold-helpers.js.map +1 -0
- package/dist/src/generators/system-test-runner/generator.d.ts +23 -0
- package/dist/src/generators/system-test-runner/generator.js +125 -0
- package/dist/src/generators/system-test-runner/generator.js.map +1 -0
- package/dist/src/generators/workspace-dev-cli/generator.d.ts +7 -0
- package/dist/src/generators/workspace-dev-cli/generator.js +138 -0
- package/dist/src/generators/workspace-dev-cli/generator.js.map +1 -0
- package/generators.json +57 -0
- package/lib/repo-map/grammars/tree-sitter-c.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-cpp.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-csharp.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-dart.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-go.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-java.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-javascript.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-kotlin.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-lua.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-php.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-python.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-ruby.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-rust.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-scala.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-swift.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-tsx.wasm +0 -0
- package/lib/repo-map/grammars/tree-sitter-typescript.wasm +0 -0
- package/lib/repo-map/index.js +386 -0
- package/lib/repo-map/languages.js +514 -0
- package/lib/repo-map/pagerank.js +59 -0
- package/migrations/README.md +60 -0
- package/migrations/_template/cli-migration.js +27 -0
- package/migrations/gw-bet-prose-redesign.js +105 -0
- package/migrations/gw-drop-test-manifest.js +37 -0
- package/migrations/gw-register-serena-mcp.js +42 -0
- package/migrations/gw-relocate-hidden-skills.js +40 -0
- package/migrations/gw-seed-config-toml.js +24 -0
- package/migrations/index.json +40 -0
- package/package.json +70 -6
- package/src/AGENTS.md +36 -0
- package/src/config/config.toml +30 -0
- package/src/config/groundwork-state.json +5 -0
- package/src/docs/llms.txt +72 -0
- package/src/docs/principles/ai-native/agent-native-systems.md +90 -0
- package/src/docs/principles/ai-native/agentic-systems.md +78 -0
- package/src/docs/principles/ai-native/ai-engineering.md +100 -0
- package/src/docs/principles/ai-native/ai-native-product.md +76 -0
- package/src/docs/principles/delivery/cost-engineering.md +89 -0
- package/src/docs/principles/delivery/day-2-operational-baseline.md +57 -0
- package/src/docs/principles/delivery/devex.md +88 -0
- package/src/docs/principles/delivery/platform.md +101 -0
- package/src/docs/principles/delivery/progressive-delivery.md +92 -0
- package/src/docs/principles/design/ai-native-design.md +73 -0
- package/src/docs/principles/design/design-foundations.md +80 -0
- package/src/docs/principles/design/design-systems-and-tokens.md +72 -0
- package/src/docs/principles/design/interaction-and-motion.md +69 -0
- package/src/docs/principles/design/layout-and-space.md +72 -0
- package/src/docs/principles/design/usability-and-ux.md +68 -0
- package/src/docs/principles/design/visual-design.md +84 -0
- package/src/docs/principles/foundations/code-craft.md +86 -0
- package/src/docs/principles/foundations/continuous-discovery.md +75 -0
- package/src/docs/principles/foundations/documentation.md +102 -0
- package/src/docs/principles/foundations/prioritization-and-appetite.md +78 -0
- package/src/docs/principles/foundations/product-engineering.md +90 -0
- package/src/docs/principles/foundations/product-risks.md +89 -0
- package/src/docs/principles/foundations/requirements-and-specs.md +80 -0
- package/src/docs/principles/foundations/success-metrics.md +66 -0
- package/src/docs/principles/foundations/testing.md +82 -0
- package/src/docs/principles/index.md +23 -0
- package/src/docs/principles/quality/accessibility.md +88 -0
- package/src/docs/principles/quality/observability.md +84 -0
- package/src/docs/principles/quality/performance.md +84 -0
- package/src/docs/principles/quality/privacy.md +92 -0
- package/src/docs/principles/quality/reliability.md +89 -0
- package/src/docs/principles/quality/security.md +78 -0
- package/src/docs/principles/stack/postgres.md +100 -0
- package/src/docs/principles/system-design/api-design.md +86 -0
- package/src/docs/principles/system-design/architecture-decisions.md +81 -0
- package/src/docs/principles/system-design/code-structure.md +104 -0
- package/src/docs/principles/system-design/data-engineering.md +87 -0
- package/src/docs/principles/system-design/durable-execution.md +89 -0
- package/src/docs/principles/system-design/evolutionary-architecture.md +81 -0
- package/src/docs/principles/system-design/identity-and-access.md +76 -0
- package/src/docs/principles/system-design/integration-patterns.md +84 -0
- package/src/docs/principles/system-design/real-time.md +83 -0
- package/src/docs/principles/system-design/surface-architecture.md +74 -0
- package/src/docs/ways-of-working/documentation.md +69 -0
- package/src/docs/ways-of-working/how-we-work.md +76 -0
- package/src/docs/ways-of-working/units-of-work.md +40 -0
- package/src/engineer-skills/groundwork-electron-engineer/SKILL.md +118 -0
- package/src/engineer-skills/groundwork-electron-engineer/references/ipc-contracts.md +138 -0
- package/src/engineer-skills/groundwork-electron-engineer/references/packaging-and-updates.md +82 -0
- package/src/engineer-skills/groundwork-electron-engineer/references/process-model.md +94 -0
- package/src/engineer-skills/groundwork-electron-engineer/references/security.md +107 -0
- package/src/engineer-skills/groundwork-electron-engineer/references/testing-and-smoke.md +107 -0
- package/src/engineer-skills/groundwork-electron-engineer/references/theming-and-tokens.md +74 -0
- package/src/engineer-skills/groundwork-electron-engineer/sync-anchor.md +14 -0
- package/src/engineer-skills/groundwork-flutter-engineer/SKILL.md +108 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/accessibility.md +92 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/architecture.md +189 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/data-and-contracts.md +136 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/navigation.md +122 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/platform-channels.md +93 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/releases-and-distribution.md +84 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/state-management.md +166 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/testing.md +135 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/theming-and-design-tokens.md +109 -0
- package/src/engineer-skills/groundwork-flutter-engineer/references/widgets-and-composition.md +123 -0
- package/src/engineer-skills/groundwork-flutter-engineer/sync-anchor.md +15 -0
- package/src/engineer-skills/groundwork-go-engineer/SKILL.md +171 -0
- package/src/engineer-skills/groundwork-go-engineer/references/api-design.md +82 -0
- package/src/engineer-skills/groundwork-go-engineer/references/architecture.md +42 -0
- package/src/engineer-skills/groundwork-go-engineer/references/capability-ports.md +50 -0
- package/src/engineer-skills/groundwork-go-engineer/references/code-craft-security.md +34 -0
- package/src/engineer-skills/groundwork-go-engineer/references/concurrency.md +108 -0
- package/src/engineer-skills/groundwork-go-engineer/references/go-services.md +77 -0
- package/src/engineer-skills/groundwork-go-engineer/references/http-handlers.md +172 -0
- package/src/engineer-skills/groundwork-go-engineer/references/implementation-patterns.md +156 -0
- package/src/engineer-skills/groundwork-go-engineer/references/integration-realtime-data.md +57 -0
- package/src/engineer-skills/groundwork-go-engineer/references/observability.md +49 -0
- package/src/engineer-skills/groundwork-go-engineer/references/postgres.md +41 -0
- package/src/engineer-skills/groundwork-go-engineer/references/reliability-performance.md +105 -0
- package/src/engineer-skills/groundwork-go-engineer/references/testing.md +139 -0
- package/src/engineer-skills/groundwork-go-engineer/sync-anchor.md +11 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/SKILL.md +107 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/architecture.md +323 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/data-fetching.md +458 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/documentation.md +324 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/error-boundaries.md +383 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/mutations-and-forms.md +396 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/performance-and-deployment.md +947 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/routing-and-navigation.md +405 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/server-components.md +394 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/tailwind-and-styling.md +134 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/testing.md +433 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/type-system.md +368 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/ux-principles.md +278 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/references/visual-language.md +69 -0
- package/src/engineer-skills/groundwork-nextjs-engineer/sync-anchor.md +9 -0
- package/src/engineer-skills/groundwork-python-engineer/SKILL.md +196 -0
- package/src/engineer-skills/groundwork-python-engineer/references/api-standards.md +88 -0
- package/src/engineer-skills/groundwork-python-engineer/references/architecture.md +57 -0
- package/src/engineer-skills/groundwork-python-engineer/references/async-patterns.md +103 -0
- package/src/engineer-skills/groundwork-python-engineer/references/capability-ports.md +44 -0
- package/src/engineer-skills/groundwork-python-engineer/references/database.md +88 -0
- package/src/engineer-skills/groundwork-python-engineer/references/documentation-mcp.md +167 -0
- package/src/engineer-skills/groundwork-python-engineer/references/implementation-patterns.md +166 -0
- package/src/engineer-skills/groundwork-python-engineer/references/ml-pipelines.md +119 -0
- package/src/engineer-skills/groundwork-python-engineer/references/ml-systems-ai-engineering.md +74 -0
- package/src/engineer-skills/groundwork-python-engineer/references/observability.md +57 -0
- package/src/engineer-skills/groundwork-python-engineer/references/resilience.md +126 -0
- package/src/engineer-skills/groundwork-python-engineer/references/testing.md +177 -0
- package/src/engineer-skills/groundwork-python-engineer/sync-anchor.md +13 -0
- package/src/generators/add-capability/generator.ts +70 -0
- package/src/generators/add-capability/schema.json +30 -0
- package/src/generators/capabilities/llm/capability.json +28 -0
- package/src/generators/capabilities/llm/providers/anthropic/footprint.json +13 -0
- package/src/generators/capabilities/llm/providers/anthropic/stacks/go/internal/llm/llm.go.template +102 -0
- package/src/generators/capabilities/llm/providers/anthropic/stacks/python/src/__packageName__/adapters/llm.py.template +61 -0
- package/src/generators/capabilities/llm/providers/local/footprint.json +13 -0
- package/src/generators/capabilities/llm/providers/local/stacks/go/internal/llm/llm.go.template +102 -0
- package/src/generators/capabilities/llm/providers/local/stacks/python/src/__packageName__/adapters/llm.py.template +53 -0
- package/src/generators/capabilities/llm/providers/localai/footprint.json +29 -0
- package/src/generators/capabilities/llm/providers/localai/stacks/go/internal/llm/llm.go.template +102 -0
- package/src/generators/capabilities/llm/providers/localai/stacks/python/src/__packageName__/adapters/llm.py.template +53 -0
- package/src/generators/capabilities/llm/providers/none/footprint.json +9 -0
- package/src/generators/capabilities/llm/providers/none/stacks/go/internal/llm/llm.go.template +35 -0
- package/src/generators/capabilities/llm/providers/none/stacks/python/src/__packageName__/adapters/llm.py.template +25 -0
- package/src/generators/capabilities/llm/providers/ollama/footprint.json +20 -0
- package/src/generators/capabilities/llm/providers/ollama/stacks/go/internal/llm/llm.go.template +102 -0
- package/src/generators/capabilities/llm/providers/ollama/stacks/python/src/__packageName__/adapters/llm.py.template +53 -0
- package/src/generators/capabilities/llm/providers/openai/footprint.json +13 -0
- package/src/generators/capabilities/llm/providers/openai/stacks/go/internal/llm/llm.go.template +98 -0
- package/src/generators/capabilities/llm/providers/openai/stacks/python/src/__packageName__/adapters/llm.py.template +60 -0
- package/src/generators/capabilities/llm/stacks/go/internal/core/service/llm.go.template +12 -0
- package/src/generators/capabilities/llm/stacks/go/internal/llm/llm_test.go.template +33 -0
- package/src/generators/capabilities/llm/stacks/python/src/__packageName__/core/llm.py.template +15 -0
- package/src/generators/capabilities/llm/stacks/python/tests/contracts/test_llm.py.template +37 -0
- package/src/generators/cli-app/files/README.md.template +76 -0
- package/src/generators/cli-app/files/build.mjs.template +15 -0
- package/src/generators/cli-app/files/package.json.template +21 -0
- package/src/generators/cli-app/files/src/cli.ts.template +67 -0
- package/src/generators/cli-app/files/src/commands/hello.ts.template +17 -0
- package/src/generators/cli-app/files/src/commands/status.ts.template +23 -0
- package/src/generators/cli-app/files/src/core/client.test.ts.template +80 -0
- package/src/generators/cli-app/files/src/core/client.ts.template +64 -0
- package/src/generators/cli-app/files/src/registry.test.ts.template +35 -0
- package/src/generators/cli-app/files/src/registry.ts.template +31 -0
- package/src/generators/cli-app/files/tsconfig.json.template +16 -0
- package/src/generators/cli-app/files/tsconfig.test.json.template +11 -0
- package/src/generators/cli-app/generator.ts +138 -0
- package/src/generators/cli-app/schema.json +24 -0
- package/src/generators/docs-site/files/.gitignore.ejs +40 -0
- package/src/generators/docs-site/files/app/docs/__slug__/page.tsx +101 -0
- package/src/generators/docs-site/files/app/docs/layout.tsx +14 -0
- package/src/generators/docs-site/files/app/docs.css +43 -0
- package/src/generators/docs-site/files/app/layout.tsx +24 -0
- package/src/generators/docs-site/files/app/page.tsx +135 -0
- package/src/generators/docs-site/files/app/source.ts +8 -0
- package/src/generators/docs-site/files/components/mermaid.tsx +67 -0
- package/src/generators/docs-site/files/next.config.mjs +10 -0
- package/src/generators/docs-site/files/package.json +32 -0
- package/src/generators/docs-site/files/pnpm-workspace.yaml +7 -0
- package/src/generators/docs-site/files/postcss.config.mjs +6 -0
- package/src/generators/docs-site/files/source.config.ts +77 -0
- package/src/generators/docs-site/files/tailwind.config.js +10 -0
- package/src/generators/docs-site/files/tsconfig.json +27 -0
- package/src/generators/docs-site/generator.ts +476 -0
- package/src/generators/docs-site/schema.json +17 -0
- package/src/generators/electron-app/docs/principles/stack/electron/index.md +47 -0
- package/src/generators/electron-app/docs/principles/stack/electron/ipc-contracts.md +71 -0
- package/src/generators/electron-app/docs/principles/stack/electron/packaging-and-updates.md +59 -0
- package/src/generators/electron-app/docs/principles/stack/electron/process-model.md +53 -0
- package/src/generators/electron-app/docs/principles/stack/electron/security.md +70 -0
- package/src/generators/electron-app/docs/principles/stack/typescript/frontend.md +65 -0
- package/src/generators/electron-app/files/.gitignore.template +20 -0
- package/src/generators/electron-app/files/README.md.template +125 -0
- package/src/generators/electron-app/files/electron.vite.config.ts +31 -0
- package/src/generators/electron-app/files/eslint.config.mjs +92 -0
- package/src/generators/electron-app/files/forge.config.ts.template +44 -0
- package/src/generators/electron-app/files/package.json.template +54 -0
- package/src/generators/electron-app/files/playwright.config.ts +18 -0
- package/src/generators/electron-app/files/project.json.template +65 -0
- package/src/generators/electron-app/files/src/main/core-client.test.ts +81 -0
- package/src/generators/electron-app/files/src/main/core-client.ts +55 -0
- package/src/generators/electron-app/files/src/main/index.ts +157 -0
- package/src/generators/electron-app/files/src/main/ipc.ts +52 -0
- package/src/generators/electron-app/files/src/main/policy.test.ts +71 -0
- package/src/generators/electron-app/files/src/main/policy.ts +73 -0
- package/src/generators/electron-app/files/src/preload/index.ts +23 -0
- package/src/generators/electron-app/files/src/renderer/index.html.template +20 -0
- package/src/generators/electron-app/files/src/renderer/src/App.test.tsx +61 -0
- package/src/generators/electron-app/files/src/renderer/src/App.tsx.template +43 -0
- package/src/generators/electron-app/files/src/renderer/src/assets/main.css +40 -0
- package/src/generators/electron-app/files/src/renderer/src/env.d.ts +14 -0
- package/src/generators/electron-app/files/src/renderer/src/main.tsx +25 -0
- package/src/generators/electron-app/files/src/shared/ipc.ts +54 -0
- package/src/generators/electron-app/files/tests/smoke/app.spec.ts.template +68 -0
- package/src/generators/electron-app/files/tool/electron_exec.sh.template +83 -0
- package/src/generators/electron-app/files/tsconfig.json +7 -0
- package/src/generators/electron-app/files/tsconfig.node.json +27 -0
- package/src/generators/electron-app/files/tsconfig.web.json +22 -0
- package/src/generators/electron-app/files/vitest.config.ts +32 -0
- package/src/generators/electron-app/files/vitest.setup.ts +1 -0
- package/src/generators/electron-app/generator.ts +288 -0
- package/src/generators/electron-app/schema.json +23 -0
- package/src/generators/flutter-app/docs/principles/stack/flutter/architecture.md +78 -0
- package/src/generators/flutter-app/docs/principles/stack/flutter/index.md +38 -0
- package/src/generators/flutter-app/docs/principles/stack/flutter/platform-channels.md +51 -0
- package/src/generators/flutter-app/docs/principles/stack/flutter/releases-and-distribution.md +59 -0
- package/src/generators/flutter-app/docs/principles/stack/flutter/state-management.md +85 -0
- package/src/generators/flutter-app/docs/principles/stack/flutter/testing.md +74 -0
- package/src/generators/flutter-app/docs/principles/stack/flutter/widgets-and-composition.md +69 -0
- package/src/generators/flutter-app/files/.gitignore.template +30 -0
- package/src/generators/flutter-app/files/README.md.template +100 -0
- package/src/generators/flutter-app/files/analysis_options.yaml.template +18 -0
- package/src/generators/flutter-app/files/integration_test/app_test.dart.template +30 -0
- package/src/generators/flutter-app/files/lib/app.dart.template +24 -0
- package/src/generators/flutter-app/files/lib/config/app_config.dart +15 -0
- package/src/generators/flutter-app/files/lib/data/repositories/status_repository.dart +36 -0
- package/src/generators/flutter-app/files/lib/data/services/api_client.dart +71 -0
- package/src/generators/flutter-app/files/lib/domain/models/health_status.dart +23 -0
- package/src/generators/flutter-app/files/lib/main.dart +11 -0
- package/src/generators/flutter-app/files/lib/router.dart +23 -0
- package/src/generators/flutter-app/files/lib/ui/core/theme/app_theme.dart +110 -0
- package/src/generators/flutter-app/files/lib/ui/home/home_view.dart +89 -0
- package/src/generators/flutter-app/files/lib/ui/home/home_view_model.dart.template +38 -0
- package/src/generators/flutter-app/files/project.json.template +51 -0
- package/src/generators/flutter-app/files/pubspec.yaml.template +47 -0
- package/src/generators/flutter-app/files/test/api_client_test.dart.template +63 -0
- package/src/generators/flutter-app/files/test/fakes/fake_status_repository.dart.template +19 -0
- package/src/generators/flutter-app/files/test/home_view_test.dart.template +58 -0
- package/src/generators/flutter-app/files/tool/flutter_exec.sh.template +60 -0
- package/src/generators/flutter-app/generator.ts +362 -0
- package/src/generators/flutter-app/schema.json +23 -0
- package/src/generators/go-microservice/docs/principles/stack/go/concurrency.md +123 -0
- package/src/generators/go-microservice/docs/principles/stack/go/index.md +70 -0
- package/src/generators/go-microservice/docs/principles/stack/go/testing.md +152 -0
- package/src/generators/go-microservice/files/.air.toml.template +38 -0
- package/src/generators/go-microservice/files/.env.template +4 -0
- package/src/generators/go-microservice/files/.golangci.yml.template +82 -0
- package/src/generators/go-microservice/files/Dockerfile.dev.template +12 -0
- package/src/generators/go-microservice/files/asyncapi-pubsub.yaml.template +33 -0
- package/src/generators/go-microservice/files/asyncapi-ws.yaml.template +34 -0
- package/src/generators/go-microservice/files/cmd/api/main.go.template +149 -0
- package/src/generators/go-microservice/files/cmd/api/main_test.go.template +99 -0
- package/src/generators/go-microservice/files/cmd/worker/cleanup/main.go.template +39 -0
- package/src/generators/go-microservice/files/db/schema.sql.template +24 -0
- package/src/generators/go-microservice/files/go.mod.template +39 -0
- package/src/generators/go-microservice/files/internal/config/config.go.template +52 -0
- package/src/generators/go-microservice/files/internal/config/otel.go.template +93 -0
- package/src/generators/go-microservice/files/internal/core/domain/errors.go.template +16 -0
- package/src/generators/go-microservice/files/internal/core/domain/model.go.template +28 -0
- package/src/generators/go-microservice/files/internal/core/domain/user.go.template +13 -0
- package/src/generators/go-microservice/files/internal/core/pagination.go.template +16 -0
- package/src/generators/go-microservice/files/internal/core/service/app_service.go.template +79 -0
- package/src/generators/go-microservice/files/internal/core/service/event_hub.go.template +9 -0
- package/src/generators/go-microservice/files/internal/core/service/message_queue.go.template +10 -0
- package/src/generators/go-microservice/files/internal/core/service/outbox_repository.go.template +31 -0
- package/src/generators/go-microservice/files/internal/core/service/repository.go.template +23 -0
- package/src/generators/go-microservice/files/internal/core/service/user_repository.go.template +15 -0
- package/src/generators/go-microservice/files/internal/core/service/user_service.go.template +43 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/app_handler.go.template +108 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/auth_middleware_test.go.template +52 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/clerk_webhook.go.template +202 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/clerk_webhook_test.go.template +82 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/health_handler.go.template +80 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/idempotency/middleware.go.template +87 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/idempotency/middleware_test.go.template +76 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/idempotency/repository.go.template +37 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/middleware_auth.go.template +40 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/middleware_loadshed.go.template +38 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/middleware_logging.go.template +40 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/middleware_ratelimit.go.template +48 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/middleware_test.go.template +81 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/router.go.template +105 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/types.go.template +70 -0
- package/src/generators/go-microservice/files/internal/entrypoints/api/websocket_handler.go.template +39 -0
- package/src/generators/go-microservice/files/internal/httpclient/http_client.go.template +87 -0
- package/src/generators/go-microservice/files/internal/kafka/kafka.go.template +34 -0
- package/src/generators/go-microservice/files/internal/postgres/postgres.go.template +195 -0
- package/src/generators/go-microservice/files/internal/postgres/postgres_test.go.template +156 -0
- package/src/generators/go-microservice/files/internal/postgres/user_repository.go.template +56 -0
- package/src/generators/go-microservice/files/internal/pubsub/gcp_pubsub.go.template +35 -0
- package/src/generators/go-microservice/files/internal/websocket/client.go.template +151 -0
- package/src/generators/go-microservice/files/internal/websocket/hub.go.template +261 -0
- package/src/generators/go-microservice/files/scripts/apply-schema.sh.template +21 -0
- package/src/generators/go-microservice/files/tools/tools.go.template +10 -0
- package/src/generators/go-microservice/generator.ts +240 -0
- package/src/generators/go-microservice/schema.json +63 -0
- package/src/generators/nextjs-app/docs/principles/stack/typescript/frontend.md +65 -0
- package/src/generators/nextjs-app/files/.dockerignore.template +7 -0
- package/src/generators/nextjs-app/files/.env.example.template +24 -0
- package/src/generators/nextjs-app/files/.gitignore.template +5 -0
- package/src/generators/nextjs-app/files/Dockerfile +53 -0
- package/src/generators/nextjs-app/files/app/(auth)/sign-in/__sign-in__/page.tsx.template +9 -0
- package/src/generators/nextjs-app/files/app/(auth)/sign-up/__sign-up__/page.tsx.template +9 -0
- package/src/generators/nextjs-app/files/app/api/config/route.ts.template +39 -0
- package/src/generators/nextjs-app/files/app/api/healthz/route.test.ts +15 -0
- package/src/generators/nextjs-app/files/app/api/healthz/route.ts +5 -0
- package/src/generators/nextjs-app/files/app/api/proxy/__path__/route.test.ts.template +55 -0
- package/src/generators/nextjs-app/files/app/api/proxy/__path__/route.ts.template +126 -0
- package/src/generators/nextjs-app/files/app/error.tsx +39 -0
- package/src/generators/nextjs-app/files/app/global-error.tsx +68 -0
- package/src/generators/nextjs-app/files/app/globals.css +105 -0
- package/src/generators/nextjs-app/files/app/layout.tsx +59 -0
- package/src/generators/nextjs-app/files/app/loading.tsx +13 -0
- package/src/generators/nextjs-app/files/app/not-found.tsx +30 -0
- package/src/generators/nextjs-app/files/app/page.tsx +20 -0
- package/src/generators/nextjs-app/files/components/providers/default.tsx +19 -0
- package/src/generators/nextjs-app/files/components/providers/production.tsx +32 -0
- package/src/generators/nextjs-app/files/components/providers/telemetry.tsx +76 -0
- package/src/generators/nextjs-app/files/components/render-smoke.test.tsx +29 -0
- package/src/generators/nextjs-app/files/components/theme-provider.tsx +11 -0
- package/src/generators/nextjs-app/files/components.json +21 -0
- package/src/generators/nextjs-app/files/eslint.config.mjs +120 -0
- package/src/generators/nextjs-app/files/hooks/use-toast.ts +7 -0
- package/src/generators/nextjs-app/files/instrumentation.ts +90 -0
- package/src/generators/nextjs-app/files/lib/api/fetcher.ts.template +130 -0
- package/src/generators/nextjs-app/files/lib/config.ts +21 -0
- package/src/generators/nextjs-app/files/lib/logger.ts +29 -0
- package/src/generators/nextjs-app/files/lib/schemas/index.ts +19 -0
- package/src/generators/nextjs-app/files/lib/utils.ts +6 -0
- package/src/generators/nextjs-app/files/next.config.mjs +9 -0
- package/src/generators/nextjs-app/files/package.json +70 -0
- package/src/generators/nextjs-app/files/postcss.config.mjs +8 -0
- package/src/generators/nextjs-app/files/proxy.test.ts.template +30 -0
- package/src/generators/nextjs-app/files/proxy.ts +31 -0
- package/src/generators/nextjs-app/files/public/.gitkeep +1 -0
- package/src/generators/nextjs-app/files/tsconfig.json +42 -0
- package/src/generators/nextjs-app/files/vitest.config.mts +15 -0
- package/src/generators/nextjs-app/files/vitest.setup.ts +7 -0
- package/src/generators/nextjs-app/generator.ts +307 -0
- package/src/generators/nextjs-app/schema.json +44 -0
- package/src/generators/python-microservice/docs/principles/stack/python/async.md +168 -0
- package/src/generators/python-microservice/docs/principles/stack/python/documentation.md +240 -0
- package/src/generators/python-microservice/docs/principles/stack/python/mcp.md +147 -0
- package/src/generators/python-microservice/docs/principles/stack/python/resilience.md +193 -0
- package/src/generators/python-microservice/docs/principles/stack/python/testing.md +281 -0
- package/src/generators/python-microservice/files/.env.example.template +30 -0
- package/src/generators/python-microservice/files/Dockerfile.template +36 -0
- package/src/generators/python-microservice/files/db/schema.sql.template +19 -0
- package/src/generators/python-microservice/files/pyproject.toml.template +76 -0
- package/src/generators/python-microservice/files/scripts/apply-schema.sh.template +25 -0
- package/src/generators/python-microservice/files/src/__packageName__/adapters/comfyui.py.template +87 -0
- package/src/generators/python-microservice/files/src/__packageName__/adapters/config.py.template +48 -0
- package/src/generators/python-microservice/files/src/__packageName__/adapters/database.py.template +21 -0
- package/src/generators/python-microservice/files/src/__packageName__/adapters/message_queue.py.template +29 -0
- package/src/generators/python-microservice/files/src/__packageName__/adapters/repository.py.template +130 -0
- package/src/generators/python-microservice/files/src/__packageName__/adapters/telemetry.py.template +68 -0
- package/src/generators/python-microservice/files/src/__packageName__/adapters/websocket_hub.py.template +36 -0
- package/src/generators/python-microservice/files/src/__packageName__/core/domain/entities.py.template +22 -0
- package/src/generators/python-microservice/files/src/__packageName__/core/domain/exceptions.py.template +43 -0
- package/src/generators/python-microservice/files/src/__packageName__/core/ports.py.template +42 -0
- package/src/generators/python-microservice/files/src/__packageName__/core/service/example_service.py.template +68 -0
- package/src/generators/python-microservice/files/src/__packageName__/entrypoints/api/dependencies.py.template +50 -0
- package/src/generators/python-microservice/files/src/__packageName__/entrypoints/api/middleware.py.template +131 -0
- package/src/generators/python-microservice/files/src/__packageName__/entrypoints/api/router.py.template +37 -0
- package/src/generators/python-microservice/files/src/__packageName__/entrypoints/api/websocket_handler.py.template +20 -0
- package/src/generators/python-microservice/files/src/__packageName__/entrypoints/worker/cleanup.py.template +35 -0
- package/src/generators/python-microservice/files/src/__packageName__/entrypoints/worker/worker.py.template +28 -0
- package/src/generators/python-microservice/files/src/__packageName__/main.py.template +108 -0
- package/src/generators/python-microservice/files/tests/test_main.py.template +74 -0
- package/src/generators/python-microservice/files/tests/test_middleware.py.template +109 -0
- package/src/generators/python-microservice/files/tests/test_worker.py.template +16 -0
- package/src/generators/python-microservice/generator.ts +286 -0
- package/src/generators/python-microservice/schema.json +86 -0
- package/src/generators/shared/brand-tokens.ts +301 -0
- package/src/generators/shared/capabilities.ts +349 -0
- package/src/generators/shared/provenance.ts +61 -0
- package/src/generators/shared/scaffold-helpers.ts +309 -0
- package/src/generators/system-test-runner/files/tests/bets/.gitkeep +0 -0
- package/src/generators/system-test-runner/files/tests/bets/_archive/.gitkeep +0 -0
- package/src/generators/system-test-runner/files/tests/conftest.py.template +503 -0
- package/src/generators/system-test-runner/files/tests/pyproject.toml.template +20 -0
- package/src/generators/system-test-runner/files/tests/system/pages/__init__.py.template +9 -0
- package/src/generators/system-test-runner/files/tests/system/pages/base_page.py.template +36 -0
- package/src/generators/system-test-runner/files/tests/system/test_a11y_smoke.py.template +132 -0
- package/src/generators/system-test-runner/files/tests/system/test_contract_conformance.py.template +140 -0
- package/src/generators/system-test-runner/files/tests/system/test_layout_geometry.py.template +109 -0
- package/src/generators/system-test-runner/files/tests/system/test_render_smoke.py.template +227 -0
- package/src/generators/system-test-runner/files/tests/system/test_system.py.template +158 -0
- package/src/generators/system-test-runner/files/tests/system/test_token_conformance.py.template +206 -0
- package/src/generators/system-test-runner/files/tests/system/test_visual_regression.py.template +104 -0
- package/src/generators/system-test-runner/generator.ts +142 -0
- package/src/generators/system-test-runner/schema.json +24 -0
- package/src/generators/workspace-dev-cli/cli-src/build.mjs +42 -0
- package/src/generators/workspace-dev-cli/cli-src/dist/dev-bundle.js +2168 -0
- package/src/generators/workspace-dev-cli/cli-src/src/commands/bet.ts +442 -0
- package/src/generators/workspace-dev-cli/cli-src/src/commands/completion.ts +87 -0
- package/src/generators/workspace-dev-cli/cli-src/src/commands/doctor.ts +139 -0
- package/src/generators/workspace-dev-cli/cli-src/src/commands/lifecycle.ts +548 -0
- package/src/generators/workspace-dev-cli/cli-src/src/commands/quality.ts +127 -0
- package/src/generators/workspace-dev-cli/cli-src/src/commands/surface.ts +214 -0
- package/src/generators/workspace-dev-cli/cli-src/src/index.ts +127 -0
- package/src/generators/workspace-dev-cli/cli-src/src/registry.ts +194 -0
- package/src/generators/workspace-dev-cli/cli-src/src/theme/color.ts +130 -0
- package/src/generators/workspace-dev-cli/cli-src/src/theme/render.ts +158 -0
- package/src/generators/workspace-dev-cli/cli-src/src/theme/tokens.ts +122 -0
- package/src/generators/workspace-dev-cli/cli-src/src/util/context.ts +43 -0
- package/src/generators/workspace-dev-cli/cli-src/src/util/extensions.ts +99 -0
- package/src/generators/workspace-dev-cli/cli-src/src/util/paths.ts +46 -0
- package/src/generators/workspace-dev-cli/cli-src/src/util/proc.ts +106 -0
- package/src/generators/workspace-dev-cli/cli-src/src/util/prompt.ts +108 -0
- package/src/generators/workspace-dev-cli/cli-src/src/util/runners.ts +70 -0
- package/src/generators/workspace-dev-cli/cli-src/src/util/services.ts +221 -0
- package/src/generators/workspace-dev-cli/cli-src/src/util/version.ts +21 -0
- package/src/generators/workspace-dev-cli/cli-src/tsconfig.json +16 -0
- package/src/generators/workspace-dev-cli/files/.agents/skills/workspace-cli/SKILL.md.template +74 -0
- package/src/generators/workspace-dev-cli/files/dev.template +16 -0
- package/src/generators/workspace-dev-cli/files/docker-compose.yml.template +20 -0
- package/src/generators/workspace-dev-cli/files/scripts/cli/templates/milestone-test.pytmpl.template +46 -0
- package/src/generators/workspace-dev-cli/files/scripts/cli/templates/slice-test.pytmpl.template +38 -0
- package/src/generators/workspace-dev-cli/generator.ts +136 -0
- package/src/generators/workspace-dev-cli/schema.json +22 -0
- package/src/hidden-skills/code-intelligence.md +129 -0
- package/src/hidden-skills/groundwork-architect/SKILL.md +114 -0
- package/src/hidden-skills/groundwork-architect/references/agentic-systems.md +44 -0
- package/src/hidden-skills/groundwork-architect/references/ai-native-architecture.md +37 -0
- package/src/hidden-skills/groundwork-architect/references/api-and-contracts.md +45 -0
- package/src/hidden-skills/groundwork-architect/references/core-and-boundaries.md +45 -0
- package/src/hidden-skills/groundwork-architect/references/data-architecture.md +33 -0
- package/src/hidden-skills/groundwork-architect/references/decision-records.md +34 -0
- package/src/hidden-skills/groundwork-architect/references/durable-execution.md +45 -0
- package/src/hidden-skills/groundwork-architect/references/evolutionary-architecture.md +37 -0
- package/src/hidden-skills/groundwork-architect/references/identity-and-access.md +41 -0
- package/src/hidden-skills/groundwork-architect/references/integration-patterns.md +39 -0
- package/src/hidden-skills/groundwork-architect/references/observability.md +36 -0
- package/src/hidden-skills/groundwork-architect/references/performance-and-scale.md +41 -0
- package/src/hidden-skills/groundwork-architect/references/platform-and-delivery.md +47 -0
- package/src/hidden-skills/groundwork-architect/references/realtime-and-async.md +28 -0
- package/src/hidden-skills/groundwork-architect/references/reliability.md +31 -0
- package/src/hidden-skills/groundwork-architect/references/security-and-trust.md +47 -0
- package/src/hidden-skills/groundwork-architect/references/surface-architecture.md +40 -0
- package/src/hidden-skills/groundwork-architect/sync-anchor.md +34 -0
- package/src/hidden-skills/groundwork-architecture/architecture-template.md +50 -0
- package/src/hidden-skills/groundwork-architecture/instructions.md +139 -0
- package/src/hidden-skills/groundwork-architecture/phases/01-context-ingestion.md +18 -0
- package/src/hidden-skills/groundwork-architecture/phases/02-technical-constraints.md +27 -0
- package/src/hidden-skills/groundwork-architecture/phases/03-service-design.md +19 -0
- package/src/hidden-skills/groundwork-architecture/phases/04-data-flow-communication.md +23 -0
- package/src/hidden-skills/groundwork-architecture/phases/05-component-boundaries-contracts.md +17 -0
- package/src/hidden-skills/groundwork-architecture/phases/06-draft-review-present.md +38 -0
- package/src/hidden-skills/groundwork-architecture/phases/07-commit.md +33 -0
- package/src/hidden-skills/groundwork-architecture/templates/architecture-cache.md +43 -0
- package/src/hidden-skills/groundwork-architecture-extract/instructions.md +163 -0
- package/src/hidden-skills/groundwork-architecture-extract/templates/architecture-extract-cache.md +21 -0
- package/src/hidden-skills/groundwork-bet/briefs/slice-worker.md +191 -0
- package/src/hidden-skills/groundwork-bet/instructions.md +88 -0
- package/src/hidden-skills/groundwork-bet/templates/bet-progress-test.md +126 -0
- package/src/hidden-skills/groundwork-bet/templates/change-proposal.md +38 -0
- package/src/hidden-skills/groundwork-bet/templates/decomposition/meta.json +4 -0
- package/src/hidden-skills/groundwork-bet/templates/decomposition/milestone-index.md +35 -0
- package/src/hidden-skills/groundwork-bet/templates/decomposition/slice.md +35 -0
- package/src/hidden-skills/groundwork-bet/templates/pitch.md +45 -0
- package/src/hidden-skills/groundwork-bet/templates/technical-design/01-ui-design.md +51 -0
- package/src/hidden-skills/groundwork-bet/templates/technical-design/02-data-flows.md +36 -0
- package/src/hidden-skills/groundwork-bet/templates/technical-design/03-api-design.md +90 -0
- package/src/hidden-skills/groundwork-bet/templates/technical-design/04-data-design.md +29 -0
- package/src/hidden-skills/groundwork-bet/workflows/01-discovery.md +198 -0
- package/src/hidden-skills/groundwork-bet/workflows/02-design.md +168 -0
- package/src/hidden-skills/groundwork-bet/workflows/03-decomposition.md +246 -0
- package/src/hidden-skills/groundwork-bet/workflows/04-delivery.md +193 -0
- package/src/hidden-skills/groundwork-bet/workflows/05-validation.md +199 -0
- package/src/hidden-skills/groundwork-design-system/instructions.md +125 -0
- package/src/hidden-skills/groundwork-design-system/templates/brand-tokens.md +182 -0
- package/src/hidden-skills/groundwork-design-system/templates/design-system-cache.md +64 -0
- package/src/hidden-skills/groundwork-design-system/tracks/_foundation.md +136 -0
- package/src/hidden-skills/groundwork-design-system/tracks/agentic-protocol.md +269 -0
- package/src/hidden-skills/groundwork-design-system/tracks/cli.md +355 -0
- package/src/hidden-skills/groundwork-design-system/tracks/graphical-ui.md +330 -0
- package/src/hidden-skills/groundwork-design-system-extract/instructions.md +124 -0
- package/src/hidden-skills/groundwork-design-system-extract/templates/design-system-extract-cache.md +19 -0
- package/src/hidden-skills/groundwork-designer/SKILL.md +108 -0
- package/src/hidden-skills/groundwork-designer/references/accessibility.md +33 -0
- package/src/hidden-skills/groundwork-designer/references/ai-native-design.md +37 -0
- package/src/hidden-skills/groundwork-designer/references/design-review.md +29 -0
- package/src/hidden-skills/groundwork-designer/references/design-systems-and-tokens.md +33 -0
- package/src/hidden-skills/groundwork-designer/references/interaction-and-motion.md +37 -0
- package/src/hidden-skills/groundwork-designer/references/layout-and-space.md +33 -0
- package/src/hidden-skills/groundwork-designer/references/usability-and-ux.md +33 -0
- package/src/hidden-skills/groundwork-designer/references/visual-craft.md +49 -0
- package/src/hidden-skills/groundwork-designer/sync-anchor.md +20 -0
- package/src/hidden-skills/groundwork-doc-sync/instructions.md +100 -0
- package/src/hidden-skills/groundwork-elicit/instructions.md +66 -0
- package/src/hidden-skills/groundwork-elicit/methods.md +65 -0
- package/src/hidden-skills/groundwork-infra-adopt/instructions.md +168 -0
- package/src/hidden-skills/groundwork-infra-adopt/templates/infra-adopt-cache.md +21 -0
- package/src/hidden-skills/groundwork-mvp/instructions.md +223 -0
- package/src/hidden-skills/groundwork-mvp/templates/mvp-cache.md +9 -0
- package/src/hidden-skills/groundwork-patch/instructions.md +40 -0
- package/src/hidden-skills/groundwork-persona/instructions.md +54 -0
- package/src/hidden-skills/groundwork-product/SKILL.md +102 -0
- package/src/hidden-skills/groundwork-product/references/ai-native-product.md +45 -0
- package/src/hidden-skills/groundwork-product/references/discovery-and-opportunity.md +38 -0
- package/src/hidden-skills/groundwork-product/references/product-risks.md +52 -0
- package/src/hidden-skills/groundwork-product/references/requirements-and-specs.md +39 -0
- package/src/hidden-skills/groundwork-product/references/scope-and-sequencing.md +35 -0
- package/src/hidden-skills/groundwork-product/references/shaping-and-appetite.md +48 -0
- package/src/hidden-skills/groundwork-product/references/success-metrics-and-signals.md +37 -0
- package/src/hidden-skills/groundwork-product/sync-anchor.md +19 -0
- package/src/hidden-skills/groundwork-product-brief/instructions.md +231 -0
- package/src/hidden-skills/groundwork-product-brief-extract/instructions.md +139 -0
- package/src/hidden-skills/groundwork-product-brief-extract/templates/product-brief-extract-cache.md +17 -0
- package/src/hidden-skills/groundwork-review/checklists/architecture.md +93 -0
- package/src/hidden-skills/groundwork-review/checklists/bet-pitch.md +94 -0
- package/src/hidden-skills/groundwork-review/checklists/decomposition.md +135 -0
- package/src/hidden-skills/groundwork-review/checklists/design-system.md +85 -0
- package/src/hidden-skills/groundwork-review/checklists/domain-entity.md +66 -0
- package/src/hidden-skills/groundwork-review/checklists/implementation-readiness.md +46 -0
- package/src/hidden-skills/groundwork-review/checklists/infrastructure.md +68 -0
- package/src/hidden-skills/groundwork-review/checklists/maturity.md +71 -0
- package/src/hidden-skills/groundwork-review/checklists/product-brief.md +69 -0
- package/src/hidden-skills/groundwork-review/checklists/technical-design.md +112 -0
- package/src/hidden-skills/groundwork-review/instructions.md +181 -0
- package/src/hidden-skills/groundwork-scaffold/instructions.md +254 -0
- package/src/hidden-skills/groundwork-scaffold/phases/01-ingestion-service-mapping.md +87 -0
- package/src/hidden-skills/groundwork-scaffold/phases/02-scaffolding-execution.md +15 -0
- package/src/hidden-skills/groundwork-scaffold/phases/03-service-documentation-api-stubs.md +100 -0
- package/src/hidden-skills/groundwork-scaffold/phases/04-infrastructure-verification.md +17 -0
- package/src/hidden-skills/groundwork-scaffold/phases/05-draft-review.md +19 -0
- package/src/hidden-skills/groundwork-scaffold/phases/06-commit.md +19 -0
- package/src/hidden-skills/groundwork-scaffold/templates/scaffold-cache.md +23 -0
- package/src/hidden-skills/groundwork-scan/instructions.md +164 -0
- package/src/hidden-skills/groundwork-scan/references/digest-schema.md +66 -0
- package/src/hidden-skills/groundwork-scan/references/exclusions.md +44 -0
- package/src/hidden-skills/groundwork-scan/templates/architecture-findings.md +42 -0
- package/src/hidden-skills/groundwork-scan/templates/design-findings.md +23 -0
- package/src/hidden-skills/groundwork-scan/templates/overview.md +26 -0
- package/src/hidden-skills/groundwork-scan/templates/product-findings.md +23 -0
- package/src/hidden-skills/groundwork-scan/templates/scan-state.json +19 -0
- package/src/hidden-skills/groundwork-stack-forge/instructions.md +150 -0
- package/src/hidden-skills/groundwork-stack-forge/references/authoring-engineer-skills.md +107 -0
- package/src/hidden-skills/groundwork-surface-activation/instructions.md +138 -0
- package/src/hidden-skills/groundwork-update/briefs/reconcile-worker.md +196 -0
- package/src/hidden-skills/groundwork-update/instructions.md +200 -0
- package/src/hidden-skills/groundwork-writer/SKILL.md +278 -0
- package/src/hidden-skills/maturity-model.md +125 -0
- package/src/hidden-skills/operating-contract.md +400 -0
- package/src/hidden-skills/repo-map-schema.md +90 -0
- package/src/hidden-skills/templates/adr.md +57 -0
- package/src/hidden-skills/templates/capability-ports.md +71 -0
- package/src/hidden-skills/templates/discovery-notes.md +33 -0
- package/src/hidden-skills/templates/domain-entity.md +80 -0
- package/src/hidden-skills/templates/gap-ledger.md +21 -0
- package/src/hidden-skills/templates/handoff.md +37 -0
- package/src/hidden-skills/templates/maturity.md +39 -0
- package/src/hidden-skills/templates/surfaces.md +207 -0
- package/src/skills/groundwork-check/SKILL.md +56 -0
- package/src/skills/groundwork-check/instructions.md +70 -0
- package/src/skills/groundwork-orchestrator/SKILL.md +176 -0
- package/src/skills/groundwork-orchestrator/workflow-index.md +50 -0
|
@@ -0,0 +1,441 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
14
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
15
|
+
}) : function(o, v) {
|
|
16
|
+
o["default"] = v;
|
|
17
|
+
});
|
|
18
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
19
|
+
var ownKeys = function(o) {
|
|
20
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
21
|
+
var ar = [];
|
|
22
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
23
|
+
return ar;
|
|
24
|
+
};
|
|
25
|
+
return ownKeys(o);
|
|
26
|
+
};
|
|
27
|
+
return function (mod) {
|
|
28
|
+
if (mod && mod.__esModule) return mod;
|
|
29
|
+
var result = {};
|
|
30
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
31
|
+
__setModuleDefault(result, mod);
|
|
32
|
+
return result;
|
|
33
|
+
};
|
|
34
|
+
})();
|
|
35
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
|
+
exports.default = default_1;
|
|
37
|
+
const devkit_1 = require("@nx/devkit");
|
|
38
|
+
const path = __importStar(require("path"));
|
|
39
|
+
const provenance_1 = require("../shared/provenance");
|
|
40
|
+
const scaffold_helpers_1 = require("../shared/scaffold-helpers");
|
|
41
|
+
const brand_tokens_1 = require("../shared/brand-tokens");
|
|
42
|
+
/** "magpie-app" → "Magpie App". Used to title the docs nav from the workspace prefix. */
|
|
43
|
+
function toTitle(s) {
|
|
44
|
+
return s
|
|
45
|
+
.replace(/[-_]+/g, ' ')
|
|
46
|
+
.replace(/\b\w/g, (c) => c.toUpperCase())
|
|
47
|
+
.trim();
|
|
48
|
+
}
|
|
49
|
+
// ---------------------------------------------------------------------------
|
|
50
|
+
// Brand projection onto Fumadocs (F1, F2)
|
|
51
|
+
// ---------------------------------------------------------------------------
|
|
52
|
+
//
|
|
53
|
+
// The scaffold runs Fumadocs UI v14 with Tailwind v3 (`createPreset()` +
|
|
54
|
+
// `fumadocs-ui/style.css`). v14 themes through `--fd-*` CSS variables whose
|
|
55
|
+
// values are HSL CHANNEL TRIPLETS in whitespace form (e.g.
|
|
56
|
+
// `--fd-background: 0 0% 100%`) — Fumadocs consumes them internally as
|
|
57
|
+
// `hsl(var(--fd-...))`. So the projection must convert the brand palette
|
|
58
|
+
// (OKLCH or #rrggbb) to an `H S% L%` triplet, not emit a full colour function.
|
|
59
|
+
/** Parse `#rgb`/`#rgba`/`#rrggbb`/`#rrggbbaa` into 0–255 RGB (alpha dropped —
|
|
60
|
+
* Fumadocs theme channels are opaque). Returns null on anything else. */
|
|
61
|
+
function hexToRgb(hex) {
|
|
62
|
+
let h = hex.trim().replace(/^#/, '');
|
|
63
|
+
if (h.length === 3 || h.length === 4) {
|
|
64
|
+
h = h.split('').slice(0, 3).map((c) => c + c).join('');
|
|
65
|
+
}
|
|
66
|
+
else if (h.length === 8) {
|
|
67
|
+
h = h.slice(0, 6);
|
|
68
|
+
}
|
|
69
|
+
else if (h.length !== 6) {
|
|
70
|
+
return null;
|
|
71
|
+
}
|
|
72
|
+
const n = parseInt(h, 16);
|
|
73
|
+
if (!Number.isFinite(n))
|
|
74
|
+
return null;
|
|
75
|
+
return { r: (n >> 16) & 255, g: (n >> 8) & 255, b: n & 255 };
|
|
76
|
+
}
|
|
77
|
+
/** OKLCH string → 0–255 sRGB. Implements the OKLab→linear-sRGB→sRGB pipeline
|
|
78
|
+
* (Björn Ottosson's reference matrices). Handles `oklch(L C H)` with L as a
|
|
79
|
+
* fraction or percentage; alpha is ignored. Returns null if it cannot parse. */
|
|
80
|
+
function oklchToRgb(value) {
|
|
81
|
+
const m = value
|
|
82
|
+
.trim()
|
|
83
|
+
.match(/^oklch\(\s*([\d.]+%?)\s+([\d.]+)\s+([\d.]+)(?:deg)?(?:\s*\/\s*[\d.]+%?)?\s*\)$/i);
|
|
84
|
+
if (!m)
|
|
85
|
+
return null;
|
|
86
|
+
let L = m[1].endsWith('%') ? parseFloat(m[1]) / 100 : parseFloat(m[1]);
|
|
87
|
+
const C = parseFloat(m[2]);
|
|
88
|
+
const Hdeg = parseFloat(m[3]);
|
|
89
|
+
if (![L, C, Hdeg].every(Number.isFinite))
|
|
90
|
+
return null;
|
|
91
|
+
const h = (Hdeg * Math.PI) / 180;
|
|
92
|
+
const a = C * Math.cos(h);
|
|
93
|
+
const bb = C * Math.sin(h);
|
|
94
|
+
// OKLab → LMS (cube of the l'/m'/s' terms)
|
|
95
|
+
const l_ = L + 0.3963377774 * a + 0.2158037573 * bb;
|
|
96
|
+
const m_ = L - 0.1055613458 * a - 0.0638541728 * bb;
|
|
97
|
+
const s_ = L - 0.0894841775 * a - 1.291485548 * bb;
|
|
98
|
+
const l = l_ ** 3;
|
|
99
|
+
const mm = m_ ** 3;
|
|
100
|
+
const s = s_ ** 3;
|
|
101
|
+
// LMS → linear sRGB
|
|
102
|
+
let lr = +4.0767416621 * l - 3.3077115913 * mm + 0.2309699292 * s;
|
|
103
|
+
let lg = -1.2684380046 * l + 2.6097574011 * mm - 0.3413193965 * s;
|
|
104
|
+
let lb = -0.0041960863 * l - 0.7034186147 * mm + 1.707614701 * s;
|
|
105
|
+
const toSrgb = (c) => {
|
|
106
|
+
const x = Math.min(Math.max(c, 0), 1);
|
|
107
|
+
return x <= 0.0031308 ? 12.92 * x : 1.055 * x ** (1 / 2.4) - 0.055;
|
|
108
|
+
};
|
|
109
|
+
return {
|
|
110
|
+
r: Math.round(toSrgb(lr) * 255),
|
|
111
|
+
g: Math.round(toSrgb(lg) * 255),
|
|
112
|
+
b: Math.round(toSrgb(lb) * 255),
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
/** Any validated brand colour (hex or OKLCH) → an `H S% L%` channel triplet
|
|
116
|
+
* for a Fumadocs `--fd-*` variable. Returns null when conversion is not
|
|
117
|
+
* possible, so the caller keeps the stock Fumadocs default for that slot. */
|
|
118
|
+
function colorToHslChannels(value) {
|
|
119
|
+
if (!value)
|
|
120
|
+
return null;
|
|
121
|
+
const rgb = value.startsWith('#') ? hexToRgb(value) : oklchToRgb(value);
|
|
122
|
+
if (!rgb)
|
|
123
|
+
return null;
|
|
124
|
+
const r = rgb.r / 255;
|
|
125
|
+
const g = rgb.g / 255;
|
|
126
|
+
const b = rgb.b / 255;
|
|
127
|
+
const max = Math.max(r, g, b);
|
|
128
|
+
const min = Math.min(r, g, b);
|
|
129
|
+
const lum = (max + min) / 2;
|
|
130
|
+
let hue = 0;
|
|
131
|
+
let sat = 0;
|
|
132
|
+
if (max !== min) {
|
|
133
|
+
const d = max - min;
|
|
134
|
+
sat = lum > 0.5 ? d / (2 - max - min) : d / (max + min);
|
|
135
|
+
switch (max) {
|
|
136
|
+
case r:
|
|
137
|
+
hue = (g - b) / d + (g < b ? 6 : 0);
|
|
138
|
+
break;
|
|
139
|
+
case g:
|
|
140
|
+
hue = (b - r) / d + 2;
|
|
141
|
+
break;
|
|
142
|
+
default:
|
|
143
|
+
hue = (r - g) / d + 4;
|
|
144
|
+
}
|
|
145
|
+
hue /= 6;
|
|
146
|
+
}
|
|
147
|
+
const H = Math.round(hue * 360);
|
|
148
|
+
const S = Math.round(sat * 100);
|
|
149
|
+
const Lp = Math.round(lum * 100);
|
|
150
|
+
return `${H} ${S}% ${Lp}%`;
|
|
151
|
+
}
|
|
152
|
+
/** Resolve a palette role's light/dark to HSL channel triplets. */
|
|
153
|
+
function paletteChannels(v, role) {
|
|
154
|
+
// resolveVisual maps palette roles onto shadcn slots; read them back so the
|
|
155
|
+
// docs theme tracks the same projection the app uses (one brand, one palette).
|
|
156
|
+
const SLOT = {
|
|
157
|
+
surface: 'background',
|
|
158
|
+
surfaceAlt: 'secondary',
|
|
159
|
+
textBody: 'foreground',
|
|
160
|
+
primary: 'primary',
|
|
161
|
+
border: 'border',
|
|
162
|
+
};
|
|
163
|
+
const slot = SLOT[role];
|
|
164
|
+
const ld = slot ? v.shadcn[slot] : undefined;
|
|
165
|
+
return {
|
|
166
|
+
light: colorToHslChannels(ld?.light ?? null),
|
|
167
|
+
dark: colorToHslChannels(ld?.dark ?? null),
|
|
168
|
+
};
|
|
169
|
+
}
|
|
170
|
+
/** Read the brand identity bits the docs site wires beyond the palette: the
|
|
171
|
+
* display/body font families (Google-font names) and the wordmark glyph. */
|
|
172
|
+
function readDocsBrandInputs(tree, v) {
|
|
173
|
+
let displayFamily = null;
|
|
174
|
+
let bodyFamily = null;
|
|
175
|
+
let wordmark = null;
|
|
176
|
+
if (tree.exists(brand_tokens_1.BRAND_TOKENS_PATH)) {
|
|
177
|
+
try {
|
|
178
|
+
const raw = JSON.parse(tree.read(brand_tokens_1.BRAND_TOKENS_PATH, 'utf-8') || '{}');
|
|
179
|
+
const fam = (x) => typeof x === 'string' && /^[\w][\w .'-]{0,48}$/.test(x.trim()) ? x.trim() : null;
|
|
180
|
+
displayFamily = fam(raw?.visual?.typography?.display?.family);
|
|
181
|
+
bodyFamily = fam(raw?.visual?.typography?.body?.family);
|
|
182
|
+
const wm = raw?.identity?.wordmark;
|
|
183
|
+
wordmark = typeof wm === 'string' && wm.trim() && wm.trim().length <= 4 ? wm.trim() : null;
|
|
184
|
+
}
|
|
185
|
+
catch {
|
|
186
|
+
/* fall back to nulls — stock appearance */
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
return { v, displayFamily, bodyFamily, wordmark };
|
|
190
|
+
}
|
|
191
|
+
/** Render app/brand.css for the docs site: map the resolved brand palette onto
|
|
192
|
+
* Fumadocs v14 `--fd-*` theme variables (HSL channel triplets). Only slots the
|
|
193
|
+
* palette actually drives are overridden; every other Fumadocs default is left
|
|
194
|
+
* untouched. The reading measure + h1–h4 scale (F2) ship separately in the
|
|
195
|
+
* static app/docs.css so they apply even when a slot keeps its Fumadocs default. */
|
|
196
|
+
function renderDocsBrandCss(inp) {
|
|
197
|
+
const { v } = inp;
|
|
198
|
+
const out = [];
|
|
199
|
+
out.push('/* GENERATED by the GroundWork docs-site generator from');
|
|
200
|
+
out.push(' * .groundwork/config/brand-tokens.json — do not hand-edit this file.');
|
|
201
|
+
out.push(' * Re-run the design system to evolve the brand, then regenerate.');
|
|
202
|
+
out.push(' * Maps the brand palette onto Fumadocs v14 --fd-* theme variables');
|
|
203
|
+
out.push(' * (HSL channel triplets). The reading measure + scale live in docs.css.');
|
|
204
|
+
out.push(` * Projection source: ${v.source}. */`);
|
|
205
|
+
out.push('');
|
|
206
|
+
const surface = paletteChannels(v, 'surface');
|
|
207
|
+
const surfaceAlt = paletteChannels(v, 'surfaceAlt');
|
|
208
|
+
const text = paletteChannels(v, 'textBody');
|
|
209
|
+
const primary = paletteChannels(v, 'primary');
|
|
210
|
+
const border = paletteChannels(v, 'border');
|
|
211
|
+
// Which --fd-* slot each palette role drives. Foregrounds-on-colour
|
|
212
|
+
// (primary-foreground) keep the Fumadocs default for contrast safety.
|
|
213
|
+
const lightMap = [
|
|
214
|
+
['--fd-background', surface.light],
|
|
215
|
+
['--fd-card', surface.light],
|
|
216
|
+
['--fd-popover', surface.light],
|
|
217
|
+
['--fd-secondary', surfaceAlt.light],
|
|
218
|
+
['--fd-muted', surfaceAlt.light],
|
|
219
|
+
['--fd-accent', surfaceAlt.light],
|
|
220
|
+
['--fd-foreground', text.light],
|
|
221
|
+
['--fd-card-foreground', text.light],
|
|
222
|
+
['--fd-popover-foreground', text.light],
|
|
223
|
+
['--fd-secondary-foreground', text.light],
|
|
224
|
+
['--fd-accent-foreground', text.light],
|
|
225
|
+
['--fd-primary', primary.light],
|
|
226
|
+
['--fd-ring', primary.light],
|
|
227
|
+
['--fd-border', border.light],
|
|
228
|
+
];
|
|
229
|
+
const darkMap = [
|
|
230
|
+
['--fd-background', surface.dark],
|
|
231
|
+
['--fd-card', surface.dark],
|
|
232
|
+
['--fd-popover', surface.dark],
|
|
233
|
+
['--fd-secondary', surfaceAlt.dark],
|
|
234
|
+
['--fd-muted', surfaceAlt.dark],
|
|
235
|
+
['--fd-accent', surfaceAlt.dark],
|
|
236
|
+
['--fd-foreground', text.dark],
|
|
237
|
+
['--fd-card-foreground', text.dark],
|
|
238
|
+
['--fd-popover-foreground', text.dark],
|
|
239
|
+
['--fd-secondary-foreground', text.dark],
|
|
240
|
+
['--fd-accent-foreground', text.dark],
|
|
241
|
+
['--fd-primary', primary.dark],
|
|
242
|
+
['--fd-ring', primary.dark],
|
|
243
|
+
['--fd-border', border.dark],
|
|
244
|
+
];
|
|
245
|
+
const block = (selector, entries) => {
|
|
246
|
+
const present = entries.filter(([, val]) => val);
|
|
247
|
+
if (present.length === 0)
|
|
248
|
+
return;
|
|
249
|
+
out.push(`${selector} {`);
|
|
250
|
+
for (const [name, val] of present)
|
|
251
|
+
out.push(` ${name}: ${val};`);
|
|
252
|
+
out.push('}');
|
|
253
|
+
out.push('');
|
|
254
|
+
};
|
|
255
|
+
block(':root', lightMap);
|
|
256
|
+
block('.dark', darkMap);
|
|
257
|
+
return out.join('\n');
|
|
258
|
+
}
|
|
259
|
+
async function default_1(tree, options) {
|
|
260
|
+
const serviceNames = (0, devkit_1.names)(options.name);
|
|
261
|
+
const projectRoot = `services/${serviceNames.fileName}`;
|
|
262
|
+
// The docs site is a NATIVE RUNNER, not a docker-compose service. It compiles
|
|
263
|
+
// the repo-root docs/ tree at build time (source.config.ts reads ../../docs),
|
|
264
|
+
// which only resolves when Next runs from the service directory — that path is
|
|
265
|
+
// outside any per-service Docker build context, so a containerized build can
|
|
266
|
+
// never see the docs. Running it natively (`pnpm dev`) also gives live reload
|
|
267
|
+
// as the delivery loop writes docs. Fixed local port; never joins compose.
|
|
268
|
+
const assignedPort = 4000;
|
|
269
|
+
const prefix = (0, scaffold_helpers_1.readProjectPrefix)(tree);
|
|
270
|
+
const navTitle = prefix && prefix !== 'workspace' ? `${toTitle(prefix)} Docs` : 'Documentation';
|
|
271
|
+
const projectName = prefix && prefix !== 'workspace' ? toTitle(prefix) : 'Project';
|
|
272
|
+
// Resolve the brand projection once. `source` distinguishes a real brand
|
|
273
|
+
// (visual-block / identity-only) from the unbranded fallback (default): when
|
|
274
|
+
// there is no brand-tokens.json the docs site keeps the stock Fumadocs
|
|
275
|
+
// appearance — no brand.css is emitted and layout.tsx imports nothing extra.
|
|
276
|
+
const visual = (0, brand_tokens_1.resolveVisual)(tree);
|
|
277
|
+
const brand = readDocsBrandInputs(tree, visual);
|
|
278
|
+
const branded = visual.source !== 'default';
|
|
279
|
+
// The brand body font, when the design system named a Google font family —
|
|
280
|
+
// it sets the whole site's type. Falls back to Inter (the stock default) when
|
|
281
|
+
// absent. (A distinct display/heading font can be wired later from the same
|
|
282
|
+
// tokens; body family is the highest-leverage single choice.)
|
|
283
|
+
const bodyFont = brand.bodyFamily ?? null;
|
|
284
|
+
const templateOptions = {
|
|
285
|
+
...options,
|
|
286
|
+
...serviceNames,
|
|
287
|
+
assignedPort,
|
|
288
|
+
navTitle,
|
|
289
|
+
projectName,
|
|
290
|
+
branded,
|
|
291
|
+
bodyFont,
|
|
292
|
+
wordmark: brand.wordmark ?? '',
|
|
293
|
+
tagline: `Reference documentation for ${projectName}.`,
|
|
294
|
+
tmpl: '', // required by generateFiles
|
|
295
|
+
};
|
|
296
|
+
(0, devkit_1.generateFiles)(tree, path.join(__dirname, '..', '..', '..', '..', 'src', 'generators', 'docs-site', 'files'), projectRoot, templateOptions);
|
|
297
|
+
// Nx's generateFiles treats __var__ as template substitution.
|
|
298
|
+
// Rename the dynamic catch-all route directory to Next's [[...slug]].
|
|
299
|
+
const oldDir = `${projectRoot}/app/docs/__slug__`;
|
|
300
|
+
const newDir = `${projectRoot}/app/docs/[[...slug]]`;
|
|
301
|
+
for (const child of tree.children(oldDir)) {
|
|
302
|
+
const content = tree.read(`${oldDir}/${child}`);
|
|
303
|
+
if (content) {
|
|
304
|
+
tree.write(`${newDir}/${child}`, content);
|
|
305
|
+
tree.delete(`${oldDir}/${child}`);
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
// Brand the docs site (WS-F). Project the brand palette onto Fumadocs --fd-*
|
|
309
|
+
// theme variables (app/brand.css); the reading measure + h1–h4 scale ship in
|
|
310
|
+
// the static app/docs.css. app/layout.tsx imports both. Unbranded projects
|
|
311
|
+
// (no brand-tokens.json) skip this entirely and keep today's stock Fumadocs
|
|
312
|
+
// appearance — brand.css is not written and docs.css is dropped.
|
|
313
|
+
if (branded) {
|
|
314
|
+
tree.write(`${projectRoot}/app/brand.css`, renderDocsBrandCss(brand));
|
|
315
|
+
}
|
|
316
|
+
else {
|
|
317
|
+
// Unbranded fallback: no brand.css, and the typography sheet is dropped so
|
|
318
|
+
// the emitted tree is the stock Fumadocs starter (layout.tsx imports neither).
|
|
319
|
+
tree.delete(`${projectRoot}/app/docs.css`);
|
|
320
|
+
}
|
|
321
|
+
// Seed the sidebar ordering as declarative Fumadocs meta.json (WS-G / E1).
|
|
322
|
+
// This lands in the project's content tree (Tier-2 content seeded into docs/),
|
|
323
|
+
// ordering the canonical doc set and collapsing the large principles tree so
|
|
324
|
+
// it no longer dominates the rail. Retires the betsFirst() JS hack. Only seed
|
|
325
|
+
// it once — never clobber a meta.json the project has since hand-tuned.
|
|
326
|
+
seedDocsMeta(tree);
|
|
327
|
+
// Register with `./dev` as a native runner so start/stop/status/logs manage it
|
|
328
|
+
// like any other surface (electron/flutter/cli do the same). Not autostarted —
|
|
329
|
+
// a docs site is a developer affordance, not part of the boot topology; it is
|
|
330
|
+
// launched on demand (`pnpm dev` in the service dir, or via the runner).
|
|
331
|
+
(0, scaffold_helpers_1.registerRunner)(tree, {
|
|
332
|
+
name: serviceNames.fileName,
|
|
333
|
+
kind: 'surface',
|
|
334
|
+
cmd: 'pnpm dev',
|
|
335
|
+
cwd: projectRoot,
|
|
336
|
+
env: { PORT: String(assignedPort) },
|
|
337
|
+
autostart: false,
|
|
338
|
+
});
|
|
339
|
+
await (0, devkit_1.formatFiles)(tree);
|
|
340
|
+
(0, provenance_1.recordGeneratorProvenance)(tree, 'docs-site', options);
|
|
341
|
+
return () => {
|
|
342
|
+
const { execSync } = require('child_process');
|
|
343
|
+
const fs = require('fs');
|
|
344
|
+
try {
|
|
345
|
+
execSync('pnpm install', { cwd: projectRoot, stdio: 'inherit' });
|
|
346
|
+
}
|
|
347
|
+
catch (e) {
|
|
348
|
+
// pnpm 10+ exits non-zero on ERR_PNPM_IGNORED_BUILDS — the build scripts of
|
|
349
|
+
// gated dependencies (esbuild/sharp) are skipped by default — even when the
|
|
350
|
+
// install itself succeeded. Treat a populated node_modules as success (pnpm
|
|
351
|
+
// already printed its own approve-builds notice); only warn if deps are
|
|
352
|
+
// genuinely missing, so we never report a false failure over a good install.
|
|
353
|
+
if (!fs.existsSync(path.join(projectRoot, 'node_modules'))) {
|
|
354
|
+
console.warn(`Failed to run pnpm install in ${projectRoot}. Run it manually.`);
|
|
355
|
+
}
|
|
356
|
+
}
|
|
357
|
+
};
|
|
358
|
+
}
|
|
359
|
+
/** The canonical top-level doc order for the sidebar (E1). The rail reads as a
|
|
360
|
+
* product-learning journey: the brief (what the system is) → the design system
|
|
361
|
+
* (how it looks and behaves) → the nested architecture section (how it is
|
|
362
|
+
* built) → ways of working → getting started (how to run it) → bets (delivery
|
|
363
|
+
* work). `...` keeps any doc/folder not named here in its natural position
|
|
364
|
+
* after the named set, and `principles` is pushed last and collapsed so its
|
|
365
|
+
* large tree never dominates the rail. Lands at docs/meta.json — Fumadocs
|
|
366
|
+
* sidebar config, ignored by GitHub and agents, so the docs/ tree stays
|
|
367
|
+
* effectively content-pristine. */
|
|
368
|
+
function seedDocsMeta(tree) {
|
|
369
|
+
const metaPath = 'docs/meta.json';
|
|
370
|
+
if (tree.exists(metaPath))
|
|
371
|
+
return; // never clobber a project-tuned ordering
|
|
372
|
+
// Fumadocs reads `pages` as the sidebar order. Explicit names come first in
|
|
373
|
+
// the listed order; `...` expands to every remaining page/folder not named;
|
|
374
|
+
// `principles` is named LAST (after `...`) so the large principles tree sinks
|
|
375
|
+
// to the bottom of the rail instead of leading it. `architecture` and
|
|
376
|
+
// `getting-started` are folders here — their own meta.json (below) orders
|
|
377
|
+
// their children.
|
|
378
|
+
const meta = {
|
|
379
|
+
pages: [
|
|
380
|
+
'product-brief',
|
|
381
|
+
'design-system',
|
|
382
|
+
'architecture',
|
|
383
|
+
'ways-of-working',
|
|
384
|
+
'getting-started',
|
|
385
|
+
'bets',
|
|
386
|
+
'...',
|
|
387
|
+
'principles',
|
|
388
|
+
],
|
|
389
|
+
};
|
|
390
|
+
tree.write(metaPath, JSON.stringify(meta, null, 2) + '\n');
|
|
391
|
+
// Order the nested architecture section: the overview (index, was the flat
|
|
392
|
+
// architecture.md) first, then infrastructure → domain → services → api →
|
|
393
|
+
// decisions, with `...` catching anything else. Seeded only when the folder
|
|
394
|
+
// exists and lacks its own meta — never write a meta.json into an empty folder
|
|
395
|
+
// (Fumadocs renders a content-less folder as a broken nav node and the build
|
|
396
|
+
// trips over it), and never clobber a project's own grouping. The architecture
|
|
397
|
+
// skill seeds this when it first creates the folder, so a fresh scaffold gets
|
|
398
|
+
// the order; this backfills it on regeneration over an older project.
|
|
399
|
+
const architectureMeta = 'docs/architecture/meta.json';
|
|
400
|
+
if (tree.exists('docs/architecture') && !tree.exists(architectureMeta)) {
|
|
401
|
+
tree.write(architectureMeta, JSON.stringify({
|
|
402
|
+
pages: [
|
|
403
|
+
'index',
|
|
404
|
+
'infrastructure',
|
|
405
|
+
'domain',
|
|
406
|
+
'services',
|
|
407
|
+
'api',
|
|
408
|
+
'decisions',
|
|
409
|
+
'...',
|
|
410
|
+
],
|
|
411
|
+
}, null, 2) + '\n');
|
|
412
|
+
}
|
|
413
|
+
// Order the getting-started on-ramp: the overview (index) first, then the
|
|
414
|
+
// setup walkthrough and the ./dev command reference. Same folder-must-exist
|
|
415
|
+
// guard as architecture above.
|
|
416
|
+
const gettingStartedMeta = 'docs/getting-started/meta.json';
|
|
417
|
+
if (tree.exists('docs/getting-started') && !tree.exists(gettingStartedMeta)) {
|
|
418
|
+
tree.write(gettingStartedMeta, JSON.stringify({ pages: ['index', 'setup', 'dev-cli-reference', '...'] }, null, 2) + '\n');
|
|
419
|
+
}
|
|
420
|
+
// Order the principles subtree last + collapsed via its own meta.json. Seeded
|
|
421
|
+
// only if absent so a project's own grouping is preserved.
|
|
422
|
+
const principlesMeta = 'docs/principles/meta.json';
|
|
423
|
+
if (!tree.exists(principlesMeta) && tree.exists('docs/principles')) {
|
|
424
|
+
tree.write(principlesMeta, JSON.stringify({ defaultOpen: false, pages: ['...'] }, null, 2) + '\n');
|
|
425
|
+
}
|
|
426
|
+
// Within the Bets section, sink the `_archive` folder (delivered bets) to the
|
|
427
|
+
// bottom of the rail so active, in-flight bets read first. `...` expands to
|
|
428
|
+
// every active bet (sorted), then `_archive` is named LAST. The archive folder
|
|
429
|
+
// itself is COLLAPSED via its own docs/bets/_archive/meta.json (defaultOpen:
|
|
430
|
+
// false), written by the dev CLI's `archive` command at delivery time — not
|
|
431
|
+
// here. (Fumadocs has no leading-underscore hide convention, so `_archive`
|
|
432
|
+
// stays visible-but-closed, which is the desired collapse.) The scaffold seeds
|
|
433
|
+
// no docs/bets/ (bets are authored during the lifecycle), so this is normally a
|
|
434
|
+
// no-op at scaffold time; guarded by tree.exists so it only lands when the bets
|
|
435
|
+
// tree is present, and never clobbers a project-tuned ordering.
|
|
436
|
+
const betsMeta = 'docs/bets/meta.json';
|
|
437
|
+
if (!tree.exists(betsMeta) && tree.exists('docs/bets')) {
|
|
438
|
+
tree.write(betsMeta, JSON.stringify({ pages: ['...', '_archive'] }, null, 2) + '\n');
|
|
439
|
+
}
|
|
440
|
+
}
|
|
441
|
+
//# sourceMappingURL=generator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../src/generators/docs-site/generator.ts"],"names":[],"mappings":"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"}
|