passalong 1.6.0 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "passalong",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Work, projects, documents and files for a team and its agents: take work, hand it in with evidence, and keep what the team knows in its projects.",
   "mcpName": "io.github.codellyson/passalong",
   "keywords": [

package/src/api.js

@@ -261,8 +261,9 @@ export const removeMember = (slug, who) =>
 export const join = (code) =>
   call(`/v1/invites/${encodeURIComponent(code)}/accept`, { method: "POST" });
 
-export const projects = (scope = "all", query = "") =>
-  call(`/v1/projects${q({ scope, q: query })}`);
+// `brief`: id, title, repos and counts, which is what an agent listing every project needs.
+export const projects = (scope = "all", query = "", brief = false) =>
+  call(`/v1/projects${q({ scope, q: query, ...(brief ? { brief: "1" } : {}) })}`);
 export const createProject = (
   title,
   description = "",
@@ -270,8 +271,12 @@ export const createProject = (
   parent = "",
   color = "",
   repo = "",
+  repos = undefined,
 ) =>
-  call("/v1/projects", { method: "POST", body: { title, description, team, parent, color, repo } });
+  call("/v1/projects", {
+    method: "POST",
+    body: { title, description, team, parent, color, repo, ...(repos ? { repos } : {}) },
+  });
 export const project = (id) => call(`/v1/projects/${encodeURIComponent(id)}`);
 export const updateProject = (id, changes) =>
   call(`/v1/projects/${encodeURIComponent(id)}`, { method: "PATCH", body: changes });

package/src/mcp.js

@@ -758,7 +758,8 @@ export function buildServer() {
       description:
         "With `id`, one project: its documents, files and the projects inside it. With `query`, " +
         "the projects whose name, description or any document mentions those words, each naming " +
-        "its matching documents. With neither, every project you can see. Each answer's `space` " +
+        "its matching documents. With neither, every project you can see, briefly: id, title, " +
+        "repos and how much is in it; ask for one by `id` for the rest. Each answer's `space` " +
         'says where it lives: private, or a named team; `repo` is the repo it is built from, "" ' +
         "when it has none. Read that repo when you write or check its documents.",
       inputSchema: {
@@ -768,7 +769,8 @@ export function buildServer() {
       },
     },
     run(({ id, query, scope }) =>
-      id ? api.project(id) : api.projects(scope || "all", query || ""),
+      // Listing everything is brief; a search keeps the documents that matched.
+      id ? api.project(id) : api.projects(scope || "all", query || "", !query),
     ),
   );
 
@@ -779,9 +781,12 @@ export function buildServer() {
       annotations: ADDS,
       description:
         "With no `id`, make a project, after find_projects shows none fits: a `title` and a short " +
-        "`description`, and its `repo` when it has one. Leave out `team` for a private one, and " +
+        "`description`, and its `repo` when it has one, or `repos` when it is built from several " +
+        "(a web app, its API, its mobile app: one product, one project). Leave out `team` for a " +
+        "private one, and " +
         "pass a team slug only when the person wants it shared; `parent` puts it inside another, " +
         'in that one\'s space. With `id`, change its title, description, repo ("" for none), ' +
+        "repos (the whole list, the main one first), " +
         'colour or place (`parent` "" for the top level); ' +
         "its space never changes. The answer's `space` says where it is: tell the person.",
       inputSchema: {
@@ -795,9 +800,16 @@ export function buildServer() {
           .string()
           .optional()
           .describe('the repo it is built from, e.g. github.com/acme/billing; "" for none'),
+        repos: z
+          .array(z.string())
+          .optional()
+          .describe(
+            "every repo it is built from, the main one first; replaces the list. Work written in " +
+              "any of them is filed in this project and its agents read this project's README",
+          ),
       },
     },
-    run(({ id, title, description, team, parent, color, repo }) => {
+    run(({ id, title, description, team, parent, color, repo, repos }) => {
       if (!id) {
         if (!title) throw new Error("a new project needs a `title`");
         return api.createProject(
@@ -807,11 +819,12 @@ export function buildServer() {
           parent || "",
           color || "",
           repo || "",
+          repos,
         );
       }
       if (team) throw new Error("a project's space does not change; leave out `team`");
       const changes = Object.fromEntries(
-        Object.entries({ title, description, parent, color, repo }).filter(
+        Object.entries({ title, description, parent, color, repo, repos }).filter(
           ([, v]) => v !== undefined,
         ),
       );
@@ -853,7 +866,11 @@ export function buildServer() {
         "(a newer edit is refused, so nobody\'s writing is lost) and/or `name` to rename it, " +
         "and/or `move_to` another project in the same space. Its id and history stay. Update the " +
         "page that already covers something rather than adding another. A document has no owner " +
-        "and no state and tells nobody: anything someone must still act on is work (create_work).",
+        "and no state and tells nobody: anything someone must still act on is work (create_work). " +
+        "The README is special: an agent taking work in the project is shown its first 4,000 " +
+        "characters. Put there what it must know before changing anything (what this is, the " +
+        "rules not to break, the words used, where things are) and the detail on other pages, " +
+        "named in it. Refer to other pages by their names, not file names.",
       inputSchema: {
         project: z.string().describe("project id"),
         document: z.string().optional().describe("the document to change; leave out for a new one"),

package/src/passalong.js

@@ -758,15 +758,23 @@ export function projectsNote(projects) {
   if (!Array.isArray(projects) || !projects.length) return "";
   const blocks = projects.map((p) => {
     const name = p.title || p.id;
-    const where = `${name} (${p.id})${p.repo ? `, built from ${p.repo}` : ""}`;
+    const repos = p.repos?.length ? p.repos : p.repo ? [p.repo] : [];
+    const where = `${name} (${p.id})${repos.length ? `, built from ${repos.join(", ")}` : ""}`;
     const about = p.description ? ` ${p.description}` : "";
+    // A README cut short says so before it starts, and ends with an instruction rather than a
+    // pointer: agents took "it goes on" as optional and worked from the part they had (2026-11-07).
     const lead = p.readme
       ? `WHAT TO KNOW FIRST: this work is filed in the project ${where}.${about} Its README is ` +
-        "below: read it before you start."
+        (p.readme.cut
+          ? "below, cut short: read all of it before you start."
+          : "below: read it before you start.")
       : `WHAT TO KNOW FIRST: this work is filed in the project ${where}.${about} It has no README yet.`;
     const readme = p.readme
       ? `\n\n--- README of ${name}: document ${p.readme.id} ---\n${p.readme.body.trimEnd()}\n` +
-        (p.readme.cut ? `…it goes on: read_document ${p.readme.id} for the rest.\n` : "")
+        (p.readme.cut
+          ? `--- The README goes on past this point. Before you start, read the rest: read_document ` +
+            `project ${p.id}, document ${p.readme.id}. ---\n`
+          : "")
       : "\n";
     const docs = p.documents?.length
       ? "Its other documents: open the ones that bear on this with read_document: " +