zefiro 0.8.0 → 0.8.1

package/README.md

@@ -1,6 +1,6 @@
 # Zefiro
 
-AI-powered codebase scanner and QA map generator. Scans your project's AST, identifies features and workflows, and generates structured test scenarios — all driven by LLM agents.
+AI-powered application explorer. Maps web applications through browser automation, producing structured documentation with screenshots and interactive reports.
 
 ## Installation
 
@@ -13,13 +13,11 @@ bun add -g zefiro
 ## Quick Start
 
 ```bash
-# 1. Initialize — copies agents, writes QAI_* env vars to .env
+# 1. Initialize
 zefiro init
 
-# 2. Scan → Analyze → Push
-zefiro scan
-zefiro analyze
-zefiro push
+# 2. Explore a running application
+zefiro scan          # static AST scan (optional)
 ```
 
 ---
@@ -33,10 +31,8 @@ zefiro push
 | `QAI_INPUT_SOURCE` | Issue tracker: `none` \| `jira` \| `linear` |
 | `QAI_OUTPUT_TARGET` | QA format: `markdown` \| `zephyr` \| `both` |
 | `QAI_BASE_URL` | QA Intelligence API base URL |
-| `QAI_API_URL` | Full push endpoint (overrides base URL) |
-| `QAI_API_KEY` | API key for authenticated push |
-| `OPENAI_API_KEY` | OpenAI API key (for `analyze` with OpenAI) |
-| `ANTHROPIC_API_KEY` | Anthropic API key (for `analyze` with Anthropic) |
+| `OPENAI_API_KEY` | OpenAI API key |
+| `ANTHROPIC_API_KEY` | Anthropic API key |
 
 ---
 
@@ -79,49 +75,6 @@ zefiro scan --no-cache
 
 ---
 
-### `zefiro analyze [input]`
-
-Two-stage AI analysis that generates a QA map from the AST scan.
-
-**Stage 1:** Feature analysis — identifies features, workflows, and components (runs in parallel).
-**Stage 2:** Scenario planning — generates test scenarios for each workflow (runs in parallel).
-
-```bash
-zefiro analyze
-zefiro analyze custom-scan.json
-zefiro analyze --skip-scenarios          # features and workflows only
-zefiro analyze --output custom-qa-map.json
-```
-
-| Option | Description |
-|--------|-------------|
-| `[input]` | AST scan file (default: `.qai/zefiro/ast-scan.json`) |
-| `--output <file>` | QA map output (default: `.qai/zefiro/qa-map.json`) |
-| `--skip-scenarios` | Skip scenario generation |
-
-**Incremental:** if the AST is unchanged since the last run, analysis is skipped. If the AST changed, only affected features are re-analyzed.
-
----
-
-### `zefiro push [input]`
-
-Push the generated QA map to QA Intelligence (or a custom endpoint).
-
-```bash
-zefiro push
-zefiro push custom-qa-map.json
-zefiro push --commit-sha abc1234
-```
-
-| Option | Description |
-|--------|-------------|
-| `[input]` | QA map file (default: `.qai/zefiro/qa-map.json`) |
-| `--commit-sha <sha>` | Git commit SHA to associate with this version |
-
-Authenticates via `zefiro auth login` session first, falls back to `QAI_API_URL` + `QAI_API_KEY`.
-
----
-
 ### `zefiro auth`
 
 Manage authentication with QA Intelligence.
@@ -167,11 +120,9 @@ claude mcp add zefiro -s user -- npx -y zefiro-mcp      # global
 
 | Tool | Description |
 |------|-------------|
+| `zefiro_explore` | Explore a web application via BFS |
+| `zefiro_read_docs` | Read generated documentation |
 | `zefiro_scan_codebase` | Scan project test infrastructure |
-| `zefiro_scan_ast` | Deep AST scan: routes, components, hooks |
-| `zefiro_scan_ast_detail` | Drill into a specific AST category |
-| `zefiro_build_qa_map` | Validate and write a QAMapV2Payload |
-| `zefiro_read_qa_map` | Read the existing QA map file |
 
 ---
 
@@ -224,11 +175,6 @@ export default defineConfig({
   integrations: {
     zephyr: { titlePrefix: 'UI Automation' },
   },
-
-  push: {
-    apiUrl: 'https://your-api.com/qa-map',
-    apiKey: 'your-key',
-  },
 });
 ```
 
@@ -244,25 +190,12 @@ Zefiro ships with agents copied to `.qai/zefiro/agents/` on `init`. Edit them to
 |-------|---------|
 | `1.feature-analyzer-agent` | Identifies features, workflows, and components from AST |
 | `2.scenario-planner-agent` | Generates test scenarios for each workflow |
-| `3.scanner-agent` | Interactive QA map building (used via MCP) |
 | `input-agent` | Enriches form component input definitions |
-| `workflow-agent` | Maps user workflows within features |
 
 Add `.qai/zefiro/context.md` to inject project-specific context into every agent call.
 
 ---
 
-## QA Map Output
-
-The generated `.qai/zefiro/qa-map.json` contains:
-
-- **Features** — User-facing capabilities grouped by routes
-- **Workflows** — User journeys (navigation, CRUD, multi-step, search/filter, configuration)
-- **Components** — UI elements (forms, modals, navigation, data display)
-- **Scenarios** — Test cases per workflow (happy-path, validation, error, edge-case, permission)
-
----
-
 ## Project Structure
 
 ```
@@ -274,7 +207,6 @@ your-project/
     agents/                    # Agent prompts (customizable)
     workflow.md                # Workflow guide
     ast-scan.json              # Latest AST scan output
-    qa-map.json                # Generated QA map
     scan-cache/                # File-level MD5 cache
 ```