@tinoy/pi-canon 0.4.0 → 0.6.0

package/README.md

@@ -1,3 +1,10 @@
+> [!WARNING]
+> **Do not install anything here yet.**
+>
+> This is a fast-moving prototype: the interfaces change without notice, and nothing here
+> is stable. Every package in this project is headed for a stable 1.0, but that is still
+> some way off. Install one only if you intend to follow the code and expect breakage.
+
 # @tinoy/pi-canon
 
 Durable system-prompt rules ("canon") for pi. Rules and learned facts are stored
@@ -17,7 +24,7 @@ pi install npm:@tinoy/pi-canon
 - **Commands** — `/canon` (list, add, remove, edit, category management) and `/canon-dump`.
 - **Injection** — the block is appended at `before_agent_start` and re-normalized on every provider request, so a run started by an injected message carries the same bytes as an interactive prompt.
 - **Category headings** — a category sub-heading inside a scope group prints the store id after the word `category` (`#### Behavioural Preferences [category 1cg5lr]`), which is the same id a `canon_add` refusal lists; the word keeps it from reading as an entry handle, which the block renders as `[1i15c2]`. Uncategorized entries carry no id, and a scope group holding a single category stays flat with no sub-heading.
-- **Peer notices** — entry changes are broadcast over the pi-intercom bus (namespace `canon`); receivers match the entry scope against their own model and audience.
+- **Peer notices** — entry changes are published over the `ipc` transport's bus (namespace `canon`); receivers match the entry scope against their own model and audience.
 - **Tail sections** — another extension contributes prompt text through the `canon:section` event; its ids are published on `canon:sections`.
 
 ## Exports

package/index.ts

@@ -14,7 +14,7 @@
  * changes via canon notices (and the user's /canon-dump).
  * Edited at runtime via canon_add / canon_remove / canon_edit (plus
  * the /canon and /canon-dump commands). Changes are broadcast to peer sessions
- * over the pi-intercom extension bus (namespace "canon"); each receiver matches
+ * over the `ipc` transport's extension bus (namespace "canon"); each receiver matches
  * the entry scope against its own model + audience before showing a notice.
  *
  * Replaces APPEND_SYSTEM.md (global/parent) and FLASH.md (global/subagent).
@@ -714,8 +714,8 @@ export default function (pi: ExtensionAPI) {
 
 	// Best-effort peer notice: the store write has already landed when this runs,
 	// so EVERY failure mode of the channel call is swallowed here and logged:
-	//   - pi-intercom 0.12.1's channel.publish is SYNCHRONOUS and throws
-	//     "Intercom is not connected" when the broker client is down;
+	//   - the channel's publish may throw SYNCHRONOUSLY when the transport is
+	//     down, and returns void, so there is no promise to catch;
 	//   - it returns void, so .catch must only ever be reached through the
 	//     optional call (chaining it directly was the TypeError that escaped);
 	//   - a promise-returning build rejects instead of throwing — the guarded
@@ -748,7 +748,7 @@ export default function (pi: ExtensionAPI) {
 		}
 	}
 
-	// ---------- intercom channel (mirrors the intercom-broadcast package) ----------
+	// ---------- the bus channel (mirrors the ipc package's registration) ----------
 
 	const registration: CanonRegistration = {
 		namespace: NAMESPACE,
@@ -793,7 +793,7 @@ export default function (pi: ExtensionAPI) {
 		pi.events.emit("intercom:extension-register", registration);
 	}
 
-	// pi-intercom may load after this extension; re-emit once its registry is
+	// The registrar may load after this extension; re-emit once the registry is
 	// reported ready. First successful registration wins (duplicate namespace
 	// is rejected, not thrown).
 	pi.events.on("intercom:extension-registry-ready", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tinoy/pi-canon",
-	"version": "0.4.0",
+	"version": "0.6.0",
 	"description": "Durable system-prompt rules for pi: an on-disk canon store, its tools, and the /canon commands.",
 	"license": "MIT",
 	"repository": {