antigravity-ai-kit 2.1.0 → 3.0.1

package/.agent/workflows/review.md

@@ -0,0 +1,188 @@
+---
+description: Code review workflow. Sequential quality gate pipeline — lint, type-check, test, security scan, and build verification.
+version: 2.1.0
+sdlc-phase: verify
+skills: [verification-loop]
+commit-types: [fix, refactor]
+---
+
+# /review — Code Review Quality Gate
+
+> **Trigger**: `/review` (full) · `/review lint` · `/review tests` · `/review security` · `/review build`
+> **Lifecycle**: After implementation, before `/retrospective`
+
+> [!CAUTION]
+> Sequential gate pipeline — each step must pass before proceeding. Failed gates block merge. No overrides.
+
+> [!TIP]
+> This workflow leverages the **verification-loop** skill. Read `.agent/skills/verification-loop/SKILL.md` for extended guidance.
+
+---
+
+## Scope Filter
+
+| Commit Type | Review Required? | Rationale |
+| :---------- | :--------------- | :-------- |
+| `feat()` | ✅ Full review | New functionality needs all gates |
+| `fix()` | ✅ Full review | Bug fixes need regression verification |
+| `refactor()` | ✅ Full review | Structural changes need quality validation |
+| `test()` | ⚠️ Gate 3 only | Test-only changes need test verification |
+| `docs()` | ❌ Skip | No testable code changes |
+| `chore()` | ❌ Skip | Config/tooling, no code quality risk |
+
+---
+
+## Critical Rules
+
+1. **SEQUENTIAL** — each gate must pass before the next runs
+2. **STOP ON FAILURE** — if a gate fails, stop immediately, show error + fix suggestion
+3. **NO OVERRIDES** — failed gates block merge, no exceptions
+4. **FULL-STACK** — all relevant stacks are scanned
+5. **DOCUMENT** — log results for audit trail
+
+---
+
+## Argument Parsing
+
+| Command            | Gates Run                 |
+| :----------------- | :------------------------ |
+| `/review`          | All gates (1-5)           |
+| `/review lint`     | Gate 1 (Lint)             |
+| `/review types`    | Gate 2 (Type Check)       |
+| `/review tests`    | Gate 3 (Tests)            |
+| `/review security` | Gate 4 (Security Scan)    |
+| `/review build`    | Gate 5 (Build)            |
+
+---
+
+## Pipeline Gates
+
+Execute gates IN ORDER. Stop at first failure.
+
+### Gate 1: Lint
+
+// turbo
+
+Run the project's lint tool:
+
+```bash
+# Examples (adapt to your stack):
+npm run lint            # JavaScript/TypeScript
+ruff check .            # Python
+cargo clippy            # Rust
+```
+
+### Gate 2: Type Check
+
+// turbo
+
+Run the project's type checker:
+
+```bash
+# Examples:
+npx tsc --noEmit        # TypeScript
+mypy .                  # Python
+```
+
+### Gate 3: Tests
+
+// turbo
+
+Run the project's test suite:
+
+```bash
+# Examples:
+npm test                # Node.js
+pytest tests/ -q        # Python
+cargo test              # Rust
+```
+
+### Gate 4: Security Scan
+
+// turbo
+
+Run dependency and vulnerability scanning:
+
+```bash
+# Examples:
+npm audit --audit-level=moderate    # Node.js
+pip-audit                           # Python
+cargo audit                         # Rust
+```
+
+### Gate 5: Build Verification
+
+// turbo
+
+Verify the project builds successfully:
+
+```bash
+# Examples:
+npm run build           # Node.js
+python -m build         # Python
+cargo build --release   # Rust
+```
+
+---
+
+## Output Template
+
+### ✅ All Gates Passed
+
+```markdown
+## ✅ Review Complete
+
+| Gate          | Status                | Duration |
+| :------------ | :-------------------- | :------- |
+| Lint          | ✅ Pass               | {time}   |
+| Type Check    | ✅ Pass               | {time}   |
+| Tests         | ✅ Pass ({n}/{n})     | {time}   |
+| Security      | ✅ No vulnerabilities | {time}   |
+| Build         | ✅ Pass               | {time}   |
+
+**Verdict**: Ready for commit.
+```
+
+### ❌ Gate Failed
+
+```markdown
+## ❌ Review Failed at Gate {N}
+
+| Gate   | Status    |
+| :----- | :-------- |
+| {gate} | ❌ FAILED |
+
+### Error Output
+
+{error details}
+
+### Recommended Fix
+
+{fix steps}
+
+Re-run: `/review` or `/review {gate}`
+```
+
+---
+
+## Governance
+
+**PROHIBITED:** Skipping gates · overriding failures · merging without all gates passing · ignoring security scan results
+
+**REQUIRED:** Run all gates for merge-ready code · document results · fix failures before re-running
+
+---
+
+## Completion Criteria
+
+- [ ] All applicable gates executed in sequence
+- [ ] Zero failures across all gates
+- [ ] Results documented with pass/fail + duration
+- [ ] Verdict rendered: "Ready for commit" or "Failed at Gate N"
+
+## Related Resources
+
+- **Previous**: `/test` (tests must pass before review)
+- **Next**: `/deploy` (deployment after all gates pass)
+- **Skill**: `.agent/skills/verification-loop/SKILL.md`
+- **Related**: `/quality-gate` (pre-task research) · `/retrospective` (sprint-level audit)

package/.agent/workflows/status.md

@@ -1,91 +1,142 @@
----
-description: Display project and progress status. Current state overview.
----
-
-# /status - Show Status
-
-$ARGUMENTS
-
----
-
-## Task
-
-Show current project and task status.
-
-### What It Shows
-
-1. **Project Info**
-   - Project name and path
-   - Tech stack detected
-   - Current features
-
-2. **Progress Status**
-   - Completed tasks
-   - In-progress tasks
-   - Pending work
-
-3. **File Statistics**
-   - Files created/modified
-   - Recent changes
-
-4. **Health Check**
-   - Build status
-   - Test status
-   - Server status (if running)
-
----
-
-## Output Format
-
-```markdown
-=== Project Status ===
-
-📁 Project: my-app
-📂 Path: /projects/my-app
-🏷️ Type: Next.js + NestJS + PostgreSQL
-
----
-
-🔧 Tech Stack:
-Framework: Next.js
-Backend: NestJS
-Database: PostgreSQL
-Auth: Clerk
-
----
-
-✅ Completed (5):
-• Initial setup
-• Database schema
-• Auth integration
-• API endpoints
-• Core pages
-
-🔄 In Progress (1):
-• User dashboard (70%)
-
-⏳ Pending (2):
-• Admin panel
-• Email notifications
-
----
-
-📊 Statistics:
-Files created: 47
-Files modified: 12
-Tests passing: 24/24
-
----
-
-💚 Health: All systems OK
-```
-
----
-
-## Examples
-
-```
-/status
-/status brief
-/status health
-```
+---
+description: Display project and progress status. Current state overview.
+version: 2.1.0
+sdlc-phase: cross-cutting
+skills: [verification-loop]
+commit-types: [chore]
+---
+
+# /status — Project Status Overview
+
+> **Trigger**: `/status [sub-command]`
+> **Lifecycle**: Cross-cutting — any SDLC phase
+
+> [!NOTE]
+> This is a read-only, informational workflow. It gathers and displays data without modifying anything.
+
+> [!TIP]
+> Skill reference: `.agent/skills/verification-loop/SKILL.md` — health checks and continuous quality gates
+
+---
+
+## Critical Rules
+
+1. **Accurate data** — all reported information must reflect the current state, not cached data
+2. **No stale info** — read live data from git, filesystem, and project config
+3. **Health checks** — always include build and test health indicators
+4. **Non-destructive** — this workflow must never modify any files or state
+
+---
+
+## Argument Parsing
+
+| Command | Action |
+| :----------------- | :------------------------------------------ |
+| `/status` | Full status report (all sections) |
+| `/status brief` | Condensed one-line summary |
+| `/status health` | Health checks only (build, tests, server) |
+| `/status git` | Git status only (branch, changes, commits) |
+
+---
+
+## Steps
+
+// turbo
+1. **Project Detection**
+   - Detect project name, path, and type from config files
+   - Identify the tech stack (framework, language, database, etc.)
+
+// turbo
+2. **Git Status**
+   - Current branch and last commit
+   - Uncommitted changes (staged, unstaged, untracked)
+   - Branch ahead/behind status
+
+// turbo
+3. **Progress Tracking**
+   - Read ROADMAP or task files for sprint/task status
+   - Count completed, in-progress, and pending items
+   - Identify blockers if any
+
+// turbo
+4. **Health Check**
+   - Build status (can the project compile/build?)
+   - Test status (are tests passing?)
+   - Server status (is the dev server running?)
+
+// turbo
+5. **File Statistics**
+   - Files created and modified (from git)
+   - Recent changes summary
+
+---
+
+## Output Template
+
+```markdown
+## 📊 Project Status
+
+### Project
+
+- **Name**: [project name]
+- **Path**: [project path]
+- **Stack**: [language] + [framework] + [database]
+
+### Git
+
+- **Branch**: [branch name]
+- **Last Commit**: [hash] — [message]
+- **Changes**: [N] staged · [N] unstaged · [N] untracked
+
+### Progress
+
+✅ Completed ([N]): [list]
+🔄 In Progress ([N]): [list]
+⏳ Pending ([N]): [list]
+
+### Health
+
+| Check | Status |
+| :---- | :----- |
+| Build | ✅ Passing / ❌ Failing |
+| Tests | ✅ [N]/[N] passing / ❌ [N] failures |
+| Server | 🟢 Running / ⚪ Stopped |
+
+### Statistics
+
+- Files created: [N]
+- Files modified: [N]
+- Test coverage: [N]%
+```
+
+---
+
+## Governance
+
+**PROHIBITED:**
+- Modifying files, state, or configuration
+- Reporting stale or cached data
+- Skipping health checks
+- Skipping failed steps · proceeding without resolution
+
+**REQUIRED:**
+- Live data from git, filesystem, and project config
+- Health check in every full status report
+- Accurate progress tracking from project files
+
+---
+
+## Completion Criteria
+
+- [ ] Project info is detected and displayed
+- [ ] Git status is current and accurate
+- [ ] Progress tracking reflects actual state
+- [ ] Health checks are performed and reported
+
+---
+
+## Related Resources
+
+- **Previous**: `/deploy` (post-deployment monitoring)
+- **Cross-cutting**: Available at any SDLC phase
+- **Related**: `/retrospective` (sprint-level status review)

package/.agent/workflows/test.md

@@ -1,95 +1,168 @@
----
-description: Write and run tests systematically
----
-
-# /test Workflow
-
-> **Purpose**: Systematic test writing and execution
-
----
-
-## Workflow Steps
-
-### 1. Identify Test Scope
-
-- What needs to be tested?
-- Unit, integration, or E2E?
-- What are the critical paths?
-
-### 2. Analyze Existing Coverage
-
-```bash
-npm run test:coverage
-```
-
-- Check current coverage percentage
-- Identify untested code paths
-- Prioritize critical functionality
-
-### 3. Write Tests (AAA Pattern)
-
-```typescript
-describe("FeatureName", () => {
-  it("should [expected behavior] when [condition]", () => {
-    // Arrange
-    const input = createTestData();
-
-    // Act
-    const result = functionUnderTest(input);
-
-    // Assert
-    expect(result).toEqual(expectedOutput);
-  });
-});
-```
-
-### 4. Test Categories
-
-| Type        | Scope          | Speed  | Isolation       |
-| :---------- | :------------- | :----- | :-------------- |
-| Unit        | Function/Class | Fast   | Full mocking    |
-| Integration | Module         | Medium | Partial mocking |
-| E2E         | Full system    | Slow   | No mocking      |
-
-### 5. Run Tests
-
-```bash
-# All tests
-npm test
-
-# Watch mode
-npm run test:watch
-
-# Specific file
-npm test -- user.service.spec.ts
-
-# Coverage report
-npm run test:coverage
-```
-
-### 6. Review Results
-
-- All tests passing?
-- Coverage targets met (≥80%)?
-- Edge cases covered?
-
----
-
-## Checklist
-
-- [ ] Test scope identified
-- [ ] Coverage analyzed
-- [ ] Tests written
-- [ ] All tests passing
-- [ ] Coverage ≥80%
-- [ ] Edge cases covered
-
----
-
-## Examples
-
-```
-/test UserService
-/test authentication flow
-/test API endpoints for orders
-```
+---
+description: Write and run tests systematically.
+version: 2.1.0
+sdlc-phase: verify
+skills: [testing-patterns, webapp-testing]
+commit-types: [test]
+---
+
+# /test — Systematic Test Writing & Execution
+
+> **Trigger**: `/test [scope]`
+> **Lifecycle**: Verify — after implementation, before `/review`
+
+> [!IMPORTANT]
+> Tests are the primary quality gate. All new code must have test coverage. Never skip failing tests — fix the code or fix the test.
+
+> [!TIP]
+> This workflow leverages the **testing-patterns** and **webapp-testing** skills. Read `.agent/skills/testing-patterns/SKILL.md` and `.agent/skills/webapp-testing/SKILL.md` for extended guidance.
+
+---
+
+## Critical Rules
+
+1. **AAA pattern** — all tests must follow Arrange-Act-Assert
+2. **Coverage ≥80%** — target minimum 80% code coverage on new code
+3. **No skipping** — `skip`, `xit`, `xdescribe` are prohibited in committed code
+4. **Descriptive names** — test names must describe expected behavior: "should [behavior] when [condition]"
+5. **Edge cases** — always test boundary conditions, null/undefined, and error paths
+6. **Stack-agnostic** — detect the project stack and use the appropriate test framework
+
+---
+
+## Scope Filter
+
+| Commit Type | Run Tests? | Rationale |
+| :---------- | :--------- | :-------- |
+| `feat()` | ✅ Yes | New functionality needs coverage |
+| `fix()` | ✅ Yes | Bug fixes need regression tests |
+| `refactor()` | ✅ Yes | Refactors must prove no regressions |
+| `test()` | ✅ Yes | Test changes need validation |
+| `docs()` | ❌ Skip | No testable code changes |
+| `chore()` | ❌ Skip | Config/tooling, no testable code |
+
+---
+
+## Steps
+
+// turbo
+1. **Identify Test Scope**
+   - What needs to be tested? (specific file, module, or feature)
+   - What type of tests? (unit, integration, E2E)
+   - What are the critical paths and edge cases?
+
+// turbo
+2. **Detect Test Framework**
+   - Scan for test config: `jest.config.*`, `vitest.config.*`, `pytest.ini`, `pyproject.toml`, `Cargo.toml`
+   - Determine the test runner and assertion library
+   - Identify coverage tool
+
+// turbo
+3. **Analyze Existing Coverage**
+   - Run coverage report
+   - Identify untested code paths
+   - Prioritize critical functionality and edge cases
+
+4. **Write Tests**
+   - Follow AAA pattern (Arrange-Act-Assert)
+   - Use descriptive test names
+   - Cover happy paths, edge cases, and error scenarios
+   - Mock external dependencies appropriately
+
+// turbo
+5. **Run Tests**
+   - Execute the full test suite
+   - Verify all tests pass
+   - Check coverage meets ≥80% threshold
+
+// turbo
+6. **Review Results**
+   - All tests passing?
+   - Coverage targets met?
+   - Edge cases covered?
+   - Any flaky tests identified?
+
+---
+
+## Multi-Stack Test Commands
+
+| Stack | Test Command | Coverage Command |
+| :------------ | :----------------------- | :------------------------------- |
+| Node.js/Jest | `npm test` | `npm run test:coverage` |
+| Node.js/Vitest | `npx vitest` | `npx vitest --coverage` |
+| Python/pytest | `pytest` | `pytest --cov` |
+| Rust/Cargo | `cargo test` | `cargo tarpaulin` |
+| Go | `go test ./...` | `go test -coverprofile=cover.out` |
+
+---
+
+## Output Template
+
+```markdown
+## 🧪 Test Results: [Scope]
+
+### Framework
+
+- **Runner**: [jest | vitest | pytest | cargo test]
+- **Coverage Tool**: [tool]
+
+### Results
+
+| Metric | Value |
+| :--------- | :--------- |
+| Total | [N] tests |
+| Passing | ✅ [N] |
+| Failing | ❌ [N] |
+| Skipped | ⚠️ [N] |
+| Coverage | [N]% |
+
+### Tests Written
+
+| Test File | Tests | Status |
+| :-------- | :---- | :----- |
+| `path/to/test` | [N] | ✅ All passing |
+
+### Coverage Gaps (if any)
+
+- [ ] [Untested function/module]
+
+After testing: proceed to `/review` for quality gates.
+```
+
+---
+
+## Governance
+
+**PROHIBITED:**
+- Committing code with `skip`, `xit`, or `xdescribe` annotations
+- Submitting code below 80% coverage without explicit justification
+- Testing only happy paths — edge cases are mandatory
+- Skipping failed steps · proceeding without resolution
+
+**REQUIRED:**
+- AAA pattern for all tests
+- Coverage report generation and review
+- Descriptive test names following "should [behavior] when [condition]"
+- Stack-appropriate test framework usage
+
+---
+
+## Completion Criteria
+
+- [ ] Test scope is identified
+- [ ] Test framework is detected for the project stack
+- [ ] Tests are written following AAA pattern
+- [ ] All tests are passing
+- [ ] Coverage is ≥80% on new code
+- [ ] Edge cases and error paths are covered
+- [ ] No skipped tests in committed code
+- [ ] After testing: proceed to `/review` for quality gates
+- [ ] Note: if `/test` ran immediately before `/review` with no code changes, `/review` Gate 3 may use cached results
+
+---
+
+## Related Resources
+
+- **Previous**: `/create` (test new code) · `/enhance` (test changes) · `/debug` (regression check after fix)
+- **Next**: `/review` (quality gate pipeline)
+- **Skills**: `.agent/skills/testing-patterns/SKILL.md` · `.agent/skills/webapp-testing/SKILL.md`