sfora-cli 0.4.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/dist/config.d.ts

@@ -8,7 +8,7 @@ export interface SforaConfig {
     }>;
 }
 export declare const CONFIG_PATH: string;
-export declare const DEFAULT_URL = "http://localhost:2222";
+export declare const DEFAULT_URL = "https://www.sfora.ai";
 export declare function readConfig(): Promise<SforaConfig>;
 export declare function writeConfig(cfg: SforaConfig): Promise<string>;
 export interface ResolvedSettings {

package/dist/config.js

@@ -8,7 +8,9 @@ import { join } from "node:path";
 import { readFile, writeFile, mkdir, chmod } from "node:fs/promises";
 const CONFIG_DIR = join(homedir(), ".sfora");
 export const CONFIG_PATH = join(CONFIG_DIR, "config.json");
-export const DEFAULT_URL = "http://localhost:2222";
+// Production sfora. Local development of sfora itself overrides via --url or
+// SFORA_URL (e.g. the dev Convex .site host).
+export const DEFAULT_URL = "https://www.sfora.ai";
 export async function readConfig() {
     try {
         const raw = await readFile(CONFIG_PATH, "utf8");

package/package.json

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