intake-ai-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{intake_ai_cli-0.1.0 → intake_ai_cli-0.2.0}/.gitignore

@@ -92,5 +92,6 @@ logs/
 tmp/
 CLAUDE.md
 .coverage
+.claude/
 
 __pycache__/

{intake_ai_cli-0.1.0 → intake_ai_cli-0.2.0}/CHANGELOG.md

@@ -5,6 +5,84 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-03-03
+
+### Added
+
+#### Plugin system (extensible architecture)
+
+- **Plugin protocols** (`plugins/protocols.py`): V2 extension contracts — `ParserPlugin`, `ExporterPlugin`, `ConnectorPlugin` protocols with `@runtime_checkable`. Supporting dataclasses: `PluginMeta`, `ExportResult`, `FetchedSource`. Exceptions: `PluginError`, `PluginLoadError`.
+- **Plugin discovery** (`plugins/discovery.py`): Automatic plugin loading via `importlib.metadata.entry_points()` (PEP 621). `PluginRegistry` with `discover_all()`, `discover_group()`, `get_parsers()`, `get_exporters()`, `get_connectors()`, `list_plugins()`, `check_compatibility()`. Three entry point groups: `intake.parsers`, `intake.exporters`, `intake.connectors`.
+- **Pipeline hooks** (`plugins/hooks.py`): `HookManager` with `register()`, `emit()`, `registered_events`. Callbacks are called in order; exceptions are caught and logged without blocking other callbacks. Ready for Phase 2 event wiring.
+- **Entry points in `pyproject.toml`**: 11 parsers + 2 exporters registered as `[project.entry-points]`. All discoverable via `intake plugins list`.
+
+#### Registry refactoring
+
+- **Parser registry** (`ingest/registry.py`): `ParserRegistry` now accepts an optional `PluginRegistry` and attempts plugin-based discovery before falling back to manual registration. New `discover_parsers()` method. JSON subtype detection expanded: Jira → GitHub Issues → Slack → generic YAML.
+- **Exporter registry** (`export/registry.py`): Same plugin-first pattern. `ExporterRegistry` with optional `PluginRegistry`, `discover_exporters()` method, plugin-first `create_default_registry()`.
+
+#### 3 new parsers (11 total)
+
+- **UrlParser** (`ingest/url.py`): Fetches HTTP/HTTPS URLs via `httpx` (sync), converts HTML to Markdown via BeautifulSoup4 + markdownify. Extracts page title, heading-based sections. Auto-detects source type (confluence, jira, github) from URL patterns. Handles connection errors, timeouts, and HTTP errors with user-friendly `ParseError`.
+- **SlackParser** (`ingest/slack.py`): Parses Slack workspace export JSON format (array of message objects with `type`, `user`, `text`, `ts`, `thread_ts`, `reactions`). Groups messages by thread. Detects decisions via reactions (thumbsup, white_check_mark) and keywords. Detects action items via keywords (TODO, action item, etc.). Metadata: message_count, thread_count, decision_count, action_item_count.
+- **GithubIssuesParser** (`ingest/github_issues.py`): Parses GitHub Issues JSON (single object or array). Extracts labels, assignees, milestones, state, html_url, comments. Detects `#NNN` cross-references as relations. Supports both array and single-issue formats.
+
+#### Source URI parsing
+
+- **Source URI parser** (`utils/source_uri.py`): `SourceURI` dataclass and `parse_source()` function. Detection order: stdin (`-`) → scheme URIs (`jira://`, `confluence://`, `github://`) → HTTP(S) URLs → existing files → file extensions → free text fallback. `SCHEME_PATTERNS` dict with compiled regexes.
+
+#### Connector infrastructure
+
+- **Connector base** (`connectors/base.py`): `ConnectorRegistry` with `register()`, `find_for_uri()`, async `fetch()`, `validate_all()`, `available_schemes`. Exceptions: `ConnectorError`, `ConnectorNotFoundError`. No concrete connectors yet (Phase 2).
+
+#### Complexity classification and adaptive generation
+
+- **Complexity classifier** (`analyze/complexity.py`): `ComplexityAssessment` dataclass and `classify_complexity()` function. Three modes: quick (<500 words, 1 source, no structure), standard (default), enterprise (4+ sources OR >5000 words). Heuristic-based, no LLM dependency.
+- **Adaptive spec builder** (`generate/adaptive.py`): `GenerationPlan` dataclass and `AdaptiveSpecBuilder` class. Wraps standard `SpecBuilder` and filters files by mode: quick generates only `context.md` + `tasks.md`, standard generates all 6, enterprise generates all 6 with detailed risks. `create_generation_plan()` respects user config overrides.
+
+#### Task state tracking
+
+- **TaskStateManager** (`utils/task_state.py`): Reads and updates `tasks.md` in a spec directory. `list_tasks()` with optional status filter, `get_task()`, `update_task()` with persistence. Supports statuses: pending, in_progress, done, blocked. `TaskStatus` dataclass, `TaskStateError` exception.
+- **TaskItem.status field** added to `analyze/models.py` (default: `"pending"`).
+- **tasks.md.j2 template** updated with Status column in summary table and `**Status:**` field in detail sections.
+
+#### New CLI commands
+
+- **`intake plugins list`**: Shows table of all discovered plugins with name, group, version, V2 status, built-in status. Verbose mode (`-v`) adds module and error columns.
+- **`intake plugins check`**: Validates compatibility of all discovered plugins. Reports OK or FAIL per plugin.
+- **`intake task list <spec_dir>`**: Lists tasks from a spec with current status. Supports `--status` filter (repeatable). Shows progress summary.
+- **`intake task update <spec_dir> <task_id> <status>`**: Updates task status in tasks.md. Supports `--note` for annotations.
+- **`intake init --mode`**: New `--mode quick|standard|enterprise` option. When omitted and `spec.auto_mode` is True, auto-classifies complexity from sources.
+
+#### init command enhancements
+
+- Source URI resolution via `parse_source()` — detects file, URL, stdin, and scheme URIs.
+- Scheme URIs (`jira://`, `confluence://`, `github://`) display "connector not available yet" warning.
+- HTTP/HTTPS URLs routed to UrlParser automatically.
+- Complexity classification + adaptive generation when `--mode` not specified.
+- `AdaptiveSpecBuilder` replaces `SpecBuilder` for mode-aware file selection.
+
+#### Configuration schema updates
+
+- `SpecConfig.auto_mode: bool = True` — enables automatic complexity classification.
+- `ConnectorsConfig` with `JiraConnectorConfig`, `ConfluenceConnectorConfig`, `GithubConnectorConfig` sub-models (Phase 2 preparation).
+- `IntakeConfig.connectors` field added.
+
+#### Optional dependencies in pyproject.toml
+
+- `connectors = ["atlassian-python-api>=3.40", "PyGithub>=2.0"]`
+- `watch = ["watchfiles>=0.21"]`
+- `mcp = ["mcp>=1.0"]`
+- `respx>=0.21` added to dev dependencies.
+
+#### Test suite
+
+- **492 tests** (up from 313), **0 failures**. 179 new tests added.
+- 13 new test files: test_protocols, test_discovery, test_hooks, test_base (connectors), test_source_uri, test_task_state, test_url, test_slack, test_github_issues, test_complexity, test_adaptive.
+- 3 new fixture files: `sample_webpage.html`, `slack_export.json`, `github_issues.json`.
+- Plugin discovery tests added to `test_ingest/test_registry.py` and `test_export/test_registry.py`.
+- CLI tests for plugins, task, and init --mode commands added to `test_cli.py`.
+
 ## [0.1.0] - 2026-03-02
 
 ### Added
@@ -112,9 +190,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **0 ruff errors**: Fixed 88 lint issues (TC001/TC003, F401, I001, SIM103, RUF022, E501, SIM117, RUF043).
 - **0 mypy --strict errors**: Fixed 26 type errors across 12 files. Proper isinstance narrowing, type-safe dict extraction, correct bool return types.
 
+#### Documentation
+
+- **`docs/` directory** fully updated with v0.2.0 content: architecture, pipeline, formats, CLI guide, configuration, best practices, troubleshooting.
+- **`docs/plugins.md`** (NEW): Complete plugin system documentation — discovery mechanism, built-in plugins table, V1 vs V2 protocols, how to create external plugins, HookManager, PluginRegistry API.
+- **`docs/github-notes/v0.2.0.md`** (NEW): Full release notes with highlights, migration guide, quality metrics.
+
 ### Fixed
 
 - **structlog test isolation**: Replaced `StringIO` sink with persistent `_NullWriter` class and yield-based autouse fixture. Fixed `cache_logger_on_first_use=True` in `setup_logging()` that caused "I/O operation on closed file" errors when CLI tests ran before module tests.
 - **`_get_list` type safety**: Split into `_get_list` (for dict lists) and `_get_str_list` (for string lists) to fix mypy --strict without breaking acceptance criteria extraction.
 - **bs4 `find()` kwargs**: Changed `**selector` to `attrs=selector` in Confluence parser for correct BeautifulSoup4 type narrowing.
 
+### QA Audit
+
+Full QA audit completed with 105 issues found and resolved:
+
+- **51 ruff lint errors** fixed: TC001 (8), RUF002 (2), N817 (2), E501 (4), F841 (2), TC003 (2), F401/I001 (30 auto-fixed), RUF100 (1).
+- **54 ruff format issues** fixed: Auto-formatted with `ruff format`.
+- **4 mypy --strict errors** fixed: `Returning Any` in `github_issues.py`, unused `type: ignore` in `discovery.py`, `list[object]` vs `list[ParsedContent]` in `cli.py`.
+- **0 security issues**: No hardcoded credentials, no sensitive data in logs.
+- **Coverage**: 86% overall (target: 65%). All modules above their individual targets.
+

intake_ai_cli-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Diego303
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{intake_ai_cli-0.1.0 → intake_ai_cli-0.2.0}/PKG-INFO

@@ -1,9 +1,12 @@
 Metadata-Version: 2.4
 Name: intake-ai-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: From requirements in any format to verified implementation
+Project-URL: Homepage, https://diego303.github.io/intake-docs/
+Project-URL: Repository, https://github.com/Diego303/intake-cli
 Author: intake contributors
 License: MIT
+License-File: LICENSE
 Keywords: ai,automation,cli,requirements,spec-driven
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
@@ -25,14 +28,22 @@ Requires-Dist: python-docx>=1.1
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.0
 Requires-Dist: structlog>=24.0
+Provides-Extra: connectors
+Requires-Dist: atlassian-python-api>=3.40; extra == 'connectors'
+Requires-Dist: pygithub>=2.0; extra == 'connectors'
 Provides-Extra: dev
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
 Requires-Dist: ruff>=0.5; extra == 'dev'
 Requires-Dist: types-beautifulsoup4>=4.12; extra == 'dev'
 Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
+Provides-Extra: watch
+Requires-Dist: watchfiles>=0.21; extra == 'watch'
 Description-Content-Type: text/markdown
 
 # intake
@@ -114,13 +125,26 @@ intake init "API gateway" -s reqs.yaml --preset enterprise
 
 # Export for a specific agent
 intake init "User endpoint" -s reqs.pdf --format architect
+
+# Quick mode for simple tasks (only context.md + tasks.md)
+intake init "Fix login bug" -s notes.txt --mode quick
+
+# Fetch requirements from a URL
+intake init "API review" -s https://wiki.company.com/rfc/auth
+
+# List discovered plugins
+intake plugins list
+
+# Track task progress
+intake task list ./specs/auth-oauth2
+intake task update ./specs/auth-oauth2 1 done --note "Implemented and tested"
 ```
 
 ---
 
 ## Supported Input Formats
 
-| Format | Extensions | Parser |
+| Format | Extensions / Source | Parser |
 |--------|-----------|--------|
 | Markdown | `.md` | Front matter, heading-based sections |
 | Plain text | `.txt`, stdin (`-`) | Paragraph sections, Slack dumps |
@@ -130,8 +154,11 @@ intake init "User endpoint" -s reqs.pdf --format architect
 | Jira export | `.json` (auto-detected) | Issues, comments, links, priorities |
 | Confluence export | `.html` (auto-detected) | Clean Markdown via BS4 + markdownify |
 | Images | `.png`, `.jpg`, `.webp`, `.gif` | LLM vision analysis |
+| URLs | `http://`, `https://` | Fetches page, converts HTML → Markdown |
+| Slack export | `.json` (auto-detected) | Messages, threads, decisions, action items |
+| GitHub Issues | `.json` (auto-detected) | Issues, labels, comments, cross-references |
 
-Format is auto-detected by file extension and content inspection. Jira JSON exports and Confluence HTML exports are distinguished automatically from generic JSON/HTML files.
+Format is auto-detected by file extension and content inspection. Jira, Slack, and GitHub Issues JSON exports are distinguished automatically from generic JSON files. Confluence HTML is distinguished from generic HTML.
 
 ---
 
@@ -148,6 +175,10 @@ Format is auto-detected by file extension and content inspection. Jira JSON expo
 | `intake diff` | Compare two spec versions | **Available** |
 | `intake doctor` | Check environment and configuration health | **Available** |
 | `intake doctor --fix` | Auto-fix environment issues (install deps, create config) | **Available** |
+| `intake plugins list` | List all discovered plugins (parsers, exporters) | **Available** |
+| `intake plugins check` | Validate plugin compatibility | **Available** |
+| `intake task list` | List tasks from a spec with current status | **Available** |
+| `intake task update` | Update a task's status (pending/in_progress/done/blocked) | **Available** |
 
 ---
 
@@ -171,6 +202,7 @@ spec:
   design_depth: moderate       # minimal | moderate | detailed
   task_granularity: medium     # coarse | medium | fine
   risk_assessment: true
+  auto_mode: true              # auto-detect quick/standard/enterprise
 
 export:
   default_format: generic      # architect | claude-code | cursor | kiro | generic
@@ -213,13 +245,19 @@ See the [`examples/`](examples/) directory for ready-to-run scenarios:
 src/intake/
 ├── cli.py                  # Click CLI — thin adapter, no logic
 ├── config/                 # Pydantic v2 models, presets, layered loader
-│   ├── schema.py           #   6 config models (LLM, Project, Spec, Verification, Export, Security)
+│   ├── schema.py           #   7 config models (LLM, Project, Spec, Verification, Export, Security, Connectors)
 │   ├── presets.py           #   minimal / standard / enterprise presets
 │   ├── loader.py            #   Layered merge: defaults → preset → YAML → CLI
 │   └── defaults.py          #   Centralized constants
-├── ingest/                 # Phase 1 — 8 parsers, registry, auto-detection
+├── plugins/                # Plugin system (v0.2.0)
+│   ├── protocols.py         #   V2 protocols: ParserPlugin, ExporterPlugin, ConnectorPlugin
+│   ├── discovery.py         #   Entry point scanning via importlib.metadata
+│   └── hooks.py             #   Pipeline hook system (HookManager)
+├── connectors/             # Connector infrastructure (Phase 2 prep)
+│   └── base.py              #   ConnectorRegistry, ConnectorError
+├── ingest/                 # Phase 1 — 11 parsers, registry, auto-detection
 │   ├── base.py              #   ParsedContent dataclass + Parser Protocol
-│   ├── registry.py          #   Auto-detection + parser dispatch
+│   ├── registry.py          #   Auto-detection + plugin discovery + parser dispatch
 │   ├── markdown.py          #   .md with YAML front matter
 │   ├── plaintext.py         #   .txt, stdin, Slack dumps
 │   ├── yaml_input.py        #   .yaml/.yml/.json structured input
@@ -227,11 +265,15 @@ src/intake/
 │   ├── docx.py              #   .docx via python-docx
 │   ├── jira.py              #   Jira JSON exports (API + list format)
 │   ├── confluence.py        #   Confluence HTML via BS4 + markdownify
-│   └── image.py             #   Image analysis via LLM vision
+│   ├── image.py             #   Image analysis via LLM vision
+│   ├── url.py               #   HTTP/HTTPS URLs via httpx + markdownify
+│   ├── slack.py             #   Slack workspace export JSON
+│   └── github_issues.py     #   GitHub Issues JSON
 ├── analyze/                # Phase 2 — LLM orchestration (async)
 │   ├── analyzer.py          #   Orchestrator: extraction → dedup → risk → design
 │   ├── prompts.py           #   3 system prompts (extraction, risk, design)
 │   ├── models.py            #   10 dataclasses for analysis pipeline
+│   ├── complexity.py        #   Heuristic complexity classification (quick/standard/enterprise)
 │   ├── extraction.py        #   LLM JSON → typed AnalysisResult
 │   ├── dedup.py             #   Jaccard word similarity deduplication
 │   ├── conflicts.py         #   Conflict validation
@@ -240,13 +282,14 @@ src/intake/
 │   └── design.py            #   Design output parsing (tasks, checks)
 ├── generate/               # Phase 3 — Jinja2 template rendering
 │   ├── spec_builder.py      #   Orchestrates 6 spec files + lock
+│   ├── adaptive.py          #   AdaptiveSpecBuilder — mode-aware file selection
 │   └── lock.py              #   spec.lock.yaml for reproducibility
 ├── verify/                 # Phase 4 — Acceptance check engine
 │   ├── engine.py           #   4 check types: command, files_exist, pattern_*
 │   └── reporter.py         #   Terminal (Rich), JSON, JUnit XML reporters
 ├── export/                 # Phase 5 — Agent-ready output
 │   ├── base.py             #   Exporter Protocol
-│   ├── registry.py         #   Format-based exporter dispatch
+│   ├── registry.py         #   Plugin discovery + format-based dispatch
 │   ├── architect.py        #   pipeline.yaml generation
 │   └── generic.py          #   SPEC.md + verify.sh generation
 ├── diff/                   # Spec comparison
@@ -258,13 +301,15 @@ src/intake/
 ├── templates/              # Jinja2 templates for spec generation
 │   ├── requirements.md.j2   #   FR, NFR, conflicts, open questions
 │   ├── design.md.j2         #   Components, files, tech decisions
-│   ├── tasks.md.j2          #   Task summary + detailed sections
+│   ├── tasks.md.j2          #   Task summary + status + detailed sections
 │   ├── acceptance.yaml.j2   #   Executable acceptance checks
 │   ├── context.md.j2        #   Project context for agents
 │   └── sources.md.j2        #   Source traceability mapping
-└── utils/                  # Shared utilities (logging, cost, detection)
+└── utils/                  # Shared utilities
     ├── file_detect.py       #   Extension-based format detection
     ├── project_detect.py    #   Auto-detect tech stack from project files
+    ├── source_uri.py        #   URI parsing (jira://, github://, http://, files, text)
+    ├── task_state.py         #   Task status tracking in tasks.md
     ├── cost.py              #   Cost accumulation with per-phase breakdown
     └── logging.py           #   structlog configuration
 ```
@@ -272,9 +317,11 @@ src/intake/
 **Key design principles:**
 
 - **Protocol over ABC** — All extension points use `typing.Protocol`
+- **Plugin-first architecture** — Parsers and exporters discovered via entry points, manual fallback
 - **Dataclasses for pipeline data, Pydantic for config** — Never mixed
 - **Async only in analyze/** — Everything else is synchronous
 - **Offline mode** — Parsing, verification, export, diff, doctor all work without LLM
+- **Adaptive generation** — Complexity auto-detection selects quick/standard/enterprise mode
 - **No magic strings** — All constants defined explicitly
 - **Budget enforcement** — LLM cost tracked per call with configurable limits
 
@@ -320,24 +367,29 @@ python -m pytest tests/ --cov=intake --cov-report=term-missing
 # Lint
 ruff check src/ tests/
 
+# Format
+ruff format src/ tests/
+
 # Type check (strict)
 mypy src/ --strict
 ```
 
-Current test suite: **313 tests**, **83% coverage**.
+Current test suite: **492 tests**, **86% coverage**, **0 mypy --strict errors**, **0 ruff warnings**.
 
 ### Implementation Status
 
 | Phase | Module | Status |
 |-------|--------|--------|
-| Phase 1 — Ingest | `ingest/` (8 parsers + registry) | Implemented |
-| Phase 2 — Analyze | `analyze/` (orchestrator + 7 sub-modules) | Implemented |
-| Phase 3 — Generate | `generate/` (spec builder + 6 templates + lock) | Implemented |
+| Phase 1 — Ingest | `ingest/` (11 parsers + plugin-based registry) | Implemented |
+| Phase 2 — Analyze | `analyze/` (orchestrator + 7 sub-modules + complexity) | Implemented |
+| Phase 3 — Generate | `generate/` (spec builder + adaptive builder + 6 templates + lock) | Implemented |
 | Phase 4 — Verify | `verify/` (engine + 3 reporters) | Implemented |
-| Phase 5 — Export | `export/` (architect + generic) | Implemented |
+| Phase 5 — Export | `export/` (architect + generic + plugin registry) | Implemented |
+| Plugins | `plugins/` (protocols + discovery + hooks) | Implemented |
+| Connectors | `connectors/` (registry infrastructure, no concrete connectors) | Implemented |
 | Standalone | `doctor/`, `config/`, `llm/`, `utils/` | Implemented |
 | Standalone | `diff/` (spec differ) | Implemented |
-| CLI | All 8 commands wired end-to-end | Implemented |
+| CLI | 13 commands/subcommands wired end-to-end | Implemented |
 
 ---
 

{intake_ai_cli-0.1.0 → intake_ai_cli-0.2.0}/README.md

@@ -77,13 +77,26 @@ intake init "API gateway" -s reqs.yaml --preset enterprise
 
 # Export for a specific agent
 intake init "User endpoint" -s reqs.pdf --format architect
+
+# Quick mode for simple tasks (only context.md + tasks.md)
+intake init "Fix login bug" -s notes.txt --mode quick
+
+# Fetch requirements from a URL
+intake init "API review" -s https://wiki.company.com/rfc/auth
+
+# List discovered plugins
+intake plugins list
+
+# Track task progress
+intake task list ./specs/auth-oauth2
+intake task update ./specs/auth-oauth2 1 done --note "Implemented and tested"
 ```
 
 ---
 
 ## Supported Input Formats
 
-| Format | Extensions | Parser |
+| Format | Extensions / Source | Parser |
 |--------|-----------|--------|
 | Markdown | `.md` | Front matter, heading-based sections |
 | Plain text | `.txt`, stdin (`-`) | Paragraph sections, Slack dumps |
@@ -93,8 +106,11 @@ intake init "User endpoint" -s reqs.pdf --format architect
 | Jira export | `.json` (auto-detected) | Issues, comments, links, priorities |
 | Confluence export | `.html` (auto-detected) | Clean Markdown via BS4 + markdownify |
 | Images | `.png`, `.jpg`, `.webp`, `.gif` | LLM vision analysis |
+| URLs | `http://`, `https://` | Fetches page, converts HTML → Markdown |
+| Slack export | `.json` (auto-detected) | Messages, threads, decisions, action items |
+| GitHub Issues | `.json` (auto-detected) | Issues, labels, comments, cross-references |
 
-Format is auto-detected by file extension and content inspection. Jira JSON exports and Confluence HTML exports are distinguished automatically from generic JSON/HTML files.
+Format is auto-detected by file extension and content inspection. Jira, Slack, and GitHub Issues JSON exports are distinguished automatically from generic JSON files. Confluence HTML is distinguished from generic HTML.
 
 ---
 
@@ -111,6 +127,10 @@ Format is auto-detected by file extension and content inspection. Jira JSON expo
 | `intake diff` | Compare two spec versions | **Available** |
 | `intake doctor` | Check environment and configuration health | **Available** |
 | `intake doctor --fix` | Auto-fix environment issues (install deps, create config) | **Available** |
+| `intake plugins list` | List all discovered plugins (parsers, exporters) | **Available** |
+| `intake plugins check` | Validate plugin compatibility | **Available** |
+| `intake task list` | List tasks from a spec with current status | **Available** |
+| `intake task update` | Update a task's status (pending/in_progress/done/blocked) | **Available** |
 
 ---
 
@@ -134,6 +154,7 @@ spec:
   design_depth: moderate       # minimal | moderate | detailed
   task_granularity: medium     # coarse | medium | fine
   risk_assessment: true
+  auto_mode: true              # auto-detect quick/standard/enterprise
 
 export:
   default_format: generic      # architect | claude-code | cursor | kiro | generic
@@ -176,13 +197,19 @@ See the [`examples/`](examples/) directory for ready-to-run scenarios:
 src/intake/
 ├── cli.py                  # Click CLI — thin adapter, no logic
 ├── config/                 # Pydantic v2 models, presets, layered loader
-│   ├── schema.py           #   6 config models (LLM, Project, Spec, Verification, Export, Security)
+│   ├── schema.py           #   7 config models (LLM, Project, Spec, Verification, Export, Security, Connectors)
 │   ├── presets.py           #   minimal / standard / enterprise presets
 │   ├── loader.py            #   Layered merge: defaults → preset → YAML → CLI
 │   └── defaults.py          #   Centralized constants
-├── ingest/                 # Phase 1 — 8 parsers, registry, auto-detection
+├── plugins/                # Plugin system (v0.2.0)
+│   ├── protocols.py         #   V2 protocols: ParserPlugin, ExporterPlugin, ConnectorPlugin
+│   ├── discovery.py         #   Entry point scanning via importlib.metadata
+│   └── hooks.py             #   Pipeline hook system (HookManager)
+├── connectors/             # Connector infrastructure (Phase 2 prep)
+│   └── base.py              #   ConnectorRegistry, ConnectorError
+├── ingest/                 # Phase 1 — 11 parsers, registry, auto-detection
 │   ├── base.py              #   ParsedContent dataclass + Parser Protocol
-│   ├── registry.py          #   Auto-detection + parser dispatch
+│   ├── registry.py          #   Auto-detection + plugin discovery + parser dispatch
 │   ├── markdown.py          #   .md with YAML front matter
 │   ├── plaintext.py         #   .txt, stdin, Slack dumps
 │   ├── yaml_input.py        #   .yaml/.yml/.json structured input
@@ -190,11 +217,15 @@ src/intake/
 │   ├── docx.py              #   .docx via python-docx
 │   ├── jira.py              #   Jira JSON exports (API + list format)
 │   ├── confluence.py        #   Confluence HTML via BS4 + markdownify
-│   └── image.py             #   Image analysis via LLM vision
+│   ├── image.py             #   Image analysis via LLM vision
+│   ├── url.py               #   HTTP/HTTPS URLs via httpx + markdownify
+│   ├── slack.py             #   Slack workspace export JSON
+│   └── github_issues.py     #   GitHub Issues JSON
 ├── analyze/                # Phase 2 — LLM orchestration (async)
 │   ├── analyzer.py          #   Orchestrator: extraction → dedup → risk → design
 │   ├── prompts.py           #   3 system prompts (extraction, risk, design)
 │   ├── models.py            #   10 dataclasses for analysis pipeline
+│   ├── complexity.py        #   Heuristic complexity classification (quick/standard/enterprise)
 │   ├── extraction.py        #   LLM JSON → typed AnalysisResult
 │   ├── dedup.py             #   Jaccard word similarity deduplication
 │   ├── conflicts.py         #   Conflict validation
@@ -203,13 +234,14 @@ src/intake/
 │   └── design.py            #   Design output parsing (tasks, checks)
 ├── generate/               # Phase 3 — Jinja2 template rendering
 │   ├── spec_builder.py      #   Orchestrates 6 spec files + lock
+│   ├── adaptive.py          #   AdaptiveSpecBuilder — mode-aware file selection
 │   └── lock.py              #   spec.lock.yaml for reproducibility
 ├── verify/                 # Phase 4 — Acceptance check engine
 │   ├── engine.py           #   4 check types: command, files_exist, pattern_*
 │   └── reporter.py         #   Terminal (Rich), JSON, JUnit XML reporters
 ├── export/                 # Phase 5 — Agent-ready output
 │   ├── base.py             #   Exporter Protocol
-│   ├── registry.py         #   Format-based exporter dispatch
+│   ├── registry.py         #   Plugin discovery + format-based dispatch
 │   ├── architect.py        #   pipeline.yaml generation
 │   └── generic.py          #   SPEC.md + verify.sh generation
 ├── diff/                   # Spec comparison
@@ -221,13 +253,15 @@ src/intake/
 ├── templates/              # Jinja2 templates for spec generation
 │   ├── requirements.md.j2   #   FR, NFR, conflicts, open questions
 │   ├── design.md.j2         #   Components, files, tech decisions
-│   ├── tasks.md.j2          #   Task summary + detailed sections
+│   ├── tasks.md.j2          #   Task summary + status + detailed sections
 │   ├── acceptance.yaml.j2   #   Executable acceptance checks
 │   ├── context.md.j2        #   Project context for agents
 │   └── sources.md.j2        #   Source traceability mapping
-└── utils/                  # Shared utilities (logging, cost, detection)
+└── utils/                  # Shared utilities
     ├── file_detect.py       #   Extension-based format detection
     ├── project_detect.py    #   Auto-detect tech stack from project files
+    ├── source_uri.py        #   URI parsing (jira://, github://, http://, files, text)
+    ├── task_state.py         #   Task status tracking in tasks.md
     ├── cost.py              #   Cost accumulation with per-phase breakdown
     └── logging.py           #   structlog configuration
 ```
@@ -235,9 +269,11 @@ src/intake/
 **Key design principles:**
 
 - **Protocol over ABC** — All extension points use `typing.Protocol`
+- **Plugin-first architecture** — Parsers and exporters discovered via entry points, manual fallback
 - **Dataclasses for pipeline data, Pydantic for config** — Never mixed
 - **Async only in analyze/** — Everything else is synchronous
 - **Offline mode** — Parsing, verification, export, diff, doctor all work without LLM
+- **Adaptive generation** — Complexity auto-detection selects quick/standard/enterprise mode
 - **No magic strings** — All constants defined explicitly
 - **Budget enforcement** — LLM cost tracked per call with configurable limits
 
@@ -283,24 +319,29 @@ python -m pytest tests/ --cov=intake --cov-report=term-missing
 # Lint
 ruff check src/ tests/
 
+# Format
+ruff format src/ tests/
+
 # Type check (strict)
 mypy src/ --strict
 ```
 
-Current test suite: **313 tests**, **83% coverage**.
+Current test suite: **492 tests**, **86% coverage**, **0 mypy --strict errors**, **0 ruff warnings**.
 
 ### Implementation Status
 
 | Phase | Module | Status |
 |-------|--------|--------|
-| Phase 1 — Ingest | `ingest/` (8 parsers + registry) | Implemented |
-| Phase 2 — Analyze | `analyze/` (orchestrator + 7 sub-modules) | Implemented |
-| Phase 3 — Generate | `generate/` (spec builder + 6 templates + lock) | Implemented |
+| Phase 1 — Ingest | `ingest/` (11 parsers + plugin-based registry) | Implemented |
+| Phase 2 — Analyze | `analyze/` (orchestrator + 7 sub-modules + complexity) | Implemented |
+| Phase 3 — Generate | `generate/` (spec builder + adaptive builder + 6 templates + lock) | Implemented |
 | Phase 4 — Verify | `verify/` (engine + 3 reporters) | Implemented |
-| Phase 5 — Export | `export/` (architect + generic) | Implemented |
+| Phase 5 — Export | `export/` (architect + generic + plugin registry) | Implemented |
+| Plugins | `plugins/` (protocols + discovery + hooks) | Implemented |
+| Connectors | `connectors/` (registry infrastructure, no concrete connectors) | Implemented |
 | Standalone | `doctor/`, `config/`, `llm/`, `utils/` | Implemented |
 | Standalone | `diff/` (spec differ) | Implemented |
-| CLI | All 8 commands wired end-to-end | Implemented |
+| CLI | 13 commands/subcommands wired end-to-end | Implemented |
 
 ---