@plurnk/plurnk-service 3.0.0 → 3.1.0

package/.env.defaults

@@ -128,7 +128,7 @@ PLURNK_SERVICE_EFFECT_READ=auto
 PLURNK_SERVICE_EFFECT_PURE=auto
 # Brief settlement wait for new streams/completing siblings, ms; 0 = off; quiescence ends it early.
 PLURNK_SERVICE_OPTIMISTIC_WAIT_MS=5000
-# Maximum park before reassessing live work, positive seconds; WAIT <seconds> overrides one park.
+# Maximum park before reassessing live work, positive seconds; WAIT [seconds] overrides one park.
 PLURNK_SERVICE_WAIT_SEC=300
 # Ambient environment an EXEC subprocess may inherit from the host: exact names, or one
 # trailing-* prefix glob. This is a CEILING — a worker or a heading modifier narrows it,
@@ -151,7 +151,10 @@ PLURNK_SERVICE_EDIT_RECEIPT_CONTEXT_LINES=4
 PLURNK_SERVICE_EDIT_RECEIPT_REMOVED_LINES=40
 # Paths named per class in the packet's git status; the rest are counted.
 PLURNK_SERVICE_GIT_STATUS_PATHS=8
-# Heaviest retained log rows the Context gauge names, as {path, tokens}; 0 names none.
+# Above this share of the budget, measured before adding either, the Context gauge names its largest rows
+# and a packet within its budget carries the budget_pressure notice ({§context-pressure-notice}).
+PLURNK_SERVICE_BUDGET_PRESSURE=80%
+# Heaviest retained log rows the pressured Context gauge names, as {path, tokens}; 0 names none.
 PLURNK_SERVICE_BUDGET_LARGEST_ITEMS=5
 # First page of everything that comes back unasked in size: a READ or FIND without a scope, a stream's
 # delivery, a peer worker's message, a receipt the model did not author ({§markerless-first-page}).
@@ -159,12 +162,17 @@ PLURNK_SERVICE_BUDGET_LARGEST_ITEMS=5
 PLURNK_SERVICE_PREVIEW_LINES=100
 # Independent bound on the same page, Unicode code points; CRLF counts as one separator.
 PLURNK_SERVICE_PREVIEW_CHARS=16000
+# Assistant replay ({§emission-history}): none, latest, or all eligible turns from this loop, each as the
+# NOTEs it wrote, in the model's voice; every other operation is omitted. The context wall may omit
+# the whole section; source evidence never changes.
+PLURNK_SERVICE_EMISSION_HISTORY=all
 # Optional reasoning memory ({§reasoning-row}): 1 adds the turn's preview before its emission or results,
 # only when room remains after all requested results and diagnostics. Otherwise omit it silently. 0 disables it.
-PLURNK_SERVICE_REASONING_ROWS=1
+PLURNK_SERVICE_REASONING_ROWS=0
 # The row's page ({§reasoning-row}): reasoning that fits it lands whole; longer reasoning lands as its last page,
 # this many lines within PLURNK_SERVICE_PREVIEW_CHARS, because a turn's conclusions and plan sit at its end; the
-# rest stays readable at reasoning://. Unset/empty = the shared page, PLURNK_SERVICE_PREVIEW_LINES.
+# rest stays readable at reasoning://. -1 returns the complete reasoning without either preview bound,
+# still only if it fits. Unset/empty = the shared page, PLURNK_SERVICE_PREVIEW_LINES; 0 is invalid.
 # PLURNK_SERVICE_REASONING_TRAILING_LINES=40
 # Code points of an entry's prose summary the catalog shows whole.
 PLURNK_SERVICE_CATALOG_SUMMARY_CHARS=256
@@ -193,6 +201,10 @@ PLURNK_SERVICE_ROOTS=project,plurnk,global
 # PLURNK_SERVICE_POLICY=
 # Recap file, relative to the package root; unset = packaged recap.md; empty file omits the section.
 # PLURNK_SERVICE_RECAP=
+# Recap lines, one per key: PLURNK_SERVICE_RECAP_LINE_<alias>=<line> ({§recap-lines}). Each opens with YOU MUST,
+# YOU MUST NOT, YOU MUST ONLY, YOU SHOULD, YOU SHOULD NOT or YOU MAY and renders as one callout, in alias order,
+# ahead of the Recap source. An empty value turns a shipped line off.
+# PLURNK_SERVICE_RECAP_LINE_<alias>=
 
 # --- Search indexing ---
 # Comma-separated globs excluded from derivation, not READ. No slash = basename; slash = pathname.

package/INSTALL.md

@@ -101,6 +101,24 @@ Extension settings remain environment/configuration values; they do not extend t
 service CLI. Boolean flags use `1` and `0`. An empty value is not an unset value;
 the owning declaration specifies its meaning.
 
+## Manual and shell completions
+
+The installed package includes a generated manual and static completions. They
+require no running daemon. Find the global npm package at
+`$(npm root -g)/@plurnk/plurnk-service`; the paths below are relative to it.
+
+| Artifact | Use |
+| --- | --- |
+| `dist/man/plurnk-service.1` | Open with `man /path/to/plurnk-service.1`, or copy into a directory on `MANPATH` (commonly `~/.local/share/man/man1/`). |
+| `dist/completions/plurnk-service.bash` | Source from your Bash configuration. |
+| `dist/completions/_plurnk-service` | Copy into a directory on Zsh's `fpath` before `compinit`. |
+| `dist/completions/plurnk-service.fish` | Copy into `~/.config/fish/completions/`, or the corresponding `XDG_CONFIG_HOME` location. |
+
+Completion offers command names, long options and filenames. Configuration
+values remain in `plurnk-service config defaults`, not a separate static catalog.
+Package installation does not edit shell configuration or install these files
+outside the package.
+
 ## Choose the right scope
 
 | Change | Owner and effect |

package/README.md

@@ -5,6 +5,9 @@ operation dispatch. Its client surface is AG-UI over HTTP/SSE through
 `@plurnk/plurnk-agui`. The user-facing CLI lives in
 [plurnk](https://github.com/plurnk/plurnk).
 
+See [installation and configuration](INSTALL.md), including the packaged
+[manual and shell completions](INSTALL.md#manual-and-shell-completions).
+
 ## What an agent can do
 
 The exact model-facing language and operation set are owned by