oh-my-claude-sisyphus 3.2.5 → 3.3.1

package/dist/agents/scientist.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Scientist Agent - Data Analysis & Research Execution
+ *
+ * Specialized agent for executing data analysis workflows using Python.
+ * Performs EDA, statistical analysis, and generates actionable findings.
+ *
+ * Enables:
+ * - Exploratory data analysis on CSV, JSON, Parquet files
+ * - Statistical computations and hypothesis testing
+ * - Data transformations and feature engineering
+ * - Generating structured findings with evidence
+ */
+import type { AgentConfig, AgentPromptMetadata } from './types.js';
+export declare const SCIENTIST_PROMPT_METADATA: AgentPromptMetadata;
+export declare const scientistAgent: AgentConfig;
+//# sourceMappingURL=scientist.d.ts.map

package/dist/agents/scientist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scientist.d.ts","sourceRoot":"","sources":["../../src/agents/scientist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnE,eAAO,MAAM,yBAAyB,EAAE,mBA8BvC,CAAC;AAiUF,eAAO,MAAM,cAAc,EAAE,WAO5B,CAAC"}

package/dist/agents/scientist.js

@@ -0,0 +1,370 @@
+/**
+ * Scientist Agent - Data Analysis & Research Execution
+ *
+ * Specialized agent for executing data analysis workflows using Python.
+ * Performs EDA, statistical analysis, and generates actionable findings.
+ *
+ * Enables:
+ * - Exploratory data analysis on CSV, JSON, Parquet files
+ * - Statistical computations and hypothesis testing
+ * - Data transformations and feature engineering
+ * - Generating structured findings with evidence
+ */
+export const SCIENTIST_PROMPT_METADATA = {
+    category: 'specialist',
+    cost: 'CHEAP',
+    promptAlias: 'scientist',
+    triggers: [
+        { domain: 'Data analysis', trigger: 'Analyzing datasets and computing statistics' },
+        { domain: 'Research execution', trigger: 'Running data experiments and generating findings' },
+        { domain: 'Python data work', trigger: 'Using pandas, numpy, scipy for data tasks' },
+        { domain: 'EDA', trigger: 'Exploratory data analysis on files' },
+        { domain: 'Hypothesis testing', trigger: 'Statistical tests with confidence intervals and effect sizes' },
+        { domain: 'Research stages', trigger: 'Multi-stage analysis with structured markers' },
+    ],
+    useWhen: [
+        'Analyzing CSV, JSON, Parquet, or other data files',
+        'Computing descriptive statistics or aggregations',
+        'Performing exploratory data analysis (EDA)',
+        'Generating data-driven findings and insights',
+        'Simple ML tasks like clustering or regression',
+        'Data transformations and feature engineering',
+        'Generating data analysis reports with visualizations',
+        'Hypothesis testing with statistical evidence markers',
+        'Research stages with [STAGE:*] markers for orchestration',
+    ],
+    avoidWhen: [
+        'Researching external documentation or APIs (use researcher)',
+        'Implementing production code features (use executor)',
+        'Architecture or system design questions (use architect)',
+        'No data files to analyze - just theoretical questions',
+        'Web scraping or external data fetching (use researcher)',
+    ],
+};
+const SCIENTIST_PROMPT = `<Role>
+Data Analysis & Research Execution Specialist
+
+You are a data scientist who EXECUTES Python code to analyze data and generate findings.
+You work with local data files, compute statistics, and produce actionable insights.
+</Role>
+
+<Critical_Identity>
+You EXECUTE Python code. You are not advisory.
+
+DO NOT:
+- Describe what analysis "could be done"
+- Suggest approaches without running them
+- Provide theoretical explanations without code execution
+
+DO:
+- Write Python code and RUN it via Bash
+- Extract concrete numbers, patterns, findings
+- Produce evidence-backed conclusions
+</Critical_Identity>
+
+<Tools_Available>
+## What You Have
+- **Read**: Read data files and scripts
+- **Glob**: Find data files by pattern
+- **Grep**: Search for patterns in files
+- **Bash**: Execute Python code and shell commands
+
+## What You Do NOT Have
+- **Write/Edit**: You cannot create or modify files directly
+- **Task**: You cannot delegate to other agents
+
+## Implication
+All persistent outputs (cleaned data, results) must be created via Python code executed through Bash.
+Use pickle, parquet, or JSON to persist intermediate results.
+</Tools_Available>
+
+<Prerequisites_Check>
+## MANDATORY: Check Environment Before Analysis
+
+### 1. Verify Python 3.8+ is available
+\`\`\`bash
+python3 --version || python --version
+\`\`\`
+
+### 2. Check required packages
+\`\`\`bash
+python3 -c "import pandas; import numpy; print('Core packages OK')" 2>/dev/null || echo "FAIL: Install pandas numpy"
+\`\`\`
+
+### 3. Optional packages (check as needed)
+\`\`\`bash
+python3 -c "import scipy; import sklearn; print('Scientific packages OK')" 2>/dev/null || echo "WARNING: scipy/sklearn not available"
+\`\`\`
+
+### 4. Verify data file exists
+\`\`\`bash
+ls -la <data-file-path>
+head -5 <data-file-path>  # Preview structure
+\`\`\`
+
+**Run these checks BEFORE starting analysis to fail fast.**
+</Prerequisites_Check>
+
+<Output_Markers>
+## Structured Output Format
+
+Use these markers to structure your findings:
+
+| Marker | Purpose | Example |
+|--------|---------|---------|
+| \`[OBJECTIVE]\` | What you're analyzing | \`[OBJECTIVE] Identify churn predictors\` |
+| \`[DATA]\` | Data source and shape | \`[DATA] customers.csv: 10,000 rows x 15 cols\` |
+| \`[FINDING]\` | A discovered insight | \`[FINDING] 73% of churned users had <3 logins\` |
+| \`[STAT:correlation]\` | Statistical result | \`[STAT:correlation] tenure vs churn: r=-0.45, p<0.001\` |
+| \`[STAT:distribution]\` | Distribution info | \`[STAT:distribution] age: mean=34.2, std=12.1, skew=0.3\` |
+| \`[STAT:test]\` | Hypothesis test | \`[STAT:test] t-test groups A/B: t=2.34, p=0.019\` |
+| \`[LIMITATION]\` | Caveat or constraint | \`[LIMITATION] 15% missing values in income column\` |
+
+### Example Output
+\`\`\`
+[OBJECTIVE] Analyze customer churn patterns
+
+[DATA] churn_data.csv: 7,043 rows x 21 columns
+[LIMITATION] 11 rows with missing TotalCharges (0.16%)
+
+[FINDING] Month-to-month contracts have 42.7% churn vs 11.3% for 2-year contracts
+[STAT:test] Chi-square test contract vs churn: χ²=849.3, p<0.001
+
+[FINDING] Customers without tech support churn at 2.1x the rate of those with support
+[STAT:correlation] TechSupport vs Churn: Cramér's V=0.31
+\`\`\`
+</Output_Markers>
+
+<State_Persistence>
+## Persisting Results Between Code Blocks
+
+Since you execute discrete Python scripts, persist state to files:
+
+### Pickle for DataFrames and objects
+\`\`\`python
+import pickle
+import pandas as pd
+
+# Save
+df_cleaned = df.dropna()
+with open('/tmp/analysis_state.pkl', 'wb') as f:
+    pickle.dump({'df': df_cleaned, 'stats': stats_dict}, f)
+
+# Load in next script
+with open('/tmp/analysis_state.pkl', 'rb') as f:
+    state = pickle.load(f)
+df = state['df']
+\`\`\`
+
+### Parquet for large DataFrames
+\`\`\`python
+# Save
+df.to_parquet('/tmp/cleaned_data.parquet')
+
+# Load
+df = pd.read_parquet('/tmp/cleaned_data.parquet')
+\`\`\`
+
+### JSON for simple results
+\`\`\`python
+import json
+
+# Save findings
+findings = {'correlation': 0.45, 'significant': True}
+with open('/tmp/findings.json', 'w') as f:
+    json.dump(findings, f)
+\`\`\`
+
+**Use /tmp/ for ephemeral analysis artifacts.**
+</State_Persistence>
+
+<Analysis_Workflow>
+## Four-Phase Analysis Process
+
+### Phase 1: Setup
+- Check prerequisites (Python, packages)
+- Locate and validate data files
+- Load data and check shape/dtypes
+
+### Phase 2: Explore (EDA)
+- Compute descriptive statistics
+- Check missing values and data quality
+- Identify outliers and distributions
+- Examine relationships between variables
+
+### Phase 3: Analyze
+- Run targeted statistical tests
+- Compute correlations and aggregations
+- Build simple models if applicable
+- Generate quantitative findings
+
+### Phase 4: Synthesize
+- Compile findings with markers
+- Note limitations and caveats
+- Provide actionable conclusions
+- Suggest next steps if appropriate
+
+### Phase 5: Report
+- Generate markdown report in .omc/scientist/reports/
+- Include visualizations saved in .omc/scientist/figures/
+- Executive summary at top
+- Detailed findings with statistics
+- Limitations and recommendations
+</Analysis_Workflow>
+
+<Python_Execution_Library>
+## Heredoc Patterns for Python Execution
+
+### Basic script execution
+\`\`\`bash
+python3 << 'EOF'
+import pandas as pd
+df = pd.read_csv('/path/to/data.csv')
+print(df.describe())
+EOF
+\`\`\`
+
+### With error handling
+\`\`\`bash
+python3 << 'EOF'
+import pandas as pd
+import sys
+
+try:
+    df = pd.read_csv('/path/to/data.csv')
+    print(f"Loaded {len(df)} rows")
+except FileNotFoundError:
+    print("ERROR: Data file not found", file=sys.stderr)
+    sys.exit(1)
+EOF
+\`\`\`
+
+### Multi-file analysis
+\`\`\`bash
+python3 << 'EOF'
+import pandas as pd
+from pathlib import Path
+
+data_dir = Path('/path/to/data')
+dfs = []
+for csv_file in data_dir.glob('*.csv'):
+    df = pd.read_csv(csv_file)
+    df['source'] = csv_file.stem
+    dfs.append(df)
+
+combined = pd.concat(dfs, ignore_index=True)
+print(f"Combined {len(dfs)} files: {len(combined)} total rows")
+EOF
+\`\`\`
+
+### Statistical analysis
+\`\`\`bash
+python3 << 'EOF'
+import pandas as pd
+import numpy as np
+from scipy import stats
+
+df = pd.read_csv('/path/to/data.csv')
+
+# Correlation
+corr, pval = stats.pearsonr(df['x'], df['y'])
+print(f"[STAT:correlation] x vs y: r={corr:.3f}, p={pval:.4f}")
+
+# T-test
+group_a = df[df['group'] == 'A']['value']
+group_b = df[df['group'] == 'B']['value']
+t_stat, p_val = stats.ttest_ind(group_a, group_b)
+print(f"[STAT:test] t-test A vs B: t={t_stat:.2f}, p={p_val:.4f}")
+EOF
+\`\`\`
+</Python_Execution_Library>
+
+<Output_Management>
+## Managing Python Output
+
+### NEVER dump raw data
+Bad:
+\`\`\`python
+print(df)  # Floods output with thousands of rows
+\`\`\`
+
+### Use summaries
+Good:
+\`\`\`python
+print(f"Shape: {df.shape}")
+print(f"Columns: {list(df.columns)}")
+print(df.describe())
+print(df.head(10))
+\`\`\`
+
+### Aggregate before printing
+\`\`\`python
+# Instead of printing all rows
+summary = df.groupby('category').agg({
+    'value': ['mean', 'std', 'count']
+}).round(2)
+print(summary)
+\`\`\`
+
+### Limit output size
+\`\`\`python
+# For large value_counts
+print(df['category'].value_counts().head(20))
+
+# For correlations
+corr_matrix = df.corr()
+# Show only strong correlations
+strong = corr_matrix[abs(corr_matrix) > 0.5]
+print(strong.stack().dropna())
+\`\`\`
+</Output_Management>
+
+<Anti_Patterns>
+NEVER:
+- Describe analysis without executing code
+- Print entire DataFrames to stdout
+- Skip prerequisite checks
+- Ignore missing values without noting them
+- Make claims without statistical evidence
+- Use Write/Edit tools (you don't have them)
+- Assume packages are installed without checking
+
+ALWAYS:
+- Execute Python via Bash heredocs
+- Use [MARKERS] for structured findings
+- Report actual numbers with context
+- Note data quality issues as [LIMITATION]
+- Check environment before analysis
+- Persist state via files for multi-step analysis
+</Anti_Patterns>
+
+<Quality_Standards>
+## Findings Must Be
+
+### Specific
+Bad: "There's a correlation between X and Y"
+Good: "[STAT:correlation] X vs Y: r=0.67, p<0.001, n=1,234"
+
+### Actionable
+Bad: "The data shows some patterns"
+Good: "[FINDING] Users with >5 sessions in week 1 have 3.2x higher retention - target onboarding to drive early engagement"
+
+### Contextualized
+Bad: "Mean value is 42.5"
+Good: "[STAT:distribution] revenue: mean=$42.50, median=$28.00, std=$67.20 (right-skewed, median more representative)"
+
+### Evidence-backed
+Every [FINDING] should reference:
+- Sample size
+- Statistical test or metric
+- Confidence level or p-value where applicable
+</Quality_Standards>`;
+export const scientistAgent = {
+    name: 'scientist',
+    description: 'Data analysis and research execution specialist. Executes Python code for EDA, statistical analysis, and generating data-driven findings. Works with CSV, JSON, Parquet files using pandas, numpy, scipy.',
+    prompt: SCIENTIST_PROMPT,
+    tools: ['Read', 'Glob', 'Grep', 'Bash', 'python_repl'],
+    model: 'sonnet',
+    metadata: SCIENTIST_PROMPT_METADATA
+};
+//# sourceMappingURL=scientist.js.map

package/dist/agents/scientist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scientist.js","sourceRoot":"","sources":["../../src/agents/scientist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAwB;IAC5D,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,WAAW;IACxB,QAAQ,EAAE;QACR,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,6CAA6C,EAAE;QACnF,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,kDAAkD,EAAE;QAC7F,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,2CAA2C,EAAE;QACpF,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,oCAAoC,EAAE;QAChE,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,8DAA8D,EAAE;QACzG,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,8CAA8C,EAAE;KACvF;IACD,OAAO,EAAE;QACP,mDAAmD;QACnD,kDAAkD;QAClD,4CAA4C;QAC5C,8CAA8C;QAC9C,+CAA+C;QAC/C,8CAA8C;QAC9C,sDAAsD;QACtD,sDAAsD;QACtD,0DAA0D;KAC3D;IACD,SAAS,EAAE;QACT,6DAA6D;QAC7D,sDAAsD;QACtD,yDAAyD;QACzD,uDAAuD;QACvD,yDAAyD;KAC1D;CACF,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA6TJ,CAAC;AAEtB,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,2MAA2M;IACxN,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC;IACtD,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,yBAAyB;CACpC,CAAC"}

package/dist/lib/atomic-write.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Atomic, durable file writes for oh-my-claudecode.
+ * Self-contained module with no external dependencies.
+ */
+/**
+ * Create directory recursively (inline implementation).
+ * Ensures parent directories exist before creating the target directory.
+ *
+ * @param dir Directory path to create
+ */
+export declare function ensureDirSync(dir: string): void;
+/**
+ * Write JSON data atomically to a file.
+ * Uses temp file + atomic rename pattern to ensure durability.
+ *
+ * @param filePath Target file path
+ * @param data Data to serialize as JSON
+ * @throws Error if JSON serialization fails or write operation fails
+ */
+export declare function atomicWriteJson(filePath: string, data: unknown): Promise<void>;
+/**
+ * Read and parse JSON file with error handling.
+ * Returns null if file doesn't exist or on parse errors.
+ *
+ * @param filePath Path to JSON file
+ * @returns Parsed JSON data or null on error
+ */
+export declare function safeReadJson<T>(filePath: string): Promise<T | null>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/lib/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/lib/atomic-write.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAe/C;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CpF;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAsBzE"}

package/dist/lib/atomic-write.js

@@ -0,0 +1,111 @@
+/**
+ * Atomic, durable file writes for oh-my-claudecode.
+ * Self-contained module with no external dependencies.
+ */
+import * as fs from 'fs/promises';
+import * as fsSync from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+/**
+ * Create directory recursively (inline implementation).
+ * Ensures parent directories exist before creating the target directory.
+ *
+ * @param dir Directory path to create
+ */
+export function ensureDirSync(dir) {
+    if (fsSync.existsSync(dir)) {
+        return;
+    }
+    try {
+        fsSync.mkdirSync(dir, { recursive: true });
+    }
+    catch (err) {
+        // If directory was created by another process between exists check and mkdir,
+        // that's fine - verify it exists now
+        if (err.code === 'EEXIST') {
+            return;
+        }
+        throw err;
+    }
+}
+/**
+ * Write JSON data atomically to a file.
+ * Uses temp file + atomic rename pattern to ensure durability.
+ *
+ * @param filePath Target file path
+ * @param data Data to serialize as JSON
+ * @throws Error if JSON serialization fails or write operation fails
+ */
+export async function atomicWriteJson(filePath, data) {
+    const dir = path.dirname(filePath);
+    const base = path.basename(filePath);
+    const tempPath = path.join(dir, `.${base}.tmp.${crypto.randomUUID()}`);
+    let success = false;
+    try {
+        // Ensure parent directory exists
+        ensureDirSync(dir);
+        // Serialize data to JSON
+        const jsonContent = JSON.stringify(data, null, 2);
+        // Write to temp file with exclusive creation (wx = O_CREAT | O_EXCL | O_WRONLY)
+        const fd = await fs.open(tempPath, 'wx', 0o600);
+        try {
+            await fd.write(jsonContent, 0, 'utf-8');
+            // Sync file data to disk before rename
+            await fd.sync();
+        }
+        finally {
+            await fd.close();
+        }
+        // Atomic rename - replaces target file if it exists
+        // On Windows, fs.rename uses MoveFileExW with MOVEFILE_REPLACE_EXISTING
+        await fs.rename(tempPath, filePath);
+        success = true;
+        // Best-effort directory fsync to ensure rename is durable
+        try {
+            const dirFd = await fs.open(dir, 'r');
+            try {
+                await dirFd.sync();
+            }
+            finally {
+                await dirFd.close();
+            }
+        }
+        catch {
+            // Some platforms don't support directory fsync - that's okay
+        }
+    }
+    finally {
+        // Clean up temp file on error
+        if (!success) {
+            await fs.unlink(tempPath).catch(() => { });
+        }
+    }
+}
+/**
+ * Read and parse JSON file with error handling.
+ * Returns null if file doesn't exist or on parse errors.
+ *
+ * @param filePath Path to JSON file
+ * @returns Parsed JSON data or null on error
+ */
+export async function safeReadJson(filePath) {
+    try {
+        // Check if file exists
+        await fs.access(filePath);
+        // Read file content
+        const content = await fs.readFile(filePath, 'utf-8');
+        // Parse JSON
+        return JSON.parse(content);
+    }
+    catch (err) {
+        const error = err;
+        // File doesn't exist - return null
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        // Parse error or read error - return null
+        // In production, you might want to log these errors
+        return null;
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/lib/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/lib/atomic-write.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,IAAI,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8EAA8E;QAC9E,qCAAqC;QACrC,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO;QACT,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAa;IACnE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,QAAQ,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEvE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,IAAI,CAAC;QACH,iCAAiC;QACjC,aAAa,CAAC,GAAG,CAAC,CAAC;QAEnB,yBAAyB;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAElD,gFAAgF;QAChF,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YACxC,uCAAuC;YACvC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QAED,oDAAoD;QACpD,wEAAwE;QACxE,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEpC,OAAO,GAAG,IAAI,CAAC;QAEf,0DAA0D;QAC1D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACrB,CAAC;oBAAS,CAAC;gBACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;IACH,CAAC;YAAS,CAAC;QACT,8BAA8B;QAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,IAAI,CAAC;QACH,uBAAuB;QACvB,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE1B,oBAAoB;QACpB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAErD,aAAa;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAA4B,CAAC;QAE3C,mCAAmC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,0CAA0C;QAC1C,oDAAoD;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -7,6 +7,7 @@
 import { z } from 'zod';
 export { lspTools } from './lsp-tools.js';
 export { astTools } from './ast-tools.js';
+export { pythonReplTool } from './python-repl/index.js';
 /**
  * Generic tool definition type
  */

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACzF;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,qBAAqB,EAGjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,qBAAqB,EAAE,CAS3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAElF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,qBAAqB,GAAG,aAAa,CAS1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACzF;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,qBAAqB,EAIjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,qBAAqB,EAAE,CAS3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAElF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,qBAAqB,GAAG,aAAa,CAS1E"}

package/dist/tools/index.js

@@ -7,14 +7,17 @@
 import { z } from 'zod';
 import { lspTools } from './lsp-tools.js';
 import { astTools } from './ast-tools.js';
+import { pythonReplTool } from './python-repl/index.js';
 export { lspTools } from './lsp-tools.js';
 export { astTools } from './ast-tools.js';
+export { pythonReplTool } from './python-repl/index.js';
 /**
  * All custom tools available in the system
  */
 export const allCustomTools = [
     ...lspTools,
-    ...astTools
+    ...astTools,
+    pythonReplTool
 ];
 /**
  * Get tools by category

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAY1C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,GAAG,QAA8C;IACjD,GAAG,QAA8C;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAA+B;IAChE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,KAAK;YACR,OAAO,QAA8C,CAAC;QACxD,KAAK,KAAK;YACR,OAAO,QAA8C,CAAC;QACxD,KAAK,KAAK;YACR,OAAO,cAAc,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAA0B,MAAS;IAChE,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAeD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAA2B;IACzD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAE9C,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,MAAkC;IAKzD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,KAAqB,CAAC;QACtC,UAAU,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAE/C,gDAAgD;QAChD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAqB;IAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,0BAA0B;IAC1B,IAAI,OAAO,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1D,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+BAA+B;IAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;IAC7C,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;IAED,qBAAqB;IACrB,IAAI,OAAO,YAAY,CAAC,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;IACzB,CAAC;SAAM,IAAI,OAAO,YAAY,CAAC,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC;YAChF,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,QAAQ,CAAC;IACf,CAAC;SAAM,IAAI,OAAO,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC;IAC1B,CAAC;SAAM,IAAI,OAAO,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC;QACtB,MAAM,CAAC,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,OAAO,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;QACvB,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IACpC,CAAC;SAAM,IAAI,OAAO,YAAY,CAAC,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,6BAA6B;QAC7B,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/python-repl/bridge-manager.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Bridge Manager - Python process lifecycle management
+ *
+ * Manages the gyoshu_bridge.py process:
+ * - Spawning with proper environment detection
+ * - Ensuring single bridge per session with security validations
+ * - Graceful shutdown with signal escalation
+ * - PID reuse detection via process identity verification
+ */
+import { BridgeMeta } from './types.js';
+export interface EscalationResult {
+    terminated: boolean;
+    terminatedBy?: 'SIGINT' | 'SIGTERM' | 'SIGKILL';
+    terminationTimeMs?: number;
+}
+/**
+ * Verify that a bridge process is still running and is the same process
+ * that was originally spawned (guards against PID reuse).
+ *
+ * Returns false if:
+ * - Process is not alive
+ * - Start time was recorded but doesn't match (PID reused)
+ * - Start time was recorded but cannot be retrieved (fail-closed)
+ */
+export declare function verifyProcessIdentity(meta: BridgeMeta): Promise<boolean>;
+/**
+ * Spawn a new bridge server process for the given session.
+ *
+ * @param sessionId - Unique session identifier
+ * @param projectDir - Optional project directory (defaults to cwd)
+ * @returns BridgeMeta containing process information
+ */
+export declare function spawnBridgeServer(sessionId: string, projectDir?: string): Promise<BridgeMeta>;
+/**
+ * Get or spawn a bridge server for the session.
+ *
+ * Implements security validations:
+ * - Anti-poisoning: Verifies sessionId in metadata matches expected
+ * - Anti-hijack: Verifies socketPath is the expected canonical path
+ * - Socket type: Verifies the socket path is actually a socket
+ * - Process identity: Verifies PID + start time match
+ *
+ * @param sessionId - Unique session identifier
+ * @param projectDir - Optional project directory (defaults to cwd)
+ * @returns BridgeMeta for the active bridge
+ */
+export declare function ensureBridge(sessionId: string, projectDir?: string): Promise<BridgeMeta>;
+/**
+ * Terminate a bridge process with signal escalation.
+ *
+ * Escalation order:
+ * 1. SIGINT - wait gracePeriodMs (default 5000ms)
+ * 2. SIGTERM - wait 2500ms
+ * 3. SIGKILL - immediate termination
+ *
+ * Uses process group kill (-pid) to also terminate child processes.
+ *
+ * @param sessionId - Session whose bridge to kill
+ * @param options - Optional configuration
+ * @returns EscalationResult with termination details
+ */
+export declare function killBridgeWithEscalation(sessionId: string, options?: {
+    gracePeriodMs?: number;
+}): Promise<EscalationResult>;
+//# sourceMappingURL=bridge-manager.d.ts.map

package/dist/tools/python-repl/bridge-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-manager.d.ts","sourceRoot":"","sources":["../../../src/tools/python-repl/bridge-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAkBvD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAwID;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAsB9E;AAqFD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAqFrB;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAuC9F;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAoE3B"}