textus 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91be0acd415a4b41d96e896015dfd19e58fc7867d007332456499ec5ceb8a6aa
-  data.tar.gz: 576d361ebba900b33b2f612b1a0a51d0373cb4a5e1fbd503e43c2bb248ca9306
+  metadata.gz: e4b96d4cff83e901df4b2871b57f9c86d071b11126fd42e8fc5563abf45ce810
+  data.tar.gz: 6afa20a10f7ddee98b5b4adbf6eb87218725b5eb1c3f7b181b8bcb462d4fff74
 SHA512:
-  metadata.gz: c551c60809be1eefc0d964092adc62a8555cb6f0df3585e775fd2fda1549f1e7d811fb2bfeec992dd3ce872dccb16fd9300a66314d5e51e8f24a98b57f29da5b
-  data.tar.gz: c96ec13692d6366a916b125266afb70aabcca439594db4e8fd1b434f1db1a88e216938cbf64bc69e64bcfef241ca7314664398c656f1d7333a7480a7d02852f9
+  metadata.gz: 83825a241b91ac10c2024ebdf04ec0f1bb753b8deeded27894fbbbff84f3f654ad6cc4c0faa2bbfcf940b989bc0393d832ae90af837039814fe51e5f7e4c4515
+  data.tar.gz: 57079b174111a5e89637140d53ca83f5c9b0c5f777c270be9833174c3dd11c7f4d8b8039ef30c69c6f85e1dfb9d78c89dab3eb99cd517b32e1cf7af2ce7ded7a

data/CHANGELOG.md

@@ -8,6 +8,27 @@ The **gem version** (`0.x.y`) is distinct from the **protocol version**
 (currently `textus/2`, embedded in every envelope as `protocol`). The protocol
 is additive within a major; a new major would change the wire string.
 
+## 0.8.1 — Terminology cleanup (2026-05-21)
+
+### Breaking — intro output
+- `textus intro` JSON: the `"extensions"` key is renamed to `"hooks"`. Consumers
+  reading `env["extensions"]` must switch to `env["hooks"]`. Wire protocol
+  remains `textus/2`; envelope shape on read/write is unchanged.
+
+### Internal Ruby renames
+- `Textus::Store#load_extensions` → `Textus::Store#load_hooks`.
+- `Textus::Intro.extensions_for` → `Textus::Intro.hooks_for`.
+- Error string `"failed loading extension <file>"` → `"failed loading hook <file>"`.
+
+### Fixed
+- `textus doctor` `:check`-hook failure hint pointed to `.textus/extensions/`,
+  which has never existed in 0.6+. Now correctly points to `.textus/hooks/`.
+
+### Docs
+- SPEC.md §5.10: "single extension verb" → "single hook verb".
+- Scaffolded `.textus/hooks/README.md` no longer mixes "hook" and "extension"
+  terminology.
+
 ## 0.8.0 — Folder restructure & Zeitwerk autoload (2026-05-21)
 
 ### Breaking — internal Ruby renames

data/README.md

@@ -45,7 +45,7 @@ You get `.textus/` with all five zone directories, baseline schemas, an empty au
   audit.log           # append-only NDJSON, every write
   schemas/            # YAML field shapes per entry family
   templates/          # mustache templates for derived entries
-  extensions/         # one .rb per action / reducer / hook / doctor_check
+  hooks/              # one .rb per hook
   sentinels/          # publish bookkeeping
   zones/
     canon/            # human-only — identity, voice, decisions
@@ -77,8 +77,8 @@ For the full shape — Claude plugin with agents, skills, commands, pending walk
 - **Per-leaf publishing.** Nested entries declare `publish_each: "skills/{basename}/SKILL.md"`. Every leaf byte-copies to its consumer location on `textus build`. No more hand-mirrored `agents/` / `skills/` / `commands/` directories.
 - **Stable identity (`uid:`).** 16-char hex, auto-minted on first `put`, preserved across writes and moves. `textus key mv old.key new.key` renames in place — uid survives, audit row records `from_key`, `to_key`, `uid`. Reorganising a tree no longer breaks references.
 - **Strict key grammar.** `/^[a-z0-9][a-z0-9-]*$/`, max 8 segments × 64 chars. `textus key migrate --dry-run|--write` rewrites existing stores with illegal segments deterministically.
-- **`textus intro`.** One-shot store orientation: zones with writers + purposes, entry families with schemas and publish targets, loaded extensions, write flows per role, the full CLI verb table. The boot signal for any agent — one tool call and it knows your store.
-- **`textus doctor`.** Health check across 9 categories: missing schemas/templates, broken extensions, illegal nested keys, sentinel drift, audit log readability, unowned schema fields, schema violations, and missing manifest files. Returns `ok: true` only when nothing is wrong; warnings and info don't flip the bit.
+- **`textus intro`.** One-shot store orientation: zones with writers + purposes, entry families with schemas and publish targets, loaded hooks, write flows per role, the full CLI verb table. The boot signal for any agent — one tool call and it knows your store.
+- **`textus doctor`.** Health check across 9 categories: missing schemas/templates, broken hooks, illegal nested keys, sentinel drift, audit log readability, unowned schema fields, schema violations, and missing manifest files. Returns `ok: true` only when nothing is wrong; warnings and info don't flip the bit.
 - **Actionable hints on every error.** `UnknownKey` carries ranked "did you mean" suggestions. `WriteForbidden` names the role that *would* be allowed. `BadFrontmatter` tells you exactly what to rename. Printed to stderr alongside the JSON envelope on stdout.
 
 Symlink-mode publish was removed; publish is `FileUtils.cp` + sentinel. Sentinels for published files live under `.textus/sentinels/<target_rel>.textus-managed.json` so consumer directories stay clean. Legacy sibling sentinels auto-migrate on next publish.
@@ -91,7 +91,7 @@ All verbs accept `--format=json` and return the envelope defined in SPEC §8. Wr
 
 | Verb | Purpose |
 |---|---|
-| `intro` | Store orientation: zones, entries, extensions, write flows, CLI map |
+| `intro` | Store orientation: zones, entries, hooks, write flows, CLI map |
 | `list [--prefix=K] [--zone=Z]` | Enumerate keys |
 | `where K` | Resolve a key to its filesystem path |
 | `get K` | Full envelope (frontmatter, body, uid, etag, format) |

data/SPEC.md

@@ -365,7 +365,7 @@ Reducers are RPC hooks on the `:reduce` event. See §5.10.
 
 ### 5.10 Hooks
 
-textus has a single extension verb: `Textus.hook(event, name, **opts) { ... }`. The EVENTS table below defines every extension point. Files in `.textus/hooks/*.rb` are `load`ed at `Store#initialize` in lexical order.
+textus has a single hook verb: `Textus.hook(event, name, **opts) { ... }`. The EVENTS table below defines every extension point. Files in `.textus/hooks/*.rb` are `load`ed at `Store#initialize` in lexical order.
 
 | Event    | Mode    | Args                              | Return        | Failure |
 |----------|---------|-----------------------------------|---------------|---------|

data/lib/textus/doctor.rb

@@ -67,7 +67,7 @@ module Textus
         rescue StandardError => e
           out << fail_issue(name, code: "doctor_check.failed",
                                   message: "#{e.class}: #{e.message}",
-                                  fix: "fix the doctor_check block in .textus/extensions/")
+                                  fix: "fix the :check hook in .textus/hooks/")
         end
       end
       out

data/lib/textus/init.rb

@@ -31,7 +31,7 @@ module Textus
       File.write(File.join(target_root, "hooks", "README.md"), <<~MD)
         # Hooks
 
-        Drop one Ruby file per hook. All extensions register through one DSL.
+        Drop one Ruby file per hook. All hooks register through one DSL.
         Every handler receives `store:` as its first kwarg, then event-specific args.
 
         ```ruby

data/lib/textus/intro.rb

@@ -2,7 +2,7 @@ module Textus
   # Read-only "what's in this store and how do I use it" envelope.
   # A single call gives an agent the working model of a textus-managed
   # project: zones and their write authority, entries and their flags,
-  # registered extensions, write flows, and the CLI verb catalog.
+  # registered hooks, write flows, and the CLI verb catalog.
   #
   # Intro is side-effect-free.
   module Intro
@@ -53,7 +53,7 @@ module Textus
         "store_root" => store.root,
         "zones" => zones_for(store),
         "entries" => entries_for(store),
-        "extensions" => extensions_for(store),
+        "hooks" => hooks_for(store),
         "write_flows" => WRITE_FLOWS.dup,
         "cli_verbs" => CLI_VERBS.map(&:dup),
         "docs" => { "spec" => "SPEC.md", "example" => "examples/claude-plugin/" },
@@ -87,7 +87,7 @@ module Textus
       end
     end
 
-    def self.extensions_for(store)
+    def self.hooks_for(store)
       reg = store.registry
       sections = {}
       Hooks::Registry::EVENTS.each do |event, spec|

data/lib/textus/store.rb

@@ -42,12 +42,12 @@ module Textus
       @bus = Hooks::Dispatcher.new(audit_log: audit_log)
       @registry = Hooks::Registry.new(dispatcher: @bus)
       @schemas = {}
-      load_extensions
+      load_hooks
       @reader = Reader.new(self)
       @writer = Writer.new(self)
     end
 
-    def load_extensions
+    def load_hooks
       Textus.with_registry(@registry) do
         Hooks::Builtin.register_all
         dir = File.join(@root, "hooks")
@@ -57,7 +57,7 @@ module Textus
           begin
             load(f)
           rescue StandardError, ScriptError => e
-            raise UsageError.new("failed loading extension #{File.basename(f)}: #{e.class}: #{e.message}")
+            raise UsageError.new("failed loading hook #{File.basename(f)}: #{e.class}: #{e.message}")
           end
         end
       end

data/lib/textus/version.rb

@@ -1,4 +1,4 @@
 module Textus
-  VERSION = "0.8.0"
+  VERSION = "0.8.1"
   PROTOCOL = "textus/2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Patrick