[houlianpi]

Summary

Prepare fsq-agent 0.3.1 with a standalone Quick Test CLI and make it the default host-neutral Coding Agent Skill workflow. A known Web starting address can be passed through --url independently of natural-language test intent; existing browser Quick Test and goal-only search remain supported.

Related issue

No separate issue: this PR implements the maintainer's explicitly authorized, SPEC-confirmed work and release-preparation request.

Design document

Direct /spec-driven requests were clarified and the resulting SPEC changes confirmed before implementation. The version bump and release records add no further runtime behavior.

SPEC updates

Confirmed root SPEC.md and the Application, AI Services, CLI, and Control Plane module SPECs. The release metadata update preserves those confirmed contracts.

Changes

• Add quick-test context and quick-test run using shared preparation/execution without project Workspace setup or an HTTP service.
• Add Web-only --url, preserve the exact caller-supplied starting reference through intent analysis, planning, and execution, and retain existing address-free search evidence requirements.
• Unify URL extraction/provenance and support Chinese punctuation, paired wrappers, labels, Markdown presentation, IPv6, and exact URL data with negative boundary checks.
• Migrate the host-neutral Skill to Quick Test with real progress, same-process cancellation, evidence-based reporting, and no automatic resubmission or Case publication. Explicit Case workflows and separate Codex compatibility resources remain available.
• Bump Python distribution metadata and its contract test to 0.3.1; update CHANGELOG, CLI reference, and release notes. The private frontend package keeps its independent version.

Verification

• Functional snapshot: .venv/bin/python -m pytest -q --ignore=tests/test_playwright_web_driver_real_browser.py — 4,699 passed, 11 skipped. The real-browser module was excluded by explicit user instruction; no live-model or all-platform execution claim.
• Release metadata: .venv/bin/python -m pytest -q tests/test_distribution_contract.py — 20 passed.
• .venv/bin/ruff check . and .venv/bin/ruff format --check . — passed (367 Python files formatted).
• npm run typecheck, npm test -- --maxWorkers=2 — passed, 520 frontend tests.
• npm run build — passed; generated assets remain ignored.
• Built 0.3.1 wheel and sdist, rebuilt a wheel from the sdist, and verified identical package contents and version metadata.
• Fresh source-free installation: both CLI entry points, exact URL/parser checks, copied Skill installation, and packaged Control Plane static resources passed.
• Complete bidirectional independent functional audit and repair review passed; independent bounded release audit recorded separately. No required local check is waived; CI/host matrix status is reported by this PR.

Evidence

The maintainer reported successful manual CLI and Coding Agent testing. No private logs, local environment/configuration, screenshots, Run evidence, or credentials are included. Automated checks use controlled collaborators and isolated configuration roots.

Release or documentation impact

Documents 0.3.1 changes and the explicit fsq init --agent skill update/reload step for copied Skills after package upgrade. This PR prepares the release only; it does not merge, create tags/releases, or publish packages.

Checklist

• Root and relevant module SPECs reviewed; required confirmation gates completed.
• Implementation and documentation grounded in current confirmed SPECs.
• Focused and required local lint/format, Python, frontend, build, and installation verification completed with stated live-test limits.
• User-facing release and CLI documentation updated.
• No credentials, local configuration, private evidence, generated logs or compiled assets committed.
• No large binary media added.