@repogo/plugins 0.1.29 → 0.1.31

package/README.md

@@ -28,6 +28,17 @@ data `<project>.<name>`. A bare name (`todos`) is shared by every plugin that
 names it, in any project, so they must agree on their collections' schemas.
 Data stays in place when the project moves. A plugin without collections has no file.
 
+A plugin for every project goes in `~/.repogo/plugins/<name>/app.ts` instead
+of a project's folder: the same shape, run with `ctx.root` set to whichever
+project calls it. A project plugin of the same name takes precedence. Pages
+beside it (`pages/*.md`) are reachable from any project as
+`~/.repogo/plugins/<name>/pages/<page>.md`, and `~/.repogo/plugins/tab.json`
+lists the pages every project's tab shows.
+
+A method may alert the user's phones: `ctx.notify({ title, body, page })`, where
+`page` is a page target a tap opens (`".repogo/tabs/vercel.md?project=a"`), and
+`collapse` lets a repeated alert replace itself.
+
 Add it to `.repogo/plugins/package.json` (`bun add @repogo/plugins`) for types
 and editor help. The RepoGo host runs plugins with its own copy of this
 package, the version it shipped with, so a plugin always matches the host.

package/dist/context.d.ts

@@ -1,4 +1,13 @@
 import type { Collection } from "./collections";
+/** An alert for the user's phones: what it says, and the page a tap opens. */
+export type Notice = {
+    title: string;
+    body: string;
+    /** A page target, `.repogo/tabs/vercel.md?project=a`; a tap opens it. */
+    page?: string;
+    /** Alerts sharing a collapse id replace one another; defaults to the plugin and title. */
+    collapse?: string;
+};
 export type Context = {
     plugin: string;
     /** The project's checkout, for a plugin that reads the project's files. */
@@ -6,5 +15,7 @@ export type Context = {
     db: Record<string, Collection<any>>;
     call: (method: string, input?: unknown) => Promise<unknown>;
     emit: (name: string, payload: unknown) => Promise<void>;
+    /** Sends an alert to every phone paired with this environment. */
+    notify: (notice: Notice) => void;
     log: (...args: unknown[]) => void;
 };

package/dist/index.js

@@ -33,7 +33,9 @@ function toCallError(error) {
     const fieldErrors = {};
     for (const issue of error.issues)
       fieldErrors["/" + issue.path.join("/")] ??= issue.message;
-    return { code: "VALIDATION", message: "Check the highlighted fields.", fieldErrors };
+    const messages = Object.values(fieldErrors);
+    const message = messages.length === 1 ? messages[0] : "Check the highlighted fields.";
+    return { code: "VALIDATION", message, fieldErrors };
   }
   return { code: "INTERNAL", message: error instanceof Error ? error.message : String(error) };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repogo/plugins",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "Write RepoGo plugins: collections and methods over SQLite that agents and cards call",
   "type": "module",
   "exports": {