ace-handbook 0.35.0 → 0.35.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 363ae1e6cd89c714512860b8ca79d36d845dfe197b039b2bcedcf60c77548000
-  data.tar.gz: 077205f8a16622b6972759fa7038cf4fca5a8dcd866ba048f5aebc5bcd2d2ba1
+  metadata.gz: 265fcff8879eef3a62977ecf5ac29dda8e252f06b5cb18f654da4064e6bb7de9
+  data.tar.gz: 7edd597cda3730560bfbf34ea456c02a230f10850da5c312a26d946926825dc6
 SHA512:
-  metadata.gz: 8b32ee617623055b732bb731531d5039f6f1da1ea5a413cf3828e02ab38c08b93f6ce5bb18a97cfbbe29c9dc041adae39f3a370a205749ae791e404ed8266b19
-  data.tar.gz: 1de4da539f049133b9672cedb3575679b26089b6d3cbb2fb126aa9ddb4639391313e4bc4964a70699f7ae89df5e4cd5633c19d835c7c94e6b88bf38a2e66e1d0
+  metadata.gz: 39ff2ee4d8a19b8329fd3588c7a78cc222cc139cb5017cb8cc53579867bf270fcb3bf754777b9cadfabca1046268989e8bfa379a54f392ae3ef1bfaaf687f5e1
+  data.tar.gz: 82491f08d0331566b9e42539e40d402668ed510cc89dcdecc4f3850575de3f8d8717b94babae38f2505c876091d9dd671341867d535000b36424b3719b76853b

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.35.1] - 2026-10-10
+
+### Technical
+
+- Clarify guide candidate discovery and the scope of this monorepo's checked-in priority-5 workflow source in `wfi://handbook/manage-overrides`.
+
 ## [0.35.0] - 2026-10-08
 
 ### Changed

data/handbook/workflow-instructions/handbook/manage-overrides.wf.md

@@ -34,7 +34,7 @@ per URI.
 
 | Surface | Protocol | Project-local location | Overridable? | Winner of duplicates (shipped defaults) |
 |---------|----------|------------------------|--------------|------------------------------------------|
-| Workflows | `wfi://` | `.ace-handbook/workflow-instructions/<ns>/<name>.wf.md` | Yes | Project-local, when its source priority is lower than the gem source's (e.g. the shipped `local` source at priority 5 vs gem at 10) |
+| Workflows | `wfi://` | `.ace-handbook/workflow-instructions/<ns>/<name>.wf.md` | Yes | Project-local, when its source priority is lower than the gem source's (e.g. this monorepo's checked-in `local` source at priority 5 vs gem at 10) |
 | Cookbooks | `cookbook://` | `.ace-handbook/cookbooks/<name>.cookbook.md` | Yes | The candidate from the source with the lower priority number. The shipped project-local default registers priority 20 and the gem source 10, so **the gem wins by default**; register a project cookbook source with priority < 10 to make project-local win |
 | Guides | `guide://` | `handbook/guides/<name>.g.md` | Yes, with registration | Requires a project source registration (`.ace/nav/protocols/guide-sources/local.yml` → `handbook/guides`); with priority < 10 the project-local guide wins. Without registration the gem wins |
 | Skills | `skill://` | none | **No** | Always the gem. Skills are thin layers; override the workflow the skill calls instead |
@@ -44,9 +44,9 @@ per URI.
 
 Sources for a protocol are scanned in ascending priority order (lower number = higher precedence); the first source
 containing the resource wins and remaining duplicates are ignored. Registration defaults: project sources 10, user
-sources 50, gem defaults 100 — an individual source registration may pin another value (this is why the shipped
-`local` workflow source at priority 5 beats the gem at 10, while the shipped project-local cookbook source at 20 loses
-to the gem at 10).
+sources 50, gem defaults 100 — an individual source registration may pin another value. In this monorepo, the checked-in
+`.ace/nav/protocols/wfi-sources/local.yml` sets priority 5 and beats the gem at 10; downstream projects must register
+their own local workflow source. The shipped project-local cookbook source at 20 loses to the gem at 10.
 
 To answer "why did this candidate win?" for a concrete URI without planting probe files:
 
@@ -73,7 +73,8 @@ are ignored and resolution always returns the gem file. The design rule is: **ov
 2. **Create the project-local file** at the surface's project-local location (see table), keeping the canonical
    frontmatter and structure so tools keep resolving it.
 3. **Ensure the source registration makes your file win:**
-   - workflows: keep `.ace/nav/protocols/wfi-sources/local.yml` priority below the gem source (shipped default: 5).
+   - workflows: register `.ace/nav/protocols/wfi-sources/local.yml` with priority below the gem source; this monorepo's
+     checked-in registration uses 5, but downstream projects do not receive that project-local source by default.
    - cookbooks: register `.ace/nav/protocols/cookbook-sources/local.yml` with priority < 10 (the shipped
      project-local default of 20 loses to the gem's 10).
    - guides: register `.ace/nav/protocols/guide-sources/local.yml` pointing at `handbook/guides` with priority < 10;
@@ -135,8 +136,10 @@ ace-handbook sync                                      # regenerates .agents/ski
 
 - **Override silently loses:** inspect `ace-nav resolve <uri> --why`; the losing candidate's source priority is too
   high — lower it in the source registration.
-- **Guide override not discovered at all:** no project guide source is registered; add
-  `.ace/nav/protocols/guide-sources/local.yml` (see Process Step 3).
+- **Guide override does not win:** a planted guide may be discovered as a losing candidate through the
+  `@ace-support-nav` gem-default example source (`./handbook/guides`, priority 100), or it may be absent from the
+  candidates, depending on source registration. Register `.ace/nav/protocols/guide-sources/local.yml` with priority
+  below the gem source (see Process Step 3), then confirm the project candidate wins with `ace-nav resolve --why`.
 - **Skill edit appears to do nothing:** skills are not overridable; override the workflow the skill calls.
 - **`.agents/skills/` edits keep disappearing:** expected — `ace-handbook sync` regenerates the projection and prunes
   stale entries; edit canonical skills in the owning gem.

data/lib/ace/handbook/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Handbook
-    VERSION = "0.35.0"
+    VERSION = "0.35.1"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-handbook
 version: !ruby/object:Gem::Version
-  version: 0.35.0
+  version: 0.35.1
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-10-08 00:00:00.000000000 Z
+date: 2026-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-config