copilot.tools 1.0.0 → 3.0.1

package/CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to this package.
 
 ---
 
+## [3.0.1] — 2026-07-13
+
+### Added
+- README: "Looking for Copilot version" changed to level 2 header
+
 ## [3.0.0] — 2026-07-13
 
 ### ⚠️ BREAKING CHANGES

package/README.md

@@ -9,7 +9,7 @@ Cross-platform — works on Windows, macOS, and Linux.
 ## What's inside
 
 ```
-copilot.history/
+copilot.tools/
 ├── _list_sessions.js            # Internal: reads Copilot session database
 ├── package.json                 # npm package config
 ├── tools-install.js             # Cross-platform installer (copies skills globally)
@@ -29,7 +29,7 @@ copilot.history/
 1. Open a terminal (Windows PowerShell, Command Prompt, macOS Terminal, or Linux shell).
 2. Run:
    ```bash
-   npm install -g copilot.history
+   npm install -g copilot.tools
    ```
 
 ### Verify Installation
@@ -54,6 +54,11 @@ After installation:
    - `/snapshot` — Toggle automatic pre-edit file backups
    - `/teach-me` — Start an interactive code quiz
 
+## Looking for Copilot version
+
+This tool pack is also available for Codewhale. Find it at:
+[https://www.npmjs.com/package/codewhale.history](https://www.npmjs.com/package/codewhale.history)
+
 ## Skills Reference
 
 ### `/tools`
@@ -106,86 +111,6 @@ An interactive code-teaching quiz that randomly selects real snippets from your
 - **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 |
@@ -197,8 +122,7 @@ current project.  Two independent dimensions across five difficulty levels:
 | `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`
+**Triggers:** `teach me` · `quiz me` · `test my knowledge` · `code quiz` · `drill me`
 
 **Modifiers (combine freely):**
 
@@ -223,46 +147,41 @@ current project.  Two independent dimensions across five difficulty levels:
 | 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.
+**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.
 
 ## 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)
+- **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).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilot.tools",
-  "version": "1.0.0",
+  "version": "3.0.1",
   "description": "Copilot skills: /tools, /history, /snapshot, /teach-me — session tracking, file snapshots, interactive code quiz — global install",
   "bin": {
     "copilot-history": "./_list_sessions.js",