@pugi/cli 0.1.0-alpha.17 → 0.1.0-alpha.19

package/dist/tui/repl-render.js

@@ -24,6 +24,7 @@ import { ReplSession, } from '../core/repl/session.js';
 import { resolveWorkspaceContext } from '../core/repl/workspace-context.js';
 import { SqliteSessionStore } from '../core/repl/store/index.js';
 import { slugForCwd } from '../core/repl/history.js';
+import { WorkingSet, buildRepoSkeleton, loadPugiIgnore, PugiWatcher, } from '../core/context/index.js';
 /**
  * Mount the REPL and resolve when the user exits via Ctrl+C × 2 or
  * `/quit`. The session is closed (server-side stays alive; resume via
@@ -48,6 +49,14 @@ export async function renderRepl(options) {
         workspaceRoot: process.cwd(),
         resumeLocalSessionId: options.resumeLocalSessionId,
     });
+    // α6.5 three-tier context bootstrap. The skeleton + working set
+    // + watcher are local-first and best-effort: every step is wrapped
+    // in try/catch so an unreadable workspace never blocks REPL launch.
+    // Opt-out via PUGI_DISABLE_CONTEXT=1 for hermetic test runs.
+    const { skeleton, workingSet, watcher } = await bootstrapContext({
+        cwd: process.cwd(),
+        env: process.env,
+    });
     const session = new ReplSession({
         apiUrl: options.apiUrl,
         apiKey: options.apiKey,
@@ -57,6 +66,9 @@ export async function renderRepl(options) {
         workspace,
         store,
         localSessionId: openedSessionId,
+        repoSkeleton: skeleton,
+        workingSet,
+        watcher,
     });
     // Restore the transcript from the JSONL log if we resumed an
     // existing session. The restore is idempotent and bypasses persist
@@ -103,6 +115,14 @@ export async function renderRepl(options) {
                 /* idempotent — already closed */
             }
         }
+        if (watcher) {
+            try {
+                await watcher.close();
+            }
+            catch {
+                /* idempotent — chokidar may already be torn down */
+            }
+        }
     }
 }
 /**
@@ -141,6 +161,58 @@ async function openLocalStore(input) {
         return { store: null, openedSessionId: undefined };
     }
 }
+/**
+ * Bootstrap the α6.5 three-tier context primitives:
+ *
+ *   - Tier 0: `RepoSkeleton` (~5KB ASCII tree + meta) for prompt injection.
+ *   - Tier 1: `WorkingSet` LRU bounded at 50 entries.
+ *   - Filewatch: chokidar started against cwd, ignore-filtered.
+ *
+ * The bootstrap is fail-safe: every primitive is wrapped so the REPL
+ * still launches when (e.g.) chokidar refuses to start on a
+ * permission-blocked dir. The PUGI_DISABLE_CONTEXT=1 env var skips
+ * the bootstrap entirely for hermetic test runs and for operators
+ * who want a zero-touch REPL.
+ */
+async function bootstrapContext(input) {
+    if (input.env.PUGI_DISABLE_CONTEXT === '1') {
+        return { skeleton: null, workingSet: null, watcher: null };
+    }
+    let ignore;
+    try {
+        ignore = loadPugiIgnore(input.cwd);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`[pugi] Three-tier context bootstrap skipped (ignore matcher failed: ${msg}).\n`);
+        return { skeleton: null, workingSet: null, watcher: null };
+    }
+    let skeleton = null;
+    try {
+        skeleton = buildRepoSkeleton(input.cwd, { ignore });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`[pugi] Repo skeleton bootstrap failed (${msg}). Continuing without Tier 0.\n`);
+    }
+    const workingSet = new WorkingSet();
+    let watcher = null;
+    // chokidar opt-out: PUGI_DISABLE_FILEWATCH=1 keeps Tier 0/1 wired
+    // but skips the live-update channel. Useful on CI runners and on
+    // network mounts where fsevents misbehaves.
+    if (input.env.PUGI_DISABLE_FILEWATCH !== '1') {
+        try {
+            const w = new PugiWatcher({ cwd: input.cwd, ignore });
+            await w.start();
+            watcher = w;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`[pugi] Filewatch bootstrap failed (${msg}). Continuing without live updates.\n`);
+        }
+    }
+    return { skeleton, workingSet, watcher };
+}
 /* ------------------------------------------------------------------ */
 /* Production transport                                               */
 /* ------------------------------------------------------------------ */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pugi/cli",
-  "version": "0.1.0-alpha.17",
-  "description": "Pugi CLI — terminal-native software execution system",
+  "version": "0.1.0-alpha.19",
+  "description": "Pugi CLI - terminal-native software execution system",
   "homepage": "https://pugi.io",
   "repository": {
     "type": "git",
@@ -35,11 +35,14 @@
   "engines": {
     "node": ">=22.5.0"
   },
+  "//publishConfig": "CEO sign-off 2026-05-23 alpha launch: @pugi/cli is the customer-facing CLI and ships PUBLIC so `npm i -g @pugi/cli` resolves anonymously. The HARD default-restricted memory rule (2026-05-25) applies to INTERNAL @pugi/* packages (db-client, telegram bot helpers, etc.) - those must ship access:restricted unless an additional CEO sign-off granted. @pugi/sdk + @pugi/personas were published public alongside the CLI under the same alpha-launch sign-off because the CLI's customer install pulls them as transitive deps; review before α7 GA.",
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
     "@mozilla/readability": "^0.6.0",
+    "chokidar": "^3.6.0",
+    "ignore": "^5.3.2",
     "ink": "^5.0.1",
     "linkedom": "^0.18.12",
     "react": "^18.3.1",
@@ -49,7 +52,7 @@
     "undici": "^8.3.0",
     "zod": "^3.23.0",
     "@pugi/personas": "0.1.1",
-    "@pugi/sdk": "0.1.0-alpha.17"
+    "@pugi/sdk": "0.1.0-alpha.19"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",