sfora-cli 0.3.0 → 0.5.0

package/README.md

@@ -7,6 +7,7 @@ or `echo >` straight into it. Ships first-class verbs, an interactive shell, and
 an **MCP server** (`--mcp`) so agents in Claude / Cursor operate sfora natively.
 
 ```bash
+sfora new "Acme"                          # create a project
 sfora post plan.md --project acme        # push a markdown plan as a post
 sfora task spec.md --project acme         # …or a task on the board
 sfora cat /projects/acme/board/01-todo/0042-fix-login.md

package/dist/api-client.d.ts

@@ -70,6 +70,11 @@ export declare class SforaApiClient {
     constructor(config: SforaApiConfig);
     /** `GET /v1/fs/projects` */
     listProjects(): Promise<Project[]>;
+    /** `POST /v1/fs/projects` — create a project; the caller becomes its lead. */
+    createProject(name: string): Promise<{
+        slug: string;
+        name: string;
+    }>;
     /**
      * `GET …/posts` or `…/drafts`. `scheduled` lists drafts that have a
      * (future) `scheduledFor` set.

package/dist/api-client.js

@@ -85,6 +85,11 @@ export class SforaApiClient {
         const data = await this.#json("/v1/fs/projects");
         return data.projects;
     }
+    /** `POST /v1/fs/projects` — create a project; the caller becomes its lead. */
+    async createProject(name) {
+        const res = await this.#request("POST", "/v1/fs/projects", JSON.stringify({ name }));
+        return (await res.json());
+    }
     /**
      * `GET …/posts` or `…/drafts`. `scheduled` lists drafts that have a
      * (future) `scheduledFor` set.

package/dist/cli.js

@@ -10,7 +10,7 @@ import * as readline from "node:readline";
 import { spawn } from "node:child_process";
 import { readFile as readLocalFile } from "node:fs/promises";
 import { basename } from "node:path";
-import { createSforaShell } from "./index.js";
+import { createSforaShell, SforaApiClient } from "./index.js";
 import { runMcpServer } from "./mcp-server.js";
 import { readConfig, writeConfig, resolveSettings, DEFAULT_URL, } from "./config.js";
 const colors = {
@@ -89,8 +89,11 @@ Push markdown straight to sfora:
   sfora task <file.md> [--project <slug>] [--column <name>]   Create a task
   sfora doc  <file.md> [--project <slug>]             Create a doc
 
-Browse:
+Projects:
+  sfora new "<name>"                  Create a project
   sfora projects                      List your projects
+
+Browse:
   sfora ls [path]                     List a path (default /projects)
   sfora cat <path>                    Print a file's markdown
   sfora                               Open the interactive shell
@@ -260,14 +263,30 @@ async function resolveProject(fs, flag, md) {
         return slugs[0];
     throw new Error(`specify --project <slug>${slugs.length ? ` (yours: ${slugs.join(", ")})` : ""}`);
 }
-const VERBS = new Set(["projects", "ls", "cat", "post", "task", "doc"]);
-async function runVerb(args, fs) {
+const VERBS = new Set([
+    "projects",
+    "new",
+    "ls",
+    "cat",
+    "post",
+    "task",
+    "doc",
+]);
+async function runVerb(args, fs, client) {
     const ok = (msg) => console.log(`${colors.green}✓${colors.reset} ${msg}`);
     if (args.command === "projects") {
         const slugs = await fs.readdir("/projects");
         console.log(slugs.length ? slugs.join("\n") : "(no projects)");
         return;
     }
+    if (args.command === "new") {
+        const name = args.rest.join(" ").trim();
+        if (!name)
+            throw new Error('usage: sfora new "<project name>"');
+        const res = await client.createProject(name);
+        ok(`Created project ${res.name} · /projects/${res.slug}`);
+        return;
+    }
     if (args.command === "ls") {
         const entries = await fs.readdir(args.rest[0] ?? "/projects");
         console.log(entries.join("\n"));
@@ -354,8 +373,9 @@ async function main() {
             apiKey,
             org: settings.org ?? "",
         });
+        const client = new SforaApiClient({ baseUrl, apiKey });
         try {
-            await runVerb(args, fs);
+            await runVerb(args, fs, client);
         }
         catch (e) {
             process.stderr.write(`${colors.red}error:${colors.reset} ${e instanceof Error ? e.message : String(e)}\n`);

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.3.0",
+  "version": "0.5.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": [