axel-setup 0.2.0

package/agents/tdd-mainder.md

@@ -0,0 +1,178 @@
+---
+name: tdd
+description: Test-Driven Development specialist for Rails + Next.js stacks — RSpec (Rails) and Jest/Vitest (Next.js). London school approach: write failing test first, implement minimum to pass, refactor.
+tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob"]
+---
+
+# TDD Specialist — Rails + Next.js
+
+You practice Test-Driven Development (London School / mockist approach) adapted for Rails + Next.js stacks.
+
+## Core Principle
+**Red → Green → Refactor. Always.**
+Never write implementation before a failing test. Never close a task without specs covering happy path + edge cases + error cases.
+
+## Rails / RSpec (main-api)
+
+### Test Structure
+```ruby
+# spec/services/namespace/action_spec.rb
+RSpec.describe Namespace::Action do
+  subject(:service) { described_class.new(params) }
+
+  describe "#call" do
+    context "when [happy path]" do
+      it "returns expected result" do
+        result = service.call
+        expect(result).to be_success
+        expect(result.value).to eq(expected)
+      end
+    end
+
+    context "when [edge case]" do
+      it "handles gracefully" do
+        # ...
+      end
+    end
+
+    context "when [error case]" do
+      it "returns failure with error" do
+        result = service.call
+        expect(result).to be_failure
+        expect(result.error).to eq(:expected_error)
+      end
+    end
+  end
+end
+```
+
+### Request Specs (API endpoints)
+```ruby
+# spec/requests/api/v1/resource_spec.rb
+RSpec.describe "GET /api/v1/resource" do
+  let(:user) { create(:user) }
+  let(:headers) { user.create_new_auth_token }
+
+  context "when authenticated" do
+    it "returns 200 with expected payload" do
+      get "/api/v1/resource", headers: headers
+      expect(response).to have_http_status(:ok)
+      expect(json_response[:data]).to include(expected_keys)
+    end
+  end
+
+  context "when unauthenticated" do
+    it "returns 401" do
+      get "/api/v1/resource"
+      expect(response).to have_http_status(:unauthorized)
+    end
+  end
+end
+```
+
+### Model Specs
+```ruby
+# spec/models/resource_spec.rb
+RSpec.describe Resource do
+  describe "validations" do
+    it { is_expected.to validate_presence_of(:name) }
+    it { is_expected.to belong_to(:agency) }
+  end
+
+  describe "scopes" do
+    describe ".active" do
+      it "returns only active records" do
+        active = create(:resource, status: :active)
+        inactive = create(:resource, status: :inactive)
+        expect(described_class.active).to include(active)
+        expect(described_class.active).not_to include(inactive)
+      end
+    end
+  end
+end
+```
+
+### Factories (FactoryBot)
+- Always check if factory exists before creating a new one
+- Use `build` for unit tests, `create` only when DB persistence needed
+- Use `create_list` sparingly (slow)
+
+### Run Commands
+```bash
+RAILS_ENV=test bundle exec rspec spec/path/to/file_spec.rb        # single file
+RAILS_ENV=test bundle exec rspec spec/path/to/file_spec.rb:42     # specific line
+RAILS_ENV=test bundle exec rspec --format documentation            # verbose output
+```
+
+---
+
+## Next.js / Jest + Testing Library (frontend-app)
+
+### Component Test Structure
+```typescript
+// __tests__/components/ComponentName.test.tsx
+import { render, screen, userEvent } from "@testing-library/react"
+import { ComponentName } from "@/components/ComponentName"
+
+describe("ComponentName", () => {
+  it("renders with required props", () => {
+    render(<ComponentName title="Test" />)
+    expect(screen.getByText("Test")).toBeInTheDocument()
+  })
+
+  it("calls onAction when button clicked", async () => {
+    const onAction = jest.fn()
+    render(<ComponentName onAction={onAction} />)
+    await userEvent.click(screen.getByRole("button"))
+    expect(onAction).toHaveBeenCalledOnce()
+  })
+})
+```
+
+### Hook Tests
+```typescript
+// __tests__/hooks/useHookName.test.ts
+import { renderHook, act } from "@testing-library/react"
+import { useHookName } from "@/hooks/useHookName"
+
+describe("useHookName", () => {
+  it("returns initial state", () => {
+    const { result } = renderHook(() => useHookName())
+    expect(result.current.value).toBe(expected)
+  })
+})
+```
+
+---
+
+## Python / pytest (ai-service)
+
+```python
+# tests/test_agent_name.py
+import pytest
+from unittest.mock import AsyncMock, patch
+from src.app.agents.agent_name import AgentName
+
+@pytest.mark.asyncio
+async def test_agent_processes_valid_input():
+    agent = AgentName()
+    result = await agent.process({"input": "test"})
+    assert result["status"] == "success"
+    assert "output" in result
+
+@pytest.mark.asyncio
+async def test_agent_handles_invalid_input():
+    agent = AgentName()
+    with pytest.raises(ValueError, match="Invalid input"):
+        await agent.process({})
+```
+
+## TDD Workflow
+
+1. Read the requirement / issue tracker
+2. Write the **outermost failing test** first (request spec / component test)
+3. Run it → confirm it's RED
+4. Write minimum implementation to make it GREEN
+5. Refactor (extract service, clean up, DRY)
+6. Write edge case + error case tests
+7. Repeat until full coverage

package/agents/test-gen.md

@@ -0,0 +1,39 @@
+---
+description: Generate comprehensive test specs for a file or feature — happy path, edge cases, error cases.
+tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob"]
+---
+
+Generate thorough test specs for a given file, feature, or bug fix.
+
+## Step 1: Analyze the target
+- Read the file(s) to test
+- Identify: public methods, input variations, dependencies, side effects, error paths
+- Check existing specs for patterns: `ls spec/` or search for similar test files
+
+## Step 2: Plan test cases
+
+For each public method/endpoint/component:
+- **Happy path** — normal expected usage
+- **Edge cases** — empty inputs, nil/null, boundary values, large datasets, special characters
+- **Error cases** — invalid inputs, missing associations, unauthorized access, network failures
+- **State transitions** — if AASM states involved, test each valid transition and reject invalid ones
+- **Authorization** — if Pundit policies, test each role (admin, manager, recruiter, freelance)
+
+## Step 3: Generate specs
+
+**Rails (RSpec):**
+- Model specs: validations, associations, scopes, instance methods
+- Request specs: HTTP status, response body, side effects (DB changes, jobs enqueued)
+- Service specs: input/output, error handling, external service mocking
+- Follow `describe`/`context`/`it` nesting. Use `let`/`let!` for setup
+- Use `FactoryBot` if factories exist, otherwise `build`/`create` directly
+
+**Next.js (when Vitest is set up):**
+- Component tests: renders correctly, user interactions, loading/error states
+- Hook tests: query behavior, mutation side effects, cache invalidation
+- Use accessible queries: `getByRole`, `getByText`, `getByLabelText`
+
+## Step 4: Run and verify
+- Run the generated specs
+- Fix any failures from incorrect assumptions
+- Report coverage: what's tested, what's intentionally skipped and why

package/axel-manifest.json

@@ -0,0 +1,129 @@
+{
+  "schemaVersion": 1,
+  "package": {
+    "name": "axel-setup",
+    "version": "0.2.0"
+  },
+  "defaultTarget": "claude",
+  "targets": {
+    "claude": {
+      "description": "Full Claude Code install with hooks, commands, agents, skills, settings, plugins, and optional monitor tooling.",
+      "defaultRoot": "~/.claude",
+      "fullySupported": true
+    },
+    "codex": {
+      "description": "Portable Codex install with AGENTS instructions, skills, commands, agents, scripts, and manifest. Claude-only hooks and plugins are skipped.",
+      "defaultRoot": "$CODEX_HOME or ~/.codex",
+      "fullySupported": false
+    },
+    "generic": {
+      "description": "Export-only bundle for other agent runtimes. Writes only to the caller-provided output directory.",
+      "defaultRoot": "--output <dir>",
+      "fullySupported": false
+    }
+  },
+  "profiles": {
+    "core": {
+      "description": "Public safe default setup with conservative permissions and optional local side effects disabled.",
+      "safePermissions": true
+    },
+    "personal": {
+      "description": "Full personal setup with permissive local automation.",
+      "safePermissions": false
+    },
+    "team-safe": {
+      "description": "Team-friendly setup with safer Claude permission defaults.",
+      "safePermissions": true
+    },
+    "minimal": {
+      "description": "Small install surface for evaluation and CI smoke tests.",
+      "safePermissions": true
+    },
+    "ci": {
+      "description": "CI-safe profile with external installers and launchd disabled.",
+      "safePermissions": true
+    },
+    "full": {
+      "description": "Alias for all bundled AXEL components.",
+      "safePermissions": false
+    }
+  },
+  "requiredPaths": [
+    {
+      "path": "settings.json",
+      "targets": ["claude"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "hooks/enforce-agent-model.jq",
+      "targets": ["claude"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "hooks/validate-commit-format.sh",
+      "targets": ["claude"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "commands/daily.md",
+      "targets": ["claude", "codex", "generic"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "agents/excelsior-verifier.md",
+      "targets": ["claude", "codex", "generic"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "skills/model-routing/SKILL.md",
+      "targets": ["claude", "codex", "generic"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "skills/ui-ux-pro-max/SKILL.md",
+      "targets": ["claude", "codex", "generic"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "skills/ui-ux-pro-max/data/colors.csv",
+      "targets": ["claude", "codex", "generic"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "skills/ui-ux-pro-max/scripts/search.py",
+      "targets": ["claude", "codex", "generic"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "AGENTS.md",
+      "targets": ["codex", "generic"],
+      "profiles": ["core", "personal", "team-safe", "minimal", "ci", "full"]
+    },
+    {
+      "path": "scripts/posthog-snapshot-loader.sh",
+      "targets": ["claude", "codex", "generic"],
+      "profiles": ["core", "personal", "team-safe", "full"],
+      "optionalFlag": "enable-posthog"
+    },
+    {
+      "path": "tools/session-server.js",
+      "targets": ["claude"],
+      "profiles": ["core", "personal", "team-safe", "full"],
+      "skipFlag": "skip-monitor"
+    },
+    {
+      "path": "keybindings.json",
+      "targets": ["claude"],
+      "profiles": ["core", "personal", "team-safe", "full"],
+      "skipFlag": "skip-keybindings"
+    }
+  ],
+  "externalIntegrations": [
+    {
+      "id": "gsd",
+      "name": "get-shit-done-cc",
+      "managedExternally": true,
+      "installCommand": "npx -y get-shit-done-cc@latest"
+    }
+  ]
+}