karajan-code 3.5.0 → 3.5.1

package/README.md

@@ -23,7 +23,7 @@
 
 ---
 
-> **v3.5.0 released** — Quality harness: `kj harden` brings the guardrails Karajan was built with to any repo in one command — idempotent git hooks, lint/format/commit config, CI quality gates and agent guidelines, all stack-aware and behind `kj:managed` markers that never overwrite your content. Native per-language hook commands mean hardening a Go/Python/Java repo never makes Node a commit-time dependency. `kj check` verifies the harness as a CI drift gate, and `kj init` installs it out of the box. Full notes in [CHANGELOG.md](CHANGELOG.md).
+> **v3.5.1 released** — PHP joins the quality harness as a first-class language: `kj harden` now detects `composer.json`, installs PHP-native hooks (`phpstan` / `php-cs-fixer` / `phpunit`), a `phpstan.neon` config and a `setup-php` CI workflow — same as JS/Python/Go, no npm/Node imposed at commit time. Builds on v3.5.0's quality harness (`kj harden` + `kj check`): idempotent git hooks, config, CI gates and agent guidelines for any repo, behind `kj:managed` markers. Full notes in [CHANGELOG.md](CHANGELOG.md).
 
 You describe what you want to build. Karajan orchestrates multiple AI agents to plan it, implement it, test it, review it with SonarQube, and iterate. No babysitting required.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karajan-code",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "Local multi-agent coding orchestrator with TDD, SonarQube, and code review pipeline",
   "type": "module",
   "license": "AGPL-3.0",

package/src/harden/config-templates.js

@@ -103,10 +103,15 @@ export const JS_CONFIGS = [
 export const PY_CONFIGS = [{ file: "ruff.toml", blockId: "ruff", style: "hash", body: RUFF_BODY }];
 export const GO_CONFIGS = [{ file: ".golangci.yml", blockId: "golangci", style: "hash", body: GOLANGCI_BODY }];
 
+// PHPStan static analysis — the PHP analogue of ruff/golangci.
+export const PHPSTAN_BODY = ["parameters:", "  level: 6", "  paths:", "    - src", "    - tests"].join("\n");
+export const PHP_CONFIGS = [{ file: "phpstan.neon", blockId: "phpstan", style: "hash", body: PHPSTAN_BODY }];
+
 /** Lint/format configs by detected language. Unknown ⇒ universal only. */
 export const CONFIGS_BY_LANGUAGE = {
   javascript: JS_CONFIGS,
   typescript: JS_CONFIGS,
   python: PY_CONFIGS,
   go: GO_CONFIGS,
+  php: PHP_CONFIGS,
 };

package/src/harden/hook-commands.js

@@ -12,6 +12,11 @@
 export const COMMANDS_BY_LANGUAGE = {
   python: { lint: "ruff check .", format: "ruff format --check .", test: "pytest" },
   go: { lint: "go vet ./...", format: 'test -z "$(gofmt -l .)"', test: "go test ./..." },
+  php: {
+    lint: "vendor/bin/phpstan analyse --no-progress",
+    format: "vendor/bin/php-cs-fixer fix --dry-run --diff",
+    test: "vendor/bin/phpunit",
+  },
 };
 
 /** Native commands for a language, or {} when JS/TS or unknown. */

package/src/harden/stack-roots.js

@@ -39,6 +39,7 @@ export function languageAt(dir) {
   }
   if (["pyproject.toml", "requirements.txt", "setup.py"].some((f) => existsSync(join(dir, f)))) return "python";
   if (existsSync(join(dir, "go.mod"))) return "go";
+  if (existsSync(join(dir, "composer.json"))) return "php";
   return null;
 }
 

package/src/harden/workflow-templates.js

@@ -78,6 +78,14 @@ const QUALITY_BY_LANGUAGE = {
     "      - run: go vet ./...",
     "      - run: go test ./...",
   ]),
+  php: header([
+    "      - uses: shivammathur/setup-php@v2",
+    "        with:",
+    "          php-version: '8.3'",
+    "      - run: composer install --no-interaction --no-progress",
+    "      - run: vendor/bin/phpstan analyse --no-progress",
+    "      - run: vendor/bin/phpunit",
+  ]),
 };
 QUALITY_BY_LANGUAGE.typescript = QUALITY_BY_LANGUAGE.javascript;