waterplane 0.0.1 → 0.1.6

package/node_modules/@waterplane/shared/dist/plugin.js

@@ -0,0 +1,196 @@
+import { maturityProblems } from "./pluginmaturity.js";
+import { BRAND, LEGACY } from "./brand.js";
+/**
+ * The plugin API's version, semver `MAJOR.MINOR.PATCH`. It versions everything a plugin
+ * author builds against: `HostPluginApi`, the manifest (`PluginManifest`), the event
+ * payloads, the module shape (`HostPluginModule`) and the backend descriptor
+ * (`PluginBackendDef`).
+ *
+ * **Compatibility rule** (`pluginApiProblem`, run by the loader on every manifest): a
+ * plugin declaring `apiVersion` `A.B` loads on a host speaking `X.Y` exactly when
+ * `A === X` and `B <= Y`. Anything else is refused with a sentence and the plugin is
+ * listed broken (`state: "error"`), never loaded half-way. The patch number is not
+ * compared: a plugin cannot depend on one.
+ *
+ * A bare number (`"apiVersion": 1`, every manifest written before semver) means `1.0`.
+ *
+ * **What bumps what:**
+ * - MAJOR (breaking): removing or renaming anything exported here; changing a member's
+ *   type so an existing call no longer compiles or no longer means the same; making an
+ *   optional field required, on either side; a manifest field the loader newly REFUSES;
+ *   a call that used to succeed now throwing or being refused for input it used to
+ *   accept; an event a plugin relied on no longer firing.
+ * - MINOR (additive): a new API method, event, manifest field, optional field, backend
+ *   cap or reader name. A plugin using one declares the new minor, so an older host
+ *   refuses it in words instead of failing at the first call.
+ * - PATCH: wording, documentation and fixes that change no shape — nothing a plugin
+ *   can observe through types.
+ *
+ * **2.0** (backend contract v2, `PLUGIN_API_V2_DOC`): `PluginBackendDef` replaces the v1
+ * reader caps (`hooks`, `promptBoxes`, `transcript`, `contextMeter`, `usageLimits`,
+ * `usageProbe`, `asking`, `forkVia` inside caps) with `facts` — one ordered provider list per
+ * fact — and `launchArgs` with an async `prepare`; it adds `measured`. A 1.x manifest that
+ * lists `backends` is refused in words; there is no shim. Everything else in 2.0 is additive,
+ * so a 1.x plugin that registers NO backend (a reader, a panel, a usage probe) still loads:
+ * `V1_LAST_MINOR` is the newest 1.x it may declare.
+ *
+ * **2.1** (additive): `HostPluginApi.supports` (`dialogKeysThenTyped`), and a source turn's
+ * `ended(at)` waits ≤1.5 s for a `sources.context` sample stamped `>= at` — no end-gate hold needed.
+ * **2.2** (additive, `docs/plans/backend-parity-v3.md` §7): facts + slots `mode`/`commands`, Tab and
+ * Shift+Tab in `SourceKeys`, context `window` + `compactions`, `tokens.session`. 2.1 plugins load as-is.
+ */
+export const PLUGIN_API_VERSION = "2.2.0";
+/** Where the 2.0 backend contract is written down; the 1.x refusal names it. */
+export const PLUGIN_API_V2_DOC = "docs/plans/backend-contract-v2.md";
+/** The last 1.x minor: a 1.0–1.8 plugin with no `backends` in its manifest loads on 2.x. */
+export const V1_LAST_MINOR = 8;
+/** Parse a manifest's `apiVersion`: a semver string (`"1.2"` or `"1.2.3"`) or a bare
+ *  non-negative integer (`1` ⇒ `1.0.0`). Anything else ⇒ null. */
+export function parsePluginApiVersion(v) {
+    if (typeof v === "number")
+        return Number.isInteger(v) && v >= 0 ? { major: v, minor: 0, patch: 0 } : null;
+    if (typeof v !== "string")
+        return null;
+    const m = /^(\d{1,6})\.(\d{1,6})(?:\.(\d{1,6}))?$/.exec(v.trim());
+    return m ? { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3] ?? 0) } : null;
+}
+/**
+ * Why a plugin declaring `declared` cannot load on a host speaking `host`
+ * (default: this one), in a sentence — or null when it can. The rule is
+ * `PLUGIN_API_VERSION`'s: same major, minor no newer than the host's.
+ */
+export function pluginApiProblem(declared, host = PLUGIN_API_VERSION, opts = {}) {
+    const h = parsePluginApiVersion(host);
+    if (!h)
+        throw new Error(`PLUGIN_API_VERSION ${host} is not semver`);
+    const range = `${h.major}.0 up to ${h.major}.${h.minor}`;
+    const said = `apiVersion is ${JSON.stringify(declared)}; this daemon speaks ${host}`;
+    const d = parsePluginApiVersion(declared);
+    if (!d)
+        return `${said}, and loads plugins written for ${range} — "apiVersion" must be a version like "${h.major}.${h.minor}"`;
+    // 2.0 broke only the backend descriptor: a 1.x plugin registering no backend is unaffected.
+    if (h.major === 2 && d.major === 1 && d.minor <= V1_LAST_MINOR && opts.backends === false)
+        return null;
+    if (d.major !== h.major) {
+        // A 1.x plugin on a 2.x daemon: v1 is broken, not shimmed — the sentence names where 2.0 is written down.
+        const where = d.major < h.major && h.major === 2 ? ` — the 2.0 contract is ${PLUGIN_API_V2_DOC}` : "";
+        return `${said}, and loads plugins written for ${range}; ${d.major > h.major ? "this plugin needs a newer daemon" : "this plugin was written for an older API and must be updated"}${where}`;
+    }
+    if (d.minor > h.minor)
+        return `${said}, and loads plugins written for ${range}; this plugin needs a newer daemon`;
+    return null;
+}
+/** `plugin.push` event names, `plugin.call` ack ids, and the byte caps on args and pushed data. */
+export const PLUGIN_EVENT_RE = /^[a-z][a-zA-Z0-9._-]{0,39}$/;
+export const PLUGIN_ACK_RE = /^[A-Za-z0-9._:-]{1,80}$/;
+export const PLUGIN_ARGS_MAX = 64 * 1024;
+export const PLUGIN_PUSH_MAX = 64 * 1024;
+/** `[a-z][a-z0-9-]{1,39}` — also the plugin's directory under `<state dir>/plugins/` (the host state dir, not the config dir). */
+export const PLUGIN_ID_RE = /^[a-z][a-z0-9-]{1,39}$/;
+/** The manifest's file name, current and every past identity's (newest first;
+ *  the loader accepts a legacy one with a deprecation line). */
+export const PLUGIN_MANIFEST = BRAND.pluginManifest;
+export const LEGACY_PLUGIN_MANIFESTS = LEGACY.map((l) => l.pluginManifest);
+/** `<config dir>/<PLUGIN_PATHS_FILE>` lists plugin directories kept elsewhere:
+ *  `{ "paths": ["~/code/my-plugin"] }` (`~` expanded, relative to the config dir).
+ *  Not the STATE dir's `plugins.json`, which holds the person's on/off switches. */
+export const PLUGIN_PATHS_FILE = "plugin-paths.json";
+/** That file's name before API 1.0.0; the loader renames an old one once, never deletes it. */
+export const LEGACY_PLUGIN_PATHS_FILE = "plugins.json";
+/** The largest JSON body a plugin route is handed. */
+export const PLUGIN_ROUTE_BODY_MAX = 1_000_000;
+// ── plugin backends (`api.backend`, docs/analysis/backends-design.md §3) ──────
+/** A backend id: a short lowercase word — the same rule the host's registry applies. */
+export const PLUGIN_BACKEND_ID_RE = /^[a-z][a-z0-9-]{0,31}$/;
+// ── contributed readers (`api.screenReader` / `api.storeReader`, since 1.1) ───
+/** A reader name: the same short lowercase word a backend id is. */
+export const PLUGIN_READER_NAME_RE = /^[a-z][a-z0-9-]{0,39}$/;
+export * from "./pluginreadings.js";
+export * from "./pluginlaunch.js";
+/** How long the core holds a hook's HTTP response for a pending answer by default, and at most. */
+export const PLUGIN_HOOK_HOLD_DEFAULT_MS = 8_000;
+export const PLUGIN_HOOK_HOLD_MAX_MS = 60_000;
+/** Register every method of a typed table with `api.handle`; returns one unregister.
+ * Args arrive from the wire UNCHECKED — the types are a convenience, each handler validates. */
+export function handleAll(api, fns) {
+    const offs = Object.keys(fns).map((k) => api.handle(k, (a, c) => fns[k](a, c)));
+    return () => { for (const off of offs)
+        off(); };
+}
+/** Validate a parsed manifest: problems in words (empty = valid). Unknown fields are allowed — a newer manifest on an older daemon loads with what it understands. */
+export function manifestProblems(m) {
+    const out = [];
+    if (!m || typeof m !== "object" || Array.isArray(m))
+        return [`${PLUGIN_MANIFEST} is not a JSON object`];
+    const o = m;
+    if (typeof o.id !== "string" || !PLUGIN_ID_RE.test(o.id))
+        out.push(`id must match ${PLUGIN_ID_RE}`);
+    if (typeof o.name !== "string" || !o.name.trim())
+        out.push("name is required");
+    if (typeof o.version !== "string")
+        out.push("version is required");
+    const api = pluginApiProblem(o.apiVersion, PLUGIN_API_VERSION, { backends: Array.isArray(o.backends) && o.backends.length > 0 });
+    if (api)
+        out.push(api);
+    const keys = new Set();
+    for (const f of Array.isArray(o.settings) ? o.settings : []) {
+        if (!f || typeof f.key !== "string" || !f.key) {
+            out.push("a setting has no key");
+            continue;
+        }
+        if (keys.has(f.key))
+            out.push(`setting "${f.key}" is declared twice`);
+        keys.add(f.key);
+        if (!["switch", "choice", "number", "text"].includes(f.kind))
+            out.push(`setting "${f.key}" has unknown kind "${String(f.kind)}"`);
+        if (f.kind === "number" && !(f.min <= f.default && f.default <= f.max))
+            out.push(`setting "${f.key}" default is outside min..max`);
+        if (f.kind === "choice" && !f.options?.some((x) => x.value === f.default))
+            out.push(`setting "${f.key}" default is not one of its options`);
+    }
+    for (const a of Array.isArray(o.actions) ? o.actions : []) {
+        if (!a?.id || !a.label)
+            out.push("an action needs an id and a label");
+        else if (a.scope !== "global" && a.scope !== "session")
+            out.push(`action "${a.id}" scope must be global or session`);
+    }
+    for (const t of Array.isArray(o.toggles) ? o.toggles : [])
+        if (!t?.id || !t.label || typeof t.default !== "boolean")
+            out.push("a toggle needs an id, a label and a boolean default");
+    if (o.env !== undefined && (!Array.isArray(o.env) || o.env.some((e) => typeof e !== "string")))
+        out.push("env must be a list of names");
+    if (o.web !== undefined && typeof o.web !== "string")
+        out.push("web must be a path string");
+    if (o.assets !== undefined && (typeof o.assets !== "string" || !o.assets || /^([\\/]|[A-Za-z]:)/.test(o.assets) || o.assets.split(/[\\/]/).includes("..")))
+        out.push("assets must be a folder path inside the extension (relative, no ..)");
+    for (const k of ["optional", "experimental"])
+        if (o[k] !== undefined && typeof o[k] !== "boolean")
+            out.push(`${k} must be true or false`);
+    if (o.backends !== undefined) {
+        if (!Array.isArray(o.backends))
+            out.push("backends must be a list of backend ids");
+        else
+            for (const b of o.backends) {
+                if (typeof b !== "string" || !PLUGIN_BACKEND_ID_RE.test(b))
+                    out.push(`backend id ${JSON.stringify(b)} is not a short lowercase word (letters, digits, dashes)`);
+            }
+    }
+    return [...out, ...maturityProblems(o)];
+}
+/** A value as the manifest allows it, or undefined (refused, never repaired). */
+export function cleanPluginValue(f, v) {
+    switch (f.kind) {
+        case "switch": return typeof v === "boolean" ? v : undefined;
+        case "choice": return typeof v === "string" && f.options.some((o) => o.value === v) ? v : undefined;
+        case "number": return typeof v === "number" && Number.isFinite(v) && v >= f.min && v <= f.max ? v : undefined;
+        case "text": return typeof v === "string" && v.length <= 20_000 ? v : undefined;
+    }
+}
+/** The settings with defaults filled in. */
+export function pluginValues(m, stored) {
+    const out = {};
+    for (const f of m.settings ?? [])
+        out[f.key] = cleanPluginValue(f, stored[f.key]) ?? f.default;
+    return out;
+}
+//# sourceMappingURL=plugin.js.map

package/node_modules/@waterplane/shared/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/node_modules/@waterplane/shared/dist/pluginfile.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `api.offerFile` (plugin API 1.5, `plugin.ts`): one file a plugin wrote into its own `dataDir`,
+ * handed to the phone's one download path and deleted by the core once fetched or at its TTL. The
+ * host half is `packages/host/src/plugins/pluginfiles.ts`; the reasoning is docs/notes/plugins.md.
+ */
+/** `api.offerFile`'s options (since 1.5). */
+export interface PluginFileOfferOpts {
+    /** The name the phone saves it under: letters, digits, `.`, `_`, `-`, space; at most 120. */
+    name: string;
+    /** How long it may be fetched, ms (default PLUGIN_FILE_TTL_MS, at most PLUGIN_FILE_TTL_MAX_MS). */
+    ttlMs?: number;
+    /** Called once when the offer ends: fetched (its last byte went out), expired, or withdrawn. */
+    onGone?: (why: "fetched" | "expired" | "withdrawn") => void;
+}
+/** What `api.offerFile` answers: where the phone fetches it, how big it is, until when. */
+export interface PluginFileOffer {
+    /** App-relative URL path, `/api/plugin-file/<id>/<token>` — the phone downloads it with `files.downloadArtifact({…, src: path})`. */
+    path: string;
+    size: number;
+    expiresAt: number;
+    /** End the offer now (the file is deleted). */
+    withdraw(): void;
+}
+export declare const PLUGIN_FILE_TTL_MS: number;
+export declare const PLUGIN_FILE_TTL_MAX_MS: number;

package/node_modules/@waterplane/shared/dist/pluginfile.js

@@ -0,0 +1,8 @@
+/**
+ * `api.offerFile` (plugin API 1.5, `plugin.ts`): one file a plugin wrote into its own `dataDir`,
+ * handed to the phone's one download path and deleted by the core once fetched or at its TTL. The
+ * host half is `packages/host/src/plugins/pluginfiles.ts`; the reasoning is docs/notes/plugins.md.
+ */
+export const PLUGIN_FILE_TTL_MS = 10 * 60_000;
+export const PLUGIN_FILE_TTL_MAX_MS = 60 * 60_000;
+//# sourceMappingURL=pluginfile.js.map

package/node_modules/@waterplane/shared/dist/pluginfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginfile.js","sourceRoot":"","sources":["../src/pluginfile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,MAAM,CAAC;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,MAAM,CAAC"}

package/node_modules/@waterplane/shared/dist/pluginlaunch.d.ts

@@ -0,0 +1,109 @@
+/**
+ * The launch half of a plugin backend (contract 2.0): what `prepare` is handed and answers, and the
+ * provider table (`facts`) and binary caps a `PluginBackendDef` declares. Split out of `plugin.ts`
+ * for size only; `plugin.ts` re-exports all of it, so it is the same contract and the same docs.
+ */
+import type { LaunchOpts, PermissionMode } from "./wire/session.js";
+/** What `prepare` is handed. `hookPort` is the daemon's loopback port. */
+export interface PluginLaunchRequest {
+    readonly resumeMode?: "continue" | "pick" | "fork";
+    readonly resumeSessionId?: string;
+    readonly launch: LaunchOpts;
+    readonly hookPort: number;
+    /** The session's working directory (realpath) and the host's own id for it (2.0: always set). */
+    readonly cwd: string;
+    readonly hostSessionId: string;
+    /** Fork `resumeSessionId` AT this turn — only reaches a backend with `forkVia: "server"`. */
+    readonly forkAtTurn?: string;
+    /**
+     * The core's repo-facing text (`reposkilltext.ts`), the ONE text every agent is told: the
+     * outbox, the inbox, builds, screenshots. The plan says how it reached the CLI
+     * (`instructionsVia`): e.g. `files: [{ path: "session:instructions/AGENTS.md", content:
+     * req.instructions }]` plus an `env` value `"session:instructions"`, which the host
+     * resolves to that directory's absolute path (`"env-file"`).
+     */
+    readonly instructions: string;
+    /** Ask rules already cut for this repo (`shared/askrules.ts`); the plan says how they hold (`askRulesVia`). */
+    readonly askRules: readonly string[];
+}
+/** How the core's `instructions` reached the CLI; `"none"` is published so the phone can say so. */
+export type InstructionsVia = "plugin-dir" | "env-file" | "config" | "flag" | "none";
+/** How the ask rules hold: the CLI's own policy, the host's answer gate on dialogs, or not at all. */
+export type AskRulesVia = "native" | "gate" | "none";
+/**
+ * What `prepare` answers. `sessionId` is CLAUDE's conversation uuid only (a
+ * reader turns it into a path under claude's projects dir); any other CLI's id
+ * rides on `backendSessionId`, and only when the launch KNOWS it. `env` is
+ * merged after `spawnEnv` into the pane's environment.
+ */
+export interface PluginLaunchPlan {
+    readonly args: string[];
+    readonly sessionId?: string;
+    readonly backendSessionId?: string;
+    readonly createsRecord?: boolean;
+    readonly env?: Readonly<Record<string, string>>;
+    /** Variables the pane must NOT inherit from the daemon: exact names, or `*_SUFFIX` (2.0). */
+    readonly dropEnv?: readonly string[];
+    /** Spawn THIS program in the PTY instead of `bin()` (absolute path), `args` as its argv — e.g. a
+     *  POSIX `sh` that waits for the backend's own server, then `exec`s the CLI. */
+    readonly exec?: string;
+    readonly instructionsVia: InstructionsVia;
+    readonly askRulesVia: AskRulesVia;
+    /**
+     * Written by the HOST before spawn. `session:<name>` ⇒
+     * `<state dir>/launch/<hostSessionId>/<name>`; an absolute path is refused unless inside the
+     * plugin's `dataDir` (realpath). Never the repo, never `~/.<cli>`. In an `env` value, an item
+     * (comma-separated) spelled `session:<name>` is replaced by that path, so a variable can
+     * name a launch file or directory; any other item is passed as written.
+     */
+    readonly files?: readonly {
+        path: string;
+        content: string;
+        mode?: number;
+    }[];
+}
+/**
+ * One way a fact can be answered, in the order the host asks (`facts`):
+ *  - `{source: true}` — ask `sources.<fact>` (re-read per call; a getter may switch it off);
+ *  - `{screen}` — a NAMED screen reader: core's (below) or one `api.screenReader` contributed;
+ *  - `{store}` — a NAMED store reader: core's `claude-jsonl`, or one `api.storeReader` contributed.
+ * A provider answering null passes to the next; an empty walk is ABSENT, never a guess.
+ */
+export type Provider = {
+    source: true;
+} | {
+    screen: string;
+} | {
+    store: string;
+};
+export type FactName = "turns" | "dialogs" | "questions" | "plan" | "delivery" | "transcript" | "context" | "tokens" | "usage" | "agents" | "conversations" | "asking" | "limits" | "mode" | "commands";
+export declare const FACT_NAMES: readonly FactName[];
+/**
+ * The providers per fact. A fact left out has none — ABSENT. Core names per fact (the host
+ * refuses any other at registration, naming the ones it has):
+ *  turns: screen `silence` · dialogs: screen `claude-numbered` (+ contributed screen readers) ·
+ *  questions / asking: screen `question-ts` · plan: screen `planbox` · context: screen
+ *  `context-meter` · limits: screen `limit-ts` · usage: screen `usage-probe` · transcript /
+ *  context / conversations / tokens: store `claude-jsonl` (+ contributed store readers) ·
+ *  agents: store `claude-agents`. `delivery`, `mode` and `commands` (2.2) take `{source:true}` only.
+ */
+export type BackendFacts = Partial<Record<FactName, readonly Provider[]>>;
+/** Facts about the BINARY — what it accepts, never which reader answers what (that is `facts`). */
+export interface BackendCapsV2 {
+    /** False = a plain shell: no turns, no idle ping, no model-made tab name. */
+    turns: boolean;
+    /** Whose slash-command vocabulary the composer speaks. */
+    slash: "claude" | "own" | "none";
+    /** The reasoning-effort ladder the binary accepts, in order; absent = no knob. Measured, never guessed. */
+    effort?: readonly string[];
+    /** The permission modes it accepts, in the order offered; empty = no such concept. */
+    permissionModes: readonly PermissionMode[];
+    /**
+     * 2.2: the subset of `permissionModes` a session can START in; absent = all of them. Non-empty,
+     * each mode once. Narrowing it refuses a stored launch (backlog, schedule, intent, fork, limit
+     * relaunch) whose mode falls outside, in words at create.
+     */
+    launchModes?: readonly PermissionMode[];
+    /** It accepts a remote-control flag. */
+    remoteControl: boolean;
+}

package/node_modules/@waterplane/shared/dist/pluginlaunch.js

@@ -0,0 +1,3 @@
+export const FACT_NAMES = ["turns", "dialogs", "questions", "plan", "delivery", "transcript",
+    "context", "tokens", "usage", "agents", "conversations", "asking", "limits", "mode", "commands"];
+//# sourceMappingURL=pluginlaunch.js.map

package/node_modules/@waterplane/shared/dist/pluginlaunch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginlaunch.js","sourceRoot":"","sources":["../src/pluginlaunch.ts"],"names":[],"mappings":"AA8EA,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY;IAC/G,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC"}

package/node_modules/@waterplane/shared/dist/pluginmaturity.d.ts

@@ -0,0 +1,26 @@
+/**
+ * How mature a plugin SAYS it is, and the words for it — one place.
+ *
+ * The plugin's own `waterplane-plugin.json` carries `maturity`; absent is "unrated" (the plugin does
+ * not say), never shown as stable. The phone and the host both word a plugin through
+ * `pluginMaturity`, so no second table of labels exists.
+ */
+import type { PluginManifest } from "./plugin.js";
+/** The GitHub topic a repo carries to be offered as a plugin (listed under `BRAND.githubOrg`). */
+export declare const PLUGIN_TOPIC: string;
+export declare const PLUGIN_MATURITIES: readonly ["stable", "preview", "experimental"];
+export type PluginMaturityDeclared = (typeof PLUGIN_MATURITIES)[number];
+export type PluginMaturityLevel = PluginMaturityDeclared | "unrated";
+export interface PluginMaturityInfo {
+    level: PluginMaturityLevel;
+    /** The tag as printed: "Stable", "Preview", "Experimental", "Unrated". */
+    label: string;
+    /** One line of what it means for the person installing. */
+    meaning: string;
+}
+/** Read a manifest's maturity. Accepts a partial/unvalidated manifest; anything outside the three is "unrated". */
+export declare function pluginMaturity(m: Pick<PluginManifest, "maturity"> | {
+    maturity?: unknown;
+} | null | undefined): PluginMaturityInfo;
+/** Refusals for the manifest's `maturity` field (empty when absent or valid). Called by `manifestProblems`. */
+export declare function maturityProblems(o: Record<string, unknown>): string[];

package/node_modules/@waterplane/shared/dist/pluginmaturity.js

@@ -0,0 +1,32 @@
+/**
+ * How mature a plugin SAYS it is, and the words for it — one place.
+ *
+ * The plugin's own `waterplane-plugin.json` carries `maturity`; absent is "unrated" (the plugin does
+ * not say), never shown as stable. The phone and the host both word a plugin through
+ * `pluginMaturity`, so no second table of labels exists.
+ */
+import { BRAND } from "./brand.js";
+/** The GitHub topic a repo carries to be offered as a plugin (listed under `BRAND.githubOrg`). */
+export const PLUGIN_TOPIC = BRAND.pluginManifest.replace(/\.json$/, "");
+export const PLUGIN_MATURITIES = ["stable", "preview", "experimental"];
+const WORDS = {
+    stable: { label: "Stable", meaning: "The author considers it ready for daily use" },
+    preview: { label: "Preview", meaning: "May break between versions" },
+    experimental: { label: "Experimental", meaning: "May not work" },
+    unrated: { label: "Unrated", meaning: "The plugin does not say" },
+};
+/** Read a manifest's maturity. Accepts a partial/unvalidated manifest; anything outside the three is "unrated". */
+export function pluginMaturity(m) {
+    const v = m?.maturity;
+    const level = PLUGIN_MATURITIES.includes(v) ? v : "unrated";
+    return { level, ...WORDS[level] };
+}
+/** Refusals for the manifest's `maturity` field (empty when absent or valid). Called by `manifestProblems`. */
+export function maturityProblems(o) {
+    if (o.maturity === undefined)
+        return [];
+    if (PLUGIN_MATURITIES.includes(o.maturity))
+        return [];
+    return [`maturity must be one of ${PLUGIN_MATURITIES.join(", ")} (or left out)`];
+}
+//# sourceMappingURL=pluginmaturity.js.map

package/node_modules/@waterplane/shared/dist/pluginmaturity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginmaturity.js","sourceRoot":"","sources":["../src/pluginmaturity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,kGAAkG;AAClG,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAU,CAAC;AAYhF,MAAM,KAAK,GAAoE;IAC7E,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,6CAA6C,EAAE;IACnF,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,4BAA4B,EAAE;IACpE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE;IAChE,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,yBAAyB,EAAE;CAClE,CAAC;AAEF,mHAAmH;AACnH,MAAM,UAAU,cAAc,CAAC,CAA+E;IAC5G,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACtB,MAAM,KAAK,GAAyB,iBAAwC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAA4B,CAAC,CAAC,CAAC,SAAS,CAAC;IACrI,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AACpC,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,gBAAgB,CAAC,CAA0B;IACzD,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACxC,IAAK,iBAAwC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9E,OAAO,CAAC,2BAA2B,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACnF,CAAC"}

package/node_modules/@waterplane/shared/dist/pluginreadings.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The readings a plugin contributes to the machine and account readouts — `api.thermalReader`
+ * (since 1.3) and `api.usageProbe` (since 1.7). Part of the plugin contract: re-exported from
+ * `plugin.ts` and documented with it (`docs/plugins-api.md`).
+ */
+import type { FanRow } from "./wire/sysstat.js";
+import type { UsageReading, UsageSourceId } from "./wire/telemetry.js";
+/** How long the core waits for a contributed thermal reader before it counts as no reading. */
+export declare const PLUGIN_THERMAL_TIMEOUT_MS = 8000;
+/**
+ * What a contributed thermal reader answers (since 1.3). A READING carries what it read and
+ * which tool read it (`source`, shown beside the figures — the numbers are that tool's); a
+ * NOTE says why there is none and, optionally, shell commands that would fill it in (drawn as
+ * copy blocks); null is "nothing to say".
+ */
+export type PluginThermalReading = {
+    cpuTempC?: number;
+    gpuTempC?: number;
+    fans: FanRow[];
+    source: string;
+} | {
+    note: string;
+    fix?: string[];
+} | null;
+/** A thermal reader (`api.thermalReader`). */
+export interface PluginThermalReader {
+    read(): Promise<PluginThermalReading>;
+}
+/** A usage probe (`api.usageProbe`, since 1.7): one account's quota as a `UsageReading`. */
+export interface PluginUsageProbe {
+    /** The reading's id: short, lowercase, `[a-z0-9:_-]` (`USAGE_SOURCE_RE`). Never `claude`. */
+    source: UsageSourceId;
+    /** As drawn on the chip: `"Copilot"`. */
+    label: string;
+    /** The backend id this account belongs to, when there is one (a session header shows its own). */
+    backend?: string;
+    /** Poll period while polling is on; default 15 min, never less than 60 s. */
+    everyMs?: number;
+    /** A reading, or null when there is nothing to say (the source is then absent). */
+    probe(): Promise<UsageReading | null>;
+}
+/** How long a usage probe may take before it counts as a failure (its last reading is kept). */
+export declare const PLUGIN_USAGE_PROBE_TIMEOUT_MS = 20000;

package/node_modules/@waterplane/shared/dist/pluginreadings.js

@@ -0,0 +1,5 @@
+/** How long the core waits for a contributed thermal reader before it counts as no reading. */
+export const PLUGIN_THERMAL_TIMEOUT_MS = 8_000;
+/** How long a usage probe may take before it counts as a failure (its last reading is kept). */
+export const PLUGIN_USAGE_PROBE_TIMEOUT_MS = 20_000;
+//# sourceMappingURL=pluginreadings.js.map

package/node_modules/@waterplane/shared/dist/pluginreadings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginreadings.js","sourceRoot":"","sources":["../src/pluginreadings.ts"],"names":[],"mappings":"AAQA,+FAA+F;AAC/F,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAgC/C,gGAAgG;AAChG,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC"}