jonsoc 1.1.43

package/AGENTS.md

@@ -0,0 +1,27 @@
+# jonsoc agent guidelines
+
+## Build/Test Commands
+
+- **Install**: `bun install`
+- **Run**: `bun run --conditions=browser ./src/index.ts`
+- **Typecheck**: `bun run typecheck` (npm run typecheck)
+- **Test**: `bun test` (runs all tests)
+- **Single test**: `bun test test/tool/tool.test.ts` (specific test file)
+
+## Code Style
+
+- **Runtime**: Bun with TypeScript ESM modules
+- **Imports**: Use relative imports for local modules, named imports preferred
+- **Types**: Zod schemas for validation, TypeScript interfaces for structure
+- **Naming**: camelCase for variables/functions, PascalCase for classes/namespaces
+- **Error handling**: Use Result patterns, avoid throwing exceptions in tools
+- **File structure**: Namespace-based organization (e.g., `Tool.define()`, `Session.create()`)
+
+## Architecture
+
+- **Tools**: Implement `Tool.Info` interface with `execute()` method
+- **Context**: Pass `sessionID` in tool context, use `App.provide()` for DI
+- **Validation**: All inputs validated with Zod schemas
+- **Logging**: Use `Log.create({ service: "name" })` pattern
+- **Storage**: Use `Storage` namespace for persistence
+- **API Client**: The TypeScript TUI (built with SolidJS + OpenTUI) communicates with the JonsOC server using `@jonsoc/sdk`. When adding/modifying server endpoints in `packages/jonsoc/src/server/server.ts`, run `./script/generate.ts` to regenerate the SDK and related files.

package/Dockerfile

@@ -0,0 +1,18 @@
+FROM alpine AS base
+
+# Disable the runtime transpiler cache by default inside Docker containers.
+# On ephemeral containers, the cache is not useful
+ARG BUN_RUNTIME_TRANSPILER_CACHE_PATH=0
+ENV BUN_RUNTIME_TRANSPILER_CACHE_PATH=${BUN_RUNTIME_TRANSPILER_CACHE_PATH}
+RUN apk add libgcc libstdc++ ripgrep
+
+FROM base AS build-amd64
+COPY dist/opencode-linux-x64-baseline-musl/bin/opencode /usr/local/bin/opencode
+
+FROM base AS build-arm64
+COPY dist/opencode-linux-arm64-musl/bin/opencode /usr/local/bin/opencode
+
+ARG TARGETARCH
+FROM build-${TARGETARCH}
+RUN opencode --version
+ENTRYPOINT ["opencode"]

package/PUBLISHING_GUIDE.md

@@ -0,0 +1,151 @@
+# Publishing jonsOC to npm
+
+This guide explains how to publish jonsOC as a global npm package that users can install with `bun add -g jonsoc` or `npm install -g jonsoc`.
+
+## Changes Made
+
+1. **Removed `"private": true`** from `package.json` to allow publishing
+2. **Updated package name** in publish script from "jonsoc" to "jonsoc"
+3. **Added npm metadata** (description, keywords, repository, etc.) for better discoverability
+4. **Updated README** with installation and usage instructions
+
+## How It Works
+
+jonsOC uses a multi-package distribution strategy (similar to esbuild, Parcel, etc.):
+
+1. **Main package (`jonsoc`)**: Contains the wrapper script that users install
+2. **Platform-specific packages**: Compiled binaries for each platform:
+   - `jonsoc-linux-x64`
+   - `jonsoc-darwin-arm64`
+   - `jonsoc-windows-x64`
+
+When users install `jonsoc`, npm automatically installs the correct platform-specific binary as an optional dependency.
+
+## Prerequisites
+
+Before publishing, make sure you:
+
+1. **Have an npm account**: Sign up at https://www.npmjs.com
+2. **Are logged in to npm**:
+   ```bash
+   npm login
+   ```
+3. **Check package name availability**:
+   ```bash
+   npm view jonsoc
+   ```
+   If the package exists and isn't yours, you'll need to choose a different name.
+
+## Publishing Steps
+
+### 1. Build all platform binaries
+
+```bash
+cd packages/jonsoc
+bun run build
+```
+
+This creates compiled binaries for all supported platforms in the `dist/` directory.
+
+### 2. Test locally (optional but recommended)
+
+Build for your current platform only:
+
+```bash
+bun run build -- --single
+```
+
+Test the binary:
+
+```bash
+./dist/jonsoc-<your-platform>-<your-arch>/bin/jonsoc --version
+```
+
+### 3. Publish to npm
+
+```bash
+bun run script/publish.ts
+```
+
+This will:
+
+- Publish all platform-specific packages
+- Publish the main `jonsoc` package
+- Create GitHub release archives (if configured)
+
+### 4. Test the published package
+
+```bash
+# In a different directory
+bun add -g jonsoc
+
+# Verify installation
+jonsoc --version
+jonsoc --help
+```
+
+## Version Management
+
+The version is managed in `@jonsoc/script` package. To publish a new version:
+
+1. Update the version in the script package
+2. Run the build and publish commands
+
+## Troubleshooting
+
+### Package name already taken
+
+If `jonsoc` is already taken on npm, you have a few options:
+
+1. **Use a scoped package**: Change to `@your-username/jonsoc`
+2. **Choose a different name**: e.g., `jonsoc-cli`, `jonsoc-dev`, etc.
+3. **Contact the current owner** if the package is abandoned
+
+To use a scoped package, update the `name` field in `package.json`:
+
+```json
+{
+  "name": "@your-username/jonsoc"
+}
+```
+
+### Authentication errors
+
+If you get authentication errors:
+
+```bash
+npm whoami  # Check if logged in
+npm login   # Login if needed
+```
+
+### Platform binary issues
+
+If a specific platform binary fails to build:
+
+```bash
+# Build only current platform for testing
+bun run build -- --single
+
+# Skip npm install during build
+bun run build -- --skip-install
+```
+
+## Publishing Updates
+
+When publishing updates:
+
+1. Update version in script package
+2. Run `bun run build`
+3. Run `bun run script/publish.ts`
+
+The publish script automatically:
+
+- Tags releases based on the channel (stable, preview, etc.)
+- Creates platform-specific packages
+- Updates the main package
+
+## Notes
+
+- The publish script uses `--access public` to ensure packages are publicly available
+- Platform-specific binaries are automatically selected during installation based on OS and architecture
+- The bin wrapper (`bin/jonsoc`) handles finding and executing the correct binary

package/README.md

@@ -0,0 +1,58 @@
+# jonsOC
+
+AI-powered development tool for modern coding workflows.
+
+## Installation
+
+Install globally using bun:
+
+```bash
+bun add -g jonsoc
+```
+
+Or with npm:
+
+```bash
+npm install -g jonsoc
+```
+
+## Usage
+
+Once installed, you can use jonsOC from anywhere:
+
+```bash
+jonsoc --help
+```
+
+## Development
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run locally:
+
+```bash
+bun run dev
+```
+
+To build for all platforms:
+
+```bash
+bun run build
+```
+
+## Publishing
+
+To build and publish to npm:
+
+```bash
+bun run build
+bun run script/publish.ts
+```
+
+## License
+
+MIT

package/bin/jonsoc

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "child_process"
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "fs"
+import { dirname, join } from "path"
+import { platform as osPlatform, arch as osArch, homedir } from "os"
+import { fileURLToPath } from "url"
+import { xdgData, xdgState } from "xdg-basedir"
+
+/** Exit code 75 signals a restart request from the TUI */
+const EXIT_CODE_RESTART = 75
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const cwd = process.cwd()
+const env = {
+  ...process.env,
+  JONSOC_WORKDIR: process.env.JONSOC_WORKDIR ?? process.env.JOC_WORKDIR ?? cwd,
+  JONSOC_CLI: "1",
+}
+
+function run(target, args, options = {}) {
+  const result = spawnSync(target, args || process.argv.slice(2), {
+    stdio: "inherit",
+    shell: osPlatform() === "win32",
+    cwd: options.cwd,
+    env: options.env,
+  })
+  if (result.error) {
+    console.error(result.error.message)
+    process.exit(1)
+  }
+  return typeof result.status === "number" ? result.status : 0
+}
+
+const rawArgs = process.argv.slice(2)
+const hasFlag = (value) => rawArgs.includes(value)
+const safe = hasFlag("-safe") || hasFlag("--safe")
+const restart = hasFlag("-restart") || hasFlag("--restart") || hasFlag("-return") || hasFlag("--return")
+const autoReturn = hasFlag("-auto-return") || hasFlag("--auto-return")
+const check = hasFlag("-check") || hasFlag("--check")
+const safeIsolated =
+  hasFlag("-safe-isolated") ||
+  hasFlag("--safe-isolated") ||
+  process.env.JONSOC_SAFE_ISOLATE === "1" ||
+  process.env.OPENCODE_SAFE_ISOLATE === "1"
+const flagSet = new Set([
+  "-safe",
+  "--safe",
+  "-restart",
+  "--restart",
+  "-return",
+  "--return",
+  "-auto-return",
+  "--auto-return",
+  "-check",
+  "--check",
+  "-safe-isolated",
+  "--safe-isolated",
+])
+const baseArgs = rawArgs.filter((arg) => !flagSet.has(arg))
+const appName = process.env.JONSOC_APP_NAME ?? process.env.OPENCODE_APP_NAME ?? "jonsoc"
+const stateAppName = safe && safeIsolated ? `${appName}-safe` : appName
+
+const stateDir = () => {
+  const root = xdgState ?? join(homedir(), ".local", "state")
+  return join(root, stateAppName)
+}
+
+const lastSession = () => {
+  const filePath = join(stateDir(), "kv.json")
+  if (!existsSync(filePath)) return
+  const raw = readFileSync(filePath, "utf8")
+  if (!raw) return
+  try {
+    const data = JSON.parse(raw)
+    const session = data?.session_last
+    if (typeof session !== "string") return
+    return session
+  } catch {
+    return
+  }
+}
+
+const restartArgs = (() => {
+  if (!restart) return baseArgs
+  if (baseArgs.includes("--session") || baseArgs.includes("-s")) return baseArgs
+  const sessionID = lastSession()
+  if (!sessionID) {
+    console.error("No recent session found to restart.")
+    process.exit(1)
+  }
+  return ["--session", sessionID, ...baseArgs]
+})()
+
+if (check) {
+  console.log("running")
+  process.exit(0)
+}
+
+/** Build args for restart - add --session if we have a last session */
+function buildRestartArgs() {
+  if (baseArgs.includes("--session") || baseArgs.includes("-s")) return baseArgs
+  const sessionID = lastSession()
+  if (!sessionID) return baseArgs
+  return ["--session", sessionID, ...baseArgs]
+}
+
+/** Run the CLI and handle restart exit code */
+function runWithRestart(target, prefix, trailingArgs, options = {}) {
+  let args = [...prefix, ...trailingArgs]
+  for (;;) {
+    const code = run(target, args, options)
+
+    // Clean exit (user typed /exit, /quit, or Ctrl+C handled cleanly)
+    if (code === 0) {
+      process.exit(0)
+    }
+
+    // Requested restart (code 75) or Crash/Error (code != 0)
+    // We always attempt to return to the session on any failure.
+    if (code !== 0) {
+      if (code !== EXIT_CODE_RESTART) {
+        console.error(`\n[jonsoc] unexpected exit (${code}). recovering session...`)
+        // 1s throttle only on actual crashes to prevent cpu pinning if there's a persistent boot error
+        spawnSync("node", ["-e", "setTimeout(() => {}, 1000)"], { stdio: "inherit" })
+      }
+      args = [...prefix, ...buildRestartArgs()]
+      continue
+    }
+
+    process.exit(code)
+  }
+}
+
+if (safe) {
+  const safeEnv = {
+    ...env,
+    ...(safeIsolated ? { JONSOC_APP_NAME: `${appName}-safe` } : {}),
+    JONSOC_SAFE_MODE: "1",
+  }
+  runWithRestart("npx", ["--yes", "jonsoc@latest"], restartArgs, { env: safeEnv })
+}
+
+const envPath = process.env.JONSOC_BIN_PATH || process.env.JOC_BIN_PATH || process.env.OPENCODE_BIN_PATH
+if (envPath) {
+  runWithRestart(envPath, [], restartArgs, { env })
+}
+
+const scriptPath = realpathSync(__filename)
+const scriptDir = dirname(scriptPath)
+const pkgDir = dirname(scriptDir)
+
+// Development mode: run TypeScript source directly with bun when inside repo
+function repoRoot(dir) {
+  const entry = join(dir, "packages", "jonsoc", "src", "index.ts")
+  if (existsSync(entry)) return dir
+  const parent = dirname(dir)
+  if (parent === dir) return
+  return repoRoot(parent)
+}
+
+const root = repoRoot(cwd)
+if (root) {
+  const workdir = join(root, "packages", "jonsoc")
+  runWithRestart("bun", ["run", "--conditions=browser", "src/index.ts"], restartArgs, { cwd: workdir, env })
+}
+
+
+// Production mode: fetch compiled binary into XDG data dir
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+}
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+  arm: "arm",
+}
+
+let platform = platformMap[osPlatform()]
+if (!platform) {
+  platform = osPlatform()
+}
+let arch = archMap[osArch()]
+if (!arch) {
+  arch = osArch()
+}
+const base = "jonsoc-" + platform + "-" + arch
+const binary = platform === "windows" ? "jonsoc.exe" : "jonsoc"
+
+const supported = new Set(["darwin-arm64", "linux-x64", "windows-x64"])
+if (!supported.has(`${platform}-${arch}`)) {
+  console.error(`[jonsoc] Unsupported platform: ${platform}-${arch}. Supported: ${Array.from(supported).join(", ")}`)
+  process.exit(1)
+}
+
+const pkgJsonPath = join(pkgDir, "package.json")
+const version = (() => {
+  if (!existsSync(pkgJsonPath)) return "latest"
+  const raw = readFileSync(pkgJsonPath, "utf8")
+  const data = JSON.parse(raw)
+  return typeof data.version === "string" ? data.version : "latest"
+})()
+
+const repo = (process.env.JONSOC_REPO ?? process.env.OPENCODE_REPO ?? "Noisemaker111/JonsOpencode").replace(
+  /^https?:\/\/github\.com\//,
+  "",
+)
+const dataRoot = xdgData ?? join(homedir(), ".local", "share")
+const dataDir = join(dataRoot, appName)
+const binDir = join(dataDir, "bin")
+const versionFile = join(binDir, "version")
+const binaryPath = join(binDir, binary)
+
+function ensureDir(dir) {
+  if (existsSync(dir)) return
+  mkdirSync(dir, { recursive: true })
+}
+
+function versionMatch() {
+  if (!existsSync(binaryPath)) return false
+  if (!existsSync(versionFile)) return false
+  const stored = readFileSync(versionFile, "utf8").trim()
+  return stored === version
+}
+
+function releaseUrl() {
+  const asset = platform === "linux" ? `${base}.tar.gz` : `${base}.zip`
+  const releasePath = version === "latest" ? "latest/download" : `download/v${version}`
+  return {
+    asset,
+    url: `https://github.com/${repo}/releases/${releasePath}/${asset}`,
+  }
+}
+
+function extractArchive(archivePath) {
+  if (platform === "linux") {
+    const code = run("tar", ["-xzf", archivePath, "-C", binDir], { env })
+    if (code !== 0) process.exit(code)
+    return
+  }
+
+  if (platform === "windows") {
+    const cmd = `Expand-Archive -Path "${archivePath}" -DestinationPath "${binDir}" -Force`
+    const code = run("powershell", ["-NoProfile", "-Command", cmd], { env })
+    if (code !== 0) process.exit(code)
+    return
+  }
+
+  const code = run("unzip", ["-o", archivePath, "-d", binDir], { env })
+  if (code !== 0) process.exit(code)
+}
+
+function ensureBinary() {
+  if (versionMatch()) return binaryPath
+  ensureDir(binDir)
+  const { asset, url } = releaseUrl()
+  const archivePath = join(dataDir, asset)
+  const code = run("curl", ["-fL", "-o", archivePath, url], { env })
+  if (code !== 0) {
+    console.error(`[jonsoc] Failed to download ${url}`)
+    process.exit(code)
+  }
+  extractArchive(archivePath)
+  if (platform !== "windows") {
+    run("chmod", ["+x", binaryPath], { env })
+  }
+  if (!existsSync(binaryPath)) {
+    console.error(`[jonsoc] Expected binary not found at ${binaryPath}`)
+    process.exit(1)
+  }
+  writeFileSync(versionFile, version)
+  return binaryPath
+}
+
+const resolved = ensureBinary()
+runWithRestart(resolved, [], restartArgs, { env })

package/bunfig.toml

@@ -0,0 +1,7 @@
+preload = ["@opentui/solid/preload"]
+
+[test]
+preload = ["./test/preload.ts"]
+timeout = 10000  # 10 seconds (default is 5000ms)
+# Enable code coverage
+coverage = true

package/package.json

@@ -0,0 +1,147 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "version": "1.1.43",
+  "name": "jonsoc",
+  "description": "AI-powered development tool",
+  "type": "module",
+  "license": "MIT",
+  "author": "Jon",
+  "keywords": [
+    "ai",
+    "development",
+    "cli",
+    "jonsoc",
+    "coding-assistant"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Noisemaker111/Jonsoc"
+  },
+  "homepage": "https://github.com/Noisemaker111/Jonsoc#readme",
+  "bugs": {
+    "url": "https://github.com/Noisemaker111/Jonsoc/issues"
+  },
+  "scripts": {
+    "typecheck": "tsgo --noEmit",
+    "test": "bun test",
+    "build": "bun run script/build.ts",
+    "dev": "bun run --conditions=browser ./src/index.ts",
+    "random": "echo 'Random script updated at $(date)' && echo 'Change queued successfully' && echo 'Another change made' && echo 'Yet another change' && echo 'One more change' && echo 'Final change' && echo 'Another final change' && echo 'Yet another final change'",
+    "clean": "echo 'Cleaning up...' && rm -rf node_modules dist",
+    "lint": "echo 'Running lint checks...' && bun test --coverage",
+    "format": "echo 'Formatting code...' && bun run --prettier --write src/**/*.ts",
+    "docs": "echo 'Generating documentation...' && find src -name '*.ts' -exec echo 'Processing: {}' \\;",
+    "deploy": "echo 'Deploying application...' && bun run build && echo 'Deployment completed successfully'"
+  },
+  "bin": {
+    "jonsoc": "./bin/jonsoc"
+  },
+  "optionalDependencies": {
+    "jonsoc-darwin-arm64": "1.1.42",
+    "jonsoc-linux-x64": "1.1.42",
+    "jonsoc-windows-x64": "1.1.42"
+  },
+  "exports": {
+    "./*": "./src/*.ts"
+  },
+  "devDependencies": {
+    "@babel/core": "7.28.4",
+    "@octokit/webhooks-types": "7.6.1",
+    "@jonsoc/script": "workspace:*",
+    "@parcel/watcher-darwin-arm64": "2.5.1",
+    "@parcel/watcher-darwin-x64": "2.5.1",
+    "@parcel/watcher-linux-arm64-glibc": "2.5.1",
+    "@parcel/watcher-linux-arm64-musl": "2.5.1",
+    "@parcel/watcher-linux-x64-glibc": "2.5.1",
+    "@parcel/watcher-linux-x64-musl": "2.5.1",
+    "@parcel/watcher-win32-x64": "2.5.1",
+    "@standard-schema/spec": "1.0.0",
+    "@tsconfig/bun": "catalog:",
+    "@types/babel__core": "7.20.5",
+    "@types/bun": "catalog:",
+    "@types/turndown": "5.0.5",
+    "@types/yargs": "17.0.33",
+    "@typescript/native-preview": "catalog:",
+    "typescript": "catalog:",
+    "vscode-languageserver-types": "3.17.5",
+    "why-is-node-running": "3.2.2",
+    "zod-to-json-schema": "3.24.5"
+  },
+  "dependencies": {
+    "@actions/core": "1.11.1",
+    "@actions/github": "6.0.1",
+    "@agentclientprotocol/sdk": "0.12.0",
+    "@ai-sdk/amazon-bedrock": "3.0.73",
+    "@ai-sdk/anthropic": "2.0.57",
+    "@ai-sdk/azure": "2.0.91",
+    "@ai-sdk/cerebras": "1.0.34",
+    "@ai-sdk/cohere": "2.0.22",
+    "@ai-sdk/deepinfra": "1.0.31",
+    "@ai-sdk/gateway": "2.0.25",
+    "@ai-sdk/google": "2.0.52",
+    "@ai-sdk/google-vertex": "3.0.97",
+    "@ai-sdk/groq": "2.0.34",
+    "@ai-sdk/mistral": "2.0.27",
+    "@ai-sdk/openai": "2.0.89",
+    "@ai-sdk/openai-compatible": "1.0.30",
+    "@ai-sdk/perplexity": "2.0.23",
+    "@ai-sdk/provider": "2.0.1",
+    "@ai-sdk/provider-utils": "3.0.20",
+    "@ai-sdk/togetherai": "1.0.31",
+    "@ai-sdk/vercel": "1.0.31",
+    "@ai-sdk/xai": "2.0.51",
+    "@clack/prompts": "1.0.0-alpha.1",
+    "@gitlab/gitlab-ai-provider": "3.2.0",
+    "@hono/standard-validator": "0.1.5",
+    "@hono/zod-validator": "catalog:",
+    "@jonsoc/plugin": "workspace:*",
+    "@jonsoc/script": "workspace:*",
+    "@jonsoc/sdk": "workspace:*",
+    "@jonsoc/util": "workspace:*",
+    "@modelcontextprotocol/sdk": "1.25.2",
+    "@octokit/graphql": "9.0.2",
+    "@octokit/rest": "catalog:",
+    "@openauthjs/openauth": "catalog:",
+    "@openrouter/ai-sdk-provider": "1.5.2",
+    "@opentui/core": "0.1.75",
+    "@opentui/solid": "0.1.75",
+    "@parcel/watcher": "2.5.1",
+    "@pierre/diffs": "catalog:",
+    "@solid-primitives/event-bus": "1.1.2",
+    "@solid-primitives/scheduled": "1.5.2",
+    "@standard-schema/spec": "1.0.0",
+    "@zip.js/zip.js": "2.7.62",
+    "ai": "catalog:",
+    "bonjour-service": "1.3.0",
+    "bun-pty": "0.4.4",
+    "chokidar": "4.0.3",
+    "clipboardy": "4.0.0",
+    "decimal.js": "10.5.0",
+    "diff": "catalog:",
+    "fuzzysort": "3.1.0",
+    "gray-matter": "4.0.3",
+    "hono": "catalog:",
+    "hono-openapi": "catalog:",
+    "ignore": "7.0.5",
+    "jsonc-parser": "3.3.1",
+    "minimatch": "10.0.3",
+    "open": "10.1.2",
+    "opentui-spinner": "0.0.6",
+    "partial-json": "0.1.7",
+    "remeda": "catalog:",
+    "solid-js": "catalog:",
+    "strip-ansi": "7.1.2",
+    "tree-sitter-bash": "0.25.0",
+    "turndown": "7.2.0",
+    "ulid": "catalog:",
+    "vscode-jsonrpc": "8.2.1",
+    "web-tree-sitter": "0.25.10",
+    "xdg-basedir": "5.1.0",
+    "yargs": "18.0.0",
+    "zod": "catalog:",
+    "zod-to-json-schema": "3.24.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}