@north-light/cli 0.3.529 → 0.3.530

package/dist/api/dto/lifecycle.d.ts

@@ -6,7 +6,9 @@ export interface ReviveRequest {
     /** Clear the finalization latch before reviving (the `--reopen` gate). The
      *  revive doorway accepts it only for a finalized node (`not_finalized`
      *  otherwise); without it, a finalized node is rejected (`node_finalized`).
-     *  Message delivery has its own wider reopen behavior. */
+     *  The target becomes resident, unless the caller is a node that is the
+     *  target's manager: then it keeps its lifecycle. Message delivery has its
+     *  own wider reopen behavior. */
     reopen?: boolean;
     /** Wake provenance: the cron whose run drove this revive (`CRTR_CRON_ID`,
      *  set by the daemon in every cron run's environment and forwarded by the

package/dist/api/dto/messages.d.ts

@@ -19,9 +19,11 @@ export interface SendMessageRequest {
     from?: NodeIdDTO | null;
     /** Revive with no inbox entry (`--fresh` → `reviveNode({ resume: false })`). */
     fresh?: boolean;
-    /** Before delivery, make the target resident and clear its finalization latch
-     *  when present (`--reopen`). Accepted for both durable and interactive
-     *  delivery; `--fresh` retains its separate finalized-only gate. */
+    /** Before delivery, clear the target's finalization latch when present and
+     *  make it resident (`--reopen`), unless the caller is a node that is the
+     *  target's manager: then the target keeps its lifecycle. Accepted for both
+     *  durable and interactive delivery; `--fresh` retains its separate
+     *  finalized-only gate. */
     reopen?: boolean;
     /** Hidden ambient context upserted onto the target's sidecar as a
      *  `situational` card, never visible chat (`--situational-context`).

package/dist/builtin-memory/crouter-plugin/bundles-and-memory.md

@@ -21,7 +21,7 @@ await writeFile('acme.tar', bundle.tar);
 
 `buildBundle` returns `commandsJson`, `bundleJson`, generated `memory/` members, uncompressed tar bytes, and an ETag. It runs the manifest validator and throws `ManifestInvalidError` when the generated command manifest is invalid. `buildCommandManifest(plugin, { mountPath })` returns the manifest object when archive bytes are not needed.
 
-The tar has exactly `bundle.json`, `commands.json`, and `memory/<name>.md` members for the documents declared in the `memory` array of `definePlugin`. `bundle.json` carries `bundleVersion`, plus `version` when the plugin declares one, `object_kinds` when it declares object kinds, and `groups` when a provider declares its tool groups (the directory refuses a provider archive without them). `groups` is keyed by group id, each value `{"consent_line": string, "who"?: "own" | "user" | "allowlist" | "any", "allowlist"?: string[]}`, with `who` and `allowlist` written only when declared:
+The tar has exactly `bundle.json`, `commands.json`, and `memory/<name>.md` members for the documents declared in the `memory` array of `definePlugin`. `bundle.json` carries `bundleVersion`, plus `version` when the plugin declares one, `object_kinds` when it declares object kinds, and `groups` when a provider declares its tool groups (the directory refuses a provider archive without them). `groups` is keyed by group id, each value `{"consent_line": string, "who"?: "own" | "user" | "allowlist" | "any" | "team:<id>", "allowlist"?: string[]}`, with `who` and `allowlist` written only when declared:
 
 ```json
 {"bundleVersion":1,"version":1,"groups":{"read":{"consent_line":"Read your Acme apps and deployments."},"deploy":{"consent_line":"Start deployments on your Acme apps.","who":"allowlist","allowlist":["app:k3x9"]}}}

package/dist/builtin-memory/crouter-plugin/commands.md

@@ -32,7 +32,7 @@ definePlugin({
 });
 ```
 
-Each group has `consentLine`, the line the directory's consent page shows, and optionally `who` (`own`, `user`, `allowlist` or `any`; the directory treats an omitted `who` as `user`) and `allowlist` (app principals `app:<id>`, required with `who: 'allowlist'` and refused otherwise). `buildBundle` writes the block into `bundle.json` as `groups`, and the directory applies it when it refreshes the provider's manifest. The directory refuses a provider archive whose `bundle.json` has no `groups` (`bundle.json groups: is required`), and a provider's groups come only from this declaration: the directory's console and CLI do not edit groups. `definePlugin` itself accepts a provider without `groups`, but once declared every leaf's `group` must name a declared group and every declared group must be used by at least one leaf; `definePlugin` throws `PluginDefinitionError` otherwise. A plugin that is not `provider: true` must not declare `groups`.
+Each group has `consentLine`, the line the directory's consent page shows, and optionally `who` (`own`, `user`, `allowlist`, `any` or `team:<id>`; the directory treats an omitted `who` as `user`) and `allowlist` (app principals `app:<id>`, required with `who: 'allowlist'` and refused otherwise). `buildBundle` writes the block into `bundle.json` as `groups`, and the directory applies it when it refreshes the provider's manifest. The directory refuses a provider archive whose `bundle.json` has no `groups` (`bundle.json groups: is required`), and a provider's groups come only from this declaration: the directory's console and CLI do not edit groups. `definePlugin` itself accepts a provider without `groups`, but once declared every leaf's `group` must name a declared group and every declared group must be used by at least one leaf; `definePlugin` throws `PluginDefinitionError` otherwise. A plugin that is not `provider: true` must not declare `groups`.
 
 A branch or leaf may set `tier` to `common` or `important` to be promoted into its parent's `-h`. A command with more than 40 children lists only its promoted children in its own `-h`, followed by the count of the rest; the others still run and answer `-h` by name. Use this when a plugin mounts one command per entry of a large catalog. On such a command only promoted leaves reach the top-level `crtr -h`; a promoted branch shows in the command's own `-h`.