Commit Graph

29 Commits

Author SHA1 Message Date
3b2edd4a9e feat: scheduled agent execution via activity-core (WP-0006, v1.3.0)
Enable kaizen agents to run on a regular cadence against a preselected repo
roster, orchestrated by activity-core and prepared by kaizen-agentic — without
this repo owning cron, Temporal workers, or an LLM runtime.

CLI + module:
- src/kaizen_agentic/schedule.py — .kaizen/schedule.yml parse/validate/scaffold
- `kaizen-agentic schedule` group: init, validate, list, prepare <agent>
  (prepare bundles agent prompt + memory + metrics + repo pointers, offline)
- tests/test_schedule_cli.py — 15 tests

Contract & design:
- ADR-005 scheduled agent execution; schema doc + example manifest
- discover_kaizen_scheduled_repos resolver spec, state-hub roster fields,
  kaizen.schedule.prepared event payload, activity-core handoff checklist
- INTEGRATION_PATTERNS Pattern 2 extended with roster model

ActivityDefinition drafts (enabled: false):
- weekly-coach-orientation, weekly-optimization-review

Docs: agency-framework, CLI cheat sheet, PACKAGE_RELEASE runner prereqs,
EcosystemIntegration, CHANGELOG, TODO. Workplan closed (status: done).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 08:19:51 +02:00
297afed823 release: v1.2.0 — adoption polish and publish pipeline (WP-0005)
Some checks failed
ci / test (push) Failing after 35s
Publish Python package / publish (push) Successful in 3m46s
Bump version to 1.2.0. Fleet parity, install doc sync, Gitea publish workflow
fixes, and Helix reciprocal doc link. Closes KAIZEN-WP-0005.
2026-06-17 00:53:12 +02:00
c004c3d4d7 feat: WP-0005 adoption polish — doc sync, fleet parity, CI lint
Some checks failed
ci / test (3.10) (push) Has been cancelled
ci / test (3.12) (push) Has been cancelled
- Add make agents-sync-package and release-check parity gate
- Add tests/test_packaged_agents_parity.py; sync packaged agents with agents/
- Update install docs (HELLO_WORLD, CLI_CHEAT_SHEET, AGENT_DISTRIBUTION)
- Expand PACKAGE_RELEASE.md secrets setup and pre-tag checklist
- Add flake8 to Gitea CI; CHANGELOG Unreleased for v1.2.0
- Expand INTEGRATION_PATTERNS activity-core handoff checklist
2026-06-16 02:26:13 +02:00
68555ec2f1 fix: release-check lint fixes for 1.1.0 publish
Some checks failed
ci / test (3.10) (push) Has been cancelled
ci / test (3.12) (push) Has been cancelled
Wrap long lines for flake8, rename extensions remove command handler
to avoid Click shadowing, and drop unused migration imports.
2026-06-16 02:14:07 +02:00
22ee93e125 WP-0001 complete: v1.1.0 lazy registry and install performance
Some checks failed
ci / test (3.12) (push) Has been cancelled
ci / test (3.10) (push) Has been cancelled
Lazy-load agent registry (frontmatter index, parse on demand), copy
agents by path during install, fix Makefile template tab lint issue,
add registry performance tests, bump to 1.1.0, document CLI reinstall
after pull.
2026-06-16 02:06:43 +02:00
80c60ebd7a WP-0001: feedback channels, CI, pre-commit, telemetry docs
Some checks failed
ci / test (3.12) (push) Has been cancelled
ci / test (3.10) (push) Has been cancelled
Add kaizen-agentic feedback CLI, Gitea issue templates, CI workflow,
pre-commit hooks, FEEDBACK/TELEMETRY docs, and cross-platform path tests.
Improve CLI registry error messages; remove agents_backup scaffolding.
Apply black formatting across src/tests for CI consistency.

State Hub message sent to agentic-resources for Helix correlation doc link.
2026-06-16 01:58:07 +02:00
b48a2102d7 WP-0004: ecosystem integration complete
Add Helix Forge correlation (HELIX_SESSION_UID env, metrics correlate),
artifact-store publish (metrics publish), activity-core ActivityDefinition
references, integration patterns docs, and canon/knowledge design artifacts.
2026-06-16 01:53:01 +02:00
4a9c2d9bea WP-0003 Part 6: packaging sync and docs close-out
Sync coach, sys-medic, scope-analyst, optimization, and updated
tdd-workflow to packaged data (20 agents). Update architecture.md,
README orientation, and CHANGELOG for the metrics loop. Mark WP-0003
completed.
2026-06-16 01:49:27 +02:00
04fdc249f5 Bridge Coach memory brief with project metrics summaries.
Add Performance Summary block to memory brief, document metrics synthesis in
agent-coach, and add e2e and CLI tests for qualitative plus quantitative briefs.
2026-06-16 01:46:51 +02:00
2711a3ebcc Wire OptimizationLoop to project metrics and add metrics optimize.
Add from_metrics_store factory, OptimizerStore persistence, metrics optimize
CLI, consolidate duplicate optimization agent, and add integration tests.
2026-06-16 01:41:26 +02:00
97b7eb8cba Add metrics CLI for project-scoped agent performance records.
Implement record, show, list, and export commands; document session-close
protocol template; extend cheat sheet and agency-framework docs; add CLI tests.
2026-06-16 01:38:42 +02:00
5cd3da3166 Implement MetricsStore for project-scoped agent metrics.
Add ADR-004 storage layer with append-only executions, summary
regeneration, idempotency keys, and retention pruning. Wire memory init
to scaffold .kaizen/metrics/ by default and add unit tests.
2026-06-16 01:35:27 +02:00
07c4a70907 feat(agency): complete WP-0002 Part 3 — E2E tests, docs, sys-medic cross-refs, bugfix
T25: add tests/test_e2e_agency_framework.py — 16 E2E tests covering the full
memory lifecycle (init, show, brief, clear) and protocol list/show commands.

T26: replace agency-framework.md protocols placeholder with full documentation —
location convention, frontmatter schema, CLI reference, sys-medic memory
extensions, and protocols table.

T27: add Related Documents footer to agent-sys-medic.md linking to the k3s
protocol runbook, ADR-002, ADR-003, and agency-framework.md.

Fix: rename CLI command function list() → list_agents() to stop it shadowing
Python's built-in list(). The shadow caused memory_brief() to invoke the
agent-list command instead of constructing a list from dict keys, producing
the agent list as output on every `memory brief` invocation.

All 27 WP-0002 tasks complete. Test suite: 51 passed, 1 skipped.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-19 00:27:39 +00:00
53dfd55916 feat(protocols): add protocols artifact convention, sys-medic protocol + CLI (WP-0002 T17-T24)
- ADR-003: protocols artifact convention (location, structure, lifecycle)
- agents/protocols/README.md: directory-level index and usage guide
- agents/protocols/sys-medic/k3s-node-health-assessment.md: full structured
  k3s node health assessment protocol (8 steps: OS baseline, process hygiene,
  memory, CPU, disk, network, k3s node state, runtime services)
- agent-sys-medic.md: add memory: enabled frontmatter, session-start/close
  protocols, node-profile memory template extensions, protocol reference in
  Default Task
- cli.py: add protocols command group (list, show); extend memory init to hint
  protocol commands for agents that have protocols

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 23:48:09 +00:00
23345cc5fd feat(agency): add coach meta-agent and complete memory brief command (WP-0002 T12-T14)
- Add agents/agent-coach.md: new meta-category coaching agent that reads
  all project agent memories, synthesises cross-agent briefs, and produces
  targeted orientation briefs for incoming agents
- Complete memory brief command: now reads all .kaizen/agents/*/memory.md,
  formats structured orientation output following coach agent spec, adds
  --raw flag for unformatted dump
- Coach validates and appears under kaizen-agentic list --category meta

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 23:41:17 +00:00
260b9b27e9 feat(agency): add session protocols to agents and memory field to schema
- CONTRIBUTING.md: add Session Start/Close protocol reference with YAML
  frontmatter schema (including new memory: enabled|disabled field)
- agents: add ## Session Start / ## Session Close blocks to
  project-management, tdd-workflow, requirements-engineering, scope-analyst
- registry.py: add AgentCategory.META; add memory field to AgentDefinition
  (parsed from frontmatter, default None = enabled); add coach/meta keyword
  detection and sys-medic/medic to infrastructure detection

WP-0002 T09, T10, T11 done.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 23:33:14 +00:00
4b4b1ff1f1 feat(memory): add memory CLI command group and project memory ADRs
- Add docs/adr/ADR-001-workplan-convention.md (formalises existing convention)
- Add docs/adr/ADR-002-project-memory-convention.md (file location, structure,
  session protocols, opt-out, CLI interface)
- Implement `kaizen-agentic memory` command group: show, init, brief, clear
  - Memory stored at .kaizen/agents/<name>/memory.md in project root
  - `init` scaffolds the standard memory template with YAML frontmatter
  - `brief` lists all agent memories + note that coach synthesis is pending T13
  - `clear` deletes with confirmation prompt

WP-0002 T07 and T08 done.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 23:25:48 +00:00
3858141ce6 Extend update command error handling and update documentation
- Extend safe_cli_wrapper() to suppress spurious Click errors for both
  install and update commands; add success indicators for update output
- Add test_update_command_error_suppression to verify error suppression
- Expand CLAUDE.md to document all 17 agents with categories
- Add Keep a Contributing-File format header to CONTRIBUTING.md
- Fix TodoFileGuide URL reference in TODO.md
- Add RELEASE_NOTES_v1.0.1.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-27 09:02:04 +01:00
167222d45b Release v1.0.2: Extended CLI error suppression and updated documentation
🔧 Extended Click library workaround to cover update command
📚 Updated CLAUDE.md with all 17 agents organized by category
🧪 Added comprehensive test coverage for update command
 All 11 CLI error handling tests pass

Major improvements:
- Both install and update commands now provide clean professional output
- Complete agent ecosystem documentation (17 agents vs previous 6)
- Unified error handling approach across affected CLI commands
- Enhanced test suite covering all CLI error scenarios

User experience: Clean output for kaizen-agentic install/update commands
Technical: Extended safe_cli_wrapper to handle ["install", "update"] commands

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 07:24:29 +02:00
803f032818 Release v1.0.1: Fix CLI error messages and improve user experience
### Key Fixes
- Resolve spurious "Got unexpected extra argument" error messages in Click library
- Fix malformed YAML frontmatter in agent definition files
- Enhance global installation capability with improved make install-global

### Technical Implementation
- Add intelligent CLI error handling with safe_cli_wrapper() function
- Implement comprehensive test suite for error suppression (11 test cases)
- Create detailed documentation and future maintenance guide
- Update entry point to provide clean user experience

### Files Added
- tests/test_cli_error_handling.py - Comprehensive test coverage
- CLICK_WORKAROUND.md - Technical documentation and removal timeline

### Files Modified
- pyproject.toml - Version bump to 1.0.1 and entry point update
- CHANGELOG.md - Detailed release notes for v1.0.1
- README.md - Added known issues section
- src/kaizen_agentic/cli.py - Click error handling implementation
- Multiple agent files - Fixed YAML frontmatter formatting

Resolves: Issue #3 - CLI argument parsing errors and user confusion

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 07:05:32 +02:00
19b3c16cce Include releaseManager agent in package distribution
- Copy agent-releaseManager.md to src/kaizen_agentic/data/agents/
- Ensure releaseManager agent is packaged and distributed with v1.0.0
- Complete v1.0.0 package now includes all 17 agents including release management
- Final package ready for PyPI publication with full feature set

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 21:01:04 +02:00
d68310793b Fix linting violations for v1.0.0 release preparation
- Apply black formatting to all Python files
- Fix various flake8 violations in agent system code
- Clean up imports and whitespace issues

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 20:44:58 +02:00
6fb302075d Implement complete Scenario 2: Integration with existing projects having agents
Built comprehensive system for introducing Kaizen agents to existing projects:

🔍 **Detection System (detection.py)**:
- Detects 9+ types of existing agent systems (Kaizen, Claude Code, custom agents, etc.)
- Analyzes agent files with YAML frontmatter parsing
- Identifies conflicts and functional overlaps
- Generates integration strategies and migration recommendations

🔄 **Migration Framework (migration.py)**:
- Creates detailed migration plans for each detected agent
- Supports 5 migration strategies: replace, extend, preserve, merge, remove
- Intelligent conflict resolution with multiple resolution types
- Safe execution with backup creation and rollback capability

🔗 **Extension System (extensions.py)**:
- Project-specific agent customizations and extensions
- Multiple extension types: config overlay, functional extension, workflow integration
- Template generation for basic and advanced extensions
- Legacy agent integration with wrapper creation

🛠️ **CLI Integration**:
- `kaizen-agentic detect` - Analyze existing agent systems
- `kaizen-agentic migrate` - Execute migration plans with dry-run support
- `kaizen-agentic extensions` - Complete extension management commands

📖 **Integration Patterns Documentation**:
- 5 proven integration scenarios with detailed patterns
- Conflict resolution strategies and decision matrices
- Safe transition strategies with phased rollout
- Best practices and troubleshooting guides

**Key Features**:
 Respects existing project structure and workflows
 Safe transitions with comprehensive backup strategies
 Conflict detection and automated resolution
 Extension mechanisms for preserving custom functionality
 Comprehensive tooling for all transition scenarios

Scenario 2 is now production-ready for integrating Kaizen agents into any existing project!

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 11:47:17 +02:00
ca6909a04f Update documentation for first-time users and fix outdated agent names
Major documentation improvements:
- Fixed all outdated agent names throughout README.md and GETTING_STARTED.md
- Updated agent references from old names (todo-keeper, changelog-keeper, setup-repository)
  to new names (keepaTodofile, keepaChangelog, setupRepository)
- Created comprehensive HELLO_WORLD_TUTORIAL.md with step-by-step guide for new users
- Added prominent tutorial links in README.md and GETTING_STARTED.md for better discoverability
- Updated Python version requirements from 3.8 to 3.9 in project templates
- Enhanced first-time user experience with clear guidance and working examples

Documentation now provides:
 Working commands that match actual agent names
 Clear separation between new users and experienced users
 Complete tutorial from installation to running code
 Proper guidance for scenario one (greenfield projects)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 09:13:50 +02:00
d560d1dcfd Fix failing tests for agent framework updates
Updated test fixtures and expectations to match new agent naming:
- Fixed test registry to use correct agent names (setupRepository, keepaTodofile, keepaChangelog)
- Updated test assertions to expect new agent names instead of old ones
- Added missing category fields to test agent definitions
- Enhanced test registry with keepaChangelog agent for complete template testing

All 24 tests now pass:
- test_core.py: 6 tests 
- test_installer.py: 10 tests 
- test_registry.py: 8 tests 

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 09:07:10 +02:00
da6eee7d47 Fix all flake8 violations across the codebase
CODE STYLE FIXES:
- Fixed line length violations by breaking long lines appropriately
- Removed unused imports (os from installer.py and registry.py)
- Removed unused variables (package_name in _create_pyproject_toml)
- Fixed f-string usage (removed f-strings without placeholders)
- Fixed import organization and removed redundant imports
- Added missing newlines at end of files

SPECIFIC FIXES:
- cli.py: Split long option line, fixed f-string usage, added newline
- installer.py: Removed unused imports/variables, fixed line breaks, improved validation logic
- registry.py: Removed unused import/variable, broke long condition line
- test files: Removed unused imports, fixed long assertion lines, added newlines

All 24 tests still pass and flake8 now reports no violations.
Code is now compliant with PEP 8 style guidelines.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 08:15:42 +02:00
873120c2d3 Fix test failures and rename Makefile targets for consistency
MAKEFILE TARGET RENAMING:
- Renamed agent management targets to use agents- prefix for consistency
- list-agents → agents-list
- update-agents → agents-update
- validate-agents → agents-validate
- agent-status → agents-status
- install-agent-cli → agents-install-cli
- Updated all documentation to reflect new naming convention

TEST FIXES:
- Fixed backup directory collision in tests by adding microseconds and counter
- Improved dependency detection to be more precise and avoid false positives
- Updated dependency parsing to support YAML frontmatter dependencies
- Fixed test expectations to match actual validation behavior
- All 24 tests now passing

DEPENDENCY SYSTEM IMPROVEMENTS:
- Enhanced dependency extraction from YAML frontmatter (dependencies, depends_on, requires)
- More precise agent reference detection in content
- Better handling of explicit vs implicit dependencies
- Improved validation error reporting

This ensures consistent naming convention (setup-, standards-, agents-) across
all Makefile targets while fixing test reliability issues.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 08:03:45 +02:00
38965c1d4a Implement hybrid agent distribution system
Complete implementation of the agent distribution framework including:

CORE INFRASTRUCTURE:
- AgentRegistry: Agent discovery, categorization, and dependency management
- AgentInstaller: Agent installation, updates, and removal with safety measures
- ProjectInitializer: Template-based project initialization with agent integration
- CLI Tool: Comprehensive kaizen-agentic command-line interface

DISTRIBUTION FEATURES:
- Python package distribution with console script entry point
- Agent categorization (project-management, development-process, code-quality, etc.)
- Project templates (python-basic, python-web, python-cli, python-data, comprehensive)
- Dependency resolution and validation
- Idempotent operations with backup and rollback support

CLI COMMANDS:
- kaizen-agentic init: Initialize new projects with agents
- kaizen-agentic install/update/remove: Manage agents in existing projects
- kaizen-agentic list/status/validate: Discovery and maintenance
- kaizen-agentic templates: Project template management

INTEGRATION & DOCUMENTATION:
- Makefile targets for agent management (list-agents, update-agents, etc.)
- Automatic Claude Code configuration updates (CLAUDE.md)
- Comprehensive documentation (GETTING_STARTED, AGENT_DISTRIBUTION, CLI_CHEAT_SHEET)
- Multi-language build system integration examples
- Complete test coverage for all components

PACKAGE STRUCTURE:
- Console script: kaizen-agentic command available globally
- Package data: All agents included for distribution
- Dependencies: click, pyyaml for CLI and parsing
- Testing: Comprehensive test suite for registry and installer

This enables sharing specialized AI agents across projects with easy installation,
updates, and management through both CLI and integrated Makefile targets.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 02:31:15 +02:00
8f5c0a7cc6 Add complete Kaizen Agentic framework foundation
- Essential project files: .gitignore, pyproject.toml, README.md
- Documentation framework: CHANGELOG.md, CONTRIBUTING.md, TODO.md, CLAUDE.md
- 15 specialized agent definitions for comprehensive development workflow
- Core source code structure with optimization framework
- Testing infrastructure with example tests
- Proper Python package structure following PythonVibes standards

This establishes the complete foundation for the AI agent development framework
with agent-driven workflows, continuous improvement principles, and comprehensive
development infrastructure.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 02:07:53 +02:00