v0.20.0

Added

• The learning plane (#747): the library’s third plane lands end to end.
  • Experiment, Measure, and Arc are first-class card types; learning-card vitals parse from frontmatter (Experiment kind/grade/state/expected/arc/ role/verdict with stop and guardrail tag-notes; Research kind/origin/ grade; Measure target/trend) and render in the card drawer.
  • WHY joins the required fill sections for every card; WHEN is required for plane: learning cards. WHY and WHEN are first-class story buckets end to end (bucket cap 2,400 → 6,000 characters).
  • The Engine view gains a plane switcher; type filters derive from the selected plane. Altitude ranking is complete and unknown altitude words warn.
  • Story links render the author’s pipe alias; bare links keep the card title.
  • The hand-rolled frontmatter parser handles YAML block scalars (>-, |, and chomping variants).
• Workflow flow: steps carry per-step context, gate, and evidence (#757). The Play Run workflow renders its six surface lanes again (viewer, triggers, playbook, library, ledger, canvas) instead of collapsing into the owning card’s single lane.
• The Workflow view’s plane sidebar now filters workflows by the owning card’s plane (#757); plane-less legacy workflows stay visible on every plane.

Changed

• Cards using the new flow: step keys require ax ≥ 0.20.0 to project their workflow; older binaries drop the steps as unknown keys.

v0.19.0

Changed

• The library model completed its migration (library-migration plan):
  • The product library lives at docs/alexandria/library and its location is config-owned (library.root in alexandria-config.json, default <workspace>/library; ax start --library-root and ?libraryRoot= remain as explicit overrides). The viewer resolves the root from the runtime server; library-bundles.json is Builder-only.
  • Cards use frontmatter v2: identity is the path (<context>/<Type>/<Type> - <Name>.md), grounding lives in evidence:, and decision/creation provenance lives in Ledger events — type:, prefLabel:, context:, proposed_by:, rulings:, and source_evidence: are retired (v1 cards still read via fallbacks, with identity-mismatch lints).
  • Path lints: reserved context names (runtime) and globally-unique Type - Name stems are enforced at load.
  • All sidecar JSONs dissolved: workflows.json → flow: on the aggregate card; threads.json → library.thread_opened/library.thread_resolved Ledger events (Notepad projects from events); gaps.json applied to the files and deleted; library.json retired (product-card mode via config identity; draft bundles carry library-draft.json manifests).
  • Ledger event types flattened: library.front_of_house.* → library.* (read-side aliases keep old spellings parseable), plus new library.thread_opened, library.thread_resolved, library.taxonomy_ruled, and ax internal library backfill.
  • The Ledger is git-backed shared history (union merge; never local-only).
• Raven’s prompt and skills resolve the library via config and describe the v2 identity model.

Removed

• The retired legacy library corpus and the viewer’s “Legacy reference” Builder tab.

v0.18.0

Added

• Raven ships as a named agent in the plugin payload (alexandria:raven): the director’s product-thinking colleague and resident expert on the product’s context library, grounded in a new agents/raven-resources/ reference set (library model, product traversal, conversation archetypes, diagnostic patterns, thinking lenses, and a confidence protocol).
• Raven’s built-in agent entry now carries claudeAgentPromptPath and codexAgentPromptPath runtime metadata pointing at agents/raven.md, matching Damien, and release packaging guards that the Raven agent files ship in the public repo payload and plugin archive.

v0.17.1

Fixed

• The Claude event monitor now detects plugin/ax version skew before running: when the installed payload’s VERSION and ax version disagree, it names both versions and recommends ax upgrade instead of failing on a cryptic Unknown subcommand error. Source checkouts (claude --plugin-dir) carry no VERSION file and skip the check.
• That version-skew check now locates the plugin root with POSIX parameter expansion instead of the external dirname command, so the monitor keeps working in minimal-PATH environments.

v0.17.0

Added

• Added the PlayMaker Studio CLI (pms): pms run make-a-play:design|build|prove production modules, pms capture|deprecate|quarantine Studio Operations, and pms start — a dedicated PMS server on port 4322 serving the new PMS viewer (Studio, PMS-Back, and PMS-Drafts) that reaches Alexandria data only through an identity-checked read-only proxy of the public runtime API.
• Added the Alexandria Drafts library tab: a live draft window over Alexandria’s own product bundle and draft patch log.
• Made PMS-Drafts a live Front-of-House draft window: it starts blank, auto-refreshes during a walk, renders only overlay-touched draft cards grouped by section, and shows director-confirmed section labels and summaries.
• Guaranteed a banked Front-of-House frame gate: when a bundle has no scan-authored frame thread, agenda preparation synthesizes a headline frame item so every walk opens with a real, banked frame exchange.

Changed

• Completed the PMS/Alexandria boundary migration: PMS production machinery moved out of the ax CLI and Alexandria viewer into the new pms package, PMS operations record to per-operation files under studio/records/ instead of Alexandria’s Ledger, the Alexandria product sweep moved to docs/alexandria/sweeps/, and the Alexandria viewer and runtime no longer carry studio surfaces.

Fixed

• ax start all now survives Codex substrate failures: a missing Codex CLI or marketplace metadata degrades to a codex: unavailable status instead of failing Alexandria startup.
• Tightened draft section-confirmation matching so stale repeated patch ids can no longer attach an old section header to a new draft.

v0.16.0

Added

• Added the Front-of-House library walk: a guided walk with a headline opener, thread-backed agendas, a section comprehension pass, and section confirmations recorded in the Ledger.
• Modeled Front-of-House placement state explicitly, derived walk thread lifecycle from the Ledger, and hardened card-edit provenance so walks survive rejected bundle patches and record durable draft logs.
• Added the Back-of-House search-prior contract, thread lifecycle provenance, and a scope fence that flags suspect threads, plus the first Alexandria product library bundle from the Back-of-House sweep.
• Added the Alexandria Back viewer tab for product sweep QA, alongside library viewer upgrades: a product-thesis Library Index, in-place peek, a PMS-Drafts overlay tab, and the Workflow lens.
• Banked Front-of-House scripted reaction answers so review gates replay deterministically in scripted runs.
• Added the Studio keystone conformance gate to CI.
• ax doctor now verifies live ACP provider authentication.

Changed

• Reshaped Raven Vision onboarding into the Basic Product Description with Shape, Work, and Refusal Fence slots.
• Tightened the Raven Front-of-House opener contract and consolidated Front-of-House catalog, read-path, command dispatch, and projection internals.

Fixed

• Hardened confirm-section provenance and idempotency; malformed Front-of-House card edit patches and broken agenda inputs now fail loudly instead of corrupting walk state.
• Fixed Front-of-House record-turn re-presentation linkage.
• Pending human-input wakes are now delivered when the Claude monitor connects instead of being dropped.

v0.15.2

Fixed

• Resolved Railway Claude ACP credentials through Fabro’s server vault so managed Frame the Problem runs receive the API key at ACP launch time instead of the unresolved {{ env.ANTHROPIC_API_KEY }} template.
• Upgraded existing managed Fabro settings from the 0.15.1 env placeholder to the vault-backed secret placeholder while preserving local Claude subscription authentication outside Railway.

Changed

• Release assets now build the bundled Fabro sidecar from this vendored source tree so Alexandria releases include the ACP credential fix.

v0.15.1

Fixed

• Forward ANTHROPIC_API_KEY into Claude ACP subprocesses only in Railway product deployments, leaving local Claude subscription authentication unchanged.

v0.15.0

Fixed

• Guarded ACP-backed play moves so frame-the-problem, source-assessment, and one-pager workflows fail closed instead of advancing to review after an ACP agent failure.
• Added workflow edge validation and projection test coverage so future shipped ACP workflows keep explicit failure routes.

v0.14.1

Changed

• Release asset builds now package the pinned upstream Fabro 0.267.0-nightly.0 GitHub release binary instead of compiling Fabro from the vendored source tree during release.

v0.14.0

Added

• Added the AX server run bridge so detached Fabro play runs are observed and projected into the Alexandria ledger.
• Added the Frame-a-Problem coin flow: Raven can elicit source material, launch the frame-the-problem play, manage human feedback through Fabro gates, and surface progress in the viewer.
• Added ax raven answer for out-of-band human gate answers and ax run --reactions for scripted dry-run traversal of review and revise gates.

Changed

• Frame the Problem now frames the human struggle directly instead of centering generic undertaking risk.
• Detached ax run now returns the Fabro run handle and refuses fire-and-forget launches when no runtime bridge is available to emit play lifecycle events.
• The Play Tracker and Studio viewer surfaces now expose active play progress, human-feedback status, and the Frame-a-Problem entry point.

Fixed

• Fixed apostrophe handling in workflow input substitution and added --input-text temp-file routing for literal play material.
• Removed a too-strict answer-kind validator so Fabro remains the arbiter for mixed freeform and multiple-choice human gates.
• Tightened the scripted-answer and Fabro answer Effect boundaries so async IO failures surface as stable operational failures.

v0.13.0

Added

• Studio now includes a live Play Tracker for following play delivery status, estimates, board state, and play-specific progress from the viewer.
• Studio Play Testing now ships preflight validation, diagnostics, measurement, prompt-contract, risk-map, and eval-authoring support for play hardening.
• The Alexandria plugin now includes Damien/demo station skills for demo thesis, story spine, demo path, and demo video preparation.
• Added the Damien agent registry and viewer support for browsing agent context alongside the Alexandria library.
• Added the stable Big Edit playbook and runtime methodology notes for from-scratch Studio play authoring.

Changed

• Frame the Problem now uses the interactive Riff workflow in place of the earlier 9-move pipeline, with deliberate node fidelity and revised prompts.
• Play testing now treats build validity as a real Fabro validation gate and adds studio-to-plugin conformance checks for shipped play assets.
• AX and viewer runtime support now expose richer Studio APIs, agent metadata, play state, and project-state surfaces needed by the new Studio views.
• Public release guidance now requires creating the public GetAlexandria/alexandria GitHub Release in addition to the internal release.

Fixed

• Tightened the remaining ax2 to ax naming cleanup in Studio placeholders, parser paths, and conformance checks.
• Hardened local Fabro restart and notification behavior to avoid active-run interruptions and noisy notification loops.
• Corrected stale Studio imports and play-testing risk-map semantics so preflight and diagnostics reflect the current viewer/runtime package names.

v0.12.0

Added

• Alexandria Next is now Alexandria. The rewrite replaces the old public Alexandria line as the sole shipped CLI, plugin, viewer, installer, and release payload.
• The canonical ax CLI now carries the Alexandria Next runtime: project initialization, local state/event inspection, managed Fabro startup, play execution, Raven Vision onboarding, source intake, host monitor integration, doctor checks, upgrade support, and viewer launch commands.
• The canonical plugin now ships the event-log monitor, ax-start, Raven Vision drafting/elicitation skills, source-assessment workflow, and the plugin-side monitor wrapper needed by the local runtime.
• The canonical viewer now ships the Alexandria Next application shell, library browser, Studio views, Raven Vision surfaces, runtime client, and bundled visual assets.

Changed

• Renamed the former Next workspaces into the release workspaces: packages/ax-next became packages/ax, packages/alexandria-next-plugin became packages/alexandria-plugin, and packages/viewer-next became packages/viewer.
• The public CLI binary is ax; the former ax2/ax-next naming is removed from the shipped artifact names, package names, build metadata, and user documentation.
• The public plugin identity is alexandria; the marketplace now exposes one local plugin source at ./alexandria instead of parallel legacy and Next plugin entries.
• The installer is back to install.sh and installs a single plugin, ax binary, and Fabro sidecar from root release downloads.
• Release publishing now produces one set of public artifacts: alexandria-plugin-v*.tar.gz, ax-v*-<platform>.tar.gz, fabro-v*-<platform>.tar.gz, latest-version.txt, and install.sh.
• Site release publishing now updates only the canonical public install, download version, changelog, and version metadata surfaces.
• The public README and package docs now describe the Alexandria Next behavior as the current Alexandria product rather than as a parallel preview.

Removed

• Removed the legacy Alexandria CLI, plugin payload, viewer implementation, plugin commands, eval harness, release QA harness, and old package docs.
• Removed install-next.sh, the Alexandria Next deployment workflow, and the separate Next release runbook.
• Removed the two-channel release topology and all public-repo sync behavior that copied both legacy Alexandria and Alexandria Next payloads.
• Removed stale verification artifacts for the pre-release Next line.

v0.11.0

Added

• ax cards list now inventories Alexandria library cards with table and JSON output.
• ax cards list --summary now reports card counts by type and layer.
• ax cards list --type, --layer, and --area now filter card inventory output. Type and layer filters are case-insensitive.
• ax config show now prints the active Alexandria configuration, with JSON and summary output modes.

Changed

• Card inventory output now includes parsed frontmatter metadata needed for area filtering.
• Manifest dissolution planning docs now keep area as the transitional coverage field and defer Sam-authored area population to a later slice.

Removed

• The retired ax initialize CLI subcommand has been removed from the public command surface.

v0.10.0

Changed

• Breaking: All user-invocable slash commands now use the ax- prefix. /alexandria:library → /ax-library, /alexandria:plan → /ax-plan, /alexandria:brief → /ax-brief, /alexandria:sync-tickets → /ax-sync-tickets, /alexandria:upgrade → /ax-upgrade.
• Four previously top-level skills (revise-plan, complete-plan, implementation-planning, context-briefing) now ship as part of the bundled plugin payload, so external users get the full planning surface. /ax-revise-plan and /ax-complete-plan are now first-class user commands.
• implementation-planning renamed to ax-plan; context-briefing renamed to ax-brief.
• Agent resource packs (conan, raven, sam, solomon, initialize) keep their bare names — they are not user-invocable slash commands.

Migration

• Update muscle memory or scripts referencing /alexandria:* to the /ax-* equivalents.
• Run /ax-upgrade (or ax update) to pull the new plugin payload.

v0.9.4

Added

• New public ax update command for in-place Alexandria upgrades that refresh both the plugin payload and the installed ax binary

Fixed

• ax update-check no longer caches stale up_to_date results, so freshly shipped releases show up immediately
• Upgrade docs and the bundled upgrade skill now describe the real supported in-place update path instead of sending users through setup-only or manual flows
• Shared release-install logic now hardens plugin/binary replacement during setup and update flows

v0.9.3

Fixed

• ax setup now defaults to the R2-backed Alexandria downloads host, so standalone setup no longer downloads HTML and fails archive extraction
• Autonomous build pipeline initialize flows now keep the corrected AI mode labeling split between product decisions and implementation autonomy
• Scoreboard derivation now attributes cards to the correct knowledge area
• Conan now type-audits sections before grading and marks obvious type mismatches as UNGRADED — RETYPE REQUIRED

Changed

• The initialize engine now runs from the checked-in TypeScript implementation used by ax initialize, reducing drift between runtime logic and maintainer docs
• Release QA coverage now includes fresh-install and reinstall scenarios exercised through the real installer path

v0.9.2

Fixed

• Release downloads no longer go through Cloudflare Pages, avoiding the 25 MiB asset limit that blocked 0.9.1 site deployment
• The release workflow now installs Bun before publishing download artifacts to R2

Changed

• Alexandria release tarballs now publish to downloads.getalexandria.ai through Cloudflare R2
• The Alexandria site release step now publishes only install.sh, latest-version.txt, and changelog/version metadata to the site repo

v0.9.1

Fixed

• Public release sync source now preserves the correct getalexandria.ai install/discovery surface
• Installer compatibility aliases for CONTEXT_LIBRARY_VERSION and CONTEXT_LIBRARY_ALEXANDRIA_URL
• Release docs now describe the current Alexandria public download surfaces and local tarball validation path

Changed

• Added deterministic installer coverage for the legacy compatibility env vars before future public syncs
• Prepared the repo-split release machinery for a patch release validation pass

v0.9.0

Added

• Hard cut-over to the new Alexandria release topology: GetAlexandria/alexandria-internal, GetAlexandria/alexandria, and getalexandria.ai
• Public payload sync from the internal repo into the public repo
• Public issue templates and issue-only public repo surface
• Release build scripts for public plugin payloads, ax binaries, and site download publishing
• Release QA harness for staged plugin/binary artifact verification

Changed

• ax is now the canonical public CLI surface
• Public install no longer depends on shipped source or Bun after installation
• Product agents and skills now call ax instead of the old alxndr / standalone product command mix
• Installer and marketplace metadata now point at the GetAlexandria org/domain structure

Notes

• Release evals are not auto-run in the release workflow; they remain a human release gate based on prior feature coverage
• The legacy sociotechnica-org/alexandria repo now carries a cut-over notice to the new surfaces

v0.0.1

• Initial Alexandria site launch
• Landing page with product story, roadmap, team, and risks
• Book infrastructure for The 7 Turn Work Week (11 chapters, coming soon)
• Updates page

v0.8.4

Fixed

• Eval CLI and harness root resolution for source-mode runs in maintainer checkouts
• Raven handoff/tier signaling and card-write guidance that caused structural eval failures
• Sam and Conan eval prompt/config regressions that left create-cards and surgery failing

Changed

• Refreshed Raven, Sam, and Conan eval baselines after the post-0.8.3 reruns
• Tightened Raven structural checks for handoff detection, evidence-tier signaling, and card-write rejection