@iflow-mcp/jkheadley-instar 0.26.2

package/dist/core/UpdateGate.d.ts

@@ -0,0 +1,102 @@
+/**
+ * UpdateGate — Session-aware restart gating.
+ *
+ * Checks whether it's safe to restart the server for an update.
+ * Only 'healthy' (actively producing output) sessions block restarts.
+ * 'unresponsive', 'idle', and 'dead' sessions don't — blocking an update
+ * for a broken session serves no user interest.
+ *
+ * Healthy sessions are NEVER killed for an update. The gate defers indefinitely
+ * while healthy sessions exist, sending warnings at the configured thresholds.
+ */
+export interface SessionInfo {
+    name: string;
+    topicId?: number;
+}
+export interface SessionHealthEntry {
+    topicId: number;
+    sessionName: string;
+    status: string;
+    idleMinutes: number;
+}
+export interface GateResult {
+    allowed: boolean;
+    reason?: string;
+    retryInMs?: number;
+    /** Sessions that are actively blocking the restart */
+    blockingSessions?: string[];
+    /** Sessions that are unresponsive (warned but not blocking) */
+    unresponsiveSessions?: string[];
+}
+export interface UpdateGateConfig {
+    /** Maximum hours to defer a restart for active sessions. Default: 4 */
+    maxDeferralHours?: number;
+    /** Minutes before forced restart to send first warning. Default: 30 */
+    firstWarningMinutes?: number;
+    /** Minutes before forced restart to send final warning. Default: 5 */
+    finalWarningMinutes?: number;
+    /** How often to re-check sessions during deferral, in ms. Default: 5 * 60_000 (5 min) */
+    retryIntervalMs?: number;
+}
+export interface UpdateGateStatus {
+    /** Whether a restart is currently being deferred */
+    deferring: boolean;
+    /** When deferral started */
+    deferralStartedAt: string | null;
+    /** How long we've been deferring, in minutes */
+    deferralElapsedMinutes: number;
+    /** Max deferral before forced restart */
+    maxDeferralHours: number;
+    /** Reason for current deferral */
+    deferralReason: string | null;
+    /** Whether the first warning (T-30min) has been sent */
+    firstWarningSent: boolean;
+    /** Whether the final warning (T-5min) has been sent */
+    finalWarningSent: boolean;
+}
+/** Minimal interface for SessionManager — only what we need */
+export interface SessionManagerLike {
+    listRunningSessions(): SessionInfo[];
+}
+/** Minimal interface for SessionMonitor — only what we need */
+export interface SessionMonitorLike {
+    getStatus(): {
+        sessionHealth: SessionHealthEntry[];
+    };
+}
+export declare class UpdateGate {
+    private config;
+    private deferralStartedAt;
+    private deferralReason;
+    private firstWarningSent;
+    private firstWarningPending;
+    private finalWarningSent;
+    private finalWarningPending;
+    constructor(config?: UpdateGateConfig);
+    /**
+     * Check if it's safe to restart now.
+     *
+     * Returns { allowed: true } if restart can proceed.
+     * Returns { allowed: false, retryInMs, reason } if sessions are blocking.
+     */
+    canRestart(sessionManager: SessionManagerLike, sessionMonitor?: SessionMonitorLike | null): GateResult;
+    /**
+     * Get current gate status for observability.
+     */
+    getStatus(): UpdateGateStatus;
+    /**
+     * Whether the first warning (T-30min before forced restart) should fire.
+     * Returns true exactly once — consumes the flag on read.
+     */
+    shouldSendFirstWarning(): boolean;
+    /**
+     * Whether the final warning (T-5min before forced restart) should fire.
+     * Returns true exactly once — consumes the flag on read.
+     */
+    shouldSendFinalWarning(): boolean;
+    /**
+     * Reset deferral state (called after restart proceeds or update is cancelled).
+     */
+    reset(): void;
+}
+//# sourceMappingURL=UpdateGate.d.ts.map

package/dist/core/UpdateGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateGate.d.ts","sourceRoot":"","sources":["../../src/core/UpdateGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,+DAA+D;IAC/D,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gDAAgD;IAChD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,wDAAwD;IACxD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,IAAI,WAAW,EAAE,CAAC;CACtC;AAED,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,SAAS,IAAI;QACX,aAAa,EAAE,kBAAkB,EAAE,CAAC;KACrC,CAAC;CACH;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,mBAAmB,CAAS;gBAExB,MAAM,CAAC,EAAE,gBAAgB;IASrC;;;;;OAKG;IACH,UAAU,CACR,cAAc,EAAE,kBAAkB,EAClC,cAAc,CAAC,EAAE,kBAAkB,GAAG,IAAI,GACzC,UAAU;IA8Eb;;OAEG;IACH,SAAS,IAAI,gBAAgB;IAa7B;;;OAGG;IACH,sBAAsB,IAAI,OAAO;IAQjC;;;OAGG;IACH,sBAAsB,IAAI,OAAO;IAQjC;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}

package/dist/core/UpdateGate.js

@@ -0,0 +1,149 @@
+/**
+ * UpdateGate — Session-aware restart gating.
+ *
+ * Checks whether it's safe to restart the server for an update.
+ * Only 'healthy' (actively producing output) sessions block restarts.
+ * 'unresponsive', 'idle', and 'dead' sessions don't — blocking an update
+ * for a broken session serves no user interest.
+ *
+ * Healthy sessions are NEVER killed for an update. The gate defers indefinitely
+ * while healthy sessions exist, sending warnings at the configured thresholds.
+ */
+export class UpdateGate {
+    config;
+    deferralStartedAt = null;
+    deferralReason = null;
+    firstWarningSent = false;
+    firstWarningPending = false;
+    finalWarningSent = false;
+    finalWarningPending = false;
+    constructor(config) {
+        this.config = {
+            maxDeferralHours: config?.maxDeferralHours ?? 4,
+            firstWarningMinutes: config?.firstWarningMinutes ?? 30,
+            finalWarningMinutes: config?.finalWarningMinutes ?? 5,
+            retryIntervalMs: config?.retryIntervalMs ?? 5 * 60_000,
+        };
+    }
+    /**
+     * Check if it's safe to restart now.
+     *
+     * Returns { allowed: true } if restart can proceed.
+     * Returns { allowed: false, retryInMs, reason } if sessions are blocking.
+     */
+    canRestart(sessionManager, sessionMonitor) {
+        const sessions = sessionManager.listRunningSessions();
+        // No sessions → restart immediately
+        if (sessions.length === 0) {
+            this.reset();
+            return { allowed: true };
+        }
+        // Check session health if monitor is available
+        const health = sessionMonitor?.getStatus().sessionHealth ?? [];
+        const healthMap = new Map(health.map(h => [h.sessionName, h]));
+        const activeSessions = [];
+        const unresponsiveSessions = [];
+        for (const session of sessions) {
+            const h = healthMap.get(session.name);
+            if (!h) {
+                // No health data — be conservative, treat as active
+                activeSessions.push(session.name);
+            }
+            else if (h.status === 'healthy') {
+                activeSessions.push(session.name);
+            }
+            else if (h.status === 'unresponsive') {
+                unresponsiveSessions.push(session.name);
+            }
+            // 'idle' and 'dead' sessions don't block
+        }
+        // No active sessions → restart (idle/dead/unresponsive don't block)
+        if (activeSessions.length === 0) {
+            this.reset();
+            return {
+                allowed: true,
+                unresponsiveSessions: unresponsiveSessions.length > 0 ? unresponsiveSessions : undefined,
+            };
+        }
+        // Active sessions exist — start or continue deferral
+        if (!this.deferralStartedAt) {
+            this.deferralStartedAt = Date.now();
+        }
+        const elapsedMs = Date.now() - this.deferralStartedAt;
+        const maxDeferralMs = this.config.maxDeferralHours * 60 * 60_000;
+        const remainingMs = maxDeferralMs - elapsedMs;
+        this.deferralReason = `${activeSessions.length} active session(s): ${activeSessions.join(', ')}`;
+        // Max deferral exceeded — but only force restart if no HEALTHY sessions.
+        // Active, healthy sessions should NEVER be killed for an update.
+        // The update can wait — the user's work cannot.
+        if (remainingMs <= 0) {
+            console.log(`[UpdateGate] Max deferral (${this.config.maxDeferralHours}h) exceeded, but ${activeSessions.length} healthy session(s) still running — continuing to defer`);
+        }
+        // Check warning thresholds
+        const remainingMinutes = remainingMs / 60_000;
+        if (remainingMinutes <= this.config.finalWarningMinutes && !this.finalWarningSent) {
+            this.finalWarningSent = true;
+            this.finalWarningPending = true;
+        }
+        if (remainingMinutes <= this.config.firstWarningMinutes && !this.firstWarningSent) {
+            this.firstWarningSent = true;
+            this.firstWarningPending = true;
+        }
+        return {
+            allowed: false,
+            reason: this.deferralReason,
+            retryInMs: this.config.retryIntervalMs,
+            blockingSessions: activeSessions,
+            unresponsiveSessions: unresponsiveSessions.length > 0 ? unresponsiveSessions : undefined,
+        };
+    }
+    /**
+     * Get current gate status for observability.
+     */
+    getStatus() {
+        const elapsedMs = this.deferralStartedAt ? Date.now() - this.deferralStartedAt : 0;
+        return {
+            deferring: this.deferralStartedAt !== null,
+            deferralStartedAt: this.deferralStartedAt ? new Date(this.deferralStartedAt).toISOString() : null,
+            deferralElapsedMinutes: Math.round(elapsedMs / 60_000),
+            maxDeferralHours: this.config.maxDeferralHours,
+            deferralReason: this.deferralReason,
+            firstWarningSent: this.firstWarningSent,
+            finalWarningSent: this.finalWarningSent,
+        };
+    }
+    /**
+     * Whether the first warning (T-30min before forced restart) should fire.
+     * Returns true exactly once — consumes the flag on read.
+     */
+    shouldSendFirstWarning() {
+        if (this.firstWarningPending) {
+            this.firstWarningPending = false;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Whether the final warning (T-5min before forced restart) should fire.
+     * Returns true exactly once — consumes the flag on read.
+     */
+    shouldSendFinalWarning() {
+        if (this.finalWarningPending) {
+            this.finalWarningPending = false;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Reset deferral state (called after restart proceeds or update is cancelled).
+     */
+    reset() {
+        this.deferralStartedAt = null;
+        this.deferralReason = null;
+        this.firstWarningSent = false;
+        this.firstWarningPending = false;
+        this.finalWarningSent = false;
+        this.finalWarningPending = false;
+    }
+}
+//# sourceMappingURL=UpdateGate.js.map

package/dist/core/UpdateGate.js.map

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

package/dist/core/UpgradeGuideProcessor.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Upgrade Guide Processor — the "intelligence" layer of knowledge upgrades.
+ *
+ * PostUpdateMigrator handles mechanical patches (hooks, scripts, CLAUDE.md sections).
+ * UpgradeGuideProcessor delivers higher-level guidance that each agent processes
+ * intelligently based on its own evolved context.
+ *
+ * Each Instar version can ship with an upgrade guide (markdown file in upgrades/).
+ * These guides contain:
+ *   - What changed and why
+ *   - Suggested actions the agent should take
+ *   - Configuration hints
+ *   - Behavioral guidance
+ *
+ * The agent reads the guide and decides how to integrate it — because every agent
+ * is different, evolving separately, and best-positioned to know how new capabilities
+ * fit into its own situation.
+ *
+ * Flow:
+ *   1. `instar migrate` runs (from NEW binary after npm update)
+ *   2. PostUpdateMigrator patches files mechanically
+ *   3. UpgradeGuideProcessor finds unprocessed guides
+ *   4. Writes pending guide to `.instar/state/pending-upgrade-guide.md`
+ *   5. Session-start hook detects the file and injects it into agent context
+ *   6. Agent reads, processes, and acts on the guidance
+ *   7. Next `instar migrate` marks previous guides as processed
+ *
+ * Born from Justin's vision: "It's literally guidance. Each agent is different,
+ * evolving separately — they are best-informed and most knowledgeable on how
+ * to ingest these upgrades and apply to their own situation."
+ */
+export interface UpgradeGuideResult {
+    /** Guides that were found and are pending processing by the agent */
+    pendingGuides: string[];
+    /** Guides already processed by the agent */
+    alreadyProcessed: string[];
+    /** The combined guide content for the agent to read (empty if none pending) */
+    guideContent: string;
+    /** Path where the pending guide was written (for session-start hook) */
+    pendingGuidePath: string | null;
+}
+export interface UpgradeGuideConfig {
+    /** The .instar state directory */
+    stateDir: string;
+    /** Current installed version (to determine which guides are new) */
+    currentVersion: string;
+    /** Version the agent upgraded FROM — only guides newer than this are delivered.
+     *  If omitted, falls back to processed-upgrades.json state (legacy behavior). */
+    previousVersion?: string;
+}
+export declare class UpgradeGuideProcessor {
+    private stateDir;
+    private currentVersion;
+    private previousVersion;
+    private processedFile;
+    private pendingGuidePath;
+    constructor(config: UpgradeGuideConfig);
+    /**
+     * Find and deliver any unprocessed upgrade guides.
+     *
+     * Scans the `upgrades/` directory bundled with the instar package,
+     * compares against the processed state, and writes any new guides
+     * to a pending file for the agent to read.
+     */
+    process(): UpgradeGuideResult;
+    /**
+     * Check if there's a pending upgrade guide waiting for the agent.
+     * Used by the session-start hook.
+     */
+    hasPendingGuide(): boolean;
+    /**
+     * Get the pending guide content (for session-start hook injection).
+     */
+    getPendingGuide(): string | null;
+    /**
+     * Clear the pending guide (called after the agent has processed it).
+     */
+    clearPendingGuide(): void;
+    /**
+     * Find the upgrades/ directory bundled with the instar package.
+     * Resolves relative to this module's location on disk.
+     */
+    private findUpgradesDir;
+    /**
+     * Get all available upgrade guides, sorted by version.
+     */
+    private getAvailableGuides;
+    /**
+     * Get the list of versions whose guides have already been processed.
+     */
+    private getProcessedVersions;
+    /**
+     * Mark versions as processed (their guides have been delivered to the agent).
+     */
+    private markProcessed;
+    /**
+     * Remove the pending guide file.
+     */
+    private cleanPendingGuide;
+    /**
+     * Compare two semver strings. Returns negative if a < b, positive if a > b, 0 if equal.
+     */
+    private compareSemver;
+}
+//# sourceMappingURL=UpgradeGuideProcessor.d.ts.map

package/dist/core/UpgradeGuideProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpgradeGuideProcessor.d.ts","sourceRoot":"","sources":["../../src/core/UpgradeGuideProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB;qFACiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE,kBAAkB;IAQtC;;;;;;OAMG;IACH,OAAO,IAAI,kBAAkB;IA+F7B;;;OAGG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;IAUhC;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,aAAa;CAStB"}

package/dist/core/UpgradeGuideProcessor.js

@@ -0,0 +1,278 @@
+/**
+ * Upgrade Guide Processor — the "intelligence" layer of knowledge upgrades.
+ *
+ * PostUpdateMigrator handles mechanical patches (hooks, scripts, CLAUDE.md sections).
+ * UpgradeGuideProcessor delivers higher-level guidance that each agent processes
+ * intelligently based on its own evolved context.
+ *
+ * Each Instar version can ship with an upgrade guide (markdown file in upgrades/).
+ * These guides contain:
+ *   - What changed and why
+ *   - Suggested actions the agent should take
+ *   - Configuration hints
+ *   - Behavioral guidance
+ *
+ * The agent reads the guide and decides how to integrate it — because every agent
+ * is different, evolving separately, and best-positioned to know how new capabilities
+ * fit into its own situation.
+ *
+ * Flow:
+ *   1. `instar migrate` runs (from NEW binary after npm update)
+ *   2. PostUpdateMigrator patches files mechanically
+ *   3. UpgradeGuideProcessor finds unprocessed guides
+ *   4. Writes pending guide to `.instar/state/pending-upgrade-guide.md`
+ *   5. Session-start hook detects the file and injects it into agent context
+ *   6. Agent reads, processes, and acts on the guidance
+ *   7. Next `instar migrate` marks previous guides as processed
+ *
+ * Born from Justin's vision: "It's literally guidance. Each agent is different,
+ * evolving separately — they are best-informed and most knowledgeable on how
+ * to ingest these upgrades and apply to their own situation."
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export class UpgradeGuideProcessor {
+    stateDir;
+    currentVersion;
+    previousVersion;
+    processedFile;
+    pendingGuidePath;
+    constructor(config) {
+        this.stateDir = config.stateDir;
+        this.currentVersion = config.currentVersion;
+        this.previousVersion = config.previousVersion ?? null;
+        this.processedFile = path.join(config.stateDir, 'state', 'processed-upgrades.json');
+        this.pendingGuidePath = path.join(config.stateDir, 'state', 'pending-upgrade-guide.md');
+    }
+    /**
+     * Find and deliver any unprocessed upgrade guides.
+     *
+     * Scans the `upgrades/` directory bundled with the instar package,
+     * compares against the processed state, and writes any new guides
+     * to a pending file for the agent to read.
+     */
+    process() {
+        const result = {
+            pendingGuides: [],
+            alreadyProcessed: [],
+            guideContent: '',
+            pendingGuidePath: null,
+        };
+        // Find the upgrades directory relative to this module
+        const upgradesDir = this.findUpgradesDir();
+        if (!upgradesDir) {
+            return result;
+        }
+        // Read available guides
+        let availableGuides = this.getAvailableGuides(upgradesDir);
+        if (availableGuides.length === 0) {
+            return result;
+        }
+        // Filter by previousVersion — only deliver guides for versions the agent
+        // hasn't seen yet. Without this, agents that update across multiple versions
+        // (or whose processed-upgrades.json was lost) get ALL historical guides
+        // concatenated, producing repetitive/confusing announcements.
+        if (this.previousVersion) {
+            const prevVer = this.previousVersion;
+            availableGuides = availableGuides.filter(g => this.compareSemver(g.version, prevVer) > 0);
+            if (availableGuides.length === 0) {
+                return result;
+            }
+        }
+        // Read processed state
+        const processed = this.getProcessedVersions();
+        // Find unprocessed guides (among version-filtered set)
+        const pending = [];
+        for (const guide of availableGuides) {
+            if (processed.includes(guide.version)) {
+                result.alreadyProcessed.push(guide.version);
+            }
+            else {
+                pending.push(guide);
+                result.pendingGuides.push(guide.version);
+            }
+        }
+        if (pending.length === 0) {
+            // All guides already delivered — don't touch the pending file.
+            // It may still be waiting for the agent to read and acknowledge it.
+            // Only `clearPendingGuide()` (via `instar upgrade-ack`) should remove it.
+            return result;
+        }
+        // Concatenate pending guides in version order
+        const sections = [];
+        for (const guide of pending) {
+            try {
+                const content = fs.readFileSync(guide.filePath, 'utf-8');
+                sections.push(content);
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+        if (sections.length === 0) {
+            return result;
+        }
+        // Build the combined guide
+        const header = `# Instar Upgrade Guide\n\n` +
+            `> You have ${pending.length} upgrade guide${pending.length > 1 ? 's' : ''} to process.\n` +
+            `> Read through each section and take the suggested actions based on YOUR context.\n` +
+            `> **IMPORTANT**: All commands in these guides are for YOU (the agent) to execute directly.\n` +
+            `> Never relay commands to the user for them to run manually. You have full shell access.\n` +
+            `> After processing, these guides won't appear again.\n\n` +
+            `---\n\n`;
+        result.guideContent = header + sections.join('\n\n---\n\n');
+        // Write to pending file
+        try {
+            const dir = path.dirname(this.pendingGuidePath);
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(this.pendingGuidePath, result.guideContent);
+            result.pendingGuidePath = this.pendingGuidePath;
+        }
+        catch {
+            // Non-fatal — guide content is still in the result
+        }
+        // Mark these guides as processed (they've been delivered)
+        this.markProcessed(pending.map(g => g.version));
+        return result;
+    }
+    /**
+     * Check if there's a pending upgrade guide waiting for the agent.
+     * Used by the session-start hook.
+     */
+    hasPendingGuide() {
+        return fs.existsSync(this.pendingGuidePath);
+    }
+    /**
+     * Get the pending guide content (for session-start hook injection).
+     */
+    getPendingGuide() {
+        if (!fs.existsSync(this.pendingGuidePath))
+            return null;
+        try {
+            return fs.readFileSync(this.pendingGuidePath, 'utf-8');
+        }
+        catch {
+            // @silent-fallback-ok — pending guide returns null
+            return null;
+        }
+    }
+    /**
+     * Clear the pending guide (called after the agent has processed it).
+     */
+    clearPendingGuide() {
+        this.cleanPendingGuide();
+    }
+    /**
+     * Find the upgrades/ directory bundled with the instar package.
+     * Resolves relative to this module's location on disk.
+     */
+    findUpgradesDir() {
+        try {
+            // This file is at dist/core/UpgradeGuideProcessor.js
+            // The upgrades/ dir is at the package root
+            const moduleDir = path.resolve(new URL(import.meta.url).pathname, '..', '..', '..');
+            const upgradesDir = path.join(moduleDir, 'upgrades');
+            if (fs.existsSync(upgradesDir) && fs.statSync(upgradesDir).isDirectory()) {
+                return upgradesDir;
+            }
+        }
+        catch {
+            // @silent-fallback-ok — upgrades dir returns null
+        }
+        return null;
+    }
+    /**
+     * Get all available upgrade guides, sorted by version.
+     */
+    getAvailableGuides(upgradesDir) {
+        const guides = [];
+        try {
+            const files = fs.readdirSync(upgradesDir);
+            for (const file of files) {
+                // Match files like "0.8.12.md", "1.0.0.md"
+                const match = /^(\d+\.\d+\.\d+)\.md$/.exec(file);
+                if (match) {
+                    guides.push({
+                        version: match[1],
+                        filePath: path.join(upgradesDir, file),
+                    });
+                }
+            }
+        }
+        catch {
+            // @silent-fallback-ok — dir read returns empty
+            return [];
+        }
+        // Sort by semver (ascending)
+        guides.sort((a, b) => this.compareSemver(a.version, b.version));
+        return guides;
+    }
+    /**
+     * Get the list of versions whose guides have already been processed.
+     */
+    getProcessedVersions() {
+        if (!fs.existsSync(this.processedFile))
+            return [];
+        try {
+            const data = JSON.parse(fs.readFileSync(this.processedFile, 'utf-8'));
+            return data.processedVersions || [];
+        }
+        catch {
+            // @silent-fallback-ok — processed versions reset
+            return [];
+        }
+    }
+    /**
+     * Mark versions as processed (their guides have been delivered to the agent).
+     */
+    markProcessed(versions) {
+        const existing = this.getProcessedVersions();
+        const all = [...new Set([...existing, ...versions])];
+        const dir = path.dirname(this.processedFile);
+        fs.mkdirSync(dir, { recursive: true });
+        const data = {
+            processedVersions: all,
+            lastProcessedAt: new Date().toISOString(),
+            lastDeliveredVersion: versions[versions.length - 1],
+        };
+        // Atomic write
+        const tmpPath = this.processedFile + `.${process.pid}.tmp`;
+        try {
+            fs.writeFileSync(tmpPath, JSON.stringify(data, null, 2));
+            fs.renameSync(tmpPath, this.processedFile);
+        }
+        catch {
+            try {
+                fs.unlinkSync(tmpPath);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    /**
+     * Remove the pending guide file.
+     */
+    cleanPendingGuide() {
+        try {
+            if (fs.existsSync(this.pendingGuidePath)) {
+                fs.unlinkSync(this.pendingGuidePath);
+            }
+        }
+        catch {
+            // @silent-fallback-ok — cleanup, file persists
+        }
+    }
+    /**
+     * Compare two semver strings. Returns negative if a < b, positive if a > b, 0 if equal.
+     */
+    compareSemver(a, b) {
+        const partsA = a.split('.').map(Number);
+        const partsB = b.split('.').map(Number);
+        for (let i = 0; i < 3; i++) {
+            const diff = (partsA[i] || 0) - (partsB[i] || 0);
+            if (diff !== 0)
+                return diff;
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=UpgradeGuideProcessor.js.map

package/dist/core/UpgradeGuideProcessor.js.map

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