@aethrekh/pi-cs 0.1.9 → 0.1.10-alpha.1

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.1.10-alpha.1](https://github.com/AshishBagdane/pi-cs/compare/v0.1.10-alpha.0...v0.1.10-alpha.1) (2026-06-05)
+
+### ### Fixed
+
+* self-heal stale APPEND_SYSTEM.md on session_start ([c0c5027](https://github.com/AshishBagdane/pi-cs/commit/c0c50279d8682a5e8d15e6789ffdbc229ab5cfeb))
+
+## [0.1.10-alpha.0](https://github.com/AshishBagdane/pi-cs/compare/v0.1.9...v0.1.10-alpha.0) (2026-06-05)
+
+### ### Fixed
+
+* scope persona injection to active sessions, remove global APPEND_SYSTEM.md write ([eb86028](https://github.com/AshishBagdane/pi-cs/commit/eb86028a14c2f34eb982da127e0806e1a7bad219))
+
+### ### Changed
+
+* fix and expand CLAUDE.md with accurate architecture details ([fc7d4d8](https://github.com/AshishBagdane/pi-cs/commit/fc7d4d8c382b1bea1286de2f6dc8be59f5bcf74b))
+
 ## [0.1.9](https://github.com/AshishBagdane/pi-cs/compare/v0.1.8...v0.1.9) (2026-06-04)
 
 ### Fixed

package/README.md

@@ -29,14 +29,12 @@ It covers every dimension of a CS degree:
 ## Quick Start
 
 ```bash
-# Install pi-cs
-pi install npm:@aethrekh/pi-cs
-
-# Navigate to your university folder
-cd ~/university/fall2025
+# Install Pisces in your university workspace (recommended)
+cd ~/university
+pi install npm:@aethrekh/pi-cs -l
 
 # Initialize your semester context
-/semester
+/semester --init
 
 # Start working
 /homework
@@ -44,6 +42,8 @@ cd ~/university/fall2025
 /leetcode 42
 ```
 
+> **Global install:** `pi install npm:@aethrekh/pi-cs` (without `-l`) activates Pisces in every Pi session, including non-university projects. Use this only if you want Pisces everywhere.
+
 ---
 
 ## Semester Context
@@ -193,7 +193,7 @@ See [`config/schema.json`](config/schema.json) for the full configuration refere
 
 ## Installation
 
-**Requirements:** Pi >= 1.0.0, Node.js >= 18
+**Requirements:** Pi >= 0.78.0, Node.js >= 18
 
 ```bash
 pi install npm:@aethrekh/pi-cs

package/extensions/semester-detector.js

@@ -182,11 +182,10 @@ function semesterContextBlock(ctx) {
         .filter(Boolean)
         .join("\n");
 }
-// ─── Persona ───────────────────────────────────────────────────────────────
-const APPEND_SYSTEM_PATH = path.join(os.homedir(), ".pi", "agent", "APPEND_SYSTEM.md");
+// ─── Persona Loader ────────────────────────────────────────────────────────
 function loadPersona() {
     const candidates = [
-        path.resolve(__dirname, "../SYSTEM.md"), // compiled: extensions/ → package root
+        path.resolve(__dirname, "../SYSTEM.md"), // compiled: dist/extensions/ → dist/
         path.resolve(__dirname, "../../SYSTEM.md"), // dev ts-node: src/extensions/ → project root
         path.resolve(__dirname, "../../../SYSTEM.md"),
     ];
@@ -202,31 +201,31 @@ function loadPersona() {
     }
     return "";
 }
-const PERSONA = loadPersona();
-function ensurePersonaInstalled() {
-    if (!PERSONA)
-        return "noop";
+// ─── Stale Global File Cleanup ─────────────────────────────────────────────
+const LEGACY_APPEND_PATH = path.join(os.homedir(), ".pi", "agent", "APPEND_SYSTEM.md");
+function removeLegacyGlobalPersona(persona) {
+    if (!persona)
+        return false;
     try {
-        const existing = fs.existsSync(APPEND_SYSTEM_PATH)
-            ? fs.readFileSync(APPEND_SYSTEM_PATH, "utf-8").trim()
-            : "";
-        if (existing === PERSONA)
-            return "noop";
-        fs.mkdirSync(path.dirname(APPEND_SYSTEM_PATH), { recursive: true });
-        fs.writeFileSync(APPEND_SYSTEM_PATH, PERSONA, "utf-8");
-        return existing === "" ? "installed" : "updated";
+        if (!fs.existsSync(LEGACY_APPEND_PATH))
+            return false;
+        const existing = fs.readFileSync(LEGACY_APPEND_PATH, "utf-8").trim();
+        if (existing !== persona)
+            return false;
+        fs.unlinkSync(LEGACY_APPEND_PATH);
+        return true;
     }
     catch {
-        return "noop";
+        return false;
     }
 }
 // ─── Pi Extension Factory ──────────────────────────────────────────────────
 function default_1(pi) {
+    const persona = loadPersona();
     let semesterCtx = null;
     pi.on("session_start", async (_event, ctx) => {
-        const personaStatus = ensurePersonaInstalled();
-        if (personaStatus === "installed" || personaStatus === "updated") {
-            ctx.ui.notify(`🐠 Pisces persona ${personaStatus} — restart Pi for it to take effect.`, "info");
+        if (removeLegacyGlobalPersona(persona)) {
+            ctx.ui.notify("🐠 Pisces: cleaned up a stale ~/.pi/agent/APPEND_SYSTEM.md from an older install. Persona is now session-scoped.", "info");
         }
         const result = detectSemesterContext();
         if (result.found && result.context) {
@@ -239,9 +238,14 @@ function default_1(pi) {
         }
     });
     pi.on("before_agent_start", async (event) => {
-        if (!semesterCtx)
+        const parts = [];
+        if (persona)
+            parts.push(persona);
+        if (semesterCtx)
+            parts.push(semesterContextBlock(semesterCtx));
+        if (parts.length === 0)
             return;
-        return { systemPrompt: `${event.systemPrompt}\n\n${semesterContextBlock(semesterCtx)}` };
+        return { systemPrompt: [event.systemPrompt, ...parts].join("\n\n") };
     });
 }
 // ─── Pi Extension Entry Point ──────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aethrekh/pi-cs",
-  "version": "0.1.9",
+  "version": "0.1.10-alpha.1",
   "description": "Pisces — The CS Student Edition for Pi Coding Agent. Your personal AI teaching assistant from homework to thesis.",
   "keywords": [
     "academic",

package/pi-cs.meta.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-cs",
-  "version": "0.1.9",
-  "built_at": "2026-06-04T17:05:59.017Z",
+  "version": "0.1.10-alpha.1",
+  "built_at": "2026-06-05T10:16:13.700Z",
   "entry": "index.js",
   "node_minimum": "18.0.0"
 }

package/pi-package.yaml

@@ -1,5 +1,5 @@
 name: pi-cs
-version: 0.1.9-alpha.0
+version: 0.1.10-alpha.1
 display_name: "pi-cs (Pisces)"
 description: "The CS Student Edition for Pi — Your personal AI teaching assistant for Computer Science, from homework to thesis."
 icon: public/pisces-logo-512.png

package/postinstall.d.ts

@@ -2,8 +2,8 @@
  * postinstall.ts
  *
  * Runs automatically after `pi install npm:@aethrekh/pi-cs`.
- * Writes SYSTEM.md to ~/.pi/agent/APPEND_SYSTEM.md so the Pisces persona
- * is active from the very first Pi session — no restart required.
+ * Persona injection is handled at runtime via the before_agent_start hook
+ * in semester-detector.ts, scoped to sessions where pi-cs is active.
+ * No global APPEND_SYSTEM.md write is performed.
  */
-export {};
 //# sourceMappingURL=postinstall.d.ts.map

package/postinstall.js

@@ -3,64 +3,8 @@
  * postinstall.ts
  *
  * Runs automatically after `pi install npm:@aethrekh/pi-cs`.
- * Writes SYSTEM.md to ~/.pi/agent/APPEND_SYSTEM.md so the Pisces persona
- * is active from the very first Pi session — no restart required.
+ * Persona injection is handled at runtime via the before_agent_start hook
+ * in semester-detector.ts, scoped to sessions where pi-cs is active.
+ * No global APPEND_SYSTEM.md write is performed.
  */
-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 });
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const systemMdPath = path.join(__dirname, "SYSTEM.md");
-const appendPath = path.join(os.homedir(), ".pi", "agent", "APPEND_SYSTEM.md");
-try {
-    if (!fs.existsSync(systemMdPath))
-        process.exit(0);
-    const content = fs.readFileSync(systemMdPath, "utf-8").trim();
-    if (!content)
-        process.exit(0);
-    fs.mkdirSync(path.dirname(appendPath), { recursive: true });
-    const existing = fs.existsSync(appendPath)
-        ? fs.readFileSync(appendPath, "utf-8").trim()
-        : "";
-    if (existing !== content) {
-        fs.writeFileSync(appendPath, content, "utf-8");
-        console.log("🐠 Pisces persona installed → ~/.pi/agent/APPEND_SYSTEM.md");
-    }
-}
-catch {
-    // Never fail install
-}
 //# sourceMappingURL=postinstall.js.map

package/postinstall.js.map

@@ -1 +1 @@
-{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AAEzB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACvD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAE/E,IAAI,CAAC;IACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE9B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QACxC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE;QAC7C,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAAC,MAAM,CAAC;IACP,qBAAqB;AACvB,CAAC"}
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}