@haus-tech/haus-workflow 0.1.0

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@haus-tech/haus-workflow",
+  "version": "0.1.0",
+  "description": "Haus AI workflow CLI for Claude Code.",
+  "type": "module",
+  "bin": {
+    "haus": "./dist/cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/WeAreHausTech/haus-workflow.git"
+  },
+  "homepage": "https://github.com/WeAreHausTech/haus-workflow",
+  "files": [
+    "dist",
+    "library/global",
+    "library/catalog",
+    "tests/fixtures/catalog",
+    "docs/user-guide.md",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --dts --clean --out-dir dist",
+    "dev": "tsx src/cli.ts",
+    "test": "node --test tests/**/*.test.js",
+    "lint": "eslint src scripts",
+    "format:check": "prettier --check src scripts",
+    "format:write": "prettier --write src scripts",
+    "typecheck": "tsc --noEmit",
+    "typecheck:scripts": "tsc --noEmit --project tsconfig.scripts.json",
+    "cleanup:status": "tsx scripts/cleanup-status.ts",
+    "bench:hooks": "tsx scripts/bench-hooks.ts",
+    "pack:local": "yarn pack",
+    "publish:dry": "npm pack --dry-run",
+    "publish:public": "yarn npm publish --access public",
+    "release": "GITHUB_TOKEN=$(gh auth token) release-it",
+    "release:dry": "GITHUB_TOKEN=$(gh auth token) release-it --dry-run",
+    "prepack": "yarn build",
+    "verify": "yarn typecheck && yarn typecheck:scripts && yarn lint && yarn build && yarn test",
+    "prepare": "husky",
+    "security:audit": "yarn npm audit -A -R --severity high --environment production"
+  },
+  "dependencies": {
+    "commander": "13.1.0",
+    "diff": "8.0.4",
+    "execa": "9.6.1",
+    "fast-glob": "3.3.3",
+    "fs-extra": "11.3.5",
+    "ignore": "6.0.2",
+    "picomatch": "4.0.4",
+    "semver": "7.8.0",
+    "yaml": "2.8.4",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@release-it/conventional-changelog": "11.0.0",
+    "@types/fs-extra": "11.0.4",
+    "@types/node": "22.19.17",
+    "@types/semver": "7.7.1",
+    "@typescript-eslint/eslint-plugin": "8.59.3",
+    "@typescript-eslint/parser": "8.59.3",
+    "eslint": "9.39.4",
+    "eslint-plugin-import": "2.32.0",
+    "husky": "9.1.7",
+    "lint-staged": "17.0.4",
+    "prettier": "3.8.3",
+    "release-it": "20.0.1",
+    "tsup": "8.5.1",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "yarn@4.15.0",
+  "lint-staged": {
+    "**/*.ts": [
+      "eslint",
+      "prettier --write"
+    ]
+  }
+}

package/tests/README.md

@@ -0,0 +1,70 @@
+# Tests
+
+Node built-in test runner (`node --test`). No framework. All test files are `.js` (compiled output not required — tests import from `dist/` via `fixture-runner.js`).
+
+```bash
+yarn test
+```
+
+## Structure
+
+| Path | Contents |
+|---|---|
+| `tests/*.test.js` | Unit and integration tests |
+| `tests/helpers/` | Shared test utilities |
+| `tests/fixtures/` | Static fixture repos used by tests |
+| `tests/golden/` | Golden output snapshots for scan/recommend/context |
+
+## helpers/fixture-runner.js
+
+Utilities for running the compiled CLI against fixture repos in a temp directory:
+
+- `cloneFixtureToTemp(fixtureName)` — copies `tests/fixtures/repos/<name>` to a temp dir, returns the path
+- `runHaus(cwd, command)` — runs `node dist/cli.js <command>` in `cwd`, returns stdout
+- `readHausJson(cwd, fileName)` — reads `.haus-workflow/<fileName>` as parsed JSON
+- `normalizeRecommendationForGolden(rec)` — stable sort for golden snapshot comparison
+- `normalizeContextForGolden(ctx)` — stable sort for golden snapshot comparison
+
+Tests that use `fixture-runner.js` require a built `dist/` — run `yarn build && yarn test`, or use `yarn verify` which builds before running tests.
+
+## fixtures/
+
+### fixtures/repos/
+
+Full fixture repos scanned by integration tests and golden tests. Each subdirectory is a minimal repo skeleton:
+
+| Fixture | Stack |
+|---|---|
+| `laravel-app` | Laravel (PHP, Composer, PHPUnit) |
+| `laravel-with-react-frontend` | Laravel + React (pnpm) |
+| `nest-graphql-api` | NestJS + GraphQL (Yarn) |
+| `nextjs-app` | Next.js (pnpm) |
+| `nx-workspace` | Nx monorepo (Yarn) |
+| `orphan-graphql-config` | GraphQL config without backend (pnpm) |
+| `turbo-monorepo` | Turborepo (Yarn) |
+| `vendure-monorepo` | Vendure e-commerce (Yarn) |
+| `vendure-with-nextjs-storefront` | Vendure + Next.js storefront (Yarn) |
+| `wordpress-bedrock-site` | WordPress Bedrock (Composer) |
+| `wordpress-with-node-tooling` | WordPress + Node tooling (pnpm) |
+
+### fixtures/findings/
+
+QA findings records (see `fixtures/findings/README.md`). Observational only — not gated by any test.
+
+### Other fixture dirs
+
+- `fixtures/dotnet-service/` — unsupported stack (C#/.NET), used to verify unsupported-stack handling
+- `fixtures/unsupported-go/` — unsupported stack (Go)
+- `fixtures/unsupported-python/` — unsupported stack (Python)
+- `fixtures/vendure-plugin/` — minimal Vendure plugin package
+- `fixtures/laravel-app/`, `fixtures/next-react-app/`, `fixtures/wordpress-bedrock/` — legacy shallow fixtures; prefer `fixtures/repos/` equivalents for new tests
+
+## golden/
+
+Snapshot files for `context-goldens.test.js` and `recommender.test.js`. Keyed by fixture name.
+
+- `golden/scans/` — `scanProject` output
+- `golden/recommendations/` — `runRecommend` output (normalized)
+- `golden/context/` — `runContext` output (normalized)
+
+To regenerate goldens after intentional recommender changes, delete the relevant `.json` file and re-run `yarn test` — the test will write the new snapshot and pass on the next run.

package/tests/fixtures/catalog/agents/code-reviewer.md

@@ -0,0 +1,15 @@
+---
+description: Fixture stub agent for CLI tests.
+---
+
+## Use when
+
+Use when working on the relevant task.
+
+## Do not use when
+
+Do not use for unrelated tasks.
+
+## Verification
+
+Check that the output matches expectations.

package/tests/fixtures/catalog/agents/docs-researcher.md

@@ -0,0 +1,15 @@
+---
+description: Fixture stub agent for CLI tests.
+---
+
+## Use when
+
+Use when working on the relevant task.
+
+## Do not use when
+
+Do not use for unrelated tasks.
+
+## Verification
+
+Check that the output matches expectations.

package/tests/fixtures/catalog/agents/planner.md

@@ -0,0 +1,15 @@
+---
+description: Fixture stub agent for CLI tests.
+---
+
+## Use when
+
+Use when working on the relevant task.
+
+## Do not use when
+
+Do not use for unrelated tasks.
+
+## Verification
+
+Check that the output matches expectations.

package/tests/fixtures/catalog/agents/security-reviewer.md

@@ -0,0 +1,15 @@
+---
+description: Fixture stub agent for CLI tests.
+---
+
+## Use when
+
+Use when working on the relevant task.
+
+## Do not use when
+
+Do not use for unrelated tasks.
+
+## Verification
+
+Check that the output matches expectations.

package/tests/fixtures/catalog/agents/test-reviewer.md

@@ -0,0 +1,15 @@
+---
+description: Fixture stub agent for CLI tests.
+---
+
+## Use when
+
+Use when working on the relevant task.
+
+## Do not use when
+
+Do not use for unrelated tasks.
+
+## Verification
+
+Check that the output matches expectations.