rewritable 0.7.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.
@@ -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

@@ -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:
@@ -606,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

package/package.json

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