@bugmole/cli 0.4.0

package/spec/plans/dashboard-smoke.flow.yaml

@@ -0,0 +1,20 @@
+version: 1
+id: dashboard-smoke
+name: "Journey: dashboard-smoke"
+description: Generated plan for journey dashboard-smoke with actor qa-agent
+suites:
+  - id: default
+    runs: on_demand
+    journeys:
+      - id: dashboard-smoke
+        actor: qa-agent
+        goal: "Complete journey: dashboard-smoke"
+        capabilities_required: []
+        preconditions:
+          - Test tenant / sandbox is active
+          - Actor account exists
+        steps:
+          - action: auth.login
+            proofs:
+              - type: navigation
+                expects: screen:dashboard

package/spec/plans/example.flow.yaml

@@ -0,0 +1,99 @@
+version: 1
+id: example.core
+name: Example Core Journeys
+description: >
+  Example plan file showing the structure of a journey plan.
+  Replace this with your application's actual core journeys.
+
+  TEMPLATE: This is a domain-agnostic example. Adapt the journey steps,
+  actions, and proofs to match your application's actual workflows.
+
+suites:
+  - id: daily_core
+    runs: daily
+    journeys:
+      # Example: Basic happy-path journey
+      - id: user.login.create_content.view_content.logout
+        actor: user
+        goal: "Complete a basic content creation workflow from start to finish"
+        capabilities_required:
+          - auth.login
+          - content.create
+          - content.view
+          - auth.logout
+        preconditions:
+          - "Test tenant / sandbox is active"
+          - "Test user account exists (watermarked or in test data)"
+          - "Application is accessible and responsive"
+        steps:
+          - action: auth.login
+            proofs:
+              - type: navigation
+                expects: "screen:dashboard"
+          - action: content.create
+            proofs:
+              - type: navigation
+                expects: "screen:content_editor"
+          - action: content.fill_form
+            params:
+              title: "Test Content"
+              body: "Test body text"
+            proofs:
+              - type: dom
+                expects: "visible:[data-testid='content-title'][value='Test Content']"
+          - action: content.submit
+            proofs:
+              - type: network
+                expects: "POST /api/content status 200"
+              - type: dom
+                expects: "content_status == PUBLISHED"
+          - action: content.view
+            proofs:
+              - type: navigation
+                expects: "screen:content_view"
+              - type: dom
+                expects: "visible:[data-testid='content-title'][text='Test Content']"
+          - action: auth.logout
+            proofs:
+              - type: navigation
+                expects: "screen:login"
+
+      # Example: Negative case - permission denied
+      - id: viewer.cannot_create_content
+        actor: viewer
+        goal: "Verify that viewers cannot create content"
+        capabilities_required:
+          - auth.login
+          - content.view
+        preconditions:
+          - "Viewer account exists"
+          - "Viewer is logged in"
+        steps:
+          - action: content.create
+            expected_outcome: blocked
+            proofs:
+              - type: dom
+                expects: "visible:[data-testid='error-message'][text*='permission']"
+              - type: navigation
+                expects: "screen != content_editor"
+
+      # Example: Variant with different preconditions
+      - id: admin.can_override_restrictions
+        actor: admin
+        goal: "Verify admin can override restrictions"
+        capabilities_required:
+          - auth.login
+          - admin.override_restrictions
+          - content.create
+        variants:
+          - id: admin_override_when_restricted
+            preconditions:
+              - "Content creation is restricted for standard users"
+              - "Admin account exists"
+            steps:
+              - action: content.create
+                proofs:
+                  - type: navigation
+                    expects: "screen:content_editor"
+                  - type: dom
+                    expects: "visible:[data-testid='admin-override-badge']"

package/spec/plans/flow_api-keys-to-logout-7396cd5d.flow.yaml

@@ -0,0 +1,33 @@
+version: 2
+id: flow_api-keys-to-logout-7396cd5d
+name: "Journey: flow:api-keys-to-logout-7396cd5d"
+description: Generated plan for journey flow:api-keys-to-logout-7396cd5d with actor user
+driver: maestro
+platform: web
+target:
+  base_url: http://localhost:3020
+flow: null
+recovery:
+  enabled: false
+  max_attempts: 1
+  timeout_ms: 30000
+journey_revision: 2
+suites:
+  - id: default
+    runs: on_demand
+    journeys:
+      - id: flow:api-keys-to-logout-7396cd5d
+        actor: user
+        goal: "Complete journey: flow:api-keys-to-logout-7396cd5d"
+        capabilities_required: []
+        preconditions:
+          - Test tenant / sandbox is active
+          - Actor account exists
+        steps:
+          - node_id: screen:/api-keys
+            action: navigate:/logout
+            proofs:
+              - type: navigation
+                expects: screen:/logout
+              - type: dom
+                expects: "screen source: src/app/api-keys/page.tsx"

package/spec/plans/flow_api-keys-to-screen-157e10a6.flow.yaml

@@ -0,0 +1,33 @@
+version: 2
+id: flow_api-keys-to-screen-157e10a6
+name: "Journey: flow:api-keys-to-screen-157e10a6"
+description: Generated plan for journey flow:api-keys-to-screen-157e10a6 with actor user
+driver: maestro
+platform: web
+target:
+  base_url: http://localhost:3020
+flow: null
+recovery:
+  enabled: false
+  max_attempts: 1
+  timeout_ms: 30000
+journey_revision: 3
+suites:
+  - id: default
+    runs: on_demand
+    journeys:
+      - id: flow:api-keys-to-screen-157e10a6
+        actor: user
+        goal: "Complete journey: flow:api-keys-to-screen-157e10a6"
+        capabilities_required: []
+        preconditions:
+          - Test tenant / sandbox is active
+          - Actor account exists
+        steps:
+          - node_id: screen:/api-keys
+            action: navigate:/
+            proofs:
+              - type: navigation
+                expects: screen:/
+              - type: dom
+                expects: "screen source: src/app/api-keys/page.tsx"

package/spec/plans/flow_manage-to-audits-176c1eb8.flow.yaml

@@ -0,0 +1,33 @@
+version: 2
+id: flow_manage-to-audits-176c1eb8
+name: "Journey: flow:manage-to-audits-176c1eb8"
+description: Generated plan for journey flow:manage-to-audits-176c1eb8 with actor user
+driver: maestro
+platform: web
+target:
+  base_url: http://localhost:3020
+flow: null
+recovery:
+  enabled: false
+  max_attempts: 1
+  timeout_ms: 30000
+journey_revision: 2
+suites:
+  - id: default
+    runs: on_demand
+    journeys:
+      - id: flow:manage-to-audits-176c1eb8
+        actor: user
+        goal: "Complete journey: flow:manage-to-audits-176c1eb8"
+        capabilities_required: []
+        preconditions:
+          - Test tenant / sandbox is active
+          - Actor account exists
+        steps:
+          - node_id: screen:/manage
+            action: navigate:App Audit
+            proofs:
+              - type: navigation
+                expects: screen:/audits
+              - type: dom
+                expects: "screen source: runtime-verified"

package/spec/plans/flow_manage-to-blockers-633282c8.flow.yaml

@@ -0,0 +1,112 @@
+version: 2
+id: flow_manage-to-blockers-633282c8
+name: "Journey: Open Manage → Open Blockers"
+description: >
+  Executable plan for flow:manage-to-blockers-633282c8 (revision 1) derived from
+  grounded test case assumptions in flow-manage-to-blockers-633282c8.json.
+  Covers the resource management hub at /manage, sidebar Blockers navigation,
+  and the blockers catalog panels on /blockers.
+driver: maestro
+platform: web
+target:
+  base_url: http://localhost:3020
+flow: null
+recovery:
+  enabled: false
+  max_attempts: 1
+  timeout_ms: 30000
+journey_revision: 1
+case_set_id: flow-manage-to-blockers-633282c8
+suites:
+  - id: default
+    runs: on_demand
+    journeys:
+      - id: flow:manage-to-blockers-633282c8
+        actor: user
+        goal: "Open /manage hub and navigate to blockers via sidebar"
+        capabilities_required:
+          - auth.login
+        preconditions:
+          - Aegis-authenticated dashboard session is active (sign in through dashboard OAuth)
+          - Local QA dashboard is running at http://localhost:3020
+          - Actor user is defined in roles.yaml with project membership
+          - Project context bugmole is selected (?project=bugmole) for full blockers panel data
+        steps:
+          - node_id: screen:/manage
+            case_id: TC-MANAGE-ENTRANCE
+            action: navigate:/manage
+            proofs:
+              - type: dom
+                expects: "visible:.auth-eyebrow[text*='RESOURCE MANAGEMENT']"
+              - type: dom
+                expects: "visible:.auth-title[text='Manage Bugmole']"
+              - type: dom
+                expects: "visible:a.management-hub-card[href='/manage/workspaces']"
+              - type: dom
+                expects: "visible:a.management-hub-card[href='/manage/projects']"
+              - type: dom
+                expects: "visible:a.management-hub-card[href='/manage/apps']"
+              - type: dom
+                expects: "visible:a.management-hub-card[href='/manage/environments']"
+              - type: dom
+                expects: "visible:a.auth-back[href='/'][text*='Back to dashboard']"
+              - type: navigation
+                expects: screen:/manage
+          - node_id: screen:/manage
+            case_id: TC-MANAGE-NAV-BLOCKERS
+            edge_id: screen:/manage->screen:/blockers:dom-6
+            action: navigate:Blockers
+            proofs:
+              - type: navigation
+                expects: screen:/blockers
+              - type: dom
+                expects: "visible:nav a[href='/blockers'][aria-current='page']"
+              - type: dom
+                expects: "visible:h1[text='What is gating the graph.']"
+          - node_id: screen:/blockers
+            case_id: TC-BLOCKERS-GOAL
+            action: verify:blockers-panels
+            proofs:
+              - type: dom
+                expects: "visible:#blockers.panel"
+              - type: dom
+                expects: "visible:#blockers .eyebrow[text='Hard stops']"
+              - type: dom
+                expects: "visible:#blockers h2[text='The run ends here']"
+              - type: dom
+                expects: "visible:#blockers-documented.panel"
+              - type: dom
+                expects: "visible:#blockers-documented .eyebrow[text='Documented and continued']"
+              - type: dom
+                expects: "visible:#blockers-documented h2[text='Setup and data states']"
+              - type: dom
+                expects: "visible:#blockers .panel-foot[text*='spec/blockers.yaml']"
+              - type: dom
+                expects: "screen source: apps/qa/src/app/blockers/page.tsx section=blockers"
+        variants:
+          - id: unauthenticated_manage_redirect
+            case_id: TC-manage-auth-redirect
+            preconditions:
+              - Aegis session cookie is cleared or absent
+            steps:
+              - node_id: screen:/manage
+                action: navigate:/manage
+                proofs:
+                  - type: navigation
+                    expects: screen:/login
+                  - type: dom
+                    expects: "screen source: apps/qa/src/app/login/page.tsx"
+          - id: blockers_direct_load
+            case_id: TC-BLOCKERS-GOAL-direct
+            preconditions:
+              - Authenticated session active
+            steps:
+              - node_id: screen:/blockers
+                action: navigate:/blockers?project=bugmole
+                proofs:
+                  - type: dom
+                    expects: "visible:h1[text='What is gating the graph.']"
+                  - type: dom
+                    expects: "visible:#blockers"
+                  - type: dom
+                    expects: "visible:#blockers-documented"

package/spec/plans/flow_manage-to-devices-ad57e202.flow.yaml

@@ -0,0 +1,33 @@
+version: 2
+id: flow_manage-to-devices-ad57e202
+name: "Journey: flow:manage-to-devices-ad57e202"
+description: Generated plan for journey flow:manage-to-devices-ad57e202 with actor user
+driver: maestro
+platform: web
+target:
+  base_url: http://localhost:3020
+flow: null
+recovery:
+  enabled: false
+  max_attempts: 1
+  timeout_ms: 30000
+journey_revision: 2
+suites:
+  - id: default
+    runs: on_demand
+    journeys:
+      - id: flow:manage-to-devices-ad57e202
+        actor: user
+        goal: "Complete journey: flow:manage-to-devices-ad57e202"
+        capabilities_required: []
+        preconditions:
+          - Test tenant / sandbox is active
+          - Actor account exists
+        steps:
+          - node_id: screen:/manage
+            action: navigate:Devices
+            proofs:
+              - type: navigation
+                expects: screen:/devices
+              - type: dom
+                expects: "screen source: rendered-dom"

package/spec/plans/flow_manage-to-logout-86c54656.flow.yaml

@@ -0,0 +1,33 @@
+version: 2
+id: flow_manage-to-logout-86c54656
+name: "Journey: flow:manage-to-logout-86c54656"
+description: Generated plan for journey flow:manage-to-logout-86c54656 with actor user
+driver: maestro
+platform: web
+target:
+  base_url: http://localhost:3020
+flow: null
+recovery:
+  enabled: false
+  max_attempts: 1
+  timeout_ms: 30000
+journey_revision: 2
+suites:
+  - id: default
+    runs: on_demand
+    journeys:
+      - id: flow:manage-to-logout-86c54656
+        actor: user
+        goal: "Complete journey: flow:manage-to-logout-86c54656"
+        capabilities_required: []
+        preconditions:
+          - Test tenant / sandbox is active
+          - Actor account exists
+        steps:
+          - node_id: screen:/manage
+            action: navigate:/logout
+            proofs:
+              - type: navigation
+                expects: screen:/logout
+              - type: dom
+                expects: "screen source: src/app/manage/page.tsx"

package/spec/plans/flow_manage-to-manage-resource-action-6325f99a.flow.yaml

@@ -0,0 +1,185 @@
+version: 2
+id: flow_manage-to-manage-resource-action-6325f99a
+name: "Journey: Open Manage → Open resource management"
+description: >
+  Executable plan for flow:manage-to-manage-resource-action-6325f99a (revision 3) derived from
+  grounded test case assumptions in flow-manage-to-manage-resource-action-6325f99a.json.
+  Covers the resource management hub at /manage, hub-card navigation to workspaces/projects/apps/environments,
+  resource list screens, back-to-hub navigation, and unauthenticated redirect.
+driver: maestro
+platform: web
+target:
+  base_url: http://localhost:3020
+flow: null
+recovery:
+  enabled: false
+  max_attempts: 1
+  timeout_ms: 30000
+journey_revision: 3
+case_set_id: flow-manage-to-manage-resource-action-6325f99a
+suites:
+  - id: default
+    runs: on_demand
+    journeys:
+      - id: flow:manage-to-manage-resource-action-6325f99a
+        actor: user
+        goal: "Open /manage hub and navigate to resource management list pages"
+        capabilities_required:
+          - auth.login
+        preconditions:
+          - Aegis-authenticated dashboard session is active (sign in through dashboard OAuth)
+          - Local QA dashboard is running at http://localhost:3020
+          - Actor user is defined in roles.yaml with project membership
+        steps:
+          - node_id: screen:/manage
+            case_id: TC-manage-hub-renders
+            action: navigate:/manage
+            proofs:
+              - type: dom
+                expects: "visible:.auth-eyebrow[text*='RESOURCE MANAGEMENT']"
+              - type: dom
+                expects: "visible:.auth-title[text='Manage Bugmole']"
+              - type: dom
+                expects: "visible:a.management-hub-card[href='/manage/workspaces']"
+              - type: dom
+                expects: "visible:a.management-hub-card[href='/manage/projects']"
+              - type: dom
+                expects: "visible:a.management-hub-card[href='/manage/apps']"
+              - type: dom
+                expects: "visible:a.management-hub-card[href='/manage/environments']"
+              - type: dom
+                expects: "visible:.qa-header"
+              - type: navigation
+                expects: screen:/manage
+          - node_id: screen:/manage
+            case_id: TC-manage-workspaces-nav
+            edge_id: screen:/manage->screen:/manage/:resource/:[...action]:1
+            action: navigate:/manage/workspaces
+            proofs:
+              - type: navigation
+                expects: screen:/manage/:resource/:[...action]
+              - type: dom
+                expects: "visible:.auth-eyebrow[text='WORKSPACES']"
+              - type: dom
+                expects: "visible:a.auth-back[href='/manage'][text*='Resource management']"
+              - type: network
+                expects: "GET /manage/workspaces → 200"
+          - node_id: screen:/manage/:resource/:[...action]
+            case_id: TC-resource-workspaces-list
+            action: verify:workspaces-list
+            proofs:
+              - type: dom
+                expects: "visible:.management-table-header"
+              - type: dom
+                expects: "visible:a.auth-button[href='/manage/workspaces/new']"
+              - type: network
+                expects: "GET /api/workspaces → 200"
+          - node_id: screen:/manage/:resource/:[...action]
+            case_id: TC-resource-back-to-hub
+            action: navigate:/manage
+            proofs:
+              - type: navigation
+                expects: screen:/manage
+              - type: dom
+                expects: "visible:.auth-title[text='Manage Bugmole']"
+        variants:
+          - id: projects_hub_nav
+            case_id: TC-manage-projects-nav
+            preconditions:
+              - Authenticated session active
+            steps:
+              - node_id: screen:/manage
+                action: navigate:/manage/projects
+                proofs:
+                  - type: navigation
+                    expects: screen:/manage/:resource/:[...action]
+                  - type: dom
+                    expects: "visible:.auth-eyebrow[text='PROJECTS']"
+                  - type: dom
+                    expects: "visible:label.auth-label:has-text('Workspace')"
+                  - type: network
+                    expects: "GET /manage/projects → 200"
+              - node_id: screen:/manage/:resource/:[...action]
+                case_id: TC-resource-projects-list
+                action: verify:projects-list
+                proofs:
+                  - type: dom
+                    expects: "visible:.management-table-header"
+                  - type: network
+                    expects: "GET /api/projects → 200"
+          - id: apps_hub_nav
+            case_id: TC-manage-apps-nav
+            preconditions:
+              - Authenticated session active
+              - Project context bugmole selected (?project=bugmole)
+            steps:
+              - node_id: screen:/manage
+                action: navigate:/manage/apps
+                proofs:
+                  - type: navigation
+                    expects: screen:/manage/:resource/:[...action]
+                  - type: dom
+                    expects: "visible:.auth-eyebrow[text='APPS']"
+                  - type: dom
+                    expects: "visible:label.auth-label:has-text('Project')"
+                  - type: network
+                    expects: "GET /manage/apps → 200"
+              - node_id: screen:/manage/:resource/:[...action]
+                case_id: TC-resource-apps-list
+                action: verify:apps-list
+                proofs:
+                  - type: dom
+                    expects: "visible:.management-table-header"
+                  - type: dom
+                    expects: "visible:a.table-action[href*='/manage/apps/'][href*='/edit']"
+          - id: environments_hub_nav
+            case_id: TC-manage-environments-nav
+            preconditions:
+              - Authenticated session active
+              - Project context bugmole selected (?project=bugmole)
+            steps:
+              - node_id: screen:/manage
+                action: navigate:/manage/environments
+                proofs:
+                  - type: navigation
+                    expects: screen:/manage/:resource/:[...action]
+                  - type: dom
+                    expects: "visible:.auth-eyebrow[text='ENVIRONMENTS']"
+                  - type: dom
+                    expects: "visible:label.auth-label:has-text('Project')"
+                  - type: network
+                    expects: "GET /manage/environments → 200"
+              - node_id: screen:/manage/:resource/:[...action]
+                case_id: TC-resource-environments-list
+                action: verify:environments-list
+                proofs:
+                  - type: dom
+                    expects: "visible:.management-table-header"
+                  - type: dom
+                    expects: "visible:a.table-action[href*='/manage/environments/'][href*='/edit']"
+          - id: unauthenticated_manage_redirect
+            case_id: TC-manage-auth-gate
+            preconditions:
+              - Aegis session cookie is cleared or absent
+            steps:
+              - node_id: screen:/manage
+                action: navigate:/manage
+                proofs:
+                  - type: navigation
+                    expects: screen:/login
+                  - type: dom
+                    expects: "screen source: apps/qa/src/app/login/page.tsx"
+          - id: create_workspace_form
+            case_id: TC-resource-create-nav
+            preconditions:
+              - Authenticated session active
+            steps:
+              - node_id: screen:/manage/:resource/:[...action]
+                action: navigate:/manage/workspaces/new
+                proofs:
+                  - type: navigation
+                    expects: screen:/manage/:resource/:[...action]
+                  - type: dom
+                    expects: "visible:h2[text*='Create workspace']"
+                  - type: dom
+                    expects: "visible:input[placeholder*='Workspace ID'], label:has-text('Workspace ID')"

package/spec/plans/flow_manage-to-parity-issues-01fa2579.flow.yaml

@@ -0,0 +1,34 @@
+version: 2
+id: flow_manage-to-parity-issues-01fa2579
+name: "Journey: flow:manage-to-parity-issues-01fa2579"
+description: Generated plan for journey flow:manage-to-parity-issues-01fa2579
+  with actor user
+driver: maestro
+platform: web
+target:
+  base_url: http://localhost:3020
+flow: null
+recovery:
+  enabled: false
+  max_attempts: 1
+  timeout_ms: 30000
+journey_revision: 2
+suites:
+  - id: default
+    runs: on_demand
+    journeys:
+      - id: flow:manage-to-parity-issues-01fa2579
+        actor: user
+        goal: "Complete journey: flow:manage-to-parity-issues-01fa2579"
+        capabilities_required: []
+        preconditions:
+          - Test tenant / sandbox is active
+          - Actor account exists
+        steps:
+          - node_id: screen:/manage
+            action: navigate:Parity bugs
+            proofs:
+              - type: navigation
+                expects: screen:/parity/issues
+              - type: dom
+                expects: "screen source: runtime-verified"