pi-weave 0.1.12 → 0.1.13

package/README.md

@@ -27,7 +27,6 @@ It also understands the repository you are working in. Personal notes live in a
   while maintaining an organized summary above it.
 - **Knowledge retrieval.** Pi searches existing notes when answering questions about previous decisions, people, projects, or meetings.
 - **Unified visual workspace.** `/weave-view` presents notes, links, repository structure, and provenance in a live browser interface.
-- **Optional session memory.** `/weave-scan sessions` converts prior pi sessions into searchable notes and skips unchanged transcripts.
 - **Repository exploration.** A lightweight, git-aware index gives Pi a structural overview of the current codebase before it reads files.
 
 Nothing is captured silently. pi-weave creates or extends a personal note only when you ask it to.
@@ -98,42 +97,18 @@ Useful requests include:
 
 The browser workspace has four connected views:
 
-- **Tree** — notes, folders, session memories, and repository structure. Filter by text or provenance, create folders, drag notes between
-  folders, and use the context menu to rename or delete.
-- **Note** — rendered Markdown with clickable `[[wikilinks]]`, link previews, tags, and authorship. Click the body or press `⌘E` / `Ctrl E`
-  to edit; save with `⌘S` / `Ctrl S`.
+- **Tree** — notes, folders, and repository structure, with text and provenance filters.
+- **Note** — rendered Markdown with clickable `[[wikilinks]]`, link previews, tags, authorship, 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.
 
-The editor checks revisions before saving. If the note changed elsewhere, it asks whether to reload or overwrite instead of silently losing
-work. Unknown front-matter fields are preserved, so the same vault remains safe to edit with Obsidian or a text editor.
+The browser is read-only. Edit with `$EDITOR`, Obsidian, or the `weave_note` tool; unknown front-matter fields remain preserved.
 
 `/weave-view tui` is the smaller, read-only terminal explorer: tree, focused neighborhood, details, and link health over the same graph.
 
-## Remember past pi sessions
-
-```bash
-/weave-scan sessions
-```
-
-This reads pi’s local session transcripts and creates generated notes under:
-
-```text
-~/.okf/notes/sessions/
-```
-
-Each note records what was asked, what happened, and any open threads. The scan is:
-
-- **opt-in** — it never runs automatically;
-- **incremental** — unchanged transcripts use no model calls;
-- **cancellable** — run `/weave-scan-cancel`;
-- **repo-independent** — it works from any directory.
-
-Session summaries use the active pi model and are marked `source: generated`.
-
 ## Repository knowledge
 
 Inside a Git repository, pi-weave detects whether `<repo>/.okf/` is missing, fresh, or stale.
@@ -159,8 +134,7 @@ Most people only need natural language and `/weave-view`.
 | 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 sessions` | Turn pi session history into vault notes |
-| Command | `/weave-scan-cancel` | Stop a deep or session scan |
+| Command | `/weave-scan-cancel` | Stop a deep scan |
 | Tool | `weave_note` | List, read, add, append, finalize, and search notes |
 | Tool | `weave_repo` | Check, scan, and summarize the repository index |
 
@@ -174,8 +148,7 @@ Personal notes are ordinary Markdown files:
 ~/.okf/
 └── notes/
     ├── authentication-migration.md
-    └── sessions/
-        └── plan-the-release.md
+    └── release-plan.md
 ```
 
 A note has small YAML front matter followed by Markdown:
@@ -205,9 +178,8 @@ We probably want OIDC next quarter…
 
 Set `PI_WEAVE_VAULT` to use a different vault location.
 
-Reading, writing, searching, and viewing notes are local operations. Deep repository scans and session summaries send their bounded input to
-whichever model you configured in pi. The browser workspace binds only to loopback, uses a per-session token, and shuts down with the pi
-session.
+Reading, writing, searching, and viewing notes are local operations. Deep repository scans send bounded input to whichever model you
+configured in pi. The browser workspace binds only to loopback, uses a per-session token, and shuts down with the pi session.
 
 The vault format, repository index, and skills are intentionally harness-agnostic. `src/core` contains no pi-specific imports.
 
@@ -236,8 +208,7 @@ Read [AGENTS.md](AGENTS.md) before contributing. Work on a feature branch; do no
 
 - [Design](docs/design.md) — product and architecture
 - [Notepad skill](skills/weave-notepad/SKILL.md) — capture, narration, and provenance behavior
-- [Browser workspace](docs/weave-workspace.md) — UI architecture and security model
-- [Session scanning](docs/session-scan.md) — incremental session memory
+- [Historical browser workspace notes](docs/weave-workspace.md) — superseded implementation record
 - [Repository exploration skill](skills/weave-explore/SKILL.md) — how Pi uses the index
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-weave",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "An agent-native knowledge workspace for your life and your code. Smart notepad + repository exploration, readable by humans and agents alike.",
   "type": "module",
   "sideEffects": false,
@@ -64,7 +64,6 @@
     "@earendil-works/pi-ai": "^0.84.2",
     "@earendil-works/pi-coding-agent": "^0.84.2",
     "@earendil-works/pi-tui": "^0.84.2",
-    "@preact/signals": "^2.11.1",
     "@types/d3-force": "^3.0.10",
     "@types/node": "^24.0.0",
     "@vitest/coverage-v8": "^3.2.4",

package/src/core/concurrency.ts

@@ -1,10 +1,7 @@
 /**
- * Bounded-concurrency task runner shared by the deep scan (summaries.ts) and
- * the session scan (sessions.ts).
+ * Bounded-concurrency task runner shared by repository scans.
  *
- * Extracted from summaries.ts so the two scanners cannot drift: a second copy
- * of the scheduler is a second place for an off-by-one or a lost
- * cancellation check.
+ * Keeping the scheduler here gives every scan the same cancellation behavior.
  */
 
 /**
@@ -33,4 +30,4 @@ export async function mapWithConcurrency<T, R>(
   }
   await Promise.all(Array.from({ length: Math.max(1, concurrency) }, worker));
   return results;
-}
+}

package/src/core/frontmatter.ts

@@ -289,59 +289,6 @@ export function parseFrontMatter(text: string): ParsedFrontMatter | null {
   return { fields, body, lines };
 }
 
-/**
- * Upsert owned scalar fields into a front-matter block, preserving order.
- *
- * For each wanted key: the **first** line declaring it is replaced with a
- * fresh `key: value` line in place, and any later declarations are dropped —
- * mirroring how duplicate managed keys collapse in `replayBlock` (the
- * subset parser keeps the last occurrence, so collapsing to one line with
- * the fresh value is the consistent outcome). A key introducing a block
- * construct (`scalar: false`) is replaced too: the value this function writes
- * is a scalar, and leaving the old block head in place would orphan its
- * indented children under a duplicated key.
- *
- * Wanted keys the block never declared are appended at the end, in the order
- * given. Everything else — unknown keys, blank lines, junk — is carried
- * through byte-identically, the same round-trip contract `serializeNote`
- * honors for the note engine's writes.
- *
- * Keys arrive from pi-weave's own generated-note writers (`session_id`,
- * `session_hash`, …); there is no escaping for the *key* because a key is
- * caller-controlled code, not user input — `quoteField` guards the value.
- */
-export function upsertFrontMatterFields(
-  lines: NoteFrontMatter,
-  fields: Record<string, string>,
-): NoteFrontMatter {
-  const wanted = new Set(Object.keys(fields));
-  const out: string[] = [];
-  const written = new Set<string>();
-  let inDroppedBlock = false;
-  for (const line of scanFrontMatter(lines)) {
-    // Continuation lines of a block construct whose head we replaced: their
-    // parent key is gone, so carrying them would leave orphaned YAML children
-    // under a scalar. The block ends at the first non-indented line.
-    if (inDroppedBlock) {
-      if (/^\s/.test(line.text)) continue;
-      inDroppedBlock = false;
-    }
-    if (line.key !== null && wanted.has(line.key)) {
-      if (!written.has(line.key)) {
-        out.push(`${line.key}: ${quoteField(fields[line.key] ?? "")}`);
-        written.add(line.key);
-        if (!line.scalar) inDroppedBlock = true; // swallow the block body too
-      }
-      continue; // later duplicates collapse into the first occurrence
-    }
-    out.push(line.text);
-  }
-  for (const [key, value] of Object.entries(fields)) {
-    if (!written.has(key)) out.push(`${key}: ${quoteField(value)}`);
-  }
-  return out;
-}
-
 /**
  * Parse a note file. Throws on missing/invalid front matter so callers can
  * treat the file as malformed rather than guessing.

package/src/core/graph/build.ts

@@ -2,7 +2,7 @@
  * Pure graph builder: knowledge workspace inputs → GraphModel.
  *
  * No I/O, no clock access, no harness imports (design §21,
- * docs/weave-view.md §3). Stability contract: identical inputs produce
+ * docs/design.md §11). Stability contract: identical inputs produce
  * byte-identical JSON (ids derive from slugs/paths only; `generatedAt` is
  * derived from input timestamps, never from the wall clock) — that is what
  * makes the page's refresh-polling cheap.
@@ -15,7 +15,7 @@ import type { EdgeKind, GraphEdge, GraphModel, GraphNode } from "./model";
 import { buildPathIndex, resolveMentions, type PathIndex } from "./mentions";
 import { extractWikilinks } from "./wikilinks";
 
-/** Hard cap on note nodes (docs/weave-view.md M3 guard). */
+/** Hard cap on note nodes so a large vault cannot overwhelm the viewer. */
 export const DEFAULT_MAX_NOTES = 500;
 
 export interface BuildGraphInput {
@@ -133,10 +133,9 @@ function buildVaultSide(
 
   const keptSlugs = new Set(kept.map((n) => n.slug));
 
-  // Nested notes (`sessions/foo` — session memory, docs/session-scan.md) nest
-  // under synthesized folder nodes so the vault tree groups them the way the
-  // repository tree groups directories. Ids are prefixed `vfolder:` because a
-  // repository module could legitimately share the path (`module:sessions`);
+  // Nested notes nest under synthesized folder nodes so the vault tree groups
+  // them the way the repository tree groups directories. Ids are prefixed
+  // `vfolder:` because a repository module could legitimately share the path;
   // the tree renders any `contains` chain, so the kind reuse needs no client
   // change. Deterministic: dirs sorted, parents before children.
   const folderIds = new Map<string, string>();
@@ -320,7 +319,7 @@ function buildRepositorySide(
 
 /**
  * Build the graph model for the viewer. Notes are capped at `maxNotes`
- * (docs/weave-view.md M3); the vault node carries a warning when truncated.
+ * (docs/design.md §11); the vault node carries a warning when truncated.
  */
 export function buildGraph(input: BuildGraphInput, options: { maxNotes?: number } = {}): GraphModel {
   const maxNotes = options.maxNotes ?? DEFAULT_MAX_NOTES;

package/src/core/graph/current.ts

@@ -1,6 +1,5 @@
 /**
- * Workspace assembly readers for the viewers (docs/weave-view.md §2,
- * weave-view-tui-design §3.1).
+ * Workspace assembly readers for the viewers (docs/design.md §11).
  *
  * These functions are *workspace assembly*, symmetric to `getWorkspaceStatus`
  * (already in core): pure fan-out over `core/vault`, `core/repoIndex`,
@@ -92,7 +91,7 @@ export async function readRepositorySide(
 
 /**
  * Assemble the fresh graph from disk. Called on every viewer fetch
- * (no caching — docs/weave-view.md §2). Reads the vault (capped at
+ * (no caching). Reads the vault (capped at
  * DEFAULT_MAX_NOTES) 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.
@@ -117,4 +116,3 @@ export async function buildCurrentGraph(cwd: string, vaultRoot: string = resolve
   }
   return buildGraph(input);
 }
-

package/src/core/graph/model.ts

@@ -1,6 +1,6 @@
 /**
  * Graph model shared between the builder (core) and the viewer (adapter).
- * Pure data — no harness imports (design §21). See docs/weave-view.md §3.
+ * Pure data — no harness imports (design §21).
  */
 
 import type { NoteSource, StalenessReport } from "../types";

package/src/core/graph/wikilinks.ts

@@ -1,6 +1,6 @@
 /**
  * Obsidian-compatible [[wiki-link]] extraction from note bodies.
- * Pure module — see docs/weave-view.md §3.
+ * Pure module used by graph construction and viewer view-models.
  */
 
 import { slugify } from "../slug";
@@ -14,8 +14,8 @@ const WIKILINK_RE = /\[\[([^\][|]+)(?:\|[^\]]*)?\]\]/g;
  * `release-plan`. Duplicates are removed, order of first appearance kept.
  *
  * Path separators survive: a nested note's slug is its path relative to
- * `notes/` (`sessions/foo`), so `[[sessions/foo]]` targets the session note,
- * not a flattened name. Each path segment is slugified independently.
+ * `notes/`, so links target the nested note rather than a flattened name.
+ * Each path segment is slugified independently.
  */
 export function extractWikilinks(body: string): string[] {
   const out: string[] = [];

package/src/core/index.ts

@@ -3,24 +3,32 @@
  *
  * NO harness imports allowed in this tree (see docs/design.md §21).
  */
-export * from "./types";
-export * from "./slug";
-export * from "./frontmatter";
-export * from "./languages";
-export * from "./mutex";
-export * from "./paths";
-export * from "./git";
-export * from "./vault";
-export * from "./repoIndex";
-export * from "./summaries";
-export * from "./sessions";
-export * from "./concurrency";
-export * from "./workspace";
-export * from "./openInEditor";
-export * from "./graph/model";
-export * from "./graph/wikilinks";
-export * from "./view";
-export { buildGraph, dataTimestamp, DEFAULT_MAX_NOTES, type BuildGraphInput } from "./graph/build";
+export type { WorkspaceStatus } from "./types";
+export { NOTES_DIR, repoIndexDir, resolveVaultRoot } from "./paths";
+export { findGitRoot } from "./git";
+export {
+  assessStaleness,
+  buildRepoIndex,
+  readRepoIndex,
+  summarizeIndex,
+  writeRepoIndex,
+} from "./repoIndex";
+export { runDeepScan, type DeepScanOptions, type DeepScanResult, type SummarizeFn } from "./summaries";
+export {
+  addNote,
+  appendToNote,
+  extractRawTail,
+  finalizeNote,
+  formatNote,
+  formatRawAppend,
+  getNote,
+  listNotes,
+  resolveNotePath,
+  searchNotes,
+} from "./vault";
+export { withMutationQueue } from "./mutex";
+export { formatDashboard, formatStatusLine, getWorkspaceStatus } from "./workspace";
+export { WorkspaceCache } from "./cache/workspace";
 export {
   buildCurrentGraph,
   readNoteForView,
@@ -28,12 +36,3 @@ export {
   readRepositorySide,
   type ViewNote,
 } from "./graph/current";
-export {
-  classifyPath,
-  DEFAULT_STALENESS_TTL_MS,
-  WorkspaceCache,
-  type CacheStats,
-  type InvalidationScope,
-  type WorkspaceCacheOptions,
-  type WorkspaceSnapshot,
-} from "./cache/workspace";

package/src/core/paths.ts

@@ -14,13 +14,6 @@ import { join } from "node:path";
 export const OKF_DIR = ".okf";
 export const OKF_MANIFEST = "okf.json";
 export const NOTES_DIR = "notes";
-/**
- * Vault collection for generated session memory (docs/session-scan.md).
- * A sibling of `notes/` rather than a subdirectory of it: session notes are
- * machine-derived memory, not hand-curated knowledge, so they stay out of
- * the note graph's flat listing — and out of its slug namespace.
- */
-export const SESSIONS_DIR = "sessions";
 export const REPOSITORY_DIR = "repository";
 export const VAULT_ENV_VAR = "PI_WEAVE_VAULT";