Skip to content

Commit 3cd003b

Browse files
author
codejunkie99
committed
docs: v0.10.0 release notes (CHANGELOG + README) + version bump
- harness_manager/__init__.py: __version__ bumped to 0.10.0 (was 0.9.0, never bumped during the v0.9.1 patch release — fixing now). - CHANGELOG.md: full 0.10.0 entry covering both the design-md skill (PR #21 by @danielfoch) under "Added" and the Python 3.9 PEP 604 fix (#27 by @WhoLsJohnGalt) under "Fixed". - README.md: replaces the v0.9.1 "New in" block with v0.10.0 highlights; demotes v0.9.1 to a one-line summary.
1 parent f0cd73b commit 3cd003b

3 files changed

Lines changed: 72 additions & 19 deletions

File tree

CHANGELOG.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,55 @@ All notable changes to this project.
55
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66
and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [0.10.0] — 2026-04-26
9+
10+
Minor release. Adds the `design-md` seed skill (sixth seed skill in the
11+
brain), and fixes a hard crash on macOS-default Python 3.9 that hit every
12+
brew user on first run.
13+
14+
### Added
15+
- **`design-md` seed skill — DESIGN.md / Google Stitch support.** A new
16+
portable skill that points coding agents at a root `DESIGN.md` (Google
17+
Stitch format) as the visual-system source of truth. Loads only when
18+
`DESIGN.md` exists at the project root; default behavior is read-only on
19+
the contract file, and validation prefers
20+
`npx @google/design.md lint DESIGN.md` over hand-checks. Brings the seed
21+
skill count from five to six. Thanks to @danielfoch for the contribution
22+
(PR #21). Decision recorded in `.agent/memory/semantic/DECISIONS.md`.
23+
24+
### Fixed
25+
- **Python 3.9 crash on first run (#27).** Every brew user on macOS-default
26+
Python 3.9 hit `TypeError: unsupported operand type(s) for |: 'type' and
27+
'type'` immediately after `brew install agentic-stack` because
28+
`harness_manager/` used PEP 604 union syntax (`Path | str`) that requires
29+
Python 3.10+ at runtime. Added `from __future__ import annotations`
30+
(PEP 563) to the eight affected files so all annotations are stored as
31+
strings and never evaluated at import time. Works on Python 3.7+, which
32+
covers every macOS-shipped Python in the wild. Zero-cost vs. the
33+
reporter's suggested `python@3.10` brew dep (~150 MB pull). Thanks to
34+
@WhoLsJohnGalt for the precise repro and the suggested workaround.
35+
36+
### Migration
37+
`brew upgrade agentic-stack` is enough — no on-disk schema changes. Users
38+
on Python 3.9 who hit #27 on v0.9.x can upgrade and the crash goes away.
39+
Users with existing `.pi/extensions/memory-hook.ts` from v0.9.0 already
40+
got the fixes via `./install.sh pi` after the v0.9.1 upgrade; this release
41+
adds the `design-md` skill on top.
42+
43+
### Release
44+
- Tag `v0.10.0` cut from master.
45+
- GitHub release: <https://github.com/codejunkie99/agentic-stack/releases/tag/v0.10.0>
46+
- `Formula/agentic-stack.rb` bumped to v0.10.0 in a follow-up commit
47+
(same flow as v0.8.0 → v0.9.0 → v0.9.1): tag first, compute sha256,
48+
then bump `url` + `sha256` + `version` together so brew always points
49+
at a real installable artifact.
50+
51+
### Credits
52+
- PR #21 by @danielfoch (design-md skill), with cross-model review fixes
53+
applied as a follow-up commit.
54+
- Issue #27 by @WhoLsJohnGalt — clean repro of the macOS Python 3.9 crash
55+
including a working sed-based workaround.
56+
857
## [0.9.1] — 2026-04-26
958

1059
Patch release that closes the gap between v0.9.0 and a working pi adapter.

README.md

Lines changed: 22 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -12,27 +12,31 @@ A portable `.agent/` folder (memory + skills + protocols) that plugs into Claude
1212
<img src="docs/diagram.svg" alt="agentic-stack architecture" width="880"/>
1313
</p>
1414

15-
### New in v0.9.1 — pi adapter fixes + tz correctness
16-
17-
Patch release. Closes the gap between v0.9.0 and a working pi adapter,
18-
plus a timezone sweep across every Python writer/reader so the dream
19-
cycle stops drifting against the UTC decay window.
20-
21-
- Brew users on v0.9.0 hit `ModuleNotFoundError: harness_manager` on
22-
first run. Formula now installs `harness_manager/` correctly.
23-
- Pi's dream cycle never fired (`session_shutdown` filter rejected every
24-
event because `SessionShutdownEvent` has no `reason` field). Now runs.
25-
- Pi's edit reflections were missing the diff (hook expected MultiEdit
26-
shape; Pi's edit input is flat). Now captures `oldText` / `newText`.
27-
- Naive-local Python timestamps reinterpreted at decay time as UTC
28-
caused silent drift. Every writer now emits aware UTC; every reader
29-
normalises naive entries before comparing.
30-
- `auto_dream` held no lock across its read-modify-write window —
31-
concurrent appenders could be silently truncated. Now holds a single
32-
`flock(LOCK_EX)` on the episodic log for the full cycle.
15+
### New in v0.10.0 — design-md skill + Python 3.9 fix
16+
17+
Minor release. Adds a sixth seed skill and unbreaks `brew install` for
18+
every macOS user on the system Python.
19+
20+
- **`design-md` seed skill.** Drop a Google Stitch-style `DESIGN.md` in
21+
your project root and the skill points coding agents at it as the
22+
visual-system source of truth — colors, typography, spacing, components,
23+
rationale. Loads only when `DESIGN.md` exists; default behavior is
24+
read-only on the contract file.
25+
- **Python 3.9 crash on first run is fixed (#27).** Every brew user on
26+
macOS-default Python 3.9 hit `TypeError: unsupported operand type(s) for
27+
|: 'type' and 'type'` immediately after install. Root cause: PEP 604
28+
union annotations (`Path | str`) that require Python 3.10+. Fixed by
29+
adding `from __future__ import annotations` to the eight affected
30+
`harness_manager/` files; works on Python 3.7+.
3331

3432
See [CHANGELOG.md](CHANGELOG.md) for the full list.
3533

34+
### v0.9.1 — pi adapter fixes + tz correctness
35+
36+
Closed the gap between v0.9.0 and a working pi adapter, plus a timezone
37+
sweep across every Python writer/reader so the dream cycle stops drifting
38+
against the UTC decay window.
39+
3640
### v0.9.0 — harness manager
3741

3842
<p align="center">

harness_manager/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,4 @@
55
The "harness_manager" name is internal only and never appears in CLI help, docs,
66
or error messages users see.
77
"""
8-
__version__ = "0.9.0"
8+
__version__ = "0.10.0"

0 commit comments

Comments
 (0)