paris-immersion 0.1.0 → 0.1.1

package/dist/commands/install.d.ts

@@ -2,3 +2,16 @@ export declare function installCommand(opts: {
     dir?: string;
     immersion?: string;
 }): Promise<void>;
+/**
+ * Locate the student's workspace, or create one if none exists. Used by
+ * `paris serve` so the onboarding embedded terminal always opens a *coached*
+ * Claude session — the student never has to know `paris install` exists. This
+ * is what guarantees the "magic moment": open the terminal, Claude greets you
+ * with today's mission. Returns the workspace dir + whether it was just created.
+ */
+export declare function ensureWorkspace(opts?: {
+    immersion?: string;
+}): Promise<{
+    dir: string;
+    created: boolean;
+}>;

package/dist/commands/install.js

@@ -1,4 +1,5 @@
 import { promises as fs } from 'node:fs';
+import { homedir } from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { apiAuthFetch } from '../lib/api.js';
@@ -22,14 +23,50 @@ export async function installCommand(opts) {
         return;
     }
     process.stdout.write(c.dim('Buscando contexto da imersão...\n'));
-    const slugQuery = opts.immersion ? `?immersion=${encodeURIComponent(opts.immersion)}` : '';
-    const boot = await apiAuthFetch(`/immersion-app/v1/workspace/bootstrap${slugQuery}`, {
+    const boot = await bootstrapWorkspace(opts.immersion);
+    const targetDir = path.resolve(opts.dir ?? `paris-${boot.immersion.slug}`);
+    await writeWorkspaceFiles(targetDir, boot, creds.api_url, creds.email);
+    console.log();
+    console.log(c.green(`✓ Workspace pronto em ${targetDir}`));
+    console.log();
+    console.log(c.bold('Próximo passo:'));
+    console.log(`  cd ${path.relative(process.cwd(), targetDir) || '.'}`);
+    console.log('  claude');
+    console.log();
+    console.log(c.dim(`Imersão: ${boot.immersion.name} · fase ${boot.phase} · dia ${boot.day_number}`));
+}
+/**
+ * Locate the student's workspace, or create one if none exists. Used by
+ * `paris serve` so the onboarding embedded terminal always opens a *coached*
+ * Claude session — the student never has to know `paris install` exists. This
+ * is what guarantees the "magic moment": open the terminal, Claude greets you
+ * with today's mission. Returns the workspace dir + whether it was just created.
+ */
+export async function ensureWorkspace(opts = {}) {
+    const existing = await findMarker();
+    if (existing)
+        return { dir: existing.dir, created: false };
+    const creds = await readCredentials();
+    if (!creds) {
+        throw new Error('Você precisa rodar `paris login` antes.');
+    }
+    const boot = await bootstrapWorkspace(opts.immersion);
+    // Predictable, findable location regardless of where `paris serve` was run.
+    const targetDir = path.join(homedir(), `paris-${boot.immersion.slug}`);
+    await writeWorkspaceFiles(targetDir, boot, creds.api_url, creds.email);
+    return { dir: targetDir, created: true };
+}
+async function bootstrapWorkspace(immersion) {
+    const slugQuery = immersion ? `?immersion=${encodeURIComponent(immersion)}` : '';
+    return apiAuthFetch(`/immersion-app/v1/workspace/bootstrap${slugQuery}`, {
         method: 'POST',
     });
-    const targetDir = path.resolve(opts.dir ?? `paris-${boot.immersion.slug}`);
+}
+/** Write the full workspace layout (marker, hooks, vendored MCP, settings, skill, CLAUDE.md). */
+async function writeWorkspaceFiles(targetDir, boot, apiUrl, email) {
     await fs.mkdir(targetDir, { recursive: true });
     // .paris/workspace.json — the marker.
-    await writeMarker(targetDir, { ...boot.marker, api_url: creds.api_url });
+    await writeMarker(targetDir, { ...boot.marker, api_url: apiUrl });
     // .paris/hooks/paris-hook.mjs — installed Claude Code hook.
     const hooksDir = path.join(targetDir, '.paris', 'hooks');
     await fs.mkdir(hooksDir, { recursive: true });
@@ -40,13 +77,12 @@ export async function installCommand(opts) {
     const mcpDir = path.join(targetDir, '.paris', 'mcp');
     await fs.mkdir(mcpDir, { recursive: true });
     await fs.writeFile(path.join(mcpDir, 'index.mjs'), await readVendoredMcpBundle(), { mode: 0o755 });
-    // .claude/settings.json — wires hooks + MCP server.
+    // .claude/settings.json — wires hooks + MCP server. Both settings.json (for
+    // interactive `claude`) and settings.local.json (the source `claude -p`
+    // reliably loads hooks from).
     const claudeDir = path.join(targetDir, '.claude');
     await fs.mkdir(claudeDir, { recursive: true });
-    // Write both settings.json (so the regular interactive `claude` picks it up)
-    // and settings.local.json (so `claude -p` does too — in -p mode, local
-    // settings are the reliably-loaded source for hooks).
-    const settingsPayload = renderSettingsJson({ apiUrl: creds.api_url });
+    const settingsPayload = renderSettingsJson({ apiUrl });
     await fs.writeFile(path.join(claudeDir, 'settings.json'), JSON.stringify(settingsPayload, null, 2));
     await fs.writeFile(path.join(claudeDir, 'settings.local.json'), JSON.stringify(settingsPayload, null, 2));
     // .claude/skills/paris-coach/SKILL.md
@@ -57,16 +93,8 @@ export async function installCommand(opts) {
     await fs.writeFile(path.join(targetDir, 'CLAUDE.md'), renderClaudeMd({
         immersionName: boot.immersion.name,
         immersionSlug: boot.immersion.slug,
-        participantEmail: creds.email,
+        participantEmail: email,
     }));
-    console.log();
-    console.log(c.green(`✓ Workspace pronto em ${targetDir}`));
-    console.log();
-    console.log(c.bold('Próximo passo:'));
-    console.log(`  cd ${path.relative(process.cwd(), targetDir) || '.'}`);
-    console.log('  claude');
-    console.log();
-    console.log(c.dim(`Imersão: ${boot.immersion.name} · fase ${boot.phase} · dia ${boot.day_number}`));
 }
 /**
  * Reads the bundled MCP server shipped with this package. Lives at

package/dist/commands/serve.d.ts

@@ -2,6 +2,9 @@ export interface ServeOptions {
     port: number;
     allowedOrigins: string[];
     token: string;
+    /** Working directory the embedded `claude` runs in. Defaults to process.cwd().
+     *  serveCommand sets this to the provisioned workspace so the session is coached. */
+    cwd?: string;
     /** When true, accept connections without spawning a pty — used by tests + dry-run handshake checks. */
     dryRun?: boolean;
 }

package/dist/commands/serve.js

@@ -1,6 +1,7 @@
 import { WebSocketServer } from 'ws';
 import { createRequire } from 'node:module';
 import { readCredentials } from '../lib/credentials.js';
+import { ensureWorkspace } from './install.js';
 import { c } from '../lib/colors.js';
 const DEFAULT_ALLOWED_ORIGINS = [
     'https://app.paris-group.com',
@@ -62,7 +63,7 @@ export async function startServeServer(opts) {
                 name: 'xterm-color',
                 cols: 80,
                 rows: 24,
-                cwd: process.cwd(),
+                cwd: opts.cwd ?? process.cwd(),
                 env: {
                     ...process.env,
                     TOSTUDY_MCP_ENABLED: '1',
@@ -156,9 +157,25 @@ export async function serveCommand(opts) {
         process.exit(1);
     }
     const allowedOrigins = (process.env.PARIS_SERVE_ORIGINS?.split(',').map((s) => s.trim()).filter(Boolean)) ?? DEFAULT_ALLOWED_ORIGINS;
+    // Guarantee the embedded `claude` opens inside a provisioned (coached)
+    // workspace. If the student already ran `paris install`, we reuse it; else we
+    // bootstrap one now so the onboarding terminal is never vanilla Claude. A
+    // failure here is non-fatal — we fall back to cwd so the terminal still works.
+    let cwd = process.cwd();
+    try {
+        const { dir, created } = await ensureWorkspace({});
+        cwd = dir;
+        console.log(created
+            ? `  ${c.green('✓')} workspace criado em ${c.bold(dir)}`
+            : `  ${c.dim('workspace:')} ${dir}`);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(c.yellow(`  ! sem workspace coachado (${msg}). Abrindo Claude em ${cwd}.`));
+    }
     let handle;
     try {
-        handle = await startServeServer({ port: portNum, allowedOrigins, token });
+        handle = await startServeServer({ port: portNum, allowedOrigins, token, cwd });
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);

package/package.json

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