cray-code 1.0.0

package/dist/services/memory.js

@@ -0,0 +1,181 @@
+/**
+ * Memory System for Cray Code.
+ *
+ * Mirrors Claude Code's memory/ directory design.
+ * Persistent memory stored as markdown files in .cray/memory/:
+ *   user/        — user preferences, role, knowledge
+ *   project/     — project decisions, constraints, ongoing work
+ *   feedback/    — user corrections, confirmed approaches
+ *   reference/   — pointers to external resources (docs, dashboards, etc.)
+ *
+ * Memories are auto-injected into the system prompt on each turn.
+ */
+import { existsSync, readFileSync, readdirSync, mkdirSync, writeFileSync, unlinkSync } from 'fs';
+import { join, basename } from 'path';
+import { homedir } from 'os';
+// ─── Directory Resolution ──────────────────────────────────────────
+export function getMemoryDirectories(projectRoot) {
+    const dirs = [];
+    // Global memory: ~/.cray/memory/
+    const globalDir = join(homedir(), '.cray', 'memory');
+    if (existsSync(globalDir))
+        dirs.push(globalDir);
+    // Project memory: <project>/.cray/memory/
+    if (projectRoot) {
+        const projectDir = join(projectRoot, '.cray', 'memory');
+        if (existsSync(projectDir))
+            dirs.push(projectDir);
+    }
+    return dirs;
+}
+function getTypeDir(base, type) {
+    return join(base, type);
+}
+// ─── Load All Memories ─────────────────────────────────────────────
+export function loadAllMemories(projectRoot) {
+    const dirs = getMemoryDirectories(projectRoot);
+    const entries = [];
+    for (const dir of dirs) {
+        for (const type of ['user', 'project', 'feedback', 'reference']) {
+            const typeDir = join(dir, type);
+            if (!existsSync(typeDir))
+                continue;
+            try {
+                for (const file of readdirSync(typeDir)) {
+                    if (!file.endsWith('.md'))
+                        continue;
+                    const filePath = join(typeDir, file);
+                    try {
+                        const content = readFileSync(filePath, 'utf-8');
+                        const entry = parseMemoryFile(file, content, filePath, type);
+                        if (entry)
+                            entries.push(entry);
+                    }
+                    catch { /* skip unreadable */ }
+                }
+            }
+            catch { /* skip unreadable dir */ }
+        }
+    }
+    return entries;
+}
+/** Build the memory prompt block injected into system prompt */
+export function buildMemoryPrompt(projectRoot) {
+    const entries = loadAllMemories(projectRoot);
+    if (entries.length === 0)
+        return '';
+    // Group by type
+    const byType = {};
+    for (const e of entries) {
+        (byType[e.type] ??= []).push(e);
+    }
+    const lines = [];
+    lines.push('─── Persistent Memory ───');
+    lines.push('');
+    const labels = {
+        user: 'About You (user profile)',
+        project: 'Project Context',
+        feedback: 'Feedback & Preferences',
+        reference: 'External References',
+    };
+    for (const [type, mems] of Object.entries(byType)) {
+        lines.push(`[${labels[type] || type}]`);
+        for (const m of mems.slice(0, 5)) {
+            lines.push(`- ${m.description}`);
+        }
+        lines.push('');
+    }
+    lines.push(`(${entries.length} total memories loaded)`);
+    return lines.join('\n');
+}
+/** Build a single memory entry' full content for tool display */
+export function buildMemoryContentPrompt(projectRoot) {
+    const entries = loadAllMemories(projectRoot);
+    if (entries.length === 0)
+        return '';
+    const lines = ['MEMORY CONTEXT:', ''];
+    for (const e of entries) {
+        lines.push(`--- ${e.type}: ${e.name} ---`);
+        lines.push(e.content.slice(0, 500));
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ─── Save / Create ─────────────────────────────────────────────────
+export function saveMemory(type, name, description, content, projectRoot) {
+    const baseDir = projectRoot
+        ? join(projectRoot, '.cray', 'memory')
+        : join(homedir(), '.cray', 'memory');
+    const typeDir = join(baseDir, type);
+    mkdirSync(typeDir, { recursive: true });
+    const safeName = name.replace(/[^a-zA-Z0-9一-鿿_-]/g, '-');
+    const filePath = join(typeDir, `${safeName}.md`);
+    const frontmatter = [
+        '---',
+        `name: ${safeName}`,
+        `description: ${description}`,
+        `type: ${type}`,
+        '---',
+        '',
+        content,
+    ].join('\n');
+    writeFileSync(filePath, frontmatter, 'utf-8');
+    return { success: true, message: `Memory "${name}" saved as ${type}.`, path: filePath };
+}
+export function deleteMemory(type, name, projectRoot) {
+    const dirs = getMemoryDirectories(projectRoot);
+    for (const dir of dirs) {
+        const filePath = join(dir, type, `${name}.md`);
+        if (existsSync(filePath)) {
+            unlinkSync(filePath);
+            return { success: true, message: `Memory "${name}" deleted.` };
+        }
+    }
+    return { success: false, message: `Memory "${name}" not found.` };
+}
+export function listMemories(projectRoot) {
+    return loadAllMemories(projectRoot);
+}
+// ─── Memory Injection Hint for System Prompt ──────────────────────
+export function getMemoryInjectionHint() {
+    return [
+        'You have access to a persistent memory system.',
+        `Memories are stored in ~/.cray/memory/ and <project>/.cray/memory/.`,
+        'Types: user (about the user), project (project context), feedback (preferences), reference (external refs).',
+        'When the user says "remember this" or gives feedback about how to work, SAVE IT using the memory tool.',
+        'When relevant, recall memories to personalize responses.',
+    ].join('\n');
+}
+// ─── Parser ───────────────────────────────────────────────────────
+function parseMemoryFile(filename, content, filePath, type) {
+    let name = basename(filename, '.md');
+    let description = '';
+    if (content.startsWith('---')) {
+        const endIdx = content.indexOf('---', 3);
+        if (endIdx > 0) {
+            const fm = content.slice(3, endIdx).trim();
+            for (const line of fm.split('\n')) {
+                const ci = line.indexOf(':');
+                if (ci < 0)
+                    continue;
+                const k = line.slice(0, ci).trim();
+                const v = line.slice(ci + 1).trim().replace(/^["']|["']$/g, '');
+                if (k === 'name')
+                    name = v || name;
+                if (k === 'description')
+                    description = v;
+            }
+        }
+    }
+    if (!description) {
+        description = content
+            .replace(/^---[\s\S]*?---/, '')
+            .trim()
+            .split('\n')
+            .find((l) => l.trim() && !l.startsWith('#'))
+            ?.trim()
+            .slice(0, 80) || name;
+    }
+    return { type, name, description, content, path: filePath };
+}
+//# sourceMappingURL=memory.js.map

package/dist/services/memory.js.map

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

package/dist/services/permissionPrompt.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Interactive Permission Prompt for Cray Code.
+ *
+ * When a tool requests permission (behavior: 'ask'), this module
+ * renders a Y/N prompt inline in the terminal and waits for the user.
+ *
+ * Rules:
+ *   Y / Yes / y / yes → allow
+ *   N / No / n / no   → deny
+ *   Enter              → deny (default safe)
+ *   A / a              → allow ALL subsequent asks this session
+ *
+ * Mode 'bypass' skips all prompts.
+ * Mode 'acceptEdits' skips write/edit, prompts for bash.
+ * Mode 'default' prompts for all destructive operations.
+ */
+export type PromptAnswer = 'allow' | 'deny' | 'allowAll';
+export interface PermissionPromptOptions {
+    /** What the tool wants to do */
+    message: string;
+    /** Current permission mode */
+    mode: string;
+    /** Whether "allow all" has been set this session */
+    allowAllActive: boolean;
+    /** Abort signal to cancel the prompt */
+    signal?: AbortSignal;
+}
+/**
+ * Returns 'allow' | 'deny' | 'allowAll'.
+ * Call this from the tool execution layer before running a tool.
+ */
+export declare function askPermission(opts: PermissionPromptOptions): Promise<PromptAnswer>;
+/** Resolve a permission prompt synchronously (used in non-interactive mode). */
+export declare function askPermissionSync(opts: PermissionPromptOptions): PromptAnswer;
+export declare const PERMISSION_MODES: readonly ["default", "acceptEdits", "bypass", "plan"];
+export type PermissionMode = (typeof PERMISSION_MODES)[number];
+export declare function isMode(value: string): value is PermissionMode;
+//# sourceMappingURL=permissionPrompt.d.ts.map

package/dist/services/permissionPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionPrompt.d.ts","sourceRoot":"","sources":["../../src/services/permissionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,cAAc,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BxF;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,uBAAuB,GAAG,YAAY,CAI7E;AAsBD,eAAO,MAAM,gBAAgB,uDAAwD,CAAC;AACtF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAE7D"}

package/dist/services/permissionPrompt.js

@@ -0,0 +1,83 @@
+/**
+ * Interactive Permission Prompt for Cray Code.
+ *
+ * When a tool requests permission (behavior: 'ask'), this module
+ * renders a Y/N prompt inline in the terminal and waits for the user.
+ *
+ * Rules:
+ *   Y / Yes / y / yes → allow
+ *   N / No / n / no   → deny
+ *   Enter              → deny (default safe)
+ *   A / a              → allow ALL subsequent asks this session
+ *
+ * Mode 'bypass' skips all prompts.
+ * Mode 'acceptEdits' skips write/edit, prompts for bash.
+ * Mode 'default' prompts for all destructive operations.
+ */
+import readline from 'readline';
+/**
+ * Returns 'allow' | 'deny' | 'allowAll'.
+ * Call this from the tool execution layer before running a tool.
+ */
+export async function askPermission(opts) {
+    if (opts.mode === 'bypass')
+        return 'allow';
+    if (opts.allowAllActive)
+        return 'allow';
+    // Write/Edit operations in acceptEdits mode are auto-allowed
+    const isFileOp = opts.message.toLowerCase().includes('write') ||
+        opts.message.toLowerCase().includes('edit') ||
+        opts.message.toLowerCase().includes('create') ||
+        opts.message.toLowerCase().includes('overwrite');
+    if (opts.mode === 'acceptEdits' && isFileOp)
+        return 'allow';
+    // Build the prompt
+    const text = `\n  ⚡ ${opts.message}\n  [Y] yes  [N] no (default)  [A] allow all  → `;
+    process.stderr.write(text);
+    const answer = await readLine(opts.signal);
+    process.stderr.write('\n');
+    const trimmed = answer.trim().toLowerCase();
+    if (trimmed === 'y' || trimmed === 'yes')
+        return 'allow';
+    if (trimmed === 'a' || trimmed === 'allow' || trimmed === 'allow all')
+        return 'allowAll';
+    // Default: deny
+    return 'deny';
+}
+/** Resolve a permission prompt synchronously (used in non-interactive mode). */
+export function askPermissionSync(opts) {
+    if (opts.mode === 'bypass')
+        return 'allow';
+    if (opts.allowAllActive)
+        return 'allow';
+    return 'deny'; // non-interactive → safe default
+}
+// ─── Read a single line from stdin ─────────────────────────────────
+function readLine(signal) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+        let resolved = false;
+        const onSig = () => {
+            if (!resolved) {
+                resolved = true;
+                rl.close();
+                resolve('n');
+            }
+        };
+        signal?.addEventListener('abort', onSig, { once: true });
+        rl.question('', (answer) => {
+            if (!resolved) {
+                resolved = true;
+                signal?.removeEventListener('abort', onSig);
+                rl.close();
+                resolve(answer);
+            }
+        });
+    });
+}
+// ─── Permission Mode Helpers ──────────────────────────────────────
+export const PERMISSION_MODES = ['default', 'acceptEdits', 'bypass', 'plan'];
+export function isMode(value) {
+    return PERMISSION_MODES.includes(value);
+}
+//# sourceMappingURL=permissionPrompt.js.map

package/dist/services/permissionPrompt.js.map

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

package/dist/services/permissions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Permission Engine — mirrors Claude Code's utils/permissions/permissions.ts.
+ *
+ * Core function: hasPermissionsToUseTool()
+ * Full pipeline: tool-level deny → tool-level ask → tool.checkPermissions →
+ *               safety checks → mode bypass → tool-level allow → convert passthrough→ask
+ *
+ * Post-processing: dontAsk mode, acceptEdits fast-path, headless auto-deny.
+ */
+import type { ToolDef } from '../Tool.js';
+import type { PermissionResult, PermissionRule, ToolPermissionContext, PermissionMode } from '../types/permission.js';
+export declare function hasPermissionsToUseTool(tool: ToolDef<any, any>, input: Record<string, unknown>, context: ToolPermissionContext): Promise<PermissionResult>;
+export declare function addPermissionRule(rule: PermissionRule, context: ToolPermissionContext): ToolPermissionContext;
+export declare function setPermissionMode(mode: PermissionMode, context: ToolPermissionContext): ToolPermissionContext;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/services/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/services/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EAGrB,cAAc,EACf,MAAM,wBAAwB,CAAC;AAMhC,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AA4QD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,CAcvB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,CASvB"}

package/dist/services/permissions.js

@@ -0,0 +1,237 @@
+/**
+ * Permission Engine — mirrors Claude Code's utils/permissions/permissions.ts.
+ *
+ * Core function: hasPermissionsToUseTool()
+ * Full pipeline: tool-level deny → tool-level ask → tool.checkPermissions →
+ *               safety checks → mode bypass → tool-level allow → convert passthrough→ask
+ *
+ * Post-processing: dontAsk mode, acceptEdits fast-path, headless auto-deny.
+ */
+// ═════════════════════════════════════════════════════════════════════
+//  MAIN ENTRY POINT
+// ═════════════════════════════════════════════════════════════════════
+export async function hasPermissionsToUseTool(tool, input, context) {
+    const inner = await hasPermissionsToUseToolInner(tool, input, context);
+    return postProcess(inner, context);
+}
+// ═════════════════════════════════════════════════════════════════════
+//  STEP 1: Check tool-level deny
+// ═════════════════════════════════════════════════════════════════════
+function hasPermissionsToUseToolInner(tool, input, context) {
+    return checkDenyRules(tool, input, context);
+}
+async function checkDenyRules(tool, input, context) {
+    // 1a. Entire tool denied by rule
+    const denyRule = getDenyRuleForTool(tool.name, context.alwaysDenyRules);
+    if (denyRule) {
+        return {
+            behavior: 'deny',
+            message: `Tool "${tool.name}" is permanently denied by rule.`,
+            decisionReason: { type: 'rule', message: `Denied by rule from ${denyRule.source ?? 'settings'}` },
+        };
+    }
+    // 1b. Content-specific deny: check if input matches a deny pattern
+    const contentDeny = matchContentRule(tool.name, input, context.alwaysDenyRules, 'deny');
+    if (contentDeny) {
+        return {
+            behavior: 'deny',
+            message: `This specific ${tool.name} operation matches a deny rule.`,
+            decisionReason: { type: 'rule', message: contentDeny.message },
+        };
+    }
+    return checkAskRules(tool, input, context);
+}
+// ═════════════════════════════════════════════════════════════════════
+//  STEP 2: Tool-level ask rules
+// ═════════════════════════════════════════════════════════════════════
+async function checkAskRules(tool, input, context) {
+    // 2a. Entire tool always ask
+    const askRule = context.alwaysAskRules.find((r) => r.toolName === tool.name && !r.pattern);
+    if (askRule) {
+        return {
+            behavior: 'ask',
+            message: `Tool "${tool.name}" requires explicit confirmation.`,
+            decisionReason: { type: 'rule', message: `Always-ask rule from ${askRule.source ?? 'settings'}` },
+            suggestions: buildSuggestions(tool.name, input),
+        };
+    }
+    // 2b. Content-specific ask rule
+    const contentAsk = matchContentRule(tool.name, input, context.alwaysAskRules, 'ask');
+    if (contentAsk) {
+        return {
+            behavior: 'ask',
+            message: contentAsk.message,
+            decisionReason: { type: 'contentAsk', message: contentAsk.message },
+            suggestions: buildSuggestions(tool.name, input),
+        };
+    }
+    // Continue to tool check
+    return checkToolImpl(tool, input, context);
+}
+// ═════════════════════════════════════════════════════════════════════
+//  STEP 3: Ask the tool implementation
+// ═════════════════════════════════════════════════════════════════════
+async function checkToolImpl(tool, input, context) {
+    // 3a. Run tool.checkPermissions()
+    let toolResult;
+    try {
+        toolResult = tool.checkPermissions
+            ? await tool.checkPermissions(input, { mode: context.mode })
+            : { behavior: 'passthrough', message: '' };
+    }
+    catch {
+        toolResult = { behavior: 'ask', message: `Permission check failed for ${tool.name}.` };
+    }
+    // 3b. Tool denied — stop
+    if (toolResult.behavior === 'deny') {
+        return {
+            ...toolResult,
+            decisionReason: toolResult.decisionReason ?? { type: 'toolCheck', message: toolResult.message },
+        };
+    }
+    // 3c. Requires user interaction — even bypass can't skip (but we still ask)
+    const requiresInteraction = toolResult.requireExplicitUserApproval === true;
+    if (requiresInteraction && toolResult.behavior === 'ask') {
+        return {
+            ...toolResult,
+            behavior: 'ask',
+            decisionReason: { type: 'requiresInteraction', message: 'This operation requires explicit user approval.' },
+            suggestions: suggestionsForTool(tool, input, toolResult),
+        };
+    }
+    // 3d. Content-specific ask from tool (survives even bypass)
+    if (toolResult.behavior === 'ask' && toolResult.decisionReason?.type === 'contentAsk') {
+        return {
+            ...toolResult,
+            behavior: 'ask',
+            suggestions: suggestionsForTool(tool, input, toolResult),
+        };
+    }
+    // 3e. Safety checks are always ask (even in bypass mode)
+    if (toolResult.decisionReason?.type === 'safetyCheck') {
+        return {
+            ...toolResult,
+            behavior: 'ask',
+            suggestions: suggestionsForTool(tool, input, toolResult),
+        };
+    }
+    return checkModeBypass(tool, input, context, toolResult);
+}
+// ═════════════════════════════════════════════════════════════════════
+//  STEP 4: Mode-based bypass
+// ═════════════════════════════════════════════════════════════════════
+async function checkModeBypass(tool, input, context, toolResult) {
+    // 4a. bypass mode: everything allowed
+    if (context.mode === 'bypass') {
+        return { behavior: 'allow', decisionReason: { type: 'mode', message: 'Bypass mode' } };
+    }
+    // 4b. acceptEdits: auto-allow file edits, prompt for bash
+    if (context.mode === 'acceptEdits') {
+        const isEdit = ['write', 'create', 'edit', 'modify', 'replace'].includes(tool.name);
+        if (isEdit) {
+            return { behavior: 'allow', decisionReason: { type: 'mode', message: 'Accept edits mode' } };
+        }
+    }
+    // 4c. plan mode: read-only only
+    if (context.mode === 'plan') {
+        if (tool.isReadOnly?.(input)) {
+            return { behavior: 'allow', decisionReason: { type: 'mode', message: 'Plan mode (read-only)' } };
+        }
+        return {
+            behavior: 'deny',
+            message: `Cannot write/modify in plan mode. Exit plan mode first.`,
+            decisionReason: { type: 'mode', message: 'Plan mode blocks writes' },
+        };
+    }
+    // 4d. Entire tool allowed by rule
+    const allowRule = context.alwaysAllowRules.find((r) => r.toolName === tool.name && !r.pattern);
+    if (allowRule) {
+        return { behavior: 'allow', decisionReason: { type: 'rule', message: `Allowed by rule from ${allowRule.source ?? 'settings'}` } };
+    }
+    // 4e. Content-specific allow rule
+    const contentAllow = matchContentRule(tool.name, input, context.alwaysAllowRules, 'allow');
+    if (contentAllow) {
+        return { behavior: 'allow', decisionReason: { type: 'rule', message: contentAllow.message } };
+    }
+    // 4f. Tool itself says passthrough (no opinion) → convert to ask in default mode
+    if (toolResult.behavior === 'passthrough' || toolResult.behavior === 'allow') {
+        const isReadOnly = tool.isReadOnly?.(input) ?? false;
+        if (isReadOnly && context.mode === 'default') {
+            return { behavior: 'allow', decisionReason: { type: 'mode', message: 'Read-only tool in default mode' } };
+        }
+        return {
+            behavior: 'ask',
+            message: toolResult.message || `Allow ${tool.name}?`,
+            decisionReason: toolResult.decisionReason ?? { type: 'mode', message: 'Default mode requires confirmation' },
+            suggestions: suggestionsForTool(tool, input, toolResult),
+        };
+    }
+    // 4g. Ask the user
+    return {
+        behavior: 'ask',
+        message: toolResult.message || `Allow ${tool.name}?`,
+        decisionReason: toolResult.decisionReason,
+        suggestions: suggestionsForTool(tool, input, toolResult),
+    };
+}
+// ═════════════════════════════════════════════════════════════════════
+//  POST-PROCESSING
+// ═════════════════════════════════════════════════════════════════════
+function postProcess(result, _context) {
+    return result;
+}
+// ═════════════════════════════════════════════════════════════════════
+//  HELPERS
+// ═════════════════════════════════════════════════════════════════════
+function getDenyRuleForTool(toolName, rules) {
+    return rules.find((r) => r.toolName === toolName && !r.pattern);
+}
+function matchContentRule(toolName, input, rules, behavior) {
+    for (const rule of rules) {
+        if (rule.toolName !== toolName || !rule.pattern || rule.behavior !== behavior)
+            continue;
+        // Check if the pattern appears anywhere in the tool input
+        const inputStr = JSON.stringify(input).toLowerCase();
+        if (inputStr.includes(rule.pattern.toLowerCase())) {
+            return { message: `"${rule.pattern}" matches a ${behavior} rule from ${rule.source ?? 'settings'}.` };
+        }
+    }
+    return null;
+}
+function buildSuggestions(toolName, input) {
+    const suggestions = [
+        { label: 'Yes', description: 'Allow this operation once', behavior: 'allow' },
+        { label: "Yes, don't ask again for this tool", description: `Always allow ${toolName}`, behavior: 'allowAlways' },
+        { label: 'No', description: 'Deny this operation', behavior: 'deny' },
+    ];
+    return suggestions;
+}
+function suggestionsForTool(tool, input, _toolResult) {
+    return buildSuggestions(tool.name, input);
+}
+export function addPermissionRule(rule, context) {
+    const updated = { ...context };
+    switch (rule.behavior) {
+        case 'allow':
+            updated.alwaysAllowRules = [...context.alwaysAllowRules, rule];
+            break;
+        case 'deny':
+            updated.alwaysDenyRules = [...context.alwaysDenyRules, rule];
+            break;
+        case 'ask':
+            updated.alwaysAskRules = [...context.alwaysAskRules, rule];
+            break;
+    }
+    return updated;
+}
+export function setPermissionMode(mode, context) {
+    if (mode === 'plan' && context.mode !== 'plan') {
+        return { ...context, mode, prePlanMode: context.mode };
+    }
+    if (mode !== 'plan' && context.mode === 'plan') {
+        const restored = context.prePlanMode ?? 'default';
+        return { ...context, mode, prePlanMode: undefined };
+    }
+    return { ...context, mode };
+}
+//# sourceMappingURL=permissions.js.map

package/dist/services/permissions.js.map

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

package/dist/services/sessionStorage.d.ts

@@ -0,0 +1,51 @@
+/**
+ * sessionStorage.ts — Session persistence for Cray Code.
+ *
+ * Mirrors Claude Code's pattern: conversations persist as JSONL files
+ * in ~/.cray/projects/<sanitized-project-path>/<sessionId>.jsonl.
+ *
+ * Each line is a JSON object representing one message entry.
+ * Messages are chained via parentUuid for conversation reconstruction.
+ */
+import type { Message } from '../types/message.js';
+export declare function sanitizePath(projectPath: string): string;
+export declare function getProjectDir(cwd: string): string;
+export declare function getSessionPath(cwd: string, sessionId: string): string;
+export interface SessionMeta {
+    sessionId: string;
+    cwd: string;
+    firstPrompt: string;
+    messageCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SessionListEntry {
+    sessionId: string;
+    firstPrompt: string;
+    messageCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * List all saved sessions for the current project directory.
+ * Reads the JSONL tail to extract first-prompt metadata.
+ */
+export declare function listSessions(cwd: string): Promise<SessionListEntry[]>;
+/**
+ * List sessions across ALL projects (global resume).
+ */
+export declare function listAllSessions(): Promise<(SessionListEntry & {
+    cwd: string;
+})[]>;
+export declare function recordTranscriptEntry(cwd: string, sessionId: string, entry: Record<string, unknown>): void;
+export declare function recordMessages(cwd: string, sessionId: string, messages: Message[], parentUuid?: string | null): void;
+/**
+ * Flush any pending writes immediately (call before process exit).
+ */
+export declare function flushSessionStorage(): Promise<void>;
+export declare function loadSession(cwd: string, sessionId: string): Promise<Message[]>;
+export declare function loadSessionFromFile(filePath: string): Promise<Message[]>;
+export declare function deleteSession(cwd: string, sessionId: string): Promise<boolean>;
+export declare function getCurrentSessionId(): string | null;
+export declare function setCurrentSessionId(id: string): void;
+//# sourceMappingURL=sessionStorage.d.ts.map