@harness-forge/cli 0.1.0

package/manifests/bundles/core.json

@@ -0,0 +1,384 @@
+{
+  "bundles": [
+    {
+      "id": "baseline:agents",
+      "family": "baseline",
+      "version": 1,
+      "description": "Core agent guidance and planner support.",
+      "paths": [
+        "AGENTS.md",
+        "agents/planner.md",
+        ".agents/skills",
+        "skills"
+      ],
+      "targets": [
+        "codex",
+        "claude-code",
+        "cursor",
+        "opencode"
+      ],
+      "dependencies": [],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": true,
+      "stability": "stable",
+      "tags": [
+        "baseline",
+        "agents"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Use for general project guidance and planning."
+      ]
+    },
+    {
+      "id": "baseline:commands",
+      "family": "baseline",
+      "version": 1,
+      "description": "Core command guidance and usage patterns.",
+      "paths": [
+        "commands/plan.md",
+        "commands/test.md",
+        "contexts/dev.md",
+        "profiles"
+      ],
+      "targets": [
+        "codex",
+        "claude-code",
+        "cursor",
+        "opencode"
+      ],
+      "dependencies": [],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": true,
+      "stability": "stable",
+      "tags": [
+        "baseline",
+        "commands"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Use when starting, testing, or validating work."
+      ]
+    },
+    {
+      "id": "capability:workflow-quality",
+      "family": "capability",
+      "version": 1,
+      "description": "Workflow templates and validators for quality-guided execution.",
+      "paths": [
+        ".specify",
+        "templates/tasks/implement-feature.md",
+        "templates/tasks/fix-bug.md",
+        "templates/workflows/research-plan-implement-validate.md",
+        "templates/workflows/triage-reproduce-fix-verify.md",
+        "scripts/templates/README.md",
+        "scripts/templates/config/required-sections.json",
+        "scripts/templates/shell/check-template-links.sh",
+        "scripts/templates/shell/list-missing-template-sections.sh",
+        "scripts/templates/shell/generate-template-index.sh",
+        "scripts/templates/shell/verify-workflow-contracts.sh",
+        "scripts/templates/shell/check-template-frontmatter.sh",
+        "scripts/templates/powershell/Check-TemplateLinks.ps1",
+        "scripts/templates/powershell/Get-MissingTemplateSections.ps1",
+        "scripts/templates/powershell/New-TemplateIndex.ps1",
+        "scripts/templates/powershell/Test-WorkflowContracts.ps1",
+        "scripts/templates/powershell/Check-TemplateFrontmatter.ps1",
+        "hooks",
+        "mcp",
+        "skills/speckit-analyze",
+        "skills/speckit-checklist",
+        "skills/speckit-clarify",
+        "skills/speckit-constitution",
+        "skills/speckit-implement",
+        "skills/speckit-plan",
+        "skills/speckit-specify",
+        "skills/speckit-tasks",
+        "skills/speckit-taskstoissues"
+      ],
+      "targets": [
+        "codex",
+        "claude-code",
+        "cursor",
+        "opencode"
+      ],
+      "dependencies": [
+        "baseline:agents",
+        "baseline:commands"
+      ],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": true,
+      "stability": "stable",
+      "tags": [
+        "workflow",
+        "templates",
+        "validation"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Use when implementing, fixing, or validating work."
+      ]
+    },
+    {
+      "id": "target-runtime:codex",
+      "family": "target-runtime",
+      "version": 1,
+      "description": "Project-owned runtime files for Codex.",
+      "paths": [
+        "targets/codex/runtime/.codex",
+        "scripts/codex"
+      ],
+      "targets": [
+        "codex"
+      ],
+      "dependencies": [],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": false,
+      "stability": "stable",
+      "tags": [
+        "target",
+        "codex",
+        "runtime"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Install when the selected target is codex."
+      ]
+    },
+    {
+      "id": "target-runtime:claude-code",
+      "family": "target-runtime",
+      "version": 1,
+      "description": "Project-owned runtime files for Claude Code.",
+      "paths": [
+        "targets/claude-code/runtime/.claude"
+      ],
+      "targets": [
+        "claude-code"
+      ],
+      "dependencies": [],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": false,
+      "stability": "stable",
+      "tags": [
+        "target",
+        "claude-code",
+        "runtime"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Install when the selected target is claude-code."
+      ]
+    },
+    {
+      "id": "capability:repo-intelligence",
+      "family": "capability",
+      "version": 1,
+      "description": "Repo scanning, framework detection, benchmark fixtures, and evidence-backed recommendations.",
+      "paths": [
+        "scripts/intelligence",
+        "docs/catalog/framework-packs.md",
+        "docs/benchmark-scenarios.md",
+        "manifests/catalog/framework-assets.json",
+        "manifests/catalog/language-assets.json",
+        "manifests/bundles/frameworks.json",
+        "skills/repo-onboarding",
+        "skills/documentation-lookup"
+      ],
+      "targets": [
+        "codex",
+        "claude-code",
+        "cursor",
+        "opencode"
+      ],
+      "dependencies": [
+        "baseline:agents",
+        "baseline:commands"
+      ],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": false,
+      "stability": "stable",
+      "tags": [
+        "recommendation",
+        "intelligence",
+        "benchmarks"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Install when repository-aware setup guidance matters more than language-only defaults."
+      ]
+    },
+    {
+      "id": "capability:flow-orchestration",
+      "family": "capability",
+      "version": 1,
+      "description": "Recoverable Speckit flow state, artifact lineage, and implementation re-entry guidance.",
+      "paths": [
+        ".specify/state",
+        "docs/flow-orchestration.md",
+        "docs/generated-artifacts.md",
+        "manifests/catalog/flow-artifacts.json",
+        "schemas/runtime/flow-state.schema.json",
+        "scripts/runtime/flow-status.mjs",
+        "skills/speckit-analyze",
+        "skills/speckit-checklist",
+        "skills/speckit-clarify",
+        "skills/speckit-constitution",
+        "skills/speckit-implement",
+        "skills/speckit-plan",
+        "skills/speckit-specify",
+        "skills/speckit-tasks",
+        "skills/speckit-taskstoissues"
+      ],
+      "targets": [
+        "codex",
+        "claude-code"
+      ],
+      "dependencies": [
+        "baseline:agents",
+        "baseline:commands",
+        "capability:workflow-quality"
+      ],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": false,
+      "stability": "stable",
+      "tags": [
+        "flow",
+        "speckit",
+        "recovery"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Install when spec-to-implementation recovery and artifact lineage need to be first-class."
+      ]
+    },
+    {
+      "id": "capability:lifecycle-governance",
+      "family": "capability",
+      "version": 1,
+      "description": "Typed hooks, profiles, maintenance commands, compatibility reporting, and release validation.",
+      "paths": [
+        "docs/hooks",
+        "docs/profile-guide.md",
+        "docs/target-support-matrix.md",
+        "docs/maintenance-lifecycle.md",
+        "docs/quality-gates.md",
+        "manifests/hooks/index.json",
+        "manifests/profiles",
+        "manifests/catalog/compatibility-matrix.json",
+        "schemas/hooks/hook.schema.json",
+        "scripts/ci",
+        "targets/cursor/adapter.json",
+        "targets/opencode/adapter.json"
+      ],
+      "targets": [
+        "codex",
+        "claude-code",
+        "cursor",
+        "opencode"
+      ],
+      "dependencies": [
+        "baseline:agents",
+        "baseline:commands"
+      ],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": false,
+      "stability": "stable",
+      "tags": [
+        "governance",
+        "profiles",
+        "compatibility"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Install when release safety, support honesty, and maintenance diagnostics are required."
+      ]
+    },
+    {
+      "id": "capability:workload-skills",
+      "family": "capability",
+      "version": 1,
+      "description": "Operational and workload-specialized skills with explicit output contracts and references.",
+      "paths": [
+        "skills/README.md",
+        "skills/repo-onboarding",
+        "skills/security-scan",
+        "skills/release-readiness",
+        "skills/documentation-lookup",
+        "skills/architecture-decision-records",
+        "skills/incident-triage",
+        "skills/dependency-upgrade-safety",
+        "skills/performance-profiling",
+        "skills/test-strategy-and-coverage",
+        "skills/api-contract-review",
+        "skills/db-migration-review",
+        "skills/pr-triage-and-summary",
+        "skills/observability-setup",
+        "skills/repo-modernization"
+      ],
+      "targets": [
+        "codex",
+        "claude-code",
+        "cursor",
+        "opencode"
+      ],
+      "dependencies": [
+        "baseline:agents"
+      ],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": false,
+      "stability": "stable",
+      "tags": [
+        "skills",
+        "operations",
+        "workloads"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Install when tasks are dominated by triage, release, security, profiling, or modernization work."
+      ]
+    },
+    {
+      "id": "capability:local-observability",
+      "family": "capability",
+      "version": 1,
+      "description": "Local-first effectiveness tracking and reporting for recommendations, maintenance, and flow recovery.",
+      "paths": [
+        "docs/observability.md",
+        "scripts/runtime/report-effectiveness.mjs",
+        "scripts/knowledge/report-coverage.mjs",
+        "scripts/knowledge/report-drift.mjs"
+      ],
+      "targets": [
+        "codex",
+        "claude-code",
+        "cursor",
+        "opencode"
+      ],
+      "dependencies": [
+        "baseline:commands"
+      ],
+      "conflicts": [],
+      "optional": false,
+      "defaultInstall": false,
+      "stability": "stable",
+      "tags": [
+        "observability",
+        "local-first",
+        "diagnostics"
+      ],
+      "owner": "core",
+      "usageCues": [
+        "Install when you need local evidence for recommendation uptake, maintenance activity, and flow recovery."
+      ]
+    }
+  ]
+}

package/manifests/bundles/frameworks.json

@@ -0,0 +1,196 @@
+{
+  "bundles": [
+    {
+      "id": "framework:react",
+      "family": "framework",
+      "version": 1,
+      "description": "React component and application guidance.",
+      "paths": ["docs/catalog/frameworks/react.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:typescript"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["react", "framework", "frontend"],
+      "owner": "core",
+      "usageCues": ["Recommend when package.json declares react or the repo ships TSX components."]
+    },
+    {
+      "id": "framework:vite",
+      "family": "framework",
+      "version": 1,
+      "description": "Vite build and frontend project guidance.",
+      "paths": ["docs/catalog/frameworks/vite.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:typescript"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["vite", "framework", "frontend"],
+      "owner": "core",
+      "usageCues": ["Recommend when vite.config.* or a vite dependency is present."]
+    },
+    {
+      "id": "framework:express",
+      "family": "framework",
+      "version": 1,
+      "description": "Express service guidance.",
+      "paths": ["docs/catalog/frameworks/express.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:typescript"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["express", "framework", "service"],
+      "owner": "core",
+      "usageCues": ["Recommend when Express appears in package.json."]
+    },
+    {
+      "id": "framework:fastapi",
+      "family": "framework",
+      "version": 1,
+      "description": "FastAPI service guidance.",
+      "paths": ["docs/catalog/frameworks/fastapi.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:python"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["fastapi", "framework", "service"],
+      "owner": "core",
+      "usageCues": ["Recommend when FastAPI is declared in pyproject.toml or requirements.txt."]
+    },
+    {
+      "id": "framework:django",
+      "family": "framework",
+      "version": 1,
+      "description": "Django web application and service guidance.",
+      "paths": ["docs/catalog/frameworks/django.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:python"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["django", "framework", "service"],
+      "owner": "core",
+      "usageCues": ["Recommend when manage.py or Django dependencies are present."]
+    },
+    {
+      "id": "framework:spring-boot",
+      "family": "framework",
+      "version": 1,
+      "description": "Spring Boot service guidance.",
+      "paths": ["docs/catalog/frameworks/spring-boot.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:java"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["spring-boot", "framework", "service"],
+      "owner": "core",
+      "usageCues": ["Recommend when pom.xml or Gradle uses spring-boot."]
+    },
+    {
+      "id": "framework:aspnet-core",
+      "family": "framework",
+      "version": 1,
+      "description": "ASP.NET Core API and web guidance.",
+      "paths": ["docs/catalog/frameworks/aspnet-core.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:dotnet"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["aspnet-core", "framework", "service"],
+      "owner": "core",
+      "usageCues": ["Recommend when Microsoft.NET.Sdk.Web or WebApplication.CreateBuilder is present."]
+    },
+    {
+      "id": "framework:gin",
+      "family": "framework",
+      "version": 1,
+      "description": "Gin HTTP service guidance.",
+      "paths": ["docs/catalog/frameworks/gin.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:go"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["gin", "framework", "service"],
+      "owner": "core",
+      "usageCues": ["Recommend when go.mod references gin-gonic/gin."]
+    },
+    {
+      "id": "framework:ktor",
+      "family": "framework",
+      "version": 1,
+      "description": "Ktor server guidance.",
+      "paths": ["docs/catalog/frameworks/ktor.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:kotlin"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["ktor", "framework", "service"],
+      "owner": "core",
+      "usageCues": ["Recommend when Gradle references io.ktor."]
+    },
+    {
+      "id": "framework:symfony",
+      "family": "framework",
+      "version": 1,
+      "description": "Symfony PHP application guidance.",
+      "paths": ["docs/catalog/frameworks/symfony.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:php"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["symfony", "framework", "service"],
+      "owner": "core",
+      "usageCues": ["Recommend when composer.json references symfony/*."]
+    },
+    {
+      "id": "framework:nextjs",
+      "family": "framework",
+      "version": 1,
+      "description": "Next.js framework guidance.",
+      "paths": ["docs/catalog/frameworks/nextjs.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:typescript"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["nextjs", "framework", "frontend"],
+      "owner": "core",
+      "usageCues": ["Recommend when next.config.* or a next dependency is present."]
+    },
+    {
+      "id": "framework:laravel",
+      "family": "framework",
+      "version": 1,
+      "description": "Laravel framework guidance.",
+      "paths": ["docs/catalog/frameworks/laravel.md"],
+      "targets": ["codex", "claude-code", "cursor", "opencode"],
+      "dependencies": ["lang:php"],
+      "conflicts": [],
+      "optional": true,
+      "defaultInstall": false,
+      "stability": "beta",
+      "tags": ["laravel", "framework", "service"],
+      "owner": "core",
+      "usageCues": ["Recommend when artisan or composer.json references laravel/framework."]
+    }
+  ]
+}