pi-weave 0.1.8 → 0.1.9

package/src/pi/sessionScan.ts

@@ -0,0 +1,104 @@
+/**
+ * pi adapter for the session scan (docs/session-scan.md): summarize pi
+ * session transcripts into the vault as incremental memory notes.
+ *
+ * Model wiring is shared with the deep scan (`createModelSummarizer` — the
+ * session's already-configured model, auth via `modelRegistry`); only the
+ * prompt differs, because a session transcript wants different sentences
+ * than a source file. `deps.complete` is the test seam — no network in unit
+ * tests.
+ */
+
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import {
+  resolveSessionsRoot,
+  resolveVaultRoot,
+  runSessionScan,
+  type SessionScanOptions,
+  type SessionScanResult,
+  type SummarizeFn,
+} from "../core";
+import { createModelSummarizer, type SummarizerDeps } from "./summarize";
+
+const SESSION_SYSTEM_PROMPT = [
+  "You write durable memory notes that compact coding-agent sessions into their bottom line.",
+  "Answer, in order: what happened, what we did, what shipped (features, files, commands,",
+  "decisions), and what went less well (dead ends, breakage, anything left unfinished).",
+  "Technical sessions get specifics — real file paths, commands, outcomes — not generalities.",
+  "3–6 sentences, past tense. No preamble, no headings, no code fences.",
+].join("\n");
+
+const SESSION_MAX_OUTPUT_TOKENS = 400;
+
+/** Session summarizer over the session model, or null when none is active. */
+export function createSessionSummarizer(
+  ctx: Pick<ExtensionContext, "model" | "modelRegistry">,
+  deps: SummarizerDeps = {},
+): { summarize: SummarizeFn; label: string } | null {
+  return createModelSummarizer(ctx, SESSION_SYSTEM_PROMPT, SESSION_MAX_OUTPUT_TOKENS, deps);
+}
+
+export type SessionScanOutcome =
+  | { kind: "ok"; result: SessionScanResult }
+  | { kind: "no-model" };
+
+export interface SessionScanAdapterOptions {
+  complete?: SummarizerDeps["complete"];
+  maxSessions?: SessionScanOptions["maxSessions"];
+  maxFileBytes?: SessionScanOptions["maxFileBytes"];
+  concurrency?: SessionScanOptions["concurrency"];
+  sessionsRoot?: SessionScanOptions["sessionsRoot"];
+  vaultRoot?: SessionScanOptions["vaultRoot"];
+  now?: SessionScanOptions["now"];
+  onProgress?: SessionScanOptions["onProgress"];
+  signal?: SessionScanOptions["signal"];
+}
+
+/**
+ * Scan pi sessions into the vault using the session model. Roots default to
+ * the real locations (PI_WEAVE_SESSIONS / PI_WEAVE_VAULT overrides apply);
+ * tests inject both.
+ */
+export async function scanPiSessions(
+  ctx: Pick<ExtensionContext, "model" | "modelRegistry">,
+  deps: SessionScanAdapterOptions = {},
+): Promise<SessionScanOutcome> {
+  const llm = createSessionSummarizer(
+    ctx,
+    deps.complete !== undefined ? { complete: deps.complete } : {},
+  );
+  if (!llm) return { kind: "no-model" };
+  // exactOptionalPropertyTypes: only present keys may be spread in.
+  const result = await runSessionScan({
+    sessionsRoot: deps.sessionsRoot ?? resolveSessionsRoot(),
+    vaultRoot: deps.vaultRoot ?? resolveVaultRoot(),
+    summarize: llm.summarize,
+    model: llm.label,
+    ...(deps.maxSessions !== undefined ? { maxSessions: deps.maxSessions } : {}),
+    ...(deps.maxFileBytes !== undefined ? { maxFileBytes: deps.maxFileBytes } : {}),
+    ...(deps.concurrency !== undefined ? { concurrency: deps.concurrency } : {}),
+    ...(deps.now !== undefined ? { now: deps.now } : {}),
+    ...(deps.onProgress !== undefined ? { onProgress: deps.onProgress } : {}),
+    ...(deps.signal !== undefined ? { signal: deps.signal } : {}),
+  });
+  return { kind: "ok", result };
+}
+
+/** One-line human summary of a session-scan result (for notify output). */
+export function formatSessionScanResult(result: SessionScanResult): string {
+  const parts = [
+    `${result.written} summarized (${result.created} new, ${result.updated} updated)`,
+    `${result.skippedFresh} unchanged`,
+  ];
+  if (result.skippedEmpty > 0) parts.push(`${result.skippedEmpty} empty`);
+  if (result.skippedTooBig > 0) parts.push(`${result.skippedTooBig} skipped (size)`);
+  if (result.skippedUnreadable > 0) parts.push(`${result.skippedUnreadable} unreadable`);
+  let text = `${parts.join(", ")} — ${result.considered} sessions considered`;
+  if (result.failed.length > 0) {
+    const [failed0] = result.failed;
+    if (failed0) {
+      text += `; ${result.failed.length} failed, first: ${failed0.path}: ${failed0.error}`;
+    }
+  }
+  return text;
+}

package/src/pi/summarize.ts

@@ -44,9 +44,21 @@ const SYSTEM_PROMPT = [
 const MAX_OUTPUT_TOKENS = 220;
 const REQUEST_TIMEOUT_MS = 30_000;
 
-/** Create the model-backed summarizer, or null when the session has no active model. */
-export function createLlmSummarizer(
+/**
+ * The shared session-model wiring behind every pi-weave summarizer (deep
+ * scan, session scan): resolve the session's already-configured model — no
+ * extra keys or providers (docs/scan-modes.md) — drive completion through
+ * `ctx.modelRegistry`, which owns auth, and reject empty outputs so a
+ * degraded model cannot silently blank a note.
+ *
+ * Returns null when the session has no active model (headless runs without a
+ * provider, etc.) — callers fall back or notify. `deps.complete` is the test
+ * seam: unit tests inject a fake and never touch a network.
+ */
+export function createModelSummarizer(
   ctx: Pick<ExtensionContext, "model" | "modelRegistry">,
+  systemPrompt: string,
+  maxOutputTokens: number,
   deps: SummarizerDeps = {},
 ): LlmSummarizer | null {
   const model = ctx.model;
@@ -58,7 +70,7 @@ export function createLlmSummarizer(
     const message = await complete(
       model,
       {
-        systemPrompt: SYSTEM_PROMPT,
+        systemPrompt,
         messages: [
           {
             role: "user",
@@ -67,7 +79,7 @@ export function createLlmSummarizer(
           },
         ],
       },
-      { maxTokens: MAX_OUTPUT_TOKENS, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) },
+      { maxTokens: maxOutputTokens, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) },
     );
     const text = contentText(message.content).trim();
     if (text.length === 0) {
@@ -78,6 +90,14 @@ export function createLlmSummarizer(
   return { summarize, label };
 }
 
+/** Create the file summarizer for deep scans, or null when no model is active. */
+export function createLlmSummarizer(
+  ctx: Pick<ExtensionContext, "model" | "modelRegistry">,
+  deps: SummarizerDeps = {},
+): LlmSummarizer | null {
+  return createModelSummarizer(ctx, SYSTEM_PROMPT, MAX_OUTPUT_TOKENS, deps);
+}
+
 export type DeepScanOutcome =
   | { kind: "ok"; result: DeepScanResult }
   | { kind: "no-model" }

package/src/pi/tools/noteTool.ts

@@ -5,6 +5,7 @@ import { Type } from "typebox";
 import {
   addNote,
   appendToNote,
+  extractRawTail,
   finalizeNote,
   formatNote,
   formatRawAppend,
@@ -30,7 +31,8 @@ export function registerNoteTool(pi: ExtensionAPI): void {
     description:
       "Read and write notes in the pi-weave vault — a persistent, human-readable knowledge base " +
       "of Markdown notes. Actions: list (all notes), get (one note by slug), add (new note), " +
-      "append (extend a note), finalize (restructure a note above its raw tail), search (title/tags/body). " +
+      "append (extend a note; raw=true appends verbatim dictation into the ## Raw tail), " +
+      "finalize (restructure a note above its raw tail), search (title/tags/body). " +
       "Use it to remember decisions, facts, and user preferences across sessions.",
     promptSnippet: "Remember and retrieve durable knowledge in the pi-weave vault",
     promptGuidelines: [
@@ -43,6 +45,7 @@ export function registerNoteTool(pi: ExtensionAPI): void {
       text: Type.Optional(Type.String({ description: "Markdown body (add), addition (append), or restructured body above the raw tail (finalize)" })),
       tags: Type.Optional(Type.Array(Type.String(), { description: "Tags (add)" })),
       slug: Type.Optional(Type.String({ description: "Note slug (get, append, finalize)" })),
+      raw: Type.Optional(Type.Boolean({ description: "append: add text as verbatim dictation to the ## Raw tail (timestamped fenced block; tail created if missing). Use for dictation/scribbles; omit for structured Markdown additions" })),
       source: Type.Optional(StringEnum(["human", "agent"] as const, { description: "Provenance (add): human for user-scribbled notes, agent for Pi-drafted (default agent)" })),
       query: Type.Optional(Type.String({ description: "Search query (search)" })),
     }),
@@ -117,12 +120,14 @@ export function registerNoteTool(pi: ExtensionAPI): void {
           // Serialized read-modify-write: parallel weave_note appends (and
           // pi's own file tools) targeting the same note would otherwise
           // lose each other's additions.
-          const note = await withMutationQueue(path, () => appendToNote(vault, slug, text));
+          const note = await withMutationQueue(path, () =>
+            appendToNote(vault, slug, text, new Date(), params.raw ? { raw: true } : {}),
+          );
           if (!note) {
             return { content: [{ type: "text", text: `No note found with slug '${params.slug}'.` }], details: { action: "append", found: false } };
           }
           return {
-            content: [{ type: "text", text: `Appended to ${note.slug} (updated ${note.updated}).` }],
+            content: [{ type: "text", text: params.raw ? `Appended verbatim to the ## Raw tail of ${note.slug} (updated ${note.updated}).` : `Appended to ${note.slug} (updated ${note.updated}).` }],
             details: { action: "append", found: true, note },
           };
         }
@@ -150,8 +155,12 @@ export function registerNoteTool(pi: ExtensionAPI): void {
           if (!note) {
             return { content: [{ type: "text", text: `No note found with slug '${params.slug}'.` }], details: { action: "finalize", found: false } };
           }
+          // Be truthful about what was preserved: a note with no `## Raw`
+          // marker yet gets its whole pre-finalize body preserved as a new
+          // raw tail (never silently dropped).
+          const preserved = extractRawTail(note.body) !== "";
           return {
-            content: [{ type: "text", text: `Finalized ${note.slug} (updated ${note.updated}). Raw notes tail preserved.` }],
+            content: [{ type: "text", text: `Finalized ${note.slug} (updated ${note.updated}). ${preserved ? "Raw tail preserved beneath the structured body." : "Note body was empty — nothing to preserve."}` }],
             details: { action: "finalize", found: true, note },
           };
         }

package/src/pi/viewer/tui/branding.ts

@@ -7,7 +7,7 @@
  *   1. "kitty"   — the real raster logo via pi-tui's `Image` component (a small
  *                  ~2×2-cell favicon). The raw JPG is bundled and base64'd once.
  *   2. "glyph"   — a tiny curated Unicode glyph derived from the logo silhouette.
- *   3. "plain"   — `🧵` + wordmark, forced by PI_WEAVE_TUI_PLAIN.
+ *   3. "plain"   — `🕸️` + wordmark, forced by PI_WEAVE_TUI_PLAIN.
  *
  * The line-art/unicode constants contain no ESC by construction (decision 1:
  * the representation fallback is a curated constant, never generated at runtime).
@@ -22,25 +22,26 @@ export type LogoTier = "kitty" | "glyph" | "plain";
 /** A tiny Unicode mark derived from the logo silhouette (decision 1 fallback). */
 export const MARK_GLYPH = "◈";
 /** Absolute last-resort mark (also the forced plain tier). */
-export const PLAIN_MARK = "🧵";
+export const PLAIN_MARK = "🕸️";
 /** The wordmark shown after the mark. */
 export const WORDMARK = "weave view";
 
 /** Env var that forces the plain tier. */
 export const PLAIN_ENV = "PI_WEAVE_TUI_PLAIN";
 
-/** MIME of the bundled raster logo asset (downscaled JPEG of the logo). */
-export const LOGO_MIME = "image/jpeg";
+/** MIME of the bundled raster logo asset (downscaled transparent PNG of the logo). */
+export const LOGO_MIME = "image/png";
 
 /**
- * Bundled downscaled raster copy of `docs/pi-weave-logo.jpg` (32×32, ~1.3 KB).
- * Decision 1 (§15): ship a small raster copy and embed it via pi-tui's `Image`
+ * Bundled downscaled raster copy of `docs/pi-weave-logo.png` (the transparent-
+ * background spider, 32×32, ~1.7 KB). Decision 1 (§15): ship a small raster copy
+ * and embed it via pi-tui's `Image`
  * (Kitty graphics) as a small ~2×2-cell favicon in the header strip — a casual
  * in-bar mark, not a hero splash. Stored base64 so the render path needs no
  * fs/path resolution and the asset is trivially unit-testable.
  */
 export const LOGO_B64 =
-  "/9j/4AAQSkZJRgABAQAASABIAAD/4QDORXhpZgAATU0AKgAAAAgABgESAAMAAAABAAEAAAEaAAUAAAABAAAAVgEbAAUAAAABAAAAXgEoAAMAAAABAAIAAAExAAIAAAAVAAAAZodpAAQAAAABAAAAfAAAAAAAAABIAAAAAQAAAEgAAAABUGl4ZWxtYXRvciBQcm8gMi4xLjMAAAAEkAQAAgAAABQAAACyoAEAAwAAAAEAAQAAoAIABAAAAAEAAAAgoAMABAAAAAEAAAAgAAAAADIwMjY6MDg6MjIgMTk6NTY6MjIA/+0AZFBob3Rvc2hvcCAzLjAAOEJJTQQEAAAAAAAsHAFaAAMbJUccAgAAAgACHAI+AAgyMDI2MDgyMhwCPwALMTk1NjIyKzAwMDA4QklNBCUAAAAAABBB7D4+CxrdyaRylkhoEmIW/8AAEQgAIAAgAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/bAEMAAgICAgICAwICAwUDAwMFBgUFBQUGCAYGBgYGCAoICAgICAgKCgoKCgoKCgwMDAwMDA4ODg4ODw8PDw8PDw8PD//bAEMBAgICBAQEBwQEBxALCQsQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEP/dAAQAAv/aAAwDAQACEQMRAD8A/E8Lk4rQsocXcD46SIf/AB4VDbpvYDua95+HfhtZtHn8QpBbXEdvKyM00iKW2RtKY4Vcjc+xGY45wAByQD62FwzqO17Luc0pWPC7yHNzM2Orsf1NUGXBxXu/xH8O/Y7Cy114baCG9m8oNBIrbCYlmCTKmdr7JEbHJwcH5gQPEZ02sR6UsThnTdr3XcIyuf/Q/GHT/JkcQzbQpO7Lccjtn3r0Dwv/AG1fMdH0e+e1e+kRTaEM4uZwTtBXhSRk7c8YOO/PlwJByK14dZvI7dbXcDEpJAKjv79ccetezQxfLHlZw1acn8L1PTPE+nanZpb2Wr6i99JBkw2gV4xbzSk8KuGA3BckgYKjGQMVzPjG70+ygh8LaXFZSQWshuGurdd8kkkqDKGY5YqgABUfKH3ECsW48U6vcWs1k02IbjbvUKBnb0AOMgdsA4xxXOE55oxGJ5lZDjRVk5atH//Z";
+  "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";
 
 /** Terminal capability surface branding probes. */
 export interface BrandCapabilities {

package/src/pi/viewer/tui/explorer.ts

@@ -263,7 +263,7 @@ export class WeaveExplorer implements Component {
 
   private renderHeader(width: number): string[] {
     const t = this.theme;
-    const line1 = t.bold(`🧵 weave view — data as of ${this.model.generatedAt || "now"}`) + `  ${this.surfaceName()}`;
+    const line1 = t.bold(`🕸️ weave view — data as of ${this.model.generatedAt || "now"}`) + `  ${this.surfaceName()}`;
     const counts = this.countNotes();
     const repo = this.model.nodes.find((n) => n.kind === "repository");
     const repoState = this.model.staleness?.state ?? (repo ? "fresh" : "missing");