pi-weave 0.3.0 → 0.3.2

package/README.md

@@ -154,22 +154,46 @@ Renaming or moving a note rewrites its inbound links automatically, so its backl
 /weave-view tui          # Pi only: terminal UI for SSH or browser-free use
 ```
 
-The browser workspace has four connected views:
-
-- **Tree** — notes, folders, and repository structure, with text and provenance filters.
-- **Note** — rendered Markdown with clickable `[[wikilinks]]`, link previews, tags, authorship, click-to-edit, and an action to open the
-  source in `$EDITOR`.
-- **Graph** — a navigable map of notes, links, mentions, modules, and repository relationships. Selecting something updates every view.
-- **Context** — links, backlinks, tags, and code mentions for the current selection.
-
-Search with `⌘K` / `Ctrl K`. Press `?` for all shortcuts. The workspace updates as notes change on disk, so a note written by Pi appears
-without a reload. It follows the system theme by default and can be switched between light and dark.
-
-**Click the note text to edit it** — the prose swaps for its Markdown source; `⌘S` / `Ctrl S` saves, `Esc` or **Done** closes. Selecting
-text to copy and clicking a `[[wikilink]]` do what they always did; neither opens the editor. A save rewrites the body and nothing
-else — unknown front-matter fields, key order, and the append-only `## Raw` tail of a dictated note all survive untouched, so a note edited
-here and a note edited in Obsidian stay byte-compatible. Editing with `$EDITOR`, Obsidian, or the `weave_note` tool works as before; the
-last writer wins, and the workspace picks up outside changes within a couple of seconds.
+The browser workspace puts notes at the center, with a collapsible notes sidebar, document tabs, and optional context for links,
+backlinks, tags, and code mentions. Open a note to replace the current document; `⌘` / `Ctrl` click a note or wiki-link to open a new tab.
+Drag a tab title within its tab strip to reorder tabs, or use `Alt ←` / `Alt →` while the tab is focused.
+Each document tab has its own Back/Forward history and reading position. The tab strip sits at the top of the workspace.
+Use the ribbon search button or `⌘K` / `Ctrl K`; `⌘` / `Ctrl Enter` opens a result
+in a new tab. **Recent** keeps its order while you browse; returning to it refreshes the visit order. Its rows show the same item icons
+as Files. Press `?` for shortcuts.
+
+Open **Graph view** from the left ribbon. Click a node to preview its title and type while staying in Graph. Click the same node again
+or choose **Open in new tab** to open its content; in a split layout, the new tab opens in the other pane. Dragging does not open content.
+Use **Pane options (···)** to split right or down, move the current tab to the other pane, or close a pane while retaining its tabs.
+In a split workspace, drag a tab title into the other pane to move it. History, reading position, and unsaved drafts stay with it. On small windows, **Switch pane** reaches the
+other group. Drag a note from Files into either pane to open it in a new tab. Closing or moving the last tab out of a split removes that pane;
+closing the final workspace tab leaves a New tab. `Option W` / `Alt W` closes the active Weave tab using the same unsaved-draft guard.
+Some browser hosts also claim this shortcut: Codex’s in-app browser still closes its outer tab. Both sidebars can be shown or hidden from the ribbon.
+
+Click **Edit** to change a note's Markdown; `⌘S` / `Ctrl S` saves, and **Done** closes the editor. Drafts survive tab and pane switching,
+and duplicate views of a note share one draft. Closing or replacing the last view of an unsaved note asks before discarding it. A save
+rewrites only the body: unknown front-matter fields, key order, and the append-only `## Raw` tail survive untouched. Outside edits appear
+within a couple of seconds; the last writer wins.
+
+Tabs, pane sizes, sidebars, theme, and reading positions restore for the same vault and repository, even when the local server port
+changes. Presentation snapshots live under `$XDG_CONFIG_HOME/pi-weave/presentation` (or `~/.config/pi-weave/presentation`), separate from
+the knowledge files. Unsaved text stays in memory and is guarded on reload/close; it is not restored after closing the browser. Missing
+notes do not prevent the other tabs from restoring. The workspace follows the system theme unless you choose a palette in Settings.
+
+Open **Settings** with the gear button or `⌘,` / `Ctrl ,`. General includes workspace locations, refresh, documentation, and
+keyboard shortcuts. Appearance offers six Catppuccin palettes and three additional light/dark pairs, an independent accent selector,
+and note font size. Choose a light theme and a dark theme; the ribbon button and `t` switch between those two. System mode follows
+your device using the selected pair. Interface holds sidebar visibility, group colors, and the live graph layout sliders. Editor controls spellcheck,
+readable line length, and whether newly opened notes start in editing mode. Files controls startup tabs and whether new tabs take focus.
+These preferences are stored with the workspace snapshots.
+
+**Settings → Backup → Download vault ZIP** exports saved vault files, including attachments, hidden metadata, empty folders, and linked
+content. Save unsaved drafts before downloading. Backups are manual; there is no scheduled backup or sync. Restore by extracting the ZIP
+into a vault directory. Symbolic-link cycles, unreadable files, and entries outside ZIP format limits produce an error instead of a partial
+archive. Presentation snapshots and the separate repository index are not part of the vault download.
+
+This browser facelift is the first stage toward a dedicated macOS window. `/weave-view` still launches the browser, and the agent owns
+the local server's lifetime.
 
 `/weave-view tui` is the smaller, read-only terminal explorer: tree, focused neighborhood, details, and link health over the same graph.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-weave",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Local-first Markdown memory and knowledge graph for Pi and OpenCode: preserve decisions, recall sessions, and explore notes with code.",
   "type": "module",
   "sideEffects": false,
@@ -18,7 +18,6 @@
     "local-first",
     "knowledge-graph",
     "codebase-memory",
-    "obsidian",
     "developer-tools"
   ],
   "license": "MIT",
@@ -94,6 +93,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
+    "fflate": "^0.8.3",
     "zod": "4.1.8"
   }
 }

package/src/core/frontmatter.ts

@@ -14,7 +14,7 @@ import { NOTE_SOURCES } from "./types";
  * not the same promise. `parseNoteFile` read five keys and `serializeNote`
  * wrote five keys, so every write through core silently deleted whatever
  * else the file carried — `aliases`, `cssclass`, `publish`, any property an
- * Obsidian user or another tool had added. Reading a note and appending one
+ * external editor or another tool had added. Reading a note and appending one
  * line destroyed the rest of its metadata (weave-workspace §11 P5).
  *
  * The fix is *not* a fuller YAML parser. A vault is plain text a human edits,
@@ -46,8 +46,8 @@ import { NOTE_SOURCES } from "./types";
  * change rather than a silent one. See {@link isDefaulted}.
  *
  * **An owned key whose on-disk syntax this subset cannot represent is
- * frozen**: carried verbatim, and not re-rendered or duplicated. Obsidian's
- * property editor writes tags as a YAML block list —
+ * frozen**: carried verbatim, and not re-rendered or duplicated. A property
+ * editor may write tags as a YAML block list —
  *
  * ```yaml
  * tags:

package/src/core/graph/model.ts

@@ -64,8 +64,8 @@ export interface GraphModel {
    * slug → wiki-link targets that resolved to no note in the graph
    * (weave-workspace §4.2).
    *
-   * A `[[target]]` that matches nothing is not an error — it is Obsidian's
-   * ghost node, the affordance that offers to create the missing note. The
+   * A `[[target]]` that matches nothing is not an error — it is a ghost node,
+   * the affordance that offers to create the missing note. The
    * builder used to count these and throw the names away, leaving
    * `detail["dangling links"] = "3"` as the only trace; a display string is
    * not something a UI can navigate.

package/src/core/graph/wikilinks.ts

@@ -1,5 +1,5 @@
 /**
- * Obsidian-compatible [[wiki-link]] extraction from note bodies.
+ * Wiki-link extraction from note bodies.
  * Pure module used by graph construction and viewer view-models.
  */
 

package/src/core/types.ts

@@ -29,7 +29,7 @@ export interface NoteMeta {
  * This is how pi-weave keeps front matter **lossless**. `NoteMeta` names the
  * five fields the engine understands; a vault is a directory of files a human
  * also edits, so real notes carry keys the engine has never heard of —
- * Obsidian's `aliases`, `cssclass`, `publish`, whatever the user invented last
+ * `aliases`, `cssclass`, `publish`, whatever the user invented last
  * Tuesday. Modelling those as parsed values would mean re-emitting them, and
  * re-emitting a value the parser only half-understands is how formatting (and
  * then content) gets destroyed.

package/src/pi/viewer/tui/surface/detail.ts

@@ -148,7 +148,7 @@ export class DetailSurface implements Surface {
     if (matchesKey(data, "enter")) {
       const row = this.activeRow();
       if (row?.target) {
-        // rebind this detail pane to the target (Obsidian "open in main" in place)
+        // rebind this detail pane to the target (open in main, in place)
         this.state = { nodeId: row.target, selectedId: row.target, scrollOffset: 0, gotoBuf: null };
         this._lines = undefined;
         this.requestBody(row.target);