@weaveprotocol/cli 0.2.3 → 0.2.4

package/dist/weave.mjs

@@ -12942,7 +12942,8 @@ var app = {
       title: { type: "string", minLength: 1, maxLength: 100 },
       description: { type: "string", maxLength: 1e3 },
       needs: { type: "array", minItems: 1, maxItems: MAX_APP_COLLECTIONS, items: { type: "object" } },
-      from: { type: "string", maxLength: 300 }
+      from: { type: "string", maxLength: 300 },
+      updates: { type: "string", minLength: 1, maxLength: 100 }
     },
     required: ["title", "needs"]
   },
@@ -12956,6 +12957,9 @@ function checkApp(value) {
   if (body.description !== void 0 && (typeof body.description !== "string" || body.description.length > 1e3)) {
     return "An app's description is at most 1000 characters";
   }
+  if (body.updates !== void 0 && (typeof body.updates !== "string" || !body.updates || body.updates.length > 100)) {
+    return `An app's "updates" is the key of the app it replaces`;
+  }
   if (!Array.isArray(body.needs) || body.needs.length === 0 || body.needs.length > MAX_APP_COLLECTIONS) {
     return `An app needs 1\u2013${MAX_APP_COLLECTIONS} collections`;
   }
@@ -13031,9 +13035,25 @@ function reviewApp(body, collections) {
   });
   return { needs, added: needs.every((need) => need.status === "same"), problem: null };
 }
+function supersededApps(records, collections) {
+  const replaces = /* @__PURE__ */ new Map();
+  for (const record of records) {
+    if (record.body?.updates && record.body.updates !== record.key) replaces.set(record.key, record.body.updates);
+  }
+  const superseded = /* @__PURE__ */ new Set();
+  for (const record of records) {
+    if (!record.body || !reviewApp(record.body, collections).added) continue;
+    for (let key3 = replaces.get(record.key); key3 && !superseded.has(key3) && key3 !== record.key; key3 = replaces.get(key3)) superseded.add(key3);
+  }
+  return superseded;
+}
 async function proposeApp(node, spaceId, body) {
   const problem = checkApp(body);
   if (problem) throw new Error(problem);
+  if (body.updates) {
+    const replaced = await node.records.get(spaceId, body.updates);
+    if (!replaced || replaced.collection !== app.name) throw new Error(`"updates" names no app in this space: ${body.updates}`);
+  }
   return node.records.put(spaceId, app.name, body);
 }
 
@@ -13280,7 +13300,7 @@ var NODE_ACTIONS = Object.freeze([
   },
   {
     name: "apps_list",
-    description: 'The apps proposed in a space: each with its title, who proposed it (viaAgent when an agent did), and for every collection it needs whether it is new, already there, or would change one \u2014 with what it allows, worked out from its rules. "added" is true once a person has added it.',
+    description: 'The apps proposed in a space: each with its title, who proposed it (viaAgent when an agent did), and for every collection it needs whether it is new, already there, or would change one \u2014 with what it allows, worked out from its rules. "added" is true once a person has added it. "updates" names the app it is a new version of; "superseded" is true once a newer version of it has been added, so it is only history.',
     input: { type: "object", properties: { space }, required: ["space"] },
     readOnly: true,
     peerContent: true,
@@ -13288,6 +13308,7 @@ var NODE_ACTIONS = Object.freeze([
       const spaceId = str(input, "space");
       const collections = await node.collections.list(spaceId);
       const found = await node.records.list(spaceId, { collection: app.name });
+      const superseded = supersededApps(found, collections);
       return found.map((record) => {
         const review = record.body ? reviewApp(record.body, collections) : null;
         return {
@@ -13297,7 +13318,9 @@ var NODE_ACTIONS = Object.freeze([
           proposedBy: record.createdBy,
           ...record.viaAgent ? { viaAgent: true } : {},
           ...record.body && appScreen(record.body) ? { screen: appScreen(record.body).collection } : {},
+          ...record.body?.updates ? { updates: record.body.updates } : {},
           added: review?.added ?? false,
+          superseded: superseded.has(record.key),
           problem: review?.problem ?? (record.body ? null : "It could not be read"),
           needs: review?.needs.map(({ definition, status, summary, changes }) => ({ name: definition.name, status, summary, changes })) ?? []
         };
@@ -13313,13 +13336,14 @@ var NODE_ACTIONS = Object.freeze([
   },
   {
     name: "apps_propose",
-    description: `Propose an app in a space: a new way for its people to work together \u2014 a carpool, a sign-up sheet, a decision log. Give it a title, a line on what it is for, and the collections it needs, each exactly as collections_define takes it (name, title, description, schema, links, permissions, rules \u2014 no version). Nothing is defined yet: everyone in the space sees the proposal, with what it allows worked out from its rules, and a person who may define collections adds it. Read collections_list first and reuse what the space already has (std.poll, std.task\u2026) rather than inventing a twin. For anything plain lists and forms can't show \u2014 a game board, a calendar, a whiteboard \u2014 give the main collection a "screen": its own HTML UI (one document, inline scripts and styles, no network unless the collection names exact origins in "network"). Inside it, use exactly: weave.me ({ did, name }), await weave.list("<collection>", { where: { "link:<rel>": key } }), await weave.put("<collection>", body, { links: [{ rel, to: key }] }), await weave.update(key, body), await weave.remove(key), weave.onChange(redraw). Records are { key, body, links, createdBy, mine }. Read apps_screen_guide for the rest. Returns what each collection will allow; tell the person that, not your own description.`,
+    description: `Propose an app in a space: a new way for its people to work together \u2014 a carpool, a sign-up sheet, a decision log. Give it a title, a line on what it is for, and the collections it needs, each exactly as collections_define takes it (name, title, description, schema, links, permissions, rules \u2014 no version). Nothing is defined yet: everyone in the space sees the proposal, with what it allows worked out from its rules, and a person who may define collections adds it. Read collections_list first and reuse what the space already has (std.poll, std.task\u2026) rather than inventing a twin. To change an app that is already here, read apps_list and pass the key of its newest version, the one not superseded, as "updates": the change then shows as an update to it, and once it is added the old version is not offered again. For anything plain lists and forms can't show \u2014 a game board, a calendar, a whiteboard \u2014 give the main collection a "screen": its own HTML UI (one document, inline scripts and styles, no network unless the collection names exact origins in "network"). Inside it, use exactly: weave.me ({ did, name }), await weave.list("<collection>", { where: { "link:<rel>": key } }), await weave.put("<collection>", body, { links: [{ rel, to: key }] }), await weave.update(key, body), await weave.remove(key), weave.onChange(redraw). Records are { key, body, links, createdBy, mine }. Read apps_screen_guide for the rest. Returns what each collection will allow; tell the person that, not your own description.`,
     input: {
       type: "object",
       properties: {
         space,
         title: { type: "string", description: 'What people will call it, e.g. "Carpool"' },
         description: { type: "string", description: "What it is for, in a sentence" },
+        updates: { type: "string", description: "The key of the app this is a new version of, from apps_list" },
         needs: {
           type: "array",
           description: "Collection definitions, as collections_define takes them \u2014 without version",
@@ -13334,6 +13358,7 @@ var NODE_ACTIONS = Object.freeze([
       const body = {
         title: str(input, "title"),
         ...typeof input.description === "string" ? { description: input.description } : {},
+        ...typeof input.updates === "string" ? { updates: input.updates } : {},
         needs: input.needs
       };
       const problem = checkApp(body);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weaveprotocol/cli",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "The Weave protocol from a terminal: manage spaces, run an always-on node, serve MCP to agents",
   "type": "module",
   "bin": {