agentirc-cli 0.2.1__tar.gz

agentirc_cli-0.2.1/.github/workflows/pages.yml

@@ -0,0 +1,52 @@
+name: Deploy Jekyll to GitHub Pages
+
+on:
+  push:
+    branches: ["main"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Build with Jekyll
+        run: bundle exec jekyll build
+        env:
+          JEKYLL_ENV: production
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

agentirc_cli-0.2.1/.github/workflows/publish.yml

@@ -0,0 +1,93 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "pyproject.toml"
+      - "agentirc/**"
+  pull_request:
+    branches: [main]
+    paths:
+      - "pyproject.toml"
+      - "agentirc/**"
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+
+      - run: uv python install 3.12
+
+      - run: uv sync
+
+      - run: uv run pytest -v
+
+  test-publish:
+    if: github.event_name == 'pull_request'
+    needs: test
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+
+      - run: uv python install 3.12
+
+      - run: uv sync
+
+      - name: Set dev version
+        run: |
+          BASE=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          DEV_VERSION="${BASE}.dev${{ github.run_number }}"
+          sed -i "s/^version = .*/version = \"${DEV_VERSION}\"/" pyproject.toml
+          echo "DEV_VERSION=${DEV_VERSION}" >> "$GITHUB_ENV"
+          echo "Publishing ${DEV_VERSION} to TestPyPI"
+
+      - name: Build and publish agentirc-cli to TestPyPI
+        run: |
+          uv build
+          uv publish --publish-url https://test.pypi.org/legacy/ --trusted-publishing always
+
+      - name: Build and publish agentirc to TestPyPI
+        run: |
+          sed -i 's/^name = "agentirc-cli"/name = "agentirc"/' pyproject.toml
+          rm -rf dist
+          uv build
+          uv publish --publish-url https://test.pypi.org/legacy/ --trusted-publishing always
+
+      - name: Print install commands
+        run: |
+          echo "::notice::Test with: pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ agentirc-cli==${DEV_VERSION}"
+          echo "::notice::Or: pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ agentirc==${DEV_VERSION}"
+
+  publish:
+    if: github.event_name == 'push'
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+
+      - run: uv python install 3.12
+
+      - run: uv sync
+
+      - run: uv build
+
+      - run: uv publish --trusted-publishing always

agentirc_cli-0.2.1/.github/workflows/tests.yml

@@ -0,0 +1,22 @@
+name: Tests
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+
+      - run: uv python install 3.12
+
+      - run: uv sync
+
+      - run: uv run pytest -v

agentirc_cli-0.2.1/.gitignore

@@ -0,0 +1,207 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/

agentirc_cli-0.2.1/.markdownlint-cli2.yaml

@@ -0,0 +1,14 @@
+# Global markdownlint-cli2 configuration
+# Per-project .markdownlint-cli2.yaml overrides these defaults
+
+config:
+  default: true
+  # MD013: Line length — disabled globally (too noisy for content-heavy repos)
+  MD013: false
+  # MD060: Table pipe spacing — disabled (stylistic preference)
+  MD060: false
+
+# Ignore patterns
+ignores:
+  - "node_modules/**"
+  - ".local/**"

agentirc_cli-0.2.1/.pr_agent.toml

@@ -0,0 +1,9 @@
+[pr_reviewer]
+extra_instructions = """
+- The `packages/` directory is ONLY for the "assimilai" pattern (internal packages copied into other projects). Top-level directories like `server/`, `protocol/`, and `clients/` are standalone application packages — they belong at the top level, NOT under `packages/`.
+- The "no mocks for the server" testing rule applies to IRC server tests only. Client libraries (like SkillClient) may use mock/stub servers in unit tests. Integration tests in `test_integration_layer5.py` exercise the real server stack.
+- Nick format validation (`<server>-<agent>`) is enforced by the IRC server at connection time. Config loading is a data layer and should not duplicate server-side validation.
+- Features explicitly marked as TODO or listed in the spec's "Deferred Features" section are known limitations, not bugs.
+- The `clients/` directory contains agent client harnesses (daemons). It is NOT an internal package for assimilation.
+"""
+num_max_findings = 5

agentirc_cli-0.2.1/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/).
+
+## [0.2.1] - 2026-03-22
+
+
+### Added
+
+- OIDC trusted publishing for PyPI and TestPyPI
+- Dual package publish (agentirc + agentirc-cli) to TestPyPI
+- CHANGELOG.md with Keep a Changelog format
+
+
+### Changed
+
+- Publish workflow uses id-token instead of API token secrets
+
+## [0.2.0] - 2026-03-22
+
+### Added
+
+- Unified `agentirc` CLI: server start/stop/status, init, start/stop/status, read/who/channels
+- `agentirc init` derives agent nick from current directory name
+- IRC observer for ephemeral read-only connections (read, who, channels)
+- PID file management for server and agent lifecycle
+- Graceful agent shutdown via IPC socket
+- `--link` flag on `agentirc server start` for federation
+- `_handle_list` in server (LIST command, RPL_LIST 322 + RPL_LISTEND 323)
+- `server.name` config field for nick prefix
+- Config helpers: `save_config`, `load_config_or_default`, `add_agent_to_config`, `sanitize_agent_name`
+- CLI reference documentation (`docs/cli.md`)
+- PyPI publishing workflow with TestPyPI pre-deploy
+- Publishing guide (`docs/publishing.md`)
+
+### Changed
+
+- Restructured all code under `agentirc/` namespace to avoid site-packages collisions
+- Package name `agentirc-cli` on PyPI (`agentirc` was taken)
+- README rewritten around `pip install agentirc-cli` workflow
+- All imports updated from `protocol.*`, `server.*`, `clients.*` to `agentirc.*`
+- Updated all documentation with new import paths and CLI commands
+
+### Fixed
+
+- WHO reply param index (params[5] not params[4]) for correct nick extraction
+- Removed broken `WHO *` for channel listing, replaced with LIST
+- Removed dead `"x in dir()"` guards in observer timeout handlers
+- Removed forced `#` prefix on WHO target — nick lookups now work
+- Fixed `agentirc-cli-cli` typo in publishing docs
+
+## [0.1.0] - 2026-03-21
+
+### Added
+
+- Initial release
+- Async Python IRCd (Layers 1-4: Core IRC, Attention/Routing, Skills, Federation)
+- Claude Agent SDK client harness (Layer 5)
+- Agent daemon with IRC transport, message buffering, supervisor
+- IRC skill tools for agent actions via Unix socket IPC
+- Webhook alerting system
+- 197 tests with real TCP connections (no mocks)
+- GitHub Pages documentation site

agentirc_cli-0.2.1/CLAUDE.md

@@ -0,0 +1,39 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**agentirc** — A mesh of IRC servers where AI agents collaborate, share knowledge, and coordinate work. Humans participate as first-class citizens. Custom async Python IRCd built from scratch, with Claude Agent SDK client harnesses.
+
+Design spec: `docs/superpowers/specs/2026-03-19-agentirc-design.md`
+
+## Package Management
+
+- **External packages:** Managed in `pyproject.toml`, installed with `uv`
+- **Internal packages:** Written in `packages/` folder, managed in `pyproject.toml` under the `assimilai` entry. Internal packages are NOT installed as dependencies — they are assimilated into target projects as organic code, placed in the correct folder and location as if written directly in the target project.
+
+## Documentation
+
+When implementing features, write a corresponding markdown doc in `docs/` describing the feature — its purpose, usage, and any protocol details. Keep `docs/` as the living reference for the project.
+
+## Git Workflow
+
+- Branch out for all changes
+- Push to GitHub for agentic code review
+- Pull review comments, address feedback, push fixes
+- Reply to comments after pushing, resolve threads
+
+## Testing
+
+- `pytest` + `pytest-asyncio`
+- No mocks for the server — tests spin up real server instances on random ports with real TCP connections
+- Validate each layer with real IRC clients (weechat/irssi)
+
+## Nick Format
+
+`<server>-<agent>` (e.g., `thor-claude`, `spark-ori`). Globally unique by construction.
+
+## Protocol
+
+IRC RFC 2812 as base. Extensions use new verbs (never redefine existing commands), documented in `protocol/extensions/`.

agentirc_cli-0.2.1/CNAME

@@ -0,0 +1 @@
+agentirc.dev

agentirc_cli-0.2.1/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+gem "jekyll", "~> 4.3"
+gem "just-the-docs", "~> 0.10"
+gem "jekyll-seo-tag"
+gem "jekyll-relative-links"