businesslens 0.21.0 → 0.23.0

package/CHANGELOG.md

@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.23.0] - 2026-10-04
+
+- Model experiments, configuration choices and supported versions as Variations of an Interface, Experience, Screen, Entity, Capability, Journey, Scenario or Business Rule, and browse them in a new Variations collection.
+- Read every alternative under its Variation's name (in readings, lists, trees, graphs, matrices, Lifecycles and search) and switch between them in place; what holds only under some alternatives is dashed and says which.
+- Model nested Screens, Screens reachable from anywhere in an Interface or Experience, and the languages a Product serves.
+- Record the facts a Screen shows and collects, and the facts each Scenario Step reads, changes or creates; a Screen's Capabilities now come from the Steps placed on it.
+- Read what a Business Rule applies to, and find every Rule that names a resource from that resource.
+- See each place's Capabilities, Scenarios and Journeys, including what happens directly on it, and follow Capability state changes into Entity Lifecycles.
+- Read permissions as operations and grants, with badges on the facts they restrict.
+- Mapping no longer fails on very large repositories, and draws Capabilities, Domains, Journeys, settings and roles more consistently.
+- Verification checks each Variation's alternatives, and what selects them, against the code.
+- Fewer false lint warnings about resource names.
+- The local report keeps running when Git cannot open the repository, saying so once.
+- Blueprints with ambiguous place names are rejected before import.
+- Shorter, simpler documentation: the introduction shows the development loop and the local report, each Product Model page leads with everyday examples, and a new Variations page covers feature flags, plan tiers, A/B tests and API versions.
+- **Breaking.** Models and Blueprints must be updated to the new format; older model and report formats are rejected. Screens describe what they show and offer through relations instead of prose sections and Capability lists; Interfaces and Experiences drop their Capability boundary sections and Screen lists; References drop state labels.
+
+## [0.22.0] - 2026-09-23
+
+- Coverage now records scope, modeled behavior, approved exclusions, gaps and uncertainty instead of a completeness status. Existing models need the new Coverage format.
+- Read Coverage on one page: scope and method with a card per category, then every recorded path with its statements available in place.
+- Tell Coverage categories apart at a glance by icon and colour, filter by category, and find recorded paths by name.
+- Browse References by where they point: each file or external page appears once with the resources that cite it, repository files beside external links, with a card per kind to filter by and search by path or link.
+- See each resource's References split into repository files and external links.
+- Blueprints keep Coverage descriptions but leave repository paths behind; older Blueprint formats are no longer accepted.
+- Apply the same structural checks to every model, including those with known gaps.
+- Open the local report before a model exists and follow valid edits as they arrive, with visible connection status.
+- Recover the local report when a repository is initialized or referenced files are staged.
+- Reject Blueprint steps with undeclared Entities before importing the model.
+- Read clearer Product details and larger headings in About, under a simpler report header.
+
 ## [0.21.0] - 2026-09-21
 
 - Choose lists, graphs and comparisons from preview cards, keeping the same filters and counts.
@@ -810,7 +841,12 @@ Initial public launch of the repository.
   `docs/format.md`.
 - Claude plugin manifest and marketplace entry.
 
-[Unreleased]: https://github.com/businesslens/pdd/compare/v0.18.0...HEAD
+[Unreleased]: https://github.com/businesslens/pdd/compare/v0.23.0...HEAD
+[0.23.0]: https://github.com/businesslens/pdd/compare/v0.22.0...v0.23.0
+[0.22.0]: https://github.com/businesslens/pdd/compare/v0.21.0...v0.22.0
+[0.21.0]: https://github.com/businesslens/pdd/compare/v0.20.0...v0.21.0
+[0.20.0]: https://github.com/businesslens/pdd/compare/v0.19.0...v0.20.0
+[0.19.0]: https://github.com/businesslens/pdd/compare/v0.18.0...v0.19.0
 [0.18.0]: https://github.com/businesslens/pdd/compare/v0.17.0...v0.18.0
 [0.17.0]: https://github.com/businesslens/pdd/compare/v0.16.0...v0.17.0
 [0.16.0]: https://github.com/businesslens/pdd/compare/v0.15.0...v0.16.0

package/README.md

@@ -24,6 +24,7 @@ resolution loop.
 ├── capabilities/<id>.md      # or <id>/capability.md with scenarios/ or assets
 ├── journeys/<id>.md          # or <id>/journey.md with scenarios/ or assets; optional
 ├── business-rules/<id>.md    # or <id>/business-rule.md with assets
+├── variations/<id>.md        # optional; one set of alternatives each
 └── coverage.md
 ```
 
@@ -96,19 +97,17 @@ Catalog contribution stays in the CLI; there is no contribution skill.
 - `references` optionally attach intent, implementation, or context artifacts
   to any semantic resource. They are navigation and supporting material, not
   proof or verification receipts.
-- `coverage.status` describes model breadth: `draft` while the model itself is
-  under review, `partial` with known unmapped areas, and `complete` when the
-  intended product breadth is modeled.
-- A complete model may contain zero References.
+- `coverage.md` describes model scope and known gaps; it has no status.
+- A model may contain zero References.
 - A Product may expose several Interfaces—such as web, mobile, CLI, and a
   supported API—without being classified as one of those delivery forms.
 - Experiences are optional coherent usage contexts, each belonging to exactly
   one Interface. Availability is a list of strict Context objects whose
   `place` is an undivided Interface or an Experience.
-- Domains are optional regions of subject matter. Only a Capability authors
-  `domain:`; every other Domain relation is derived.
-- Screens are optional platform-neutral product views, nested in the Interface
-  or Experience that contains them. Their path supplies their place. Product
+- Domains are optional regions of subject matter. Only Capabilities and
+  Entities author `domain:`; every other Domain relation is derived.
+- Screens are optional platform-neutral product views, nested in the Interface,
+  Experience or parent Screen that contains them. Their path supplies their place. Product
   assets sit beside the resource they describe; anything
   under `implementation/` describes this realization and stays home.
 - `lint` checks format, required content, relationships, Reference grammar, and
@@ -152,13 +151,12 @@ derived report projections, not additional authored relationships.
 ## Documentation
 
 - [Introduction](./docs/index.md) · [Installation](./docs/installation.md) ·
-  [Development loop](./docs/the-loop.md)
+  [Development loop](./docs/index.md#the-development-loop)
 - Start [from your repo](./docs/from-your-repo.md),
   [from a Blueprint](./docs/from-a-blueprint.md), or
   [from an idea](./docs/from-an-idea.md)
 - [Product Model](./docs/product-model.md) · [References](./docs/references.md)
-- [Skills](./docs/skills.md) · [CLI](./docs/cli.md) ·
-  [CI/CD](./docs/ci.md)
+- [Skills](./docs/skills.md) · [CLI](./docs/cli.md)
 - [Format contract](./spec/format.md) ·
   [Report contract](./spec/report.md)