drafted 1.19.38 → 1.19.40

package/mcp/server.mjs

@@ -1653,6 +1653,7 @@ async function resolveProjectArg(projectArg, { required = true } = {}) {
  *   /projects/<folder>/<project>/<layer>/<lane>/<file>
  *   /projects/<project>/<layer>/<file>          (layer-root file)
  *   /o/<org>/projects/<project>/<layer>/<lane>/<file>  (URL form)
+ *   /o/<org>[/<folder>]/tasks/<lane?>/<file> | /tasks/...  (tasks root)
  *   /f/<uuid> | bare UUID
  * Returns { frameId } or throws with a helpful message.
  */
@@ -1666,6 +1667,19 @@ async function resolveFsFramePath(path) {
   let fsPath = p;
   const urlForm = p.match(/^\/o\/[^/]+\/projects\/(.+)$/);
   if (urlForm) fsPath = '/projects/' + urlForm[1];
+  // Tasks form. This is the address Drafted PRINTS for a task (the /tasks root,
+  // not the system project behind it), so it has to resolve here too — a printed
+  // path that this tool rejects is the worst kind of dead end. Checked after the
+  // /projects form so the raw `/projects/tasks/tasks/...` URL still works.
+  const taskForm = !urlForm && (p.match(/^\/o\/([^/]+)\/(?:(.+?)\/)?tasks\/(.+)$/) || p.match(/^()()\/tasks\/(.+)$/));
+  if (taskForm) {
+    const sys = await api('POST', '/api/tasks/project', { create: false }, {
+      ...(taskForm[1] ? { 'X-Drafted-Org': decodeURIComponent(taskForm[1]) } : {}),
+      ...(taskForm[2] ? { 'X-Drafted-Folder': taskForm[2] } : {}),
+    }).catch((e) => (e.status === 404 ? null : Promise.reject(e)));
+    if (!sys?.id) throw new Error(`Not found: ${path} — this org has no tasks yet.`);
+    fsPath = `/projects/${sys.id}/tasks/${taskForm[3]}`;
+  }
   if (!fsPath.startsWith('/projects')) {
     throw new Error('Target must be a frame URL, frame ID, or path /projects/<project>/<layer>/<lane>/<file>');
   }
@@ -3254,7 +3268,7 @@ server.resource('info', 'drafted://info', {
   };
 });
 
-tool('fs', 'Navigate Drafted like a local filesystem. A FOLDER is the single container and the org is the folder at depth 0: `fs(ls, path="/")` lists the orgs you can address, `/o/<org>` is that org, and every folder level — the org included — carries the SAME four roots:\n\n- `<folder>/wiki/<path>` — knowledge pages (markdown, OKF; free nesting; `index.md` at any level is synthesized and read-only)\n- `<folder>/skills/<slug>` — reusable procedures (flat: one dir per skill slug, `SKILL.md` + supporting files inside; slugs stay unique per ORG, so a skill resolves by slug from anywhere)\n- `<folder>/tasks/<lane?>/<file>` — work items. A task IS a frame: `read` renders its `drafted:status:`/`drafted:assignee:` as front matter and `write`/`edit` parse them back into columns, so they are never stored in the body. The keys are namespaced so an ordinary `status:` in your own front matter is left alone. Valid statuses: open, in_progress, scheduled, needs_review, needs_decision, done, failed (an empty `drafted:status:` clears it). Status is a column, not a location — a task moved out of /tasks stays a task.\n- `<folder>/projects/<project>/<layer>/<lane>/<file>` — producible frames (then exactly layer → lane → file)\n\nFolders nest arbitrarily: `/o/<org>/engineering/backend/wiki/deploy`. The ROOT KEYWORD IS THE SEPARATOR — everything before `wiki`/`skills`/`tasks`/`projects` is the folder chain, everything after is the path inside that root, so `/o/<org>/wiki/engineering/foo` (the org wiki, nested page) and `/o/<org>/engineering/wiki/foo` (the engineering folder\'s wiki) are different pages. The four names are therefore RESERVED: a folder cannot be called one. `fs(ls, path="/o/<org>/<folder>")` shows a folder\'s four roots plus the folders inside it; `fs(mkdir, path="/o/<org>/<folder>")` creates one.\n\n(Bare `/wiki`, `/skills`, `/tasks`, `/projects` roots still resolve via the session\'s working org, at that org\'s root.)\n\nVerbs: `ls` (list a directory), `read` (file content — hashline-annotated for text so `edit` stays surgical), `write` (create/overwrite; extension + layer classify the type: .html design, .md document, .excalidraw diagram, .xlsx/.docx office, images/videos media, .pdf asset, .google-doc/.google-sheet/.google-slide create native Google Workspace files), `edit` (hashline ops for text, element ops for excalidraw, structured ops for office), `mv` (rename/move — at THREE scopes, same as `rm`: a FILE path moves one frame; a LANE or LAYER path (`/<layer>/<lane>`, `/<layer>`) moves the whole set in one call, in-project or into another project, carrying frame ids, version history, connectors and assets; a PROJECT path (`/o/<org>/projects/<project>`) renames the project, with `to` as the new display name — the slug and every existing URL stay put), `rm` (delete), `search` (frames are searched by label AND content, with the matching line returned as a snippet; `fs(search, path="/o/<org>")` fans out across wiki + skills + projects in one call. SEARCH MUST NAME ITS ORG — put it in the path, or pass org=. If you belong to more than one org an unaddressed search is REFUSED rather than silently scoped, because "no matches" from one org is indistinguishable from "nowhere" and you would stop looking. Search several orgs with one call each; every result says which org it came from), `link` / `unlink` / `links` (relate one frame to another frame, to a project, or to an external url — `links` lists a frame\'s edges plus its backlinks, and on a project path lists the tasks linked to that project; a link is stored by ID, so `mv` never breaks it). `mkdir` creates a project only: use `/projects/<project>` or `/projects/<folder>/<project>`, never a layer path. To create a layer, write its first frame at `/projects/<project>/<new-layer>/<lane>/<file>`.\n\nThe project is resolved from the path itself — no separate "open" step. Guardrails are server-side and unchanged: the org in the path must be the project\'s own org (project paths under /o/<org>/ validate it), the G1 wiki-search gate fires before project mutations, attached-skill gates fire on mutations, anchored frames must be read before editing a layer, `.skillinstall/` is stripped on skill push.', {
+tool('fs', 'Navigate Drafted like a local filesystem. A FOLDER is the single container and the org is the folder at depth 0: `fs(ls, path="/")` lists the orgs you can address, `/o/<org>` is that org, and every folder level — the org included — carries the SAME four roots:\n\n- `<folder>/wiki/<path>` — knowledge pages (markdown, OKF; free nesting; `index.md` at any level is synthesized and read-only)\n- `<folder>/skills/<slug>` — reusable procedures (flat: one dir per skill slug, `SKILL.md` + supporting files inside; slugs stay unique per ORG, so a skill resolves by slug from anywhere)\n- `<folder>/tasks/<lane?>/<file>` — work items. A task IS a frame: `read` renders its `drafted:status:`/`drafted:assignee:` as front matter and `write`/`edit` parse them back into columns, so they are never stored in the body. The keys are namespaced so an ordinary `status:` in your own front matter is left alone. Valid statuses: open, in_progress, scheduled, needs_review, needs_decision, done, failed (an empty `drafted:status:` clears it). Status is a column, not a location — a task moved out of /tasks stays a task. `read` also projects `drafted:id:` (BEO-42), the org-scoped handle a human says out loud: READ-ONLY and server-allocated, so writing or inventing one is silently dropped rather than stored. Quote it back to the user; it resolves at /o/<org>/t/<id> and survives a rename or a move.\n- `<folder>/projects/<project>/<layer>/<lane>/<file>` — producible frames (then exactly layer → lane → file)\n\nFolders nest arbitrarily: `/o/<org>/engineering/backend/wiki/deploy`. The ROOT KEYWORD IS THE SEPARATOR — everything before `wiki`/`skills`/`tasks`/`projects` is the folder chain, everything after is the path inside that root, so `/o/<org>/wiki/engineering/foo` (the org wiki, nested page) and `/o/<org>/engineering/wiki/foo` (the engineering folder\'s wiki) are different pages. The four names are therefore RESERVED: a folder cannot be called one. `fs(ls, path="/o/<org>/<folder>")` shows a folder\'s four roots plus the folders inside it; `fs(mkdir, path="/o/<org>/<folder>")` creates one.\n\n(Bare `/wiki`, `/skills`, `/tasks`, `/projects` roots still resolve via the session\'s working org, at that org\'s root.)\n\nVerbs: `ls` (list a directory), `read` (file content — hashline-annotated for text so `edit` stays surgical), `write` (create/overwrite; extension + layer classify the type: .html design, .md document, .excalidraw diagram, .xlsx/.docx office, images/videos media, .pdf asset, .google-doc/.google-sheet/.google-slide create native Google Workspace files), `edit` (hashline ops for text, element ops for excalidraw, structured ops for office), `mv` (rename/move — at THREE scopes, same as `rm`: a FILE path moves one frame; a LANE or LAYER path (`/<layer>/<lane>`, `/<layer>`) moves the whole set in one call, in-project or into another project, carrying frame ids, version history, connectors and assets; a PROJECT path (`/o/<org>/projects/<project>`) renames the project, with `to` as the new display name — the slug and every existing URL stay put), `rm` (delete), `search` (frames are searched by label AND content, with the matching line returned as a snippet; `fs(search, path="/o/<org>")` fans out across wiki + skills + projects in one call. SEARCH MUST NAME ITS ORG — put it in the path, or pass org=. If you belong to more than one org an unaddressed search is REFUSED rather than silently scoped, because "no matches" from one org is indistinguishable from "nowhere" and you would stop looking. Search several orgs with one call each; every result says which org it came from), `link` / `unlink` / `links` (relate one frame to another frame, to a project, or to an external url — `links` lists a frame\'s edges plus its backlinks, and on a project path lists the tasks linked to that project; a link is stored by ID, so `mv` never breaks it). `mkdir` creates a project only: use `/projects/<project>` or `/projects/<folder>/<project>`, never a layer path. To create a layer, write its first frame at `/projects/<project>/<new-layer>/<lane>/<file>`.\n\nThe project is resolved from the path itself — no separate "open" step. Guardrails are server-side and unchanged: the org in the path must be the project\'s own org (project paths under /o/<org>/ validate it), the G1 wiki-search gate fires before project mutations, attached-skill gates fire on mutations, anchored frames must be read before editing a layer, `.skillinstall/` is stripped on skill push.', {
   action: z.enum(['ls', 'read', 'write', 'edit', 'mv', 'rm', 'mkdir', 'search', 'link', 'unlink', 'links']).describe('Filesystem verb.'),
   path: z.string().describe('Drafted path: /o/<org>[/<folder…>]/wiki/... | .../skills/... | .../tasks/... | .../projects/... — a folder chain may precede any root (bare /wiki, /skills, /tasks, /projects also work; for mv: source)'),
   to: z.string().optional().describe('[mv] destination — a frame path for a frame, a container path (/<layer> or /<layer>/<lane>, optionally prefixed /o/<org>/projects/<other-project>/… to move across projects) for a lane or layer, or the NEW NAME when the source path is a project; [link/unlink] target path — a frame path, or a project path (/o/<org>/projects/<project>) to link a task to a project'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.19.38",
+  "version": "1.19.40",
   "description": "Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.",
   "type": "module",
   "files": [

package/src/shared/task-id.mjs

@@ -0,0 +1,54 @@
+/**
+ * The human-readable task id: BEO-42.
+ *
+ * ONE file knows this format. The server mints it, the tasks view renders it,
+ * the resolver route parses it, and a test pins it — all from here, because a
+ * second implementation of "what does BEO-42 mean" is the two-writers-drift trap
+ * with an identifier on the line.
+ *
+ * Shape: <PREFIX>-<n>. The prefix is letters/digits, stored per org
+ * (organizations.task_prefix). The number is per-org and monotonic
+ * (organizations.next_task_number), so it also sorts by age.
+ */
+
+const FALLBACK_PREFIX = "TASK";
+
+/**
+ * Derive an org's prefix from its name. Called ONCE per org, at first mint; the
+ * result is stored, because re-deriving it would renumber every existing task
+ * the day someone renames the org.
+ *
+ * Letters and digits only, uppercased, first three — "Beoflow" -> BEO,
+ * "Acme Widgets" -> ACM, "3M" -> 3M. A name with nothing usable in it (emoji,
+ * CJK, punctuation) falls back to TASK rather than producing an empty prefix,
+ * because "-42" is not an id.
+ */
+export function taskPrefixFrom(name) {
+  const cleaned = String(name || "")
+    .toUpperCase()
+    .replace(/[^A-Z0-9]/g, "");
+  return cleaned ? cleaned.slice(0, 3) : FALLBACK_PREFIX;
+}
+
+/** Render: ("BEO", 42) -> "BEO-42". Null/0 number means "not a task" -> null. */
+export function formatTaskId(prefix, number) {
+  if (!number || !Number.isFinite(Number(number))) return null;
+  return (prefix || FALLBACK_PREFIX) + "-" + Number(number);
+}
+
+/**
+ * Parse "beo-42", "BEO-42", " BEO-42 " -> { prefix: "BEO", number: 42 }.
+ * Returns null for anything else. Case-insensitive on purpose: this is typed by
+ * a human into a URL or a search box, and rejecting "beo-42" would be a lookup
+ * that fails for the reason nobody guesses.
+ *
+ * The prefix is NOT checked against the org here — the caller does that, because
+ * only the caller knows which org it is resolving in.
+ */
+export function parseTaskId(value) {
+  const m = String(value || "").trim().match(/^([A-Za-z0-9]{1,16})-(\d{1,9})$/);
+  if (!m) return null;
+  const number = Number(m[2]);
+  if (!number) return null;
+  return { prefix: m[1].toUpperCase(), number };
+}