sfora-cli 0.8.0 → 0.10.0

package/dist/local/workspace.js

@@ -19,20 +19,111 @@ import { join, dirname, resolve } from "node:path";
 import { parseMarkdownCard, cardFilename, numberFromFilename, columnSlugFromDirname, parseMarkdownPost, parseMarkdownNote, noteFilename, slugify, } from "../format/index.js";
 /** Directory name that marks a local sfora workspace. */
 export const WORKSPACE_DIR = ".sfora";
-const DEFAULT_COLUMNS = ["01-todo", "02-in-progress", "03-done"];
+// One Flow: every board is the same four fixed stage columns, matching the cloud
+// byte-for-byte, so `cp` stays a migration. There is no column management.
+const DEFAULT_COLUMNS = [
+    "01-triage",
+    "02-todo",
+    "03-in-progress",
+    "04-done",
+];
+// Map a legacy column slug → its stage dir. Mirrors the server's migrateStages
+// name-mapping; anything unrecognized falls to "02-todo" (with the old name kept
+// as a label so the lane isn't lost).
+const STAGE_DIR_BY_SLUG = {
+    triage: "01-triage",
+    undecided: "01-triage",
+    someday: "01-triage",
+    icebox: "01-triage",
+    todo: "02-todo",
+    "to-do": "02-todo",
+    "in-progress": "03-in-progress",
+    doing: "03-in-progress",
+    wip: "03-in-progress",
+    working: "03-in-progress",
+    done: "04-done",
+    complete: "04-done",
+    completed: "04-done",
+    shipped: "04-done",
+};
 const WORKSPACE_README = `# sfora workspace
 
 Everything here is a plain markdown file — edit with any tool, version with git.
 
-- \`board/<column>/NNNN-<slug>.md\` — tasks. Frontmatter: \`status\`, \`priority\`,
-  \`labels\`, \`assignees\`, \`due\`. Move a task by moving the file between column
-  directories (\`mv\` works).
+- \`board/<column>/NNNN-<slug>.md\` — tasks. Every board is the same four fixed
+  columns — \`01-triage / 02-todo / 03-in-progress / 04-done\`. Move a task by
+  moving the file between column dirs (\`mv\` works); moving into \`04-done\`
+  marks it done. Frontmatter: \`status\`, \`priority\`, \`labels\`, \`assignees\`, \`due\`.
 - \`posts/YYYY-MM-DD-<slug>.md\` — posts. An H1 (\`# Title\`) is the title.
 - \`docs/<slug>.md\` — docs.
 
 Create files by hand, or use the CLI: \`sfora task plan.md\`, \`sfora post note.md\`.
 Same format as sfora cloud — \`sfora login\` connects this workspace to a team.
 `;
+// Surgically add a label to a card's YAML frontmatter without reformatting the
+// rest of the file (local files are hand-edited; we don't round-trip them).
+function addLabelToCard(md, label) {
+    const fm = /^---\n([\s\S]*?)\n---\n?/.exec(md);
+    if (!fm)
+        return `---\nlabels: [${label}]\n---\n\n${md}`;
+    const block = fm[1];
+    const labelLine = /^labels:\s*\[(.*)\]\s*$/m.exec(block);
+    if (labelLine) {
+        const items = labelLine[1]
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean);
+        if (items.includes(label))
+            return md;
+        const replaced = block.replace(labelLine[0], `labels: [${[...items, label].join(", ")}]`);
+        return md.replace(block, replaced);
+    }
+    return md.replace(block, `${block}\nlabels: [${label}]`);
+}
+/**
+ * Migrate an existing workspace's board onto the four fixed stage dirs (One
+ * Flow). Idempotent: a board already in the canonical shape is left untouched.
+ * Legacy columns are mapped by name (done→done, in progress→doing, triage/
+ * undecided/…→triage, else todo); each card file MOVES into its stage dir, and
+ * a card leaving an unrecognized column keeps that column's name as a label so
+ * nothing is lost. Called on open so old \`.sfora/\` dirs reshape silently.
+ */
+export async function migrateWorkspaceStages(root) {
+    const boardDir = join(root, "board");
+    const entries = await readdir(boardDir, { withFileTypes: true }).catch(() => []);
+    const dirs = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    if (dirs.length === 0)
+        return { migrated: false, moved: 0 };
+    const isCanonical = dirs.length === DEFAULT_COLUMNS.length &&
+        DEFAULT_COLUMNS.every((d) => dirs.includes(d));
+    if (isCanonical)
+        return { migrated: false, moved: 0 };
+    for (const d of DEFAULT_COLUMNS) {
+        await mkdir(join(boardDir, d), { recursive: true });
+    }
+    let moved = 0;
+    for (const oldDir of dirs) {
+        if (DEFAULT_COLUMNS.includes(oldDir))
+            continue; // canonical dir stays put
+        const slug = columnSlugFromDirname(oldDir);
+        const canonical = STAGE_DIR_BY_SLUG[slug];
+        const target = canonical ?? "02-todo";
+        const files = await readdir(join(boardDir, oldDir)).catch(() => []);
+        for (const f of files) {
+            if (!f.endsWith(".md"))
+                continue;
+            const src = join(boardDir, oldDir, f);
+            let md = await readFile(src, "utf8");
+            if (!canonical)
+                md = addLabelToCard(md, slug); // preserve the old lane
+            await writeFile(join(boardDir, target, f), md, "utf8");
+            await rm(src);
+            moved++;
+        }
+        await rm(join(boardDir, oldDir), { recursive: true, force: true }).catch(() => { });
+    }
+    return { migrated: true, moved };
+}
 /**
  * Walk up from `cwd` looking for a `.sfora/` workspace. A directory only
  * counts when it has workspace markers (board/posts/docs) — `~/.sfora` is also
@@ -194,8 +285,8 @@ export class LocalWorkspace {
     // ─── Internals ───────────────────────────────────────────────────
     /**
      * Resolve a column reference (slug or name, e.g. "todo" / "In progress") to
-     * an existing column dirname. With no reference: a closed status prefers a
-     * done-ish column, otherwise the first column.
+     * an existing column dirname. With no reference: a closed status prefers the
+     * done column, otherwise "To do" (new work is up for grabs, not in triage).
      */
     async #resolveColumn(ref, status) {
         const columns = await this.listColumns();
@@ -217,7 +308,9 @@ export class LocalWorkspace {
             if (done)
                 return done;
         }
-        return columns[0];
+        // Default target is "To do" (02-todo), not the leading triage column.
+        const todo = columns.find((c) => columnSlugFromDirname(c) === "todo");
+        return todo ?? columns[0];
     }
     async #nextNumber() {
         let max = 0;

package/dist/mcp-server.js

@@ -13,18 +13,24 @@ import { createSforaShell, createLocalShell } from "./index.js";
 const TOOL_DESCRIPTION = `Run a bash command against the sfora workspace — a Unix-style view where every post, task, and doc is a markdown file:
   - /projects/<slug>/posts/<file>.md            published posts
   - /projects/<slug>/drafts/<file>.md           your drafts
-  - /projects/<slug>/board/<NN-col>/<NNNN>.md   tasks (kanban cards), by column
-  - /projects/<slug>/docs/<file>.md             docs / notes
+  - /projects/<slug>/board/<NN-stage>/<NNNN>.md tasks (kanban cards), by stage
+  - /projects/<slug>/library/documents/<file>.md workspace documents (writable)
+  - /projects/<slug>/library/files/<file>        uploaded files (read-only)
+  - /projects/<slug>/library/repositories/<repo> project source trees (read-only)
   - /projects/<slug>/pulls/<number>.md          pull requests (diff + linked work), read-only
+  - /projects/<slug>/plan.md                    the goal + open questions (write to set the goal)
+  - /projects/<slug>/asks.md                    coordination asks, read-only
   - /inbox/mentions.md                          unread mentions
   - /me/api-key                                 your identity
-Examples: 'ls /projects', 'cat /projects/web/board/01-todo/*.md', 'grep -ri TODO /projects', 'echo "# Fix login\\nstatus: active" > /projects/web/board/01-todo/fix.md'.
+Every board is the same four fixed columns — 01-triage / 02-todo / 03-in-progress / 04-done. There is no column management; move a card into 04-done to close it. Question cards (kind: question) map their stage to the plan: triage = fuzzy, todo = up for grabs, in-progress = claimed, done = decided.
+Examples: 'ls /projects', 'cat /projects/web/board/02-todo/*.md', 'grep -ri TODO /projects', 'echo "# Fix login\\nstatus: active" > /projects/web/board/02-todo/fix.md', 'mv /projects/web/board/02-todo/0003-*.md /projects/web/board/04-done/'.
 Write a file to create or update the entity (frontmatter sets fields like status/priority/assignees/due). cwd and environment persist across calls.`;
 const LOCAL_TOOL_DESCRIPTION = `Run a bash command against the local sfora workspace (a .sfora/ directory of plain markdown files, git-versioned with the repo):
-  - /board/<NN-col>/<NNNN>-<slug>.md   tasks (kanban cards), by column — 'mv' between column dirs moves a task
+  - /board/<NN-stage>/<NNNN>-<slug>.md tasks (kanban cards), by stage — 'mv' between stage dirs moves a task
   - /posts/<YYYY-MM-DD>-<slug>.md      posts
   - /docs/<slug>.md                    docs / notes
-Examples: 'ls /board/01-todo', 'cat /board/01-todo/*.md', 'grep -ri TODO /', 'echo "# Fix login\\nstatus: active" > /board/01-todo/fix-login.md', 'mv /board/01-todo/0003-*.md /board/03-done/'.
+Every board is the same four fixed columns — 01-triage / 02-todo / 03-in-progress / 04-done. There is no column management; moving a card into 04-done marks it done.
+Examples: 'ls /board/02-todo', 'cat /board/02-todo/*.md', 'grep -ri TODO /', 'echo "# Fix login\\nstatus: active" > /board/02-todo/fix-login.md', 'mv /board/02-todo/0003-*.md /board/04-done/'.
 Frontmatter sets task fields (status/priority/labels/assignees/due). cwd and environment persist across calls.`;
 export async function runMcpServer(options) {
     const { bash } = options.localRoot

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sfora-cli",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "type": "module",
   "description": "Your sfora workspace as a markdown filesystem — a CLI + MCP server. Post/task/doc, ls/cat/grep, and a shell so agents operate sfora natively.",
   "keywords": [
@@ -36,15 +36,16 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc -p .",
-    "dev": "tsx src/cli.ts",
-    "typecheck": "tsc --noEmit"
+    "build": "node scripts/sync-format.mjs && tsc -p .",
+    "dev": "node scripts/sync-format.mjs && tsx src/cli.ts",
+    "typecheck": "node scripts/sync-format.mjs && tsc --noEmit"
   },
   "dependencies": {
-    "just-bash": "^3.0.1",
-    "@modelcontextprotocol/sdk": "^1.0.0"
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "just-bash": "^3.0.1"
   },
   "devDependencies": {
+    "@types/mdast": "^4.0.4",
     "@types/node": "^22.10.0",
     "tsx": "^4.20.3",
     "typescript": "^5.9.3"