feat: Implement documentation deployment, build infrastructure, and refine scanner parsing logic.

Author: tercel

.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: CI
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  test:
+    name: Test on Rust ${{ matrix.rust }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        # Pin CI to stable. Add `beta` / `nightly` later if desired.
+        rust: ["stable"]
+
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ matrix.rust }}
+          components: rustfmt, clippy
+
+      - name: Cache cargo registry & build
+        uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install apdev-rs
+        run: cargo install apdev-rs
+        continue-on-error: true
+
+      - name: Check characters
+        run: apdev-rs check-chars src/
+        continue-on-error: true
+
+      - name: Check formatting
+        run: cargo fmt --all -- --check
+
+      - name: Lint with Clippy
+        run: cargo clippy --all-targets --all-features -- -D warnings
+
+      - name: Build
+        run: cargo build --all-features
+
+      - name: Run tests
+        run: cargo test --all-features

.github/workflows/deploy-docs.yml

@@ -0,0 +1,65 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "README.md"
+      - "apexe-logo.svg"
+      - ".github/workflows/deploy-docs.yml"
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.x"
+
+      - run: pip install mkdocs-material
+
+      - name: Prepare docs for MkDocs
+        run: |
+          # Copy README as index page
+          cp README.md docs/index.md
+
+          # Copy logo into docs assets
+          mkdir -p docs/assets
+          cp apexe-logo.svg docs/assets/
+
+          # Fix links in index.md: docs/X → X (since we're now inside docs/)
+          sed -i 's|\./docs/|./|g' docs/index.md
+          sed -i 's|(docs/|(|g' docs/index.md
+
+          # Fix logo reference in index.md
+          sed -i 's|\./apexe-logo\.svg|./assets/apexe-logo.svg|g' docs/index.md
+
+      - run: mkdocs build
+
+      - uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac553fd0d28 # v4.0.5

CLAUDE.md

@@ -0,0 +1,121 @@
+# CLAUDE.md — apexe Development & Code Quality Specification
+
+## Project Overview
+
+`apexe` is an Outside-In CLI-to-Agent Bridge — automatically wraps existing CLI tools into governed apcore modules, served via MCP/A2A.
+
+---
+
+## Rust Code Quality
+
+### Readability
+
+- Use precise, full-word names; standard abbreviations only when idiomatic (`buf`, `cfg`, `ctx`).
+- Functions ≤50 lines, single responsibility, verb-named (`parse_request`, `build_schema`).
+- Avoid obscure tricks, overly chained iterators, unnecessary macros, or excessive generics.
+- Break complex logic into small, well-named helper functions.
+
+### Types (Mandatory)
+
+- Provide explicit types on all public items; do not rely on inference for public API surfaces.
+- Prefer `struct` over raw tuples for anything with more than 2 fields.
+- Use **`newtype`** wrappers (`struct TaskId(Uuid);`) to encode domain semantics.
+- Use **`enum`** for exhaustive variants; avoid stringly-typed logic.
+- Implement `serde::Serialize` / `serde::Deserialize` on all public data types.
+
+### Design
+
+- Favor **composition over inheritance**; use `trait` only for true behavioral interfaces.
+- Prefer plain functions + data structs; minimize trait object (`dyn Trait`) indirection.
+- No circular module dependencies.
+- Use **dependency injection** (constructor arguments) for config, logging, DB connections, etc.
+- Keep `pub` surface minimal — default to module-private, expose only what consumers need.
+
+### Errors & Resources
+
+- Define domain errors with **`thiserror`**; no bare `Box<dyn Error>` in library code.
+- Propagate errors with `?`; no `unwrap()` / `expect()` in library paths (tests excepted).
+- If `unwrap()` / `expect()` is truly unreachable, document with a `// SAFETY:` or `// INVARIANT:` comment.
+- Validate and sanitize all public inputs at crate boundaries.
+- Use RAII / `Drop` for resource cleanup; avoid manual teardown.
+
+### Async
+
+- Runtime: **Tokio** (`features = ["full"]`).
+- Never block the async executor — use `tokio::task::spawn_blocking` for CPU-heavy work.
+- Use `tokio::time::sleep` / `tokio::time::timeout`, not `std::thread::sleep`.
+
+### Logging
+
+- Use **`tracing`** — no `println!` / `eprintln!` in production code.
+- Level guide:
+  - `tracing::error!` — unrecoverable failures
+  - `tracing::warn!`  — recoverable anomalies
+  - `tracing::info!`  — key business events
+  - `tracing::debug!` — internal state for debugging
+- Always include structured fields: `tracing::info!(task_id = %id, "task started")`.
+
+### Testing
+
+- Run with: `cargo test --all-features`
+- **Unit tests**: in the same file under `#[cfg(test)] mod tests { ... }`.
+- **Integration tests**: in `tests/` directory.
+- Test names: `test_<unit>_<behavior>` (e.g., `test_parse_request_returns_error_on_empty_body`).
+- Never change production code without adding or updating corresponding tests.
+- Use **`tokio-test`** for async test helpers.
+
+### Serialization
+
+- JSON: `serde_json`. YAML: `serde_yaml`.
+- Avoid manual `Serialize` / `Deserialize` impls unless schema shape requires it.
+
+---
+
+## Mandatory Quality Gates (CI — all must pass)
+
+Run `make check` before every commit (mirrors CI exactly):
+
+| Command | Purpose |
+|---------|---------|
+| `cargo fmt --all -- --check` | Formatting |
+| `cargo clippy --all-targets --all-features -- -D warnings` | Lint (warnings = errors) |
+| `apdev-rs check-chars src/` | Character validation |
+| `cargo build --all-features` | Full build |
+| `cargo test --all-features` | Tests |
+
+```bash
+make setup   # One-time: installs apdev-rs + pre-commit hook
+make fmt     # Auto-format
+make check   # Run all gates (do this before git commit)
+```
+
+### Clippy & Formatting Rules
+
+- `#[allow(...)]` to silence Clippy requires an inline comment explaining why.
+- `#[rustfmt::skip]` is forbidden without documented justification.
+- `Cargo.lock` **must be committed** (reproducible CI builds).
+
+### CI Security
+
+- All `uses:` actions must be pinned to a **full commit SHA** (not just a tag):
+  ```yaml
+  uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+  ```
+- Workflow default permissions: `contents: read` (minimum privilege).
+
+---
+
+## Dependency Management
+
+- Evaluate necessity before adding a new dependency.
+- Specify minimum compatible versions; avoid over-pinning patch versions.
+- Dev-only crates go in `[dev-dependencies]`, never `[dependencies]`.
+
+---
+
+## General Guidelines
+
+- **English only** for all code, comments, doc comments, error messages, and commit messages.
+- Fully understand surrounding code before making changes.
+- Do not generate unnecessary documentation stubs, example files, or boilerplate unless explicitly requested.
+- No secrets hardcoded — use environment variables or configuration files.

Makefile

@@ -0,0 +1,32 @@
+.PHONY: setup check test lint fmt clean
+
+# One-time dev environment setup
+setup:
+	@echo "Installing apdev-rs..."
+	@command -v apdev-rs >/dev/null 2>&1 || cargo install apdev-rs
+	@echo "Installing git pre-commit hook..."
+	@mkdir -p .git/hooks
+	@cp hooks/pre-commit .git/hooks/pre-commit
+	@chmod +x .git/hooks/pre-commit
+	@echo "Done! Development environment is ready."
+
+# Run all checks (same as pre-commit hook)
+check: fmt-check lint check-chars test
+
+check-chars:
+	apdev-rs check-chars src/
+
+fmt-check:
+	cargo fmt --all -- --check
+
+lint:
+	cargo clippy --all-targets --all-features -- -D warnings
+
+test:
+	cargo test --all-features
+
+fmt:
+	cargo fmt --all
+
+clean:
+	cargo clean

README.md

@@ -219,6 +219,15 @@ RUST_LOG=debug apexe scan git
 apexe --log-level debug scan git
 ```
 
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [User Manual](docs/user-manual.md) | Installation, commands, configuration, and troubleshooting guide |
+| [Technical Design](docs/tech-design.md) | Architecture, design decisions, and protocol details |
+| [Feature Manifest](docs/FEATURE_MANIFEST.md) | Feature decomposition, status, and scope summary |
+| [Feature Specs](docs/features/overview.md) | Detailed specifications for each feature (F1–F5) |
+
 ## License
 
 Apache-2.0