agentirc-cli 7.0.4__tar.gz → 7.1.1__tar.gz

agentirc_cli-7.1.1/.markdownlint-cli2.yaml

@@ -0,0 +1,30 @@
+# culture project markdownlint-cli2 configuration
+# Consumed by the markdownlint-cli2 pre-commit hook (see .pre-commit-config.yaml).
+
+config:
+  default: true
+  # MD013: Line length — too noisy for content-heavy docs
+  MD013: false
+  # MD060: Table pipe spacing — stylistic preference
+  MD060: false
+  # MD024: Duplicate headings — allow siblings_only so the Keep-a-Changelog
+  # pattern (### Added / ### Changed / ### Fixed repeated per release) passes.
+  MD024:
+    siblings_only: true
+  # MD025: Multiple top-level H1s — Jekyll pages derive an H1 from front
+  # matter, so additional `# Heading` in body content is legitimate.
+  MD025: false
+  # MD033: Inline HTML — Jekyll docs use inline HTML for hero sections,
+  # badges, and collapsible details.
+  MD033: false
+  # MD041: First line must be H1 — Jekyll front matter precedes content,
+  # so this rule doesn't fit the repo's doc layout.
+  MD041: false
+
+# Ignore patterns
+ignores:
+  - "node_modules/**"
+  - ".local/**"
+  - "_site/**"             # default Jekyll build output
+  - "_site_*/**"           # per-site Jekyll build outputs (agentirc, culture)
+  - "docs/superpowers/**"  # internal plan/spec drafts

{agentirc_cli-7.0.4 → agentirc_cli-7.1.1}/.pre-commit-config.yaml

@@ -40,3 +40,9 @@ repos:
     entry: uv run pylint --rcfile=.pylintrc --fail-under=9.0
     language: system
     types: [python]
+
+- repo: https://github.com/DavidAnson/markdownlint-cli2
+  rev: v0.22.0
+  hooks:
+  - id: markdownlint-cli2
+    files: \.md$

{agentirc_cli-7.0.4 → agentirc_cli-7.1.1}/CHANGELOG.md

@@ -4,8 +4,28 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
-## [7.0.4] - 2026-04-17
+## [7.1.1] - 2026-04-17
+
+### Changed
+
+- Added markdownlint-cli2 to the pre-commit hook set via the upstream DavidAnson/markdownlint-cli2 repo. Contributors running `pre-commit install` now get markdown linting on staged .md files automatically — no system install required (pre-commit provisions its own Node environment).
+- Tuned .markdownlint-cli2.yaml to fit the repo's existing conventions: MD024 uses `siblings_only` so Keep-a-Changelog headings pass; MD025/MD033/MD041 disabled for Jekyll pages that derive their H1 from front matter and use inline HTML; added `_site_*/**` and `docs/superpowers/**` to ignores.
+- Merged duplicated `### Changed` blocks inside CHANGELOG [0.21.0] that the new lint rule surfaced.
+
+## [7.1.0] - 2026-04-17
+
+### Changed
+
+- Refactored `_handle_channel_mode` in `culture/agentirc/client.py`: extracted `_apply_mode_char` and `_broadcast_mode_change` helpers to drop cognitive complexity from 21 to ≤15 (SonarCloud S3776)
+- Background task GC safety in `ircd.py` `_notify_local_quit`: `asyncio.ensure_future` replaced with a tracked `asyncio.create_task` using the existing `self._background_tasks` set + `add_done_callback(discard)` pattern
+
+### Fixed
+
+- culture mesh update no longer hangs on broken/unresponsive systemd units — all subprocess calls in persistence.py and cli/mesh.py now have explicit timeouts (30s for service restarts, 30s for CLI fallbacks, 120s for package upgrade)
+- fires_event chain not triggering downstream bots (#260) — the bot.yaml loader now accepts fires_event at the top level as well as under output:, so configs that put the block at the top level emit events as expected
+- Daemon log flushing stops after startup — replaced logging.basicConfig's default StreamHandler (which inherits stderr buffering from interpreter startup) with an explicit logging.FileHandler so runtime log records flush per-record
 
+## [7.0.4] - 2026-04-17
 
 ### Fixed
 
@@ -13,7 +33,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [7.0.3] - 2026-04-17
 
-
 ### Fixed
 
 - Duplicate _ERR_CHANNEL_PREFIX string in all 5 daemon files (S1192)
@@ -26,7 +45,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [7.0.2] - 2026-04-17
 
-
 ### Fixed
 
 - Cognitive complexity in observer.py (CC 22→~13)
@@ -35,7 +53,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [7.0.1] - 2026-04-17
 
-
 ### Fixed
 
 - Wrong AgentConfig/DaemonConfig import types in test helpers (S5655)
@@ -86,26 +103,22 @@ new subsystem, new bot trigger type).
 
 ## [6.2.3] - 2026-04-15
 
-
 ### Changed
 
 - docs: post-#231 retrospective — CLAUDE.md guidance for pre-branch checklist, format-before-commit, pre-push code review, SonarCloud pre-ready; new doc-test-alignment subagent; /pr-review skill step for SonarCloud query
 
 ## [6.2.2] - 2026-04-14
 
-
 ### Fixed
 
 - console: handle BrokenPipeError/ConnectionResetError in _send_raw; surface a red system notice in the chat panel instead of letting the asyncio task crash (#230)
 
 ## [6.2.1] - 2026-04-13
 
-
 ### Added
 
 - Copy-paste guidance in help screen (Shift+drag bypasses TUI mouse capture in modern terminals)
 
-
 ### Fixed
 
 - #227: Tab now cycles channels (added priority=True to override Textual Screen focus-cycling)
@@ -116,33 +129,28 @@ new subsystem, new bot trigger type).
 
 ## [6.2.0] - 2026-04-12
 
-
 ### Added
 
 - Agent status indicators in console sidebar (#218) — shows working/idle/paused/circuit-open for each agent
 - Auto-read channel history on switch (#219) — loads last 20 messages when switching channels via Tab, sidebar click, or /join
 - Help menu — /help command and Ctrl+H keybinding showing all commands and keybindings
 
-
 ### Fixed
 
 - Joined message no longer wiped by channel switch clear_log
 
 ## [6.1.1] - 2026-04-11
 
-
 ### Changed
 
 - Remove Python API sections from all backend SKILL.md files — agents should use culture channel CLI exclusively
 
-
 ### Fixed
 
 - IRC skill teaches agents to use internal module path instead of culture CLI (#215)
 
 ## [6.1.0] - 2026-04-10
 
-
 ### Added
 
 - Two-site docs architecture: agentirc.dev (runtime layer) and culture.dev (full solution)
@@ -153,7 +161,6 @@ new subsystem, new bot trigger type).
 - Cross-site linking via _data/sites.yml
 - docs-check CI workflow validating both site builds
 
-
 ### Changed
 
 - Consolidated 23 per-backend harness docs into 4 single-page references
@@ -163,14 +170,12 @@ new subsystem, new bot trigger type).
 
 ## [6.0.2] - 2026-04-10
 
-
 ### Changed
 
 - AgentIRC local docs with Jekyll pipeline copy step
 
 ## [6.0.1] - 2026-04-10
 
-
 ### Fixed
 
 - agent create/join/delete/archive/unarchive/rename crash with manifest-format server.yaml (#208)
@@ -179,7 +184,6 @@ new subsystem, new bot trigger type).
 
 ## [6.0.0] - 2026-04-10
 
-
 ### Changed
 
 - **BREAKING:** Renamed internal Python package `culture.server` to `culture.agentirc`. All imports must update from `culture.server.*` to `culture.agentirc.*`. CLI command `culture server` and config path `~/.culture/server.yaml` are unchanged.
@@ -187,7 +191,6 @@ new subsystem, new bot trigger type).
 
 ## [5.0.4] - 2026-04-10
 
-
 ### Fixed
 
 - Reduce cognitive complexity of _cmd_topic in channel CLI
@@ -195,19 +198,16 @@ new subsystem, new bot trigger type).
 
 ## [5.0.3] - 2026-04-10
 
-
 ### Added
 
 - New channel subcommands: join, part, ask, topic, compact, clear
 
-
 ### Changed
 
 - Channel CLI routes through agent daemon IPC when CULTURE_NICK is set
 - All SKILL.md files and learn prompt use culture channel CLI instead of python3 -m
 - Mesh update readiness probe verifies PID-based server identity
 
-
 ### Fixed
 
 - culture channel message sends as agent nick instead of temporary peek nick (#203)
@@ -215,7 +215,6 @@ new subsystem, new bot trigger type).
 
 ## [5.0.2] - 2026-04-09
 
-
 ### Fixed
 
 - Handle missing credential tool (secret-tool/security/powershell) gracefully instead of crashing the server
@@ -223,14 +222,12 @@ new subsystem, new bot trigger type).
 
 ## [5.0.1] - 2026-04-09
 
-
 ### Added
 
 - Topic subcommand for IRC skill (#192)
 - @mention validation warnings for unknown nicks (#196)
 - GitHub issues skill for Claude Code
 
-
 ### Fixed
 
 - Whitespace-only messages now rejected (#195)
@@ -241,12 +238,10 @@ new subsystem, new bot trigger type).
 
 ## [5.0.0] - 2026-04-09
 
-
 ### Added
 
 - Mesh overview shows stopped/registered agents from server.yaml manifest (#178)
 
-
 ### Changed
 
 - CLI docs use correct noun-group syntax (culture agent create, culture channel read, etc.) (#186)
@@ -254,14 +249,12 @@ new subsystem, new bot trigger type).
 - All doc references updated from agents.yaml to server.yaml (#188)
 - Documented --mesh-config, --webhook-port, --data-dir server start flags (#189)
 
-
 ### Fixed
 
 - Mesh overview now includes agents that are registered but not running
 
 ## [4.5.2] - 2026-04-09
 
-
 ### Fixed
 
 - Agent status now reports the circuit-open state correctly instead of showing running (#179)
@@ -273,14 +266,12 @@ new subsystem, new bot trigger type).
 
 ## [4.5.1] - 2026-04-09
 
-
 ### Fixed
 
 - Fix mesh overview crash after agent config migration (str has no attribute items)
 
 ## [4.5.0] - 2026-04-09
 
-
 ### Added
 
 - Decentralized agent configuration with per-directory culture.yaml files
@@ -290,16 +281,13 @@ new subsystem, new bot trigger type).
 - Unified culture/config.py module with AgentConfig, ServerConfig, auto-detection
 - culture.yaml definitions for harness template and backend agents (#harness channel)
 
-
 ### Changed
 
 - Agent config split: per-agent settings in culture.yaml, server settings in server.yaml
 - CLI agent commands now support both server.yaml and legacy agents.yaml formats
 
-
 ## [4.4.3] - 2026-04-08
 
-
 ### Changed
 
 - Regenerate all favicons, including `/favicon.ico` and `/assets/images/favicon.ico`, from the source image with proper cropping and optimization
@@ -308,7 +296,6 @@ new subsystem, new bot trigger type).
 
 ## [4.4.2] - 2026-04-08
 
-
 ### Fixed
 
 - Codex/copilot: preserve HOME for auth tokens instead of isolating (#159)
@@ -321,7 +308,6 @@ new subsystem, new bot trigger type).
 
 ## [4.4.1] - 2026-04-07
 
-
 ### Fixed
 
 - Config save operations no longer strip backend-specific fields like acp_command (#150)
@@ -334,13 +320,11 @@ new subsystem, new bot trigger type).
 
 ## [4.4.0] - 2026-04-07
 
-
 ### Added
 
 - SQLite-backed persistent channel history (survives server restarts)
 - --data-dir CLI flag for server start (default: ~/.culture/data)
 
-
 ### Fixed
 
 - Multi-line messages truncated to first line in send_privmsg and thread methods
@@ -348,7 +332,6 @@ new subsystem, new bot trigger type).
 
 ## [4.3.7] - 2026-04-07
 
-
 ### Fixed
 
 - Extract duplicate string constants (S1192, #85)
@@ -360,12 +343,10 @@ new subsystem, new bot trigger type).
 
 ## [4.3.6] - 2026-04-07
 
-
 ### Changed
 
 - CLI module docstring updated with current subcommand sets (#147)
 
-
 ### Fixed
 
 - agent message silently succeeds for nonexistent targets (#132)
@@ -385,14 +366,12 @@ new subsystem, new bot trigger type).
 
 ## [4.3.5] - 2026-04-07
 
-
 ### Changed
 
 - Reduce cognitive complexity in 30+ functions across backend clients, server code, CLI submodules, and standalone files to meet SonarCloud threshold (≤15)
 
 ## [4.3.4] - 2026-04-07
 
-
 ### Changed
 
 - Extract duplicated string literals into named constants (SonarCloud S1192)
@@ -400,54 +379,46 @@ new subsystem, new bot trigger type).
 
 ## [4.3.3] - 2026-04-07
 
-
 ### Changed
 
 - Reduced cognitive complexity in 40 functions across 25 files to meet SonarCloud threshold (≤15)
 
 ## [4.3.2] - 2026-04-07
 
-
 ### Changed
 
 - Reduced cognitive complexity in 13 functions across 6 files by extracting helpers and flattening control flow (SonarCloud S3776)
 
 ## [4.3.1] - 2026-04-07
 
-
 ### Fixed
 
 - Remove unnecessary list() wrapping on already-iterable values (SonarCloud S7504/S7494)
 
 ## [4.3.0] - 2026-04-07
 
-
 ### Added
 
 - agent delete command to remove agents from config entirely
 - agent create now overwrites archived agents, enabling harness/model migration
 
-
 ### Fixed
 
 - agent create no longer blocks when the matching nick is archived
 
 ## [4.2.1] - 2026-04-07
 
-
 ### Changed
 
 - Update dispatch patterns to use declarative maybe_await() utility for handling both sync and async handlers
 - Remove unnecessary async keyword from ~40 handler functions that never use await
 
-
 ### Fixed
 
 - SonarCloud S7503: async functions that never await (issue #83)
 
 ## [4.2.0] - 2026-04-07
 
-
 ### Added
 
 - Archive and unarchive commands for servers, agents, and bots
@@ -458,21 +429,18 @@ new subsystem, new bot trigger type).
 
 ## [4.1.3] - 2026-04-06
 
-
 ### Fixed
 
 - mesh update now discovers and restarts all running servers instead of only the one in mesh.yaml
 
 ## [4.1.2] - 2026-04-06
 
-
 ### Fixed
 
 - Clean up _mention_targets deque on prompt failure to prevent misrouted responses
 
 ## [4.1.1] - 2026-04-06
 
-
 ### Fixed
 
 - Fix ACP/Codex/Copilot poll loop to use fire-and-forget (race condition fix)
@@ -481,7 +449,6 @@ new subsystem, new bot trigger type).
 
 ## [4.1.0] - 2026-04-06
 
-
 ### Added
 
 - Channel polling: agents periodically check channels for unread messages (configurable via poll_interval, default 5 minutes)
@@ -489,13 +456,11 @@ new subsystem, new bot trigger type).
 
 ## [4.0.0] - 2026-04-06
 
-
 ### Added
 
 - culture agent message and culture agent read for DM operations
 - culture channel message and culture channel who for channel operations
 
-
 ### Changed
 
 - Reorganized CLI into noun-first command groups: agent, server, mesh, channel, bot, skills
@@ -504,21 +469,18 @@ new subsystem, new bot trigger type).
 
 ## [3.1.2] - 2026-04-06
 
-
 ### Fixed
 
 - culture update used wrong package name (culture-cli) for uv tool upgrade
 
 ## [3.1.1] - 2026-04-06
 
-
 ### Fixed
 
 - culture update and setup auto-generate mesh.yaml from agents.yaml when mesh.yaml is missing
 
 ## [3.1.0] - 2026-04-06
 
-
 ### Added
 
 - culture server rename — rename server and all its agent nick prefixes
@@ -527,7 +489,6 @@ new subsystem, new bot trigger type).
 
 ## [3.0.2] - 2026-04-06
 
-
 ### Fixed
 
 - Server startup readiness — culture server start now waits for port to accept connections before returning
@@ -535,14 +496,12 @@ new subsystem, new bot trigger type).
 
 ## [3.0.1] - 2026-04-06
 
-
 ### Fixed
 
 - Fix empty error message when running `culture overview` against a starting or unreachable server
 
 ## [3.0.0] - 2026-04-06
 
-
 ### Added
 
 - Console chat TUI for human participation in the IRC mesh (culture console)
@@ -555,14 +514,12 @@ new subsystem, new bot trigger type).
 
 ## [2.0.1] - 2026-04-05
 
-
 ### Added
 
 - what-is-culture.md — project philosophy page
 - culture-cli.md — conceptual CLI guide
 - Architecture and Operations index pages for docs navigation
 
-
 ### Changed
 
 - Reorganize docs/ — architecture files to docs/architecture/, operations files to docs/operations/
@@ -571,25 +528,20 @@ new subsystem, new bot trigger type).
 
 ## [2.0.0] - 2026-04-05
 
-
 ### Added
 
-
 ### Changed
 
-
 ### Fixed
 
 ## [1.1.0] - 2026-04-05
 
-
 ### Added
 
 - culture create command (replaces init for agent creation)
 - culture join command (create + start in one step)
 - Promote phase documented as upcoming feature
 
-
 ### Changed
 
 - Agent lifecycle reframed: Introduce → Educate → Join → Mentor → Promote
@@ -601,7 +553,6 @@ new subsystem, new bot trigger type).
 
 ## [1.0.7] - 2026-04-05
 
-
 ### Fixed
 
 - Validate PID ownership via /proc/<pid>/cmdline before os.kill() to prevent signaling unrelated processes after PID reuse (SonarCloud S4828)
@@ -609,44 +560,39 @@ new subsystem, new bot trigger type).
 
 ## [1.0.6] - 2026-04-05
 
-
 ### Added
 
 - Project-local run-tests skill for portable pytest execution
 
 ## [1.0.5] - 2026-04-05
 
-
 ### Changed
 
-- Extract helper methods from socket_server _handle_client (all backends)
-- Convert irc_transport _handle to dispatch table (all backends)
-- Extract _auto_approve and _flush_accumulated_text in codex/acp agent_runner
-- Extract _handle_session_update and _extract_response_text in acp/copilot agent_runner
-- Decompose _handle_roommeta into query/update methods in rooms.py
-- Extract _merge_room_metadata in server_link.py
-- Extract _attempt_single_reconnect in ircd.py
-- Extract _create_agent_config and _try_ipc_shutdown/_try_pid_shutdown in cli.py
+- Extract helper methods from `socket_server._handle_client` (all backends)
+- Convert `irc_transport._handle` to dispatch table (all backends)
+- Extract `_auto_approve` and `_flush_accumulated_text` in codex/acp `agent_runner`
+- Extract `_handle_session_update` and `_extract_response_text` in acp/copilot `agent_runner`
+- Decompose `_handle_roommeta` into query/update methods in `rooms.py`
+- Extract `_merge_room_metadata` in `server_link.py`
+- Extract `_attempt_single_reconnect` in `ircd.py`
+- Extract `_create_agent_config`, `_try_ipc_shutdown`, and `_try_pid_shutdown` in `cli.py`
 - Update packages/agent-harness templates to match backend features
 - Add socket_server and irc_transport to sonar CPD exclusions
 
 ## [1.0.4] - 2026-04-05
 
-
 ### Changed
 
 - Reduced cognitive complexity of 76 high-complexity functions across daemon.py (5 files), server_link.py, threads.py, cli.py, and ircd.py by replacing if/elif chains with dispatch tables and extracting named logic units
 
 ## [1.0.3] - 2026-04-05
 
-
 ### Changed
 
 - Parallelize test suite with pytest-xdist for ~15x speedup (10min → 40s)
 
 ## [1.0.2] - 2026-04-05
 
-
 ### Fixed
 
 - Re-raise asyncio.CancelledError after cleanup to fix cancellation propagation (SonarCloud S7497)
@@ -654,24 +600,18 @@ new subsystem, new bot trigger type).
 
 ## [1.0.1] - 2026-04-05
 
-
 ### Fixed
 
 - Remove agentirc legacy alias from production PyPI publish pipeline
 
 ## [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
@@ -684,6 +624,7 @@ new subsystem, new bot trigger type).
 
 ### 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`.
 - 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

{agentirc_cli-7.0.4 → agentirc_cli-7.1.1}/CLAUDE.md

@@ -71,7 +71,7 @@ Before the first push on a branch that adds public API surface (new exceptions,
 
 ## Format Before Commit
 
-Pre-commit runs `black`, `isort`, `flake8`, `pylint`, `bandit`. `black`/`isort` failures reformat the file and reject the commit — you then have to `git add` the reformatted file and commit again. To avoid the re-commit loop, run `uv run black <files>` and `uv run isort <files>` on staged Python files **before** `git commit`.
+Pre-commit runs `black`, `isort`, `flake8`, `pylint`, `bandit`, `markdownlint-cli2`. `black`/`isort` failures reformat the file and reject the commit — you then have to `git add` the reformatted file and commit again. To avoid the re-commit loop, run `uv run black <files>` and `uv run isort <files>` on staged Python files **before** `git commit`. Markdown rules live in `.markdownlint-cli2.yaml` (tuned for Keep-a-Changelog via MD024 `siblings_only` and Jekyll pages via MD025/MD033/MD041 off).
 
 ## Nick Format
 

{agentirc_cli-7.0.4 → agentirc_cli-7.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 7.0.4
+Version: 7.1.1
 Summary: Legacy alias for culture — install culture instead
 Project-URL: Homepage, https://github.com/OriNachum/culture
 Author: Ori Nachum