Squash-merge lib-standardisation: adopt repo standards across packaging, tooling, docs, and CI. - standardize pyproject.toml (canonical packaging, lint config, extras, GSDFC pydoclint) - add py.typed marker, modernize type hints and Google-style docstrings - nest generated docs under docs/lib and docs/mcp; add hand-written wiki - adopt standard Type A PyPI CI pipeline (tag==version guard + quality gate) - promote generated CHANGELOG.md; bump version to 0.0.7
44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
# Changelog
|
|
|
|
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).
|
|
|
|
## [Unreleased]
|
|
|
|
## [0.0.7] - 2026-10-17
|
|
|
|
### Added
|
|
- `py.typed` marker for PEP 561 type information.
|
|
- `build --refresh` flag to rebaseline an existing `docs/mkdocs.{kind}.yml`
|
|
from the packaged templates.
|
|
- `wiki` build kind with navigation derived from the source file structure.
|
|
- `--api` build mode rendering an OpenAPI reference under `docs/api` with
|
|
lib-prefixed navigation.
|
|
- Hand-written wiki, plus doc-forge-generated API reference under `docs/lib`
|
|
and MCP bundle under `docs/mcp` (per-kind MkDocs configs).
|
|
- MIT `LICENSE`.
|
|
|
|
### Changed
|
|
- Adopted the standard Type A PyPI CI pipeline: a `tag == version` guard and a
|
|
quality gate (black, ruff, mypy, pydoclint, pytest).
|
|
- Standardized `pyproject.toml` (canonical packaging, lint tool config, extras).
|
|
- Pinned the `mcp` extra to `mcp>=1.0.0,<2.0.0` to restore compatibility with
|
|
the current MCP server API used by doc-forge.
|
|
- Per-kind MkDocs configs (`docs/mkdocs.{lib,api,wiki}.yml`) are generated only
|
|
when absent; an existing config is used verbatim (the file wins). Pass
|
|
`--refresh` to regenerate it from the templates.
|
|
- The wiki template now uses the mongo-ops look: horizontal `navigation.tabs`
|
|
header, blue grey/teal palette, Roboto font, and additional material feature
|
|
flags. The lib and api templates are unchanged.
|
|
- Docstrings and wiki brought to the GSDFC (Google-style) standard.
|
|
|
|
### Fixed
|
|
- Loader-generated signatures render cleanly and unresolvable aliases are
|
|
dropped from generated models.
|
|
- Stub fixes for typed API surfaces.
|
|
|
|
[Unreleased]: https://git.aetoskia.com/aetos/doc-forge/compare/0.0.7...HEAD
|
|
[0.0.7]: https://git.aetoskia.com/aetos/doc-forge/compare/0.0.6...0.0.7
|