specforge-mcp 0.1.0

package/dist/config/idp-tools.json

@@ -0,0 +1,173 @@
+{
+  "_description": "IDP tools catalog for Platform Engineering recommendations (SPEC-048)",
+  "developerPortals": [
+    {
+      "name": "Backstage",
+      "vendor": "Spotify / CNCF",
+      "type": "open-source",
+      "teamSizeMin": 20,
+      "hosted": false,
+      "url": "https://backstage.io",
+      "description": "CNCF open-source IDP with rich plugin ecosystem: software catalog, TechDocs, scaffolder, search",
+      "useCases": ["software-catalog", "documentation", "scaffolding", "search", "api-catalog"]
+    },
+    {
+      "name": "Port",
+      "vendor": "Port.io",
+      "type": "saas",
+      "teamSizeMin": 5,
+      "hosted": true,
+      "url": "https://getport.io",
+      "description": "API-driven SaaS IDP. Fast adoption (days not months), flexible data model, self-service actions",
+      "useCases": ["software-catalog", "self-service", "scorecards", "automations"]
+    },
+    {
+      "name": "Cortex",
+      "vendor": "Cortex",
+      "type": "saas",
+      "teamSizeMin": 10,
+      "hosted": true,
+      "url": "https://cortex.io",
+      "description": "Engineering intelligence platform. Service scorecards, maturity tracking, DORA metrics integration",
+      "useCases": ["scorecards", "dora-metrics", "service-catalog", "on-call"]
+    },
+    {
+      "name": "Humanitec",
+      "vendor": "Humanitec",
+      "type": "enterprise",
+      "teamSizeMin": 50,
+      "hosted": true,
+      "url": "https://humanitec.com",
+      "description": "Platform Orchestrator for enterprise-scale dynamic configuration management across environments",
+      "useCases": ["platform-orchestration", "dynamic-config", "multi-environment"]
+    }
+  ],
+  "selfServiceInfra": [
+    {
+      "name": "Crossplane",
+      "vendor": "CNCF",
+      "type": "open-source",
+      "url": "https://crossplane.io",
+      "description": "Kubernetes-native IaC — provision databases, queues, cloud resources as K8s custom resources",
+      "useCases": ["self-service-databases", "self-service-queues", "cloud-resource-provisioning"]
+    },
+    {
+      "name": "ArgoCD + ApplicationSets",
+      "vendor": "CNCF",
+      "type": "open-source",
+      "url": "https://argo-cd.readthedocs.io",
+      "description": "GitOps multi-tenant deployments — ApplicationSets generate ArgoCD apps for each team",
+      "useCases": ["gitops", "multi-tenant-deployments", "self-service-deploys"]
+    },
+    {
+      "name": "Backstage Software Templates",
+      "vendor": "Spotify / CNCF",
+      "type": "open-source",
+      "url": "https://backstage.io/docs/features/software-templates/",
+      "description": "Scaffolding engine for golden path templates — new service, new library, new API",
+      "useCases": ["service-scaffolding", "golden-path", "template-automation"]
+    },
+    {
+      "name": "Dagger",
+      "vendor": "Dagger",
+      "type": "open-source",
+      "url": "https://dagger.io",
+      "description": "Portable CI/CD as code — same pipeline runs locally and in CI, any language",
+      "useCases": ["portable-ci", "reproducible-builds", "local-ci-testing"]
+    }
+  ],
+  "doraTools": [
+    {
+      "name": "Faros.ai",
+      "vendor": "Faros",
+      "type": "open-source",
+      "url": "https://faros.ai",
+      "sources": ["GitHub", "GitLab", "Jira", "PagerDuty", "CircleCI", "Jenkins"],
+      "description": "Open-source engineering intelligence platform. Self-hosted, multi-source DORA metrics"
+    },
+    {
+      "name": "LinearB",
+      "vendor": "LinearB",
+      "type": "saas",
+      "url": "https://linearb.io",
+      "sources": ["GitHub", "GitLab", "Jira", "Linear"],
+      "description": "Developer productivity metrics — DORA, cycle time, PR analytics, team benchmarking"
+    },
+    {
+      "name": "Cortex",
+      "vendor": "Cortex",
+      "type": "saas",
+      "url": "https://cortex.io",
+      "sources": ["GitHub", "PagerDuty", "Datadog", "Jira"],
+      "description": "Engineering intelligence with service scorecards and DORA integration"
+    },
+    {
+      "name": "GitHub Insights",
+      "vendor": "GitHub",
+      "type": "included",
+      "url": "https://github.com/features/insights",
+      "sources": ["GitHub"],
+      "description": "Basic deployment frequency and PR metrics — included with GitHub, limited to GitHub data"
+    }
+  ],
+  "complianceAsCode": [
+    {
+      "name": "OPA + Conftest",
+      "vendor": "CNCF",
+      "type": "open-source",
+      "url": "https://www.openpolicyagent.org/",
+      "description": "Rego policy enforcement in CI — validate Terraform, Kubernetes manifests, Dockerfiles",
+      "useCases": ["policy-enforcement", "ci-gates", "kubernetes-admission"]
+    },
+    {
+      "name": "Kyverno",
+      "vendor": "CNCF",
+      "type": "open-source",
+      "url": "https://kyverno.io",
+      "description": "Kubernetes-native policy engine — mutate, validate, generate K8s resources",
+      "useCases": ["k8s-policy", "admission-control", "resource-generation"]
+    },
+    {
+      "name": "Drata",
+      "vendor": "Drata",
+      "type": "saas",
+      "url": "https://drata.com",
+      "description": "SOC2 and ISO27001 automation — continuous compliance evidence collection",
+      "useCases": ["soc2-automation", "iso27001", "compliance-evidence"]
+    },
+    {
+      "name": "Vanta",
+      "vendor": "Vanta",
+      "type": "saas",
+      "url": "https://vanta.com",
+      "description": "Security compliance platform — SOC2, HIPAA, ISO27001 automated evidence",
+      "useCases": ["soc2", "hipaa", "iso27001", "gdpr"]
+    }
+  ],
+  "devEnvironments": [
+    {
+      "name": "Dev Containers",
+      "vendor": "Microsoft / Open Spec",
+      "type": "open-source",
+      "url": "https://containers.dev",
+      "description": "Reproducible containerized dev environment — works with VS Code, JetBrains, GitHub Codespaces",
+      "useCases": ["reproducible-dev-env", "onboarding", "remote-development"]
+    },
+    {
+      "name": "Nix / NixOS",
+      "vendor": "NixOS Foundation",
+      "type": "open-source",
+      "url": "https://nixos.org",
+      "description": "Fully reproducible development environment via flake.nix — exact dependency pinning",
+      "useCases": ["reproducible-dev-env", "hermetic-builds", "multi-language-projects"]
+    },
+    {
+      "name": "GitHub Codespaces",
+      "vendor": "GitHub",
+      "type": "saas",
+      "url": "https://github.com/features/codespaces",
+      "description": "Cloud-based dev environments — browser or VS Code, instant onboarding",
+      "useCases": ["instant-onboarding", "remote-development", "zero-setup"]
+    }
+  ]
+}

package/dist/config/linter-registry.json

@@ -0,0 +1,451 @@
+{
+  "_description": "Registry of linters and formatters by language with config files, known conflicts, and recommendations",
+  "typescript": {
+    "recommended": ["eslint", "prettier", "stylelint"],
+    "alternates": ["biome", "oxlint"],
+    "transversal": ["commitlint", "markdownlint", "hadolint", "actionlint", "shellcheck"],
+    "linters": {
+      "eslint": {
+        "configFiles": [
+          ".eslintrc",
+          ".eslintrc.js",
+          ".eslintrc.json",
+          ".eslintrc.yml",
+          ".eslintrc.yaml",
+          ".eslintrc.cjs",
+          "eslint.config.js",
+          "eslint.config.mjs",
+          "eslint.config.cjs",
+          "eslint.config.ts"
+        ],
+        "npmPkg": "eslint",
+        "installCmd": "npm install -D eslint @eslint/js",
+        "docsUrl": "https://eslint.org/docs/latest/",
+        "purpose": "linting"
+      },
+      "biome": {
+        "configFiles": ["biome.json", "biome.jsonc"],
+        "npmPkg": "@biomejs/biome",
+        "installCmd": "npm install -D @biomejs/biome",
+        "docsUrl": "https://biomejs.dev/",
+        "purpose": "linting+formatting"
+      },
+      "prettier": {
+        "configFiles": [
+          ".prettierrc",
+          ".prettierrc.js",
+          ".prettierrc.json",
+          ".prettierrc.yml",
+          ".prettierrc.yaml",
+          ".prettierrc.cjs",
+          ".prettierrc.toml",
+          "prettier.config.js",
+          "prettier.config.mjs",
+          "prettier.config.cjs"
+        ],
+        "npmPkg": "prettier",
+        "installCmd": "npm install -D prettier",
+        "docsUrl": "https://prettier.io/docs/",
+        "purpose": "formatting"
+      },
+      "stylelint": {
+        "configFiles": [
+          ".stylelintrc",
+          ".stylelintrc.js",
+          ".stylelintrc.json",
+          ".stylelintrc.yml",
+          ".stylelintrc.yaml",
+          ".stylelintrc.cjs",
+          "stylelint.config.js",
+          "stylelint.config.cjs",
+          "stylelint.config.mjs"
+        ],
+        "npmPkg": "stylelint",
+        "installCmd": "npm install -D stylelint",
+        "docsUrl": "https://stylelint.io/",
+        "purpose": "css-linting"
+      },
+      "oxlint": {
+        "configFiles": [".oxlintrc.json", "oxlint.config.js"],
+        "npmPkg": "oxlint",
+        "installCmd": "npm install -D oxlint",
+        "docsUrl": "https://oxc.rs/docs/guide/usage/linter",
+        "purpose": "linting"
+      }
+    }
+  },
+  "javascript": {
+    "recommended": ["eslint", "prettier"],
+    "alternates": ["biome"],
+    "transversal": ["commitlint", "markdownlint"],
+    "linters": {
+      "eslint": {
+        "configFiles": [
+          ".eslintrc",
+          ".eslintrc.js",
+          ".eslintrc.json",
+          ".eslintrc.yml",
+          "eslint.config.js",
+          "eslint.config.mjs"
+        ],
+        "npmPkg": "eslint",
+        "installCmd": "npm install -D eslint",
+        "docsUrl": "https://eslint.org/docs/latest/",
+        "purpose": "linting"
+      },
+      "biome": {
+        "configFiles": ["biome.json", "biome.jsonc"],
+        "npmPkg": "@biomejs/biome",
+        "installCmd": "npm install -D @biomejs/biome",
+        "docsUrl": "https://biomejs.dev/",
+        "purpose": "linting+formatting"
+      },
+      "prettier": {
+        "configFiles": [".prettierrc", ".prettierrc.js", ".prettierrc.json", "prettier.config.js"],
+        "npmPkg": "prettier",
+        "installCmd": "npm install -D prettier",
+        "docsUrl": "https://prettier.io/docs/",
+        "purpose": "formatting"
+      }
+    }
+  },
+  "python": {
+    "recommended": ["ruff", "mypy"],
+    "alternates": ["pylint", "black", "isort"],
+    "transversal": ["commitlint", "markdownlint"],
+    "linters": {
+      "ruff": {
+        "configFiles": ["ruff.toml", "pyproject.toml", ".ruff.toml"],
+        "purpose": "linting+formatting",
+        "installCmd": "pip install ruff",
+        "docsUrl": "https://docs.astral.sh/ruff/"
+      },
+      "pylint": {
+        "configFiles": [".pylintrc", "pyproject.toml", "setup.cfg"],
+        "purpose": "linting",
+        "installCmd": "pip install pylint",
+        "docsUrl": "https://pylint.readthedocs.io/"
+      },
+      "mypy": {
+        "configFiles": ["mypy.ini", "pyproject.toml", "setup.cfg", ".mypy.ini"],
+        "purpose": "type-checking",
+        "installCmd": "pip install mypy",
+        "docsUrl": "https://mypy.readthedocs.io/"
+      },
+      "black": {
+        "configFiles": ["pyproject.toml", "black.toml"],
+        "purpose": "formatting",
+        "installCmd": "pip install black",
+        "docsUrl": "https://black.readthedocs.io/"
+      },
+      "isort": {
+        "configFiles": [".isort.cfg", "pyproject.toml", "setup.cfg"],
+        "purpose": "import-sorting",
+        "installCmd": "pip install isort",
+        "docsUrl": "https://pycqa.github.io/isort/"
+      }
+    }
+  },
+  "go": {
+    "recommended": ["golangci-lint"],
+    "alternates": ["gofmt", "govet"],
+    "transversal": ["commitlint", "markdownlint"],
+    "linters": {
+      "golangci-lint": {
+        "configFiles": [".golangci.yml", ".golangci.yaml", ".golangci.toml", ".golangci.json"],
+        "purpose": "linting",
+        "installCmd": "go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest",
+        "docsUrl": "https://golangci-lint.run/"
+      },
+      "gofmt": {
+        "configFiles": [],
+        "purpose": "formatting",
+        "installCmd": "Included with Go installation",
+        "docsUrl": "https://pkg.go.dev/cmd/gofmt"
+      }
+    }
+  },
+  "rust": {
+    "recommended": ["clippy", "rustfmt"],
+    "alternates": [],
+    "transversal": ["commitlint"],
+    "linters": {
+      "clippy": {
+        "configFiles": ["clippy.toml", ".clippy.toml"],
+        "purpose": "linting",
+        "installCmd": "rustup component add clippy",
+        "docsUrl": "https://doc.rust-lang.org/clippy/"
+      },
+      "rustfmt": {
+        "configFiles": ["rustfmt.toml", ".rustfmt.toml"],
+        "purpose": "formatting",
+        "installCmd": "rustup component add rustfmt",
+        "docsUrl": "https://rust-lang.github.io/rustfmt/"
+      }
+    }
+  },
+  "java": {
+    "recommended": ["checkstyle", "spotless"],
+    "alternates": [],
+    "transversal": ["commitlint", "markdownlint"],
+    "linters": {
+      "checkstyle": {
+        "configFiles": ["checkstyle.xml", ".checkstyle.xml", "config/checkstyle/checkstyle.xml"],
+        "purpose": "linting",
+        "installCmd": "Add checkstyle plugin to pom.xml or build.gradle",
+        "docsUrl": "https://checkstyle.sourceforge.io/"
+      },
+      "spotless": {
+        "configFiles": ["build.gradle", "build.gradle.kts", "pom.xml"],
+        "purpose": "formatting",
+        "installCmd": "Add spotless plugin to build.gradle",
+        "docsUrl": "https://github.com/diffplug/spotless"
+      }
+    }
+  },
+  "swift": {
+    "recommended": ["swiftlint", "swiftformat", "periphery"],
+    "alternates": [],
+    "transversal": ["commitlint"],
+    "linters": {
+      "swiftlint": {
+        "configFiles": [".swiftlint.yml", ".swiftlint.yaml"],
+        "purpose": "linting",
+        "installCmd": "brew install swiftlint",
+        "docsUrl": "https://realm.github.io/SwiftLint/"
+      },
+      "swiftformat": {
+        "configFiles": [".swiftformat"],
+        "purpose": "formatting",
+        "installCmd": "brew install swiftformat",
+        "docsUrl": "https://github.com/nicklockwood/SwiftFormat"
+      },
+      "periphery": {
+        "configFiles": [".periphery.yml"],
+        "purpose": "dead-code",
+        "installCmd": "brew install peripheryapp/periphery/periphery",
+        "docsUrl": "https://github.com/peripheryapp/periphery"
+      }
+    }
+  },
+  "kotlin": {
+    "recommended": ["detekt", "ktlint"],
+    "alternates": ["android-lint"],
+    "transversal": ["commitlint"],
+    "linters": {
+      "detekt": {
+        "configFiles": ["detekt.yml", "detekt.yaml", "config/detekt/detekt.yml"],
+        "purpose": "linting",
+        "installCmd": "Add detekt plugin to build.gradle.kts",
+        "docsUrl": "https://detekt.dev/"
+      },
+      "ktlint": {
+        "configFiles": [".editorconfig", ".ktlint"],
+        "purpose": "formatting",
+        "installCmd": "brew install ktlint",
+        "docsUrl": "https://pinterest.github.io/ktlint/"
+      }
+    }
+  },
+  "php": {
+    "recommended": ["phpstan", "php-cs-fixer"],
+    "alternates": ["phpcs"],
+    "transversal": ["commitlint"],
+    "linters": {
+      "phpstan": {
+        "configFiles": ["phpstan.neon", "phpstan.neon.dist"],
+        "purpose": "static-analysis",
+        "installCmd": "composer require --dev phpstan/phpstan",
+        "docsUrl": "https://phpstan.org/"
+      },
+      "php-cs-fixer": {
+        "configFiles": [".php-cs-fixer.php", ".php-cs-fixer.dist.php"],
+        "purpose": "formatting",
+        "installCmd": "composer require --dev friendsofphp/php-cs-fixer",
+        "docsUrl": "https://cs.symfony.com/"
+      }
+    }
+  },
+  "ruby": {
+    "recommended": ["rubocop"],
+    "alternates": [],
+    "transversal": ["commitlint"],
+    "linters": {
+      "rubocop": {
+        "configFiles": [".rubocop.yml"],
+        "purpose": "linting+formatting",
+        "installCmd": "gem install rubocop",
+        "docsUrl": "https://rubocop.org/"
+      }
+    }
+  },
+  "csharp": {
+    "recommended": ["dotnet-format", "roslyn-analyzers"],
+    "alternates": ["stylecop"],
+    "transversal": ["commitlint"],
+    "linters": {
+      "dotnet-format": {
+        "configFiles": [".editorconfig", "Directory.Build.props"],
+        "purpose": "formatting",
+        "installCmd": "dotnet format",
+        "docsUrl": "https://learn.microsoft.com/dotnet/core/tools/dotnet-format"
+      },
+      "roslyn-analyzers": {
+        "configFiles": [".editorconfig", "*.csproj"],
+        "purpose": "static-analysis",
+        "installCmd": "Included in .NET SDK",
+        "docsUrl": "https://learn.microsoft.com/dotnet/fundamentals/code-analysis/overview"
+      },
+      "stylecop": {
+        "configFiles": ["stylecop.json", ".editorconfig"],
+        "purpose": "style-enforcement",
+        "installCmd": "dotnet add package StyleCop.Analyzers",
+        "docsUrl": "https://github.com/DotNetAnalyzers/StyleCopAnalyzers"
+      }
+    }
+  },
+  "dart": {
+    "recommended": ["dart-analyze", "dart-format", "flutter-lints"],
+    "alternates": [],
+    "transversal": ["commitlint"],
+    "linters": {
+      "dart-analyze": {
+        "configFiles": ["analysis_options.yaml"],
+        "purpose": "static-analysis",
+        "installCmd": "dart analyze",
+        "docsUrl": "https://dart.dev/tools/dart-analyze"
+      },
+      "dart-format": {
+        "configFiles": [],
+        "purpose": "formatting",
+        "installCmd": "dart format .",
+        "docsUrl": "https://dart.dev/tools/dart-format"
+      },
+      "flutter-lints": {
+        "configFiles": ["analysis_options.yaml", "pubspec.yaml"],
+        "purpose": "linting",
+        "installCmd": "Add flutter_lints to pubspec.yaml",
+        "docsUrl": "https://pub.dev/packages/flutter_lints"
+      }
+    }
+  },
+  "elixir": {
+    "recommended": ["credo", "dialyxir"],
+    "alternates": ["mix-format"],
+    "transversal": ["commitlint"],
+    "linters": {
+      "credo": {
+        "configFiles": [".credo.exs"],
+        "purpose": "static-analysis",
+        "installCmd": "Add {:credo, \"~> 1.7\"} to mix.exs",
+        "docsUrl": "https://hexdocs.pm/credo/"
+      },
+      "dialyxir": {
+        "configFiles": [".dialyzer_ignore.exs"],
+        "purpose": "type-checking",
+        "installCmd": "Add {:dialyxir, \"~> 1.4\"} to mix.exs",
+        "docsUrl": "https://hexdocs.pm/dialyxir/"
+      },
+      "mix-format": {
+        "configFiles": [".formatter.exs"],
+        "purpose": "formatting",
+        "installCmd": "mix format",
+        "docsUrl": "https://hexdocs.pm/mix/Mix.Tasks.Format.html"
+      }
+    }
+  },
+  "scala": {
+    "recommended": ["scalafmt", "scalafix"],
+    "alternates": ["wartremover"],
+    "transversal": ["commitlint"],
+    "linters": {
+      "scalafmt": {
+        "configFiles": [".scalafmt.conf"],
+        "purpose": "formatting",
+        "installCmd": "Add sbt-scalafmt plugin to project/plugins.sbt",
+        "docsUrl": "https://scalameta.org/scalafmt/"
+      },
+      "scalafix": {
+        "configFiles": [".scalafix.conf"],
+        "purpose": "linting+refactoring",
+        "installCmd": "Add sbt-scalafix plugin to project/plugins.sbt",
+        "docsUrl": "https://scalacenter.github.io/scalafix/"
+      },
+      "wartremover": {
+        "configFiles": ["build.sbt"],
+        "purpose": "wart-detection",
+        "installCmd": "Add sbt-wartremover plugin to project/plugins.sbt",
+        "docsUrl": "https://www.wartremover.org/"
+      }
+    }
+  },
+  "c": {
+    "recommended": ["clang-tidy", "clang-format", "cppcheck"],
+    "alternates": [],
+    "transversal": ["commitlint"],
+    "linters": {
+      "clang-tidy": {
+        "configFiles": [".clang-tidy"],
+        "purpose": "static-analysis",
+        "installCmd": "brew install llvm",
+        "docsUrl": "https://clang.llvm.org/extra/clang-tidy/"
+      },
+      "clang-format": {
+        "configFiles": [".clang-format"],
+        "purpose": "formatting",
+        "installCmd": "brew install clang-format",
+        "docsUrl": "https://clang.llvm.org/docs/ClangFormat.html"
+      },
+      "cppcheck": {
+        "configFiles": [".cppcheck", "compile_commands.json"],
+        "purpose": "static-analysis",
+        "installCmd": "brew install cppcheck",
+        "docsUrl": "https://cppcheck.sourceforge.io/"
+      }
+    }
+  },
+  "conflicts": [
+    {
+      "linters": ["eslint", "biome"],
+      "conflictType": "rule-contradiction",
+      "description": "Both ESLint and Biome are configured. They overlap significantly in linting rules.",
+      "resolution": "Choose one. Biome is faster; ESLint has more plugins. If migrating, use `biome migrate`."
+    },
+    {
+      "linters": ["prettier", "biome"],
+      "conflictType": "formatting-overlap",
+      "description": "Both Prettier and Biome handle formatting.",
+      "resolution": "Biome includes a Prettier-compatible formatter. Remove Prettier if using Biome."
+    },
+    {
+      "linters": ["eslint", "prettier"],
+      "conflictType": "formatting-overlap",
+      "description": "ESLint formatting rules may conflict with Prettier. Both can format code differently.",
+      "resolution": "Install `eslint-config-prettier` to disable ESLint rules that conflict with Prettier."
+    },
+    {
+      "linters": ["ruff", "black"],
+      "conflictType": "formatting-overlap",
+      "description": "Ruff includes a formatter (replacement for Black). Running both causes redundancy.",
+      "resolution": "Use Ruff's formatter (`ruff format`) and remove Black, or keep Black and disable Ruff format."
+    },
+    {
+      "linters": ["ruff", "isort"],
+      "conflictType": "rule-contradiction",
+      "description": "Ruff includes isort-compatible import sorting. Running both may conflict.",
+      "resolution": "Enable Ruff's I rules (`ruff check --select I`) and remove isort."
+    },
+    {
+      "linters": ["ruff", "pylint"],
+      "conflictType": "rule-contradiction",
+      "description": "Ruff covers most Pylint rules with much faster execution.",
+      "resolution": "Consider replacing Pylint with Ruff. Check which Pylint rules Ruff doesn't cover yet."
+    },
+    {
+      "linters": ["dart-analyze", "flutter-lints"],
+      "conflictType": "rule-contradiction",
+      "description": "flutter_lints extends analysis_options.yaml. Custom analysis_options may override or conflict with flutter_lints rules.",
+      "resolution": "Include flutter_lints as a package: import rule in analysis_options.yaml and add custom rules below it, not instead of it."
+    }
+  ]
+}