pi-context-map 0.1.4 → 0.2.0

package/CHANGELOG.md

@@ -1,27 +1,15 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
-
-## [0.1.4] - 2026-06-14
-### Fixed
-- Fixed a critical runtime crash in `pi-coding-agent` caused by an incompatible manifest format in `package.json`. Changed extension declaration to a simple path array.
-
-## [0.1.3] - 2026-06-14
-### Fixed
-- Aligned package manifest with official Pi specifications.
-- Moved core libraries to `peerDependencies` to prevent bundling conflicts.
-
-## [0.1.2] - 2026-06-14
-### Added
-- Professional README.md with badges and usage guides.
-- MIT License.
-
-## [0.1.1] - 2026-06-14
-### Added
-- Initial release of the context mapping logic.
-- Integration with the Pi extension API.
-
-## [0.1.0] - 2026-06-14
+## [0.2.0] - 2026-06-14
+### Professional Context Profiler
+- **Architectural Modernization**: Migrated to source-shipping (`./extensions`) and async factory function pattern.
+- **Nexus Synergy**: Optimized for compatibility with the Nexus monorepo (e.g., `pi-ultra-compact`).
+- **TUI Integration**: Refined command registration for seamless discovery in the Pi command palette.
+- **LSP Clean**: Resolved type mismatches with the latest `pi-coding-agent` API.
+
+## [0.1.4] - 2026-06-13
 ### Initial Release
-- Implementation of `ContextAnalyzer` and `ReportGenerator`.
-- Basic `/context-map` command functionality.
+- Visual context window mapping and token distribution dashboard.
+- Categorization of files as `Active`, `Stale`, or `Legacy`.
+- Operation tracking and temporal mapping for compaction candidates.
+- Standalone HTML report generation at `~/.pi/context-map/report.html`.

package/package.json

@@ -1,33 +1,37 @@
 {
   "name": "pi-context-map",
-  "version": "0.1.4",
-  "description": "A Pi extension that visualizes the current session context window and token distribution.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc -w"
-  },
+  "version": "0.2.0",
+  "description": "Professional context profiler for Pi that visualizes the session context window, token distribution, and integrates with Nexus packages for actionable insights.",
   "keywords": [
-    "pi",
     "pi-package",
-    "extension",
     "context",
     "visualization",
-    "tokens"
+    "tokens",
+    "profiler",
+    "nexus"
   ],
-  "author": "ZachDreamZ",
-  "license": "MIT",
   "pi": {
-    "extensions": ["dist/index.js"]
+    "extensions": ["./extensions"]
+  },
+  "files": [
+    "extensions",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
   },
-  "dependencies": {},
   "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*"
+    "pi-coding-agent": "*"
   },
   "devDependencies": {
     "typescript": "^5.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
     "@types/node": "^20.0.0"
   }
 }

package/dist/analyzer.d.ts

@@ -1,40 +0,0 @@
-/**
- * ContextAnalyzer
- * Responsible for parsing Pi session messages to identify the active working set of files,
- * their token weights, and their temporal status.
- */
-export interface FileOp {
-    type: "read" | "write" | "edit" | "delete";
-    turn: number;
-    timestamp: number;
-}
-export interface FileContext {
-    path: string;
-    weight: number;
-    lastOp: FileOp;
-    status: "active" | "stale" | "legacy";
-}
-export interface ContextMap {
-    files: FileContext[];
-    totalTokens: number;
-    systemTokens: number;
-    historyTokens: number;
-    fileTokens: number;
-    toolTokens: number;
-}
-export declare class ContextAnalyzer {
-    /**
-     * Heuristic for token estimation: approx 4 chars per token.
-     */
-    private static TOKEN_HEURISTIC;
-    /**
-     * Analyze session messages to produce a context map.
-     * @param messages The full session conversation history.
-     * @param currentTurn The current turn number.
-     */
-    analyze(messages: any[], currentTurn: number): ContextMap;
-    private extractPath;
-    private getOpType;
-    private calculateStatus;
-    private findToolResult;
-}

package/dist/analyzer.js

@@ -1,117 +0,0 @@
-"use strict";
-/**
- * ContextAnalyzer
- * Responsible for parsing Pi session messages to identify the active working set of files,
- * their token weights, and their temporal status.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContextAnalyzer = void 0;
-class ContextAnalyzer {
-    /**
-     * Heuristic for token estimation: approx 4 chars per token.
-     */
-    static TOKEN_HEURISTIC = 4;
-    /**
-     * Analyze session messages to produce a context map.
-     * @param messages The full session conversation history.
-     * @param currentTurn The current turn number.
-     */
-    analyze(messages, currentTurn) {
-        const fileRegistry = new Map();
-        let totalTokens = 0;
-        let fileTokens = 0;
-        let toolTokens = 0;
-        messages.forEach((msg, index) => {
-            const turn = index + 1;
-            // Basic token estimation for the message
-            const msgText = typeof msg.content === "string"
-                ? msg.content
-                : JSON.stringify(msg.content);
-            const msgTokens = Math.ceil(msgText.length / ContextAnalyzer.TOKEN_HEURISTIC);
-            totalTokens += msgTokens;
-            if (msg.role === "assistant" && Array.isArray(msg.content)) {
-                for (const block of msg.content) {
-                    if (block.type === "tool_use") {
-                        const input = block.input;
-                        const path = this.extractPath(block.name, input);
-                        if (path) {
-                            const opType = this.getOpType(block.name);
-                            // If the file is already tracked, update it
-                            // Find the tool result for this tool use to get actual content length
-                            const result = this.findToolResult(messages, index, block.id);
-                            const content = result?.content || "";
-                            const weight = Math.ceil(String(content).length / ContextAnalyzer.TOKEN_HEURISTIC);
-                            fileRegistry.set(path, {
-                                path,
-                                weight,
-                                lastOp: {
-                                    type: opType,
-                                    turn,
-                                    timestamp: msg.timestamp || Date.now(),
-                                },
-                                status: this.calculateStatus(turn, currentTurn),
-                            });
-                        }
-                    }
-                }
-            }
-            if (msg.role === "tool") {
-                toolTokens += Math.ceil(String(msg.content).length / ContextAnalyzer.TOKEN_HEURISTIC);
-            }
-        });
-        const files = Array.from(fileRegistry.values());
-        fileTokens = files.reduce((acc, f) => acc + f.weight, 0);
-        return {
-            files: files.sort((a, b) => b.weight - a.weight).slice(0, 100),
-            totalTokens,
-            systemTokens: 0, // Pi provides this via ctx, not messages
-            historyTokens: totalTokens - fileTokens - toolTokens,
-            fileTokens,
-            toolTokens,
-        };
-    }
-    extractPath(toolName, input) {
-        if (toolName === "read" || toolName === "write" || toolName === "edit") {
-            return typeof input.path === "string" ? input.path : null;
-        }
-        if (toolName === "bash") {
-            // Simple regex for paths in bash commands (e.g., cat path/to/file)
-            const match = input.command?.match(/(?:cat|ls|rm|mv|cp|vi|nano)\s+([^\s;]+)/);
-            return match ? match[1] : null;
-        }
-        return null;
-    }
-    getOpType(toolName) {
-        switch (toolName) {
-            case "write":
-                return "write";
-            case "edit":
-                return "edit";
-            case "bash":
-                return "delete"; // Simplified; usually bash implies modification or deletion
-            default:
-                return "read";
-        }
-    }
-    calculateStatus(turn, currentTurn) {
-        const diff = currentTurn - turn;
-        if (diff <= 3)
-            return "active";
-        if (diff <= 10)
-            return "stale";
-        return "legacy";
-    }
-    findToolResult(messages, toolTurnIndex, toolId) {
-        // Look for the tool result immediately following the tool use
-        for (let i = toolTurnIndex + 1; i < messages.length; i++) {
-            if (messages[i].role === "tool" && messages[i].tool_call_id === toolId) {
-                return messages[i];
-            }
-            // If we hit another assistant turn, the result for this specific call is likely gone/compacted
-            if (messages[i].role === "assistant")
-                break;
-        }
-        return null;
-    }
-}
-exports.ContextAnalyzer = ContextAnalyzer;

package/dist/generator.d.ts

@@ -1,11 +0,0 @@
-/**
- * ReportGenerator
- * Generates a visual HTML dashboard based on the ContextMap.
- */
-import type { ContextMap } from "./analyzer";
-export declare class ReportGenerator {
-    static generateHTML(map: ContextMap): string;
-    static writeReport(html: string): string;
-    private static getOpIcon;
-    private static escapeHtml;
-}

package/dist/generator.js

@@ -1,258 +0,0 @@
-"use strict";
-/**
- * ReportGenerator
- * Generates a visual HTML dashboard based on the ContextMap.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReportGenerator = void 0;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
-class ReportGenerator {
-    static generateHTML(map) {
-        const fileCards = map.files
-            .map((file) => `
-			<div class="file-card ${file.status}">
-				<div class="file-header">
-					<span class="file-path">${ReportGenerator.escapeHtml(file.path)}</span>
-					<span class="file-weight">${file.weight.toLocaleString()} tokens</span>
-				</div>
-				<div class="file-footer">
-					<span class="op-badge">${ReportGenerator.getOpIcon(file.lastOp.type)} ${file.lastOp.type}</span>
-					<span class="turn-badge">Turn ${file.lastOp.turn}</span>
-					<span class="status-text">${file.status.toUpperCase()}</span>
-				</div>
-				<div class="weight-bar">
-					<div class="weight-fill" style="width: ${Math.min(100, (file.weight / 1000) * 100)}%"></div>
-				</div>
-			</div>
-		`)
-            .join("");
-        const budgetPercent = (map.fileTokens / map.totalTokens) * 100;
-        return `
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Pi Context Map</title>
-    <style>
-        :root {
-            --bg: #0f172a;
-            --card-bg: #1e293b;
-            --text: #f1f5f9;
-            --text-dim: #94a3b8;
-            --primary: #38bdf8;
-            --active: #22c55e;
-            --stale: #eab308;
-            --legacy: #ef4444;
-            --border: #334155;
-        }
-        body {
-            background: var(--bg);
-            color: var(--text);
-            font-family: 'Inter', -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
-            margin: 0;
-            padding: 2rem;
-            line-height: 1.5;
-        }
-        .container { max-width: 1200px; margin: 0 auto; }
-        header { margin-bottom: 3rem; border-bottom: 1px solid var(--border); padding-bottom: 2rem; }
-        h1 { font-size: 2rem; margin: 0; color: var(--primary); }
-        .stats-grid {
-            display: grid;
-            grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
-            gap: 1.5rem;
-            margin-top: 2rem;
-        }
-        .stat-card {
-            background: var(--card-bg);
-            padding: 1.5rem;
-            border-radius: 12px;
-            border: 1px solid var(--border);
-            text-align: center;
-        }
-        .stat-value { font-size: 1.5rem; font-weight: bold; display: block; }
-        .stat-label { color: var(--text-dim); font-size: 0.875rem; text-transform: uppercase; }
-        
-        .budget-container {
-            margin: 2rem 0;
-            background: var(--card-bg);
-            padding: 1rem;
-            border-radius: 12px;
-            border: 1px solid var(--border);
-        }
-        .budget-bar {
-            height: 24px;
-            background: #020617;
-            border-radius: 12px;
-            display: flex;
-            overflow: hidden;
-            margin-bottom: 0.5rem;
-        }
-        .budget-segment { height: 100%; transition: width 0.3s ease; }
-        .seg-system { background: #6366f1; }
-        .seg-history { background: #a855f7; }
-        .seg-files { background: var(--primary); }
-        .seg-tools { background: #ec4899; }
-        
-        .budget-legend {
-            display: flex;
-            gap: 1rem;
-            justify-content: center;
-            font-size: 0.75rem;
-            color: var(--text-dim);
-        }
-        .legend-item { display: flex; align-items: center; gap: 0.5rem; }
-        .dot { width: 8px; height: 8px; border-radius: 50%; }
-
-        .file-grid {
-            display: grid;
-            grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
-            gap: 1rem;
-        }
-        .file-card {
-            background: var(--card-bg);
-            border: 1px solid var(--border);
-            border-radius: 12px;
-            padding: 1rem;
-            transition: transform 0.2s ease, border-color 0.2s ease;
-            display: flex;
-            flex-direction: column;
-            justify-content: space-between;
-        }
-        .file-card:hover { transform: translateY(-4px); border-color: var(--primary); }
-        .file-header {
-            display: flex;
-            justify-content: space-between;
-            align-items: flex-start;
-            margin-bottom: 1rem;
-        }
-        .file-path {
-            font-family: 'Fira Code', monospace;
-            font-size: 0.875rem;
-            word-break: break-all;
-            margin-right: 1rem;
-            color: var(--text);
-        }
-        .file-weight { font-size: 0.75rem; color: var(--text-dim); white-space: nowrap; }
-        .file-footer {
-            display: flex;
-            justify-content: space-between;
-            align-items: center;
-            margin-top: 1rem;
-            font-size: 0.75rem;
-        }
-        .op-badge {
-            background: #0f172a;
-            padding: 2px 6px;
-            border-radius: 4px;
-            color: var(--text-dim);
-        }
-        .turn-badge { color: var(--text-dim); }
-        .status-text { font-weight: bold; text-transform: uppercase; }
-
-        /* Status Colors */
-        .active { border-left: 4px solid var(--active); }
-        .active .status-text { color: var(--active); }
-        .stale { border-left: 4px solid var(--stale); }
-        .stale .status-text { color: var(--stale); }
-        .legacy { border-left: 4px solid var(--legacy); }
-        .legacy .status-text { color: var(--legacy); }
-
-        .weight-bar {
-            height: 4px;
-            background: #020617;
-            border-radius: 2px;
-            margin-top: 1rem;
-            overflow: hidden;
-        }
-        .weight-fill {
-            height: 100%;
-            background: var(--primary);
-            transition: width 0.3s ease;
-        }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <header>
-            <h1>Pi Context Map</h1>
-            <p style="color: var(--text-dim)">Session context window visualization and token distribution.</p>
-            
-            <div class="stats-grid">
-                <div class="stat-card">
-                    <span class="stat-value">${map.totalTokens.toLocaleString()}</span>
-                    <span class="stat-label">Total Tokens</span>
-                </div>
-                <div class="stat-card">
-                    <span class="stat-value">${map.files.length}</span>
-                    <span class="stat-label">Files in Context</span>
-                </div>
-                <div class="stat-card">
-                    <span class="stat-value">${map.fileTokens.toLocaleString()}</span>
-                    <span class="stat-label">File Tokens</span>
-                </div>
-                <div class="stat-card">
-                    <span class="stat-value">${Math.round(budgetPercent)}%</span>
-                    <span class="stat-label">File Load</span>
-                </div>
-            </div>
-
-            <div class="budget-container">
-                <div class="budget-bar">
-                    <div class="budget-segment seg-system" style="width: ${(map.systemTokens / map.totalTokens) * 100 || 0}%"></div>
-                    <div class="budget-segment seg-history" style="width: ${(map.historyTokens / map.totalTokens) * 100 || 0}%"></div>
-                    <div class="budget-segment seg-files" style="width: ${(map.fileTokens / map.totalTokens) * 100 || 0}%"></div>
-                    <div class="budget-segment seg-tools" style="width: ${(map.toolTokens / map.totalTokens) * 100 || 0}%"></div>
-                </div>
-                <div class="budget-legend">
-                    <div class="legend-item"><span class="dot seg-system"></span> System</div>
-                    <div class="legend-item"><span class="dot seg-history"></span> History</div>
-                    <div class="legend-item"><span class="dot seg-files"></span> Files</div>
-                    <div class="legend-item"><span class="dot seg-tools"></span> Tools</div>
-                </div>
-            </div>
-        </header>
-
-        <div class="file-grid">
-            ${fileCards}
-        </div>
-    </div>
-</body>
-</html>
-`;
-    }
-    static writeReport(html) {
-        const reportDir = (0, node_path_1.join)((0, node_os_1.homedir)(), ".pi", "context-map");
-        (0, node_fs_1.mkdirSync)(reportDir, { recursive: true });
-        const reportPath = (0, node_path_1.join)(reportDir, "report.html");
-        (0, node_fs_1.writeFileSync)(reportPath, html, "utf8");
-        return reportPath;
-    }
-    static getOpIcon(type) {
-        switch (type) {
-            case "read":
-                return "👁️";
-            case "write":
-                return "📝";
-            case "edit":
-                return "✍️";
-            case "delete":
-                return "🗑️";
-            default:
-                return "📄";
-        }
-    }
-    static escapeHtml(text) {
-        const map = {
-            "&": "&amp;",
-            "<": "&lt;",
-            ">": "&gt;",
-            '"': "&quot;",
-            "'": "&#039;",
-        };
-        return text.replace(/[&<>"']/g, (m) => map[m]);
-    }
-}
-exports.ReportGenerator = ReportGenerator;

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * pi-context-map
- * Pi extension to visualize session context window and token distribution.
- */
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-export default function (pi: ExtensionAPI): void;

package/dist/index.js

@@ -1,50 +0,0 @@
-"use strict";
-/**
- * pi-context-map
- * Pi extension to visualize session context window and token distribution.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = default_1;
-const analyzer_1 = require("./analyzer");
-const generator_1 = require("./generator");
-function default_1(pi) {
-    const analyzer = new analyzer_1.ContextAnalyzer();
-    // Register the /context-map command
-    pi.registerCommand("context-map", {
-        description: "Generate a visual map of the current session context window.",
-        handler: (_args, ctx) => {
-            ctx.ui.notify("Analyzing session context...", "info");
-            try {
-                // 1. Extract messages and current turn
-                // Note: We assume ctx.session.messages is available.
-                // If not, we may need to fetch them via another API or use provided event data.
-                const messages = ctx.session.messages || [];
-                const currentTurn = messages.length;
-                if (messages.length === 0) {
-                    ctx.ui.notify("No session history found to map.", "warning");
-                    return;
-                }
-                // 2. Analyze context
-                const map = analyzer.analyze(messages, currentTurn);
-                // 3. Generate HTML Report
-                const html = generator_1.ReportGenerator.generateHTML(map);
-                const reportPath = generator_1.ReportGenerator.writeReport(html);
-                ctx.ui.notify(`Context map generated successfully! \nPath: ${reportPath}`, "success");
-                // Providing a link or instruction to open the report
-                ctx.ui.notify("You can open the report.html in your browser to see the visualization.", "info");
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
-                ctx.ui.notify(`Failed to generate context map: ${message}`, "error");
-            }
-        },
-    });
-    // Optional: Notify the user when a significant amount of context is loaded
-    pi.on("session_before_compact", (event, ctx) => {
-        const { preparation } = event;
-        const tokens = preparation.tokensBefore;
-        if (tokens > 100_000) {
-            ctx.ui.notify(`High context load detected (${(tokens / 1000).toFixed(1)}k tokens). Try /context-map to see what's consuming space.`, "info");
-        }
-    });
-}

package/docs/proposal.md

@@ -1,41 +0,0 @@
-# Proposal: pi-context-map
-
-## 1. Problem Statement
-As Pi sessions grow in complexity, the "Context Window" becomes a black box. Users and agents often lose track of:
-- Which files are currently consuming the most tokens.
-- When a file was last "refreshed" (read) by the agent.
-- The distribution of tokens between history, system prompts, and tool outputs.
-
-This leads to "context bloat," where the agent becomes sluggish or forgets critical instructions because the window is filled with stale file content.
-
-## 2. Goal
-Create a Pi extension that provides a **real-time, visual map of the current session's context**. It should transform the abstract concept of a "token window" into a concrete, actionable dashboard.
-
-## 3. Core Features
-### A. `/context-map` Command
-A command that generates a visual report of the current context.
-
-### B. Context Analysis
-- **File Inventory**: List all files currently in context.
-- **Weight Tracking**: Approximate token count per file.
-- **Status Mapping**:
-    - `Active`: Read/Modified in the last 3 turns.
-    - `Stale`: Read 4-10 turns ago.
-    - `Legacy`: Read >10 turns ago (candidate for compaction).
-- **Operation History**: Mark if a file was Read 🟢, Written 🟠, or Edited 🟡.
-
-### C. Visual Output
-The extension will generate an `index.html` report (stored in `.pi/context-map/report.html`) featuring:
-- **Token Budget Bar**: Visual breakdown of context usage.
-- **File Treemap/List**: Files sized by their token weight.
-- **Temporal Timeline**: A simple timeline showing when files entered the context.
-
-## 4. Success Criteria
-- The user can run `/context-map` and immediately see which file is the "token hog."
-- The user can identify "stale" files that can be removed to free up space.
-- Zero performance degradation during normal session operation.
-- Full compatibility with `pi-ultra-compact` (since both manage context).
-
-## 5. Non-Goals
-- This is a *visualization* tool, not an *automatic* context cleaner (though it provides the data needed for a user to trigger compaction).
-- It will not modify the actual LLM context window, only report on it.

package/docs/spec.md

@@ -1,57 +0,0 @@
-# Technical Specification: pi-context-map
-
-## 1. Architecture Overview
-`pi-context-map` is a Pi extension that analyzes the session message history to derive a "map" of the active context. It operates as a read-only analysis tool triggered by a user command.
-
-## 2. Data Extraction Logic
-When `/context-map` is called, the extension will:
-1. **Scan Messages**: Iterate through all messages in the current session history.
-2. **Identify File Ops**:
-    - Scan `tool_use` blocks for `read`, `write`, `edit`, and `bash` (regex for file paths).
-    - Map each file to its most recent occurrence (turn number).
-3. **Calculate Weights**:
-    - For each file found, retrieve its content length from the corresponding `tool_result` if available.
-    - Estimate tokens using a heuristic: $\text{tokens} \approx \text{chars} / 4$.
-4. **Assign Status**:
-    - **Active**: Turn difference $\le 3$.
-    - **Stale**: $3 <$ Turn difference $\le 10$.
-    - **Legacy**: Turn difference $> 10$.
-
-## 3. Component Design
-
-### A. `ContextAnalyzer` (Class)
-- `analyze(messages: Message[])`: Returns a `ContextMap` object.
-- `calculateTokens(text: string)`: Returns estimated token count.
-- `getFileMetadata(path: string)`: Tracks the operation type and timestamp.
-
-### B. `ReportGenerator` (Class)
-- `generateHTML(map: ContextMap)`: Produces a standalone HTML string.
-- `writeReport(html: string)`: Saves the report to `.pi/context-map/report.html` and opens it.
-
-### C. `ExtensionEntry` (Main)
-- `pi.registerCommand("context-map", ...)`: The entry point.
-- `pi.on("session_before_compact", ...)`: (Optional) Could trigger a map update before compaction.
-
-## 4. Visual Specification (HTML Dashboard)
-The report will be a single-file HTML dashboard with:
-- **Header**: Session ID, Total Estimated Tokens, and Timestamp.
-- **Context Budget**: A CSS-based stacked bar showing:
-    - `[ System ] [ History ] [ Files ] [ Tool Outputs ]`
-- **File Grid**:
-    - Cards for each file.
-    - Size proportional to token weight.
-    - Color-coded by status (Green $\to$ Yellow $\to$ Red).
-    - Icons for operation type (👁️ for read, ✍️ for edit).
-- **Stats Table**:
-    - File Path | Tokens | Last Turn | Status.
-
-## 5. Implementation Details
-- **Language**: TypeScript.
-- **Dependencies**: `@earendil-works/pi-coding-agent`, `node:fs`, `node:path`.
-- **Complexity**: 
-    - Time: $O(N)$ where $N$ is number of messages.
-    - Space: $O(F)$ where $F$ is number of unique files in context.
-
-## 6. Error Handling
-- **Missing Tool Results**: If a file was read but the result is missing (e.g., due to previous compaction), mark weight as "Unknown" and status as "Stale".
-- **Large Repos**: Limit the map to the top 100 largest files to prevent the HTML report from crashing the browser.

package/tasks.md

@@ -1,32 +0,0 @@
-# Implementation Tasks: pi-context-map
-
-## Phase 1: Foundation
-- [ ] Initialize `package.json` and TypeScript config.
-- [ ] Create project folder structure (`src/`, `docs/`).
-
-## Phase 2: Core Logic (`ContextAnalyzer`)
-- [ ] Implement message scanning logic to find file operations.
-- [ ] Implement token estimation heuristic.
-- [ ] Implement status assignment (Active/Stale/Legacy).
-- [ ] Create unit tests for analyzer logic.
-
-## Phase 3: Visualization (`ReportGenerator`)
-- [ ] Design the HTML dashboard template.
-- [ ] Implement data-to-HTML mapping.
-- [ ] Implement file writing to `.pi/context-map/report.html`.
-
-## Phase 4: Pi Integration
-- [ ] Register `/context-map` command.
-- [ ] Implement command handler that triggers analysis $\to$ report $\to$ notification.
-- [ ] Add "Open Report" link in the Pi notification.
-
-## Phase 5: QA & Polishing
-- [ ] Test with high-token sessions.
-- [ ] Verify accuracy of token weights.
-- [ ] Run Pi Lens diagnostics to ensure zero blockers.
-- [ ] Polish HTML CSS for "Architect" look.
-
-## Phase 6: Release
-- [ ] Update README.md.
-- [ ] Publish to npm.
-- [ ] Final GitHub release.

package/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "baseUrl": ".",
-    "paths": {
-      "*": ["src/types/*"]
-    }
-  },
-  "include": ["src/**/*"],
-  "typeRoots": ["./node_modules/@types", "src/types"]
-}