drafted 1.19.32 → 1.19.33

package/mcp/server.mjs

@@ -3384,14 +3384,14 @@ tool('fs', 'Navigate Drafted like a local filesystem. A FOLDER is the single con
           : (note ? note.trimStart() : '');
       });
 
-      // Which of these hits are read-only in Drafted. A git-owned folder's wiki
-      // and skills answer 409 repo_owned on write, and nothing else in the
-      // output distinguishes them from an ordinary path — the failure lands at
-      // write time, after the edit is composed.
+      // Which of these hits are read-only in Drafted, and precisely which part.
+      // A link makes the folder's WIKI and SKILLS git-owned (409 repo_owned on
+      // write); its TASKS and PROJECTS write normally. Naming the folder alone
+      // would tell an agent not to attempt a frame write it is entitled to make.
       const linked = (Array.isArray(repos.v?.repos) ? repos.v.repos : [])
         .map(r => `${r.folderName ? r.folderName : '(org root)'} → ${r.slug}@${r.branch}`);
       if (linked.length) {
-        out.push(`Git-owned (edits are commits, not fs writes): ${linked.join('; ')}`);
+        out.push(`Git-owned WIKI + SKILLS (edit those via commit; tasks + projects write normally): ${linked.join('; ')}`);
       }
 
       const searched = orgFromPath || org || null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.19.32",
+  "version": "1.19.33",
   "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/folder-path.mjs

@@ -120,10 +120,16 @@ export function liftFolderScope(path, to) {
  * org's folder names (each of which is its full path). One segment deeper only —
  * `ls` shows a level, not a tree.
  */
-/** `repoOf(fullFolderName)` -> "slug@branch" when git owns that folder, else
- *  null. A git-owned folder's wiki and skills answer 409 repo_owned on write,
- *  and without this the listing renders it identically to a writable one — the
- *  agent finds out at write time, after composing the edit. */
+/** `repoOf(fullFolderName)` -> "slug@branch" when a repo is linked to that
+ *  folder, else null.
+ *
+ *  SAY WHAT IS OWNED, NOT "THE FOLDER". A link makes the folder's WIKI and
+ *  SKILLS git-owned — those answer 409 repo_owned on write. Its TASKS and
+ *  PROJECTS are untouched and write normally (verified: a frame write into a
+ *  project inside a linked folder succeeds). A bare "GIT-OWNED" on the folder
+ *  overclaims, and an agent that believes it will not attempt a frame write it
+ *  is perfectly entitled to make — a false negative costs more here than the
+ *  409 it was meant to prevent. */
 export function subfolderEntries(base, prefix, names, repoOf = null) {
   const depth = prefix ? normalizeFolder(prefix).split('/').length : 0;
   const kids = new Set();
@@ -142,7 +148,7 @@ export function subfolderEntries(base, prefix, names, repoOf = null) {
       type: 'directory',
       path: `${String(base || '').replace(/\/+$/, '')}/${name}`,
       hint: repo
-        ? `folder — carries its own wiki, skills, tasks and projects · GIT-OWNED by ${repo} (edits are commits)`
+        ? `folder — carries its own wiki, skills, tasks and projects · wiki + skills GIT-OWNED by ${repo} (edit those via commit); tasks + projects write normally`
         : 'folder — carries its own wiki, skills, tasks and projects',
     };
   });