paris-immersion 0.1.12 → 0.1.14

package/dist/commands/install.js

@@ -10,6 +10,7 @@ import { renderClaudeMd } from '../templates/claude-md.js';
 import { renderSettingsJson } from '../templates/settings.js';
 import { renderParisCoachSkill } from '../templates/skill.js';
 import { renderHookScript } from '../templates/hook.js';
+import { renderTostudyCommand } from '../templates/tostudy-command.js';
 export async function installCommand(opts) {
     const creds = await readCredentials();
     if (!creds) {
@@ -89,6 +90,11 @@ async function writeWorkspaceFiles(targetDir, boot, apiUrl, email) {
     const skillDir = path.join(claudeDir, 'skills', 'paris-coach');
     await fs.mkdir(skillDir, { recursive: true });
     await fs.writeFile(path.join(skillDir, 'SKILL.md'), renderParisCoachSkill());
+    // .claude/commands/tostudy.md — NOSSO slash-command /tostudy (rota confiável do
+    // curso). Garante que /tostudy sempre exista, independente do @tostudy-ai/cli.
+    const commandsDir = path.join(claudeDir, 'commands');
+    await fs.mkdir(commandsDir, { recursive: true });
+    await fs.writeFile(path.join(commandsDir, 'tostudy.md'), renderTostudyCommand());
     // CLAUDE.md — workspace-level rules.
     await fs.writeFile(path.join(targetDir, 'CLAUDE.md'), renderClaudeMd({
         immersionName: boot.immersion.name,

package/dist/commands/serve.d.ts

@@ -37,21 +37,7 @@ export interface ServeHandle {
     port: number;
     close: () => void;
 }
-/**
- * Descobre o slash-command do tutor pra injetar no kickoff. O `@tostudy-ai/cli`
- * instala o comando com nome ESPECÍFICO do curso (`.claude/commands/tostudy-<slug>.md`),
- * NÃO `/tostudy` — então cravar `/tostudy` dava "Unknown command: /tostudy" e o
- * curso não iniciava. Aqui varremos `.claude/commands/tostudy*.md` e usamos o
- * comando real; com vários cursos, casamos com o `slug` ativo do
- * `.tostudy/workspace.json`. Override explícito via PARIS_COACH_KICKOFF.
- * Fallback `/tostudy` (legado / antes do `tostudy` instalar o comando).
- */
 export declare function resolveKickoff(cwd: string): string;
-/**
- * Spawn the coached pty (`claude '/tostudy-<curso>'` inside the provisioned
- * workspace). Shared by the local ws server and the relay agent. Throws if
- * node-pty can't load/spawn — callers report it on their channel.
- */
 export declare function spawnCoachPty(cwd: string): IPty;
 /**
  * Start a localhost WebSocket server that brokers a pty (running `claude`) to a

package/dist/commands/serve.js

@@ -1,11 +1,12 @@
 import { WebSocketServer } from 'ws';
 import { createRequire } from 'node:module';
-import { promises as fs, chmodSync, existsSync, statSync, readdirSync, readFileSync } from 'node:fs';
+import { promises as fs, chmodSync, existsSync, statSync, readdirSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import path from 'node:path';
 import { readCredentials } from '../lib/credentials.js';
 import { ensureWorkspace } from './install.js';
 import { startRelayAgent } from '../lib/relay-agent.js';
+import { renderTostudyCommand } from '../templates/tostudy-command.js';
 import { c } from '../lib/colors.js';
 /**
  * Restore the executable bit on node-pty's `spawn-helper`. Some install paths
@@ -79,6 +80,21 @@ const DEFAULT_ALLOWED_ORIGINS = [
  * `.tostudy/workspace.json`. Override explícito via PARIS_COACH_KICKOFF.
  * Fallback `/tostudy` (legado / antes do `tostudy` instalar o comando).
  */
+// Fallback ROBUSTO quando o slash-command `/tostudy-<slug>` não existe (o
+// `@tostudy-ai/cli` não rodou `init` no workspace, ou rodou DEPOIS do Claude
+// subir — slash-commands carregam no startup, então um comando criado depois dá
+// "Unknown command: /tostudy"). Em vez de cravar `/tostudy` (que erra), passamos
+// um prompt de tutor em TEXTO: o Claude conduz o curso direto pela tostudy CLI
+// (select/next/progress), sem depender de nenhum comando instalado. Sem apóstrofo
+// no texto (o kickoff vai dentro de aspas simples no shell).
+const COURSE_TUTOR_PROMPT = 'Você é o tutor do curso de onboarding da imersão Paris Group, rodando no terminal do aluno. ' +
+    'Comece AGORA falando primeiro, em português — o aluno ainda não digitou nada. ' +
+    'Antes de ensinar, prepare o curso da ToStudy em silêncio: rode no bash "tostudy courses --json" para ver o curso matriculado; ' +
+    'rode "tostudy select <id-ou-número-do-curso>" para ativá-lo; e "tostudy progress --json" para ver onde o aluno parou. ' +
+    'Depois conduza lição por lição, no ritmo do aluno, usando: "tostudy next" (avançar), "tostudy lesson" e "tostudy theory" (conteúdo da lição), ' +
+    '"tostudy hint" (dica) e "tostudy progress" (status). ' +
+    'Se o tostudy não estiver disponível ou sem curso ativo, use as ferramentas MCP get_course e complete_lesson do paris como fallback. ' +
+    'Dê as boas-vindas e já comece a primeira lição.';
 export function resolveKickoff(cwd) {
     const override = process.env.PARIS_COACH_KICKOFF;
     if (override)
@@ -102,8 +118,12 @@ export function resolveKickoff(cwd) {
         }
     }
     if (names.size === 0)
-        return '/tostudy';
+        return COURSE_TUTOR_PROMPT;
     const all = [...names];
+    // Nosso /tostudy (escrito pelo install/serve, sempre presente) é a rota
+    // CONFIÁVEL — preferimos ele: o aluno e o tutor sempre rodam via /tostudy.
+    if (all.some((n) => n.toLowerCase() === 'tostudy'))
+        return '/tostudy';
     // Curso ATIVO deste workspace = fonte da verdade pra escolher entre vários cursos.
     let slug = '';
     try {
@@ -126,17 +146,35 @@ export function resolveKickoff(cwd) {
     const courseSpecific = all.filter((n) => /^tostudy-.+/i.test(n)).sort();
     if (courseSpecific.length)
         return '/' + courseSpecific[0];
-    return '/tostudy';
+    return COURSE_TUTOR_PROMPT;
 }
 /**
  * Spawn the coached pty (`claude '/tostudy-<curso>'` inside the provisioned
  * workspace). Shared by the local ws server and the relay agent. Throws if
  * node-pty can't load/spawn — callers report it on their channel.
  */
+/**
+ * Garante que o slash-command `/tostudy` exista no workspace ANTES do Claude
+ * subir (slash-commands carregam no startup — criados depois não aparecem sem
+ * reload). O `paris install` já escreve, mas reescrevemos aqui pra cobrir
+ * workspaces antigos e manter o conteúdo fresco a cada serve. Best-effort.
+ */
+function ensureTostudyCommand(cwd) {
+    try {
+        const dir = path.join(cwd, '.claude', 'commands');
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(path.join(dir, 'tostudy.md'), renderTostudyCommand());
+    }
+    catch {
+        /* best-effort — se falhar, o resolveKickoff cai no fallback de texto */
+    }
+}
 export function spawnCoachPty(cwd) {
     const req = createRequire(import.meta.url);
     ensureSpawnHelperExecutable(req);
     const ptyMod = req('node-pty');
+    // Escreve /tostudy ANTES de resolver o kickoff + subir o Claude.
+    ensureTostudyCommand(cwd);
     const kickoff = resolveKickoff(cwd);
     const shell = process.env.SHELL || (process.platform === 'win32' ? 'powershell.exe' : 'bash');
     const shellArgs = process.platform === 'win32'

package/dist/index.js

@@ -13,7 +13,7 @@ import { daemonCommand, restartCommand } from './commands/daemon.js';
 const program = new Command()
     .name('paris')
     .description('Paris Immersion — CLI do aluno (login, workspace, tarefas)')
-    .version('0.1.12');
+    .version('0.1.14');
 program
     .command('login')
     .description('Autenticar com sua conta Paris (device-code OR --token direto)')

package/dist/templates/hook.js

@@ -139,7 +139,7 @@ async function main() {
   if (inCourse) {
     lines.push('## FASE DO CURSO DE ONBOARDING')
     lines.push('O aluno está na etapa do curso **' + course.title + '** (progresso: **' + course.lessonsCompleted + '/' + course.totalLessons + '**).')
-    lines.push('Rode a skill **/tostudy** (o tutor da ToStudy) pra conduzir o curso — o aluno já chega logado na conta dele da ToStudy (auto-login no install). NÃO trabalhe em missões da imersão enquanto o curso não terminar. (Fallback: se a ToStudy não estiver disponível, use as ferramentas MCP **get_course**/**complete_lesson** do paris.)')
+    lines.push('Rode **/tostudy** pra conduzir o curso da ToStudy (o comando está instalado no workspace e o aluno já chega logado). Ele ativa o curso e ensina lição por lição. NÃO trabalhe em missões da imersão enquanto o curso não terminar. (Fallback: ferramentas MCP **get_course**/**complete_lesson** do paris.)')
     if (PHASE === 'session-start') {
       lines.push('')
       lines.push('**Comece falando primeiro**: rode /tostudy e dê as boas-vindas. O aluno ainda não digitou nada.')

package/dist/templates/tostudy-command.d.ts

@@ -0,0 +1,10 @@
+/**
+ * O slash-command `/tostudy` que O NOSSO LADO escreve no workspace
+ * (`<ws>/.claude/commands/tostudy.md`). É a rota CONFIÁVEL pra iniciar o curso:
+ * o `@tostudy-ai/cli` só instala um comando específico do curso (`/tostudy-<slug>`)
+ * SE rodar `init` — e mesmo então, se o Claude já tinha subido, ele não recarrega
+ * slash-commands. Escrevendo `/tostudy` nós mesmos (no `paris install` E no
+ * `paris serve`, antes do Claude subir), garantimos que `/tostudy` SEMPRE exista
+ * e SEMPRE funcione, conduzindo o curso real via a tostudy CLI.
+ */
+export declare function renderTostudyCommand(): string;

package/dist/templates/tostudy-command.js

@@ -0,0 +1,37 @@
+/**
+ * O slash-command `/tostudy` que O NOSSO LADO escreve no workspace
+ * (`<ws>/.claude/commands/tostudy.md`). É a rota CONFIÁVEL pra iniciar o curso:
+ * o `@tostudy-ai/cli` só instala um comando específico do curso (`/tostudy-<slug>`)
+ * SE rodar `init` — e mesmo então, se o Claude já tinha subido, ele não recarrega
+ * slash-commands. Escrevendo `/tostudy` nós mesmos (no `paris install` E no
+ * `paris serve`, antes do Claude subir), garantimos que `/tostudy` SEMPRE exista
+ * e SEMPRE funcione, conduzindo o curso real via a tostudy CLI.
+ */
+export function renderTostudyCommand() {
+    return `---
+description: Inicia ou retoma o curso de onboarding da imersão (tutor ToStudy no terminal)
+---
+
+Você é o **tutor do curso de onboarding** da imersão Paris Group, rodando no terminal do aluno. Conduza o curso da ToStudy em **português**, no ritmo do aluno. O aluno já chega logado na conta dele da ToStudy (auto-login no install).
+
+## 1. Prepare o curso (em silêncio, antes de falar)
+
+1. Rode \`tostudy courses --json\` para ver o curso em que o aluno está matriculado.
+2. Rode \`tostudy select <id-ou-número-do-curso>\` para ativá-lo (escolha o curso da imersão; normalmente só há um).
+3. Rode \`tostudy progress --json\` para ver onde ele parou.
+
+## 2. Ensine lição por lição
+
+- \`tostudy next\` — avança para a próxima lição (marca a atual como concluída).
+- \`tostudy lesson\` / \`tostudy theory\` — conteúdo da lição atual.
+- \`tostudy hint\` — dica progressiva quando o aluno travar.
+- \`tostudy validate\` — valida exercícios.
+- \`tostudy progress\` — status atual (lição X de Y, %).
+
+Explique cada lição com suas palavras, traga exemplos do contexto de negócio do aluno e só avance quando ele entender. **Comece dando as boas-vindas** e já ensinando a primeira lição — o aluno ainda não digitou nada. NÃO trabalhe em missões da imersão enquanto o curso não terminar.
+
+## 3. Fallback (se a ToStudy não estiver disponível)
+
+Use as ferramentas MCP do paris: \`get_course\` (currículo + progresso) e \`complete_lesson\` (marcar lição concluída).
+`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paris-immersion",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Paris Immersion CLI — login, install workspace, status, task control. Para alunos das imersões da Paris Group.",
   "homepage": "https://parisgroup.ai",
   "repository": {