pi-weave 0.3.7 → 0.3.9

package/README.md

@@ -113,7 +113,7 @@ You: Start a note for this interview. I’m going to narrate; keep my words
 
 For each chunk, the agent:
 
-1. appends your words unchanged to the note’s `## Raw` tail;
+1. appends your words unchanged to the note’s `## Raw` tail, starting with the very first chunk;
 2. refreshes the structured summary above it;
 3. leaves the raw record untouched.
 
@@ -152,12 +152,13 @@ Renaming or moving a note rewrites its inbound links automatically, so its backl
 
 ```bash
 /weave-view              # open the browser workspace
-/weave-view --no-open    # start it and print the URL
-/weave-view tui          # Pi only: terminal UI for SSH or browser-free use
+/weave-view --no-open    # start it and print the URL (handy over SSH)
 ```
 
 Browse and search your notes, follow links, or explore the graph. Use tabs and split panes to keep related notes side by side.
 Notes update within a couple of seconds as your agent writes them.
+While your agent works, the notes it searches, reads, and writes light up in the tree and graph, and fade after about a minute.
+The **This turn** list in the Context sidebar shows those steps in order; click an earlier turn to replay it.
 
 Ask your agent to write, organize, and connect notes, or click **New note** on an empty tab to start one yourself.
 Click **Edit** to change Markdown and `⌘S` / `Ctrl S` to save. Your original words in `## Raw` stay intact.
@@ -165,7 +166,8 @@ Tabs, layout, and settings restore when you return and survive package updates f
 unsaved drafts last only while the browser stays open.
 
 Use **Settings** for themes, fonts, layout, and a manual vault ZIP backup. Press `?` for keyboard shortcuts.
-`/weave-view tui` opens a smaller, read-only terminal explorer in Pi.
+
+Every change to a note is saved to `<vault>/history/`, whether you, your agent, or another editor made it. Press **History** on a note and drag the slider (or press play) to watch it being written, Raw tail included. Turn this off in **Settings → Editor → Note history**.
 
 ## Remember sessions
 
@@ -182,18 +184,18 @@ technical takeaways, works outside Git repositories, and can be stopped with `/w
 
 ## Repository knowledge
 
-Inside a Git repository, pi-weave detects whether `<repo>/.okf/` is missing, fresh, or stale.
+Inside a Git repository, `/weave-scan` asks your session model for a short summary of each file, so you and your agent can find your way
+around without reading everything. It only revisits files whose content changed since the last run.
 
 ```bash
-/weave-scan         # fast structural index
-/weave-scan deep    # also summarize changed files with the active model
+/weave-scan         # summarize changed files with the active model
 ```
 
-The light index covers languages, packages, modules, entry points, and Git state. A deep scan adds short per-file summaries and only
-revisits files whose content changed.
+pi-weave also keeps a small structural index of the repository (languages, packages, modules, entry points, Git state). It feeds the graph
+and links notes to the files they mention. You never build it by hand: it is refreshed automatically whenever something needs it.
 
-The repository index is a cache, not a source of truth. Delete `.okf`, scan again, and nothing important is lost. pi-weave excludes it
-locally from Git by default.
+Everything under `<repo>/.okf/` is a cache, not a source of truth. Delete it and nothing important is lost. pi-weave excludes it locally
+from Git by default.
 
 ## Commands and tools
 
@@ -201,14 +203,13 @@ Most people only need natural language and `/weave-view`.
 
 | Surface | Name | Purpose |
 |---|---|---|
-| Command | `/weave-view` | Open the browser workspace (`tui` is a Pi-only argument) |
+| Command | `/weave-view` | Open the browser workspace |
 | Command | `/weave` | Show vault and repository status |
-| Command | `/weave-scan` | Build or refresh the repository index |
-| Command | `/weave-scan deep` | Add incremental model-written file summaries |
+| Command | `/weave-scan` | Add incremental model-written file summaries |
 | Command | `/weave-scan sessions [path]` | Turn changed session-history files into durable memory notes |
-| Command | `/weave-scan-cancel` | Stop a deep or session scan |
+| Command | `/weave-scan-cancel` | Stop a running scan |
 | Tool | `weave_note` | List, read, add, append, finalize, and search notes |
-| Tool | `weave_repo` | Check, scan, and summarize the repository index |
+| Tool | `weave_repo` | Describe the repository structure for the agent |
 
 The included `weave-notepad` and `weave-explore` skills teach Pi and OpenCode when and how to use these tools. In OpenCode, `/weave` shows
 vault/repository status and scan progress appears in toasts; Pi keeps its persistent status line. V1 slash commands use its standard prompt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-weave",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "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,
@@ -59,6 +59,7 @@
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.web.json",
     "build:web": "node scripts/build-web.mjs",
     "build:web:check": "node scripts/build-web.mjs --check",
+    "e2e": "vitest run --config vitest.e2e.config.ts",
     "check": "npm run typecheck && npm run build:web:check && npm run coverage",
     "eval:notepad": "node scripts/eval-notepad-search.mjs",
     "rewrap:md": "node scripts/rewrap-md.mjs",
@@ -68,14 +69,13 @@
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
     "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*",
     "typebox": "*"
   },
   "devDependencies": {
     "@earendil-works/pi-ai": "^0.84.2",
     "@earendil-works/pi-coding-agent": "^0.84.2",
-    "@earendil-works/pi-tui": "^0.84.2",
     "@opencode-ai/plugin": "1.18.29",
+    "@opencode-ai/sdk": "1.18.29",
     "@opencode/plugin": "^2.0.19",
     "@types/d3-force": "^3.0.10",
     "@types/node": "^24.0.0",
@@ -86,6 +86,7 @@
     "graphology": "^0.26.0",
     "graphology-types": "^0.24.8",
     "marked": "^18.0.10",
+    "playwright-core": "1.56.1",
     "preact": "^10.29.8",
     "sigma": "^3.0.3",
     "typebox": "1.3.7",

package/skills/weave-explore/SKILL.md

@@ -9,17 +9,15 @@ Use `weave_repo`. Without the tool, read `<repo>/.okf/` directly. The index is a
 
 ## Workflow
 
-1. Check `action=status`: if missing, offer a scan or scan when exploration was requested; if stale, rescan; if fresh, read
-   `action=overview`.
+1. Read `action=overview`. It builds or refreshes the structure index itself, so there is nothing to scan first.
 2. Use the overview's languages, packages, modules, and entry points to select relevant paths instead of listing the whole repository.
 3. Read available `.okf/repository/summaries/` sidecars before opening full files.
 4. Inspect the relevant code and cite indexed paths in your answer.
 
 ## Commands
 
-- `/weave-scan` refreshes the index (`weave_repo` action=scan).
-- `/weave-scan deep` generates file summaries using the session model. Offer it when summaries are missing or stale; never run it
-  implicitly. Only changed content is summarized again.
+- `/weave-scan` generates file summaries using the session model. Offer it when summaries would help and the overview shows none;
+  never run it implicitly. Only changed content is summarized again.
 - `/weave-view` opens the browser workspace.
 - `/weave-scan sessions [path]` writes session memories to the vault, not the repository index; see `weave-notepad`.
 

package/skills/weave-notepad/SKILL.md

@@ -26,9 +26,10 @@ Use `weave_note`. Without the tool, edit the files directly (`PI_WEAVE_VAULT` ov
 
 During live dictation or interviews, keep the organized note current after every append; do not wait until the session ends:
 
-1. `append` with `raw: true` preserves the user's words verbatim under `## Raw`. Never silently reword dictation.
-2. Immediately `finalize` the body above the tail: front-loaded summary, sections, decisions, questions, tasks, entities, and links
-   reflecting everything said so far.
+1. Start the note with `add` and `raw: true`, so its first words land in `## Raw` too. Then `append` each chunk with `raw: true`.
+   Never silently reword dictation.
+2. Immediately `finalize` the body above the tail: TLDR, sections, decisions, questions, tasks, entities, and links reflecting
+   everything said so far.
 
 Outside dictation, finalize only on request.
 
@@ -36,7 +37,7 @@ Outside dictation, finalize only on request.
 
 - Keep an append-only raw section at the bottom: `---`, then `## Raw`, then the notice shown below.
 - Fence verbatim input in code blocks. Prepend each subsequent block with `<!-- appended YYYY-MM-DD HH:MM -->`.
-- Use `append` with `raw: true` when available; it maintains this format and creates the tail if missing. Do not hand-format it.
+- Use `add` or `append` with `raw: true` when available; they maintain this format and create the tail if missing. Do not hand-format it.
 - `finalize` changes only the body above the tail. Never rewrite, remove, or move words out of the raw tail. If no tail exists, preserve the
   entire previous body as a new raw tail before restructuring; the tool does this automatically.
 
@@ -58,6 +59,31 @@ When editing files directly, preserve the same format:
 ```
 ````
 
+## Second thoughts
+
+When the user states a decision, check the `search` hits you already made and the target note's decisions for an earlier **human**
+decision that it contradicts. Do not run extra searches or reads for this.
+
+- Keep the bar high: an explicit decision against an explicit decision on the same subject. Overlapping facts, refinements, and
+  compatible choices are not conflicts. When unsure, stay silent.
+- Capture first, then ask. Save the user's words as usual, then ask one short question quoting the earlier decision with its date and
+  slug: replace it, or are both true? At most one question per turn.
+- `source` is per note, not per line, so judge each decision by where it came from. It is human when the user's words for it are in the
+  raw tail, or when it sits in a `source: human` note outside an "Agent addendum". Anything else counts as agent.
+- Conflicting agent or `generated` decisions do not get a question; the human statement already wins. Mention them in one line.
+- If the user says it replaces the old one, strike the old decision through instead of deleting it, and link the new one:
+  `~~OIDC next quarter~~ (superseded 2026-10-11 → [[auth-sso]])`, where the link names the note that holds the new decision. When the
+  new decision is in the same note, drop the link: `(superseded 2026-10-11)`. A note should not link to itself.
+- Never edit the raw tail to supersede anything. `finalize` keeps superseded lines, struck through, in the body.
+
+See [references/second-thoughts.md](references/second-thoughts.md) for example exchanges.
+
+## TLDR on finalize
+
+Every finalized note opens with a TLDR directly under the title: a `**TLDR:**` block of 1–8 lines on what the note says and what
+matters most. Bullets and lists are fine. Always list action items, if any, as `- [ ]` checkboxes. Rewrite it on each `finalize` so it reflects the whole
+note; never stack a second one.
+
 ## Retrieve
 
 - Known slug: `get`. Otherwise, one targeted `search` with the user's terms; never list the vault to find a note.

package/skills/weave-notepad/references/second-thoughts.md

@@ -0,0 +1,57 @@
+# Second thoughts
+
+Catch a decision that contradicts an earlier human decision while the user is there to answer in one word. Silence is the default; a
+false alarm costs more than a missed one.
+
+## Conflict: ask once, after saving
+
+```text
+User:  Add to the auth note that we're going with SAML.
+
+Agent: (search "auth" → auth-migration; Decisions has "2026-09-03: OIDC next quarter, JWT compatibility window", source: human)
+       (append to auth-migration)
+
+Agent: Added. One thing: on Sep 3 you decided "OIDC next quarter, JWT compatibility window" (auth-migration, Decisions).
+       Should SAML replace that decision, or are both true?
+
+User:  Replace it.
+
+Agent: (edit the body above the raw tail)
+       Updated. The Sep 3 decision is now marked superseded.
+```
+
+The Decisions section afterwards:
+
+```markdown
+## Decisions
+
+- ~~2026-09-03: OIDC next quarter, JWT compatibility window~~ (superseded 2026-10-11)
+- 2026-10-11: Go with SAML.
+```
+
+The new decision is in the same note, so there is no link. When it lives in another note, link it:
+`(superseded 2026-10-11 → [[auth-sso]])`.
+
+If the user answers "both are true", leave both lines as they are and say so.
+
+## No question
+
+| New statement | Earlier note | Why silent |
+|---|---|---|
+| "Use SAML for the admin portal" | human: "OIDC for the customer app" | Different subjects |
+| "Use Okta as the OIDC provider" | human: "OIDC next quarter" | Compatible; it builds on the decision |
+| "We're going with SAML" | generated session note: "team leaning OIDC" | Not a human decision; mention it in one line |
+| "SAML might be simpler" | human: "OIDC next quarter" | Not a decision |
+| "We're going with SAML" | "OIDC next quarter" in the Agent addendum of a `source: human` note | Agent-written line; mention it in one line |
+
+## Mixed authorship
+
+`source` describes who created the note, not each line in it. A decision the user dictated into an agent note is human: its words are in
+the raw tail. A decision in the Agent addendum of a human note is the agent's. Check the raw tail or the addendum before deciding whether to
+ask.
+
+## Rules of thumb
+
+- Use the hits from the one `search` the capture already made; no extra calls to look for conflicts.
+- At most one question per turn, even if several decisions conflict. Name the strongest; mention others in the same question.
+- Never delete the old decision and never touch the raw tail. Superseded lines survive `finalize`, struck through.

package/src/core/graph/build.ts

@@ -11,7 +11,7 @@
 import type { HtmlArtifact, Note, RepoIndex, StalenessReport, VaultStatus } from "../types";
 import { createHash } from "node:crypto";
 import type { SummaryRecord } from "../summaries";
-import type { EdgeKind, GraphEdge, GraphModel, GraphNode } from "./model";
+import type { GraphEdge, GraphModel, GraphNode } from "./model";
 import { buildPathIndex, resolveMentions, type PathIndex } from "./mentions";
 import { extractWikilinks } from "./wikilinks";
 

package/src/core/graph/current.ts

@@ -15,7 +15,7 @@ import { join, resolve, sep } from "node:path";
 // that cache, so going through the barrel would close an import cycle.
 import { findGitRoot } from "../git";
 import { resolveVaultRoot } from "../paths";
-import { assessStaleness, readRepoIndex } from "../repoIndex";
+import { ensureRepoIndex } from "../repoIndex";
 import { readSummaryMap } from "../summaries";
 import type { Note } from "../types";
 import { getNote, readVault, resolveNotePath } from "../vault";
@@ -72,7 +72,7 @@ export async function readOkfFileForView(cwd: string, rel: string): Promise<{ pa
 
 /**
  * Assemble the repository half of the graph input for `cwd`, or null when
- * cwd is not inside a git repository with a readable `.okf` index. Shared
+ * cwd is not inside a git repository with at least one commit. Shared
  * with `src/core/cache/workspace` so the cached and uncached paths cannot
  * drift in what they read.
  */
@@ -81,19 +81,21 @@ export async function readRepositorySide(
 ): Promise<Pick<BuildGraphInput, "repository" | "summaries"> | null> {
   const repoRoot = await findGitRoot(cwd);
   if (repoRoot === null) return null;
-  const index = await readRepoIndex(repoRoot);
-  if (index === null) return null;
+  // The structure index is plumbing: built or refreshed here when missing or
+  // stale, so the repository side of the graph never waits on a manual scan.
+  const repository = await ensureRepoIndex(repoRoot);
+  if (repository === null) return null;
   return {
-    repository: { index, staleness: await assessStaleness(repoRoot) },
+    repository,
     summaries: await readSummaryMap(repoRoot), // deep-scan sidecars, read live
   };
 }
 
 /**
  * Assemble the fresh graph from disk. Called on every viewer fetch
- * (no caching). Reads the complete vault and, when cwd is an indexed git
- * repository, the repo index + deep-scan summary sidecars. Degrades to a vault-only graph when
- * the repo has no index or the index is corrupt.
+ * (no caching). Reads the complete vault and, when cwd is inside a git
+ * repository, the repo index (refreshed on demand) + deep-scan summary
+ * sidecars. Degrades to a vault-only graph when the repo has no commits.
  *
  * One read per note: `readVault` returns bodies *and* the file count, so the
  * old `listNotes` → `getNote`-per-slug → `noteCount` sequence (2N reads plus