@aethrekh/pi-cs 0.1.0

package/index.js

@@ -0,0 +1,381 @@
+"use strict";
+/**
+ * src/index.ts
+ *
+ * pi-cs (Pisces) — Package Entry Point
+ *
+ * This is the single file Pi loads when the package is activated.
+ * It wires together all extensions, registers lifecycle hooks, loads
+ * user config, and exposes the public API surface the Pi runtime calls.
+ *
+ * Lifecycle order:
+ *   1. onLoad()        — package installed / Pi starts, config resolved
+ *   2. onStartup()     — new session begins, context injected
+ *   3. onDirectoryChange() — cwd changed mid-session
+ *   4. onSkillCall()   — user invokes a /skill command
+ *   5. onSessionEnd()  — session closes, progress recorded
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILLS = exports.PACKAGE_VERSION = exports.PACKAGE_NAME = void 0;
+exports.loadConfig = loadConfig;
+exports.createSessionState = createSessionState;
+exports.onLoad = onLoad;
+exports.onStartup = onStartup;
+exports.onDirectoryChange = onDirectoryChange;
+exports.onSkillCall = onSkillCall;
+exports.onSessionEnd = onSessionEnd;
+exports.onMidSession = onMidSession;
+exports.getActiveSemesterContext = getActiveSemesterContext;
+exports.getActiveProjectContext = getActiveProjectContext;
+exports.isValidSkill = isValidSkill;
+exports.describe = describe;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+// ─── Extension Imports ─────────────────────────────────────────────────────
+const semester_detector_1 = require("./extensions/semester-detector");
+const folder_detector_1 = require("./extensions/folder-detector");
+const integrity_guard_1 = require("./extensions/integrity-guard");
+const progress_tracker_1 = require("./extensions/progress-tracker");
+// ─── Package Metadata ──────────────────────────────────────────────────────
+exports.PACKAGE_NAME = "pi-cs";
+exports.PACKAGE_VERSION = "0.1.0";
+exports.SKILLS = [
+    "homework",
+    "project",
+    "review",
+    "explain",
+    "leetcode",
+    "exam",
+    "research",
+];
+// ─── Config Loader ─────────────────────────────────────────────────────────
+const DEFAULTS_PATH = path.join(__dirname, "../config/defaults.json");
+function getConfigSearchPaths() {
+    return [
+        path.join(process.cwd(), ".pi-cs.json"),
+        path.join(os.homedir(), ".pi", "pi-cs.json"),
+        path.join(os.homedir(), ".config", "pi-cs", "config.json"),
+    ];
+}
+/**
+ * Loads and merges user config over package defaults.
+ * Never throws — falls back to defaults on any read/parse error.
+ */
+function loadConfig() {
+    let defaults = {};
+    try {
+        const raw = fs.readFileSync(DEFAULTS_PATH, "utf-8");
+        defaults = JSON.parse(raw);
+    }
+    catch {
+        // Defaults file unreadable — use hardcoded fallback
+        defaults = {
+            explanations: { default_depth: "intermediate", prefer_visuals: true, use_analogies: true },
+            code: { style: "balanced", always_include_complexity: true, always_include_tests: false },
+            integrity: { enabled: true, strictness: "balanced" },
+            productivity: { burnout_nudges: true, session_warning_minutes: 180, weekly_summary: true },
+        };
+    }
+    // Search for user config file — use first one found
+    for (const configPath of getConfigSearchPaths()) {
+        try {
+            if (fs.existsSync(configPath)) {
+                const raw = fs.readFileSync(configPath, "utf-8");
+                const userConfig = JSON.parse(raw);
+                return deepMerge(defaults, userConfig);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return defaults;
+}
+/**
+ * Deep merges two config objects. User values override defaults at every level.
+ */
+function deepMerge(base, override) {
+    const result = { ...base };
+    for (const key of Object.keys(override)) {
+        const baseVal = base[key];
+        const overrideVal = override[key];
+        if (overrideVal !== null &&
+            typeof overrideVal === "object" &&
+            !Array.isArray(overrideVal) &&
+            typeof baseVal === "object" &&
+            baseVal !== null) {
+            result[key] = deepMerge(baseVal, overrideVal);
+        }
+        else if (overrideVal !== undefined) {
+            result[key] = overrideVal;
+        }
+    }
+    return result;
+}
+// ─── Session State ─────────────────────────────────────────────────────────
+/**
+ * Creates a fresh session state object. Called by Pi at session start.
+ */
+function createSessionState() {
+    return {
+        startTime: new Date(),
+        skillsUsed: [],
+        topicsWorked: [],
+        semesterContext: null,
+        folderContext: null,
+        warningIssuedAt: null,
+    };
+}
+// ─── Lifecycle Hooks ────────────────────────────────────────────────────────
+/**
+ * onLoad — called once when Pi installs or loads the package.
+ * Validates the environment and logs the package is ready.
+ */
+function onLoad() {
+    const nodeVersion = process.version;
+    const major = parseInt(nodeVersion.slice(1).split(".")[0], 10);
+    if (major < 18) {
+        return {
+            ok: false,
+            message: `pi-cs requires Node.js >= 18. Current: ${nodeVersion}. Please upgrade.`,
+        };
+    }
+    const config = loadConfig();
+    const configSource = getConfigSearchPaths().find((p) => {
+        try {
+            return fs.existsSync(p);
+        }
+        catch {
+            return false;
+        }
+    }) ?? "defaults";
+    return {
+        ok: true,
+        message: `pi-cs ${exports.PACKAGE_VERSION} loaded. Config: ${configSource}. Integrity guard: ${config.integrity?.enabled !== false ? "on" : "off"}.`,
+    };
+}
+/**
+ * onStartup — called at the start of every Pi session.
+ * Runs semester + folder detectors, builds greeting and context injection.
+ */
+function onStartup(state) {
+    const config = loadConfig();
+    // Run semester detector
+    const semesterResult = (0, semester_detector_1.run)();
+    if (semesterResult) {
+        // Extract context if found (greeting contains it serialised in comment blocks)
+        const detection = (0, semester_detector_1.detectSemesterContext)();
+        state.semesterContext = detection.context ?? null;
+    }
+    // Run folder detector
+    const folderResult = (0, folder_detector_1.run)();
+    state.folderContext = (0, folder_detector_1.detectFolderContext)();
+    // Build the combined context injection block
+    const contextParts = [];
+    if (semesterResult.inject) {
+        contextParts.push(semesterResult.inject);
+    }
+    if (folderResult.inject) {
+        contextParts.push(folderResult.inject);
+    }
+    // Inject config-derived hints
+    contextParts.push(buildConfigInjection(config));
+    return {
+        contextInjection: contextParts.filter(Boolean).join("\n\n"),
+        greeting: semesterResult.greeting,
+        config,
+    };
+}
+/**
+ * onDirectoryChange — called when the user `cd`s to a new directory.
+ * Re-runs context detectors so Pi stays accurate.
+ */
+function onDirectoryChange(state) {
+    const semesterResult = (0, semester_detector_1.run)();
+    const folderResult = (0, folder_detector_1.run)();
+    const newFolderContext = (0, folder_detector_1.detectFolderContext)();
+    const previousProject = state.folderContext?.project?.name;
+    const newProject = newFolderContext?.project?.name;
+    // Update session state
+    state.folderContext = newFolderContext;
+    if ((0, semester_detector_1.detectSemesterContext)().context) {
+        state.semesterContext = (0, semester_detector_1.detectSemesterContext)().context ?? null;
+    }
+    const contextParts = [semesterResult.inject, folderResult.inject].filter(Boolean);
+    // Notify if we've moved into a different project
+    const message = newProject && newProject !== previousProject
+        ? `📂 Switched to project: **${newProject}** (${newFolderContext.project?.type ?? "unknown"})`
+        : null;
+    return {
+        contextInjection: contextParts.join("\n\n"),
+        message,
+    };
+}
+/**
+ * onSkillCall — called just before Pi executes a skill.
+ * Runs the integrity guard and records the skill in session state.
+ */
+function onSkillCall(context) {
+    const { skillName, userInput, sessionState } = context;
+    const config = loadConfig();
+    // Record skill usage
+    if (!sessionState.skillsUsed.includes(skillName)) {
+        sessionState.skillsUsed.push(skillName);
+    }
+    // Skip integrity check if disabled in config
+    if (config.integrity?.enabled === false) {
+        return { proceed: true, injection: "" };
+    }
+    const guardResult = (0, integrity_guard_1.run)({ skillName, userInput });
+    return {
+        proceed: true, // never hard-block — always redirect gracefully
+        injection: guardResult.inject,
+    };
+}
+/**
+ * onSessionEnd — called when the Pi session closes.
+ * Records session stats, surfaces a burnout nudge and weekly summary if configured.
+ */
+function onSessionEnd(state) {
+    const config = loadConfig();
+    const durationMinutes = Math.round((Date.now() - state.startTime.getTime()) / 60000);
+    const trackerResult = (0, progress_tracker_1.run)({
+        sessionDurationMinutes: durationMinutes,
+        skillsUsed: state.skillsUsed,
+        topicsWorked: state.topicsWorked,
+    });
+    return {
+        nudge: config.productivity?.burnout_nudges !== false ? trackerResult.nudge : null,
+        summary: config.productivity?.weekly_summary !== false ? trackerResult.weeklySummary : null,
+    };
+}
+/**
+ * onMidSession — called periodically by Pi (e.g. every 30 min).
+ * Issues a burnout warning if the session has exceeded the configured threshold.
+ */
+function onMidSession(state) {
+    const config = loadConfig();
+    const warnAt = config.productivity?.session_warning_minutes ?? 180;
+    if (!config.productivity?.burnout_nudges)
+        return { warning: null };
+    const elapsedMinutes = Math.round((Date.now() - state.startTime.getTime()) / 60000);
+    // Only issue the warning once per session
+    if (elapsedMinutes >= warnAt && state.warningIssuedAt === null) {
+        state.warningIssuedAt = elapsedMinutes;
+        return {
+            warning: `🐠 You've been at this for ${elapsedMinutes} minutes. Time for a short break — your brain will thank you.`,
+        };
+    }
+    return { warning: null };
+}
+// ─── Context Injection Helpers ─────────────────────────────────────────────
+/**
+ * Builds a config-derived injection block that nudges Pi's behavior
+ * based on the user's preferences without overriding the system prompt.
+ */
+function buildConfigInjection(config) {
+    const hints = [];
+    if (config.student?.name) {
+        hints.push(`Student name: ${config.student.name}`);
+    }
+    if (config.student?.year_of_study) {
+        const yearLabels = {
+            1: "Freshman (1st year)",
+            2: "Sophomore (2nd year)",
+            3: "Junior (3rd year)",
+            4: "Senior (4th year)",
+            5: "Graduate (1st year)",
+            6: "Graduate (2nd year+)",
+        };
+        hints.push(`Year of study: ${yearLabels[config.student.year_of_study] ?? config.student.year_of_study}`);
+    }
+    if (config.student?.primary_language) {
+        hints.push(`Primary language: ${config.student.primary_language}`);
+    }
+    if (config.explanations?.default_depth) {
+        hints.push(`Explanation depth preference: ${config.explanations.default_depth}`);
+    }
+    if (config.code?.always_include_complexity) {
+        hints.push("Always annotate algorithm time/space complexity");
+    }
+    if (config.code?.always_include_tests) {
+        hints.push("Always suggest test cases alongside code");
+    }
+    if (!hints.length)
+        return "";
+    return [
+        "<!-- USER CONFIG PREFERENCES -->",
+        ...hints.map((h) => `<!-- ${h} -->`),
+    ].join("\n");
+}
+// ─── Public Utility API ────────────────────────────────────────────────────
+/**
+ * Returns the active semester context for the current session.
+ * Useful for extensions or templates that need course/week info.
+ */
+function getActiveSemesterContext(state) {
+    return state.semesterContext;
+}
+/**
+ * Returns the active project context for the current session.
+ */
+function getActiveProjectContext(state) {
+    return state.folderContext?.project ?? null;
+}
+/**
+ * Checks if a given skill name is valid (registered in this package).
+ */
+function isValidSkill(name) {
+    return exports.SKILLS.includes(name);
+}
+/**
+ * Returns a short summary of what pi-cs provides, for display in Pi's
+ * package listing or help output.
+ */
+function describe() {
+    return [
+        `🐠 pi-cs (Pisces) v${exports.PACKAGE_VERSION}`,
+        `   The CS Student Edition for Pi Coding Agent`,
+        ``,
+        `   Skills:     /${exports.SKILLS.join(", /")}`,
+        `   Extensions: semester-detector, folder-detector, integrity-guard, progress-tracker`,
+        `   Config:     ~/.pi/pi-cs.json`,
+        ``,
+        `   Run any skill with /<name>, e.g. /homework or /explain binary search`,
+    ].join("\n");
+}
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@aethrekh/pi-cs",
+  "version": "0.1.0",
+  "description": "Pisces — The CS Student Edition for Pi Coding Agent. Your personal AI teaching assistant from homework to thesis.",
+  "keywords": [
+    "academic",
+    "computer-science",
+    "teaching-assistant",
+    "coding-agent",
+    "cs-student",
+    "homework",
+    "pi",
+    "pi-package"
+  ],
+  "author": "Ashish Bagdane <ashishbagdane1@gmail.com>",
+  "license": "MIT",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AshishBagdane/pi-cs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AshishBagdane/pi-cs/issues"
+  },
+  "homepage": "https://github.com/AshishBagdane/pi-cs#readme",
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}

package/pi-cs.meta.json

@@ -0,0 +1,7 @@
+{
+  "name": "pi-cs",
+  "version": "0.1.0",
+  "built_at": "2026-06-02T04:46:16.850Z",
+  "entry": "index.js",
+  "node_minimum": "18.0.0"
+}

package/pi-package.yaml

@@ -0,0 +1,76 @@
+name: pi-cs
+version: 0.1.0
+display_name: "pi-cs (Pisces)"
+description: "The CS Student Edition for Pi — Your personal AI teaching assistant for Computer Science, from homework to thesis."
+author: ""
+license: MIT
+pi_version: ">=1.0.0"
+
+# Core system prompt that defines the academic persona
+system: system.md
+
+# Skills (slash commands) registered by this package
+skills:
+  - name: homework
+    path: skills/homework/SKILL.md
+    description: "Break down problems, provide guided hints, and walk through step-by-step implementation"
+  - name: project
+    path: skills/project/SKILL.md
+    description: "Full project kickoff: requirements → architecture → tech stack → scaffolding"
+  - name: review
+    path: skills/review/SKILL.md
+    description: "Strict TA-level code review covering style, efficiency, edge cases, and security"
+  - name: explain
+    path: skills/explain/SKILL.md
+    description: "Concept explanations with analogies, Mermaid diagrams, and connections to prior knowledge"
+  - name: leetcode
+    path: skills/leetcode/SKILL.md
+    description: "Problem parsing, optimized solutions with time/space complexity analysis"
+  - name: exam
+    path: skills/exam/SKILL.md
+    description: "Practice questions, mind maps, and revision plans for upcoming exams"
+  - name: research
+    path: skills/research/SKILL.md
+    description: "Paper summarization, arXiv search, and literature review assistance"
+
+# Extensions that run automatically in the background
+extensions:
+  - name: semester-detector
+    path: extensions/semester-detector.js
+    description: "Auto-detects semester context from SEMESTER.md and folder structures"
+    triggers:
+      - on_startup
+      - on_directory_change
+  - name: folder-detector
+    path: extensions/folder-detector.js
+    description: "Detects standard CS university folder structures and sets project context"
+    triggers:
+      - on_startup
+      - on_directory_change
+  - name: integrity-guard
+    path: extensions/integrity-guard.js
+    description: "Monitors for academic integrity violations and adds appropriate warnings"
+    triggers:
+      - on_skill_call
+  - name: progress-tracker
+    path: extensions/progress-tracker.js
+    description: "Tracks weekly activity and surfaces burnout prevention nudges"
+    triggers:
+      - on_session_end
+
+# Templates available for scaffolding
+templates:
+  - name: semester-init
+    path: templates/semester-init.md
+    description: "Initialize a new semester workspace with SEMESTER.md and folder structure"
+  - name: project-init
+    path: templates/project-init.md
+    description: "Bootstrap a new CS project with README, structure, and CI"
+  - name: research-paper
+    path: templates/research-paper.md
+    description: "Academic research paper structure and writing guide"
+
+# User-level config schema
+config:
+  schema: config/schema.json
+  defaults: config/defaults.json