copilot.tools 1.0.0

package/README.md

@@ -0,0 +1,268 @@
+# Copilot Tools Pack
+
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+
+A portable pack of global GitHub Copilot skills: `/tools`, `/history`, `/snapshot`, and `/teach-me`.
+
+Cross-platform — works on Windows, macOS, and Linux.
+
+## What's inside
+
+```
+copilot.history/
+├── _list_sessions.js            # Internal: reads Copilot session database
+├── package.json                 # npm package config
+├── tools-install.js             # Cross-platform installer (copies skills globally)
+├── skills/
+│   ├── history/SKILL.md         # /history — lists Copilot chat sessions
+│   ├── snapshot/SKILL.md        # /snapshot — pre-edit file backups
+│   ├── teach-me/SKILL.md        # /teach-me — interactive code quiz
+│   └── tools/tools-skill/SKILL.md  # /tools — lists available tools
+├── README.md                    # This file
+└── CHANGELOG.md                 # Version history
+```
+
+## Install
+
+### Global Installation
+
+1. Open a terminal (Windows PowerShell, Command Prompt, macOS Terminal, or Linux shell).
+2. Run:
+   ```bash
+   npm install -g copilot.history
+   ```
+
+### Verify Installation
+
+Skills are automatically copied to `~/.copilot/skills/` and will be auto-discovered by GitHub Copilot:
+
+- **Windows**: `C:\Users\<username>\.copilot\skills\`
+- **macOS/Linux**: `~/.copilot/skills/`
+
+To verify, check that the directory exists and contains 4 subdirectories: `history`, `snapshot`, `teach-me`, `tools`.
+
+## How to use
+
+After installation:
+
+1. **Open VS Code** with the GitHub Copilot extension installed.
+2. **Open the Copilot Chat panel** (Ctrl+Shift+I / Cmd+Shift+I).
+3. **Type `/`** to see available skills.
+4. **Select a skill** or type the full command:
+   - `/tools` — List all available tools
+   - `/history` — Show Copilot chat session history with tokens and costs
+   - `/snapshot` — Toggle automatic pre-edit file backups
+   - `/teach-me` — Start an interactive code quiz
+
+## Skills Reference
+
+### `/tools`
+
+Lists every tool available in the current Copilot session, grouped by category (File I/O, Search, Git, Sub-agents, Shell, Planning, etc.), with a brief description of what each tool does. Read-only — no files touched.
+
+**`/tools help`** or **`/tools readme`** — Displays the full tools documentation.
+
+### `/history`
+
+Lists all Copilot chat sessions with metadata:
+
+- **Date/time** — When the session was created
+- **Title** — Session title or first message
+- **Messages** — Message count in that session
+- **Tokens** — Tokens consumed (with thousands separators)
+- **Cost** — Estimated session cost in USD
+- **Model** — Which LLM was used
+
+A **TOTAL** row summarizes across all sessions: total count, total messages, total tokens, and total cost.
+
+**Note:** Session data is read from Copilot's SQLite database (`session-store.db`), which persists across VS Code restarts. Token counts and costs reflect actual Copilot API usage.
+
+### `/snapshot`
+
+Toggle automatic pre-edit file backups:
+- **`/snapshot on`** — Enable backups
+- **`/snapshot off`** — Disable backups
+- **`/snapshot status`** — Show current status
+
+**Why use this:** Snapshot is designed for folders that are **not** Git repos — especially folders with Office documents (`.docx`, `.pptx`, `.xlsx`, `.pdf`) that Copilot is about to edit. Before every modification, snapshot saves a timestamped copy into `_snapshots/` so you can always recover the pre-AI version:
+
+```
+report.docx  →  _snapshots/report.2026-06-21_14-30-00.docx
+```
+
+If the workspace already has a `.git` directory, snapshot politely declines — Git already has your back.
+
+### `/teach-me`
+
+An interactive code-teaching quiz that randomly selects real snippets from your current project. Two independent dimensions across five difficulty levels:
+
+**Response mode** (how you answer):
+- **Passive** (default) — Describe your answer in the chat.
+- **Interactive** (`teach me interactive`) — Edit the actual file, then say `done`.
+
+**Content theme** (what it's about):
+- **Standard** (default) — Code comprehension or line reconstruction.
+- **SOLID** (`teach me solid`) — Anti-pattern detection and design restoration.
+- **Spec** (`teach me spec`) — Spec-to-code traceability using office docs as source.
+- **BA-Gates** (`teach me ba`) — BA documentation quality analysis (ambiguity, AC completeness, edge case coverage).
+
+**Examples:**
+- `/teach-me` — Standard code quiz, passive mode
+- `/teach-me level 4` — Difficulty 4, standard theme
+- `/teach-me python interactive` — Python code, edit mode
+- `/teach-me solid` — SOLID anti-pattern restoration, passive
+- `/teach-me spec interactive` — Spec↔code traceability, edit mode
+- `/teach-me ba level 2` — BA documentation quality, difficulty 2
+
+**Mid-session commands:** `hint` · `skip` · `next` · `level 3` · `easier` · `harder` · `interactive` · `passive` · `done` · `stop`
+
+**Difficulty levels:**
+
+| Level | Line range | What you'll face |
+|-------|-----------|-------────────|
+| 1 | 5–15 | Straight-line logic, if/else, basic function calls |
+| 2 | 8–20 | Loops, list/dict operations, simple try/except |
+| 3 | 12–30 | Comprehensions, decorators, with statements, multiple branches |
+| 4 | 18–45 | Generators, async/await, descriptors, threading, closures |
+| 5 | 25–55 | Metaclasses, complex async patterns, multi-threading, architectural glue |
+
+**In SOLID theme:** the model rewrites code with deliberate anti-patterns (STUPID, WET, god objects, tight coupling), presents the degraded code, and you restore good design.
+
+**In Spec theme:** the model scans your office documents (`.docx`, `.pptx`, `.xlsx`) and source code, then quizzes you on the correlation between them. Each round randomly picks one direction — either "what code implements this spec?" or "what spec does this code satisfy?"
+
+**In BA-Gates theme:** the model analyzes your BA documentation files (`.docx`, `.pptx`, `.xlsx`, `.md`, `.feature`, `.txt`) against three quality gates: **Ambiguity**, **Acceptance Criteria Completeness**, and **Edge Case Coverage**. You identify which gates a fragment violates and describe the developer impact.
+
+## Requirements
+
+- **Node.js** (version 14 or later) — for the installer and session history lookup
+- **VS Code** (latest version)
+- **GitHub Copilot extension** — installed and authenticated
+- **LLM credits/API key** — configured in your Copilot settings (enterprise or personal)
+
+## Troubleshooting
+
+### Skills not showing up in Copilot
+
+1. Verify installation: Check that `~/.copilot/skills/` exists with 4 subdirectories.
+2. Restart VS Code completely (not just the Copilot chat panel).
+3. In Copilot chat, type `/` to see if skills appear in autocomplete.
+
+### `/history` shows "No sessions found"
+
+This is normal for a fresh Copilot install. Start a new chat session in Copilot, then run `/history` again — it will show the new session.
+
+### `/teach-me` can't find code in my project
+
+Make sure your project files are open in the VS Code workspace. The quiz needs access to the actual code files to select snippets.
+
+## Contact & License
+
+Developer: [species8472](mailto:swyuri@yahoo.com)
+
+Copyright © 2026 Celestial Consulting Ltd. Licensed under the [GNU Affero General Public License v3.0](LICENSE).
+repos — especially folders full of Office documents (`.docx`, `.pptx`, `.xlsx`,
+`.pdf`) that an AI agent is about to edit. Before every file modification,
+snapshot saves a timestamped copy into `_snapshots/` so you can always get back
+to the pre-AI version:
+
+```
+report.docx  →  _snapshots/report.2026-06-21_14-30-00.docx
+```
+
+If the workspace already has a `.git` directory, snapshot politely declines —
+Git already has your back.
+
+### `//teach-me`
+An interactive code-teaching quiz that randomly selects real snippets from your
+current project.  Two independent dimensions across five difficulty levels:
+
+**Response mode** (how you answer):
+- **Passive** (default) — Describe your answer in the console.
+- **Interactive** (`teach me interactive`) — Edit the actual file, say `done`.
+
+**Content theme** (what it's about):
+- **Standard** (default) — Code comprehension or line reconstruction.
+- **SOLID** (`teach me solid`) — Anti-pattern detection and design restoration.
+- **Spec** (`teach me spec`) — Spec-to-code traceability using office docs as source.
+- **BA-Gates** (`teach me ba`) — BA documentation quality analysis (ambiguity, AC completeness, edge case coverage).
+
+| Trigger | Response | Theme | What happens |
+|---------|----------|-------|-------------|
+| `teach me` | passive | standard | Present code; you explain it |
+| `teach me interactive` | interactive | standard | Lines removed; you restore them |
+| `teach me solid` | passive | solid | Degraded code; you describe fixes |
+| `teach me solid interactive` | interactive | solid | Degraded code; you edit to fix it |
+| `teach me spec` | passive | spec | Two directions: spec→code (show requirement, you find the code) or code→spec (show code, you name the requirement) |
+| `teach me spec interactive` | interactive | spec | Two directions: spec→code (edit code to satisfy a spec) or code→spec (edit spec to match the code) |
+| `teach me ba` | passive | ba-gates | BA doc fragment; you identify quality gate violations |
+| `teach me ba interactive` | interactive | ba-gates | BA doc with issues; you edit to fix them |
+
+**Triggers:** `teach me` · `quiz me` · `test my knowledge` · `code quiz` ·
+`drill me`
+
+**Modifiers (combine freely):**
+
+| Modifier | Example | What it does |
+|----------|---------|-------------|
+| Language | `teach me python` | Restrict to Python, TypeScript, Rust, Go, Java… |
+| Level | `teach me level 3` or `teach me l3` | Set difficulty 1–5 (default: 3) |
+| Response | `teach me interactive` | Edit the file instead of describing |
+| Theme | `teach me solid` | Anti-pattern detection — fix degraded design |
+| Theme | `teach me spec` | Spec↔code traceability — either direction (show spec, find the code; or show code, name the requirement) |
+| Theme | `teach me ba` | BA documentation quality analysis |
+| Scope | `teach me services/` | Narrow to a specific file or folder |
+| Concept | `teach me decorators` | Target: decorators, async, generators, context managers, comprehensions, error handling, type hints, threading |
+
+**Difficulty levels:**
+
+| Level | Line range | What you'll face |
+|-------|-----------|------------------|
+| 1 | 5–15 | Straight-line logic, `if`/`else`, basic function calls |
+| 2 | 8–20 | Loops, list/dict operations, simple `try`/`except` |
+| 3 | 12–30 | Comprehensions, decorators, `with` statements, multiple branches |
+| 4 | 18–45 | Generators, `async`/`await`, descriptors, threading, closures |
+| 5 | 25–55 | Metaclasses, complex async patterns, multi-threading, architectural glue |
+
+**Mid-round commands:** `hint` (get a nudge) · `skip` (see the answer) ·
+`next` (draw a new snippet) · `level N` · `easier` · `harder` ·
+`interactive` · `passive` · `solid` · `spec` · `ba` · `done` (verify work) · `stop`
+
+**At the end** you get a session summary: rounds completed, mode, files covered,
+what you're strong on, what to review, and a suggested next level.
+
+In **SOLID theme**: the model rewrites code with deliberate anti-patterns
+(STUPID, WET, god objects, tight coupling), presents the degraded code, and you
+restore good design. Files are always restored with `git checkout` after each
+round.
+
+In **Spec theme**: the model scans your office documents (`.docx`, `.pptx`,
+`.xlsx`) and source code, then quizzes you on the correlation between them.
+Each round randomly picks one direction — either "what code implements this
+spec?" or "what spec does this code satisfy?" — testing whether you truly
+understand how requirements map to implementation. In interactive mode, you
+edit the code to satisfy the spec; in passive mode, you describe the link.
+
+In **BA-Gates theme**: the model runs a two-pass analysis over your BA documentation
+files (`.docx`, `.pptx`, `.xlsx`, `.md`, `.feature`, `.txt`). Pass 1 uses regex
+triage to flag fragments against three quality gates — **Ambiguity**
+(unmeasurable terms, passive states), **Acceptance Criteria Completeness**
+(missing structure, unverifiable outcomes), and **Edge Case Coverage** (missing
+negative scenarios, error states). Pass 2 runs an LLM interpretation per
+fragment at round time to generate quiz material and concrete improvement
+options. You identify which gates a fragment triggers and describe the developer
+impact. On skip or strike-3, the model presents 2–3 domain-specific rewrites per
+issue with a best-fit recommendation.
+
+## Want to take this further
+If you've enjoyed using //teach-me and want to audit your entire specification repository and get a formatted report with readiness scores, band distributions, and ranked improvement recommendations, check out our licensed product //spec-analysis.  Contact the developer for more info.
+
+## Requirements
+- Node.js (for the `codewhale-history` command)
+- [CodeWhale](https://codewhale.net/en/docs) — install from [codewhale.net](https://codewhale.net/en/docs)
+- An API key for your preferred LLM provider (configured in CodeWhale settings)
+
+## Contact Developer
+[species8472](mailto:swyuri@yahoo.com)
+
+---
+Copyright © 2026 Celestial Consulting Ltd. Licensed under the [GNU Affero General Public License v3.0](LICENSE).

package/_extract_office.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+/**
+ * Copyright (C) 2026 Celestial Consulting Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+/**
+ * Office Document Text Extractor
+ *
+ * Extracts plain text from .docx, .pptx, and .xlsx files.
+ * Pure Node.js — no external dependencies. Handles ZIP/Open XML internally.
+ *
+ * Usage:
+ *   node _extract_office.js <file.docx|pptx|xlsx>
+ *   codewhale-doc-extract <file.docx|pptx|xlsx>
+ */
+
+const fs = require('fs');
+const zlib = require('zlib');
+
+const filePath = process.argv[2];
+if (!filePath) {
+  console.error('Usage: codewhale-doc-extract <file.docx|pptx|xlsx>');
+  process.exit(1);
+}
+
+const ext = filePath.toLowerCase().split('.').pop();
+const buf = fs.readFileSync(filePath);
+
+// ── ZIP parser ─────────────────────────────────────────────────
+function readZip(buffer) {
+  const entries = [];
+  let offset = 0;
+
+  while (offset < buffer.length - 4) {
+    const sig = buffer.readUInt32LE(offset);
+    if (sig !== 0x04034b50) break;
+
+    const compression = buffer.readUInt16LE(offset + 8);
+    const compressedSize = buffer.readUInt32LE(offset + 18);
+    const nameLen = buffer.readUInt16LE(offset + 26);
+    const extraLen = buffer.readUInt16LE(offset + 28);
+
+    const name = buffer.toString('utf-8', offset + 30, offset + 30 + nameLen);
+    const dataStart = offset + 30 + nameLen + extraLen;
+
+    let data;
+    if (compression === 0) {
+      data = buffer.slice(dataStart, dataStart + compressedSize);
+    } else if (compression === 8) {
+      const raw = buffer.slice(dataStart, dataStart + compressedSize);
+      data = zlib.inflateRawSync(raw);
+    } else {
+      offset = dataStart + compressedSize;
+      continue;
+    }
+
+    entries.push({ name, data: data.toString('utf-8') });
+    offset = dataStart + compressedSize;
+  }
+
+  return entries;
+}
+
+// ── XML text stripper ──────────────────────────────────────────
+function stripXml(xml) {
+  return xml
+    .replace(/<[^>]+>/g, ' ')
+    .replace(/&amp;/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'")
+    .replace(/&#?\w+;/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+// ── Format-specific extraction ─────────────────────────────────
+const entries = readZip(buf);
+let text = '';
+
+if (ext === 'docx') {
+  const doc = entries.find(e => e.name === 'word/document.xml');
+  if (doc) text = stripXml(doc.data);
+
+  for (const e of entries) {
+    if (e.name.startsWith('word/header') || e.name.startsWith('word/footer')) {
+      text += '\n' + stripXml(e.data);
+    }
+  }
+} else if (ext === 'pptx') {
+  const slides = entries
+    .filter(e => /^ppt\/slides\/slide\d+\.xml$/.test(e.name))
+    .sort((a, b) => {
+      const na = parseInt(a.name.match(/slide(\d+)/)[1]);
+      const nb = parseInt(b.name.match(/slide(\d+)/)[1]);
+      return na - nb;
+    });
+
+  for (let i = 0; i < slides.length; i++) {
+    text += '\n--- Slide ' + (i + 1) + ' ---\n';
+    text += stripXml(slides[i].data) + '\n';
+  }
+
+  for (const e of entries) {
+    if (e.name.startsWith('ppt/notesSlides/notesSlide')) {
+      text += '\n[Notes]\n' + stripXml(e.data) + '\n';
+    }
+  }
+} else if (ext === 'xlsx') {
+  const sst = entries.find(e => e.name === 'xl/sharedStrings.xml');
+  const strings = sst ? extractSharedStrings(sst.data) : [];
+
+  const sheets = entries
+    .filter(e => /^xl\/worksheets\/sheet\d+\.xml$/.test(e.name))
+    .sort((a, b) => {
+      const na = parseInt(a.name.match(/sheet(\d+)/)[1]);
+      const nb = parseInt(b.name.match(/sheet(\d+)/)[1]);
+      return na - nb;
+    });
+
+  for (let i = 0; i < sheets.length; i++) {
+    text += '\n--- Sheet ' + (i + 1) + ' ---\n';
+    text += renderSheet(sheets[i].data, strings) + '\n';
+  }
+} else {
+  console.error('Unsupported format. Use .docx, .pptx, or .xlsx');
+  process.exit(1);
+}
+
+console.log(text.trim());
+
+// ── XLSX helpers ───────────────────────────────────────────────
+function extractSharedStrings(xml) {
+  const matches = xml.match(/<si>([\s\S]*?)<\/si>/g) || [];
+  return matches.map(si => stripXml(si));
+}
+
+function renderSheet(sheetXml, strings) {
+  const rows = sheetXml.match(/<row[\s\S]*?<\/row>/g) || [];
+  let output = '';
+  for (const row of rows) {
+    const cells = row.match(/<c[^>]*>[\s\S]*?<\/c>/g) || [];
+    const rowValues = [];
+    for (const cell of cells) {
+      const tMatch = cell.match(/t="([^"]*)"/);
+      const type = tMatch ? tMatch[1] : null;
+      const vMatch = cell.match(/<v>([^<]*)<\/v>/);
+      if (!vMatch) continue;
+      if (type === 's') {
+        const idx = parseInt(vMatch[1]);
+        rowValues.push(strings[idx] || '');
+      } else {
+        rowValues.push(vMatch[1]);
+      }
+    }
+    if (rowValues.some(v => v.trim())) {
+      output += rowValues.join(' | ') + '\n';
+    }
+  }
+  return output;
+}

package/_list_sessions.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+/**
+ * Copyright (C) 2026 Celestial Consulting Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+/**
+ * Copilot Session Lister
+ * Queries Copilot's SQLite session database to display all chat sessions
+ * with tokens consumed, cost, and model information.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Determine platform-specific path to Copilot's session store
+const getSessionDbPath = () => {
+  const home = os.homedir();
+  if (process.platform === 'win32') {
+    return path.join(home, 'AppData', 'Roaming', 'Code', 'User', 'globalStorage', 'github.copilot-chat', 'session-store.db');
+  } else {
+    const baseDir = process.platform === 'darwin'
+      ? path.join(home, 'Library', 'Application Support')
+      : path.join(home, '.config');
+    return path.join(baseDir, 'Code', 'User', 'globalStorage', 'github.copilot-chat', 'session-store.db');
+  }
+};
+
+const dbPath = getSessionDbPath();
+
+// Check if database exists
+if (!fs.existsSync(dbPath)) {
+  console.log('No Copilot sessions found.');
+  process.exit(0);
+}
+
+// Try to use better-sqlite3 for fast synchronous access
+let db;
+try {
+  const Database = require('better-sqlite3');
+  db = new Database(dbPath, { readonly: true });
+} catch (err) {
+  // Fall back to sqlite3 async
+  try {
+    const sqlite3 = require('sqlite3').verbose();
+    queryWithAsync(sqlite3);
+    process.exit(0);
+  } catch (err2) {
+    console.error('');
+    console.error('❌ Cannot query Copilot session database.');
+    console.error('Required: Install sqlite3 package');
+    console.error('');
+    console.error('Run: npm install better-sqlite3');
+    console.error('');
+    console.error('Database location:', dbPath);
+    process.exit(1);
+  }
+}
+
+// Query synchronously with better-sqlite3
+if (db) {
+  querySessions(db);
+  db.close();
+}
+
+function querySessions(db) {
+  try {
+    // List all tables to understand schema
+    const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' ORDER BY name").all();
+    
+    // Try to find chat sessions in common table names
+    const sessionTable = tables.find(t => t.name.toLowerCase().includes('session') || t.name.toLowerCase().includes('chat'));
+    
+    if (!sessionTable) {
+      console.log('No session data found in Copilot database.');
+      return;
+    }
+
+    // Query the session table
+    const stmt = db.prepare(`SELECT * FROM "${sessionTable.name}" ORDER BY rowid DESC`);
+    const sessions = stmt.all();
+
+    if (sessions.length === 0) {
+      console.log('No Copilot sessions found.');
+      return;
+    }
+
+    const results = [];
+    for (const session of sessions) {
+      // Extract available fields (schema may vary)
+      const created = formatDate(session.created_at || session.createdAt || session.timestamp || new Date());
+      const title = truncate(session.title || session.name || 'Untitled', 30);
+      const msgs = session.message_count || session.messages || 0;
+      const tokens = session.total_tokens || session.tokens || 0;
+      const cost = session.cost_usd || session.cost || 0;
+      const model = session.model || '?';
+
+      console.log(
+        `${created} | ${title} | ${msgs} msgs | ${typeof tokens === 'number' ? tokens.toLocaleString() : tokens} tok | $${parseFloat(cost).toFixed(4)} | ${model}`
+      );
+      results.push({ msgs, tokens, cost: parseFloat(cost) });
+    }
+
+    // Print totals
+    if (results.length > 0) {
+      const totalMsgs = results.reduce((s, r) => s + r.msgs, 0);
+      const totalTokens = results.reduce((s, r) => s + r.tokens, 0);
+      const totalCost = results.reduce((s, r) => s + r.cost, 0);
+      console.log('');
+      console.log(
+        `TOTAL | ${results.length} sessions | ${totalMsgs} msgs | ${totalTokens.toLocaleString()} tok | $${totalCost.toFixed(4)} |`
+      );
+    }
+  } catch (err) {
+    console.error('Error querying Copilot session database:', err.message);
+    process.exit(1);
+  }
+}
+
+function queryWithAsync(sqlite3) {
+  const db = new sqlite3.Database(dbPath, sqlite3.OPEN_READONLY, (err) => {
+    if (err) {
+      console.error('Error opening database:', err);
+      process.exit(1);
+    }
+
+    db.all("SELECT name FROM sqlite_master WHERE type='table'", (err, tables) => {
+      if (err) {
+        console.error('Error reading schema:', err);
+        db.close();
+        process.exit(1);
+      }
+
+      const sessionTable = tables?.find(t => t.name.toLowerCase().includes('session')) || tables?.[0];
+      if (!sessionTable) {
+        console.log('No session data found.');
+        db.close();
+        return;
+      }
+
+      db.all(`SELECT * FROM "${sessionTable.name}" ORDER BY rowid DESC`, (err, sessions) => {
+        if (err || !sessions || sessions.length === 0) {
+          console.log('No Copilot sessions found.');
+          db.close();
+          return;
+        }
+
+        const results = [];
+        for (const session of sessions) {
+          const created = formatDate(session.created_at || session.createdAt || session.timestamp || new Date());
+          const title = truncate(session.title || session.name || 'Untitled', 30);
+          const msgs = session.message_count || session.messages || 0;
+          const tokens = session.total_tokens || session.tokens || 0;
+          const cost = session.cost_usd || session.cost || 0;
+          const model = session.model || '?';
+
+          console.log(
+            `${created} | ${title} | ${msgs} msgs | ${typeof tokens === 'number' ? tokens.toLocaleString() : tokens} tok | $${parseFloat(cost).toFixed(4)} | ${model}`
+          );
+          results.push({ msgs, tokens, cost: parseFloat(cost) });
+        }
+
+        if (results.length > 0) {
+          const totalMsgs = results.reduce((s, r) => s + r.msgs, 0);
+          const totalTokens = results.reduce((s, r) => s + r.tokens, 0);
+          const totalCost = results.reduce((s, r) => s + r.cost, 0);
+          console.log('');
+          console.log(
+            `TOTAL | ${results.length} sessions | ${totalMsgs} msgs | ${totalTokens.toLocaleString()} tok | $${totalCost.toFixed(4)} |`
+          );
+        }
+
+        db.close();
+      });
+    });
+  });
+}
+
+function formatDate(dateInput) {
+  let date;
+  if (typeof dateInput === 'string') {
+    date = new Date(dateInput);
+  } else if (typeof dateInput === 'number') {
+    date = new Date(dateInput * 1000); // SQLite timestamps are seconds
+  } else {
+    date = dateInput;
+  }
+  return date.toISOString().substring(0, 16);
+}
+
+function truncate(str, len) {
+  return str.length > len ? str.substring(0, len - 3) + '...' : str;
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "copilot.tools",
+  "version": "1.0.0",
+  "description": "Copilot skills: /tools, /history, /snapshot, /teach-me — session tracking, file snapshots, interactive code quiz — global install",
+  "bin": {
+    "copilot-history": "./_list_sessions.js",
+    "copilot-tools-install": "./tools-install.js",
+    "copilot-doc-extract": "./_extract_office.js"
+  },
+  "files": [
+    "_list_sessions.js",
+    "_extract_office.js",
+    "tools-install.js",
+    "README.md",
+    "CHANGELOG.md",
+    "skills"
+  ],
+  "scripts": {
+    "postinstall": "node ./tools-install.js"
+  },
+  "engines": {
+    "node": ">=14"
+  }
+}