@aethrekh/pi-cs 0.1.0

package/extensions/progress-tracker.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * progress-tracker.ts
+ *
+ * Extension: Progress Tracker
+ * Triggers: on_session_end
+ *
+ * Tracks weekly activity across skills and sessions.
+ * Surfaces burnout prevention nudges and weekly summaries.
+ */
+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.getBurnoutNudge = getBurnoutNudge;
+exports.buildWeeklySummary = buildWeeklySummary;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+// ─── Storage ───────────────────────────────────────────────────────────────
+const TRACKER_DIR = path.join(os.homedir(), ".pi-cs");
+const SESSIONS_FILE = path.join(TRACKER_DIR, "sessions.json");
+function ensureTrackerDir() {
+    if (!fs.existsSync(TRACKER_DIR)) {
+        fs.mkdirSync(TRACKER_DIR, { recursive: true });
+    }
+}
+function loadSessions() {
+    try {
+        if (!fs.existsSync(SESSIONS_FILE))
+            return [];
+        const raw = fs.readFileSync(SESSIONS_FILE, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+function saveSessions(sessions) {
+    try {
+        ensureTrackerDir();
+        // Keep only last 90 days of sessions
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - 90);
+        const recent = sessions.filter((s) => new Date(s.date) > cutoff);
+        fs.writeFileSync(SESSIONS_FILE, JSON.stringify(recent, null, 2));
+    }
+    catch {
+        // Fail silently — tracker is a nice-to-have, not critical
+    }
+}
+// ─── Stats ─────────────────────────────────────────────────────────────────
+function getWeeklyStats(sessions) {
+    const oneWeekAgo = new Date();
+    oneWeekAgo.setDate(oneWeekAgo.getDate() - 7);
+    const weekSessions = sessions.filter((s) => new Date(s.date) > oneWeekAgo);
+    const skillBreakdown = {};
+    let totalMinutes = 0;
+    let longestSession = 0;
+    for (const session of weekSessions) {
+        totalMinutes += session.durationMinutes;
+        longestSession = Math.max(longestSession, session.durationMinutes);
+        for (const skill of session.skillsUsed) {
+            skillBreakdown[skill] = (skillBreakdown[skill] ?? 0) + 1;
+        }
+    }
+    // Calculate streak
+    let streak = 0;
+    const sessionDays = new Set(sessions.map((s) => new Date(s.date).toDateString()));
+    const checkDate = new Date();
+    while (sessionDays.has(checkDate.toDateString())) {
+        streak++;
+        checkDate.setDate(checkDate.getDate() - 1);
+    }
+    return {
+        totalMinutes,
+        sessionCount: weekSessions.length,
+        skillBreakdown,
+        longestSession,
+        streak,
+    };
+}
+// ─── Nudges ─────────────────────────────────────────────────────────────────
+function getBurnoutNudge(sessionDurationMinutes, stats) {
+    // Long single session
+    if (sessionDurationMinutes >= 180) {
+        return "🐠 You've been coding for 3+ hours. Seriously — take a 15-minute break. Your brain consolidates learning during rest, not during grinding.";
+    }
+    // Very heavy week
+    if (stats.totalMinutes > 40 * 60) {
+        return "📊 You've put in 40+ hours of study this week. That's impressive, but rest is part of learning. Don't skip sleep before your exam.";
+    }
+    // Long streak — positive reinforcement
+    if (stats.streak >= 7) {
+        return `🔥 ${stats.streak}-day streak! Consistent daily practice beats marathon sessions. Keep this up.`;
+    }
+    return null;
+}
+// ─── Weekly Summary ────────────────────────────────────────────────────────
+function buildWeeklySummary(stats) {
+    if (stats.sessionCount === 0) {
+        return "📅 No activity recorded this week. When you're ready to start, just ask!";
+    }
+    const hours = Math.floor(stats.totalMinutes / 60);
+    const minutes = stats.totalMinutes % 60;
+    const timeStr = hours > 0 ? `${hours}h ${minutes}m` : `${minutes}m`;
+    const topSkills = Object.entries(stats.skillBreakdown)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 3)
+        .map(([skill, count]) => `  - /${skill}: ${count} session${count > 1 ? "s" : ""}`)
+        .join("\n");
+    return [
+        `📊 **This Week's Summary**`,
+        ``,
+        `⏱  Total study time: **${timeStr}**`,
+        `📅 Sessions: **${stats.sessionCount}**`,
+        `🔥 Current streak: **${stats.streak} day${stats.streak !== 1 ? "s" : ""}**`,
+        topSkills ? `\n🛠  Most used skills:\n${topSkills}` : "",
+        ``,
+        stats.totalMinutes < 5 * 60
+            ? `💡 Tip: Even 30 minutes a day compounds significantly over a semester.`
+            : `✅ Solid week. Keep the consistency going.`,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+// ─── Pi Extension Entry Point ──────────────────────────────────────────────
+function run(context) {
+    const sessions = loadSessions();
+    // Record this session
+    const record = {
+        date: new Date().toISOString(),
+        durationMinutes: context.sessionDurationMinutes,
+        skillsUsed: context.skillsUsed,
+        topicsWorked: context.topicsWorked ?? [],
+    };
+    sessions.push(record);
+    saveSessions(sessions);
+    const stats = getWeeklyStats(sessions);
+    const nudge = getBurnoutNudge(context.sessionDurationMinutes, stats);
+    const weeklySummary = buildWeeklySummary(stats);
+    return { nudge, weeklySummary };
+}
+//# sourceMappingURL=progress-tracker.js.map

package/extensions/progress-tracker.js.map

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

package/extensions/semester-detector.d.ts

@@ -0,0 +1,53 @@
+/**
+ * semester-detector.ts
+ *
+ * Extension: Semester Detector
+ * Triggers: on_startup, on_directory_change
+ *
+ * Searches for SEMESTER.md in the working directory and standard university
+ * folder locations, then injects the semester context into the Pi session.
+ */
+export interface Course {
+    code: string;
+    name: string;
+    assignments?: Assignment[];
+}
+export interface Assignment {
+    name: string;
+    due: string;
+    submitted?: boolean;
+}
+export interface SemesterContext {
+    semester: string;
+    year: number;
+    week?: number;
+    year_of_study?: number;
+    courses: Course[];
+    active_project?: string;
+    notes?: string;
+}
+export interface DetectionResult {
+    found: boolean;
+    source?: string;
+    context?: SemesterContext;
+    error?: string;
+}
+/**
+ * Main detection function. Searches candidate paths for SEMESTER.md
+ * and returns the parsed context if found.
+ */
+export declare function detectSemesterContext(): DetectionResult;
+/**
+ * Generates a contextual greeting based on the detected semester context.
+ * Injected into the Pi session at startup.
+ */
+export declare function generateGreeting(result: DetectionResult): string;
+/**
+ * Called by Pi on_startup and on_directory_change.
+ * Returns the context injection for the active session.
+ */
+export declare function run(): {
+    inject: string;
+    greeting: string;
+};
+//# sourceMappingURL=semester-detector.d.ts.map

package/extensions/semester-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semester-detector.d.ts","sourceRoot":"","sources":["../../src/extensions/semester-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAsBvD;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAiChE;AAID;;;GAGG;AACH,wBAAgB,GAAG,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAuB1D"}

package/extensions/semester-detector.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * semester-detector.ts
+ *
+ * Extension: Semester Detector
+ * Triggers: on_startup, on_directory_change
+ *
+ * Searches for SEMESTER.md in the working directory and standard university
+ * folder locations, then injects the semester context into the Pi session.
+ */
+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.detectSemesterContext = detectSemesterContext;
+exports.generateGreeting = generateGreeting;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+// ─── Search Paths ──────────────────────────────────────────────────────────
+function getSearchPaths() {
+    return [
+        process.cwd(),
+        path.join(os.homedir(), "university"),
+        path.join(os.homedir(), "uni"),
+        path.join(os.homedir(), "college"),
+        path.join(os.homedir(), "school"),
+        path.join(os.homedir(), "Documents", "university"),
+        path.join(os.homedir(), "Documents", "uni"),
+    ];
+}
+const SEMESTER_FILE = "SEMESTER.md";
+// ─── Parser ────────────────────────────────────────────────────────────────
+/**
+ * Parses a SEMESTER.md file into a SemesterContext object.
+ * Format is lenient — extracts what it can, leaves the rest as notes.
+ */
+function parseSemesterMd(content) {
+    const lines = content.split("\n");
+    const context = {
+        semester: "Unknown",
+        year: new Date().getFullYear(),
+        courses: [],
+    };
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // semester: Fall 2025
+        const semMatch = trimmed.match(/^semester[:\s]+(.+)/i);
+        if (semMatch)
+            context.semester = semMatch[1].trim();
+        // year: 2025
+        const yearMatch = trimmed.match(/^year[:\s]+(\d{4})/i);
+        if (yearMatch)
+            context.year = parseInt(yearMatch[1]);
+        // week: 7
+        const weekMatch = trimmed.match(/^week[:\s]+(\d+)/i);
+        if (weekMatch)
+            context.week = parseInt(weekMatch[1]);
+        // year_of_study: 2
+        const studyYearMatch = trimmed.match(/^year.of.study[:\s]+(\d)/i);
+        if (studyYearMatch)
+            context.year_of_study = parseInt(studyYearMatch[1]);
+        // - CS301: Operating Systems
+        const courseMatch = trimmed.match(/^[-*]\s+([A-Z]{2,4}\d{2,4})[:\s]+(.+)/);
+        if (courseMatch) {
+            context.courses.push({
+                code: courseMatch[1],
+                name: courseMatch[2].trim(),
+            });
+        }
+        // active_project: my-compiler
+        const projectMatch = trimmed.match(/^active.project[:\s]+(.+)/i);
+        if (projectMatch)
+            context.active_project = projectMatch[1].trim();
+    }
+    return context;
+}
+// ─── Detector ──────────────────────────────────────────────────────────────
+/**
+ * Main detection function. Searches candidate paths for SEMESTER.md
+ * and returns the parsed context if found.
+ */
+function detectSemesterContext() {
+    for (const searchPath of getSearchPaths()) {
+        const candidate = path.join(searchPath, SEMESTER_FILE);
+        try {
+            if (fs.existsSync(candidate)) {
+                const content = fs.readFileSync(candidate, "utf-8");
+                const context = parseSemesterMd(content);
+                return {
+                    found: true,
+                    source: candidate,
+                    context,
+                };
+            }
+        }
+        catch (err) {
+            // Permission errors or broken symlinks — skip silently
+            continue;
+        }
+    }
+    return { found: false };
+}
+// ─── Greeting Generator ────────────────────────────────────────────────────
+/**
+ * Generates a contextual greeting based on the detected semester context.
+ * Injected into the Pi session at startup.
+ */
+function generateGreeting(result) {
+    if (!result.found || !result.context) {
+        return [
+            "👋 Hey! I'm **Pisces**, your CS co-pilot.",
+            "",
+            "I don't see a `SEMESTER.md` in your workspace yet. Want to set one up so I can stay context-aware of your courses and deadlines?",
+            "",
+            "Run `/semester-init` to get started, or just tell me what you're working on!",
+        ].join("\n");
+    }
+    const ctx = result.context;
+    const weekStr = ctx.week ? ` (Week ${ctx.week})` : "";
+    const courseList = ctx.courses.length > 0
+        ? ctx.courses.map((c) => `  - ${c.code}: ${c.name}`).join("\n")
+        : "  - (no courses listed)";
+    const projectLine = ctx.active_project
+        ? `\n🔧 Active project: **${ctx.active_project}**`
+        : "";
+    return [
+        `👋 Hey! I'm **Pisces** — loaded up for **${ctx.semester} ${ctx.year}**${weekStr}.`,
+        "",
+        `📚 Your courses:`,
+        courseList,
+        projectLine,
+        "",
+        "What are we tackling today? `/homework`, `/project`, `/review`, `/explain`, `/leetcode`, `/exam`, or `/research`",
+    ]
+        .filter((l) => l !== undefined)
+        .join("\n");
+}
+// ─── Pi Extension Entry Point ──────────────────────────────────────────────
+/**
+ * Called by Pi on_startup and on_directory_change.
+ * Returns the context injection for the active session.
+ */
+function run() {
+    const result = detectSemesterContext();
+    let inject = "";
+    if (result.found && result.context) {
+        inject = [
+            "<!-- SEMESTER CONTEXT (auto-loaded from SEMESTER.md) -->",
+            `<!-- Semester: ${result.context.semester} ${result.context.year} -->`,
+            `<!-- Week: ${result.context.week ?? "unknown"} -->`,
+            `<!-- Year of study: ${result.context.year_of_study ?? "unknown"} -->`,
+            `<!-- Courses: ${result.context.courses.map((c) => c.code).join(", ")} -->`,
+            result.context.active_project
+                ? `<!-- Active project: ${result.context.active_project} -->`
+                : "",
+        ]
+            .filter(Boolean)
+            .join("\n");
+    }
+    return {
+        inject,
+        greeting: generateGreeting(result),
+    };
+}
+//# sourceMappingURL=semester-detector.js.map

package/extensions/semester-detector.js.map

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

package/index.d.ts

@@ -0,0 +1,146 @@
+/**
+ * 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
+ */
+import { SemesterContext } from "./extensions/semester-detector";
+import { FolderDetectionResult } from "./extensions/folder-detector";
+export interface PiCsConfig {
+    student?: {
+        name?: string;
+        year_of_study?: number;
+        primary_language?: string;
+        timezone?: string;
+    };
+    explanations?: {
+        default_depth?: "beginner" | "intermediate" | "advanced";
+        prefer_visuals?: boolean;
+        use_analogies?: boolean;
+    };
+    code?: {
+        style?: "verbose" | "balanced" | "concise";
+        always_include_complexity?: boolean;
+        always_include_tests?: boolean;
+    };
+    integrity?: {
+        enabled?: boolean;
+        strictness?: "strict" | "balanced" | "relaxed";
+    };
+    productivity?: {
+        burnout_nudges?: boolean;
+        session_warning_minutes?: number;
+        weekly_summary?: boolean;
+    };
+    model?: {
+        default?: string;
+        code_heavy?: string;
+        quick?: string;
+    };
+}
+export interface SessionState {
+    startTime: Date;
+    skillsUsed: string[];
+    topicsWorked: string[];
+    semesterContext: SemesterContext | null;
+    folderContext: FolderDetectionResult | null;
+    warningIssuedAt: number | null;
+}
+export interface SkillCallContext {
+    skillName: string;
+    userInput: string;
+    sessionState: SessionState;
+}
+export interface StartupResult {
+    contextInjection: string;
+    greeting: string;
+    config: PiCsConfig;
+}
+export interface SkillCallResult {
+    proceed: boolean;
+    injection: string;
+}
+export interface SessionEndResult {
+    nudge: string | null;
+    summary: string | null;
+}
+export declare const PACKAGE_NAME = "pi-cs";
+export declare const PACKAGE_VERSION = "0.1.0";
+export declare const SKILLS: readonly ["homework", "project", "review", "explain", "leetcode", "exam", "research"];
+export type SkillName = (typeof SKILLS)[number];
+/**
+ * Loads and merges user config over package defaults.
+ * Never throws — falls back to defaults on any read/parse error.
+ */
+export declare function loadConfig(): PiCsConfig;
+/**
+ * Creates a fresh session state object. Called by Pi at session start.
+ */
+export declare function createSessionState(): SessionState;
+/**
+ * onLoad — called once when Pi installs or loads the package.
+ * Validates the environment and logs the package is ready.
+ */
+export declare function onLoad(): {
+    ok: boolean;
+    message: string;
+};
+/**
+ * onStartup — called at the start of every Pi session.
+ * Runs semester + folder detectors, builds greeting and context injection.
+ */
+export declare function onStartup(state: SessionState): StartupResult;
+/**
+ * onDirectoryChange — called when the user `cd`s to a new directory.
+ * Re-runs context detectors so Pi stays accurate.
+ */
+export declare function onDirectoryChange(state: SessionState): {
+    contextInjection: string;
+    message: string | null;
+};
+/**
+ * onSkillCall — called just before Pi executes a skill.
+ * Runs the integrity guard and records the skill in session state.
+ */
+export declare function onSkillCall(context: SkillCallContext): SkillCallResult;
+/**
+ * onSessionEnd — called when the Pi session closes.
+ * Records session stats, surfaces a burnout nudge and weekly summary if configured.
+ */
+export declare function onSessionEnd(state: SessionState): SessionEndResult;
+/**
+ * onMidSession — called periodically by Pi (e.g. every 30 min).
+ * Issues a burnout warning if the session has exceeded the configured threshold.
+ */
+export declare function onMidSession(state: SessionState): {
+    warning: string | null;
+};
+/**
+ * Returns the active semester context for the current session.
+ * Useful for extensions or templates that need course/week info.
+ */
+export declare function getActiveSemesterContext(state: SessionState): SemesterContext | null;
+/**
+ * Returns the active project context for the current session.
+ */
+export declare function getActiveProjectContext(state: SessionState): FolderDetectionResult["project"] | null;
+/**
+ * Checks if a given skill name is valid (registered in this package).
+ */
+export declare function isValidSkill(name: string): name is SkillName;
+/**
+ * Returns a short summary of what pi-cs provides, for display in Pi's
+ * package listing or help output.
+ */
+export declare function describe(): string;
+//# sourceMappingURL=index.d.ts.map