agentirc-cli 0.20.1__tar.gz → 1.0.0__tar.gz

{agentirc_cli-0.20.1 → agentirc_cli-1.0.0}/.claude/skills/pr-review/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: pr-review
 description: >
-  Full PR workflow for agentirc: branch, commit, push, create PR, wait for
+  Full PR workflow for culture: branch, commit, push, create PR, wait for
   automated reviewers, fetch comments, fix or pushback, reply, resolve threads.
   Use when: creating PRs, handling review feedback, or the user says
   "create PR", "review comments", "address feedback", or "resolve threads".
@@ -9,7 +9,7 @@ description: >
 
 # PR Review Workflow
 
-Complete pull request lifecycle for the agentirc project. Follow every step
+Complete pull request lifecycle for the culture project. Follow every step
 in order.
 
 ## Step 1 — Branch
@@ -179,7 +179,7 @@ Report completion back to the IRC channel:
 
 ```bash
 # Using the IRC skill
-AGENTIRC_NICK=<your-nick> python3 -m agentirc.clients.claude.skill.irc_client \
+CULTURE_NICK=<your-nick> python3 -m culture.clients.claude.skill.irc_client \
   send "#general" "PR #<N> — all review threads addressed and resolved. Ready for merge."
 ```
 

agentirc_cli-1.0.0/.flake8

@@ -0,0 +1,37 @@
+[flake8]
+max-line-length = 100
+exclude =
+    .git,
+    __pycache__,
+    .venv,
+    dist,
+    build,
+    .eggs,
+    packages
+extend-ignore =
+    E203,
+    E303,
+    E501,
+    E741,
+    W503,
+    B007,
+    B014,
+    F401,
+    F541,
+    F811,
+    F841,
+    S101,
+    S104,
+    S105,
+    S108,
+    S110,
+    S112,
+    S310,
+    S404,
+    S406,
+    S603,
+    S606,
+    S607
+per-file-ignores =
+    culture/protocol/commands.py:S105
+    tests/*:S101,S105,S106

{agentirc_cli-0.20.1 → agentirc_cli-1.0.0}/.github/workflows/publish.yml

@@ -5,12 +5,12 @@ on:
     branches: [main]
     paths:
       - "pyproject.toml"
-      - "agentirc/**"
+      - "culture/**"
   pull_request:
     branches: [main]
     paths:
       - "pyproject.toml"
-      - "agentirc/**"
+      - "culture/**"
 
 permissions:
   contents: read
@@ -54,22 +54,33 @@ jobs:
           echo "DEV_VERSION=${DEV_VERSION}" >> "$GITHUB_ENV"
           echo "Publishing ${DEV_VERSION} to TestPyPI"
 
-      - name: Build and publish agentirc-cli to TestPyPI
+      - name: Build and publish culture to TestPyPI
+        continue-on-error: true
         run: |
           uv build
           uv publish --publish-url https://test.pypi.org/legacy/ --trusted-publishing always --check-url https://test.pypi.org/simple/
 
-      - name: Build and publish agentirc to TestPyPI
+      - name: Build and publish agentirc-cli alias to TestPyPI
+        run: |
+          sed -i 's/^name = "culture"/name = "agentirc-cli"/' pyproject.toml
+          sed -i 's/^description = .*/description = "Legacy alias for culture — install culture instead"/' pyproject.toml
+          rm -rf dist
+          uv build
+          uv publish --publish-url https://test.pypi.org/legacy/ --trusted-publishing always --check-url https://test.pypi.org/simple/
+
+      - name: Build and publish agentirc alias to TestPyPI
         run: |
           sed -i 's/^name = "agentirc-cli"/name = "agentirc"/' pyproject.toml
+          sed -i 's/^name = "culture"/name = "agentirc"/' pyproject.toml
           rm -rf dist
           uv build
           uv publish --publish-url https://test.pypi.org/legacy/ --trusted-publishing always --check-url https://test.pypi.org/simple/
 
       - name: Print install commands
+        if: always()
         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}"
+          echo "::notice::Test with: pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ culture==${DEV_VERSION}"
+          echo "::warning::agentirc on TestPyPI is not intended for production use — install culture instead"
 
   publish:
     if: github.event_name == 'push'
@@ -88,6 +99,24 @@ jobs:
 
       - run: uv sync
 
-      - run: uv build
+      - name: Build and publish culture to PyPI
+        continue-on-error: true
+        run: |
+          uv build
+          uv publish --trusted-publishing always --check-url https://pypi.org/simple/
 
-      - run: uv publish --trusted-publishing always --check-url https://pypi.org/simple/
+      - name: Build and publish agentirc-cli alias to PyPI
+        run: |
+          sed -i 's/^name = "culture"/name = "agentirc-cli"/' pyproject.toml
+          sed -i 's/^description = .*/description = "Legacy alias for culture — install culture instead"/' pyproject.toml
+          rm -rf dist
+          uv build
+          uv publish --trusted-publishing always --check-url https://pypi.org/simple/
+
+      - name: Build and publish agentirc alias to PyPI
+        run: |
+          sed -i 's/^name = "agentirc-cli"/name = "agentirc"/' pyproject.toml
+          sed -i 's/^name = "culture"/name = "agentirc"/' pyproject.toml
+          rm -rf dist
+          uv build
+          uv publish --trusted-publishing always --check-url https://pypi.org/simple/

{agentirc_cli-0.20.1 → agentirc_cli-1.0.0}/.github/workflows/security-checks.yml

@@ -26,11 +26,11 @@ jobs:
       - run: uv sync
 
       - name: Run Bandit
-        run: uv run bandit -r agentirc/ -f json -o bandit-results.json -c pyproject.toml
+        run: uv run bandit -r culture/ -f json -o bandit-results.json -c pyproject.toml
         continue-on-error: true
 
       - name: Run Pylint
-        run: uv run pylint agentirc/ --rcfile=.pylintrc --output-format=json:pylint-results.json,text
+        run: uv run pylint culture/ --rcfile=.pylintrc --output-format=json:pylint-results.json,text
         continue-on-error: true
 
       - name: Run Safety dependency check
@@ -48,7 +48,7 @@ jobs:
 
       - name: Run test coverage
         run: |
-          uv run pytest --cov=agentirc --cov-report=xml:coverage.xml --cov-report=term -v
+          uv run pytest --cov=culture --cov-report=xml:coverage.xml --cov-report=term -v
         continue-on-error: true
 
   dependency-review:

{agentirc_cli-0.20.1 → agentirc_cli-1.0.0}/.github/workflows/tests.yml

@@ -40,7 +40,7 @@ jobs:
       - name: Check if code changed
         id: changes
         run: |
-          CODE_CHANGED=$(git diff --name-only origin/main...HEAD -- 'agentirc/' 'pyproject.toml' 'tests/' | head -1)
+          CODE_CHANGED=$(git diff --name-only origin/main...HEAD -- 'culture/' 'pyproject.toml' 'tests/' | head -1)
           if [ -z "$CODE_CHANGED" ]; then
             echo "skip=true" >> "$GITHUB_OUTPUT"
             echo "Only docs/config changed — skipping version check"

{agentirc_cli-0.20.1 → agentirc_cli-1.0.0}/.pre-commit-config.yaml

@@ -37,6 +37,6 @@ repos:
 
   - id: pylint
     name: pylint
-    entry: uv run pylint --rcfile=.pylintrc
+    entry: uv run pylint --rcfile=.pylintrc --fail-under=9.0
     language: system
     types: [python]

{agentirc_cli-0.20.1 → agentirc_cli-1.0.0}/.pylintrc

@@ -2,18 +2,28 @@
 ignore=CVS
 persistent=yes
 load-plugins=
+fail-under=9
 
 [MESSAGES CONTROL]
 disable=
+    C0103,  # invalid-name (short vars in tests/loops)
     C0114,  # missing-module-docstring
     C0115,  # missing-class-docstring
     C0116,  # missing-function-docstring
     C0301,  # line-too-long (handled by black)
     C0303,  # trailing-whitespace
+    C0415,  # import-outside-toplevel (lazy imports for circular deps)
+    C1803,  # use-implicit-booleaness-not-comparison
     R0801,  # duplicate-code (assimilai pattern: backends share identical files)
     R0903,  # too-few-public-methods
+    R0912,  # too-many-branches
     R0913,  # too-many-arguments
+    R0915,  # too-many-statements
+    W0212,  # protected-access (tests access internals)
     W0511,  # fixme
+    W0612,  # unused-variable
+    W0613,  # unused-argument (pytest fixtures)
+    W0621,  # redefined-outer-name (pytest fixtures)
     W0718,  # broad-exception-caught (async server/daemon must catch broadly)
     W0719,  # broad-exception-raised
     W1202,  # logging-format-interpolation

{agentirc_cli-0.20.1 → agentirc_cli-1.0.0}/CHANGELOG.md

@@ -4,8 +4,36 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
-## [0.20.1] - 2026-04-03
+## [1.0.0] - 2026-04-05
+
+
+### Changed
+
+- **BREAKING:** Renamed package from agentirc-cli to culture. CLI command is now culture. Config directory is now ~/.culture/. Environment variable AGENTIRC_NICK is now CULTURE_NICK. agentirc-cli and agentirc remain as PyPI aliases.
+
+## [0.21.0] - 2026-04-04
+
+### Changed
+
+- **BREAKING:** Renamed package from `agentirc-cli` to `culture`. `agentirc-cli` and `agentirc` remain as PyPI aliases. CLI command is now `culture`. Config directory is now `~/.culture/`. Environment variable `AGENTIRC_NICK` is now `CULTURE_NICK`.
+
+### Added
+
+- Bots framework — server-managed virtual IRC users triggered by external events
+- Inbound webhook support via companion HTTP listener on configurable port
+- Bot CLI commands: create, start, stop, list, inspect
+- Template engine for webhook payload rendering with {body.field} dot-path substitution
+- Custom handler.py support for advanced bot logic
+- Bot visibility in status and overview commands
+- VirtualClient for bot IRC presence in channels
+
+### Changed
+
+- Server now starts a companion HTTP listener for bot webhooks
+- Overview collector and renderer include bot information
+- Channel._local_members() excludes VirtualClient from auto-operator promotion
 
+## [0.20.1] - 2026-04-03
 
 ### Changed
 
@@ -17,7 +45,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.20.0] - 2026-04-03
 
-
 ### Added
 
 - Bandit SAST security scanning
@@ -34,7 +61,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.19.0] - 2026-04-03
 
-
 ### Added
 
 - Conversation threads — inline sub-conversations with [thread:name] prefix
@@ -46,7 +72,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.18.0] - 2026-04-03
 
-
 ### Added
 
 - Conversation threads — inline sub-conversations with [thread:name] prefix
@@ -63,7 +88,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 - --foreground flag for server start and agent start (required by service managers)
 - Windows platform support guards (no fork, SIGTERM fallback)
 
-
 ### Changed
 
 - S2S links now auto-retry on initial startup failure
@@ -72,7 +96,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.17.0] - 2026-04-01
 
-
 ### Added
 
 - Two-tier skill system: root-level admin skill (server setup, mesh linking, federation, agent lifecycle) and project-level messaging skill
@@ -82,7 +105,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.16.4] - 2026-04-01
 
-
 ### Changed
 
 - Rewrote UC-03 Cross-Server Delegation with Jetson dependency resolution scenario
@@ -90,34 +112,29 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.16.3] - 2026-04-01
 
-
 ### Added
 
 - Federation mesh example in README and index — 3-server topology diagram with CLI commands
 
 ## [0.16.2] - 2026-03-31
 
-
 ### Fixed
 
 - Documentation-code alignment: missing CLI flags, config fields, protocol specs, and README links
 
 ## [0.16.1] - 2026-03-31
 
-
 ### Changed
 
 - Revamped README, docs index, and pyproject.toml description with new landing page design
 
 ## [0.16.0] - 2026-03-31
 
-
 ### Added
 
 - Generic ACP backend — supports Cline, OpenCode, Kiro, Gemini, and any ACP-compatible agent via configurable spawn command
 - CLI --agent acp with --acp-command flag for registering ACP agents
 
-
 ### Changed
 
 - Replaced OpenCode-specific backend with generic ACP backend (clients/acp/)
@@ -126,14 +143,12 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.15.2] - 2026-03-31
 
-
 ### Changed
 
 - Extended .pr_agent.toml with harness conformance checks for cross-backend validation
 
 ## [0.15.1] - 2026-03-30
 
-
 ### Fixed
 
 - Overview serve: flush stdout so port URL is visible when backgrounded
@@ -141,7 +156,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.15.0] - 2026-03-30
 
-
 ### Added
 
 - Managed rooms with rich metadata (ROOMCREATE, ROOMMETA, ROOMARCHIVE, ROOMKICK, ROOMINVITE)
@@ -152,7 +166,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 - Overview integration showing room/agent tags and metadata
 - Protocol extensions: rooms.md, tags.md
 
-
 ### Changed
 
 - Persistent channels survive when empty (no auto-cleanup)
@@ -162,7 +175,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.14.1] - 2026-03-30
 
-
 ### Fixed
 
 - Web dashboard table rendering (enable mistune table plugin)
@@ -171,7 +183,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.14.0] - 2026-03-30
 
-
 ### Added
 
 - agentirc overview CLI subcommand — mesh-wide situational awareness
@@ -183,7 +194,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.13.1] - 2026-03-30
 
-
 ### Fixed
 
 - Fix OpenCode agent crash (exit code -1) caused by 30s timeout on system prompt session/prompt call
@@ -203,28 +213,24 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.12.1] - 2026-03-29
 
-
 ### Changed
 
 - pr-review skill now checks for existing PRs before adding unrelated work to a branch
 
 ## [0.12.0] - 2026-03-29
 
-
 ### Added
 
 - agentirc learn command — self-teaching prompt for agents to learn IRC tools and create skills
 
 ## [0.11.0] - 2026-03-28
 
-
 ### Added
 
 - agentirc send command for sending messages to channels and agents
 - agentirc status --full flag and per-agent detailed view
 - agentirc sleep/wake commands with configurable schedule (default 23:00-08:00)
 
-
 ### Changed
 
 - Extended IPC protocol with status, pause, and resume handlers
@@ -232,7 +238,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.10.7] - 2026-03-28
 
-
 ### Fixed
 
 - Fix crash with cryptic asyncio Event loop is closed errors when starting agent without IRC server running
@@ -241,21 +246,18 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.10.6] - 2026-03-28
 
-
 ### Changed
 
 - Add start command suggestion to init collision output
 
 ## [0.10.5] - 2026-03-28
 
-
 ### Changed
 
 - Show existing agent config details when init detects a nick collision
 
 ## [0.10.4] - 2026-03-27
 
-
 ### Changed
 
 - Renamed DaRe to DaRIA (Data Refinery Intelligent Agent) in lifecycle guide
@@ -287,12 +289,10 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.10.0] - 2026-03-26
 
-
 ### Added
 
 - Client documentation for Codex, OpenCode, and Copilot backends (7 docs each)
 
-
 ### Changed
 
 - Remove set_directory from all backends — agents stay in their init directory
@@ -301,26 +301,22 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.9.0] - 2026-03-25
 
-
 ### Added
 
 - GitHub Copilot agent harness (Phase 4) using github-copilot-sdk
 
 ## [0.8.0] - 2026-03-24
 
-
 ### Added
 
 - OpenCode agent harness (Phase 3) — opencode acp over ACP/JSON-RPC/stdio
 
-
 ### Changed
 
 - CLI now supports --agent opencode for init, start, and skills install
 
 ## [0.7.0] - 2026-03-24
 
-
 ### Added
 
 - Codex agent backend: agentirc/clients/codex/
@@ -331,7 +327,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 - CLI: agentirc init --agent codex to initialize Codex agents
 - CLI: agentirc start dispatches to Codex daemon when agent=codex
 
-
 ### Changed
 
 - CLI: --agent flag on init subcommand (choices: claude, codex)
@@ -339,7 +334,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.6.0] - 2026-03-24
 
-
 ### Added
 
 - packages/agent-harness/ — assimilai reference for building new agent backends
@@ -347,14 +341,12 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 - Assimilation guide (README.md) with step-by-step instructions
 - agent field in AgentConfig (default: claude, backward compatible)
 
-
 ### Changed
 
 - CLAUDE.md — documented assimilai pattern for agent harness
 
 ## [0.5.0] - 2026-03-24
 
-
 ### Added
 
 - Agent Harness Specification document — defines the expected interfaces for pluggable agent backends
@@ -364,7 +356,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.4.0] - 2026-03-24
 
-
 ### Added
 
 - Link trust levels: full (share all) and restricted (share nothing unless opted in)
@@ -373,7 +364,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 - Mutual +S required for restricted links — both sides must agree
 - Safe default: inbound links from unknown peers default to restricted
 
-
 ### Changed
 
 - Link format extended: name:host:port:password:trust (trust defaults to full)
@@ -381,7 +371,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.3.1] - 2026-03-22
 
-
 ### Added
 
 - Federation setup in Getting Started guide
@@ -390,7 +379,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [0.3.0] - 2026-03-22
 
-
 ### Added
 
 - CLI command: agentirc skills install <claude|codex|all>
@@ -398,21 +386,18 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 - Codex-compatible skill layout in plugins/codex/
 - Three install methods: CLI, plugin marketplace, Codex skill installer
 
-
 ### Changed
 
 - Getting Started guide updated with skills install command
 
 ## [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

{agentirc_cli-0.20.1 → agentirc_cli-1.0.0}/CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## 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.
+**culture** — 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`
 
@@ -18,7 +18,8 @@ Design spec: `docs/superpowers/specs/2026-03-19-agentirc-design.md`
 Code in `packages/` is **reference implementation** — copied, not imported. Each target directory owns its copy and can modify it independently. No cross-directory imports between backends.
 
 For agent backends (`clients/claude/`, `clients/codex/`, etc.):
-1. Copy from `packages/agent-harness/` into `agentirc/clients/<backend>/`
+
+1. Copy from `packages/agent-harness/` into `culture/clients/<backend>/`
 2. Replace `agent_runner.py` and `supervisor.py` with your implementation
 3. Adapt `daemon.py` to wire up your runner
 4. Each file is yours to modify — no shared imports to break
@@ -34,7 +35,7 @@ When implementing features, write a corresponding markdown doc in `docs/` descri
 ## Git Workflow
 
 - Branch out for all changes
-- **Bump the version before creating a PR** — use `/version-bump patch` (bug fix), `minor` (new feature), or `major` (breaking change). This updates `pyproject.toml`, `agentirc/__init__.py`, and `CHANGELOG.md` in one step. Forgetting will fail the version-check CI job.
+- **Bump the version before creating a PR** — use `/version-bump patch` (bug fix), `minor` (new feature), or `major` (breaking change). This updates `pyproject.toml`, `culture/__init__.py`, and `CHANGELOG.md` in one step. Forgetting will fail the version-check CI job.
 - Push to GitHub for agentic code review
 - Pull review comments, address feedback, push fixes
 - Reply to comments after pushing, resolve threads