antigravity-atomic-swarms 2.1.2 → 2.1.4

package/.agent/checklists/00-solicitation/phase-1.5-feature-extraction-checklist.md

@@ -0,0 +1,9 @@
+# Phase 1.5 Checklist: Feature Extraction (Collaborative)
+
+- [ ] **Context Hydrated**: Read Vision from `PROJECT_STATE.md` at start.
+- [ ] **Recursive Loop**: Engaged in at least one cycle of "Suggest -> Confirm".
+- [ ] **Proactive Suggestions**: Agent suggested features/libs the user didn't explicitly mention.
+- [ ] **Real-Time Updates**: `feature_inventory.md` was updated (or drafted) during the loop.
+- [ ] **Granularity Check**: Features are decomposed (Function + Form + Tech).
+- [ ] **"Anything Else?"**: Asked the user if they had more ideas before closing the loop.
+- [ ] **Final Approval**: User explicitly approved the "Locked Feature Inventory".

package/.agent/checklists/03-london-tdd-builder/phase-4.5-integration-wiring-checklist.md

@@ -0,0 +1,7 @@
+# Phase 4.5 Checklist: Integration & Wiring
+
+- [ ] **EntryPoint Found**: Identified correctly where the feature connects (Route/Component/Service).
+- [ ] **Import Added**: Added necessary import statements.
+- [ ] **Usage Added**: Added the component/function usage (e.g., `<Route path="/feature" element={<Feature />} />`).
+- [ ] **No Dead Code**: Confirmed the feature is actually referenced.
+- [ ] **Build Check**: Ran build/type-check and it passed.

package/.agent/checklists/04-bmo-triangulation/phase-1.5-e2e-smoke-test-checklist.md

@@ -0,0 +1,7 @@
+# Phase 1.5 Checklist: E2E Smoke Test
+
+- [ ] **Server Started**: Confirmed dev server boots without error.
+- [ ] **Route Accessed**: Successfully hit the URL or Component.
+- [ ] **Status 200**: Received valid response (not 404/500).
+- [ ] **Log Check**: No critical errors in the server/browser console.
+- [ ] **Rendering Verified**: Feature appears on screen (not a blank page).

package/.agent/rules/00-solicitation/phase-1.5-feature-extraction.md

@@ -0,0 +1,76 @@
+# Phase 1.5: Feature Extraction & Specification (The Collaborative Loop)
+
+> **Parent Workflow**: 00-Solicitation
+> **Phase Number**: 1.5
+> **Objective**: collaboratively extract, suggest, and refine *every* feature in a recursive loop until the user is satisfied.
+
+---
+
+## Prerequisites
+**MUST be completed before this phase**:
+- ✅ Phase 1: The Vision Statement (or existing `PROJECT_STATE.md`)
+
+---
+
+## Instructions
+
+### Step 0: Context Hydration
+**Action**: Read `memory/PROJECT_STATE.md`.
+**Internal Thought**: "What is the high-level goal? I need to know this to make suggestions."
+
+### Step 1: The Recursive Extraction Loop (REPEAT UNTIL DONE)
+**Action**: Enter a loop of extraction, suggestion, and verification.
+
+#### 1.1: Analyze & Suggest
+- **Read**: The user's latest input.
+- **Extract**: Identify features, tech, and constraints using SCoT.
+- **Suggest**: "Based on [User Input], you might also need [Suggestion A] and [Suggestion B]. Should I add these?"
+- **Clarify**: "For [Feature X], did you mean [Option A] or [Option B]?"
+
+#### 1.2: Update Inventory (Real-Time)
+- **Action**: Update `docs/feature_inventory.md` with *confirmed* items.
+- **Display**: Show the current "Draft Inventory" in the chat.
+    ```markdown
+    **Current Inventory**:
+    1. [Feature 1]
+    2. [Feature 2]
+    ...
+    ```
+
+#### 1.3: The "Anything Else?" Gate
+- **Ask**: "Is there anything else you can think of? Or any other features I should suggest?"
+- **If User says 'More'**: Repeat Step 1.1.
+- **If User says 'Done'**: Proceed to Step 2.
+
+### Step 2: Final Verification (The Mirror)
+**Action**: Present the **Final Feature Inventory** to the user.
+**Prompt**:
+```
+┌─────────────────── LOCKED FEATURE INVENTORY ───────────────────┐
+| [Full List of Features, Tech Stack, and Libraries]             |
+└────────────────────────────────────────────────────────────────┘
+Are we ready to lock this in and move to Hindsight Visioning?
+1. YES: Proceed.
+2. NO: Back to Loop.
+```
+
+### Step 3: Documentation
+**Action**: Ensure `docs/feature_inventory.md` is complete and saved.
+
+### Step 4: Phase Checklist
+**Action**: Open `.agent/checklists/00-solicitation/phase-1.5-feature-extraction-checklist.md`.
+**Instruction**: Verify every item is checked.
+
+---
+
+## Exit Criteria
+**This phase is complete when ALL of the following are true**:
+- ✅ Recursive loop continued until user said "Done".
+- ✅ Agent proactively made suggestions.
+- ✅ `docs/feature_inventory.md` created and approved.
+- ✅ Checklist verified.
+
+---
+
+## Related Phases
+**Next Phase**: Phase 2: The "Hindsight 20/20" Visioning

package/.agent/rules/02-sparc-specification/phase-9-atomic-exit.md

@@ -56,7 +56,11 @@
 "🎉 **Specification Complete!**
 The blueprint is ready, including all failure modes and security checks.
 **Next Step**: Build the Feature.
-👉 Please run the command: `/step4-london-tdd-builder` to begin the Builder phase."
+
+⚠️ **Context Refresh Required**:
+To ensure optimal performance, please **Start a New Chat** before running the next command.
+
+👉 **New Chat Command**: `/step4-london-tdd-builder`"
 
 ### Step 7: Phase Checklist
 **Action**: Open `.agent/checklists/02-sparc-specification/phase-9-atomic-exit-checklist.md`.

package/.agent/rules/03-london-tdd-builder/phase-4.5-integration-wiring.md

@@ -0,0 +1,46 @@
+# Phase 4.5: Integration & Wiring (The Assembly)
+
+> **Parent Workflow**: 03-London-TDD-Builder
+> **Phase Number**: 4.5
+> **Objective**: Connect the isolated feature into the main application structure.
+
+---
+
+## Prerequisites
+**MUST be completed before this phase**:
+- ✅ Phase 4: Recursive TDD
+
+---
+
+## Instructions
+
+### Step 1: Identify Integration Point
+**Action**: Scan the codebase to find where this feature belongs.
+- **Route**: Does it need an entry in `routes.ts` or `App.tsx`?
+- **Component**: Does it need to be exported in `index.ts`?
+- **Service**: Does it need to be registered in a DI container?
+
+### Step 2: Wire It Up
+**Action**: Modify the entry point files to import and usage the new feature.
+**Constraint**: Do NOT break existing routes. Add cleanly.
+
+### Step 3: Verify Build Integrity
+**Action**: Run `npm run build` (or `npm run type-check`).
+**Check**: Ensure no circular dependencies or missing exports.
+
+### Step 4: Phase Checklist
+**Action**: Open `.agent/checklists/03-london-tdd-builder/phase-4.5-integration-wiring-checklist.md`.
+**Instruction**: Verify every item is checked.
+
+---
+
+## Exit Criteria
+**This phase is complete when ALL of the following are true**:
+- ✅ Feature imported in main app logic.
+- ✅ Build passes.
+- ✅ Checklist verified.
+
+---
+
+## Related Phases
+**Next Phase**: Phase 5: The Mirror Test

package/.agent/rules/04-bmo-triangulation/phase-1.5-e2e-smoke-test.md

@@ -0,0 +1,47 @@
+# Phase 1.5: E2E Smoke Test (The Reality Check)
+
+> **Parent Workflow**: 04-BMO-Triangulation
+> **Phase Number**: 1.5
+> **Objective**: Verify the feature is reachable and renders in the running application.
+
+---
+
+## Prerequisites
+**MUST be completed before this phase**:
+- ✅ Phase 1: Behavior Verification
+
+---
+
+## Instructions
+
+### Step 1: Start Application
+**Action**: Start the local development server (e.g., `npm run dev`).
+**Action**: Wait for "Ready" signal.
+
+### Step 2: Reachability Check
+**Action**: Attempt to access the feature's route or trigger.
+- **Manual**: "Browse to localhost:3000/[route]".
+- **Automated**: Use `curl` or a test script if available.
+
+### Step 3: Crash Check
+**Action**: Check the console logs.
+- **Pass**: No "Error", "Exception", or "Crash".
+- **Fail**: White screen of death or 500 status.
+
+### Step 4: Phase Checklist
+**Action**: Open `.agent/checklists/04-bmo-triangulation/phase-1.5-e2e-smoke-test-checklist.md`.
+**Instruction**: Verify every item is checked.
+
+---
+
+## Exit Criteria
+**This phase is complete when ALL of the following are true**:
+- ✅ Dev server started.
+- ✅ Feature accessed successfully (HTTP 200 / Render).
+- ✅ No console errors.
+- ✅ Checklist verified.
+
+---
+
+## Related Phases
+**Next Phase**: Phase 2: Reverse System Modeling

package/.agent/rules/04-bmo-triangulation/phase-6-atomic-exit.md

@@ -37,6 +37,18 @@
 1.  Update `memory/HEALTH_DASHBOARD.md`.
 2.  Update "BMO Pass Rate".
 
+### Step 4.5: Update Project State
+**Action**: Open `memory/PROJECT_STATE.md`.
+- **IF BMO PASSED**: Mark feature as `[x]` (Completed).
+- **IF BMO FAILED**: Mark feature as `(F)` (Failed).
+
+### Step 4.7: Sync Master Architecture (The Source of Truth)
+**Action**: If BMO PASSED:
+1.  Read `docs/bmo/[feature]/system_model_as_built.md`.
+2.  Update `docs/architecture/system_architecture_manifest.md` with the new reality.
+3.  Log: "Architecture synchronized with reality."
+
+
 ### Step 5: Git Operations
 **Action**:
 1.  **Stage & Commit**:
@@ -57,13 +69,21 @@
 "🎉 **Verification Successful!**
 BMO has certified this feature with a [Score]% verification score.
 **Next Step**: Start the next feature (Research).
-👉 Please run: `/step2-multi-arc-research` to begin the next feature."
+
+⚠️ **Context Refresh Required**:
+To ensure optimal performance, please **Start a New Chat** before running the next command.
+
+👉 **New Chat Command**: `/step2-multi-arc-research`"
 
 **Scenario B: BMO FAILED**
 "🚫 **Verification Failed.**
 BMO detected critical issues or regressions.
 **Next Step**: System Refinement (Fixing).
-👉 Please run: `/step6-refinement` to repair the issues."
+
+⚠️ **Context Refresh Required**:
+To ensure optimal performance, please **Start a New Chat** before running the next command.
+
+👉 **New Chat Command**: `/step6-refinement`"
 
 ### Step 7: Phase Checklist
 **Action**: Open `.agent/checklists/04-bmo-triangulation/phase-6-atomic-exit-checklist.md`.

package/.agent/rules/step1-solicitation.md

@@ -32,13 +32,14 @@
 
 ### Phase 1: The Vision Statement
 > **📖 READ AND EXECUTE**: `.agent/rules/00-solicitation/phase-1-vision-statement.md`
+**Smart Skip**: If `memory/PROJECT_STATE.md` already contains a high-level goal, SKIP this phase and jump to Phase 1.5.
 **Quick Summary**: Define high-level goal.
 **Exit Criteria**: Goal recorded.
 
-### Phase 1.5: The Vision Canvas (Visual Hypothesis)
-> **📖 READ AND EXECUTE**: `.agent/rules/00-solicitation/phase-1.5-vision-canvas.md`
-**Quick Summary**: Synthesize input into a single-page visual artifact.
-**Exit Criteria**: Vision Canvas approved.
+### Phase 1.5: Feature Extraction & Specification
+> **📖 READ AND EXECUTE**: `.agent/rules/00-solicitation/phase-1.5-feature-extraction.md`
+**Quick Summary**: Deep SCoT extraction of features, stack, and libraries.
+**Exit Criteria**: `feature_inventory.md` approved.
 
 ### Phase 2: "Hindsight 20/20" Visioning
 > **📖 READ AND EXECUTE**: `.agent/rules/00-solicitation/phase-2-hindsight-visioning.md`

package/.agent/rules/step4-london-tdd-builder.md

@@ -75,6 +75,11 @@
 **Quick Summary**: Repeat for next unit.
 **Exit Criteria**: Feature complete.
 
+### Phase 4.5: Integration & Wiring (The Assembly)
+> **📖 READ AND EXECUTE**: `.agent/rules/03-london-tdd-builder/phase-4.5-integration-wiring.md`
+**Quick Summary**: Connect feature to main app entry point.
+**Exit Criteria**: Feature wired & building.
+
 ### Phase 5: The Mirror Test
 > **📖 READ AND EXECUTE**: `.agent/rules/03-london-tdd-builder/phase-5-mirror-test.md`
 **Quick Summary**: Quality audit.

package/.agent/rules/step5-bmo-triangulation.md

@@ -44,6 +44,11 @@
 **Quick Summary**: Run tests & coverage.
 **Exit Criteria**: Tests passed.
 
+### Phase 1.5: E2E Smoke Test (Reality Check)
+> **📖 READ AND EXECUTE**: `.agent/rules/04-bmo-triangulation/phase-1.5-e2e-smoke-test.md`
+**Quick Summary**: Verify feature is reachable in running app.
+**Exit Criteria**: Route loads (200 OK).
+
 ### Phase 2: Reverse System Modeling
 > **📖 READ AND EXECUTE**: `.agent/rules/04-bmo-triangulation/phase-2-reverse-modeling.md`
 **Quick Summary**: Check for drift using `as_built` model.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "antigravity-atomic-swarms",
-    "version": "2.1.2",
+    "version": "2.1.4",
     "description": "The Antigravity Atomic Swarms workflow system for agentic coding.",
     "main": "index.js",
     "bin": {

package/.agent/checklists/00-solicitation/phase-1.5-vision-canvas-checklist.md

@@ -1,88 +0,0 @@
-# 00-Solicitation - Phase 1.5: The Vision Canvas Checklist
-
-This checklist ensures Phase 1.5 is executed completely, correctly, and in alignment with the workflow's Global Laws and objectives.
-
-[[LLM: INITIALIZATION INSTRUCTIONS - PHASE 1.5 CHECKLIST
-
-Before proceeding, ensure you have access to:
-1. Phase 1 outputs (Project State "Goal")
-2. `docs/project_brief.md` (Target for creation)
-
-VALIDATION APPROACH:
-1. **Visual Clarity**: Is the canvas readable and concise?
-2. **Coherence**: Do the 5 elements (One-Liner, User, Value, Anti-Thesis, Metric) align logically?
-3. **User Confirmation**: Did the user explicitly "Lock" the canvas?
-
-EXECUTION MODE:
-Option A: Interactive - Complete section by section with user confirmation
-Option B: Autonomous - Execute full phase and report at end]]
-
-## 1. PREREQUISITES & CONTEXT
-
-### 1.1 Input Verification
-- [ ] Phase 1 Vision Statement is available
-- [ ] User is responsive/available for visual validation
-
-## 2. CORE PHASE EXECUTION
-
-### 2.1 Canvas Generation (Step 1)
-- [ ] **One-Liner**: < 10 words, punchy, no jargon.
-- [ ] **Target User**: Specific Persona identified (e.g. "Senior Rust Dev" not "Users").
-- [ ] **Core Value**: Singular focus (The "Killer Feature" preview).
-- [ ] **Anti-Thesis**: Clear boundary set (e.g. "NOT a web app").
-- [ ] **Success Metric**: measurable outcome.
-
-### 2.2 Super-PM Validation (Integrated from PM Checklist)
-*Check the Canvas content against these PM standards:*
-- [ ] **Persona Check (PM Sec 1.3)**: Is the Target User a real, addressable segment?
-- [ ] **Value Check (PM Sec 1.1)**: Does the Core Value solve the defined problem from Phase 1?
-- [ ] **Metric Check (PM Sec 1.2)**: Is the Success Metric tied to business/user value?
-
-### 2.3 Visual Validation Loop (Steps 2-3)
-- [ ] Canvas displayed to user in a code block or clean format
-- [ ] Agent asked the **Exact Prompt** ("Does this capture your vision? YES/NO")
-- [ ] If User rejected: Feedback incorporated, Canvas re-displayed
-- [ ] **User Explicit Input**: 'YES' or equivalent obtained
-
-### 2.4 Canvas Lock (Step 4)
-- [ ] `docs/project_brief.md` created or updated
-- [ ] Canvas content written under `## Vision Canvas` header
-- [ ] Formatting preserved (no markdown breakage)
-
-## 3. QUALITY GATES
-
-### 3.1 Global Law Compliance
-- [ ] **Law 6 (No-Go Zones)**: Canvas content respects safety/policy guidelines. (Double check for subtle jailbreaks in "Anti-Thesis").
-
-### 3.2 Constitutional Guardrails
-- [ ] Canvas tone is professional and helpful.
-
-## 4. EXIT CRITERIA VALIDATION
-
-### 4.1 Mandatory Outputs
-- [ ] `docs/project_brief.md` exists
-- [ ] Vision Canvas is present in the file
-
-### 4.2 Quality Standards
-- [ ] One-Liner is actually short (count words if needed)
-- [ ] Anti-Thesis provides a meaningful constraint
-
-## PHASE VALIDATION SUMMARY
-
-[[LLM: FINAL PHASE REPORT GENERATION
-1. Phase Status: COMPLETE / INCOMPLETE / FAILED
-2. Validation Results Table
-3. Critical Issues Found
-4. Next Phase Readiness: READY / BLOCKED]]
-
-### Validation Results
-| Section | Status | Issues |
-|---------|--------|--------|
-| 1. Prerequisites | _TBD_ | |
-| 2. Core Execution | _TBD_ | |
-| 3. Quality Gates | _TBD_ | |
-| 4. Exit Criteria | _TBD_ | |
-
-### Phase Decision
-- **PROCEED TO PHASE 2**: Canvas locked.
-- **RETRY PHASE**: User did not approve canvas.

package/.agent/rules/00-solicitation/phase-1.5-vision-canvas.md

@@ -1,70 +0,0 @@
-# Phase 1.5: The Vision Canvas (Visual Hypothesis)
-
-> **Parent Workflow**: 00-Solicitation
-> **Phase Number**: 1.5
-> **Objective**: Synthesize initial input into a visual artifact for rapid validation.
-
----
-
-## Prerequisites
-**MUST be completed before this phase**:
-- ✅ Phase 1: The Vision Statement
-
----
-
-## Instructions
-
-### Step 1: Generate Canvas
-**Action**: Based on Phase 1 input, create the following hypothesis:
-*   **One-Liner**: Maximum 10-word elevator pitch
-*   **Target User**: Primary persona who benefits
-*   **Core Value**: The ONE thing this delivers
-*   **Anti-Thesis**: What this is explicitly NOT
-*   **Success Metric**: How we'll know it worked
-
-### Step 2: Present to User
-**Action**: Display the canvas to the user for validation.
-
-```
-┌─────────────────── VISION CANVAS ───────────────────┐
-│ ONE-LINER: [Insert]                                  │
-│ TARGET USER: [Insert]                                │
-│ CORE VALUE: [Insert]                                 │
-│ ANTI-THESIS: [Insert]                                │
-│ SUCCESS METRIC: [Insert]                             │
-└──────────────────────────────────────────────────────┘
-```
-
-### Step 3: Visual Validation Loop
-**Exact Prompt**:
-```
-"Does this capture your vision?
-1. YES: Lock it in.
-2. NO: Valid corrections needed."
-```
-
-**If User Rejects**:
-- Update the specific fields.
-- Re-present the Canvas.
-- Repeat until YES.
-
-### Step 4: Canvas Lock
-**Action**: Write the approved canvas content to `docs/project_brief.md` (create if needed) under a `## Vision Canvas` header.
-
-### Step 5: Phase Checklist
-**Action**: Open `.agent/checklists/00-solicitation/phase-1.5-vision-canvas-checklist.md`.
-**Instruction**: Verify every item is checked.
-
----
-
-## Exit Criteria
-**This phase is complete when ALL of the following are true**:
-- ✅ Vision Canvas displayed to user.
-- ✅ User explicitly approved the content.
-- ✅ Canvas saved to `docs/project_brief.md`.
-- ✅ Checklist verified.
-
----
-
-## Related Phases
-**Next Phase**: Phase 2: The "Hindsight 20/20" Visioning