Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "wayfinder",
"version": "0.1.1",
"version": "0.1.2",
"description": "Author, adopt, assess and search Concepta OKF knowledge bundles, with local Wayfinder validation and retrieval over MCP.",
"author": { "name": "Concepta" },
"homepage": "https://github.com/conceptadev/wayfinder",
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,8 +88,8 @@ the `wayfinder validate` gate, and let each project repository carry only its ow
The `wayfinder` package is now the core validation library (formerly
`okf_profile`). Install `wayfinder_cli` for the `wayfinder` command and MCP server.
The embeddings library remains `wayfinder_embeddings`. All three packages are
published at 0.1.0. The CLI and embeddings library have a prepared 0.1.1 patch
release; see [release status and upgrade notes](docs/releasing.md#prepared-release-011).
published: core 0.1.0, CLI and embeddings 0.1.1. The next prepared application
patch is 0.1.2; see [release status and upgrade notes](docs/releasing.md#prepared-release-012).
See [migration instructions](docs/install.md#migrate-the-dart-application-package).

## What is in here
Expand Down
83 changes: 54 additions & 29 deletions docs/releasing.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,44 +18,69 @@ release workflow is retired; historical versions and tags remain available.

## Prepare a release

All three packages and the native archives are published at 0.1.0. The next
prepared release is described below; preparation does not publish it. Publish
changed core or `wayfinder_embeddings` dependencies before the CLI, then resolve
the CLI from hosted dependencies outside the workspace and run its publish dry
run. An unchanged dependency does not need another release.
Core `wayfinder` 0.1.0, `wayfinder_cli` 0.1.1, `wayfinder_embeddings` 0.1.1, and
the native `wayfinder-v0.1.1` archives are published. The next prepared release
is described below; preparation does not publish it. Publish changed core or
`wayfinder_embeddings` dependencies before the CLI, then resolve the CLI from
hosted dependencies outside the workspace and run its publish dry run. An
unchanged dependency does not need another release.

### Prepared release: 0.1.1
### Published: 0.1.1

Shipped 16 September 2026 as GitHub Latest
[`wayfinder-v0.1.1`](https://github.com/conceptadev/wayfinder/releases/tag/wayfinder-v0.1.1),
with `wayfinder_embeddings-v0.1.1`. Core stayed at published 0.1.0. That patch
fixed oversized-input indexing ([#100](https://github.com/conceptadev/wayfinder/issues/100),
[#101](https://github.com/conceptadev/wayfinder/pull/101)) and installer input
validation ([#99](https://github.com/conceptadev/wayfinder/pull/99)).

### Prepared release: 0.1.2

Unreleased on `main` since that tag is only
[#106](https://github.com/conceptadev/wayfinder/pull/106): an in-place Profile
2026.2 amendment and the matching skill/example teaching. No Dart validation or
retrieval code changed.

| Component | Prepared version | Publication tag |
| --- | --- | --- |
| `wayfinder_embeddings` | 0.1.1 | `wayfinder_embeddings-v0.1.1` |
| `wayfinder_cli`, native runtime and plugin | 0.1.1 | `wayfinder-v0.1.1` |
| `wayfinder_cli`, native runtime and plugin | 0.1.2 | `wayfinder-v0.1.2` |
| `wayfinder_embeddings` | Remains at published 0.1.1 | No new tag |
| `wayfinder` core | Remains at published 0.1.0 | No new tag |

This patch fixes bundle-wide indexing failures caused by oversized separators
and identifiers ([#100](https://github.com/conceptadev/wayfinder/issues/100),
[#101](https://github.com/conceptadev/wayfinder/pull/101)). Recovery preserves
source bytes and reports persisted warnings through CLI text/JSON and MCP.
It also includes the public installer input and Windows architecture validation
fixes in [#99](https://github.com/conceptadev/wayfinder/pull/99).

**Upgrade:** run `wayfinder index <bundle>` once after updating, before searching.
Index configuration advances from 2 to 3; unchanged subsequent calls reuse the
index. Closed JSON consumers must allow the additive `warnings` field. No bundle
migration, Profile release, model change or ObjectBox schema change is needed.
A CLI and plugin patch is required even though the packages' Dart APIs are
unchanged. Claude Code refreshes the plugin only when its version changes, and
`wayfinder update` offers only stable `wayfinder-v` releases, so a 0.1.1 install
still teaches the withdrawn YAML SHOULDs until this cut. CI requires the CLI
pubspec, `wayfinderVersion`, and `.claude-plugin/plugin.json` to stay aligned.

The version lock is applied on the CLI pubspec, `wayfinderVersion`,
`.claude-plugin/plugin.json`, and the CLI changelog. Embeddings and core
are unchanged.

This patch withdraws the invented §6.5 producer SHOULDs (quoted timestamps,
block-style mappings, `verified` as a list) so the Profile, examples, and
authoring skill copy OKF §5 spelling. Skills treat an unsupported Profile
release as `NEEDS HUMAN` and refuse to change `concepta_profile`; the method
is implementation guide §5 when that file is present. Graph CLI filters are
documented to match MCP.

**Upgrade:** run `wayfinder update` (or reinstall) so the plugin and skills
refresh. Existing 2026.2 bundles stay conformant; no index rebuild, Profile
serial, model change, or ObjectBox schema change is needed. New writes should
copy YAML shape from OKF §5. Do not bump a bundle's `concepta_profile` as a
repair.

Publication order for this release:

1. Merge the preparation change and obtain successful source CI for that exact
commit, including all three native platforms.
2. Publish `wayfinder_embeddings-v0.1.1` at that checked commit and wait for the
package to become available on pub.dev. The CLI requires `^0.1.1`; a workspace
resolution alone cannot verify hosted availability.
3. Outside the workspace, resolve the CLI with hosted dependencies (no path
overrides), analyze it and run `dart pub publish --dry-run`.
4. Publish `wayfinder-v0.1.1` at the same checked commit and wait for CLI package
publication. Do not create a new core tag.
5. Dispatch **Distribute Wayfinder native release** against `wayfinder-v0.1.1`
1. Merge this preparation change and obtain successful source CI for that
exact commit, including all three native platforms.
2. Do not create embeddings or core tags.
3. Outside the workspace, resolve the CLI with hosted dependencies (core 0.1.0,
embeddings 0.1.1, no path overrides), analyze it and run
`dart pub publish --dry-run`.
4. Publish `wayfinder-v0.1.2` at the same checked commit and wait for CLI
package publication.
5. Dispatch **Distribute Wayfinder native release** against `wayfinder-v0.1.2`
with that successful source CI run ID, then verify the public installer jobs.

### Release gates
Expand Down
11 changes: 11 additions & 0 deletions packages/wayfinder_cli/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,14 @@
# 0.1.2

- Refresh the plugin and authoring skills so they copy OKF §5 inline
frontmatter and refuse a silent Profile release change.
- An unsupported Profile release is reported as `NEEDS HUMAN`, not a 2026.2
judgment failure. Graph CLI filters match the MCP graph tools.

After upgrading, run `wayfinder update` so the plugin and skills refresh.
Existing 2026.2 bundles stay conformant. Profile validation, the embedding
model, the ObjectBox schema, and index configuration are unchanged.

# 0.1.1

- Recover oversized separators and identifiers without aborting bundle indexing
Expand Down
2 changes: 1 addition & 1 deletion packages/wayfinder_cli/lib/src/version.dart
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
/// Wayfinder application version advertised by command-line and protocol clients.
const wayfinderVersion = '0.1.1';
const wayfinderVersion = '0.1.2';
2 changes: 1 addition & 1 deletion packages/wayfinder_cli/pubspec.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
name: wayfinder_cli
description: Local OKF validation, knowledge indexing and semantic search.
version: 0.1.1
version: 0.1.2
repository: https://github.com/conceptadev/wayfinder/tree/main/packages/wayfinder_cli
issue_tracker: https://github.com/conceptadev/wayfinder/issues
topics:
Expand Down
Loading