10xscale-agentflow-cli 0.4.0__tar.gz → 0.5.1__tar.gz

{10xscale_agentflow_cli-0.4.0 → 10xscale_agentflow_cli-0.5.1/10xscale_agentflow_cli.egg-info}/PKG-INFO

@@ -1,14 +1,15 @@
 Metadata-Version: 2.4
 Name: 10xscale-agentflow-cli
-Version: 0.4.0
+Version: 0.5.1
 Summary: CLI and API for 10xscale AgentFlow
-Author-email: 10xscale <contact@10xscale.ai>
-Maintainer-email: Shudipto Trafder <shudiptotrafder@gmail.com>
+Author-email: Shudipto Trafder <shudiptotrafder@gmail.com>
+Maintainer-email: Shudipto Trafder <shudiptotrafder@gmail.com>, 10xScale <contact@10xscale.ai>
 License: MIT
 Project-URL: Homepage, https://github.com/10xHub/agentflow-cli
 Project-URL: Repository, https://github.com/10xHub/agentflow-cli
 Project-URL: Issues, https://github.com/10xHub/agentflow-cli/issues
-Project-URL: Documentation, https://agentflow-cli.readthedocs.io/
+Project-URL: Documentation, https://10xhub.github.io/Agentflow/
+Project-URL: Changelog, https://github.com/10xHub/agentflow-cli/blob/main/CHANGELOG.md
 Keywords: 10xscale AgentFlow,api,fastapi,cli,agentflow
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -22,28 +23,30 @@ Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: 10xscale-agentflow>=0.8.0
-Requires-Dist: fastapi
-Requires-Dist: gunicorn
-Requires-Dist: orjson
-Requires-Dist: python-multipart
-Requires-Dist: pydantic
-Requires-Dist: pydantic-settings
-Requires-Dist: uvicorn
-Requires-Dist: typer
-Requires-Dist: python-dotenv
-Requires-Dist: questionary
+Requires-Dist: 10xscale-agentflow<2.0,>=0.9.0
+Requires-Dist: fastapi<1.0,>=0.116
+Requires-Dist: gunicorn<24,>=23.0
+Requires-Dist: orjson<4,>=3.11
+Requires-Dist: platformdirs<5,>=4.0
+Requires-Dist: python-multipart<0.1,>=0.0.19
+Requires-Dist: pydantic<3,>=2.13
+Requires-Dist: pydantic-settings<3,>=2.3
+Requires-Dist: uvicorn<1.0,>=0.30
+Requires-Dist: typer<1.0,>=0.17
+Requires-Dist: python-dotenv<2,>=1.0
+Requires-Dist: questionary<3,>=2.0
+Requires-Dist: rich<15,>=14.0
 Provides-Extra: sentry
 Requires-Dist: sentry-sdk>=2.10.0; extra == "sentry"
 Provides-Extra: firebase
 Requires-Dist: firebase-admin>=6.5.0; extra == "firebase"
 Requires-Dist: oauth2client>=4.1.3; extra == "firebase"
 Provides-Extra: snowflakekit
-Requires-Dist: snowflakekit; extra == "snowflakekit"
+Requires-Dist: snowflakekit<1.0,>=0.1.1; extra == "snowflakekit"
 Provides-Extra: redis
-Requires-Dist: redis>=5.0.7; extra == "redis"
+Requires-Dist: redis<7,>=5.0.7; extra == "redis"
 Provides-Extra: jwt
-Requires-Dist: PyJWT; extra == "jwt"
+Requires-Dist: PyJWT<3,>=2.8; extra == "jwt"
 Provides-Extra: media
 Requires-Dist: textxtract[docx,html,md,pdf,xml]>=0.2.0; extra == "media"
 Provides-Extra: gcloud
@@ -131,21 +134,24 @@ Requires **Python ≥ 3.12**. Depends on the core `10xscale-agentflow` framework
 # 1. Scaffold a project (interactive: dev vs production, auth, rate limiting)
 agentflow init
 
-# 2. Start the dev API server (127.0.0.1:8000)
-agentflow api
+# 2. Start the local development server and open the playground (127.0.0.1:8000)
+agentflow dev
 
-# 3. Or start the server and open the hosted playground
-agentflow play
+# 3. Check the environment if anything looks wrong
+agentflow audit
 
 # 4. Generate production Docker files
 agentflow build --docker-compose
 ```
 
+`agentflow api` (server only) and `agentflow play` (server + playground) remain
+available; `dev` is the goal-oriented wrapper around them.
+
 ---
 
 ## 🖥️ CLI Commands
 
-For detailed command documentation, see the **[CLI Guide](./docs/cli-guide.md)**.
+Run `agentflow --help` or `agentflow COMMAND --help` for the generated command reference.
 
 ### `agentflow init`
 
@@ -155,30 +161,63 @@ Initialize a new project with configuration and a sample graph.
 agentflow init                  # interactive (chooses dev vs production setup)
 agentflow init --path ./my-app  # custom directory
 agentflow init --force          # overwrite existing files
+agentflow init --path ./my-app --name MyAgent --template quick-start \
+  --non-interactive            # reproducible CI/agent workflow
+agentflow init --path ./my-app --template production --auth jwt \
+  --rate-limit redis --yes --dry-run
 ```
 
-### `agentflow api`
+### `agentflow dev`
 
-Start the development API server.
+Start the development API server and open the hosted playground when it is ready.
 
 ```bash
-agentflow api                              # defaults (127.0.0.1:8000)
-agentflow api --host 127.0.0.1 --port 9000 # custom host/port
-agentflow api --config production.json     # custom config file
-agentflow api --no-reload                  # disable auto-reload
-agentflow api --verbose                    # verbose logging
+agentflow dev                              # defaults (127.0.0.1:8000)
+agentflow dev --host 127.0.0.1 --port 9000 # custom host/port
+agentflow dev --config production.json     # custom config file
+agentflow dev --no-open --no-reload        # API only, without auto-reload
 ```
 
-### `agentflow play`
+`agentflow api` and `agentflow play` remain available as compatibility commands.
 
-Start the dev server and open the hosted playground with your local backend URL preconfigured.
+### Adaptive and structured output
 
 ```bash
-agentflow play
-agentflow play --host 127.0.0.1 --port 9000
-agentflow play --config production.json
+agentflow play                         # full-screen surface in an interactive terminal
+agentflow demo                         # preview every animation theme safely
+agentflow demo --style build           # one theme: typing, network, init, build, or eval
+agentflow --no-fullscreen play         # keep output in your normal scrollback
+agentflow --no-animation play          # accessible/static workflow
+agentflow --format plain --no-color audit
+agentflow --format jsonl eval --parallel
+agentflow --quiet build
+agentflow --cwd ../my-agent dev
 ```
 
+On an interactive terminal a command runs on its own full-screen surface: a
+pinned header (identity, version, subtitle), a pinned footer status bar, and the
+command's output scrolling between them. The intro reveals the Agentflow
+wordmark on the full canvas and collapses into that header, and each command
+shows its own pipeline — `play`/`dev` config→runtime→server→playground, `init`
+template→graph→config→project, `build` source→deps→image→ship, `eval`
+discover→load→score→report, `audit` python→core→config→port.
+
+The surface is held until you press Enter, so a fast command cannot erase its
+own result. Pass `--no-fullscreen` (or set `AGENTFLOW_NO_FULLSCREEN=1`) to keep
+everything in your normal scrollback instead — useful when you want to scroll
+back or copy a path afterwards.
+
+Long-running work reports through a live step timeline: stages are declared up
+front, pending ones stay dimmed, and the running one animates with an elapsed
+timer. `agentflow eval` uses a determinate progress bar with a running pass/fail
+tally.
+
+Motion is disabled automatically for redirected output, CI, `TERM=dumb`,
+JSON/JSONL, and `AGENTFLOW_NO_SPINNER=1`. Use `--no-animation` for a stable
+screen-reader friendly experience, or `--animation` to force motion in a
+compatible terminal. Every animated surface has a plain line-per-transition
+renderer and a versioned JSON/JSONL event renderer.
+
 ### `agentflow build`
 
 Generate production Docker files.
@@ -186,8 +225,10 @@ Generate production Docker files.
 ```bash
 agentflow build                            # Dockerfile
 agentflow build --docker-compose           # Dockerfile + docker-compose.yml
+agentflow build --k8s                      # Dockerfile + k8s.yaml (Deployment + Service)
 agentflow build --python-version 3.12 --port 9000
-agentflow build --force
+agentflow build --service-name my-agent    # name used in docker-compose.yml / k8s.yaml
+agentflow build --force                    # overwrite an existing Dockerfile
 ```
 
 ### `agentflow eval` / `agentflow test`
@@ -204,19 +245,71 @@ agentflow test --coverage
 Install bundled coding-agent skills (Codex, Claude, GitHub Copilot) into your project so your AI assistant knows how to build with Agentflow.
 
 ```bash
+agentflow skills                # pick agents interactively (space toggles, enter confirms)
 agentflow skills --all          # install for every supported agent
 agentflow skills --agent claude # install for one
 agentflow skills --list         # show supported agents
+agentflow skills --force        # overwrite an existing install
 ```
 
+Run without flags to get a checklist of the supported agents. Each row shows
+where it installs, agents that are already set up are labelled and pre-checked,
+and picking one that exists offers to overwrite rather than failing.
+
 ### `agentflow version`
 
 Display CLI and package version information.
 
 ```bash
+agentflow --version            # script-friendly CLI version only
 agentflow version
 ```
 
+### `agentflow audit`
+
+Read-only check of everything that has to be true before `dev`, `eval`, or `build`
+can work here: the Python interpreter, the installed `10xscale-agentflow-cli` and
+`10xscale-agentflow` packages, whether the installed core still exposes the
+evaluation API this CLI imports, whether `agentflow.json` is present and declares a
+valid `agent` key, and whether the default port is free.
+
+```bash
+agentflow audit                    # table of six checks
+agentflow --format json audit      # machine-readable, for CI
+agentflow --no-animation audit     # static output
+```
+
+Nothing is written or changed. It exits `1` if any check fails and `0` otherwise —
+warnings (no project config, port already bound) are reported without failing the
+run — so it works as a CI gate.
+
+### `agentflow config`
+
+Manage cross-platform user-level CLI preferences, stored as JSON in the per-user
+config directory (`platformdirs`, e.g. `~/.config/agentflow/config.json` on Linux).
+Keys are dot-separated; the output preferences read at startup are
+`output.format` (`human`, `plain`, `json`, `jsonl`), `output.color` (`auto`,
+`always`, `never`), and `output.progress` (`auto`, `tty`, `plain`, `json`, `quiet`).
+Command-line flags always win over the stored values.
+
+```bash
+agentflow config path                      # where preferences are stored
+agentflow config list                      # every stored preference
+agentflow config set output.format plain
+agentflow config get output.format
+agentflow config unset output.format
+agentflow config validate                  # parse the file and check known keys
+```
+
+### `agentflow demo`
+
+Preview the terminal animations and progress states without touching project state.
+
+```bash
+agentflow demo                  # every theme
+agentflow demo --style eval     # one of: typing, network, init, build, eval
+```
+
 ---
 
 ## ⚙️ Configuration
@@ -462,7 +555,8 @@ git tag v0.3.2.9 && git push origin v0.3.2.9
 
 ## 📄 License
 
-MIT License - see [LICENSE](https://github.com/10xHub/agentflow-cli/blob/main/LICENSE) for details.
+Agentflow is [MIT licensed](https://github.com/10xHub/agentflow-cli/blob/main/LICENSE) and made by
+[10xScale](https://10xscale.ai). Contributions are accepted under the same license.
 
 ---
 

{10xscale_agentflow_cli-0.4.0 → 10xscale_agentflow_cli-0.5.1}/10xscale_agentflow_cli.egg-info/SOURCES.txt

@@ -1,7 +1,11 @@
-CLAUDE.md
+CHANGELOG.md
+CODE_OF_CONDUCT.md
+CONTRIBUTING.md
 LICENSE
 MANIFEST.in
 README.md
+RELEASE_NOTES.md
+SECURITY.md
 agentflow.json
 pyproject.toml
 10xscale_agentflow_cli.egg-info/PKG-INFO
@@ -12,30 +16,45 @@ pyproject.toml
 10xscale_agentflow_cli.egg-info/requires.txt
 10xscale_agentflow_cli.egg-info/top_level.txt
 agentflow_cli/__init__.py
+agentflow_cli/py.typed
 agentflow_cli/cli/__init__.py
+agentflow_cli/cli/capabilities.py
 agentflow_cli/cli/constants.py
+agentflow_cli/cli/context.py
 agentflow_cli/cli/exceptions.py
 agentflow_cli/cli/logger.py
 agentflow_cli/cli/main.py
+agentflow_cli/cli/user_config.py
 agentflow_cli/cli/commands/__init__.py
 agentflow_cli/cli/commands/api.py
+agentflow_cli/cli/commands/audit.py
 agentflow_cli/cli/commands/build.py
+agentflow_cli/cli/commands/demo.py
 agentflow_cli/cli/commands/eval.py
 agentflow_cli/cli/commands/init.py
 agentflow_cli/cli/commands/skills.py
 agentflow_cli/cli/commands/test.py
 agentflow_cli/cli/commands/version.py
 agentflow_cli/cli/core/__init__.py
+agentflow_cli/cli/core/animations.py
 agentflow_cli/cli/core/config.py
 agentflow_cli/cli/core/output.py
+agentflow_cli/cli/core/prompts.py
+agentflow_cli/cli/core/screen.py
+agentflow_cli/cli/core/steps.py
+agentflow_cli/cli/core/theme.py
 agentflow_cli/cli/core/validation.py
 agentflow_cli/cli/templates/__init__.py
 agentflow_cli/cli/templates/defaults.py
+agentflow_cli/cli/templates/dev/.env.example
 agentflow_cli/cli/templates/dev/agentflow.json
 agentflow_cli/cli/templates/dev/graph/__init__.py
 agentflow_cli/cli/templates/dev/graph/agent.py
-agentflow_cli/cli/templates/prod/.pre-commot-config.yaml
+agentflow_cli/cli/templates/prod/.env.example
+agentflow_cli/cli/templates/prod/.pre-commit-config.yaml
+agentflow_cli/cli/templates/prod/.python-version
 agentflow_cli/cli/templates/prod/agentflow.json
+agentflow_cli/cli/templates/prod/pyproject.toml
 agentflow_cli/cli/templates/prod/auth/__init__.py
 agentflow_cli/cli/templates/prod/auth/agent_auth.py
 agentflow_cli/cli/templates/prod/evals/__init__.py
@@ -104,7 +123,9 @@ agentflow_cli/src/app/core/auth/auth_backend.py
 agentflow_cli/src/app/core/auth/authorization.py
 agentflow_cli/src/app/core/auth/base_auth.py
 agentflow_cli/src/app/core/auth/jwt_auth.py
+agentflow_cli/src/app/core/auth/ownership_resolver.py
 agentflow_cli/src/app/core/auth/permissions.py
+agentflow_cli/src/app/core/auth/route_guard.py
 agentflow_cli/src/app/core/config/__init__.py
 agentflow_cli/src/app/core/config/graph_config.py
 agentflow_cli/src/app/core/config/media_settings.py
@@ -131,8 +152,6 @@ agentflow_cli/src/app/core/middleware/rate_limit/redis.py
 agentflow_cli/src/app/core/utils/__init__.py
 agentflow_cli/src/app/core/utils/log_sanitizer.py
 agentflow_cli/src/app/routers/__init__.py
-agentflow_cli/src/app/routers/a2a.py
-agentflow_cli/src/app/routers/a2ui.py
 agentflow_cli/src/app/routers/setup_router.py
 agentflow_cli/src/app/routers/checkpointer/__init__.py
 agentflow_cli/src/app/routers/checkpointer/router.py
@@ -140,6 +159,10 @@ agentflow_cli/src/app/routers/checkpointer/schemas/__init__.py
 agentflow_cli/src/app/routers/checkpointer/schemas/checkpointer_schemas.py
 agentflow_cli/src/app/routers/checkpointer/services/__init__.py
 agentflow_cli/src/app/routers/checkpointer/services/checkpointer_service.py
+agentflow_cli/src/app/routers/evals/__init__.py
+agentflow_cli/src/app/routers/evals/router.py
+agentflow_cli/src/app/routers/evals/services/__init__.py
+agentflow_cli/src/app/routers/evals/services/eval_report_service.py
 agentflow_cli/src/app/routers/graph/__init__.py
 agentflow_cli/src/app/routers/graph/realtime_guard.py
 agentflow_cli/src/app/routers/graph/router.py
@@ -167,6 +190,7 @@ agentflow_cli/src/app/utils/parse_output.py
 agentflow_cli/src/app/utils/response_helper.py
 agentflow_cli/src/app/utils/snowflake_id_generator.py
 agentflow_cli/src/app/utils/swagger_helper.py
+agentflow_cli/src/app/utils/telemetry_store.py
 agentflow_cli/src/app/utils/thread_name_generator.py
 agentflow_cli/src/app/utils/media/__init__.py
 agentflow_cli/src/app/utils/media/extractor.py

{10xscale_agentflow_cli-0.4.0 → 10xscale_agentflow_cli-0.5.1}/10xscale_agentflow_cli.egg-info/requires.txt

@@ -1,14 +1,16 @@
-10xscale-agentflow>=0.8.0
-fastapi
-gunicorn
-orjson
-python-multipart
-pydantic
-pydantic-settings
-uvicorn
-typer
-python-dotenv
-questionary
+10xscale-agentflow<2.0,>=0.9.0
+fastapi<1.0,>=0.116
+gunicorn<24,>=23.0
+orjson<4,>=3.11
+platformdirs<5,>=4.0
+python-multipart<0.1,>=0.0.19
+pydantic<3,>=2.13
+pydantic-settings<3,>=2.3
+uvicorn<1.0,>=0.30
+typer<1.0,>=0.17
+python-dotenv<2,>=1.0
+questionary<3,>=2.0
+rich<15,>=14.0
 
 [firebase]
 firebase-admin>=6.5.0
@@ -18,7 +20,7 @@ oauth2client>=4.1.3
 google-cloud-logging
 
 [jwt]
-PyJWT
+PyJWT<3,>=2.8
 
 [media]
 textxtract[docx,html,md,pdf,xml]>=0.2.0
@@ -30,10 +32,10 @@ opentelemetry-instrumentation-fastapi>=0.40b0
 opentelemetry-exporter-otlp>=1.20.0
 
 [redis]
-redis>=5.0.7
+redis<7,>=5.0.7
 
 [sentry]
 sentry-sdk>=2.10.0
 
 [snowflakekit]
-snowflakekit
+snowflakekit<1.0,>=0.1.1

10xscale_agentflow_cli-0.5.1/CHANGELOG.md

@@ -0,0 +1,189 @@
+# Changelog
+
+All notable changes to `10xscale-agentflow-cli` are documented here.
+
+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).
+
+## Compatibility policy
+
+- **Nothing public is removed without a deprecation cycle.** A public name (anything
+  exported from `agentflow_cli`, a CLI command or flag, an HTTP route, or an
+  `agentflow.json` key) is first marked deprecated in a release, kept working for at
+  least one subsequent minor release, and only then removed in a major release.
+- **Moved modules keep a back-compat shim** re-exporting from the new location for at
+  least one minor release. Import paths do not break silently.
+- **Breaking changes are documented under a `### Breaking` heading** in the release's
+  section, with the migration step spelled out.
+- Anything under `agentflow_cli.cli.templates/` is emitted scaffolding, not API; template
+  content can change in any release.
+
+---
+
+## [Unreleased]
+
+### Added
+
+- **Persistent full-screen application surface.** On an interactive terminal a
+  command now runs on its own screen with branded chrome pinned in place: a
+  header (gradient rule, identity, version, subtitle) at the top, a footer
+  status bar at the bottom, and the command's output scrolling between them.
+  Pinning uses a DEC scrolling region, so it survives output from child
+  processes — pytest, Uvicorn, Questionary prompts — without routing any of it
+  through a renderer. The screen is held until you press Enter, and released
+  through a `finally` guard so a crash can never leave your shell on an
+  alternate buffer or inside a scrolling region. Opt out with `--no-fullscreen`
+  or `AGENTFLOW_NO_FULLSCREEN=1`.
+- Full-canvas animated command intro: an eased block-letter `AGENTFLOW` reveal
+  with a moving light front, a flowing gradient field, a typed tagline, and a
+  per-command pipeline that fills in as the intro plays. Inside the full-screen
+  surface it collapses into the pinned header; with `--no-fullscreen` it plays
+  on a temporary screen and leaves a durable header in your scrollback.
+- Live step timelines (`OutputFormatter.timeline`): a command declares its stages
+  up front, so pending work is visible from the first frame while the running
+  stage animates with a spinner, elapsed timer, and a live detail line. Wired
+  into `play`/`dev`/`api`, `init`, `build`, `test`, and `audit`.
+- Determinate progress with a running pass/fail tally
+  (`OutputFormatter.progress_run`), used by `agentflow eval` so per-case results
+  scroll above a bar that reports completion, counts, and elapsed time.
+- Shared brand palette and glyph sets (`cli/core/theme.py`) with continuous
+  gradient sampling and a complete ASCII fallback set.
+- Command-specific intro signatures and taglines for `play`, `dev`, `api`,
+  `init`, `build`, `test`, `eval`, `audit`, and `skills`, previewable with the
+  side-effect-free `agentflow demo` (`--style all|typing|network|init|build|eval`).
+- Row-by-row reveal for completion panels.
+- **Shared guided-prompt layer** (`cli/core/prompts.py`). Every interactive
+  question now runs through one themed service, so prompts share a palette, a
+  cancellation contract (Ctrl+C returns to a clean exit rather than a
+  traceback), and one non-interactive policy.
+- `agentflow skills` picks agents with an arrow-key list where **space toggles**
+  and enter confirms, instead of typing a menu number. Each row shows its
+  install path, already-installed agents are labelled and pre-checked, and
+  choosing one that exists offers to overwrite rather than failing.
+- `agentflow skills` reports installs through a timeline and a completion
+  screen, matching every other command.
+- `agentflow init` prompts now explain each option inline — what Quick Start
+  versus Production scaffolds, what each auth mode requires, what each rate
+  limit backend costs.
+- Staged startup feedback, a pre-flight port check, and connected-playground
+  completion output for `agentflow play` and `agentflow dev`.
+- Adaptive `--animation` / `--no-animation` controls with CI, pipe, JSON, and
+  accessibility-safe fallbacks. Every animated surface has a plain
+  line-per-transition renderer and a versioned JSON/JSONL event renderer.
+- Adaptive Rich terminal rendering with TTY/CI detection, plain/JSONL modes,
+  `NO_COLOR` support, ASCII fallback, quiet mode, and shared status rendering.
+- Root `--format`, `--json`, `--color`, `--no-color`, `--progress`,
+  `--animation/--no-animation`, `--fullscreen/--no-fullscreen`, `--cwd`,
+  `--yes`, `--non-interactive`, `--debug`, and `-V/--version` options.
+- `agentflow dev` as the goal-oriented local development command (config, host,
+  port, `--reload/--no-reload`, `--open/--no-open`); `api` and `play` remain
+  available for compatibility.
+- `agentflow audit`: six read-only checks — Python interpreter, installed
+  `10xscale-agentflow-cli`, installed `10xscale-agentflow`, whether the installed
+  core still exposes the evaluation API `agentflow eval` imports, whether
+  `agentflow.json` exists and declares a valid `agent` key, and whether the
+  default port is free. Reported live through the timeline and again as a summary
+  table. Exits `1` on any failure and `0` otherwise (warnings do not fail the
+  run), so it works as a CI gate; nothing is written or changed.
+- `agentflow demo`: preview the animation, timeline, and progress states without
+  touching project state.
+- Cross-platform `agentflow config list|get|set|unset|path|validate` user
+  preferences, stored as JSON in the per-user config directory. `output.format`,
+  `output.color`, and `output.progress` are read at startup as defaults; explicit
+  flags still win.
+- Reproducible `agentflow init --non-interactive` recipes and `--dry-run` previews.
+- Stable CLI error codes and dependency recovery suggestions.
+- `py.typed` marker, so type information now reaches consumers (PEP 561).
+- `--integration` pytest flag gating tests marked `integration` that require real
+  Redis/Postgres, so a default `pytest` run needs no external services.
+- mypy configuration (`[tool.mypy]`) and a mypy step in CI.
+- CodeQL static analysis workflow.
+- Dependabot configuration for pip and GitHub Actions updates.
+- Community health files: `CONTRIBUTING.md`, `SECURITY.md`, `CODE_OF_CONDUCT.md`,
+  `RELEASE_NOTES.md`, issue forms, and a pull request template.
+- `Changelog` entry in project URLs.
+
+### Changed
+
+- Command implementations are loaded lazily, so a broken optional feature no longer
+  prevents root help, version, completion, or unrelated commands from starting.
+- CLI logging now uses one invocation-wide handler, so quiet and verbose levels apply
+  consistently without duplicate records.
+- Project configuration discovery now walks parent directories from the current
+  working directory.
+- Init, build, and eval status output now flows through the shared renderer instead of
+  writing raw ANSI control sequences.
+- **The full-screen session no longer erases the command's output.** It used to
+  hold the alternate screen through a Rich live display, which re-homes the
+  cursor before every write — so each line overwrote the last — and then released
+  the screen on exit, which a terminal handles by discarding everything drawn on
+  it. Short commands showed a flash of nothing. The frame now switches the buffer
+  directly and pauses on a closing hint before letting go.
+- The screen is claimed lazily, by the first command that renders a header.
+  Script-shaped invocations (`--version`, `config get`, `--format json`) never
+  take over the terminal or pause on exit.
+- A console that reports itself as a terminal but refuses the alternate buffer
+  (legacy Windows console) now aborts the frame before anything is written,
+  rather than leaving a scrolling region on the user's real scrollback.
+- **A terminal that cannot host a prompt no longer crashes the command.**
+  `stdin.isatty()` is true under MSYS/Cygwin shells on Windows, but
+  prompt-toolkit cannot attach to a console there and raises — which surfaced as
+  `AF-INTERNAL-001: Unexpected error: Found xterm-256color, while expecting a
+  Windows console`. Prompt availability is now probed, so such a terminal counts
+  as non-interactive and gets the usual "pass --agent or --all" guidance.
+- Pinned chrome is repainted after each prompt. Prompt-toolkit erases from the
+  cursor to the end of the *screen*, which reaches past the scrolling region and
+  took the footer with it.
+- One Rich `Console` is now reused per stream. Rebuilding it per call meant a live
+  display could not tell that ordinary prints belonged to it, so background output
+  collided with spinners and progress bars instead of scrolling above them.
+- `agentflow init` no longer prints one line per scaffolded file; files stream through
+  the active timeline row instead.
+
+### Fixed
+
+- **Scaffolding templates were missing from the wheel.** The `package-data` globs only
+  matched `*.json/*.yaml/*.yml/*.md/*.txt`, silently dropping
+  `templates/dev/.env.example`, `templates/prod/.env.example`,
+  `templates/prod/.python-version`, and `templates/prod/pyproject.toml`. `agentflow init`
+  failed for anyone installing from PyPI. Packaging now ships the package tree wholesale.
+- `agentflow version` reported `unknown` for the package version when installed from a
+  wheel, because it read `pyproject.toml` from a path that does not exist in an installed
+  distribution. It now resolves from installed distribution metadata and additionally
+  reports the core `10xscale-agentflow` version.
+- The `prod` template shipped `.pre-commot-config.yaml` (typo), so `pre-commit` found no
+  config in scaffolded projects. Renamed to `.pre-commit-config.yaml`.
+- Branch coverage is now measured by the default `pytest` invocation (`--cov-branch`),
+  not only in the CI-specific command.
+
+### Changed
+
+- **Every runtime dependency now has a lower bound**, and pre-1.0 / major-version-risky
+  dependencies have an upper cap (`pydantic>=2.13,<3`, `fastapi>=0.116,<1.0`,
+  `10xscale-agentflow>=0.9.0,<2.0`, and so on). Previously all runtime dependencies were
+  unpinned, so a major release of any of them could break installs without warning.
+- Optional extras `snowflakekit`, `redis`, and `jwt` gained bounds.
+- CI now runs on pushes to `main` as well as pull requests, and covers both advertised
+  Python versions (3.12 and 3.13) rather than 3.13 alone.
+- The release workflow now depends on a passing test job; it no longer builds and
+  publishes untested code.
+- `Documentation` URL points at the published docs site instead of a Read the Docs URL
+  that was never provisioned.
+
+### Removed
+
+- `agentflow_cli/src/app/routers/a2a.py` and `a2ui.py`. Both were entirely commented out,
+  never mounted by `setup_router.init_routes`, and shipped in the wheel as dead code.
+  They can be restored from git history when the A2A surface is actually implemented.
+- Design and planning notes from the repository root (`AUTHORIZATION_PLAN.md`,
+  `AUTHORIZATION_PLAN_PHASE2.md`, `AGENTFLOW_JSON.md`, `CUSTOM_AUTH.md`).
+
+---
+
+## [0.5.0]
+
+Initial entry in this changelog. Releases before `0.5.0` were not tracked here; see the
+GitHub release history for their notes.
+
+[Unreleased]: https://github.com/10xHub/agentflow-cli/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/10xHub/agentflow-cli/releases/tag/v0.5.0