cli-error 0.1.0__tar.gz

cli_error-0.1.0/.claude/scheduled_tasks.lock

@@ -0,0 +1 @@
+{"sessionId":"d6c578d2-0e67-41a3-9ab3-6eb663d5b9d5","pid":25,"procStart":"26355062","acquiredAt":1783286663093}

cli_error-0.1.0/.flake8

@@ -0,0 +1,3 @@
+[flake8]
+max-line-length = 88
+extend-ignore = E203, W503

cli_error-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: tox
+    runs-on: ubuntu-latest
+    env:
+      UV_PYTHON: ${{ matrix.python-version }}
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Sync dev dependencies
+        run: uv sync --group dev
+
+      - name: Run tox
+        run: uv run tox

cli_error-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    environment: Production
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

cli_error-0.1.0/.gitignore

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+
+# Tools
+.mypy_cache/
+.pytest_cache/
+
+# tox
+.tox/
+
+# local configs
+.env
+*.local.json
+.worktrees
+
+# packaging / testing extras
+*$py.class
+*.egg
+.eggs/
+.coverage
+htmlcov/

cli_error-0.1.0/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "tasker": {
+      "type": "stdio",
+      "command": "tasker",
+      "args": [
+        "mcp"
+      ],
+      "env": {}
+    }
+  }
+}

cli_error-0.1.0/.sandbox/.env.example

@@ -0,0 +1,20 @@
+# Host identity — container files will be owned by this UID/GID.
+# Populate with: id -u, id -g, echo $USER
+HOST_UID=1000
+HOST_GID=1000
+USER=yourname
+
+# Compose project namespace. Controls per-sandbox variant/volume naming:
+#   <COMPOSE_PROJECT_NAME>-<VARIANT>:latest
+COMPOSE_PROJECT_NAME=app-error-sandbox
+
+# Base image name. Shared across all sandboxes (independent of
+# COMPOSE_PROJECT_NAME), so rebuilding it once updates every sandbox.
+# Leave this alone unless you deliberately want a private, unshared base.
+# BASE_IMAGE=agent-sandbox-base:latest
+
+# Active variant — uncomment exactly ONE.
+VARIANT=python
+
+# Language versions (used only by the matching variant).
+PYTHON_VERSION="3.10 3.11 3.12"

cli_error-0.1.0/.sandbox/README.md

@@ -0,0 +1,114 @@
+# Agent Sandbox
+
+A Docker-based environment for running Claude Code with persistent authentication,
+a shared project workspace, and a pluggable variant system for different language stacks.
+
+See the top-level [`README.md`](../README.md) for WSL setup and a variants overview.
+
+The shared base image ships `uv` and the `mcp-tasker` MCP server, so they're
+available in every variant regardless of language stack.
+
+## Layout
+
+```
+sandbox/
+  .env.example                          template for .env (copy and edit)
+  docker-compose.yml                    base compose file (variant-agnostic)
+  run.sh                                one-shot: build (if needed) → up → claude
+  base/
+    Dockerfile                          generic dev image (ubuntu + tmux/zsh/nvim/node/claude + uv/mcp-tasker)
+    zshrc, tmux.conf                    mounted read-only into the container
+  variants/
+    python/           Dockerfile + compose.override.yml  (uv + poetry)
+    typescript/       Dockerfile + compose.override.yml  (node TS toolchain)
+    php/              Dockerfile + compose.override.yml
+    minimal/          Dockerfile + compose.override.yml  (no language stack)
+  scripts/
+    build.sh     builds base image, then the active variant
+    attach.sh    `tmux attach -t main`
+    shell.sh     plain zsh shell
+    claude.sh    `claude --dangerously-skip-permissions`
+    _lib.sh      sourced helper (loads .env, sets COMPOSE_FILE)
+```
+
+## First-time setup
+
+```bash
+cd sandbox
+cp .env.example .env
+# Edit .env: set HOST_UID, HOST_GID, USER, COMPOSE_PROJECT_NAME, VARIANT
+./run.sh
+```
+
+`run.sh` builds the base image + active variant on first invocation, starts
+the container, and drops you into Claude Code. Subsequent runs skip the
+build when the images already exist.
+
+Claude credentials live in `~/.claude` / `~/.claude.json` on the host (bind-mounted
+into the container), so authentication persists across container rebuilds.
+
+The host's `~/repo-skills` is bind-mounted **read-only** at `~/repo-skills` inside
+the container as a reference source, so the sandbox can consult it without
+modifying it or leaking container-generated files back onto the host.
+
+## Daily usage
+
+```bash
+cd sandbox
+./run.sh              # ensure running, then run claude
+./scripts/attach.sh   # attach to the tmux session inside the container
+./scripts/shell.sh    # plain zsh shell inside the container
+./scripts/claude.sh   # another claude instance in the running container
+```
+
+The project directory (`..` relative to `sandbox/`) is mounted at `/work` inside
+the container and reflects host changes in real time.
+
+Press `Ctrl+B, D` to detach from tmux without stopping the container.
+
+## Switching variants
+
+```bash
+# Edit VARIANT in .env, then:
+docker compose down   # stop the old variant
+./run.sh              # build+start the new one
+```
+
+Each variant's image is tagged `<COMPOSE_PROJECT_NAME>-<variant>:latest`, so
+switching doesn't rebuild unnecessarily. The base image (`BASE_IMAGE`, default
+`agent-sandbox-base:latest`) is *shared* across all sandboxes regardless of
+`COMPOSE_PROJECT_NAME`, so it's built once and reused everywhere.
+
+## Stopping
+
+```bash
+docker compose stop        # pause, keep state
+docker compose down        # remove containers, keep volumes (auth + caches)
+docker compose down -v     # nuke everything including caches and venvs
+```
+
+Named volumes owned by a variant (e.g. `venv`, `tox`, `uv-cache`, `uv-data`,
+`poetry-cache`, `node-modules`, `vendor`, `composer-cache`) live under the
+compose project namespace — you can list them
+with `docker volume ls | grep "$COMPOSE_PROJECT_NAME"`.
+
+## Rebuilding
+
+After changing a `Dockerfile` or `claude_install.sh`:
+
+```bash
+./scripts/build.sh
+docker compose up -d --force-recreate
+```
+
+`build.sh` builds the shared base image only when it's missing, then builds the
+active variant. To refresh the shared base itself (a no-cache rebuild that
+updates *every* sandbox using it), pass `--force`:
+
+```bash
+./scripts/build.sh --force
+```
+
+## Adding a variant
+
+See the top-level README's "Adding a new variant" section.

cli_error-0.1.0/.sandbox/base/Dockerfile

@@ -0,0 +1,42 @@
+FROM ubuntu:26.04
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        curl ca-certificates git zsh neovim tmux ncurses-term \
+    && rm -rf /var/lib/apt/lists/*
+
+ARG UID=1000
+ARG GID=1000
+ARG USERNAME=agent
+
+# Ubuntu 26.04 ships a pre-created `ubuntu` user at 1000:1000. Remove it so the
+# host's UID/GID can be reused without collision.
+RUN (userdel -r ubuntu && groupdel ubuntu) 2>/dev/null || true \
+    && groupadd -g ${GID} ${USERNAME} \
+    && useradd -m -u ${UID} -g ${GID} -s /bin/zsh ${USERNAME}
+
+RUN curl -fsSL https://deb.nodesource.com/setup_lts.x | bash - \
+    && apt-get install -y --no-install-recommends nodejs \
+    && rm -rf /var/lib/apt/lists/*
+
+USER ${USERNAME}
+ENV USERNAME=${USERNAME}
+ENV PATH="/home/${USERNAME}/.local/bin:${PATH}"
+
+RUN curl -fsSL https://claude.ai/install.sh | bash
+
+# uv is shared across all variants — it manages Python interpreters and is also
+# the installer for Python-based tooling (e.g. mcp-tasker), so it belongs in the
+# base image rather than any single variant.
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# mcp-tasker is the task-tracker MCP server; make it available everywhere.
+RUN uv tool install mcp-tasker
+
+RUN git config --global user.name "Claude Agent" \
+    && git config --global user.email "agent@claude.ai"
+
+WORKDIR /work
+
+CMD ["tmux", "new-session", "-A", "-s", "main"]

cli_error-0.1.0/.sandbox/base/tmux.conf

@@ -0,0 +1,112 @@
+# link: https://hamvocke.com/blog/a-guide-to-customizing-your-tmux-conf/
+
+# command shortcuts:
+#   set-option          -> set
+#   bind-key            -> bind
+#   set-window-option   -> setw          "set -w"
+#   list-sessions       -> ls
+
+# useful shortcuts:
+#   C-q                 - prefix (default: 'C-b')
+#   r                   - reload tmux config
+# windows:
+#   c                   - create window
+#   n                   - switch to next window
+#   R                   - rename window title (default: ',')
+# panes:
+#   C-o                 - switch panes
+#   -                   - split horizontally (default: '"')
+#   \ or |              - split vertically (default: '%')
+# window content and history
+#   [                   - enter meta mode (Shift-A will exit this mode)
+#   v                   - start selection
+#   y                   - copy selected
+
+# add more accessible prefix 'Ctrl+Q' but keep the old one as fallback
+set -g prefix C-b
+bind C-b send-prefix
+
+set -g prefix2 C-q
+bind C-q send-prefix -2
+
+# split panes using | and -
+bind | split-window -h
+bind "\\" split-window -h   # don't need to press `Shift`
+bind - split-window -v
+
+# config reload
+bind r source-file ~/.config/tmux/tmux.conf
+
+# start numbering from 1
+set -g base-index 1
+
+# switch panes using Alt-arrow without prefix
+bind -n M-Left select-pane -L
+bind -n M-Right select-pane -R
+bind -n M-Up select-pane -U
+bind -n M-Down select-pane -D
+
+# allow to run vim over pane content
+setw -g mode-keys vi
+bind -T copy-mode-vi 'v' send-keys -X begin-selection
+bind -T copy-mode-vi 'y' send-keys -X copy-selection
+
+# enable mouse control
+set -g mouse on
+
+# NVIM advices:
+set -g focus-events on
+# enable truecolor feature (required by NVIM's `vim.opt.termguicolors` option)
+set -g default-terminal "xterm-256color"
+set -as terminal-features '*:RGB'
+
+# don't rename windows automatically (use "C-b ," or "C-q R" to rename window title)
+set -g allow-rename off
+bind R command-prompt -I "#W" "rename-window '%%'"
+
+# include scrollback history
+set -g history-limit 3000
+
+
+# DESIGN TWEAKS
+
+# don't do anything when a 'bell' rings
+set -g visual-activity off
+set -g visual-bell off
+set -g visual-silence off
+setw -g monitor-activity off
+set -g bell-action none
+
+# clock mode
+setw -g clock-mode-colour yellow
+
+# copy mode
+setw -g mode-style 'fg=black bg=red bold'
+
+# panes
+set -g pane-border-style 'fg=red'
+set -g pane-active-border-style 'fg=yellow'
+
+# statusbar
+set -g status-position bottom
+set -g status-justify left
+set -g status-style 'fg=red'
+
+set -g status-left ''
+set -g status-left-length 10
+
+set -g status-right-style 'fg=black bg=yellow'
+set -g status-right '%Y-%m-%d %H:%M '
+set -g status-right-length 50
+
+setw -g window-status-current-style 'fg=black bg=red'
+setw -g window-status-current-format ' #I #W #F '
+
+setw -g window-status-style 'fg=red bg=black'
+setw -g window-status-format ' #I #[fg=white]#W #[fg=yellow]#F '
+
+setw -g window-status-bell-style 'fg=yellow bg=red bold'
+
+# messages
+set -g message-style 'fg=yellow bg=red bold'
+

cli_error-0.1.0/.sandbox/base/zshrc

@@ -0,0 +1,9 @@
+# PATH
+export PATH="$HOME/.local/bin:$PATH"
+
+# Pretty prompt: user@host:dir (branch)$
+autoload -Uz vcs_info
+precmd() { vcs_info }
+zstyle ':vcs_info:git:*' formats ' (%b)'
+setopt PROMPT_SUBST
+PROMPT='%F{green}%n@%m%f:%F{blue}%~%f%F{yellow}${vcs_info_msg_0_}%f%# '

cli_error-0.1.0/.sandbox/docker-compose.yml

@@ -0,0 +1,28 @@
+services:
+  claude-code:
+    build:
+      context: variants/${VARIANT}
+      args:
+        - BASE_IMAGE=${BASE_IMAGE}
+        - USERNAME=${USER}
+        - UID=${HOST_UID:-1000}
+        - GID=${HOST_GID:-1000}
+        - PYTHON_VERSION=${PYTHON_VERSION:-3.10 3.11 3.12}
+        - PHP_VERSION=${PHP_VERSION:-8.3}
+    image: ${COMPOSE_PROJECT_NAME}-${VARIANT}:latest
+    stdin_open: true
+    tty: true
+    volumes:
+      - ..:/work
+      - npm-cache:/home/${USER}/.npm
+      - ./base/tmux.conf:/home/${USER}/.tmux.conf:ro
+      - ./base/zshrc:/home/${USER}/.zshrc:ro
+      - ~/.claude:/home/${USER}/.claude
+      - ~/.claude.json:/home/${USER}/.claude.json
+      - ~/repo-skills:/home/${USER}/repo-skills:ro
+    working_dir: /work
+    environment:
+      - TERM=xterm-256color
+
+volumes:
+  npm-cache:

cli_error-0.1.0/.sandbox/run.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# One-shot: ensure images are built, container is up, then drop into claude.
+set -euo pipefail
+
+cd "$(dirname "$0")"
+# shellcheck source=scripts/_lib.sh
+source scripts/_lib.sh
+
+WORKDIR=""
+ARGS=()
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --workdir)
+            WORKDIR="$2"
+            shift 2
+            ;;
+        --workdir=*)
+            WORKDIR="${1#*=}"
+            shift
+            ;;
+        *)
+            ARGS+=("$1")
+            shift
+            ;;
+    esac
+done
+
+WORKDIR_ARGS=()
+if [[ -n "$WORKDIR" ]]; then
+    WORKDIR_ARGS=(--workdir "$WORKDIR")
+fi
+
+VARIANT_IMAGE="${COMPOSE_PROJECT_NAME}-${VARIANT}:latest"
+
+if ! docker image inspect "${BASE_IMAGE}" >/dev/null 2>&1 \
+ || ! docker image inspect "${VARIANT_IMAGE}" >/dev/null 2>&1; then
+    scripts/build.sh
+fi
+
+docker compose up -d
+
+exec docker compose exec "${WORKDIR_ARGS[@]}" claude-code claude --dangerously-skip-permissions "${ARGS[@]}"

cli_error-0.1.0/.sandbox/scripts/_lib.sh

@@ -0,0 +1,23 @@
+# Sourced by other scripts — loads .env and exports COMPOSE_FILE.
+# Assumes the caller has already cd'd to sandbox/.
+
+if [[ ! -f .env ]]; then
+    echo "Error: sandbox/.env not found. Copy .env.example to .env and edit it." >&2
+    exit 1
+fi
+
+set -a
+# shellcheck disable=SC1091
+source .env
+set +a
+
+: "${COMPOSE_PROJECT_NAME:?Must set COMPOSE_PROJECT_NAME in .env}"
+: "${VARIANT:?Must set VARIANT in .env}"
+: "${USER:?Must set USER in .env}"
+
+# Base image name is shared across all sandboxes (independent of
+# COMPOSE_PROJECT_NAME), so rebuilding it once updates every sandbox.
+: "${BASE_IMAGE:=agent-sandbox-base:latest}"
+export BASE_IMAGE
+
+export COMPOSE_FILE="docker-compose.yml:variants/${VARIANT}/compose.override.yml"

cli_error-0.1.0/.sandbox/scripts/attach.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")/.."
+# shellcheck source=_lib.sh
+source scripts/_lib.sh
+exec docker compose exec claude-code tmux attach -t main

cli_error-0.1.0/.sandbox/scripts/build.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+# shellcheck source=_lib.sh
+source scripts/_lib.sh
+
+FORCE=0
+for arg in "$@"; do
+    case "$arg" in
+        --force) FORCE=1 ;;
+        *)
+            echo "Usage: build.sh [--force]" >&2
+            echo "  --force  rebuild the shared base image from scratch (--no-cache)" >&2
+            exit 1
+            ;;
+    esac
+done
+
+# The base image is shared across all sandboxes, so leave it untouched when it
+# already exists unless --force is given (which rebuilds it for everyone).
+if [[ "${FORCE}" -eq 1 ]]; then
+    echo ">>> Forcing rebuild of base image: ${BASE_IMAGE}"
+    docker build \
+        --no-cache \
+        --build-arg UID="${HOST_UID:-1000}" \
+        --build-arg GID="${HOST_GID:-1000}" \
+        --build-arg USERNAME="${USER}" \
+        -t "${BASE_IMAGE}" \
+        base/
+elif docker image inspect "${BASE_IMAGE}" >/dev/null 2>&1; then
+    echo ">>> Base image already present, skipping: ${BASE_IMAGE} (use --force to rebuild)"
+else
+    echo ">>> Building base image: ${BASE_IMAGE}"
+    docker build \
+        --build-arg UID="${HOST_UID:-1000}" \
+        --build-arg GID="${HOST_GID:-1000}" \
+        --build-arg USERNAME="${USER}" \
+        -t "${BASE_IMAGE}" \
+        base/
+fi
+
+echo ">>> Building variant: ${VARIANT}"
+docker compose build

cli_error-0.1.0/.sandbox/scripts/claude.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")/.."
+# shellcheck source=_lib.sh
+source scripts/_lib.sh
+exec docker compose exec claude-code claude --dangerously-skip-permissions

cli_error-0.1.0/.sandbox/scripts/shell.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")/.."
+# shellcheck source=_lib.sh
+source scripts/_lib.sh
+
+WORKDIR=""
+ARGS=()
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --workdir)
+            WORKDIR="$2"
+            shift 2
+            ;;
+        --workdir=*)
+            WORKDIR="${1#*=}"
+            shift
+            ;;
+        *)
+            ARGS+=("$1")
+            shift
+            ;;
+    esac
+done
+
+WORKDIR_ARGS=()
+if [[ -n "$WORKDIR" ]]; then
+    WORKDIR_ARGS=(--workdir "$WORKDIR")
+fi
+
+exec docker compose exec "${WORKDIR_ARGS[@]}" claude-code zsh "${ARGS[@]}"

cli_error-0.1.0/.sandbox/variants/python/Dockerfile

@@ -0,0 +1,30 @@
+# check=skip=InvalidDefaultArgInFrom
+ARG BASE_IMAGE
+FROM ${BASE_IMAGE}
+
+ARG PYTHON_VERSION="3.10 3.11 3.12"
+
+# uv ships in the base image; use it to install the requested interpreters.
+RUN uv python install ${PYTHON_VERSION}
+
+# Both uv- and poetry-based projects are supported, so install both package
+# managers alongside the shared dev tooling.
+RUN uv tool install poetry \
+ && uv tool install tox \
+ && uv tool install pytest \
+ && uv tool install mypy \
+ && uv tool install black \
+ && uv tool install isort \
+ && uv tool install flake8
+
+USER root
+RUN npm install -g pyright && rm -rf /var/lib/apt/lists/*
+USER ${USERNAME}
+
+# Pre-create volume mount points so named-volume init inherits user ownership
+# instead of being created as root by the Docker daemon.
+RUN mkdir -p /work/.venv /work/.tox
+
+# Keep poetry's venv inside the project dir so the .venv volume-shadow works.
+ENV POETRY_VIRTUALENVS_IN_PROJECT=true
+ENV PATH="/work/.venv/bin:${PATH}"

cli_error-0.1.0/.sandbox/variants/python/compose.override.yml

@@ -0,0 +1,16 @@
+services:
+  claude-code:
+    volumes:
+      # Shadow project-local paths so container writes stay out of the host bind mount.
+      - venv:/work/.venv
+      - tox:/work/.tox
+      - uv-cache:/home/${USER}/.cache/uv
+      - uv-data:/home/${USER}/.local/share/uv
+      - poetry-cache:/home/${USER}/.cache/pypoetry
+
+volumes:
+  venv:
+  tox:
+  uv-cache:
+  uv-data:
+  poetry-cache:

cli_error-0.1.0/.sandbox/worktree_run.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+SCRIPT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" &>/dev/null && pwd)
+
+exec "$SCRIPT_DIR/run.sh" --workdir /work/.worktrees/work "$@"

cli_error-0.1.0/.sandbox/worktree_shell.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+SCRIPT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" &>/dev/null && pwd)
+
+exec "$SCRIPT_DIR/scripts/shell.sh" --workdir /work/.worktrees/work "$@"

cli_error-0.1.0/.tasker/.closed

@@ -0,0 +1,16 @@
+s01t01
+s01t02
+s01t10
+s01t11
+s01t12
+s01t03
+s01t13
+s01t04
+s01t05
+s01t14
+s01t06
+s01t07
+s01t20
+s01t18
+s01t08
+s01t09