epam-ai-conductor 0.1.0

package/dist/context-builder.js

@@ -0,0 +1,116 @@
+import { writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { loadModule } from './content-loader.js';
+export const MODULE_TITLES = {
+    1: 'React Components & Project Structure',
+    2: 'Routing, Forms & Custom Hooks',
+    3: 'Redux State Management',
+    4: 'Async Redux & Private Routes',
+    5: 'Testing with React Testing Library',
+};
+export function buildContext(moduleNum, targetDir) {
+    const { theory, task, tests } = loadModule(moduleNum);
+    const title = MODULE_TITLES[moduleNum] ?? `Module ${moduleNum}`;
+    // CLAUDE.md: persona + rules only (~2k chars), heavy content in @-imported files
+    const claudeMd = `# React Course — Module ${moduleNum}: ${title}
+
+You are a Socratic mentor for a React fundamentals course.
+The student is working on Module ${moduleNum} in their local project.
+
+## Working Directory
+
+You are running inside the student's React project at: \`${targetDir}\`
+The student's source code lives in the \`src/\` subdirectory of this folder.
+The project is a pre-configured React template — the student already has it set up locally.
+Always use the Read tool to inspect the student's actual files — do not assume what they have written.
+When referencing files, use paths relative to \`${targetDir}\` (e.g. \`src/components/Header.tsx\`).
+
+## Mentor Rules — follow these strictly
+
+- NEVER write working component code for the student.
+- NEVER paste or quote from the test files.
+- NEVER reveal expected test output directly.
+- When the student is stuck: ask a targeted question — "What should this component return when the list is empty?"
+- When code is wrong: point to the specific file/line and ask "What does this return right now?"
+- When something is missing: ask "Which criterion from the task do you think isn't covered yet?"
+- After the student writes or updates code: silently validate it against the task criteria and test expectations, then ask if they feel it's complete.
+- Use the Read tool freely to look at the student's actual src/ files before commenting.
+- NEVER ask the student to run terminal commands (find, ls, cat, etc.) to show you their files — you already have the Read tool and you know where the project is.
+- NEVER ask the student to show you file contents, paste code, or tell you what's in a file — read it yourself with the Read tool.
+- Keep responses concise — one point at a time.
+
+## On module completion
+
+When ALL criteria for Module ${moduleNum} are met (you verified with Read tool), congratulate the student and say exactly:
+
+"🎉 Module ${moduleNum} complete! To start Module ${moduleNum + 1}, run this in your terminal:
+\`react-workshop start --module ${moduleNum + 1}\`
+This will load the new module context. See you there!"
+
+Then do not continue the conversation — the session for this module is done.
+
+## On session start
+
+Greet the student warmly. Ask whether they have already read the task or if they'd like a quick overview.
+Then ask: "Where would you like to start?"
+
+Do NOT dump all criteria at once. Guide step by step.
+
+---
+
+@.claude/module-theory.md
+@.claude/module-task.md
+@.claude/module-tests.md
+`;
+    const theoryMd = `## MODULE ${moduleNum} THEORY\n\n${theory}`;
+    const taskMd = `## MODULE ${moduleNum} TASK & CRITERIA\n\n${task}`;
+    const testsMd = `## TEST EXPECTATIONS — MENTOR EYES ONLY
+
+> These are the automated tests that will validate the student's submission on AutoCode.
+> Use this section as your private knowledge to guide the student accurately.
+> NEVER quote, paraphrase, or reveal the test source code to the student.
+> You may say things like "The tests check that this component renders X" without showing the test.
+
+${tests}`;
+    const hintCmd = `Read the student's current src/ directory with the Read tool.
+Based on what you see and the task requirements, give ONE specific hint.
+The hint must be a guiding question or direction — never a code snippet or direct answer.
+
+Good hint: "Your CourseCard receives duration in minutes — how would you display that as hours and minutes?"
+Bad hint: "Use Math.floor(duration / 60) to get the hours."
+
+After the hint, ask: "Does that point you in the right direction?"`;
+    const checkCmd = `Read all files in src/ with the Read tool.
+Compare the student's implementation against each task criterion one by one.
+
+For each criterion output one line:
+  ✓ <criterion> — done
+  ✗ <criterion> — missing
+  ⚠ <criterion> — partially done, then explain what's missing in one sentence
+
+For items marked ✗ or ⚠: ask the student what they think is needed — do not explain directly.
+End with a summary: "X of Y criteria complete."
+
+If ALL criteria are ✓, say:
+"🎉 Module ${moduleNum} complete! To start Module ${moduleNum + 1}, run this in your terminal:
+\`react-workshop start --module ${moduleNum + 1}\`
+This will load the new module context. See you there!"`;
+    const stepCmd = `Read src/ with the Read tool.
+Based on the task criteria and what the student has already implemented, identify the single most logical next step.
+
+Present it as a question:
+"It looks like Header is done. What component would you work on next according to the project architecture?"
+
+Do not list multiple steps — one at a time only.`;
+    const claudeDir = join(targetDir, '.claude');
+    const commandsDir = join(claudeDir, 'commands');
+    mkdirSync(commandsDir, { recursive: true });
+    writeFileSync(join(claudeDir, 'CLAUDE.md'), claudeMd, 'utf-8');
+    writeFileSync(join(claudeDir, 'module-theory.md'), theoryMd, 'utf-8');
+    writeFileSync(join(claudeDir, 'module-task.md'), taskMd, 'utf-8');
+    writeFileSync(join(claudeDir, 'module-tests.md'), testsMd, 'utf-8');
+    writeFileSync(join(commandsDir, 'hint.md'), hintCmd, 'utf-8');
+    writeFileSync(join(commandsDir, 'check.md'), checkCmd, 'utf-8');
+    writeFileSync(join(commandsDir, 'step.md'), stepCmd, 'utf-8');
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../src/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,CAAC,EAAE,sCAAsC;IACzC,CAAC,EAAE,+BAA+B;IAClC,CAAC,EAAE,wBAAwB;IAC3B,CAAC,EAAE,8BAA8B;IACjC,CAAC,EAAE,oCAAoC;CACxC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,SAAiB;IAC/D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,UAAU,SAAS,EAAE,CAAC;IAEhE,iFAAiF;IACjF,MAAM,QAAQ,GAAG,2BAA2B,SAAS,KAAK,KAAK;;;mCAG9B,SAAS;;;;2DAIe,SAAS;;;;kDAIlB,SAAS;;;;;;;;;;;;;;;;;;+BAkB5B,SAAS;;aAE3B,SAAS,8BAA8B,SAAS,GAAG,CAAC;kCAC/B,SAAS,GAAG,CAAC;;;;;;;;;;;;;;;;;CAiB9C,CAAC;IAEA,MAAM,QAAQ,GAAG,aAAa,SAAS,cAAc,MAAM,EAAE,CAAC;IAE9D,MAAM,MAAM,GAAG,aAAa,SAAS,uBAAuB,IAAI,EAAE,CAAC;IAEnE,MAAM,OAAO,GAAG;;;;;;;EAOhB,KAAK,EAAE,CAAC;IAER,MAAM,OAAO,GAAG;;;;;;;mEAOiD,CAAC;IAElE,MAAM,QAAQ,GAAG;;;;;;;;;;;;aAYN,SAAS,8BAA8B,SAAS,GAAG,CAAC;kCAC/B,SAAS,GAAG,CAAC;uDACQ,CAAC;IAEtD,MAAM,OAAO,GAAG;;;;;;iDAM+B,CAAC;IAEhD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChD,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/D,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtE,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpE,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9D,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChE,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "epam-ai-conductor",
+  "version": "0.1.0",
+  "description": "React course workshop mentor — guided learning via codemie-claude",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "bin": {
+    "ai-conductor": "./bin/workshop.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && cp -r src/content dist/content",
+    "dev": "tsc --watch",
+    "start": "node bin/workshop.js",
+    "prepublishOnly": "npm run build",
+    "sync-content": "npx tsx scripts/sync-content.ts",
+    "debug": "npx tsx scripts/debug.ts",
+    "lint": "eslint src --ext .ts",
+    "postinstall": "chmod +x node_modules/node-pty/prebuilds/darwin-arm64/spawn-helper 2>/dev/null || true"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "inquirer": "^9.2.12",
+    "node-pty": "^1.1.0",
+    "ora": "^7.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}