devcoach 0.3.60 → 0.3.62

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +44 -2
  2. package/dist/bin.js +7 -7
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,10 @@
2
2
 
3
3
  [![npm](https://img.shields.io/npm/v/devcoach?logo=npm)](https://www.npmjs.com/package/devcoach)
4
4
  [![CI](https://github.com/UltimaPhoenix/dev-coach/actions/workflows/ci.yml/badge.svg)](https://github.com/UltimaPhoenix/dev-coach/actions/workflows/ci.yml)
5
+ [![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=UltimaPhoenix_dev-coach&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=UltimaPhoenix_dev-coach)
6
+ [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=UltimaPhoenix_dev-coach&metric=coverage)](https://sonarcloud.io/summary/new_code?id=UltimaPhoenix_dev-coach)
5
7
  [![Node](https://img.shields.io/badge/node-%E2%89%A524-brightgreen?logo=node.js)](https://nodejs.org/)
8
+ [![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-purple)](https://ultimaphoenix.github.io/dev-coach/)
6
9
  [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
7
10
 
8
11
  **Progressive technical coaching that lives inside your AI agent.** devcoach connects to Claude Code, Claude Desktop, Cursor, Windsurf, and other MCP-compatible tools. After every task you complete, it delivers a short targeted lesson calibrated to what you already know — no generic tutorials, no repeated topics, nothing to open.
@@ -13,6 +16,14 @@ Everything runs **locally**. No data leaves your machine. One SQLite file at `~/
13
16
 
14
17
  ---
15
18
 
19
+ ## Why devcoach?
20
+
21
+ AI agents now write much of our code — which makes it easy to ship more while understanding less. devcoach turns each task your agent finishes into one short, in-context lesson, so you keep learning as you go. The deeper bet: as AI grows more capable, the scarce skill becomes *validating* what it produces — and that ability only survives if you keep practicing it.
22
+
23
+ → [Why devcoach exists](docs/why.md)
24
+
25
+ ---
26
+
16
27
  ## How it works
17
28
 
18
29
  ```mermaid
@@ -46,6 +57,7 @@ flowchart TD
46
57
  |--------|---------|--------------|
47
58
  | **npx** (no install) | _(used directly in the MCP config below)_ | Node.js ≥ 24 |
48
59
  | **npm** (global) | `npm install -g devcoach` | Node.js ≥ 24 |
60
+ | **Homebrew** (macOS/Linux) | `brew install UltimaPhoenix/tap/devcoach` | Homebrew (pulls Node in automatically) |
49
61
  | **Desktop Extension** (`.mcpb`) | one-click — see below | Claude Desktop (bundles its own Node) |
50
62
 
51
63
  The recommended path is **npx** — no global install, always the latest version, used directly in your agent's MCP config.
@@ -66,6 +78,35 @@ needed for a verified signature). Prebuilt `.mcpb` releases and a Desktop direct
66
78
 
67
79
  </details>
68
80
 
81
+ <details>
82
+ <summary><strong>Homebrew tap</strong> (macOS / Linux)</summary>
83
+
84
+ devcoach ships from its own tap, so add and trust the repository once, then install:
85
+
86
+ ```bash
87
+ # 1. Add the tap — registers github.com/UltimaPhoenix/homebrew-tap with Homebrew
88
+ brew tap UltimaPhoenix/tap
89
+
90
+ # 2. Trust the whole tap — required when Homebrew enforces HOMEBREW_REQUIRE_TAP_TRUST
91
+ brew trust --tap UltimaPhoenix/tap
92
+
93
+ # 3. Install
94
+ brew install devcoach
95
+ ```
96
+
97
+ `brew tap` registers the third-party repository; `brew trust --tap` marks it trusted so Homebrew
98
+ will load its formulae when `HOMEBREW_REQUIRE_TAP_TRUST` is set (the trust list lives in
99
+ `~/.homebrew/trust.json`). Both are one-time. To update later: `brew upgrade devcoach`.
100
+
101
+ Prefer a one-liner? `brew install UltimaPhoenix/tap/devcoach` taps and installs in a single
102
+ command — but if your Homebrew enforces tap trust, run `brew trust --tap UltimaPhoenix/tap` first.
103
+
104
+ The formula declares `depends_on "node"`, so Homebrew pulls in a recent Node automatically. It puts
105
+ `devcoach` on your `PATH` — so `devcoach install` registers everything with the bare `devcoach`
106
+ command (no `npx -y` prefix), and you can use `devcoach` directly in every command below.
107
+
108
+ </details>
109
+
69
110
  ### Step 2 — Connect to your AI agent
70
111
 
71
112
  ```bash
@@ -135,7 +176,7 @@ Then add the Stop hooks to `~/.claude/settings.json`:
135
176
  }
136
177
  ```
137
178
 
138
- > Tip: a global install (`npm i -g devcoach`) lets you drop the `npx -y` prefix and use `devcoach` directly in every command above.
179
+ > Tip: a global install (`npm i -g devcoach` or `brew install UltimaPhoenix/tap/devcoach`) puts `devcoach` on your `PATH`, so you can drop the `npx -y` prefix and use `devcoach` directly in every command above. `devcoach install` detects this automatically and registers the bare command.
139
180
 
140
181
  #### Claude Desktop
141
182
 
@@ -340,7 +381,8 @@ Settings are stored in `~/.devcoach/coaching.db`. See [docs/configuration.md](do
340
381
 
341
382
  ```bash
342
383
  npm uninstall -g devcoach # if installed globally (npx: nothing to remove)
343
- claude mcp remove devcoach # remove from Claude Code
384
+ brew uninstall devcoach # if installed via Homebrew (brew untap UltimaPhoenix/tap to drop the tap)
385
+ claude mcp remove --scope user devcoach # remove from Claude Code (install uses user scope)
344
386
  rm -rf ~/.devcoach # delete all coaching data (back up first: devcoach backup)
345
387
  ```
346
388
 
package/dist/bin.js CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import {spawn,spawnSync,execFileSync}from'child_process';import {existsSync,writeFileSync,readFileSync,mkdirSync,statSync,accessSync,constants,readdirSync}from'fs';import {homedir,platform}from'os';import {join,dirname,extname,basename}from'path';import {createInterface}from'readline/promises';import {Command}from'commander';import {createRequire}from'module';import {unzipSync,strToU8,zipSync,strFromU8}from'fflate';import {z as z$1}from'zod';import {McpServer,ResourceTemplate}from'@modelcontextprotocol/sdk/server/mcp.js';import {StdioServerTransport}from'@modelcontextprotocol/sdk/server/stdio.js';import {fileURLToPath}from'url';import {serve}from'@hono/node-server';import {Hono}from'hono';import {html,raw}from'hono/html';import {styleText}from'util';var me=z$1.enum(["junior","mid","senior"]),fe=z$1.enum(["github","gitlab","bitbucket","local"]),Re=z$1.enum(["know","dont_know"]),Le=z$1.number().int().min(0).max(10);function qt(t){return t.toISOString().replace(/\.\d{3}Z$/,"Z")}function Wt(t){if(t instanceof Date){if(Number.isNaN(t.getTime()))throw new TypeError("Invalid Date");return t}let e=t.trim();/[zZ]$|[+-]\d{2}:?\d{2}$/.test(e)||(e=e.includes("T")||e.includes(" ")?`${e.replace(" ","T")}Z`:`${e}T00:00:00Z`);let r=new Date(e);if(Number.isNaN(r.getTime()))throw new TypeError(`Cannot parse timestamp ${JSON.stringify(t)} \u2014 expected ISO 8601`);return r}function Xt(t){let e=Wt(t),o=new Date;return e.getTime()>o.getTime()&&(e=o),qt(e)}var Yt=z$1.union([z$1.string(),z$1.date()]).transform((t,e)=>{try{return Xt(t)}catch(o){return e.addIssue({code:"custom",message:o.message}),z$1.NEVER}}),H=z$1.string().nullish().transform(t=>t??null),Jt=z$1.object({id:z$1.string(),timestamp:Yt,topic_id:z$1.string(),categories:z$1.array(z$1.string()),title:z$1.string(),level:me,summary:z$1.string(),body:H,task_context:H,project:H,repository:H,branch:H,commit_hash:H,folder:H,repository_platform:fe.nullish().transform(t=>t??null),starred:z$1.boolean().default(false),feedback:Re.nullish().transform(t=>t??null)}),Vt=z$1.object({topic:z$1.string(),confidence:z$1.number().int()}),Zt=z$1.object({name:z$1.string(),topics:z$1.array(z$1.string())});z$1.object({knowledge:z$1.array(Vt),groups:z$1.array(Zt)});var Ie=z$1.enum(["system","dark","light"]);z$1.object({max_per_day:z$1.number().int().default(2),min_gap_minutes:z$1.number().int().default(240),ui_theme:Ie.default("system")});function re(t){return Jt.parse(t)}var{DatabaseSync:io}=createRequire(import.meta.url)("node:sqlite"),it=join(homedir(),".devcoach"),Pe=join(it,"coaching.db"),w=join(it,"learning-state.md"),Oe="settings.json",De="lessons.json",Ne="knowledge.json",je="learning-state.md",at={engineering:8,architecture:8,patterns:7,debugging:8,node:7,javascript:7,typescript:6,python:4,django:3,fastapi:4,docker:8,traefik:7,coolify:7,postgresql:6,redis:6,git:7,ci_cd:6,security:5,performance:6,testing:5,linux:7,networking:6,react:5,frontend:5},ao={max_per_day:"2",min_gap_minutes:"240",ui_theme:"system"};function j(t,e,...o){return t.prepare(e).all(...o)}function G(t,e,...o){return t.prepare(e).get(...o)}function S(t,e,...o){return Number(t.prepare(e).run(...o).changes)}function co(t=Pe){return t!==":memory:"&&mkdirSync(dirname(t),{recursive:true}),new io(t)}function lo(t=Pe){let e=co(t);return po(e),e}function m(t,e=Pe){let o=lo(e);try{return t(o)}finally{o.close();}}function po(t){t.exec(`
2
+ import {spawn,spawnSync,execFileSync}from'child_process';import {existsSync,writeFileSync,readFileSync,mkdirSync,statSync,accessSync,constants,readdirSync}from'fs';import {homedir,platform}from'os';import {join,dirname,extname,basename}from'path';import {createInterface}from'readline/promises';import {Command}from'commander';import {createRequire}from'module';import {unzipSync,strToU8,zipSync,strFromU8}from'fflate';import {z as z$1}from'zod';import {McpServer,ResourceTemplate}from'@modelcontextprotocol/sdk/server/mcp.js';import {StdioServerTransport}from'@modelcontextprotocol/sdk/server/stdio.js';import {fileURLToPath}from'url';import {serve}from'@hono/node-server';import {Hono}from'hono';import {html,raw}from'hono/html';import {styleText}from'util';var me=z$1.enum(["junior","mid","senior"]),fe=z$1.enum(["github","gitlab","bitbucket","local"]),Re=z$1.enum(["know","dont_know"]),Le=z$1.number().int().min(0).max(10);function qt(t){return t.toISOString().replace(/\.\d{3}Z$/,"Z")}function Wt(t){if(t instanceof Date){if(Number.isNaN(t.getTime()))throw new TypeError("Invalid Date");return t}let e=t.trim();/[zZ]$|[+-]\d{2}:?\d{2}$/.test(e)||(e=e.includes("T")||e.includes(" ")?`${e.replace(" ","T")}Z`:`${e}T00:00:00Z`);let r=new Date(e);if(Number.isNaN(r.getTime()))throw new TypeError(`Cannot parse timestamp ${JSON.stringify(t)} \u2014 expected ISO 8601`);return r}function Xt(t){let e=Wt(t),o=new Date;return e.getTime()>o.getTime()&&(e=o),qt(e)}var Yt=z$1.union([z$1.string(),z$1.date()]).transform((t,e)=>{try{return Xt(t)}catch(o){return e.addIssue({code:"custom",message:o.message}),z$1.NEVER}}),U=z$1.string().nullish().transform(t=>t??null),Jt=z$1.object({id:z$1.string(),timestamp:Yt,topic_id:z$1.string(),categories:z$1.array(z$1.string()),title:z$1.string(),level:me,summary:z$1.string(),body:U,task_context:U,project:U,repository:U,branch:U,commit_hash:U,folder:U,repository_platform:fe.nullish().transform(t=>t??null),starred:z$1.boolean().default(false),feedback:Re.nullish().transform(t=>t??null)}),Vt=z$1.object({topic:z$1.string(),confidence:z$1.number().int()}),Zt=z$1.object({name:z$1.string(),topics:z$1.array(z$1.string())});z$1.object({knowledge:z$1.array(Vt),groups:z$1.array(Zt)});var Ie=z$1.enum(["system","dark","light"]);z$1.object({max_per_day:z$1.number().int().default(2),min_gap_minutes:z$1.number().int().default(240),ui_theme:Ie.default("system")});function re(t){return Jt.parse(t)}var{DatabaseSync:io}=createRequire(import.meta.url)("node:sqlite"),it=join(homedir(),".devcoach"),Pe=join(it,"coaching.db"),w=join(it,"learning-state.md"),Oe="settings.json",De="lessons.json",Ne="knowledge.json",je="learning-state.md",at={engineering:8,architecture:8,patterns:7,debugging:8,node:7,javascript:7,typescript:6,python:4,django:3,fastapi:4,docker:8,traefik:7,coolify:7,postgresql:6,redis:6,git:7,ci_cd:6,security:5,performance:6,testing:5,linux:7,networking:6,react:5,frontend:5},ao={max_per_day:"2",min_gap_minutes:"240",ui_theme:"system"};function j(t,e,...o){return t.prepare(e).all(...o)}function G(t,e,...o){return t.prepare(e).get(...o)}function S(t,e,...o){return Number(t.prepare(e).run(...o).changes)}function co(t=Pe){return t!==":memory:"&&mkdirSync(dirname(t),{recursive:true}),new io(t)}function lo(t=Pe){let e=co(t);return po(e),e}function m(t,e=Pe){let o=lo(e);try{return t(o)}finally{o.close();}}function po(t){t.exec(`
3
3
  CREATE TABLE IF NOT EXISTS lessons (
4
4
  id TEXT PRIMARY KEY,
5
5
  timestamp TEXT NOT NULL,
@@ -45,8 +45,8 @@ import {spawn,spawnSync,execFileSync}from'child_process';import {existsSync,writ
45
45
  CREATE INDEX IF NOT EXISTS idx_lessons_starred_ts ON lessons (starred, timestamp);
46
46
  CREATE INDEX IF NOT EXISTS idx_lessons_feedback ON lessons (feedback);
47
47
  CREATE INDEX IF NOT EXISTS idx_lessons_topic_id ON lessons (topic_id);
48
- `),go(t),uo(t);}function go(t){try{t.exec("ALTER TABLE lessons ADD COLUMN body TEXT");}catch{}}function uo(t){for(let[e,o]of Object.entries(ao))S(t,"INSERT OR IGNORE INTO settings (key, value) VALUES (?, ?)",e,o);}var dt="(id, timestamp, topic_id, categories, title, level, summary, body, task_context, project, repository, branch, commit_hash, folder, repository_platform, starred, feedback)",ct="(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)";function lt(t){return [t.id,t.timestamp,t.topic_id,JSON.stringify(t.categories),t.title,t.level,t.summary,t.body,t.task_context,t.project,t.repository,t.branch,t.commit_hash,t.folder,t.repository_platform,t.starred?1:0,t.feedback]}function pt(t,e){S(t,`INSERT OR REPLACE INTO lessons ${dt} VALUES ${ct}`,...lt(e));}var mo=[["project","project"],["repository","repository"],["branch","branch"],["commit","commit_hash"]];function fo(t,e){if(t.date_from==null&&t.date_to==null){let o=wo(t.period??null);o!=null&&e("timestamp >= ?",o);return}if(t.date_from!=null&&e("timestamp >= ?",t.date_from),t.date_to!=null){let o=t.date_to.includes("T")||t.date_to.includes(" ");e("timestamp <= ?",o?t.date_to:`${t.date_to}T23:59:59`);}}function gt(t){let e=[],o=[],r=(s,...a)=>{e.push(s),o.push(...a);};fo(t,r),t.category!=null&&r("categories LIKE ?",`%"${t.category}"%`),t.level!=null&&r("level = ?",t.level);for(let[s,a]of mo){let l=t[s];l!=null&&r(`${a} LIKE ?`,`%${l}%`);}if(t.starred!=null&&r("starred = ?",t.starred?1:0),t.search!=null){let s=`%${t.search}%`;r("(title LIKE ? OR topic_id LIKE ? OR summary LIKE ? OR body LIKE ?)",s,s,s,s);}return t.feedback==="none"?r("feedback IS NULL"):t.feedback!=null&&r("feedback = ?",t.feedback),{where:e.length?`WHERE ${e.join(" AND ")}`:"",params:o}}function X(t,e={}){let{where:o,params:r}=gt(e),n=G(t,`SELECT COUNT(*) AS n FROM lessons ${o}`,...r);return Number(n?.n??0)}var bo=new Set(["timestamp","level","topic_id","title","feedback"]),yo=new Set(["project","repository","branch","commit_hash","repository_platform"]);function B(t,e={}){let{where:o,params:r}=gt(e),n=e.sort&&bo.has(e.sort)?e.sort:"timestamp",s=(e.order??"desc").toLowerCase()==="asc"?"ASC":"DESC",a=`SELECT * FROM lessons ${o} ORDER BY ${n} ${s}`,l=[...r];if(e.page!=null){let d=e.per_page??25;a+=" LIMIT ? OFFSET ?",l.push(d,(e.page-1)*d);}return j(t,a,...l).map(Ge)}function he(t,e){return S(t,"DELETE FROM lessons WHERE id = ?",e)>0}function Y(t,e,o){return S(t,"UPDATE lessons SET starred = ? WHERE id = ?",o?1:0,e)>0}function ne(t,e,o){S(t,"UPDATE lessons SET feedback = ? WHERE id = ?",o||null,e);let r=G(t,"SELECT topic_id FROM lessons WHERE id = ?",e);return r?r.topic_id:null}function se(t){return j(t,"SELECT * FROM lessons ORDER BY timestamp DESC").map(Ge)}function Me(t,e){let o=0,r=0,n=0;for(let s of e){let a;try{a=re(s);}catch{n+=1;continue}S(t,`INSERT OR IGNORE INTO lessons ${dt} VALUES ${ct}`,...lt(a))>0?o+=1:r+=1;}return {inserted:o,duplicated:r,invalid:n}}function ie(t,e){if(!yo.has(e))throw new Error(`Column not allowed: ${JSON.stringify(e)}`);return j(t,`SELECT DISTINCT ${e} FROM lessons WHERE ${e} IS NOT NULL ORDER BY ${e}`).map(r=>r[e])}function K(t,e){let o=G(t,"SELECT * FROM lessons WHERE id = ?",e);return o?Ge(o):null}function ut(t){return j(t,"SELECT DISTINCT value FROM lessons, json_each(lessons.categories) ORDER BY value").map(o=>o.value)}function mt(t){return j(t,"SELECT DISTINCT topic_id FROM lessons").map(e=>e.topic_id)}function xe(t,e){let o=G(t,"SELECT COUNT(*) AS n FROM lessons WHERE timestamp >= ?",e);return Number(o?.n??0)}function ft(t){let e=G(t,"SELECT timestamp FROM lessons ORDER BY timestamp DESC LIMIT 1");return e?e.timestamp:null}function Fe(t){let e={};for(let o of j(t,"SELECT topic, confidence FROM knowledge"))e[o.topic]=Number(o.confidence);return e}function ae(t){return j(t,"SELECT topic, confidence FROM knowledge ORDER BY topic").map(e=>({topic:e.topic,confidence:Number(e.confidence)}))}function Ue(t){let e=j(t,"SELECT group_name FROM knowledge_group_names ORDER BY group_name").map(r=>r.group_name),o=new Map;for(let r of j(t,"SELECT group_name, topic FROM knowledge_groups ORDER BY group_name, topic")){let n=r.group_name,s=o.get(n)??[];s.push(r.topic),o.set(n,s);}return e.map(r=>({name:r,topics:o.get(r)??[]}))}function O(t,e,o){let r=Math.max(0,Math.min(10,o)),n=new Date().toISOString();S(t,`INSERT INTO knowledge (topic, confidence, updated_at) VALUES (?, ?, ?)
49
- ON CONFLICT(topic) DO UPDATE SET confidence = excluded.confidence, updated_at = excluded.updated_at`,e,r,n);}function J(t,e){let o=S(t,"DELETE FROM knowledge WHERE topic = ?",e);return S(t,"DELETE FROM knowledge_groups WHERE topic = ?",e),o>0}function P(t,e){let o=e.trim();if(!o)throw new Error("Group name must not be empty");return S(t,"INSERT OR IGNORE INTO knowledge_group_names (group_name) VALUES (?)",o)>0}function V(t,e){return S(t,"DELETE FROM knowledge_groups WHERE group_name = ?",e),S(t,"DELETE FROM knowledge_group_names WHERE group_name = ?",e)>0}function N(t,e,o){S(t,"INSERT OR IGNORE INTO knowledge_group_names (group_name) VALUES (?)",o),S(t,"DELETE FROM knowledge_groups WHERE topic = ?",e),S(t,"INSERT OR IGNORE INTO knowledge_groups (group_name, topic) VALUES (?, ?)",o,e);}function ke(t,e){S(t,"DELETE FROM knowledge_groups WHERE topic = ?",e);}function E(t){let e={};for(let d of j(t,"SELECT key, value FROM settings"))e[d.key]=d.value;let o=e.min_gap_minutes,r=e.min_hours_between,n;o!==void 0?n=Number.parseInt(o,10):r!==void 0?n=Number.parseInt(r,10)*60:n=240;let s=e.max_per_day,a=e.ui_theme??"system",l=a==="dark"||a==="light"||a==="system"?a:"system";return {max_per_day:s!==void 0?Number.parseInt(s,10):2,min_gap_minutes:n,ui_theme:l}}function R(t,e,o){S(t,"INSERT INTO settings (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value",e,o);}function de(t){let e=G(t,"SELECT COUNT(*) AS n FROM knowledge");return {knowledge_ready:Number(e?.n??0)>0}}function He(t){let e={};for(let o of ["project","repository","branch","repository_platform"]){let r=G(t,`SELECT ${o} AS v, COUNT(*) AS c FROM lessons WHERE ${o} IS NOT NULL GROUP BY ${o} ORDER BY c DESC LIMIT 1`);e[o]=r?r.v:null;}return e}function ve(t){let e=E(t),o=se(t),r=ae(t),n=Ue(t),s=new Map;for(let d of n)for(let f of d.topics)s.set(f,d.name);let a={groups:n.map(d=>d.name),topics:r.map(d=>({topic:d.topic,confidence:d.confidence,group:s.get(d.topic)??null}))},l={[Oe]:strToU8(JSON.stringify(e,null,2)),[De]:strToU8(JSON.stringify(o,null,2)),[Ne]:strToU8(JSON.stringify(a,null,2))};return existsSync(w)&&(l[je]=strToU8(readFileSync(w,"utf8"))),zipSync(l)}function ho(t,e,o){if(!(Oe in e))return;let r=JSON.parse(strFromU8(e[Oe]));"max_per_day"in r&&R(t,"max_per_day",String(r.max_per_day)),"min_gap_minutes"in r&&R(t,"min_gap_minutes",String(r.min_gap_minutes)),(r.ui_theme==="system"||r.ui_theme==="dark"||r.ui_theme==="light")&&R(t,"ui_theme",r.ui_theme),o.settings=1;}function xo(t,e,o){if(!(Ne in e))return;let r=JSON.parse(strFromU8(e[Ne]));if(!(r&&typeof r=="object"&&Array.isArray(r.topics))){for(let[s,a]of Object.entries(r))O(t,s,a);o.topics=Object.keys(r).length;return}let n=0;for(let s of r.groups??[])P(t,s)&&(n+=1);for(let s of r.topics){O(t,s.topic,s.confidence);let a=s.group;a&&a!=="Other"&&(P(t,a)&&(n+=1),N(t,s.topic,a));}o.topics=r.topics.length,o.groups=n;}function ko(t,e,o){if(!(De in e))return;let r=JSON.parse(strFromU8(e[De])),{inserted:n,duplicated:s,invalid:a}=Me(t,r);o.lessons=n,o.skipped=s,o.invalid=a;}function vo(t,e){je in t&&(mkdirSync(dirname(w),{recursive:true}),writeFileSync(w,strFromU8(t[je]),"utf8"),e.learning_state=1);}function ce(t,e){let o={settings:0,topics:0,groups:0,lessons:0,skipped:0,invalid:0,learning_state:0},r=unzipSync(e);return ho(t,r,o),xo(t,r,o),ko(t,r,o),vo(r,o),o}function wo(t){let e=new Date,o;if(t==="today")o=new Date(Date.UTC(e.getUTCFullYear(),e.getUTCMonth(),e.getUTCDate(),0,0,0,0));else if(t==="week")o=new Date(e.getTime()-7*864e5);else if(t==="month")o=new Date(e.getTime()-30*864e5);else if(t==="year")o=new Date(e.getTime()-365*864e5);else return null;return o.toISOString()}function Ge(t){let e=[];try{let o=JSON.parse(t.categories);Array.isArray(o)&&(e=o);}catch{e=[];}return re({...t,categories:e,starred:!!t.starred})}function z(t){try{let e=E(t),o=new Date,r=new Date(o.getTime()-24*36e5).toISOString(),n=xe(t,r);if(n>=e.max_per_day)return {allowed:!1,reason:`Daily limit reached (${n}/${e.max_per_day} lessons in the last 24h)`};let s=ft(t);if(s!=null){let a=new Date(s),l=(o.getTime()-a.getTime())/6e4;if(l<e.min_gap_minutes){let d=e.min_gap_minutes-l,f=Math.floor(e.min_gap_minutes/60),b=e.min_gap_minutes%60,y=Math.trunc(d),k=Math.floor(y/60),v=y%60;return {allowed:!1,reason:`Too soon: last lesson ${l<0?`in ${Math.round(-l)}m (future timestamp)`:`${Math.round(l)}m ago`}, minimum interval is ${f}h ${b}m (${k}h ${v}m remaining)`}}}return {allowed:!0}}catch(e){return {allowed:true,reason:`Rate limit check failed: ${e}`}}}function M(t){try{return {knowledge:ae(t),groups:Ue(t)}}catch{return {knowledge:[],groups:[]}}}function q(t,e,o){let r=Fe(t)[e]??5,n=Math.max(0,Math.min(10,r+o));return O(t,e,n),n}function we(t,e,o){let r=ne(t,e,o);return r&&(o==="know"||o==="dont_know")&&q(t,r,o==="know"?1:-1),r}function Z(t){try{let e=new Date,o=X(t),r=new Date(e.getTime()-24*36e5).toISOString(),n=new Date(e.getTime()-7*864e5).toISOString(),s=xe(t,r),a=xe(t,n),l=Fe(t),d=Object.entries(l).sort((y,k)=>y[1]-k[1]),f=d.slice(0,5).map(([y,k])=>({topic:y,confidence:k})),b=d.slice(-5).reverse().map(([y,k])=>({topic:y,confidence:k}));return {total_lessons:o,lessons_today:s,lessons_this_week:a,weakest_topics:f,strongest_topics:b}}catch(e){return {error:String(e)}}}function bt(t){try{return mt(t)}catch{return []}}var To=[["package.json","javascript",6],["tsconfig*.json","typescript",6],["requirements*.txt","python",6],["pyproject.toml","python",6],["setup.py","python",6],["go.mod","go",6],["Cargo.toml","rust",6],["pom.xml","java",6],["build.gradle","java",6],["build.gradle.kts","java",6],["*.csproj","csharp",6],["Gemfile","ruby",6],["composer.json","php",6],["Dockerfile","docker",7],["Dockerfile.*","docker",7],["docker-compose.yml","docker_compose",7],["docker-compose.yaml","docker_compose",7],["docker-compose.*.yml","docker_compose",7],[".github/workflows/*.yml","github_actions",6],[".github/workflows/*.yaml","github_actions",6],[".gitlab-ci.yml","gitlab_ci",6],["Jenkinsfile","ci_cd",6],["*.tf","terraform",6],["*.sql","sql",5],[".git","git",7],["kubernetes/*.yaml","kubernetes",6],["kubernetes/*.yml","kubernetes",6],["k8s/*.yaml","kubernetes",6],["*.bicep","azure",6],["serverless.yml","aws",6],["serverless.yaml","aws",6],["template.yaml","aws",5],["angular.json","angular",6],["svelte.config.*","svelte",6],["nuxt.config.*","vue",6],["vite.config.*","javascript",6]],Eo={react:"react","react-dom":"react",vue:"vue","@angular/core":"angular",svelte:"svelte",next:"nextjs",nuxt:"vue",fastify:"fastify",express:"express",koa:"express","@nestjs/core":"node_js"},Co={django:"django",flask:"flask",fastapi:"fastapi",starlette:"fastapi",tornado:"python",aiohttp:"python",sqlalchemy:"postgresql",celery:"python"};function Ro(t){let e="";for(let o of t)o==="*"?e+="[^/]*":o==="?"?e+="[^/]":e+=o.replace(/[.+^${}()|[\]\\]/g,String.raw`\$&`);return new RegExp(`^${e}$`)}function Lo(t,e){let o=e.lastIndexOf("/"),r=o>=0?join(t,e.slice(0,o)):t,n=o>=0?e.slice(o+1):e,s;try{s=readdirSync(r);}catch{return false}let a=Ro(n);return s.some(l=>a.test(l))}function yt(t){try{return existsSync(t)?readFileSync(t,"utf8"):null}catch{return null}}function Io(t,e){let o=yt(join(t,"package.json"));if(!o)return;let r;try{r=JSON.parse(o);}catch{return}let n=new Set([...Object.keys(r.dependencies??{}),...Object.keys(r.devDependencies??{})]);for(let[s,a]of Object.entries(Eo))n.has(s)&&e(a,6);}function Oo(t,e){let o=["requirements.txt","requirements-dev.txt","requirements/base.txt","pyproject.toml"];for(let r of o){let n=yt(join(t,r))?.toLowerCase();if(n)for(let[s,a]of Object.entries(Co))n.includes(s)&&e(a,6);}}function _e(t){let e={},o=(r,n)=>{(e[r]??-1)<n&&(e[r]=n);};for(let[r,n,s]of To)Lo(t,r)&&o(n,s);return Io(t,o),Oo(t,o),e}function qe(...t){try{return execFileSync("git",t,{encoding:"utf8",timeout:3e3,stdio:["ignore","pipe","ignore"]}).trim()||null}catch{return null}}var ht={"github.com":"github","gitlab.com":"gitlab","bitbucket.org":"bitbucket"};function jo(t){if(!t)return [null,null];let e=/^git@([^:]+):(.+?)(?:\.git)?$/.exec(t);if(e){let r=(e[1]??"").toLowerCase();return [e[2]??t,ht[r]??"local"]}let o=/^https?:\/\/([^/]+)\/(.+?)(?:\.git)?$/.exec(t);if(o){let r=(o[1]??"").toLowerCase();return [o[2]??t,ht[r]??"local"]}return [t,"local"]}function Q(){let t=process.cwd(),e=qe("rev-parse","--abbrev-ref","HEAD"),o=qe("rev-parse","HEAD"),r=qe("remote","get-url","origin"),[n,s]=jo(r),a;return n?a=n.replace(/\/+$/,"").split("/").pop()??null:a=basename(t)||null,e==="HEAD"&&(e=null),{project:a,repository:n,branch:e,commit_hash:o,folder:t,repository_platform:s}}var kt=dirname(fileURLToPath(import.meta.url)),Fo=[join(kt,"../assets/SKILL.md"),join(kt,"../../assets/SKILL.md")];function vt(){for(let t of Fo)try{return readFileSync(t,"utf8")}catch{}return "devcoach: coaching instructions unavailable (SKILL.md not found in package)."}var wt={version:"0.3.60"};var le=wt.version;var I=t=>({type:"text",text:t}),_t=t=>({content:[I(JSON.stringify(t))]}),L=t=>({isError:true,content:[I(t)]}),We=t=>({content:[I(JSON.stringify(t))],structuredContent:t}),Wo={id:z$1.string(),timestamp:z$1.string(),topic_id:z$1.string(),categories:z$1.array(z$1.string()),title:z$1.string(),level:me,summary:z$1.string(),body:z$1.string().nullable(),task_context:z$1.string().nullable(),project:z$1.string().nullable(),repository:z$1.string().nullable(),branch:z$1.string().nullable(),commit_hash:z$1.string().nullable(),folder:z$1.string().nullable(),repository_platform:fe.nullable(),starred:z$1.boolean(),feedback:Re.nullable()},Xo={knowledge:z$1.array(z$1.object({topic:z$1.string(),confidence:z$1.number().int()})),groups:z$1.array(z$1.object({name:z$1.string(),topics:z$1.array(z$1.string())}))},Yo={max_per_day:z$1.number().int(),min_gap_minutes:z$1.number().int(),ui_theme:Ie};function _(t,e){return {contents:[{uri:t.href,mimeType:"application/json",text:JSON.stringify(e)}]}}function Jo(){let t=new McpServer({name:"devcoach",version:le},{instructions:"Progressive technical coaching server. Use the devcoach_instructions prompt for full coaching behaviour guidelines."});t.registerTool("log_lesson",{title:"Log Lesson",description:"Save a delivered lesson to the coaching log. Git metadata (project, repository, branch, commit_hash, folder, repository_platform) is auto-detected from the workspace when omitted. Returns the saved Lesson with all resolved fields.",inputSchema:{id:z$1.string().describe("Unique lesson id (uuid or random string)"),timestamp:z$1.string().describe("ISO 8601 timestamp; normalized to UTC and clamped to now"),topic_id:z$1.string().describe("Primary topic id, e.g. 'python'"),categories:z$1.array(z$1.string()).describe("Category tags, e.g. ['python','performance']"),title:z$1.string().describe("Short lesson title"),level:me.describe("Difficulty level: junior | mid | senior"),summary:z$1.string().describe("1-3 sentence summary shown in the lesson card"),body:z$1.string().nullish().describe("Optional full lesson markdown"),task_context:z$1.string().nullish().describe("What the user was doing when taught"),project:z$1.string().nullish().describe("Project name (auto-detected from git if omitted)"),repository:z$1.string().nullish().describe("org/repo or path (auto-detected if omitted)"),branch:z$1.string().nullish().describe("git branch (auto-detected if omitted)"),commit_hash:z$1.string().nullish().describe("git commit hash (auto-detected if omitted)"),folder:z$1.string().nullish().describe("workspace folder (auto-detected if omitted)"),repository_platform:fe.nullish().describe("github | gitlab | bitbucket | local (auto-detected if omitted)")},outputSchema:Wo,annotations:{title:"Log Lesson",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=Q(),n={};try{n=m(a=>He(a));}catch{n={};}let s=re({id:o.id,timestamp:o.timestamp,topic_id:o.topic_id,categories:o.categories,title:o.title,level:o.level,summary:o.summary,body:o.body??null,task_context:o.task_context??null,project:o.project??r.project??n.project??null,repository:o.repository??r.repository??n.repository??null,branch:o.branch??r.branch??n.branch??null,commit_hash:o.commit_hash??r.commit_hash??null,folder:o.folder??r.folder??null,repository_platform:o.repository_platform??r.repository_platform??n.repository_platform??null});m(a=>pt(a,s));try{if(t.server.getClientCapabilities()?.elicitation){let l=await t.server.elicitInput({message:"Did that land?",requestedSchema:{type:"object",properties:{feedback:{type:"string",title:"Did that land?",description:"know = got it \xB7 dont_know = need to revisit \xB7 skip = no feedback",enum:["know","dont_know","skip"]}},required:[]}}),d=l.action==="accept"?l.content?.feedback:void 0;d&&d!=="skip"&&(m(f=>{ne(f,o.id,d),q(f,o.topic_id,d==="know"?1:-1);}),s={...s,feedback:d});}}catch{}return We(s)}catch(r){return L(`log_lesson failed: ${r}`)}}),t.registerTool("update_knowledge",{title:"Update Knowledge",description:"Adjust the confidence score for a topic by delta (e.g. +1 or -1). Returns the new confidence (0-10). Creates the topic at confidence 5 if it does not exist.",inputSchema:{topic:z$1.string().describe("Topic id, e.g. 'python'"),delta:z$1.number().int().describe("Signed change to apply, e.g. +1 or -1")},annotations:{title:"Update Knowledge",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>q(n,o.topic,o.delta));return {content:[I(String(r))]}}catch(r){return L(`update_knowledge failed for '${o.topic}': ${r}`)}}),t.registerTool("get_lessons",{title:"Get Lessons",description:"Query the coaching lesson history. All filters combine. period defaults to all; date_from/date_to override period; limit caps results newest-first (0 = all).",inputSchema:{period:z$1.enum(["today","week","month","year","all"]).nullish().describe("Time window"),category:z$1.string().nullish().describe("Filter by a category tag, e.g. 'python'"),level:z$1.enum(["junior","mid","senior"]).nullish().describe("Filter by difficulty level"),project:z$1.string().nullish().describe("Fuzzy match on git project"),repository:z$1.string().nullish().describe("Fuzzy match on git repository"),branch:z$1.string().nullish().describe("Fuzzy match on git branch"),commit:z$1.string().nullish().describe("Fuzzy match on commit hash"),starred:z$1.boolean().nullish().describe("True to return only starred lessons"),feedback:z$1.enum(["know","dont_know","none"]).nullish().describe("Filter by feedback ('none' = no response)"),search:z$1.string().nullish().describe("Full-text search over title, topic_id, summary, body"),date_from:z$1.string().nullish().describe("ISO date/datetime lower bound"),date_to:z$1.string().nullish().describe("ISO date/datetime upper bound (date-only = end-of-day)"),limit:z$1.number().int().default(10).describe("Max lessons, newest first. Pass 0 for all.")},annotations:{title:"Get Lessons",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},o=>{try{let r=m(n=>B(n,{period:o.period,category:o.category,level:o.level,project:o.project,repository:o.repository,branch:o.branch,commit:o.commit,starred:o.starred,feedback:o.feedback,search:o.search,date_from:o.date_from,date_to:o.date_to,page:o.limit>0?1:null,per_page:o.limit}));return _t(r)}catch{return _t([])}}),t.registerTool("star_lesson",{title:"Star Lesson",description:"Set the starred (favourite) flag on a lesson. Returns true if found and updated. Idempotent.",inputSchema:{lesson_id:z$1.string().describe("Lesson id"),starred:z$1.boolean().describe("true to favourite, false to unmark")},annotations:{title:"Star Lesson",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>Y(n,o.lesson_id,o.starred));return {content:[I(String(r))]}}catch(r){return L(`star_lesson failed for '${o.lesson_id}': ${r}`)}}),t.registerTool("delete_lesson",{title:"Delete Lesson",description:"Permanently delete a lesson by id. Returns true if found and deleted.",inputSchema:{lesson_id:z$1.string().describe("Lesson id to delete")},annotations:{title:"Delete Lesson",destructiveHint:true,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>he(n,o.lesson_id));return {content:[I(String(r))]}}catch(r){return L(`delete_lesson failed for '${o.lesson_id}': ${r}`)}}),t.registerTool("submit_feedback",{title:"Submit Feedback",description:"Record comprehension feedback for a lesson and adjust knowledge confidence. know = +1, dont_know = -1, clear = remove feedback (no confidence change). Idempotent \u2014 the same feedback twice adjusts confidence only once.",inputSchema:{lesson_id:z$1.string().describe("Lesson id"),feedback:z$1.enum(["know","dont_know","clear"]).describe("know | dont_know | clear")},annotations:{title:"Submit Feedback",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=o.feedback==="clear"?null:o.feedback,n=m(s=>{let a=s.prepare("SELECT feedback, topic_id FROM lessons WHERE id = ?").get(o.lesson_id);return a?(a.feedback===r||(ne(s,o.lesson_id,r),(r==="know"||r==="dont_know")&&a.topic_id&&q(s,a.topic_id,r==="know"?1:-1)),!0):!1});return {content:[I(String(n))]}}catch(r){return L(`submit_feedback failed for '${o.lesson_id}': ${r}`)}}),t.registerTool("add_topic",{title:"Add Topic",description:"Add a topic to the knowledge map, or update its confidence if it exists. Optionally assign to a group (auto-created). Prefer a single-word topic id. Idempotent.",inputSchema:{topic:z$1.string().describe("Topic id \u2014 prefer a single word, max 3 words"),confidence:Le.default(5).describe("Initial confidence 0-10 (default 5)"),group:z$1.string().nullish().describe("Optional group name; 'Other' if omitted")},annotations:{title:"Add Topic",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{return m(r=>{O(r,o.topic,o.confidence),o.group&&o.group!=="Other"&&N(r,o.topic,o.group);}),{content:[I("true")]}}catch(r){return L(`add_topic failed for '${o.topic}': ${r}`)}}),t.registerTool("remove_topic",{title:"Remove Topic",description:"Remove a topic from the knowledge map entirely. Returns true if it existed.",inputSchema:{topic:z$1.string().describe("Topic id to remove")},annotations:{title:"Remove Topic",destructiveHint:true,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>J(n,o.topic));return {content:[I(String(r))]}}catch(r){return L(`remove_topic failed for '${o.topic}': ${r}`)}}),t.registerTool("add_group",{title:"Add Group",description:"Create a new (initially empty) knowledge group. Idempotent \u2014 returns true either way.",inputSchema:{name:z$1.string().describe("Group name, e.g. 'Machine Learning'")},annotations:{title:"Add Group",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{return m(r=>P(r,o.name.trim())),{content:[I("true")]}}catch(r){return L(`add_group failed for '${o.name}': ${r}`)}}),t.registerTool("remove_group",{title:"Remove Group",description:"Delete a knowledge group. Its topics move to Other. Returns true if it existed.",inputSchema:{name:z$1.string().describe("Group name to delete")},annotations:{title:"Remove Group",destructiveHint:true,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>V(n,o.name));return {content:[I(String(r))]}}catch(r){return L(`remove_group failed for '${o.name}': ${r}`)}}),t.registerTool("update_settings",{title:"Update Settings",description:"Update a coaching setting. max_per_day: integer 1-20. min_gap_minutes: integer 0-1440 (0 = no cooldown). Returns the full updated Settings.",inputSchema:{key:z$1.enum(["max_per_day","min_gap_minutes"]).describe("Setting key"),value:z$1.string().describe("New value as an integer string")},outputSchema:Yo,annotations:{title:"Update Settings",destructiveHint:false,idempotentHint:true,openWorldHint:false}},o=>{let r=Number.parseInt(o.value,10);if(Number.isNaN(r))return L(`Value must be an integer, got '${o.value}'`);if(o.key==="max_per_day"&&!(r>=1&&r<=20))return L("max_per_day must be between 1 and 20");if(o.key==="min_gap_minutes"&&!(r>=0&&r<=1440))return L("min_gap_minutes must be between 0 and 1440");let n=m(s=>(R(s,o.key,String(r)),E(s)));return We(n)}),t.registerTool("open_ui",{title:"Open UI",description:"Launch the devcoach web dashboard in the background. port must be 1024-65535.",inputSchema:{port:z$1.number().int().default(7860).describe("Port (default 7860)")},annotations:{title:"Open UI",destructiveHint:false,idempotentHint:false,openWorldHint:true}},o=>{let r=o.port;return r>=1024&&r<=65535?(spawn(process.execPath,[process.argv[1]??"","ui","--port",String(r)],{detached:true,stdio:"ignore"}).unref(),{content:[I(`devcoach UI starting at http://localhost:${r}`)]}):{content:[I(`error: port ${r} is out of valid range (1024-65535)`)]}}),t.registerTool("complete_onboarding",{title:"Complete Onboarding",description:"Save the user's initial knowledge profile and mark onboarding complete. Wipes any default-seeded profile. topics: {topic_id: confidence_0_to_10}. groups: {group_name: [topic_id,...]} (topics not in any group go to 'Other'). Returns the updated Profile.",inputSchema:{topics:z$1.record(z$1.string(),Le).describe("{topic_id: confidence 0-10}"),groups:z$1.record(z$1.string(),z$1.array(z$1.string())).optional().describe("{group_name: [topic_id, ...]}")},outputSchema:Xo,annotations:{title:"Complete Onboarding",destructiveHint:true,idempotentHint:false,openWorldHint:false}},async o=>{try{let r=m(n=>{n.exec("DELETE FROM knowledge; DELETE FROM knowledge_groups; DELETE FROM knowledge_group_names;");for(let[s,a]of Object.entries(o.topics))O(n,s,Math.max(0,Math.min(10,a)));if(o.groups)for(let[s,a]of Object.entries(o.groups))for(let l of a)l in o.topics&&N(n,l,s);return M(n)});return We(r)}catch(r){return L(`complete_onboarding failed: ${r}`)}});let e=(o,r)=>({title:o,description:r,mimeType:"application/json"});return t.registerResource("profile","devcoach://profile",e("Knowledge Profile","Current knowledge map \u2014 topics, confidence scores, and groups."),o=>{try{return _(o,m(r=>M(r)))}catch(r){return _(o,{error:String(r)})}}),t.registerResource("settings","devcoach://settings",e("Settings","Current coaching settings (rate limits, UI theme)."),o=>{try{return _(o,m(r=>E(r)))}catch(r){return _(o,{error:String(r)})}}),t.registerResource("recent-lessons","devcoach://lessons/recent",e("Recent Lessons","Last 10 lessons from the current week."),o=>{try{return _(o,m(r=>B(r,{period:"week",page:1,per_page:10})))}catch(r){return _(o,[{error:String(r)}])}}),t.registerResource("stats","devcoach://stats",e("Stats","Aggregate coaching statistics: counts and weakest/strongest topics."),o=>{try{return _(o,m(r=>Z(r)))}catch(r){return _(o,{error:String(r)})}}),t.registerResource("taught-topics","devcoach://taught-topics",e("Taught Topics","All topic_ids already taught \u2014 read before selecting a new lesson topic."),o=>{try{return _(o,m(r=>bt(r)))}catch{return _(o,[])}}),t.registerResource("rate-limit","devcoach://rate-limit",e("Rate Limit","Current rate-limit status and running lesson total."),o=>{try{let{r,total:n}=m(a=>({r:z(a),total:X(a)})),s={allowed:r.allowed,total_lessons:n};return r.reason!=null&&(s.reason=r.reason),_(o,s)}catch(r){return _(o,{allowed:false,reason:`Rate limit check unavailable: ${r}`})}}),t.registerResource("context","devcoach://context",e("Workspace Context","Auto-detected git context and most-used lesson metadata defaults."),o=>{try{let r=Q(),n=m(s=>He(s));return _(o,{git:r,usage_defaults:n})}catch(r){return _(o,{error:String(r)})}}),t.registerResource("onboarding","devcoach://onboarding",e("Onboarding","Onboarding status, auto-detected stack, and project topic defaults."),o=>{try{let n=m(d=>de(d)).knowledge_ready,s=existsSync(w)&&statSync(w).size>0,a=Q(),l=_e(a.folder??process.cwd());return _(o,{knowledge_ready:n,notebook_ready:s,needs_onboarding:!(n&&s),detected_stack:l,default_topics:at,context_ready:a.branch!==null})}catch(r){return _(o,{error:String(r)})}}),t.registerResource("lesson",new ResourceTemplate("devcoach://lessons/{lesson_id}",{list:void 0}),e("Lesson","A single lesson by id."),(o,r)=>{try{let n=String(r.lesson_id),s=m(a=>K(a,n));return s?_(o,s):_(o,{error:`Lesson '${n}' not found`})}catch(n){return _(o,{error:String(n)})}}),t.registerPrompt("devcoach_instructions",{title:"devcoach coaching instructions",description:"Full coaching instructions for the devcoach skill (content of SKILL.md)."},()=>({messages:[{role:"user",content:{type:"text",text:vt()}}]})),t}async function $t(){let t=Jo(),e=new StdioServerTransport;await t.connect(e);}function ee(t){return JSON.stringify(t??"").replace(/[<>&\u2028\u2029]/g,e=>String.raw`\u`+(e.codePointAt(0)??0).toString(16).padStart(4,"0"))}function $e(t){let e=(o,r,n)=>html`<a href="${o}" class="text-gray-500 dark:text-gray-300 hover:text-gray-900 dark:hover:text-white transition ${n?"text-gray-900 dark:text-white font-semibold":""}">${r}</a>`;return html`<!DOCTYPE html>
48
+ `),go(t),uo(t);}function go(t){try{t.exec("ALTER TABLE lessons ADD COLUMN body TEXT");}catch{}}function uo(t){for(let[e,o]of Object.entries(ao))S(t,"INSERT OR IGNORE INTO settings (key, value) VALUES (?, ?)",e,o);}var dt="(id, timestamp, topic_id, categories, title, level, summary, body, task_context, project, repository, branch, commit_hash, folder, repository_platform, starred, feedback)",ct="(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)";function lt(t){return [t.id,t.timestamp,t.topic_id,JSON.stringify(t.categories),t.title,t.level,t.summary,t.body,t.task_context,t.project,t.repository,t.branch,t.commit_hash,t.folder,t.repository_platform,t.starred?1:0,t.feedback]}function pt(t,e){S(t,`INSERT OR REPLACE INTO lessons ${dt} VALUES ${ct}`,...lt(e));}var mo=[["project","project"],["repository","repository"],["branch","branch"],["commit","commit_hash"]];function fo(t,e){if(t.date_from==null&&t.date_to==null){let o=wo(t.period??null);o!=null&&e("timestamp >= ?",o);return}if(t.date_from!=null&&e("timestamp >= ?",t.date_from),t.date_to!=null){let o=t.date_to.includes("T")||t.date_to.includes(" ");e("timestamp <= ?",o?t.date_to:`${t.date_to}T23:59:59`);}}function gt(t){let e=[],o=[],r=(s,...a)=>{e.push(s),o.push(...a);};fo(t,r),t.category!=null&&r("categories LIKE ?",`%"${t.category}"%`),t.level!=null&&r("level = ?",t.level);for(let[s,a]of mo){let l=t[s];l!=null&&r(`${a} LIKE ?`,`%${l}%`);}if(t.starred!=null&&r("starred = ?",t.starred?1:0),t.search!=null){let s=`%${t.search}%`;r("(title LIKE ? OR topic_id LIKE ? OR summary LIKE ? OR body LIKE ?)",s,s,s,s);}return t.feedback==="none"?r("feedback IS NULL"):t.feedback!=null&&r("feedback = ?",t.feedback),{where:e.length?`WHERE ${e.join(" AND ")}`:"",params:o}}function X(t,e={}){let{where:o,params:r}=gt(e),n=G(t,`SELECT COUNT(*) AS n FROM lessons ${o}`,...r);return Number(n?.n??0)}var bo=new Set(["timestamp","level","topic_id","title","feedback"]),yo=new Set(["project","repository","branch","commit_hash","repository_platform"]);function B(t,e={}){let{where:o,params:r}=gt(e),n=e.sort&&bo.has(e.sort)?e.sort:"timestamp",s=(e.order??"desc").toLowerCase()==="asc"?"ASC":"DESC",a=`SELECT * FROM lessons ${o} ORDER BY ${n} ${s}`,l=[...r];if(e.page!=null){let d=e.per_page??25;a+=" LIMIT ? OFFSET ?",l.push(d,(e.page-1)*d);}return j(t,a,...l).map(Ge)}function he(t,e){return S(t,"DELETE FROM lessons WHERE id = ?",e)>0}function Y(t,e,o){return S(t,"UPDATE lessons SET starred = ? WHERE id = ?",o?1:0,e)>0}function ne(t,e,o){S(t,"UPDATE lessons SET feedback = ? WHERE id = ?",o||null,e);let r=G(t,"SELECT topic_id FROM lessons WHERE id = ?",e);return r?r.topic_id:null}function se(t){return j(t,"SELECT * FROM lessons ORDER BY timestamp DESC").map(Ge)}function Me(t,e){let o=0,r=0,n=0;for(let s of e){let a;try{a=re(s);}catch{n+=1;continue}S(t,`INSERT OR IGNORE INTO lessons ${dt} VALUES ${ct}`,...lt(a))>0?o+=1:r+=1;}return {inserted:o,duplicated:r,invalid:n}}function ie(t,e){if(!yo.has(e))throw new Error(`Column not allowed: ${JSON.stringify(e)}`);return j(t,`SELECT DISTINCT ${e} FROM lessons WHERE ${e} IS NOT NULL ORDER BY ${e}`).map(r=>r[e])}function K(t,e){let o=G(t,"SELECT * FROM lessons WHERE id = ?",e);return o?Ge(o):null}function ut(t){return j(t,"SELECT DISTINCT value FROM lessons, json_each(lessons.categories) ORDER BY value").map(o=>o.value)}function mt(t){return j(t,"SELECT DISTINCT topic_id FROM lessons").map(e=>e.topic_id)}function xe(t,e){let o=G(t,"SELECT COUNT(*) AS n FROM lessons WHERE timestamp >= ?",e);return Number(o?.n??0)}function ft(t){let e=G(t,"SELECT timestamp FROM lessons ORDER BY timestamp DESC LIMIT 1");return e?e.timestamp:null}function Fe(t){let e={};for(let o of j(t,"SELECT topic, confidence FROM knowledge"))e[o.topic]=Number(o.confidence);return e}function ae(t){return j(t,"SELECT topic, confidence FROM knowledge ORDER BY topic").map(e=>({topic:e.topic,confidence:Number(e.confidence)}))}function He(t){let e=j(t,"SELECT group_name FROM knowledge_group_names ORDER BY group_name").map(r=>r.group_name),o=new Map;for(let r of j(t,"SELECT group_name, topic FROM knowledge_groups ORDER BY group_name, topic")){let n=r.group_name,s=o.get(n)??[];s.push(r.topic),o.set(n,s);}return e.map(r=>({name:r,topics:o.get(r)??[]}))}function O(t,e,o){let r=Math.max(0,Math.min(10,o)),n=new Date().toISOString();S(t,`INSERT INTO knowledge (topic, confidence, updated_at) VALUES (?, ?, ?)
49
+ ON CONFLICT(topic) DO UPDATE SET confidence = excluded.confidence, updated_at = excluded.updated_at`,e,r,n);}function J(t,e){let o=S(t,"DELETE FROM knowledge WHERE topic = ?",e);return S(t,"DELETE FROM knowledge_groups WHERE topic = ?",e),o>0}function P(t,e){let o=e.trim();if(!o)throw new Error("Group name must not be empty");return S(t,"INSERT OR IGNORE INTO knowledge_group_names (group_name) VALUES (?)",o)>0}function V(t,e){return S(t,"DELETE FROM knowledge_groups WHERE group_name = ?",e),S(t,"DELETE FROM knowledge_group_names WHERE group_name = ?",e)>0}function N(t,e,o){S(t,"INSERT OR IGNORE INTO knowledge_group_names (group_name) VALUES (?)",o),S(t,"DELETE FROM knowledge_groups WHERE topic = ?",e),S(t,"INSERT OR IGNORE INTO knowledge_groups (group_name, topic) VALUES (?, ?)",o,e);}function ke(t,e){S(t,"DELETE FROM knowledge_groups WHERE topic = ?",e);}function E(t){let e={};for(let d of j(t,"SELECT key, value FROM settings"))e[d.key]=d.value;let o=e.min_gap_minutes,r=e.min_hours_between,n;o!==void 0?n=Number.parseInt(o,10):r!==void 0?n=Number.parseInt(r,10)*60:n=240;let s=e.max_per_day,a=e.ui_theme??"system",l=a==="dark"||a==="light"||a==="system"?a:"system";return {max_per_day:s!==void 0?Number.parseInt(s,10):2,min_gap_minutes:n,ui_theme:l}}function R(t,e,o){S(t,"INSERT INTO settings (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value",e,o);}function de(t){let e=G(t,"SELECT COUNT(*) AS n FROM knowledge");return {knowledge_ready:Number(e?.n??0)>0}}function Ue(t){let e={};for(let o of ["project","repository","branch","repository_platform"]){let r=G(t,`SELECT ${o} AS v, COUNT(*) AS c FROM lessons WHERE ${o} IS NOT NULL GROUP BY ${o} ORDER BY c DESC LIMIT 1`);e[o]=r?r.v:null;}return e}function ve(t){let e=E(t),o=se(t),r=ae(t),n=He(t),s=new Map;for(let d of n)for(let f of d.topics)s.set(f,d.name);let a={groups:n.map(d=>d.name),topics:r.map(d=>({topic:d.topic,confidence:d.confidence,group:s.get(d.topic)??null}))},l={[Oe]:strToU8(JSON.stringify(e,null,2)),[De]:strToU8(JSON.stringify(o,null,2)),[Ne]:strToU8(JSON.stringify(a,null,2))};return existsSync(w)&&(l[je]=strToU8(readFileSync(w,"utf8"))),zipSync(l)}function ho(t,e,o){if(!(Oe in e))return;let r=JSON.parse(strFromU8(e[Oe]));"max_per_day"in r&&R(t,"max_per_day",String(r.max_per_day)),"min_gap_minutes"in r&&R(t,"min_gap_minutes",String(r.min_gap_minutes)),(r.ui_theme==="system"||r.ui_theme==="dark"||r.ui_theme==="light")&&R(t,"ui_theme",r.ui_theme),o.settings=1;}function xo(t,e,o){if(!(Ne in e))return;let r=JSON.parse(strFromU8(e[Ne]));if(!(r&&typeof r=="object"&&Array.isArray(r.topics))){for(let[s,a]of Object.entries(r))O(t,s,a);o.topics=Object.keys(r).length;return}let n=0;for(let s of r.groups??[])P(t,s)&&(n+=1);for(let s of r.topics){O(t,s.topic,s.confidence);let a=s.group;a&&a!=="Other"&&(P(t,a)&&(n+=1),N(t,s.topic,a));}o.topics=r.topics.length,o.groups=n;}function ko(t,e,o){if(!(De in e))return;let r=JSON.parse(strFromU8(e[De])),{inserted:n,duplicated:s,invalid:a}=Me(t,r);o.lessons=n,o.skipped=s,o.invalid=a;}function vo(t,e){je in t&&(mkdirSync(dirname(w),{recursive:true}),writeFileSync(w,strFromU8(t[je]),"utf8"),e.learning_state=1);}function ce(t,e){let o={settings:0,topics:0,groups:0,lessons:0,skipped:0,invalid:0,learning_state:0},r=unzipSync(e);return ho(t,r,o),xo(t,r,o),ko(t,r,o),vo(r,o),o}function wo(t){let e=new Date,o;if(t==="today")o=new Date(Date.UTC(e.getUTCFullYear(),e.getUTCMonth(),e.getUTCDate(),0,0,0,0));else if(t==="week")o=new Date(e.getTime()-7*864e5);else if(t==="month")o=new Date(e.getTime()-30*864e5);else if(t==="year")o=new Date(e.getTime()-365*864e5);else return null;return o.toISOString()}function Ge(t){let e=[];try{let o=JSON.parse(t.categories);Array.isArray(o)&&(e=o);}catch{e=[];}return re({...t,categories:e,starred:!!t.starred})}function z(t){try{let e=E(t),o=new Date,r=new Date(o.getTime()-24*36e5).toISOString(),n=xe(t,r);if(n>=e.max_per_day)return {allowed:!1,reason:`Daily limit reached (${n}/${e.max_per_day} lessons in the last 24h)`};let s=ft(t);if(s!=null){let a=new Date(s),l=(o.getTime()-a.getTime())/6e4;if(l<e.min_gap_minutes){let d=e.min_gap_minutes-l,f=Math.floor(e.min_gap_minutes/60),b=e.min_gap_minutes%60,y=Math.trunc(d),k=Math.floor(y/60),v=y%60;return {allowed:!1,reason:`Too soon: last lesson ${l<0?`in ${Math.round(-l)}m (future timestamp)`:`${Math.round(l)}m ago`}, minimum interval is ${f}h ${b}m (${k}h ${v}m remaining)`}}}return {allowed:!0}}catch(e){return {allowed:true,reason:`Rate limit check failed: ${e}`}}}function M(t){try{return {knowledge:ae(t),groups:He(t)}}catch{return {knowledge:[],groups:[]}}}function q(t,e,o){let r=Fe(t)[e]??5,n=Math.max(0,Math.min(10,r+o));return O(t,e,n),n}function we(t,e,o){let r=ne(t,e,o);return r&&(o==="know"||o==="dont_know")&&q(t,r,o==="know"?1:-1),r}function Z(t){try{let e=new Date,o=X(t),r=new Date(e.getTime()-24*36e5).toISOString(),n=new Date(e.getTime()-7*864e5).toISOString(),s=xe(t,r),a=xe(t,n),l=Fe(t),d=Object.entries(l).sort((y,k)=>y[1]-k[1]),f=d.slice(0,5).map(([y,k])=>({topic:y,confidence:k})),b=d.slice(-5).reverse().map(([y,k])=>({topic:y,confidence:k}));return {total_lessons:o,lessons_today:s,lessons_this_week:a,weakest_topics:f,strongest_topics:b}}catch(e){return {error:String(e)}}}function bt(t){try{return mt(t)}catch{return []}}var To=[["package.json","javascript",6],["tsconfig*.json","typescript",6],["requirements*.txt","python",6],["pyproject.toml","python",6],["setup.py","python",6],["go.mod","go",6],["Cargo.toml","rust",6],["pom.xml","java",6],["build.gradle","java",6],["build.gradle.kts","java",6],["*.csproj","csharp",6],["Gemfile","ruby",6],["composer.json","php",6],["Dockerfile","docker",7],["Dockerfile.*","docker",7],["docker-compose.yml","docker_compose",7],["docker-compose.yaml","docker_compose",7],["docker-compose.*.yml","docker_compose",7],[".github/workflows/*.yml","github_actions",6],[".github/workflows/*.yaml","github_actions",6],[".gitlab-ci.yml","gitlab_ci",6],["Jenkinsfile","ci_cd",6],["*.tf","terraform",6],["*.sql","sql",5],[".git","git",7],["kubernetes/*.yaml","kubernetes",6],["kubernetes/*.yml","kubernetes",6],["k8s/*.yaml","kubernetes",6],["*.bicep","azure",6],["serverless.yml","aws",6],["serverless.yaml","aws",6],["template.yaml","aws",5],["angular.json","angular",6],["svelte.config.*","svelte",6],["nuxt.config.*","vue",6],["vite.config.*","javascript",6]],Eo={react:"react","react-dom":"react",vue:"vue","@angular/core":"angular",svelte:"svelte",next:"nextjs",nuxt:"vue",fastify:"fastify",express:"express",koa:"express","@nestjs/core":"node_js"},Co={django:"django",flask:"flask",fastapi:"fastapi",starlette:"fastapi",tornado:"python",aiohttp:"python",sqlalchemy:"postgresql",celery:"python"};function Ro(t){let e="";for(let o of t)o==="*"?e+="[^/]*":o==="?"?e+="[^/]":e+=o.replace(/[.+^${}()|[\]\\]/g,String.raw`\$&`);return new RegExp(`^${e}$`)}function Lo(t,e){let o=e.lastIndexOf("/"),r=o>=0?join(t,e.slice(0,o)):t,n=o>=0?e.slice(o+1):e,s;try{s=readdirSync(r);}catch{return false}let a=Ro(n);return s.some(l=>a.test(l))}function yt(t){try{return existsSync(t)?readFileSync(t,"utf8"):null}catch{return null}}function Io(t,e){let o=yt(join(t,"package.json"));if(!o)return;let r;try{r=JSON.parse(o);}catch{return}let n=new Set([...Object.keys(r.dependencies??{}),...Object.keys(r.devDependencies??{})]);for(let[s,a]of Object.entries(Eo))n.has(s)&&e(a,6);}function Oo(t,e){let o=["requirements.txt","requirements-dev.txt","requirements/base.txt","pyproject.toml"];for(let r of o){let n=yt(join(t,r))?.toLowerCase();if(n)for(let[s,a]of Object.entries(Co))n.includes(s)&&e(a,6);}}function _e(t){let e={},o=(r,n)=>{(e[r]??-1)<n&&(e[r]=n);};for(let[r,n,s]of To)Lo(t,r)&&o(n,s);return Io(t,o),Oo(t,o),e}function qe(...t){try{return execFileSync("git",t,{encoding:"utf8",timeout:3e3,stdio:["ignore","pipe","ignore"]}).trim()||null}catch{return null}}var ht={"github.com":"github","gitlab.com":"gitlab","bitbucket.org":"bitbucket"};function jo(t){if(!t)return [null,null];let e=/^git@([^:]+):(.+?)(?:\.git)?$/.exec(t);if(e){let r=(e[1]??"").toLowerCase();return [e[2]??t,ht[r]??"local"]}let o=/^https?:\/\/([^/]+)\/(.+?)(?:\.git)?$/.exec(t);if(o){let r=(o[1]??"").toLowerCase();return [o[2]??t,ht[r]??"local"]}return [t,"local"]}function Q(){let t=process.cwd(),e=qe("rev-parse","--abbrev-ref","HEAD"),o=qe("rev-parse","HEAD"),r=qe("remote","get-url","origin"),[n,s]=jo(r),a;return n?a=n.replace(/\/+$/,"").split("/").pop()??null:a=basename(t)||null,e==="HEAD"&&(e=null),{project:a,repository:n,branch:e,commit_hash:o,folder:t,repository_platform:s}}var kt=dirname(fileURLToPath(import.meta.url)),Fo=[join(kt,"../assets/SKILL.md"),join(kt,"../../assets/SKILL.md")];function vt(){for(let t of Fo)try{return readFileSync(t,"utf8")}catch{}return "devcoach: coaching instructions unavailable (SKILL.md not found in package)."}var wt={version:"0.3.62"};var le=wt.version;var I=t=>({type:"text",text:t}),_t=t=>({content:[I(JSON.stringify(t))]}),L=t=>({isError:true,content:[I(t)]}),We=t=>({content:[I(JSON.stringify(t))],structuredContent:t}),Wo={id:z$1.string(),timestamp:z$1.string(),topic_id:z$1.string(),categories:z$1.array(z$1.string()),title:z$1.string(),level:me,summary:z$1.string(),body:z$1.string().nullable(),task_context:z$1.string().nullable(),project:z$1.string().nullable(),repository:z$1.string().nullable(),branch:z$1.string().nullable(),commit_hash:z$1.string().nullable(),folder:z$1.string().nullable(),repository_platform:fe.nullable(),starred:z$1.boolean(),feedback:Re.nullable()},Xo={knowledge:z$1.array(z$1.object({topic:z$1.string(),confidence:z$1.number().int()})),groups:z$1.array(z$1.object({name:z$1.string(),topics:z$1.array(z$1.string())}))},Yo={max_per_day:z$1.number().int(),min_gap_minutes:z$1.number().int(),ui_theme:Ie};function _(t,e){return {contents:[{uri:t.href,mimeType:"application/json",text:JSON.stringify(e)}]}}function Jo(){let t=new McpServer({name:"devcoach",version:le},{instructions:"Progressive technical coaching server. Use the devcoach_instructions prompt for full coaching behaviour guidelines."});t.registerTool("log_lesson",{title:"Log Lesson",description:"Save a delivered lesson to the coaching log. Git metadata (project, repository, branch, commit_hash, folder, repository_platform) is auto-detected from the workspace when omitted. Returns the saved Lesson with all resolved fields.",inputSchema:{id:z$1.string().describe("Unique lesson id (uuid or random string)"),timestamp:z$1.string().describe("ISO 8601 timestamp; normalized to UTC and clamped to now"),topic_id:z$1.string().describe("Primary topic id, e.g. 'python'"),categories:z$1.array(z$1.string()).describe("Category tags, e.g. ['python','performance']"),title:z$1.string().describe("Short lesson title"),level:me.describe("Difficulty level: junior | mid | senior"),summary:z$1.string().describe("1-3 sentence summary shown in the lesson card"),body:z$1.string().nullish().describe("Optional full lesson markdown"),task_context:z$1.string().nullish().describe("What the user was doing when taught"),project:z$1.string().nullish().describe("Project name (auto-detected from git if omitted)"),repository:z$1.string().nullish().describe("org/repo or path (auto-detected if omitted)"),branch:z$1.string().nullish().describe("git branch (auto-detected if omitted)"),commit_hash:z$1.string().nullish().describe("git commit hash (auto-detected if omitted)"),folder:z$1.string().nullish().describe("workspace folder (auto-detected if omitted)"),repository_platform:fe.nullish().describe("github | gitlab | bitbucket | local (auto-detected if omitted)")},outputSchema:Wo,annotations:{title:"Log Lesson",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=Q(),n={};try{n=m(a=>Ue(a));}catch{n={};}let s=re({id:o.id,timestamp:o.timestamp,topic_id:o.topic_id,categories:o.categories,title:o.title,level:o.level,summary:o.summary,body:o.body??null,task_context:o.task_context??null,project:o.project??r.project??n.project??null,repository:o.repository??r.repository??n.repository??null,branch:o.branch??r.branch??n.branch??null,commit_hash:o.commit_hash??r.commit_hash??null,folder:o.folder??r.folder??null,repository_platform:o.repository_platform??r.repository_platform??n.repository_platform??null});m(a=>pt(a,s));try{if(t.server.getClientCapabilities()?.elicitation){let l=await t.server.elicitInput({message:"Did that land?",requestedSchema:{type:"object",properties:{feedback:{type:"string",title:"Did that land?",description:"know = got it \xB7 dont_know = need to revisit \xB7 skip = no feedback",enum:["know","dont_know","skip"]}},required:[]}}),d=l.action==="accept"?l.content?.feedback:void 0;d&&d!=="skip"&&(m(f=>{ne(f,o.id,d),q(f,o.topic_id,d==="know"?1:-1);}),s={...s,feedback:d});}}catch{}return We(s)}catch(r){return L(`log_lesson failed: ${r}`)}}),t.registerTool("update_knowledge",{title:"Update Knowledge",description:"Adjust the confidence score for a topic by delta (e.g. +1 or -1). Returns the new confidence (0-10). Creates the topic at confidence 5 if it does not exist.",inputSchema:{topic:z$1.string().describe("Topic id, e.g. 'python'"),delta:z$1.number().int().describe("Signed change to apply, e.g. +1 or -1")},annotations:{title:"Update Knowledge",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>q(n,o.topic,o.delta));return {content:[I(String(r))]}}catch(r){return L(`update_knowledge failed for '${o.topic}': ${r}`)}}),t.registerTool("get_lessons",{title:"Get Lessons",description:"Query the coaching lesson history. All filters combine. period defaults to all; date_from/date_to override period; limit caps results newest-first (0 = all).",inputSchema:{period:z$1.enum(["today","week","month","year","all"]).nullish().describe("Time window"),category:z$1.string().nullish().describe("Filter by a category tag, e.g. 'python'"),level:z$1.enum(["junior","mid","senior"]).nullish().describe("Filter by difficulty level"),project:z$1.string().nullish().describe("Fuzzy match on git project"),repository:z$1.string().nullish().describe("Fuzzy match on git repository"),branch:z$1.string().nullish().describe("Fuzzy match on git branch"),commit:z$1.string().nullish().describe("Fuzzy match on commit hash"),starred:z$1.boolean().nullish().describe("True to return only starred lessons"),feedback:z$1.enum(["know","dont_know","none"]).nullish().describe("Filter by feedback ('none' = no response)"),search:z$1.string().nullish().describe("Full-text search over title, topic_id, summary, body"),date_from:z$1.string().nullish().describe("ISO date/datetime lower bound"),date_to:z$1.string().nullish().describe("ISO date/datetime upper bound (date-only = end-of-day)"),limit:z$1.number().int().default(10).describe("Max lessons, newest first. Pass 0 for all.")},annotations:{title:"Get Lessons",readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false}},o=>{try{let r=m(n=>B(n,{period:o.period,category:o.category,level:o.level,project:o.project,repository:o.repository,branch:o.branch,commit:o.commit,starred:o.starred,feedback:o.feedback,search:o.search,date_from:o.date_from,date_to:o.date_to,page:o.limit>0?1:null,per_page:o.limit}));return _t(r)}catch{return _t([])}}),t.registerTool("star_lesson",{title:"Star Lesson",description:"Set the starred (favourite) flag on a lesson. Returns true if found and updated. Idempotent.",inputSchema:{lesson_id:z$1.string().describe("Lesson id"),starred:z$1.boolean().describe("true to favourite, false to unmark")},annotations:{title:"Star Lesson",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>Y(n,o.lesson_id,o.starred));return {content:[I(String(r))]}}catch(r){return L(`star_lesson failed for '${o.lesson_id}': ${r}`)}}),t.registerTool("delete_lesson",{title:"Delete Lesson",description:"Permanently delete a lesson by id. Returns true if found and deleted.",inputSchema:{lesson_id:z$1.string().describe("Lesson id to delete")},annotations:{title:"Delete Lesson",destructiveHint:true,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>he(n,o.lesson_id));return {content:[I(String(r))]}}catch(r){return L(`delete_lesson failed for '${o.lesson_id}': ${r}`)}}),t.registerTool("submit_feedback",{title:"Submit Feedback",description:"Record comprehension feedback for a lesson and adjust knowledge confidence. know = +1, dont_know = -1, clear = remove feedback (no confidence change). Idempotent \u2014 the same feedback twice adjusts confidence only once.",inputSchema:{lesson_id:z$1.string().describe("Lesson id"),feedback:z$1.enum(["know","dont_know","clear"]).describe("know | dont_know | clear")},annotations:{title:"Submit Feedback",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=o.feedback==="clear"?null:o.feedback,n=m(s=>{let a=s.prepare("SELECT feedback, topic_id FROM lessons WHERE id = ?").get(o.lesson_id);return a?(a.feedback===r||(ne(s,o.lesson_id,r),(r==="know"||r==="dont_know")&&a.topic_id&&q(s,a.topic_id,r==="know"?1:-1)),!0):!1});return {content:[I(String(n))]}}catch(r){return L(`submit_feedback failed for '${o.lesson_id}': ${r}`)}}),t.registerTool("add_topic",{title:"Add Topic",description:"Add a topic to the knowledge map, or update its confidence if it exists. Optionally assign to a group (auto-created). Prefer a single-word topic id. Idempotent.",inputSchema:{topic:z$1.string().describe("Topic id \u2014 prefer a single word, max 3 words"),confidence:Le.default(5).describe("Initial confidence 0-10 (default 5)"),group:z$1.string().nullish().describe("Optional group name; 'Other' if omitted")},annotations:{title:"Add Topic",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{return m(r=>{O(r,o.topic,o.confidence),o.group&&o.group!=="Other"&&N(r,o.topic,o.group);}),{content:[I("true")]}}catch(r){return L(`add_topic failed for '${o.topic}': ${r}`)}}),t.registerTool("remove_topic",{title:"Remove Topic",description:"Remove a topic from the knowledge map entirely. Returns true if it existed.",inputSchema:{topic:z$1.string().describe("Topic id to remove")},annotations:{title:"Remove Topic",destructiveHint:true,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>J(n,o.topic));return {content:[I(String(r))]}}catch(r){return L(`remove_topic failed for '${o.topic}': ${r}`)}}),t.registerTool("add_group",{title:"Add Group",description:"Create a new (initially empty) knowledge group. Idempotent \u2014 returns true either way.",inputSchema:{name:z$1.string().describe("Group name, e.g. 'Machine Learning'")},annotations:{title:"Add Group",destructiveHint:false,idempotentHint:true,openWorldHint:false}},async o=>{try{return m(r=>P(r,o.name.trim())),{content:[I("true")]}}catch(r){return L(`add_group failed for '${o.name}': ${r}`)}}),t.registerTool("remove_group",{title:"Remove Group",description:"Delete a knowledge group. Its topics move to Other. Returns true if it existed.",inputSchema:{name:z$1.string().describe("Group name to delete")},annotations:{title:"Remove Group",destructiveHint:true,idempotentHint:true,openWorldHint:false}},async o=>{try{let r=m(n=>V(n,o.name));return {content:[I(String(r))]}}catch(r){return L(`remove_group failed for '${o.name}': ${r}`)}}),t.registerTool("update_settings",{title:"Update Settings",description:"Update a coaching setting. max_per_day: integer 1-20. min_gap_minutes: integer 0-1440 (0 = no cooldown). Returns the full updated Settings.",inputSchema:{key:z$1.enum(["max_per_day","min_gap_minutes"]).describe("Setting key"),value:z$1.string().describe("New value as an integer string")},outputSchema:Yo,annotations:{title:"Update Settings",destructiveHint:false,idempotentHint:true,openWorldHint:false}},o=>{let r=Number.parseInt(o.value,10);if(Number.isNaN(r))return L(`Value must be an integer, got '${o.value}'`);if(o.key==="max_per_day"&&!(r>=1&&r<=20))return L("max_per_day must be between 1 and 20");if(o.key==="min_gap_minutes"&&!(r>=0&&r<=1440))return L("min_gap_minutes must be between 0 and 1440");let n=m(s=>(R(s,o.key,String(r)),E(s)));return We(n)}),t.registerTool("open_ui",{title:"Open UI",description:"Launch the devcoach web dashboard in the background. port must be 1024-65535.",inputSchema:{port:z$1.number().int().default(7860).describe("Port (default 7860)")},annotations:{title:"Open UI",destructiveHint:false,idempotentHint:false,openWorldHint:true}},o=>{let r=o.port;return r>=1024&&r<=65535?(spawn(process.execPath,[process.argv[1]??"","ui","--port",String(r)],{detached:true,stdio:"ignore"}).unref(),{content:[I(`devcoach UI starting at http://localhost:${r}`)]}):{content:[I(`error: port ${r} is out of valid range (1024-65535)`)]}}),t.registerTool("complete_onboarding",{title:"Complete Onboarding",description:"Save the user's initial knowledge profile and mark onboarding complete. Wipes any default-seeded profile. topics: {topic_id: confidence_0_to_10}. groups: {group_name: [topic_id,...]} (topics not in any group go to 'Other'). Returns the updated Profile.",inputSchema:{topics:z$1.record(z$1.string(),Le).describe("{topic_id: confidence 0-10}"),groups:z$1.record(z$1.string(),z$1.array(z$1.string())).optional().describe("{group_name: [topic_id, ...]}")},outputSchema:Xo,annotations:{title:"Complete Onboarding",destructiveHint:true,idempotentHint:false,openWorldHint:false}},async o=>{try{let r=m(n=>{n.exec("DELETE FROM knowledge; DELETE FROM knowledge_groups; DELETE FROM knowledge_group_names;");for(let[s,a]of Object.entries(o.topics))O(n,s,Math.max(0,Math.min(10,a)));if(o.groups)for(let[s,a]of Object.entries(o.groups))for(let l of a)l in o.topics&&N(n,l,s);return M(n)});return We(r)}catch(r){return L(`complete_onboarding failed: ${r}`)}});let e=(o,r)=>({title:o,description:r,mimeType:"application/json"});return t.registerResource("profile","devcoach://profile",e("Knowledge Profile","Current knowledge map \u2014 topics, confidence scores, and groups."),o=>{try{return _(o,m(r=>M(r)))}catch(r){return _(o,{error:String(r)})}}),t.registerResource("settings","devcoach://settings",e("Settings","Current coaching settings (rate limits, UI theme)."),o=>{try{return _(o,m(r=>E(r)))}catch(r){return _(o,{error:String(r)})}}),t.registerResource("recent-lessons","devcoach://lessons/recent",e("Recent Lessons","Last 10 lessons from the current week."),o=>{try{return _(o,m(r=>B(r,{period:"week",page:1,per_page:10})))}catch(r){return _(o,[{error:String(r)}])}}),t.registerResource("stats","devcoach://stats",e("Stats","Aggregate coaching statistics: counts and weakest/strongest topics."),o=>{try{return _(o,m(r=>Z(r)))}catch(r){return _(o,{error:String(r)})}}),t.registerResource("taught-topics","devcoach://taught-topics",e("Taught Topics","All topic_ids already taught \u2014 read before selecting a new lesson topic."),o=>{try{return _(o,m(r=>bt(r)))}catch{return _(o,[])}}),t.registerResource("rate-limit","devcoach://rate-limit",e("Rate Limit","Current rate-limit status and running lesson total."),o=>{try{let{r,total:n}=m(a=>({r:z(a),total:X(a)})),s={allowed:r.allowed,total_lessons:n};return r.reason!=null&&(s.reason=r.reason),_(o,s)}catch(r){return _(o,{allowed:false,reason:`Rate limit check unavailable: ${r}`})}}),t.registerResource("context","devcoach://context",e("Workspace Context","Auto-detected git context and most-used lesson metadata defaults."),o=>{try{let r=Q(),n=m(s=>Ue(s));return _(o,{git:r,usage_defaults:n})}catch(r){return _(o,{error:String(r)})}}),t.registerResource("onboarding","devcoach://onboarding",e("Onboarding","Onboarding status, auto-detected stack, and project topic defaults."),o=>{try{let n=m(d=>de(d)).knowledge_ready,s=existsSync(w)&&statSync(w).size>0,a=Q(),l=_e(a.folder??process.cwd());return _(o,{knowledge_ready:n,notebook_ready:s,needs_onboarding:!(n&&s),detected_stack:l,default_topics:at,context_ready:a.branch!==null})}catch(r){return _(o,{error:String(r)})}}),t.registerResource("lesson",new ResourceTemplate("devcoach://lessons/{lesson_id}",{list:void 0}),e("Lesson","A single lesson by id."),(o,r)=>{try{let n=String(r.lesson_id),s=m(a=>K(a,n));return s?_(o,s):_(o,{error:`Lesson '${n}' not found`})}catch(n){return _(o,{error:String(n)})}}),t.registerPrompt("devcoach_instructions",{title:"devcoach coaching instructions",description:"Full coaching instructions for the devcoach skill (content of SKILL.md)."},()=>({messages:[{role:"user",content:{type:"text",text:vt()}}]})),t}async function $t(){let t=Jo(),e=new StdioServerTransport;await t.connect(e);}function ee(t){return JSON.stringify(t??"").replace(/[<>&\u2028\u2029]/g,e=>String.raw`\u`+(e.codePointAt(0)??0).toString(16).padStart(4,"0"))}function $e(t){let e=(o,r,n)=>html`<a href="${o}" class="text-gray-500 dark:text-gray-300 hover:text-gray-900 dark:hover:text-white transition ${n?"text-gray-900 dark:text-white font-semibold":""}">${r}</a>`;return html`<!DOCTYPE html>
50
50
  <html lang="en">
51
51
  <head>
52
52
  <meta charset="UTF-8" />
@@ -560,12 +560,12 @@ function updateLabel(inputId, labelId, submitId) {
560
560
  marked.setOptions({ breaks: true, gfm: true });
561
561
  document.getElementById('notebook-preview-settings').innerHTML = marked.parse(${raw(ee(t.notebookContent))});
562
562
  </script>`;return $e({title:"Settings \u2014 devcoach",currentPath:"/settings",uiTheme:t.uiTheme,body:n,scripts:s})}var Je=25;function Ve(t,e="/lessons"){return t?.startsWith("/")&&!t.startsWith("//")?t:e}function C(t,e,o=""){let r=t[e];return typeof r=="string"?r:o}var Ze=dirname(fileURLToPath(import.meta.url)),Ot=[join(Ze,"../assets/static"),join(Ze,"../../assets/static")].find(t=>existsSync(t))??join(Ze,"../assets/static"),sr={".css":"text/css; charset=utf-8",".js":"text/javascript; charset=utf-8",".mjs":"text/javascript; charset=utf-8",".json":"application/json",".svg":"image/svg+xml",".png":"image/png",".woff2":"font/woff2",".woff":"font/woff",".ico":"image/x-icon"};function ir(){try{return m(t=>E(t).ui_theme)}catch{return "system"}}function ar(){let t=new Hono;return t.get("/static/*",e=>{let o=decodeURIComponent(e.req.path.slice(8)),r=join(Ot,o);if(!r.startsWith(Ot))return e.notFound();try{let n=readFileSync(r);return new Response(new Uint8Array(n),{headers:{"content-type":sr[extname(r)]??"application/octet-stream"}})}catch{return e.notFound()}}),t.get("/",e=>{let{profile:o,stats:r,rateLimit:n,settings:s}=m(d=>({profile:M(d),stats:Z(d),rateLimit:z(d),settings:E(d)})),a=new Map;for(let d of o.groups)for(let f of d.topics)a.set(f,d.name);let l={};for(let d of o.groups)l[d.name]=[];for(let d of o.knowledge){let f=a.get(d.topic)??"Other",b=l[f]??[];b.push(d),l[f]=b;}return e.html(Ct({categorised:l,allGroups:o.groups.map(d=>d.name),stats:r,rateLimit:n,maxPerDay:s.max_per_day,uiTheme:s.ui_theme}))}),t.post("/knowledge",async e=>{let o=await e.req.parseBody(),r=C(o,"topic").trim();if(r){let n=Number.parseInt(C(o,"confidence","5"),10)||5,s=C(o,"group").trim();m(a=>{O(a,r,n),s&&s!=="Other"&&N(a,r,s);});}return e.redirect("/",303)}),t.post("/knowledge/:topic/delete",e=>(m(o=>J(o,e.req.param("topic"))),e.redirect("/",303))),t.post("/knowledge/:topic/group",async e=>{let o=C(await e.req.parseBody(),"group").trim(),r=e.req.param("topic");return m(n=>{o&&o!=="Other"?N(n,r,o):ke(n,r);}),e.redirect("/",303)}),t.post("/knowledge/:topic",async e=>{let o=Number.parseInt(C(await e.req.parseBody(),"delta","0"),10)||0;return m(r=>q(r,e.req.param("topic"),o)),e.redirect("/",303)}),t.post("/groups",async e=>{let o=C(await e.req.parseBody(),"group_name").trim();return o&&o!=="Other"&&m(r=>P(r,o)),e.redirect("/",303)}),t.post("/groups/:group_name/delete",e=>(m(o=>V(o,e.req.param("group_name"))),e.redirect("/",303))),t.get("/lessons/export",()=>{let e=m(o=>se(o));return new Response(JSON.stringify(e,null,2),{headers:{"content-type":"application/json","content-disposition":"attachment; filename=devcoach-lessons.json"}})}),t.post("/lessons/import",async e=>{let o=(await e.req.parseBody()).file,r;try{r=JSON.parse(o instanceof File?await o.text():String(o));}catch{return e.redirect("/settings?imported=0&skipped=0&invalid=1",303)}if(!Array.isArray(r))return e.redirect("/settings?imported=0&skipped=0&invalid=1",303);let n=m(s=>Me(s,r));return e.redirect(`/settings?imported=${n.inserted}&skipped=${n.duplicated}&invalid=${n.invalid}`,303)}),t.get("/lessons",e=>{let o=e.req.query(),r=new Set(["junior","mid","senior"]),n=o.level&&r.has(o.level)?o.level:"",s=o.date_from||"",a=o.date_to||"",l=o.starred==="1",d=o.sort||"timestamp",f=o.order==="asc"?"asc":"desc",b=Math.max(1,Number.parseInt(o.page??"1",10)||1),y=o.period||"all",k={period:s||a?null:y!=="all"?y:null,category:o.category||null,level:n||null,project:o.project||null,repository:o.repository||null,branch:o.branch||null,commit:o.commit||null,starred:l?true:null,search:o.search||null,feedback:o.feedback||null,date_from:s||null,date_to:a||null},v=m(h=>{let T=X(h,k),D=Math.max(1,Math.ceil(T/Je));return b=Math.min(b,D),{total:T,totalPages:D,lessons:B(h,{...k,sort:d,order:f,page:b,per_page:Je}),allCategories:ut(h),allProjects:ie(h,"project"),allRepositories:ie(h,"repository"),allBranches:ie(h,"branch"),allCommits:ie(h,"commit_hash"),theme:E(h).ui_theme}}),g={period:y,category:o.category||"",level:n,project:o.project||"",repository:o.repository||"",branch:o.branch||"",commit:o.commit||"",starred:l,search:o.search||"",feedback:o.feedback||"",date_from:s,date_to:a,sort:d,order:f};return e.html(Rt({lessons:v.lessons,allCategories:v.allCategories,allProjects:v.allProjects,allRepositories:v.allRepositories,allBranches:v.allBranches,allCommits:v.allCommits,s:g,page:b,perPage:Je,total:v.total,totalPages:v.totalPages,uiTheme:v.theme}))}),t.post("/lessons/:lesson_id/star",async e=>{let o=await e.req.parseBody();return m(r=>Y(r,e.req.param("lesson_id"),o.starred==="1")),e.redirect(Ve(C(o,"next")||void 0),303)}),t.post("/lessons/:lesson_id/feedback",async e=>{let o=await e.req.parseBody(),r=C(o,"feedback"),n=r===""||r==="clear"?null:r;return m(s=>we(s,e.req.param("lesson_id"),n)),e.redirect(Ve(C(o,"next")||void 0),303)}),t.get("/lessons/:lesson_id",e=>{let o=m(r=>K(r,e.req.param("lesson_id")));return o?e.html(Lt({lesson:o,uiTheme:ir()})):e.html("<h1>Lesson not found</h1>",404)}),t.get("/settings/export",()=>{let e=m(o=>ve(o));return new Response(new Uint8Array(e),{headers:{"content-type":"application/zip","content-disposition":"attachment; filename=devcoach-backup.zip"}})}),t.post("/settings/import",async e=>{let o=(await e.req.parseBody()).file;if(!(o instanceof File))return e.redirect("/settings?imported=0&skipped=0&invalid=1",303);let r=new Uint8Array(await o.arrayBuffer()),n=m(s=>ce(s,r));return e.redirect(`/settings?imported=${n.lessons}&skipped=${n.skipped}&invalid=${n.invalid}&groups=${n.groups}&notebook=${n.learning_state}`,303)}),t.get("/settings/notebook/download",()=>{let e=existsSync(w)?readFileSync(w,"utf8"):"";return new Response(e,{headers:{"content-type":"text/markdown","content-disposition":"attachment; filename=devcoach-notebook.md"}})}),t.post("/settings/notebook",async e=>{let o=await e.req.parseBody();return mkdirSync(dirname(w),{recursive:true}),writeFileSync(w,C(o,"content"),"utf8"),e.redirect(Ve(C(o,"next")||void 0,"/settings?notebook_saved=1"),303)}),t.post("/settings",async e=>{let o=await e.req.parseBody(),r=Number.parseInt(C(o,"max_per_day","2"),10)||2,n=Number.parseInt(C(o,"min_gap_minutes","240"),10),s=C(o,"ui_theme","system");return ["system","dark","light"].includes(s)||(s="system"),m(a=>{R(a,"max_per_day",String(r)),R(a,"min_gap_minutes",String(Number.isNaN(n)?240:n)),R(a,"ui_theme",s);}),e.redirect("/settings",303)}),t.get("/settings",e=>{let o=m(a=>E(a)),r=existsSync(w)?readFileSync(w,"utf8"):"",n=e.req.query(),s=n.imported!==void 0?{imported:Number(n.imported??0),skipped:Number(n.skipped??0),invalid:Number(n.invalid??0),groups:Number(n.groups??0),notebook:Number(n.notebook??0)}:null;return e.html(It({settings:o,notebookContent:r,notebookPath:w,uiTheme:o.ui_theme,flash:s}))}),t}function Nt(t){let e=ar();serve({fetch:e.fetch,port:t,hostname:"127.0.0.1"},o=>{console.log(`devcoach UI running at http://localhost:${o.port}`);});}var cr=!!process.stdout.isTTY&&!process.env.NO_COLOR,W=(t,e)=>cr?styleText(t,e):e,i={green:t=>W("green",t),red:t=>W("red",t),yellow:t=>W("yellow",t),cyan:t=>W("cyan",t),magenta:t=>W("magenta",t),dim:t=>W("dim",t),bold:t=>W("bold",t)};function et(t,e){return t==="green"?i.green(e):t==="yellow"?i.yellow(e):i.red(e)}var lr=/\[[0-9;]*m/g,pr=t=>t.replace(lr,""),Te=t=>[...pr(t)].length;function jt(t,e,o){let r=Math.max(0,e-Te(t));if(o==="right")return " ".repeat(r)+t;if(o==="center"){let n=Math.floor(r/2);return " ".repeat(n)+t+" ".repeat(r-n)}return t+" ".repeat(r)}function te(t,e,o,r=true){let n=e.map((f,b)=>Math.max(r?Te(f.header):0,...o.map(y=>Te(y[b]??"")))),s=(f,b,y)=>f+n.map(k=>"\u2500".repeat(k+2)).join(b)+y,a=f=>`\u2502${f.map((b,y)=>` ${jt(b??"",n[y]??0,e[y]?.justify??"left")} `).join("\u2502")}\u2502`,l=n.reduce((f,b)=>f+b+3,1),d=[];t&&d.push(jt(i.bold(t),l,"center")),d.push(s("\u256D","\u252C","\u256E")),r&&d.push(a(e.map(f=>i.bold(f.header))),s("\u251C","\u253C","\u2524"));for(let f of o)d.push(a(f));return d.push(s("\u2570","\u2534","\u256F")),d.join(`
563
- `)}function Ee(t=""){if(!t)return "\u2500".repeat(60);let o=` ${t} `,r=Math.max(2,60-Te(o)),n=Math.floor(r/2);return "\u2500".repeat(n)+o+"\u2500".repeat(r-n)}var At=t=>{let e=Math.max(0,Math.min(10,Math.round(t)));return "\u2588".repeat(e)+"\u2591".repeat(10-e)},Pt=t=>t>=7?"green":t>=4?"yellow":"red";var u=(t="")=>{console.log(t);},Ht=t=>t==="junior"?i.green(t):t==="mid"?i.yellow(t):t==="senior"?i.red(t):t,hr=t=>t==="know"?` ${i.green("\u2713")}`:t==="dont_know"?` ${i.red("\u2717")}`:"",xr=t=>t==="know"?i.green("\u2713 I know this"):t==="dont_know"?i.red("\u2717 I don't know this"):i.dim("no feedback");function Gt(t,e){let o=new Map;for(let n of t.groups)for(let s of n.topics)o.set(s,n.name);let r=[...t.knowledge].sort((n,s)=>s.confidence-n.confidence).map(n=>{let s=Pt(n.confidence);return [n.topic,o.get(n.topic)??"Other",et(s,`${n.confidence}/10`),et(s,At(n.confidence))]});return te(e,[{header:"Topic"},{header:"Group"},{header:"Confidence",justify:"right"},{header:"Bar"}],r)}function kr(){let t=m(e=>M(e));u(Gt(t,"Knowledge Map"));}function vr(t){let e=m(s=>B(s,{period:t.period==="all"?null:t.period,category:t.category,level:t.level,project:t.project,repository:t.repository,branch:t.branch,commit:t.commit,starred:t.starred?!0:null,feedback:t.feedback,date_from:t.dateFrom,date_to:t.dateTo,sort:t.sort,order:t.order}));if(e.length===0){u(i.dim("No lessons found."));return}let o=e.some(s=>s.project||s.branch||s.commit_hash),r=[{header:""},{header:"Date"},{header:"Topic"},{header:"Title"},{header:"Level",justify:"center"},{header:"Categories"}];o&&r.push({header:"Project"},{header:"Branch"},{header:"Commit"});let n=e.map(s=>{let a=[s.starred?i.yellow("\u2605"):i.dim("\xB7"),s.timestamp.slice(0,10),i.cyan(s.topic_id),s.title+hr(s.feedback),Ht(s.level),s.categories.join(", ")];return o&&a.push(s.project??"",s.branch?i.magenta(s.branch):"",s.commit_hash?i.cyan(s.commit_hash.slice(0,7)):""),a});u(te("Lessons",r,n));}function wr(t){let e=m(r=>K(r,t));e===null&&(u(i.red(`Lesson '${t}' not found.`)),process.exit(1)),u(Ee(i.bold(e.title))),u(`${i.dim("ID:")} ${e.id}`),u(`${i.dim("Date:")} ${e.timestamp.slice(0,19).replace("T"," ")}`),u(`${i.dim("Topic:")} ${e.topic_id}`),u(`${i.dim("Categories:")} ${e.categories.join(", ")}`),u(`${i.dim("Level:")} ${Ht(e.level)}`);let o=e.starred?i.yellow("\u2605 starred"):i.dim("\u2606 not starred");if(u(`${i.dim("Star:")} ${o} ${i.dim("Feedback:")} ${xr(e.feedback)}`),e.task_context&&u(`${i.dim("Context:")} ${e.task_context}`),e.project||e.repository||e.branch||e.commit_hash||e.folder){let r=[];e.project&&r.push(`project=${e.project}`),e.repository&&r.push(`repo=${e.repository}`),e.branch&&r.push(`branch=${i.magenta(e.branch)}`),e.commit_hash&&r.push(`commit=${i.cyan(e.commit_hash.slice(0,7))}`),e.folder&&r.push(`folder=${e.folder}`),u(`${i.dim("Git:")} ${r.join(" \xB7 ")}`);}u(Ee()),u(e.summary);}function Ft(t,e){m(r=>K(r,t)===null?!1:(Y(r,t,e),!0))||(u(i.red(`Lesson '${t}' not found.`)),process.exit(1)),u(e?`Lesson ${i.cyan(t)} \u2192 ${i.yellow("\u2605 starred")}`:`Lesson ${i.cyan(t)} \u2192 ${i.dim("\u2606 unstarred")}`);}function _r(t){m(o=>he(o,t))||(u(i.red(`Lesson '${t}' not found.`)),process.exit(1)),u(`Lesson ${i.cyan(t)} deleted.`);}function $r(t,e){["know","dont_know","clear"].includes(e)||(u(i.red(`Invalid feedback '${e}'. Use: know | dont_know | clear`)),process.exit(1));let o=e==="clear"?null:e,r=m(a=>{let l=we(a,t,o);if(l===null)return null;let d=a.prepare("SELECT confidence FROM knowledge WHERE topic = ?").get(l);return {topicId:l,newConf:d?d.confidence:5}});r===null&&(u(i.red(`Lesson '${t}' not found.`)),process.exit(1));let n;if(o==="know"||o==="dont_know"){let a=r.newConf+(o==="know"?-1:1);n=`${i.cyan(r.topicId)} confidence: ${a} \u2192 ${i.bold(String(r.newConf))}`;}else n="feedback cleared";let s=o==="know"?i.green("\u2713 I know this"):o==="dont_know"?i.red("\u2717 I don't know this"):i.dim("cleared");u(`Lesson ${i.cyan(t)} \u2192 ${s} (${n})`);}function Sr(){let t=m(n=>E(n)),e=Math.floor(t.min_gap_minutes/60),o=t.min_gap_minutes%60,r=e?`${e}h ${o}m`:`${o}m`;u(te("Settings",[{header:"Key"},{header:"Value",justify:"right"}],[["max_per_day",String(t.max_per_day)],["min_gap_minutes",`${t.min_gap_minutes} (${r})`]]));}function Tr(){let{stats:t,rateLimit:e,settings:o}=m(l=>({stats:Z(l),rateLimit:z(l),settings:E(l)})),r=l=>Number(t[l]??0),n=e.allowed?i.green("Available now"):i.yellow(e.reason??"");u(te("Coaching Stats",[{header:"Metric"},{header:"Value",justify:"right"}],[["Total lessons",String(r("total_lessons"))],["Lessons today (24h)",`${r("lessons_today")} / ${o.max_per_day}`],["Lessons this week",String(r("lessons_this_week"))],["Next lesson",n]],false));let s=t.weakest_topics??[],a=t.strongest_topics??[];if(s.length||a.length){let l=[];for(let d=0;d<Math.max(s.length,a.length);d++){let f=s[d],b=a[d];l.push([f?`${i.red(f.topic)} ${i.dim(`(${f.confidence})`)}`:"",b?`${i.green(b.topic)} ${i.dim(`(${b.confidence})`)}`:""]);}u(te(void 0,[{header:"Weakest topics"},{header:"Strongest topics"}],l));}}function Er(t,e){["max_per_day","min_gap_minutes"].includes(t)||(u(i.red(`Unknown key '${t}'. Valid keys: max_per_day, min_gap_minutes`)),process.exit(1)),m(o=>R(o,t,e)),u(i.green(`Set ${t} = ${e}`));}function Cr(t,e,o){let r=t.trim();r||(u(i.red("Topic name must not be empty.")),process.exit(1)),m(s=>{O(s,r,e),o&&o!=="Other"&&N(s,r,o);});let n=o&&o!=="Other"?` \u2192 ${i.cyan(o)}`:"";u(`${i.green("Added")} ${i.bold(r)} (confidence ${i.cyan(String(e))})${n}`);}function Rr(t){let e=m(o=>J(o,t));u(e?`${i.green("Removed")} ${i.bold(t)} from knowledge map`:i.yellow(`Topic '${t}' not found.`));}function Lr(t){let e=t.trim();(!e||e==="Other")&&(u(i.red("Invalid group name.")),process.exit(1)),m(o=>P(o,e)),u(`${i.green(`Group '${i.cyan(e)}' ready.`)} Assign topics with: devcoach group-assign <topic> "${e}"`);}function Ir(t){let e=m(o=>V(o,t));u(e?`${i.green(`Removed group '${i.cyan(t)}'`)}`:i.yellow(`Group '${t}' not found.`));}function Or(t,e){m(r=>r.prepare("SELECT topic FROM knowledge WHERE topic = ?").get(t)===void 0?!1:(e==="Other"?ke(r,t):N(r,t,e),!0))||(u(i.red(`Topic '${t}' not in knowledge map. Add it first.`)),process.exit(1)),u(e==="Other"?`${i.green("Moved")} ${i.bold(t)} \u2192 Other (ungrouped)`:`${i.green("Moved")} ${i.bold(t)} \u2192 ${i.cyan(e)}`);}function Dr(t){let{lessonsCount:e,knowledgeCount:o,data:r}=m(s=>({lessonsCount:se(s).length,knowledgeCount:ae(s).length,data:ve(s)}));writeFileSync(t,r);let n=existsSync(w)?" + notebook":"";u(`${i.green("Backup saved:")} ${t} (${i.cyan(String(e))} lessons, ${i.cyan(String(o))} topics${n})`);}function Nr(t){existsSync(t)||(u(i.red(`File not found: ${t}`)),process.exit(1));let e=m(r=>ce(r,readFileSync(t)));e.settings&&u(`${i.green("\u2713")} Settings restored`),e.topics&&u(`${i.green("\u2713")} Knowledge map restored (${i.cyan(String(e.topics))} topics)`);let o=[`${i.cyan(String(e.lessons))} imported`];e.skipped&&o.push(`${i.yellow(String(e.skipped))} duplicates skipped`),e.invalid&&o.push(`${i.red(String(e.invalid))} rejected (invalid)`),u(`${i.green("\u2713")} Lessons: ${o.join(", ")}`),e.learning_state&&u(`${i.green("\u2713")} Notebook restored`);}function jr(){let t=platform();if(t==="darwin")return join(homedir(),"Library","Application Support","Claude","claude_desktop_config.json");if(t==="win32"){let o=process.env.APPDATA??join(homedir(),"AppData","Roaming");return join(o,"Claude","claude_desktop_config.json")}let e=process.env.XDG_CONFIG_HOME??join(homedir(),".config");return join(e,"Claude","claude_desktop_config.json")}var Ar=join(homedir(),".claude","settings.json");function Bt(t){for(let e of (process.env.PATH??"").split(":"))if(e)try{return accessSync(join(e,t),constants.X_OK),!0}catch{}return false}function rt(){return Bt("devcoach")?{command:"devcoach",args:["mcp"]}:{command:"npx",args:["-y","devcoach","mcp"]}}function Pr(){return rt().command==="devcoach"?"devcoach":"npx -y devcoach"}function Mr(t,e){if(!Bt("claude"))return "";e&&spawnSync("claude",["mcp","remove","--scope",t,"devcoach"],{encoding:"utf8"});let o=rt(),r=spawnSync("claude",["mcp","add","--scope",t,"devcoach",o.command,"--",...o.args],{encoding:"utf8"});return r.status===0?`${i.green("\u2713")} Registered via \`claude mcp add\` (scope: ${t})`:`${r.stderr??""}${r.stdout??""}`.toLowerCase().includes("already")?`${i.yellow("Already registered")} in Claude Code (use --force to overwrite)`:`${i.red("claude mcp add failed:")} ${(r.stderr||r.stdout||"").trim()}`}function Kt(t){if(!existsSync(t))return {ok:true,data:{}};try{return {ok:!0,data:JSON.parse(readFileSync(t,"utf8"))??{}}}catch{return {ok:false,error:`${i.red("\u2717")} ${t} is not valid JSON \u2014 fix it and re-run (left unchanged)`}}}function Ut(t,e,o){let r=Kt(t);if(!r.ok)return r.error;let n=r.data;n.mcpServers??={};let s=n.mcpServers;return s.devcoach&&!o?`${i.yellow("Already registered")} in ${t} (use --force to overwrite)`:(s.devcoach=e,mkdirSync(dirname(t),{recursive:true}),writeFileSync(t,`${JSON.stringify(n,null,2)}
563
+ `)}function Ee(t=""){if(!t)return "\u2500".repeat(60);let o=` ${t} `,r=Math.max(2,60-Te(o)),n=Math.floor(r/2);return "\u2500".repeat(n)+o+"\u2500".repeat(r-n)}var At=t=>{let e=Math.max(0,Math.min(10,Math.round(t)));return "\u2588".repeat(e)+"\u2591".repeat(10-e)},Pt=t=>t>=7?"green":t>=4?"yellow":"red";var u=(t="")=>{console.log(t);},Ut=t=>t==="junior"?i.green(t):t==="mid"?i.yellow(t):t==="senior"?i.red(t):t,hr=t=>t==="know"?` ${i.green("\u2713")}`:t==="dont_know"?` ${i.red("\u2717")}`:"",xr=t=>t==="know"?i.green("\u2713 I know this"):t==="dont_know"?i.red("\u2717 I don't know this"):i.dim("no feedback");function Gt(t,e){let o=new Map;for(let n of t.groups)for(let s of n.topics)o.set(s,n.name);let r=[...t.knowledge].sort((n,s)=>s.confidence-n.confidence).map(n=>{let s=Pt(n.confidence);return [n.topic,o.get(n.topic)??"Other",et(s,`${n.confidence}/10`),et(s,At(n.confidence))]});return te(e,[{header:"Topic"},{header:"Group"},{header:"Confidence",justify:"right"},{header:"Bar"}],r)}function kr(){let t=m(e=>M(e));u(Gt(t,"Knowledge Map"));}function vr(t){let e=m(s=>B(s,{period:t.period==="all"?null:t.period,category:t.category,level:t.level,project:t.project,repository:t.repository,branch:t.branch,commit:t.commit,starred:t.starred?!0:null,feedback:t.feedback,date_from:t.dateFrom,date_to:t.dateTo,sort:t.sort,order:t.order}));if(e.length===0){u(i.dim("No lessons found."));return}let o=e.some(s=>s.project||s.branch||s.commit_hash),r=[{header:""},{header:"Date"},{header:"Topic"},{header:"Title"},{header:"Level",justify:"center"},{header:"Categories"}];o&&r.push({header:"Project"},{header:"Branch"},{header:"Commit"});let n=e.map(s=>{let a=[s.starred?i.yellow("\u2605"):i.dim("\xB7"),s.timestamp.slice(0,10),i.cyan(s.topic_id),s.title+hr(s.feedback),Ut(s.level),s.categories.join(", ")];return o&&a.push(s.project??"",s.branch?i.magenta(s.branch):"",s.commit_hash?i.cyan(s.commit_hash.slice(0,7)):""),a});u(te("Lessons",r,n));}function wr(t){let e=m(r=>K(r,t));e===null&&(u(i.red(`Lesson '${t}' not found.`)),process.exit(1)),u(Ee(i.bold(e.title))),u(`${i.dim("ID:")} ${e.id}`),u(`${i.dim("Date:")} ${e.timestamp.slice(0,19).replace("T"," ")}`),u(`${i.dim("Topic:")} ${e.topic_id}`),u(`${i.dim("Categories:")} ${e.categories.join(", ")}`),u(`${i.dim("Level:")} ${Ut(e.level)}`);let o=e.starred?i.yellow("\u2605 starred"):i.dim("\u2606 not starred");if(u(`${i.dim("Star:")} ${o} ${i.dim("Feedback:")} ${xr(e.feedback)}`),e.task_context&&u(`${i.dim("Context:")} ${e.task_context}`),e.project||e.repository||e.branch||e.commit_hash||e.folder){let r=[];e.project&&r.push(`project=${e.project}`),e.repository&&r.push(`repo=${e.repository}`),e.branch&&r.push(`branch=${i.magenta(e.branch)}`),e.commit_hash&&r.push(`commit=${i.cyan(e.commit_hash.slice(0,7))}`),e.folder&&r.push(`folder=${e.folder}`),u(`${i.dim("Git:")} ${r.join(" \xB7 ")}`);}u(Ee()),u(e.summary);}function Ft(t,e){m(r=>K(r,t)===null?!1:(Y(r,t,e),!0))||(u(i.red(`Lesson '${t}' not found.`)),process.exit(1)),u(e?`Lesson ${i.cyan(t)} \u2192 ${i.yellow("\u2605 starred")}`:`Lesson ${i.cyan(t)} \u2192 ${i.dim("\u2606 unstarred")}`);}function _r(t){m(o=>he(o,t))||(u(i.red(`Lesson '${t}' not found.`)),process.exit(1)),u(`Lesson ${i.cyan(t)} deleted.`);}function $r(t,e){["know","dont_know","clear"].includes(e)||(u(i.red(`Invalid feedback '${e}'. Use: know | dont_know | clear`)),process.exit(1));let o=e==="clear"?null:e,r=m(a=>{let l=we(a,t,o);if(l===null)return null;let d=a.prepare("SELECT confidence FROM knowledge WHERE topic = ?").get(l);return {topicId:l,newConf:d?d.confidence:5}});r===null&&(u(i.red(`Lesson '${t}' not found.`)),process.exit(1));let n;if(o==="know"||o==="dont_know"){let a=r.newConf+(o==="know"?-1:1);n=`${i.cyan(r.topicId)} confidence: ${a} \u2192 ${i.bold(String(r.newConf))}`;}else n="feedback cleared";let s=o==="know"?i.green("\u2713 I know this"):o==="dont_know"?i.red("\u2717 I don't know this"):i.dim("cleared");u(`Lesson ${i.cyan(t)} \u2192 ${s} (${n})`);}function Sr(){let t=m(n=>E(n)),e=Math.floor(t.min_gap_minutes/60),o=t.min_gap_minutes%60,r=e?`${e}h ${o}m`:`${o}m`;u(te("Settings",[{header:"Key"},{header:"Value",justify:"right"}],[["max_per_day",String(t.max_per_day)],["min_gap_minutes",`${t.min_gap_minutes} (${r})`]]));}function Tr(){let{stats:t,rateLimit:e,settings:o}=m(l=>({stats:Z(l),rateLimit:z(l),settings:E(l)})),r=l=>Number(t[l]??0),n=e.allowed?i.green("Available now"):i.yellow(e.reason??"");u(te("Coaching Stats",[{header:"Metric"},{header:"Value",justify:"right"}],[["Total lessons",String(r("total_lessons"))],["Lessons today (24h)",`${r("lessons_today")} / ${o.max_per_day}`],["Lessons this week",String(r("lessons_this_week"))],["Next lesson",n]],false));let s=t.weakest_topics??[],a=t.strongest_topics??[];if(s.length||a.length){let l=[];for(let d=0;d<Math.max(s.length,a.length);d++){let f=s[d],b=a[d];l.push([f?`${i.red(f.topic)} ${i.dim(`(${f.confidence})`)}`:"",b?`${i.green(b.topic)} ${i.dim(`(${b.confidence})`)}`:""]);}u(te(void 0,[{header:"Weakest topics"},{header:"Strongest topics"}],l));}}function Er(t,e){["max_per_day","min_gap_minutes"].includes(t)||(u(i.red(`Unknown key '${t}'. Valid keys: max_per_day, min_gap_minutes`)),process.exit(1)),m(o=>R(o,t,e)),u(i.green(`Set ${t} = ${e}`));}function Cr(t,e,o){let r=t.trim();r||(u(i.red("Topic name must not be empty.")),process.exit(1)),m(s=>{O(s,r,e),o&&o!=="Other"&&N(s,r,o);});let n=o&&o!=="Other"?` \u2192 ${i.cyan(o)}`:"";u(`${i.green("Added")} ${i.bold(r)} (confidence ${i.cyan(String(e))})${n}`);}function Rr(t){let e=m(o=>J(o,t));u(e?`${i.green("Removed")} ${i.bold(t)} from knowledge map`:i.yellow(`Topic '${t}' not found.`));}function Lr(t){let e=t.trim();(!e||e==="Other")&&(u(i.red("Invalid group name.")),process.exit(1)),m(o=>P(o,e)),u(`${i.green(`Group '${i.cyan(e)}' ready.`)} Assign topics with: devcoach group-assign <topic> "${e}"`);}function Ir(t){let e=m(o=>V(o,t));u(e?`${i.green(`Removed group '${i.cyan(t)}'`)}`:i.yellow(`Group '${t}' not found.`));}function Or(t,e){m(r=>r.prepare("SELECT topic FROM knowledge WHERE topic = ?").get(t)===void 0?!1:(e==="Other"?ke(r,t):N(r,t,e),!0))||(u(i.red(`Topic '${t}' not in knowledge map. Add it first.`)),process.exit(1)),u(e==="Other"?`${i.green("Moved")} ${i.bold(t)} \u2192 Other (ungrouped)`:`${i.green("Moved")} ${i.bold(t)} \u2192 ${i.cyan(e)}`);}function Dr(t){let{lessonsCount:e,knowledgeCount:o,data:r}=m(s=>({lessonsCount:se(s).length,knowledgeCount:ae(s).length,data:ve(s)}));writeFileSync(t,r);let n=existsSync(w)?" + notebook":"";u(`${i.green("Backup saved:")} ${t} (${i.cyan(String(e))} lessons, ${i.cyan(String(o))} topics${n})`);}function Nr(t){existsSync(t)||(u(i.red(`File not found: ${t}`)),process.exit(1));let e=m(r=>ce(r,readFileSync(t)));e.settings&&u(`${i.green("\u2713")} Settings restored`),e.topics&&u(`${i.green("\u2713")} Knowledge map restored (${i.cyan(String(e.topics))} topics)`);let o=[`${i.cyan(String(e.lessons))} imported`];e.skipped&&o.push(`${i.yellow(String(e.skipped))} duplicates skipped`),e.invalid&&o.push(`${i.red(String(e.invalid))} rejected (invalid)`),u(`${i.green("\u2713")} Lessons: ${o.join(", ")}`),e.learning_state&&u(`${i.green("\u2713")} Notebook restored`);}function jr(){let t=platform();if(t==="darwin")return join(homedir(),"Library","Application Support","Claude","claude_desktop_config.json");if(t==="win32"){let o=process.env.APPDATA??join(homedir(),"AppData","Roaming");return join(o,"Claude","claude_desktop_config.json")}let e=process.env.XDG_CONFIG_HOME??join(homedir(),".config");return join(e,"Claude","claude_desktop_config.json")}var Ar=join(homedir(),".claude","settings.json");function Bt(t){for(let e of (process.env.PATH??"").split(":"))if(e)try{return accessSync(join(e,t),constants.X_OK),!0}catch{}return false}function rt(){return Bt("devcoach")?{command:"devcoach",args:["mcp"]}:{command:"npx",args:["-y","devcoach","mcp"]}}function Pr(){return rt().command==="devcoach"?"devcoach":"npx -y devcoach"}function Mr(t,e){if(!Bt("claude"))return "";e&&spawnSync("claude",["mcp","remove","--scope",t,"devcoach"],{encoding:"utf8"});let o=rt(),r=spawnSync("claude",["mcp","add","--scope",t,"devcoach",o.command,"--",...o.args],{encoding:"utf8"});return r.status===0?`${i.green("\u2713")} Registered via \`claude mcp add\` (scope: ${t})`:`${r.stderr??""}${r.stdout??""}`.toLowerCase().includes("already")?`${i.yellow("Already registered")} in Claude Code (use --force to overwrite)`:`${i.red("claude mcp add failed:")} ${(r.stderr||r.stdout||"").trim()}`}function Kt(t){if(!existsSync(t))return {ok:true,data:{}};try{return {ok:!0,data:JSON.parse(readFileSync(t,"utf8"))??{}}}catch{return {ok:false,error:`${i.red("\u2717")} ${t} is not valid JSON \u2014 fix it and re-run (left unchanged)`}}}function Ht(t,e,o){let r=Kt(t);if(!r.ok)return r.error;let n=r.data;n.mcpServers??={};let s=n.mcpServers;return s.devcoach&&!o?`${i.yellow("Already registered")} in ${t} (use --force to overwrite)`:(s.devcoach=e,mkdirSync(dirname(t),{recursive:true}),writeFileSync(t,`${JSON.stringify(n,null,2)}
564
564
  `),`${i.green("\u2713")} Installed into ${t}`)}function Fr(t){let e=Pr(),o=Ar,r=Kt(o);if(!r.ok)return r.error;let n=r.data;n.hooks??={};let s=n.hooks;s.Stop??=[];let a=s.Stop,l=a.map((d,f)=>[d,f]).filter(([d])=>(d.hooks??[]).some(f=>(f.command??"").includes("devcoach"))).map(([,d])=>d);if(l.length){if(!t)return `${i.yellow("Stop hooks already installed")} in ${o} (use --force to overwrite)`;for(let d of l.toReversed())a.splice(d,1);}return a.push({hooks:[{type:"command",command:`${e} onboard-hook`}]},{hooks:[{type:"command",command:`${e} lesson-ready`}]}),mkdirSync(dirname(o),{recursive:true}),writeFileSync(o,`${JSON.stringify(n,null,2)}
565
- `),`${i.green("\u2713")} Stop hooks installed into ${o}`}function Ur(t){let e=t.claudeCode||!t.claudeDesktop,o=t.claudeDesktop||!t.claudeCode,r=rt(),n=false;if(u(i.bold("Setting up devcoach")+i.dim(` (${r.command} ${r.args.join(" ")})`)),u(),e){u(i.bold("Claude Code"));let s=Mr("user",t.force);if(!s){let a=join(homedir(),".claude.json");s=Ut(a,{type:"stdio",env:{},...r},t.force),n=true;}u(` MCP server\u2026 ${s}`),t.skipHook||u(` Stop hooks\u2026 ${Fr(t.force)}`),u();}o&&(u(i.bold("Claude Desktop")),u(` MCP server\u2026 ${Ut(jr(),r,t.force)}`),n=true,u()),n&&u(`${i.yellow("\u2192")} Restart Claude Desktop to pick up the new server.
565
+ `),`${i.green("\u2713")} Stop hooks installed into ${o}`}function Hr(t){let e=t.claudeCode||!t.claudeDesktop,o=t.claudeDesktop||!t.claudeCode,r=rt(),n=false;if(u(i.bold("Setting up devcoach")+i.dim(` (${r.command} ${r.args.join(" ")})`)),u(),e){u(i.bold("Claude Code"));let s=Mr("user",t.force);if(!s){let a=join(homedir(),".claude.json");s=Ht(a,{type:"stdio",env:{},...r},t.force),n=true;}u(` MCP server\u2026 ${s}`),t.skipHook||u(` Stop hooks\u2026 ${Fr(t.force)}`),u();}o&&(u(i.bold("Claude Desktop")),u(` MCP server\u2026 ${Ht(jr(),r,t.force)}`),n=true,u()),n&&u(`${i.yellow("\u2192")} Restart Claude Desktop to pick up the new server.
566
566
  `),u(i.dim(`Tip: run devcoach backup to export your profile, lessons and settings.
567
567
  run devcoach restore <file> to import a backup on a new machine.
568
- The coaching skill is served automatically via the MCP prompt \u2014 always up to date.`));}async function Hr(){let t=createInterface({input:process.stdin,output:process.stdout}),e=async(r,n="")=>{let s=n?` [${n}]`:"";return (await t.question(`${r}${s}: `)).trim()||n},o=async(r,n,s,a)=>{for(;;){let l=await e(r,String(n)),d=Number.parseInt(l,10);if(!Number.isNaN(d)&&d>=s&&d<=a)return d;u(i.red(`Must be ${s}\u2013${a}.`));}};try{u(Ee(i.bold("devcoach setup"))),u(`
568
+ The coaching skill is served automatically via the MCP prompt \u2014 always up to date.`));}async function Ur(){let t=createInterface({input:process.stdin,output:process.stdout}),e=async(r,n="")=>{let s=n?` [${n}]`:"";return (await t.question(`${r}${s}: `)).trim()||n},o=async(r,n,s,a)=>{for(;;){let l=await e(r,String(n)),d=Number.parseInt(l,10);if(!Number.isNaN(d)&&d>=s&&d<=a)return d;u(i.red(`Must be ${s}\u2013${a}.`));}};try{u(Ee(i.bold("devcoach setup"))),u(`
569
569
  ${i.bold("Step 1")} \u2014 Restore from backup`);let r=await e("Path to existing backup zip (Enter to skip)","");if(r){existsSync(r)||(u(i.red(`File not found: ${r}`)),process.exit(1));let b=m(y=>ce(y,readFileSync(r)));u(`${i.green("\u2713")} Restored: ${b.topics} topics, ${b.lessons} lessons${b.learning_state?", notebook":""}`),u(i.green("Setup complete!"));return}u(`
570
570
  ${i.bold("Step 2")} \u2014 Build your knowledge profile`);let n=(await e("Mode: [a]utomatic (detect from files) / [m]anual (type your stack)","a")).toLowerCase(),s={};if(n.startsWith("a")){let y=Q().folder??process.cwd(),k=_e(y),v=Object.keys(k).sort((h,T)=>h.localeCompare(T));if(v.length){u(`
571
571
  ${i.dim(`Detected from ${i.cyan(y)}:`)}`);for(let h of v){let T=k[h]??5,D=await e(` ${i.cyan(h)} (Enter=keep, 0-10=override, s=skip)`,String(T));if(D.toLowerCase()==="s")continue;let ue=Number.parseInt(D,10);s[h]=Number.isNaN(ue)?T:Math.max(0,Math.min(10,ue));}}else u(i.dim("No technology files detected in current directory."));let g=await e(`
@@ -577,4 +577,4 @@ ${i.green("Setup complete!")} ${Object.keys(s).length} topics saved.`);}finally{
577
577
  `),process.stderr.write("devcoach: no coaching profile yet. Run onboarding now \u2014 ask the user how they want to set up their profile: Automatic (detect this project's tech stack), Guided (a short conversation to map topics and confidence levels), or Import (restore from a backup). Do not pick for them. After they choose, build the profile and save it by calling the devcoach `complete_onboarding` MCP tool (not a shell command) before ending your turn.\n"),process.exit(2);}function zr(){let t;try{t=m(e=>de(e).knowledge_ready?z(e).allowed:!1);}catch{process.exit(0);}t||process.exit(0),process.stderr.write("Deliver a devcoach lesson based on the work in this conversation, then record it by calling the devcoach `log_lesson` MCP tool (not a shell/CLI command \u2014 that is required, or this hook will fire again). Ignore the devcoach://rate-limit check \u2014 it is already verified by this hook.\n"),process.exit(2);}function qr(){let t=[["mcp","Start the MCP server (stdio) for Claude Code / Claude Desktop"],["ui [--port N]","Launch the web dashboard (default port: 7860)"],["setup","First-run wizard: import backup or build your knowledge profile"],["install","Register the MCP server + Stop hook in Claude Code / Claude Desktop"],["onboard-hook","Claude Code Stop hook: cue onboarding (exit 2 when profile needed)"],["lesson-ready","Claude Code Stop hook: exit 2 when a lesson is due"],["profile","Show the knowledge map"],["stats","Coaching statistics and rate-limit status"],["settings / set","Show / update settings (max_per_day | min_gap_minutes)"],["lessons / lesson","List past lessons / show one in detail"],["star / unstar / delete","Manage a lesson"],["feedback <id>","Record know / dont_know feedback"],["knowledge-add / -remove","Add / remove a topic"],["group-add / -remove / -assign","Manage knowledge groups"],["backup / restore","Export / import a full backup zip"]];u(`
578
578
  ${i.bold(`devcoach ${i.dim(`v${le}`)}`)}`);for(let[e,o]of t)u(` ${i.cyan(`devcoach ${e}`.padEnd(32))} ${i.dim(o)}`);u(`
579
579
  ${i.dim("Run")} ${i.bold("devcoach <command> --help")} ${i.dim("for per-command options.")}
580
- `);}function A(t){return t??null}function Wr(){let t=new Command;return t.exitOverride(),t.name("devcoach").description("devcoach \u2014 progressive technical coaching").version(`devcoach ${le}`,"-v, --version","output the version number").allowExcessArguments(false).showHelpAfterError("(add --help for usage)").action(()=>qr()),t.command("mcp").description("Start the MCP server (stdio transport)").action($t),t.command("profile").description("Show the knowledge map").action(kr),t.command("lessons").description("List past lessons").option("--period <period>","today | week | month | year | all","all").option("--category <category>","Filter by category tag").option("--project <project>","Filter by project (fuzzy)").option("--repository <repository>","Filter by repository (fuzzy)").option("--branch <branch>","Filter by branch (fuzzy)").option("--commit <commit>","Filter by commit hash prefix (fuzzy)").option("--starred","Show only starred lessons").option("--feedback <feedback>","know | dont_know | none").option("--level <level>","junior | mid | senior").option("--date-from <date>","Show lessons on or after this date (YYYY-MM-DD[THH:MM])").option("--date-to <date>","Show lessons on or before this date (YYYY-MM-DD[THH:MM])").option("--sort <column>","timestamp | level | topic_id | title | feedback","timestamp").option("--order <order>","asc | desc","desc").action(e=>vr({period:e.period??"all",category:A(e.category),project:A(e.project),repository:A(e.repository),branch:A(e.branch),commit:A(e.commit),starred:!!e.starred,feedback:A(e.feedback),level:A(e.level),dateFrom:A(e.dateFrom),dateTo:A(e.dateTo),sort:e.sort??"timestamp",order:e.order??"desc"})),t.command("lesson").description("Show a single lesson in detail").argument("<id>","Lesson ID").action(e=>wr(e)),t.command("star").description("Mark a lesson as starred").argument("<id>","Lesson ID").action(e=>Ft(e,true)),t.command("unstar").description("Remove the starred mark from a lesson").argument("<id>","Lesson ID").action(e=>Ft(e,false)),t.command("delete").description("Permanently delete a lesson").argument("<id>","Lesson ID").action(e=>_r(e)),t.command("feedback").description("Record know/dont_know feedback for a lesson").argument("<id>","Lesson ID").argument("<value>","know | dont_know | clear").action((e,o)=>$r(e,o)),t.command("settings").description("Show current settings").action(Sr),t.command("stats").description("Coaching statistics and rate-limit status").action(Tr),t.command("set").description("Update a setting (max_per_day | min_gap_minutes)").argument("<key>","Setting key").argument("<value>","New value").action((e,o)=>Er(e,o)),t.command("knowledge-add").description("Add or update a topic in the knowledge map").argument("<topic>","Topic ID").option("--confidence <n>","Initial confidence 0-10","5").option("--group <group>","Assign to a named group").action((e,o)=>Cr(e,Math.max(0,Math.min(10,Number.parseInt(o.confidence??"5",10)||5)),A(o.group))),t.command("knowledge-remove").description("Remove a topic from the knowledge map").argument("<topic>","Topic ID").action(e=>Rr(e)),t.command("group-add").description("Register a new knowledge group").argument("<name>","Group name").action(e=>Lr(e)),t.command("group-remove").description("Delete a knowledge group (topics move to Other)").argument("<name>","Group name").action(e=>Ir(e)),t.command("group-assign").description("Move a topic to a group").argument("<topic>","Topic ID").argument("<group>","Group name (use 'Other' to ungroup)").action((e,o)=>Or(e,o)),t.command("backup").description("Export a full backup (settings + knowledge + lessons) as zip").argument("[file]","Output zip path","devcoach-backup.zip").action(e=>Dr(e)),t.command("restore").description("Restore from a backup zip file").argument("<file>","Path to backup zip").action(e=>Nr(e)),t.command("install").description("Register the MCP server + Stop hooks in Claude Code / Claude Desktop").option("--claude-code","Target Claude Code only").option("--claude-desktop","Target Claude Desktop only").option("--force","Overwrite existing devcoach entry").option("--skip-hook","Register MCP server only \u2014 skip the Stop hooks").action(e=>Ur({claudeCode:!!e.claudeCode,claudeDesktop:!!e.claudeDesktop,force:!!e.force,skipHook:!!e.skipHook})),t.command("ui").description("Launch the web dashboard").option("--port <port>","Port","7860").action(e=>Nt(Number.parseInt(e.port??"7860",10)||7860)),t.command("setup").description("First-run wizard: import backup or build your knowledge profile").action(Hr),t.command("onboard-hook",{hidden:true}).description("Claude Code Stop hook: cue onboarding").action(Kr),t.command("lesson-ready",{hidden:true}).description("Claude Code Stop hook: signal a lesson is due").action(zr),t}async function zt(){let t=Wr();try{await t.parseAsync(process.argv);}catch(e){let o=e.code??"";if(!o.startsWith("commander."))throw e;if(o==="commander.helpDisplayed"||o==="commander.help"||o==="commander.version")return;process.exit(2);}}try{await zt();}catch(t){console.error(t),process.exit(1);}
580
+ `);}function A(t){return t??null}function Wr(){let t=new Command;return t.exitOverride(),t.name("devcoach").description("devcoach \u2014 progressive technical coaching").version(`devcoach ${le}`,"-v, --version","output the version number").allowExcessArguments(false).showHelpAfterError("(add --help for usage)").action(()=>qr()),t.command("mcp").description("Start the MCP server (stdio transport)").action($t),t.command("profile").description("Show the knowledge map").action(kr),t.command("lessons").description("List past lessons").option("--period <period>","today | week | month | year | all","all").option("--category <category>","Filter by category tag").option("--project <project>","Filter by project (fuzzy)").option("--repository <repository>","Filter by repository (fuzzy)").option("--branch <branch>","Filter by branch (fuzzy)").option("--commit <commit>","Filter by commit hash prefix (fuzzy)").option("--starred","Show only starred lessons").option("--feedback <feedback>","know | dont_know | none").option("--level <level>","junior | mid | senior").option("--date-from <date>","Show lessons on or after this date (YYYY-MM-DD[THH:MM])").option("--date-to <date>","Show lessons on or before this date (YYYY-MM-DD[THH:MM])").option("--sort <column>","timestamp | level | topic_id | title | feedback","timestamp").option("--order <order>","asc | desc","desc").action(e=>vr({period:e.period??"all",category:A(e.category),project:A(e.project),repository:A(e.repository),branch:A(e.branch),commit:A(e.commit),starred:!!e.starred,feedback:A(e.feedback),level:A(e.level),dateFrom:A(e.dateFrom),dateTo:A(e.dateTo),sort:e.sort??"timestamp",order:e.order??"desc"})),t.command("lesson").description("Show a single lesson in detail").argument("<id>","Lesson ID").action(e=>wr(e)),t.command("star").description("Mark a lesson as starred").argument("<id>","Lesson ID").action(e=>Ft(e,true)),t.command("unstar").description("Remove the starred mark from a lesson").argument("<id>","Lesson ID").action(e=>Ft(e,false)),t.command("delete").description("Permanently delete a lesson").argument("<id>","Lesson ID").action(e=>_r(e)),t.command("feedback").description("Record know/dont_know feedback for a lesson").argument("<id>","Lesson ID").argument("<value>","know | dont_know | clear").action((e,o)=>$r(e,o)),t.command("settings").description("Show current settings").action(Sr),t.command("stats").description("Coaching statistics and rate-limit status").action(Tr),t.command("set").description("Update a setting (max_per_day | min_gap_minutes)").argument("<key>","Setting key").argument("<value>","New value").action((e,o)=>Er(e,o)),t.command("knowledge-add").description("Add or update a topic in the knowledge map").argument("<topic>","Topic ID").option("--confidence <n>","Initial confidence 0-10","5").option("--group <group>","Assign to a named group").action((e,o)=>Cr(e,Math.max(0,Math.min(10,Number.parseInt(o.confidence??"5",10)||5)),A(o.group))),t.command("knowledge-remove").description("Remove a topic from the knowledge map").argument("<topic>","Topic ID").action(e=>Rr(e)),t.command("group-add").description("Register a new knowledge group").argument("<name>","Group name").action(e=>Lr(e)),t.command("group-remove").description("Delete a knowledge group (topics move to Other)").argument("<name>","Group name").action(e=>Ir(e)),t.command("group-assign").description("Move a topic to a group").argument("<topic>","Topic ID").argument("<group>","Group name (use 'Other' to ungroup)").action((e,o)=>Or(e,o)),t.command("backup").description("Export a full backup (settings + knowledge + lessons) as zip").argument("[file]","Output zip path","devcoach-backup.zip").action(e=>Dr(e)),t.command("restore").description("Restore from a backup zip file").argument("<file>","Path to backup zip").action(e=>Nr(e)),t.command("install").description("Register the MCP server + Stop hooks in Claude Code / Claude Desktop").option("--claude-code","Target Claude Code only").option("--claude-desktop","Target Claude Desktop only").option("--force","Overwrite existing devcoach entry").option("--skip-hook","Register MCP server only \u2014 skip the Stop hooks").action(e=>Hr({claudeCode:!!e.claudeCode,claudeDesktop:!!e.claudeDesktop,force:!!e.force,skipHook:!!e.skipHook})),t.command("ui").description("Launch the web dashboard").option("--port <port>","Port","7860").action(e=>Nt(Number.parseInt(e.port??"7860",10)||7860)),t.command("setup").description("First-run wizard: import backup or build your knowledge profile").action(Ur),t.command("onboard-hook",{hidden:true}).description("Claude Code Stop hook: cue onboarding").action(Kr),t.command("lesson-ready",{hidden:true}).description("Claude Code Stop hook: signal a lesson is due").action(zr),t}async function zt(){let t=Wr();try{await t.parseAsync(process.argv);}catch(e){let o=e.code??"";if(!o.startsWith("commander."))throw e;if(o==="commander.helpDisplayed"||o==="commander.help"||o==="commander.version")return;process.exit(2);}}try{await zt();}catch(t){console.error(t),process.exit(1);}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "devcoach",
3
- "version": "0.3.60",
3
+ "version": "0.3.62",
4
4
  "description": "A local MCP server that acts as a progressive technical coach for Claude Code and Claude Desktop",
5
5
  "license": "Apache-2.0",
6
6
  "keywords": [
@@ -12,7 +12,7 @@
12
12
  "developer-tools",
13
13
  "cli"
14
14
  ],
15
- "homepage": "https://github.com/UltimaPhoenix/dev-coach#readme",
15
+ "homepage": "https://ultimaphoenix.github.io/dev-coach/",
16
16
  "repository": {
17
17
  "type": "git",
18
18
  "url": "git+https://github.com/UltimaPhoenix/dev-coach.git"