sfora-cli 0.5.0 → 0.6.0

package/dist/SforaFs.js

@@ -73,6 +73,9 @@ function classify(path) {
         if (seg.length === 2)
             return { kind: "projectDir", slug };
         const dir = seg[2];
+        if (dir === "links.md" && seg.length === 3) {
+            return { kind: "linksFile", slug };
+        }
         if (dir === "posts" || dir === "drafts") {
             if (seg.length === 3)
                 return { kind: "postsDir", slug, dir };
@@ -276,6 +279,13 @@ export class SforaFs {
                 catch (e) {
                     throw fromApi(e, "open", normalize(path));
                 }
+            case "linksFile":
+                try {
+                    return await this.#client.getProjectLinks(loc.slug);
+                }
+                catch (e) {
+                    throw fromApi(e, "open", normalize(path));
+                }
             case "root":
             case "projectsDir":
             case "inboxDir":
@@ -306,6 +316,15 @@ export class SforaFs {
         if (loc.kind === "inboxFile" || loc.kind === "meFile") {
             throw eacces("open", norm);
         }
+        if (loc.kind === "linksFile") {
+            try {
+                await this.#client.setProjectLinks(loc.slug, toText(content));
+            }
+            catch (e) {
+                throw fromApi(e, "open", norm);
+            }
+            return;
+        }
         if (loc.kind === "root" ||
             loc.kind === "projectsDir" ||
             loc.kind === "inboxDir" ||
@@ -416,6 +435,10 @@ export class SforaFs {
                 case "inboxFile":
                 case "meFile":
                     return this.#fileStat(new Date());
+                case "linksFile":
+                    if (!(await this.#projectExists(loc.slug)))
+                        throw enoent("stat", norm);
+                    return this.#fileStat(new Date());
                 case "projectDir":
                 case "postsDir":
                 case "boardDir":
@@ -489,6 +512,7 @@ export class SforaFs {
                     return [
                         dirent("board", true),
                         dirent("drafts", true),
+                        dirent("links.md", false),
                         dirent("posts", true),
                     ];
                 case "postsDir": {

package/dist/api-client.d.ts

@@ -75,6 +75,10 @@ export declare class SforaApiClient {
         slug: string;
         name: string;
     }>;
+    /** `GET …/links.md` — the project's external links as markdown. */
+    getProjectLinks(slug: string): Promise<string>;
+    /** `PUT …/links.md` — replace the project's links from a markdown list. */
+    setProjectLinks(slug: string, markdown: string): Promise<void>;
     /**
      * `GET …/posts` or `…/drafts`. `scheduled` lists drafts that have a
      * (future) `scheduledFor` set.

package/dist/api-client.js

@@ -90,6 +90,14 @@ export class SforaApiClient {
         const res = await this.#request("POST", "/v1/fs/projects", JSON.stringify({ name }));
         return (await res.json());
     }
+    /** `GET …/links.md` — the project's external links as markdown. */
+    async getProjectLinks(slug) {
+        return this.#text(`/v1/fs/projects/${encodeURIComponent(slug)}/links.md`);
+    }
+    /** `PUT …/links.md` — replace the project's links from a markdown list. */
+    async setProjectLinks(slug, markdown) {
+        await this.#request("PUT", `/v1/fs/projects/${encodeURIComponent(slug)}/links.md`, markdown);
+    }
     /**
      * `GET …/posts` or `…/drafts`. `scheduled` lists drafts that have a
      * (future) `scheduledFor` set.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sfora-cli",
-  "version": "0.5.0",
+  "version": "0.6.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": [