Release v0.1.0: production hardening

.github/workflows/ci.yml

@@ -38,10 +38,16 @@ jobs:
         run: uv sync
 
       - name: Lint (ruff)
-        run: uv run --with ruff ruff check src tests
+        run: uv run ruff check src tests examples
+
+      - name: Format check (ruff)
+        run: uv run ruff format --check src tests examples
 
       - name: Type-check (mypy)
-        run: uv run --with mypy mypy src tests
+        run: uv run mypy src tests examples
 
       - name: Test (pytest)
         run: uv run pytest
+
+      - name: Build (verify the package builds)
+        run: uv build

CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to agentling are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project aims
+to follow [semantic versioning](https://semver.org/).
+
+## [0.1.0] - 2026-07-07
+
+The first real release: the core framework plus a production-hardening pass.
+
+### Added
+
+- Async ReAct agent loop with a single streaming code path (`Agent` config and
+  factory, `AgentSession` run state); blocking and streaming `run()`.
+- Provider-neutral model layer and an OpenAI-compatible adapter with retries.
+- `@tool` decorator with JSON Schema generation, argument validation, and
+  per-tool metadata (`timeout`, `parallel_safe`, `max_output_chars`).
+- Typed memory (`TaskStep` / `ActionStep` / `FinalStep`) with JSON persistence
+  and load validation (`MemoryLoadError`).
+- Streaming events, a `print_events` renderer, and a terminal run `status`
+  (completed / interrupted / max_steps).
+- Progressive-disclosure skills (`SKILL.md`) with a built-in `load_skill` tool.
+- An exception hierarchy under `AgentlingError`, public API exports, and
+  `__all__`.
+- Timeouts (`tool_timeout`, `model_timeout`), prompt cancellation, sync tools
+  run off the event loop, optional error redaction (`redact_errors`), cumulative
+  token usage on the final event, and a `context_manager` hook for long runs.
+
+[0.1.0]: https://github.com/folathecoder/agentling/releases/tag/v0.1.0

CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing to agentling
+
+Thanks for your interest in improving agentling.
+
+## Development setup
+
+agentling uses [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv sync   # create the environment and install all dependencies
+```
+
+## The checks
+
+These all run in CI and must pass. Run them locally before opening a PR:
+
+```bash
+uv run pytest                         # tests
+uv run ruff check src tests           # lint
+uv run ruff format --check src tests  # formatting (run `ruff format` to fix)
+uv run mypy src tests                 # type-check
+uv build                              # the package builds
+```
+
+## Guidelines
+
+- Keep the framework small and readable; prefer clarity over cleverness.
+- Add tests for new behavior, including the failure paths.
+- Type everything; the codebase is checked with mypy.
+- Match the surrounding style; `ruff format` is the source of truth.
+- Avoid new runtime dependencies unless they clearly earn their place.
+
+## Reporting bugs and vulnerabilities
+
+Open a GitHub issue for bugs. For security reports, see [SECURITY.md](SECURITY.md).