rewritable 0.6.0 → 0.8.0

package/README.md

@@ -31,6 +31,8 @@ rwa edit notes.html --plan plan.json                # envelope from a file
 
 rwa doc notes.html                                  # print the editable body
 rwa doc notes.html --json                           # read + edit-contract, one call
+rwa workspace create research                       # → research/rwa-index.html
+rwa workspace sync research                         # refresh the index from sibling rewritables
 
 rwa publish notes.html                              # → a hosted 24h share URL
 rwa host notes.html --url https://host.example      # → {id, token, url} (round-trip editing)
@@ -49,6 +51,7 @@ Pass `--kind <name>` to scaffold a different primary stance at first paint:
 - `--kind document` (default) — prose container; lens placeholder *"Write, or describe what you want."*
 - `--kind workflow` — three-stage scaffold (Inbox / In progress / Done); lens placeholder *"Add an item, or describe a stage move."*
 - `--kind presentation` — prose slide deck (split on `h1`/`h2`); the *Present* toggle renders it as slides at view time without changing the stored text (spec §5.10); lens placeholder *"Add a slide, or describe a change."*
+- `--kind workspace` — directory control center scaffold. Prefer `rwa workspace create <dir>` for real workspaces so the generated manifest is filled from the sibling rewritables on disk.
 - `--kind skill-host` — hosts permission-gated skills installed from `.rwa-skill.json` files; ships an empty runtime-owned frozen `#rwa-skills` zone the runtime (never the agent) rewrites on install/uninstall; installed skills are reported via `rwa doc`/`ls` as `tool`/`compute` affordances (`provenance:'installed'`). See `docs/specs/re-write-able-actions-spec-v0.8.md` §2.
 
 The product-kind taxonomy is documented at `docs/specs/rwa-product-types.md` in the main repo. The substrate runtime is unchanged across kinds — only the `INLINE_DOC` body and lens placeholder vary at emit time.
@@ -125,10 +128,10 @@ The agent loop retries up to 3 times when the model emits plain text instead of
 
 | Flag | Effect |
 |---|---|
-| `--backend <name>` | `openrouter` (default), `ollama`, `lmstudio`. Falls back to `$RWA_BACKEND`. `bridge` is browser-only by design. |
+| `--backend <name>` | `openrouter` (default), `ollama`, `lmstudio`, `atomic`. Falls back to `$RWA_BACKEND`. `bridge` is browser-only by design. |
 | `--model <id>` | model id passed to the backend. Falls back to `$RWA_MODEL`, then `google/gemini-3.5-flash`. |
-| `--base-url <url>` | OpenAI-compatible base URL override. Defaults: `https://openrouter.ai/api/v1`, `http://localhost:11434/v1` (or `$RWA_OLLAMA_URL`), `http://localhost:1234/v1` (or `$RWA_LMSTUDIO_URL`). |
-| `--api-key <key>` | openrouter only; falls back to `$RWA_OPENROUTER_KEY`. ollama / lmstudio run locally without auth. |
+| `--base-url <url>` | OpenAI-compatible base URL override. Defaults: `https://openrouter.ai/api/v1`, `http://localhost:11434/v1` (or `$RWA_OLLAMA_URL`), `http://localhost:1234/v1` (or `$RWA_LMSTUDIO_URL`), `http://127.0.0.1:1337/v1` (or `$RWA_ATOMIC_URL`). |
+| `--api-key <key>` | openrouter only; falls back to `$RWA_OPENROUTER_KEY`. ollama / lmstudio / atomic run locally without auth. |
 
 #### Other edit flags
 
@@ -180,6 +183,23 @@ rwa ls a.html b.html  # …an explicit list
 
 `--json` emits an array of rows for an agent — `{file, status, self}` where `status` is `rewritable` (with the full `self-description/1` object), `not_a_rewritable`, or `error` (with a `reason`). The scan is lenient like its namesake: one bad path among many is a row, not a fatal exit, so a completed scan exits `0`. This is how an agent handed a project learns its whole rewritable inventory — and every container's affordances — in a single call.
 
+### `rwa workspace create <dir>` / `rwa workspace sync [dir]`
+
+Create or refresh a folder-level control center at `<dir>/rwa-index.html`. The index is itself a rewritable of kind `workspace`: it contains editable shared context for the directory (workspace memory, guidelines, examples, open questions), opens as a dashboard of sibling rewritable documents, and carries a frozen `<script id="rwa-workspace" type="application/rwa-workspace+json">` manifest generated from the directory inventory.
+
+```sh
+rwa workspace create notes/
+rwa new notes/project-brief.html
+rwa new notes/research-log.html
+rwa workspace sync notes/
+```
+
+`create` makes the directory if needed and refuses to overwrite an existing `rwa-index.html` unless `--force` is passed. `sync` refreshes an existing index, or creates it if absent, using the current sibling `.html` rewritables in that directory. The scan is non-recursive and skips non-rewritable HTML files plus the index itself. The editable context block is preserved across sync, so notes like blog style guidelines and canonical examples survive inventory refreshes.
+
+This first pass is intentionally simple: it does not merge documents, schedule automations, or expand the skill-host runtime. It gives a directory a portable, editable shared brain plus a truthful machine-readable manifest that other rewritables can use as context.
+
+When the workspace index is open, it also listens on the runtime bus for same-directory rewritables that are currently open. Those live documents appear under **Open now** and are marked `new since sync` until the next `rwa workspace sync` writes them into the durable manifest. This is live presence only: unopened files still require `sync` because a browser page cannot enumerate arbitrary local directories by itself.
+
 ### `rwa publish <path>`
 
 Publish a local rewritable to the hosted share service and get back a URL. A rewritable is already shareable as a file — it's a self-contained `.html` you can email or host anywhere — but `rwa publish` is the one-command path to an *anonymous, hosted* snapshot: create with `rwa new`, edit locally, publish.
@@ -293,7 +313,7 @@ Because the anchors in step 1 are the *same* text step 3 splices against, what t
 |---|---|
 | `--force`, `-f` | overwrite the destination if it exists |
 | `--open`, `-o` | open the resulting file in the default app |
-| `--kind <name>` | (`rwa new` only) starter kind: `document` (default), `workflow`, `presentation`, `skill-host` |
+| `--kind <name>` | (`rwa new` only) starter kind: `document` (default), `workflow`, `presentation`, `workspace`, `skill-host` |
 | `--version` | print version |
 | `--help`, `-h` | usage |
 

package/bin/rwa.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { newCmd, importCmd, version, KNOWN_KINDS, openWithPrefill, SEED_CANDIDATES } from '../src/commands.mjs';
-import { resolveApiKey } from '../src/backend.mjs';
+import { resolveApiKey, backendMaxTokens } from '../src/backend.mjs';
 import { parseCreateArgs, createCmd } from '../src/create.mjs';
 import { relative } from 'node:path';
 
@@ -12,7 +12,7 @@ Usage:
   rwa new <name> [path]       a bare <name> resolves template-first: clone a cwd
                               file labeled data-rwa-template="<name>" (fresh UUID,
                               label stripped) if one exists; else, if <name> is a
-                              known kind (document/workflow/presentation/skill-host), create
+                              known kind (document/workflow/presentation/workspace/skill-host), create
                               that built-in kind. So "rwa new presentation" makes a
                               deck, and your own labeled file overrides the builtin.
                               Default out: ./<name>-YYYY-MM-DD.html.
@@ -52,6 +52,12 @@ Usage:
                               to \`rwa doc\`. Non-rewritables are counted, not
                               hidden. With --json, an array of self-description
                               rows. Lenient: a completed scan exits 0.
+  rwa workspace create <dir>  create a folder-level rwa-index.html control
+                              center. The index is a rewritable of kind
+                              workspace, with a frozen manifest generated from
+                              sibling rewritables in that directory.
+  rwa workspace sync [dir]    refresh <dir>/rwa-index.html from the current
+                              sibling rewritable inventory (default: ./).
   rwa publish <path>          publish a local rewritable to the share service
                               and print the hosted URL. POSTs your edited bytes;
                               the hosted snapshot is anonymous, 24h, with a fresh
@@ -84,11 +90,13 @@ Usage:
 
 Flags:
   --kind <name>  (new only) starter kind: document (default), workflow,
-                 presentation, or skill-host. 'document' is the canonical prose
+                 presentation, workspace, or skill-host. 'document' is the canonical prose
                  container. 'workflow' scaffolds three stages (Inbox / In
                  progress / Done). 'presentation' scaffolds a prose deck that the
                  'Present' toggle displays as slides (split on h1/h2) without
-                 changing the stored text. 'skill-host' hosts permission-gated
+                 changing the stored text. 'workspace' scaffolds a directory
+                 control center; prefer \`rwa workspace create\` so the manifest
+                 is filled from disk. 'skill-host' hosts permission-gated
                  skills installed from .rwa-skill.json files (v0.8 actions spec).
                  See docs/specs/rwa-product-types.md.
   --skin <name>  (new only) bake a style preset into the new container:
@@ -101,7 +109,7 @@ Flags:
   --open, -o     open the resulting file in the default app. First-paint
                  sessionStorage is pre-populated from env / ./.env:
                    OPENROUTER_API_KEY → ?key=…    (lifted into rwa_apikey)
-                   RWA_BACKEND        → ?backend= (openrouter|ollama|lmstudio|bridge)
+                   RWA_BACKEND        → ?backend= (openrouter|ollama|lmstudio|atomic|bridge)
                    RWA_MODEL          → ?model=…  (model name string)
                  The bootstrap lifts each into sessionStorage and scrubs the
                  URL bar on first paint, so the values don't sit in history.
@@ -137,8 +145,8 @@ Flags:
                  the raw body; on failure, the \`{code, subcode, details}\`
                  object goes to stderr.
   --backend <n>  (edit instruction path / skin --l1) backend name. One of:
-                 openrouter (default), ollama, lmstudio. Falls back to
-                 \$RWA_BACKEND if unset.
+                 openrouter (default), ollama, lmstudio, atomic. Falls back
+                 to \$RWA_BACKEND if unset.
   --model <id>   (edit instruction path / skin --l1) model id passed to the
                  backend. Falls back to \$RWA_MODEL, then a
                  sensible default for the backend.
@@ -248,6 +256,7 @@ function envBaseUrl(name) {
     case 'openrouter': return 'https://openrouter.ai/api/v1';
     case 'ollama':     return process.env.RWA_OLLAMA_URL || 'http://localhost:11434/v1';
     case 'lmstudio':   return process.env.RWA_LMSTUDIO_URL || 'http://localhost:1234/v1';
+    case 'atomic':     return process.env.RWA_ATOMIC_URL || 'http://127.0.0.1:1337/v1';
     default:           return undefined;
   }
 }
@@ -377,7 +386,7 @@ function detectProductKind(fileText) {
 
         // Reject unknown backends fast. `bridge` is browser-only by design
         // (single-shot via web_cli_bridge); the CLI has no equivalent.
-        if (!['openrouter', 'ollama', 'lmstudio'].includes(backendName)) {
+        if (!['openrouter', 'ollama', 'lmstudio', 'atomic'].includes(backendName)) {
           emitEdit({ code: 'usage_error', subcode: 'unknown_backend', details: { backend: backendName } }, jsonMode);
           process.exitCode = 1;
           return;
@@ -457,7 +466,7 @@ function detectProductKind(fileText) {
             currentDoc: promptDoc,
             instruction,
             frozenZoneNames,
-            backend: { baseUrl, model: modelId, apiKey },
+            backend: { baseUrl, model: modelId, apiKey, maxTokens: backendMaxTokens(backendName) },
             onRetry: r => {
               if (jsonMode) {
                 process.stderr.write(JSON.stringify({ phase: 'retry', attempt: r.attempt, reason: r.reason }) + '\n');
@@ -605,6 +614,42 @@ function detectProductKind(fileText) {
       return;
     }
 
+    // `rwa workspace create <dir>` / `rwa workspace sync [dir]` — a directory
+    // control center. The generated rwa-index.html is itself a rewritable, but
+    // its manifest is CLI-owned and refreshed from sibling rewritables.
+    if (verb === 'workspace') {
+      const sub = rest.find(a => !a.startsWith('-'));
+      const force = rest.includes('--force') || rest.includes('-f');
+      const open = rest.includes('--open') || rest.includes('-o');
+      const positionals = rest.filter((a) => !a.startsWith('-'));
+      const dirPath = positionals[1] || '.';
+      const emitWorkspace = (msg) => { process.stderr.write('rwa workspace: ' + msg + '\n'); };
+
+      if (!sub || !['create', 'sync'].includes(sub)) {
+        emitWorkspace('usage: rwa workspace create <dir> [--force] [--open] | rwa workspace sync [dir] [--open]');
+        process.exitCode = 1;
+        return;
+      }
+      if (sub === 'create' && !positionals[1]) {
+        emitWorkspace('missing <dir> argument');
+        process.exitCode = 1;
+        return;
+      }
+
+      const { workspaceCreateCmd, workspaceSyncCmd } = await import('../src/workspace.mjs');
+      try {
+        const result = sub === 'create'
+          ? await workspaceCreateCmd({ dirPath, force, seedCandidates: SEED_CANDIDATES })
+          : await workspaceSyncCmd({ dirPath, seedCandidates: SEED_CANDIDATES });
+        console.log(`wrote ${relative(process.cwd(), result.indexPath) || result.indexPath} (${result.docs.length} document${result.docs.length === 1 ? '' : 's'})`);
+        if (open) await openWithPrefill(result.indexPath);
+      } catch (e) {
+        emitWorkspace((e && e.message) || String(e));
+        process.exitCode = (e && e.exitCode) || 1;
+      }
+      return;
+    }
+
     // `rwa publish <file> [--url <base>] [--json]` — publish a local rewritable
     // to the service's snapshot endpoint and print the share URL. Thin client
     // for `POST /publish`; see src/publish.mjs. Intentionally online (the
@@ -845,7 +890,7 @@ function detectProductKind(fileText) {
         const baseUrl     = baseUrlFlag.value || envBaseUrl(backendName);
         const apiKey      = resolveApiKey(backendName, apiKeyFlag.value);
 
-        if (!['openrouter', 'ollama', 'lmstudio'].includes(backendName)) {
+        if (!['openrouter', 'ollama', 'lmstudio', 'atomic'].includes(backendName)) {
           emitSkin({ code: 'usage_error', subcode: 'unknown_backend', details: { backend: backendName } });
           process.exitCode = 1; return;
         }
@@ -882,7 +927,7 @@ function detectProductKind(fileText) {
           result = await skinCmdL1(filePath, action, {
             systemPrompt,
             toolSchemas: TOOL_SCHEMAS,
-            backend: { baseUrl, model: modelId, apiKey },
+            backend: { baseUrl, model: modelId, apiKey, maxTokens: backendMaxTokens(backendName) },
             onRetry: r => {
               if (jsonMode) process.stderr.write(JSON.stringify({ phase: 'retry', attempt: r.attempt, reason: r.reason }) + '\n');
               else process.stderr.write(`rwa skin: attempt ${r.attempt}/3 retrying — ${r.reason}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rewritable",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "CLI for re-writeable: emit and import single-file rwa documents.",
   "type": "module",
   "bin": {