@sumicom/quicksave 0.7.1 → 0.8.0

package/dist/ai/sandboxMcpStdio.js

@@ -15,16 +15,25 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { execFileSync } from 'child_process';
-import { realpathSync, existsSync } from 'fs';
+import { realpathSync, existsSync, readFileSync } from 'fs';
 import { join, dirname } from 'path';
+import { homedir, platform } from 'os';
 import { fileURLToPath } from 'url';
 import { z } from 'zod';
-import { platform } from 'os';
 const __ownDir = dirname(fileURLToPath(import.meta.url));
-const cwdArg = process.argv.indexOf('--cwd');
-const cwd = cwdArg !== -1 ? process.argv[cwdArg + 1] : process.cwd();
+function readArg(flag) {
+    const idx = process.argv.indexOf(flag);
+    return idx !== -1 ? process.argv[idx + 1] : undefined;
+}
+const cwd = readArg('--cwd') ?? process.cwd();
+/** Known only on resume; undefined when the CLI spawns this MCP for a fresh session. */
+const sessionIdHint = readArg('--session-id');
 const realCwd = realpathSync(cwd);
 const realHome = realpathSync(process.env.HOME ?? '/');
+const quicksaveHome = process.env.QUICKSAVE_HOME || join(homedir(), '.quicksave');
+const sessionRegistryDir = join(quicksaveHome, 'state', 'session-registry');
+/** Same encoding as `apps/agent/src/ai/sessionRegistry.ts:encodeProjectPath`. */
+const encodedCwd = cwd.replace(/\//g, '-');
 const PROFILE_PATH = join(__ownDir, 'profiles', 'project-sandbox.sb');
 function detectBackend() {
     const os = platform();
@@ -111,12 +120,97 @@ server.tool('SandboxBash', 'Execute a shell command WITHOUT requiring user permi
         };
     }
 });
-server.tool('SetTitle', 'Update the session title shown to the user. ' +
-    'Call this whenever you start a new task, switch context, or make meaningful progress. ' +
-    'Keep titles short and descriptive (e.g. "Fixing auth middleware", "Adding unit tests for UserService").', {
-    title: z.string().describe('Short description of what you are currently doing'),
+function readStoredStatus() {
+    const empty = {
+        subject: null, stage: null, blocked: null, note: null, recentNotes: [], source: 'unknown',
+    };
+    if (!sessionIdHint)
+        return empty;
+    const path = join(sessionRegistryDir, encodedCwd, `${sessionIdHint}.json`);
+    if (!existsSync(path))
+        return empty;
+    try {
+        const entry = JSON.parse(readFileSync(path, 'utf-8'));
+        const history = Array.isArray(entry.noteHistory) ? entry.noteHistory : [];
+        return {
+            subject: typeof entry.title === 'string' ? entry.title : null,
+            stage: entry.stage ?? null,
+            blocked: typeof entry.blocked === 'boolean' ? entry.blocked : null,
+            note: typeof entry.note === 'string' ? entry.note : null,
+            recentNotes: history.slice(-5),
+            source: 'stored',
+        };
+    }
+    catch {
+        return empty;
+    }
+}
+server.tool('UpdateSessionStatus', 'Update the ticket-style status for the current session, shown to the user on the home screen.\n' +
+    '\n' +
+    'Call at the START of every session (first response), and again whenever stage changes, ' +
+    'work gets blocked/unblocked, or progress is worth surfacing.\n' +
+    '\n' +
+    'Call with NO fields to read the current stored status without mutating ' +
+    '(dry-run). Useful on resume to check whether subject/stage already match the work.\n' +
+    '\n' +
+    'Fields:\n' +
+    '  subject — What this session is solving, from the user\'s perspective.\n' +
+    '            Good: "Fix auth token expiring early"   Bad: "Debugging jwt.ts"\n' +
+    '  stage   — Ticket lifecycle stage:\n' +
+    '            investigating  reading code, finding root cause, understanding problem, designing\n' +
+    '            working        actively writing or changing code\n' +
+    '            verifying      running tests, confirming the fix, waiting on CI\n' +
+    '            done           user-visible deliverable is complete\n' +
+    '  blocked — Orthogonal flag. Set true when stuck (waiting on user decision, ' +
+    'permission request, external service). Set false when unblocked. Do not change stage.\n' +
+    '  note    — One progress/finding entry, max ~12 words. APPENDED to the session\'s event log ' +
+    '(not overwritten). Emit one on meaningful state changes: ruling out a hypothesis, ' +
+    'completing a sub-goal, hitting a blocker, starting verification, etc. ' +
+    'Examples: "handler done, writing tests" / "permission pending on git push" / ' +
+    '"ruled out jwt.ts — secret looks right".\n' +
+    '\n' +
+    'Typical flows:\n' +
+    '  Bug / debug:    investigating → working → verifying → (loop or done)\n' +
+    '  Feature:        investigating → working → verifying → done\n' +
+    '  Question:       investigating → done\n' +
+    '  Chore:          working → verifying → done\n' +
+    '\n' +
+    'Rules:\n' +
+    '- Always call on the first response of a new session to set `subject` and `stage`.\n' +
+    '- On resume, if you cannot see a prior UpdateSessionStatus tool call in conversation ' +
+    'history, do a no-args dry-run first; then set/correct subject or stage if blank or ' +
+    'drifted from the current work.\n' +
+    '- For long-running tasks (research, large refactors), emit a `note` every time you ' +
+    'cross a sub-goal or learn something — the user opens the session to skim recent notes ' +
+    'as progress signal.\n' +
+    '- Do not skip `verifying` if you ran tests / build / repro.\n' +
+    '- Do not declare `done` until the user\'s problem is fully resolved.\n' +
+    '- For long refactors, prefer proposing to split into per-phase sub-sessions ' +
+    'over keeping one session in `investigating` for a long time.', {
+    subject: z.string().optional().describe('Subject line — what this session is solving'),
+    stage: z.enum(['investigating', 'working', 'verifying', 'done']).optional()
+        .describe('Current lifecycle stage'),
+    blocked: z.boolean().optional().describe('True when stuck, false when unblocked'),
+    note: z.string().optional()
+        .describe('One progress/finding entry (~12 words). Appended to the session event log; emit on each meaningful state change.'),
 }, async (args) => {
-    return { content: [{ type: 'text', text: `Title set: ${args.title}` }] };
+    const isDryRun = args.subject === undefined &&
+        args.stage === undefined &&
+        args.blocked === undefined &&
+        args.note === undefined;
+    // Daemon-side `shouldAutoApprove` has already persisted any updates by the
+    // time this handler runs, so re-reading the registry file yields the final
+    // merged state for both dry-run and write paths.
+    const snapshot = readStoredStatus();
+    const header = isDryRun
+        ? (snapshot.source === 'stored' ? 'Current session status (dry-run read):' : 'No stored status for this session yet.')
+        : 'Session status updated. Current status:';
+    return {
+        content: [{
+                type: 'text',
+                text: `${header}\n${JSON.stringify(snapshot, null, 2)}`,
+            }],
+    };
 });
 /** Quote a string for safe use inside a bash -c argument. */
 function shellQuote(s) {

package/dist/ai/sandboxMcpStdio.js.map

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

package/dist/ai/sessionManager.d.ts

@@ -61,6 +61,10 @@ export declare class SessionManager extends EventEmitter {
     /** Send a raw control_request to the active provider session (CLI only). */
     sendControlRequest(sessionId: string, subtype: string, params?: Record<string, unknown>): Promise<unknown>;
     closeSession(sessionId: string): boolean;
+    /** Resolve and remove every pending user-input request for a session that
+     *  is going away. Used by closeSession and onSessionExited so the map
+     *  doesn't leak and any awaiter unblocks with a deny. */
+    private cancelPendingInputsForSession;
     setPermissionLevel(sessionId: string, level: PermissionLevel): Promise<boolean>;
     getPermissionLevel(sessionId: string): PermissionLevel;
     resolveUserInput(response: ClaudeUserInputResponsePayload): boolean;
@@ -110,8 +114,16 @@ export declare class SessionManager extends EventEmitter {
     makeCallbacks(agentId: AgentId): ProviderCallbacks;
     private handlePermissionRequest;
     private shouldAutoApprove;
-    /** Update session title (triggered by SetTitle MCP tool). */
-    private updateSessionTitle;
+    /**
+     * Update session ticket-model status (triggered by the UpdateSessionStatus MCP tool).
+     * Partial update: only fields present in `input` are written. Unknown-typed inputs
+     * are validated here before being applied to session config / registry.
+     *
+     * `note`, when supplied, is appended to the session's `noteHistory` log in the
+     * registry (capped at SESSION_NOTE_HISTORY_CAP, oldest-first). The latest note
+     * text is also mirrored to session config / registry `note` for quick access.
+     */
+    private updateSessionStatus;
     /** Move per-session state from oldId to newId after the CLI forks on
      * --resume. `sessionAgents[newId]` is already set by the caller; this
      * helper moves the remaining side maps and clears the old key. */

package/dist/ai/sessionManager.d.ts.map

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

package/dist/ai/sessionManager.js

@@ -1,9 +1,9 @@
 import { EventEmitter } from 'events';
 import { resolve, join } from 'path';
 import { readFile, writeFile, mkdir } from 'fs/promises';
-import { DEFAULT_AGENT, DEFAULT_MODEL, matchAllowPattern, } from '@sumicom/quicksave-shared';
+import { DEFAULT_AGENT, DEFAULT_MODEL, SESSION_NOTE_HISTORY_CAP, matchAllowPattern, } from '@sumicom/quicksave-shared';
 import { StreamCardBuilder, buildCardsFromHistory, loadPersistedCards } from './cardBuilder.js';
-import { SANDBOX_BASH_TOOL, SET_TITLE_TOOL } from './sandboxMcp.js';
+import { SANDBOX_BASH_TOOL, UPDATE_SESSION_STATUS_TOOL } from './sandboxMcp.js';
 import { getSessionRegistry } from './sessionRegistry.js';
 import { getEventStore } from '../storage/eventStore.js';
 /**
@@ -32,12 +32,23 @@ const AUTO_APPROVE = {
     auto: new Set(['TodoWrite', 'EnterWorktree', 'ExitWorktree', 'Agent', 'EnterPlanMode']),
 };
 const DEFAULT_SYSTEM_PROMPT = [
-    'For non-destructive shell commands (ls, cat, find, git log, git status, git diff, etc.), prefer SandboxBash over Bash. SandboxBash runs in a sandboxed environment. Use Bash only for commands that modify state.',
-    'Call SetTitle to set a descriptive session title when you start a new task or switch context. Keep titles short (e.g. "Fixing auth middleware", "Adding unit tests for UserService"). Update it when the focus changes.',
+    'For non-destructive shell commands (ls, cat, find, git log, git status, git diff, etc.), prefer `mcp__quicksave-sandbox__SandboxBash` over Bash. SandboxBash runs in a sandboxed environment. Use Bash only for commands that modify state.',
+    // Ticket-model status updates. Sessions surface on the user\'s home screen as tickets; keep this metadata fresh.
+    'Treat each session as a ticket. The `mcp__quicksave-sandbox__UpdateSessionStatus` MCP tool is already loaded and available — call it directly, do NOT use ToolSearch. On your FIRST response in a new session, call it with at minimum `subject` and `stage` before doing other work. `subject` is what the user is trying to solve (e.g. "Fix auth token expiring early"), not what you are doing (not "Debugging jwt.ts"). On RESUME, if you do not see a prior `mcp__quicksave-sandbox__UpdateSessionStatus` tool_use in the conversation history, call it ONCE with no arguments as a dry-run to read the current stored status; if the returned subject is empty OR does not match what the user is now asking for, follow up with a real call to set/correct it.',
+    'Re-call `mcp__quicksave-sandbox__UpdateSessionStatus` whenever the stage changes (investigating → working → verifying → done), whenever work becomes blocked or unblocked (set `blocked` true/false without changing `stage`), or when a one-line `note` would give the user useful progress signal. `note` is an append-only event log — each call adds one entry — so for long-running tasks (research, large refactors) emit a fresh `note` every time you rule out an approach, cross a sub-goal, or hit a blocker. Do not skip `verifying` when you have tests/build/repro running. Do not declare `done` until the user\'s problem is fully resolved.',
 ].join('\n\n');
 function buildSystemPrompt(extra) {
     return extra ? `${DEFAULT_SYSTEM_PROMPT}\n\n${extra}` : DEFAULT_SYSTEM_PROMPT;
 }
+const SESSION_STAGES = [
+    'investigating',
+    'working',
+    'verifying',
+    'done',
+];
+function isSessionStage(value) {
+    return SESSION_STAGES.includes(value);
+}
 function normalizeAgentId(value) {
     if (value === 'claude-code' || value === 'claude-cli' || value === 'claude-sdk') {
         return 'claude-code';
@@ -385,6 +396,11 @@ export class SessionManager extends EventEmitter {
             return false;
         console.log(`[session-manager] cancel session=${sessionId.slice(0, 8)}`);
         ps.providerSession.interrupt();
+        // The CLI abandons its can_use_tool RPC after interrupt, so any awaiter
+        // on our side would hang forever. Resolve outstanding permissions with
+        // deny: it unblocks the daemon promise, frees the map slot, and matches
+        // user intent ("stop" = don't do that thing).
+        this.cancelPendingInputsForSession(sessionId);
         return true;
     }
     /** Send a raw control_request to the active provider session (CLI only). */
@@ -408,9 +424,24 @@ export class SessionManager extends EventEmitter {
             ps.providerSession = null;
         }
         this.sessions.delete(sessionId);
+        // Drop any pending permission promises for this session — the CLI is dead
+        // so any later resolveUserInput would land on an orphan promise, and the
+        // map entry would leak forever.
+        this.cancelPendingInputsForSession(sessionId);
         this.emitSessionUpdate(sessionId);
         return true;
     }
+    /** Resolve and remove every pending user-input request for a session that
+     *  is going away. Used by closeSession and onSessionExited so the map
+     *  doesn't leak and any awaiter unblocks with a deny. */
+    cancelPendingInputsForSession(sessionId) {
+        for (const [requestId, pending] of this.pendingInputRequests) {
+            if (pending.request.sessionId !== sessionId)
+                continue;
+            pending.resolve({ sessionId, requestId, action: 'deny' });
+            this.pendingInputRequests.delete(requestId);
+        }
+    }
     // ── Permission ──
     async setPermissionLevel(sessionId, level) {
         const ps = this.sessions.get(sessionId);
@@ -432,7 +463,17 @@ export class SessionManager extends EventEmitter {
                 throw err;
             }
         }
-        this.emitSessionUpdate(sessionId);
+        if (ps) {
+            this.emitSessionUpdate(sessionId);
+        }
+        else {
+            // Inactive session: emitSessionUpdate would carry archived=true (since
+            // the session isn't in the in-memory map), which the PWA reads as a
+            // "session retired" signal and bounces the user off the page. Persist
+            // to the registry instead so the new mode applies on the next cold
+            // resume; the PWA's optimistic state already reflects the change.
+            this.persistRegistryField(sessionId, 'permissionMode', level);
+        }
         return true;
     }
     getPermissionLevel(sessionId) {
@@ -458,7 +499,12 @@ export class SessionManager extends EventEmitter {
             });
         }
         this.emit('user-input-resolved', { requestId: response.requestId, sessionId: pending.request.sessionId });
-        this.emitSessionUpdate(pending.request.sessionId);
+        // Skip the session-update emit when the session is no longer in memory:
+        // buildSessionUpdatePayload would set archived=true and navigate the PWA
+        // off the page. Can happen if the CLI exited (or was rekeyed) between
+        // sending the permission request and the user responding.
+        if (ps)
+            this.emitSessionUpdate(pending.request.sessionId);
         return true;
     }
     // ── Query ──
@@ -505,8 +551,7 @@ export class SessionManager extends EventEmitter {
     }
     async listAvailableSessions(cwd) {
         const registry = getSessionRegistry();
-        const registryEntries = registry.getEntriesForProject(cwd)
-            .filter(entry => !entry.archived);
+        const registryEntries = registry.getEntriesForProject(cwd);
         const pendingSessionIds = new Set(Array.from(this.pendingInputRequests.values()).map(p => p.request.sessionId));
         const eventStore = getEventStore();
         return registryEntries.map(entry => {
@@ -668,6 +713,13 @@ export class SessionManager extends EventEmitter {
             handlePermissionRequest: async (sessionId, req) => {
                 return this.handlePermissionRequest(sessionId, req);
             },
+            onToolUse: (sessionId, toolName, toolInput) => {
+                // Claude CLI's auto permission mode skips can_use_tool for MCP tools,
+                // so handlePermissionRequest can't reliably drive side effects here.
+                if (toolName === UPDATE_SESSION_STATUS_TOOL) {
+                    this.updateSessionStatus(sessionId, toolInput);
+                }
+            },
             onModelDetected: (model) => {
                 console.log(`[session-manager] model detected: ${model} (agent=${agentId})`);
                 if (agentId === 'claude-code') {
@@ -684,6 +736,7 @@ export class SessionManager extends EventEmitter {
                 ps.providerSession = null;
                 ps.streaming = false;
                 this.sessions.delete(sessionId);
+                this.cancelPendingInputsForSession(sessionId);
                 this.emitSessionUpdate(sessionId);
             },
         };
@@ -754,10 +807,10 @@ export class SessionManager extends EventEmitter {
         return { action: 'allow' };
     }
     shouldAutoApprove(sessionId, toolName, input) {
-        // SetTitle — always approve
-        if (toolName === SET_TITLE_TOOL) {
-            if (input.title)
-                this.updateSessionTitle(sessionId, input.title);
+        // UpdateSessionStatus — always approve. The actual metadata write happens
+        // in the onToolUse callback (driven by the assistant stream), because
+        // CLI auto mode pre-approves MCP tools without ever sending can_use_tool.
+        if (toolName === UPDATE_SESSION_STATUS_TOOL) {
             return true;
         }
         // SandboxBash: auto-approve when sandboxed, otherwise check as Bash
@@ -784,18 +837,69 @@ export class SessionManager extends EventEmitter {
         }
         return true;
     }
-    /** Update session title (triggered by SetTitle MCP tool). */
-    updateSessionTitle(sessionId, title) {
-        const config = this.sessionConfigs.get(sessionId) ?? {};
-        this.sessionConfigs.set(sessionId, { ...config, title });
-        this.emit('session-config-updated', { sessionId, config: this.sessionConfigs.get(sessionId) });
-        // Update session registry so it persists across restarts
+    /**
+     * Update session ticket-model status (triggered by the UpdateSessionStatus MCP tool).
+     * Partial update: only fields present in `input` are written. Unknown-typed inputs
+     * are validated here before being applied to session config / registry.
+     *
+     * `note`, when supplied, is appended to the session's `noteHistory` log in the
+     * registry (capped at SESSION_NOTE_HISTORY_CAP, oldest-first). The latest note
+     * text is also mirrored to session config / registry `note` for quick access.
+     */
+    updateSessionStatus(sessionId, input) {
+        const configUpdates = {};
+        const entryUpdates = {};
+        let noteToAppend = null;
+        let changed = false;
+        if (typeof input.subject === 'string' && input.subject.length > 0) {
+            configUpdates.title = input.subject;
+            entryUpdates.title = input.subject;
+            changed = true;
+        }
+        if (typeof input.stage === 'string' && isSessionStage(input.stage)) {
+            configUpdates.stage = input.stage;
+            entryUpdates.stage = input.stage;
+            changed = true;
+        }
+        if (typeof input.blocked === 'boolean') {
+            configUpdates.blocked = input.blocked;
+            entryUpdates.blocked = input.blocked;
+            changed = true;
+        }
+        if (typeof input.note === 'string' && input.note.length > 0) {
+            configUpdates.note = input.note;
+            entryUpdates.note = input.note;
+            noteToAppend = input.note;
+            changed = true;
+        }
+        if (!changed)
+            return;
+        const prev = this.sessionConfigs.get(sessionId) ?? {};
+        const next = { ...prev, ...configUpdates };
+        this.sessionConfigs.set(sessionId, next);
+        this.emit('session-config-updated', { sessionId, config: next });
         const ps = this.sessions.get(sessionId);
         if (ps?.cwd) {
             const registry = getSessionRegistry();
             const entry = registry.getEntry(ps.cwd, sessionId);
             if (entry) {
-                registry.upsertEntry({ ...entry, title, lastAccessedAt: Date.now() });
+                let nextHistory = entry.noteHistory;
+                if (noteToAppend !== null) {
+                    const appended = { ts: Date.now(), text: noteToAppend };
+                    const prior = Array.isArray(entry.noteHistory) ? entry.noteHistory : [];
+                    const combined = [...prior, appended];
+                    // Trim oldest-first once we exceed the cap so the registry payload
+                    // stays broadcast-friendly.
+                    nextHistory = combined.length > SESSION_NOTE_HISTORY_CAP
+                        ? combined.slice(combined.length - SESSION_NOTE_HISTORY_CAP)
+                        : combined;
+                }
+                registry.upsertEntry({
+                    ...entry,
+                    ...entryUpdates,
+                    ...(nextHistory !== entry.noteHistory ? { noteHistory: nextHistory } : {}),
+                    lastAccessedAt: Date.now(),
+                });
             }
         }
     }
@@ -818,6 +922,15 @@ export class SessionManager extends EventEmitter {
             this.sessionConfigs.set(newId, config);
             this.sessionConfigs.delete(oldId);
         }
+        // Rewrite any pending input request still tagged with the old sessionId
+        // so a later resolveUserInput can find the new session entry (and its
+        // cardBuilder) to clear the PWA's pending-permission UI. Without this,
+        // permission prompts emitted before the rekey stay stuck on screen.
+        for (const [, pending] of this.pendingInputRequests) {
+            if (pending.request.sessionId === oldId) {
+                pending.request = { ...pending.request, sessionId: newId };
+            }
+        }
         this.sessionAgents.delete(oldId);
     }
     emitSessionUpdate(sessionId) {
@@ -920,6 +1033,15 @@ export class SessionManager extends EventEmitter {
     waitForUserInput(requestId, request) {
         return new Promise((resolve) => {
             this.pendingInputRequests.set(requestId, { resolve, request });
+            // Notify subscribers so the PWA's dot indicator flips to "pending"
+            // immediately. resolveUserInput emits its own update to flip it back.
+            // Guard against an inactive session: emitting then would carry
+            // archived=true and bounce the PWA off the page. (Should not normally
+            // happen — the CLI is alive whenever it asks for permission — but the
+            // race is cheap to guard.)
+            if (this.sessions.has(request.sessionId)) {
+                this.emitSessionUpdate(request.sessionId);
+            }
         });
     }
 }