cc-resilient 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SaravananJaichandar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,160 @@
+# cc-resilient
+
+Network-resilient wrapper for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI.
+
+Built as a working prototype for [anthropics/claude-code#26729](https://github.com/anthropics/claude-code/issues/26729) -- a proposal for native streaming resilience in Claude Code.
+
+## Problem
+
+When using Claude Code over unstable connections (Wi-Fi drops, power cuts, VPN disconnects, mobile hotspot switching), active sessions hang silently with no timeout, no recovery, and no graceful handling. The only option is to kill the process and manually restart.
+
+## What cc-resilient does
+
+`cc-resilient` wraps the `claude` CLI and adds three capabilities:
+
+1. **Network monitoring** -- pings `api.anthropic.com` every 5 seconds to detect connectivity loss
+2. **Hang detection** -- identifies stalled processes with no output for a configurable timeout
+3. **Automatic recovery** -- kills hung processes, saves session metadata, and resumes with context when connectivity returns
+
+## Install
+
+```bash
+npm install -g cc-resilient
+```
+
+**Prerequisite**: Claude Code must be installed and authenticated (`claude` command available in PATH).
+
+## Quick start
+
+```bash
+# Use exactly like claude, but with network resilience
+cc-resilient -- "explain this project"
+
+# Print mode
+cc-resilient -- -p "refactor the auth module"
+
+# Continue a session with resilience
+cc-resilient -- --continue
+
+# Interactive mode (stdin passed through)
+cc-resilient
+
+# Disable auto-resume (ask before resuming)
+cc-resilient --no-auto-resume -- -p "build feature X"
+
+# Verbose mode (see network status on stderr)
+cc-resilient --verbose -- -p "hello"
+
+# Check last recovery state
+cc-resilient --status
+```
+
+## How it works
+
+```
+                 cc-resilient
+                      |
+        +-------------+-------------+
+        |             |             |
+  Network Monitor  Process Monitor  Session Tracker
+   (ping every 5s)  (track stdout)   (find session ID)
+        |             |             |
+        +------+------+             |
+               |                    |
+         Recovery Manager  <--------+
+          (orchestrate disconnect/reconnect/resume)
+```
+
+1. `cc-resilient` spawns `claude` as a child process
+2. In parallel, it pings `api.anthropic.com` every 5 seconds (HTTPS HEAD)
+3. If 3 consecutive pings fail, it declares the connection offline
+4. It gracefully kills the hung claude process (SIGTERM, then SIGKILL after 5s)
+5. It saves recovery metadata to `~/.cc-resilient/recovery.json`
+6. When 2 consecutive pings succeed, it declares the connection restored
+7. It resumes the session: `claude --continue -p "You were interrupted by a network disconnection..."`
+
+## Configuration
+
+### CLI flags
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--health-interval <ms>` | 5000 | How often to check connectivity |
+| `--health-timeout <ms>` | 3000 | Timeout per health check |
+| `--hang-timeout <ms>` | 300000 | No-output duration before declaring a hang (5 min) |
+| `--no-auto-resume` | false | Ask before resuming instead of auto-resume |
+| `--max-resumes <n>` | 3 | Give up after N consecutive resume failures |
+| `--resume-prompt <text>` | (see below) | Custom text for the resume context message |
+| `--log-file <path>` | null | Write structured logs to a file |
+| `--verbose` | false | Show detailed status on stderr |
+| `--config <path>` | `~/.cc-resilient.json` | Path to config file |
+| `--status` | - | Print last recovery state and exit |
+
+### Config file
+
+Create `~/.cc-resilient.json` with any of these options:
+
+```json
+{
+  "healthCheckIntervalMs": 5000,
+  "healthCheckTimeoutMs": 3000,
+  "healthCheckEndpoint": "https://api.anthropic.com",
+  "offlineThreshold": 3,
+  "reconnectStabilityCount": 2,
+  "processHangTimeoutMs": 300000,
+  "gracefulShutdownTimeoutMs": 5000,
+  "autoResume": true,
+  "autoResumeDelayMs": 2000,
+  "maxResumeAttempts": 3,
+  "verbose": false
+}
+```
+
+All fields are optional. Missing fields use defaults.
+
+## Limitations
+
+This is an external wrapper, not a native feature. It can solve some problems but not all:
+
+| What it can do | What it cannot do |
+|----------------|-------------------|
+| Detect network loss (via periodic pings) | See the SSE stream directly (instant detection) |
+| Kill hung processes | Save partial streaming responses |
+| Auto-resume sessions with context | Know exactly which tool was mid-execution |
+| Save recovery metadata to disk | Repair corrupted conversation state (orphaned tool_use blocks) |
+| Work with both interactive and print modes | Selectively retry safe vs unsafe tools |
+
+The remaining ~60% of the proposed functionality requires native support inside Claude Code. See the [full feature request](https://github.com/anthropics/claude-code/issues/26729) for the complete design.
+
+## Recovery metadata
+
+On disconnect, `cc-resilient` saves state to `~/.cc-resilient/recovery.json`:
+
+```json
+{
+  "sessionId": "fdbee89f-40d1-483c-b33b-b4305d924d84",
+  "workingDirectory": "/home/user/project",
+  "timestamp": "2026-02-23T13:45:00.000Z",
+  "lastActivityTimestamp": "2026-02-23T13:44:55.000Z",
+  "disconnectReason": "network",
+  "claudeArgs": ["-p", "build the auth module"],
+  "pid": 12345,
+  "resumeCount": 0
+}
+```
+
+This persists even if `cc-resilient` itself crashes, so you can inspect what happened and manually resume.
+
+## Development
+
+```bash
+git clone https://github.com/SaravananJaichandar/cc-resilient.git
+cd cc-resilient
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function createCli(): Command;

package/dist/src/cli.js

@@ -0,0 +1,74 @@
+import { Command } from 'commander';
+import { loadConfig } from './config.js';
+import { CcResilientWrapper } from './wrapper.js';
+import { RecoveryManager } from './recovery-manager.js';
+export function createCli() {
+    const program = new Command();
+    program
+        .name('cc-resilient')
+        .description('Network-resilient wrapper for Claude Code CLI')
+        .version('0.1.0')
+        .option('--health-interval <ms>', 'Health check interval in ms', '5000')
+        .option('--health-timeout <ms>', 'Health check timeout in ms', '3000')
+        .option('--hang-timeout <ms>', 'Process hang timeout in ms', '300000')
+        .option('--no-auto-resume', 'Disable automatic resume on reconnect')
+        .option('--max-resumes <n>', 'Maximum resume attempts', '3')
+        .option('--resume-prompt <text>', 'Custom prompt for resume context')
+        .option('--log-file <path>', 'Write logs to file')
+        .option('--verbose', 'Enable verbose output', false)
+        .option('--config <path>', 'Path to config file')
+        .option('--status', 'Show last recovery state and exit')
+        .allowUnknownOption(true)
+        .argument('[claude-args...]', 'Arguments to pass through to claude')
+        .action(async (claudeArgs, options) => {
+        if (options.status) {
+            showStatus();
+            return;
+        }
+        const cliOverrides = {};
+        if (options.healthInterval !== '5000') {
+            cliOverrides.healthCheckIntervalMs = parseInt(options.healthInterval, 10);
+        }
+        if (options.healthTimeout !== '3000') {
+            cliOverrides.healthCheckTimeoutMs = parseInt(options.healthTimeout, 10);
+        }
+        if (options.hangTimeout !== '300000') {
+            cliOverrides.processHangTimeoutMs = parseInt(options.hangTimeout, 10);
+        }
+        if (options.autoResume === false) {
+            cliOverrides.autoResume = false;
+        }
+        if (options.maxResumes !== '3') {
+            cliOverrides.maxResumeAttempts = parseInt(options.maxResumes, 10);
+        }
+        if (options.resumePrompt) {
+            cliOverrides.resumePrompt = options.resumePrompt;
+        }
+        if (options.logFile) {
+            cliOverrides.logFile = options.logFile;
+        }
+        if (options.verbose) {
+            cliOverrides.verbose = true;
+        }
+        const config = loadConfig(cliOverrides, options.config);
+        const wrapper = new CcResilientWrapper(claudeArgs, config);
+        const exitCode = await wrapper.run();
+        process.exit(exitCode);
+    });
+    return program;
+}
+function showStatus() {
+    const metadata = RecoveryManager.loadRecoveryMetadata();
+    if (!metadata) {
+        process.stderr.write('[cc-resilient] No recovery data found.\n');
+        return;
+    }
+    process.stderr.write('[cc-resilient] Last recovery state:\n');
+    process.stderr.write(`  Session ID:   ${metadata.sessionId ?? 'unknown'}\n`);
+    process.stderr.write(`  Directory:    ${metadata.workingDirectory}\n`);
+    process.stderr.write(`  Disconnected: ${metadata.timestamp}\n`);
+    process.stderr.write(`  Reason:       ${metadata.disconnectReason}\n`);
+    process.stderr.write(`  Resumes:      ${metadata.resumeCount}\n`);
+    process.stderr.write(`  Args:         ${metadata.claudeArgs.join(' ')}\n`);
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,cAAc,CAAC;SACpB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,CAAC;SACvE,MAAM,CAAC,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,CAAC;SACrE,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,EAAE,QAAQ,CAAC;SACrE,MAAM,CAAC,kBAAkB,EAAE,uCAAuC,CAAC;SACnE,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,EAAE,GAAG,CAAC;SAC3D,MAAM,CAAC,wBAAwB,EAAE,kCAAkC,CAAC;SACpE,MAAM,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;SACjD,MAAM,CAAC,WAAW,EAAE,uBAAuB,EAAE,KAAK,CAAC;SACnD,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;SAChD,MAAM,CAAC,UAAU,EAAE,mCAAmC,CAAC;SACvD,kBAAkB,CAAC,IAAI,CAAC;SACxB,QAAQ,CAAC,kBAAkB,EAAE,qCAAqC,CAAC;SACnE,MAAM,CAAC,KAAK,EAAE,UAAoB,EAAE,OAAO,EAAE,EAAE;QAC9C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,UAAU,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAA+B,EAAE,CAAC;QAEpD,IAAI,OAAO,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;YACtC,YAAY,CAAC,qBAAqB,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;YACrC,YAAY,CAAC,oBAAoB,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACrC,YAAY,CAAC,oBAAoB,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YACjC,YAAY,CAAC,UAAU,GAAG,KAAK,CAAC;QAClC,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YAC/B,YAAY,CAAC,iBAAiB,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,YAAY,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACnD,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACzC,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,QAAQ,GAAG,eAAe,CAAC,oBAAoB,EAAE,CAAC;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,QAAQ,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC,CAAC;IAC7E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,QAAQ,CAAC,gBAAgB,IAAI,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,QAAQ,CAAC,SAAS,IAAI,CAAC,CAAC;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,QAAQ,CAAC,gBAAgB,IAAI,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC;IAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,4 @@
+import type { CcResilientConfig } from './types.js';
+declare const DEFAULT_CONFIG: CcResilientConfig;
+export declare function loadConfig(cliOverrides?: Partial<CcResilientConfig>, configPath?: string): CcResilientConfig;
+export { DEFAULT_CONFIG };

package/dist/src/config.js

@@ -0,0 +1,62 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const DEFAULT_CONFIG = {
+    healthCheckIntervalMs: 5000,
+    healthCheckTimeoutMs: 3000,
+    healthCheckEndpoint: 'https://api.anthropic.com',
+    offlineThreshold: 3,
+    reconnectStabilityCount: 2,
+    processHangTimeoutMs: 300000,
+    gracefulShutdownTimeoutMs: 5000,
+    autoResume: true,
+    autoResumeDelayMs: 2000,
+    maxResumeAttempts: 3,
+    resumePrompt: 'You were interrupted by a network disconnection at {timestamp}. Your session has been automatically resumed. Please continue from where you left off. If you were in the middle of a multi-step task, summarize what you have completed so far and continue.',
+    logFile: null,
+    verbose: false,
+};
+function loadConfigFile(configPath) {
+    const filePath = configPath ?? join(homedir(), '.cc-resilient.json');
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function validateConfig(config) {
+    if (config.healthCheckIntervalMs <= 0)
+        throw new Error('healthCheckIntervalMs must be positive');
+    if (config.healthCheckTimeoutMs <= 0)
+        throw new Error('healthCheckTimeoutMs must be positive');
+    if (config.offlineThreshold < 1)
+        throw new Error('offlineThreshold must be at least 1');
+    if (config.reconnectStabilityCount < 1)
+        throw new Error('reconnectStabilityCount must be at least 1');
+    if (config.processHangTimeoutMs <= 0)
+        throw new Error('processHangTimeoutMs must be positive');
+    if (config.gracefulShutdownTimeoutMs <= 0)
+        throw new Error('gracefulShutdownTimeoutMs must be positive');
+    if (config.maxResumeAttempts < 1)
+        throw new Error('maxResumeAttempts must be at least 1');
+    try {
+        new URL(config.healthCheckEndpoint);
+    }
+    catch {
+        throw new Error('healthCheckEndpoint must be a valid URL');
+    }
+}
+export function loadConfig(cliOverrides = {}, configPath) {
+    const fileConfig = loadConfigFile(configPath);
+    const merged = {
+        ...DEFAULT_CONFIG,
+        ...fileConfig,
+        ...cliOverrides,
+    };
+    validateConfig(merged);
+    return merged;
+}
+export { DEFAULT_CONFIG };
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,cAAc,GAAsB;IACxC,qBAAqB,EAAE,IAAI;IAC3B,oBAAoB,EAAE,IAAI;IAC1B,mBAAmB,EAAE,2BAA2B;IAChD,gBAAgB,EAAE,CAAC;IACnB,uBAAuB,EAAE,CAAC;IAC1B,oBAAoB,EAAE,MAAM;IAC5B,yBAAyB,EAAE,IAAI;IAC/B,UAAU,EAAE,IAAI;IAChB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,CAAC;IACpB,YAAY,EACV,8PAA8P;IAChQ,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,KAAK;CACf,CAAC;AAEF,SAAS,cAAc,CAAC,UAAmB;IACzC,MAAM,QAAQ,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,oBAAoB,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA+B,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,MAAyB;IAC/C,IAAI,MAAM,CAAC,qBAAqB,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACjG,IAAI,MAAM,CAAC,oBAAoB,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC/F,IAAI,MAAM,CAAC,gBAAgB,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,uBAAuB,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACtG,IAAI,MAAM,CAAC,oBAAoB,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC/F,IAAI,MAAM,CAAC,yBAAyB,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACzG,IAAI,MAAM,CAAC,iBAAiB,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1F,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,eAA2C,EAAE,EAC7C,UAAmB;IAEnB,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAsB;QAChC,GAAG,cAAc;QACjB,GAAG,UAAU;QACb,GAAG,YAAY;KAChB,CAAC;IACF,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createCli } from './cli.js';
+const program = createCli();
+program.parseAsync(process.argv).catch((err) => {
+    process.stderr.write(`[cc-resilient] Fatal error: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;AAC5B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/logger.d.ts

@@ -0,0 +1,10 @@
+export declare class Logger {
+    private logFile;
+    private verbose;
+    constructor(logFile: string | null, verbose: boolean);
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+    private write;
+}

package/dist/src/logger.js

@@ -0,0 +1,48 @@
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+export class Logger {
+    logFile;
+    verbose;
+    constructor(logFile, verbose) {
+        this.logFile = logFile;
+        this.verbose = verbose;
+        if (this.logFile) {
+            mkdirSync(dirname(this.logFile), { recursive: true });
+        }
+    }
+    info(message, data) {
+        this.write('INFO', message, data);
+    }
+    warn(message, data) {
+        this.write('WARN', message, data);
+    }
+    error(message, data) {
+        this.write('ERROR', message, data);
+    }
+    debug(message, data) {
+        if (this.verbose) {
+            this.write('DEBUG', message, data);
+        }
+    }
+    write(level, message, data) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            ...data,
+        };
+        if (this.logFile) {
+            appendFileSync(this.logFile, JSON.stringify(entry) + '\n');
+        }
+        if (this.verbose || level === 'ERROR' || level === 'WARN') {
+            const prefix = level === 'ERROR' ? '\x1b[31m' : level === 'WARN' ? '\x1b[33m' : '\x1b[90m';
+            const reset = '\x1b[0m';
+            const isTTY = process.stderr.isTTY;
+            const line = isTTY
+                ? `${prefix}[cc-resilient] ${level}: ${message}${reset}\n`
+                : `[cc-resilient] ${level}: ${message}\n`;
+            process.stderr.write(line);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,MAAM;IACT,OAAO,CAAgB;IACvB,OAAO,CAAU;IAEzB,YAAY,OAAsB,EAAE,OAAgB;QAClD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,KAAa,EAAE,OAAe,EAAE,IAA8B;QAC1E,MAAM,KAAK,GAAG;YACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,OAAO;YACP,GAAG,IAAI;SACR,CAAC;QAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1D,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;YAC3F,MAAM,KAAK,GAAG,SAAS,CAAC;YACxB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YACnC,MAAM,IAAI,GAAG,KAAK;gBAChB,CAAC,CAAC,GAAG,MAAM,kBAAkB,KAAK,KAAK,OAAO,GAAG,KAAK,IAAI;gBAC1D,CAAC,CAAC,kBAAkB,KAAK,KAAK,OAAO,IAAI,CAAC;YAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CACF"}

package/dist/src/network-monitor.d.ts

@@ -0,0 +1,18 @@
+import { EventEmitter } from 'node:events';
+import { ConnectionState } from './types.js';
+import type { CcResilientConfig, NetworkCheckResult } from './types.js';
+import type { Logger } from './logger.js';
+export declare class NetworkMonitor extends EventEmitter {
+    private config;
+    private logger;
+    private intervalHandle;
+    private consecutiveFailures;
+    private consecutiveSuccesses;
+    private state;
+    constructor(config: Pick<CcResilientConfig, 'healthCheckIntervalMs' | 'healthCheckTimeoutMs' | 'healthCheckEndpoint' | 'offlineThreshold' | 'reconnectStabilityCount'>, logger: Logger);
+    start(): void;
+    stop(): void;
+    getState(): ConnectionState;
+    checkOnce(): Promise<NetworkCheckResult>;
+    private updateState;
+}

package/dist/src/network-monitor.js

@@ -0,0 +1,110 @@
+import { EventEmitter } from 'node:events';
+import https from 'node:https';
+import { ConnectionState } from './types.js';
+export class NetworkMonitor extends EventEmitter {
+    config;
+    logger;
+    intervalHandle = null;
+    consecutiveFailures = 0;
+    consecutiveSuccesses = 0;
+    state = ConnectionState.ONLINE;
+    constructor(config, logger) {
+        super();
+        this.config = config;
+        this.logger = logger;
+    }
+    start() {
+        if (this.intervalHandle)
+            return;
+        this.logger.debug('Network monitor started', {
+            interval: this.config.healthCheckIntervalMs,
+            endpoint: this.config.healthCheckEndpoint,
+        });
+        this.intervalHandle = setInterval(() => {
+            this.checkOnce().catch((err) => {
+                this.logger.error('Health check error', { error: String(err) });
+            });
+        }, this.config.healthCheckIntervalMs);
+    }
+    stop() {
+        if (this.intervalHandle) {
+            clearInterval(this.intervalHandle);
+            this.intervalHandle = null;
+            this.logger.debug('Network monitor stopped');
+        }
+    }
+    getState() {
+        return this.state;
+    }
+    async checkOnce() {
+        const start = Date.now();
+        const url = new URL(this.config.healthCheckEndpoint);
+        const result = await new Promise((resolve) => {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.config.healthCheckTimeoutMs);
+            const req = https.request({
+                hostname: url.hostname,
+                port: 443,
+                path: '/',
+                method: 'HEAD',
+                signal: controller.signal,
+            }, () => {
+                clearTimeout(timeout);
+                resolve({
+                    ok: true,
+                    latencyMs: Date.now() - start,
+                    timestamp: new Date().toISOString(),
+                });
+            });
+            req.on('error', (err) => {
+                clearTimeout(timeout);
+                resolve({
+                    ok: false,
+                    latencyMs: Date.now() - start,
+                    error: err.message,
+                    timestamp: new Date().toISOString(),
+                });
+            });
+            req.end();
+        });
+        this.emit('check', result);
+        this.updateState(result);
+        return result;
+    }
+    updateState(result) {
+        const oldState = this.state;
+        if (result.ok) {
+            this.consecutiveFailures = 0;
+            this.consecutiveSuccesses++;
+            if (this.state === ConnectionState.OFFLINE || this.state === ConnectionState.RECONNECTING) {
+                if (this.consecutiveSuccesses >= this.config.reconnectStabilityCount) {
+                    this.state = ConnectionState.ONLINE;
+                }
+                else {
+                    this.state = ConnectionState.RECONNECTING;
+                }
+            }
+            else {
+                this.state = ConnectionState.ONLINE;
+            }
+        }
+        else {
+            this.consecutiveSuccesses = 0;
+            this.consecutiveFailures++;
+            if (this.consecutiveFailures >= this.config.offlineThreshold) {
+                this.state = ConnectionState.OFFLINE;
+            }
+            else if (this.consecutiveFailures > 0) {
+                this.state = ConnectionState.DEGRADED;
+            }
+        }
+        if (oldState !== this.state) {
+            this.logger.info(`Network state: ${oldState} -> ${this.state}`, {
+                consecutiveFailures: this.consecutiveFailures,
+                consecutiveSuccesses: this.consecutiveSuccesses,
+            });
+            this.emit('stateChange', oldState, this.state);
+        }
+    }
+}
+//# sourceMappingURL=network-monitor.js.map

package/dist/src/network-monitor.js.map

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

package/dist/src/process-monitor.d.ts

@@ -0,0 +1,21 @@
+import { EventEmitter } from 'node:events';
+import { type ChildProcess } from 'node:child_process';
+import type { CcResilientConfig } from './types.js';
+import type { Logger } from './logger.js';
+export declare class ProcessMonitor extends EventEmitter {
+    private config;
+    private logger;
+    private childProcess;
+    private lastActivityTimestamp;
+    private hangCheckInterval;
+    private isInteractive;
+    constructor(config: Pick<CcResilientConfig, 'processHangTimeoutMs' | 'gracefulShutdownTimeoutMs'>, logger: Logger);
+    spawnClaude(args: string[]): ChildProcess;
+    gracefulKill(): Promise<void>;
+    isAlive(): boolean;
+    getLastActivity(): number;
+    getPid(): number | undefined;
+    getIsInteractive(): boolean;
+    private startHangDetection;
+    private stopHangDetection;
+}