- revise module details to reflect current framework structure
- introduce new branches and explain their purposes
- clarify active development status and project history
- setup.sh now creates .trinity/, .seedgo/, .ai_mail.local/ for all 15 branches
- Registry includes commons + skills (was 13, now 15)
- spawn: fix registry format mismatch (dict vs list) that crashed every command on fresh install
- spawn: skip existing files during create (never overwrite)
- README: quick start guide rewritten for new users
- commons/skills README: rebuilt from birthright scaffold to real docs
- .env.example added for OpenAI/OpenRouter API keys
Tested end-to-end in Docker: clone → setup.sh → 15 branches → all identity files valid.
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Full standards audit traced every doc through its checker into the codebase.
All 20 standards rated NEEDS UPDATE. This PR fixes the systemic issues:
Checker bugs fixed:
- encapsulation_check: continue/break bug falsely flagging allowed handlers
- error_handling_check: now accepts canonical prax import (not just shorthand)
- cli_check: import detection now matches aipass.cli prefix (was bare cli.)
- meta_check: AIPass header accepted (was only META), legacy compat preserved
Doc fixes:
- Checker paths corrected in 10 docs (added standards/aipass/ segment)
- naming.md rewritten: marketplace removed, json_handler.py promoted to
standard, verbs descriptive not prescriptive, module naming section added
- imports.md: both prax import forms now valid (canonical + shorthand)
- architecture/testing/trigger/encapsulation/json_structure/cli_flags/
log_handler: stale paths, Dev-Pass refs, outdated data fixed
Code fixes:
- parents[4]→parents[3] in 16 handler files (backup/daemon/memory)
- AIPass header marker in all 42 checker .py files
- pyproject.toml: added pyright to dev deps
- Removed agent_mock_branch template (replaced by builder/birthright)
- Removed stale branch_system_prompt.md files (renamed to aipass_local_prompt.md)
- New devpulse local prompt + FPLAN-0010
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Changed citizen_class from birthright to builder for both external projects.
Manually added missing operational scaffolding (pytest.ini, docs/, .gitignore,
aipass_local_prompt.md) since spawn update can't reach outside src/aipass/.
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Passport had set citizen_class: "birthright" but these branches have full
apps/ with 3-layer architecture. Changed to "builder" and ran spawn update
to add missing operational files (pytest.ini, docs/, tools/, artifacts/,
DASHBOARD, flow.local.md, etc). Seedgo audit now passes on all three.
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
- introduce central system_logs directory for aggregated branch logs
- update logger setup to include dual handlers for system and local logs
- modify discovery and watcher to track system log file paths
- enhance status reporting to show system logs directory
- update .gitignore to exclude *.json files alongside backups
Complete port of The Commons (FPLAN-0411) — a social network for AI branches
with posts, comments, votes, rooms, feeds, artifacts, trading, and more.
- 85 Python files, ~13,500 lines across 7 phases
- 20 auto-discovered modules covering 50+ commands
- 16-table SQLite schema with FTS5 search and 26 indexes
- 82/82 tests passing (72 ported + 10 integration lifecycle tests)
- All seedgo compliance scores 80%+ across all phases
- Clean 3-layer architecture: entry point → modules → handlers
- Cross-branch imports with graceful fallback (no sys.path manipulation)
- .gitignore updated for commons artifacts handler and json_templates
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- add foundational directory structure under src/skills with apps, modules, handlers, catalog, templates, tests, and trinity files
- support three skill tiers: markdown-only, markdown+handler.py, and full 3-layer apps/modules/handlers
- implement skill discovery scanning search paths (.aipass/skills, ~/.aipass/skills, src/skills/catalog)
- support SKILL.md with YAML frontmatter, compatible with OpenClaw format
- implement loader to parse full SKILL.md and optionally import handler.py module
- implement runner to execute skill handlers or display markdown instructions if no handler
- add skill creator scaffolding from tiered templates with placeholder substitution
- add skill registry for caching discovered skills and lookup by name
- add validator handler to check pip packages, CLI binaries, and environment config requirements
- add built-in test skills: github (markdown), system_status (handler), drone_commands (full 3-layer)
- implement drone_commands skill with subprocess executor, output parser, and command runner modules
- provide detailed README documenting architecture, usage, SKILL.md format, and commands
- add comprehensive unit and integration tests covering discovery, loading, running, validation, and lifecycle
- create seedgo standards pack with skill format, handler contract, and structure checks and documentation
- use consistent coding standards: handlers return dicts and never print; modules can print for orchestration
- enable drone routing with `drone @skills <command>` supporting list, info, run, create, validate commands
- describe project and global settings files and their roles
- explain directory structure with hooks, commands, and sounds
- document hook types and their firing order with explanations
- outline custom commands and permission settings
- provide related files references and container rebuild instructions
Backup System (FPLAN-0004): 42 files ported from internal backup_system
- Entry point, 4 modules, 20+ handlers for backup orchestration
- Google Drive sync made optional via try/except + DRIVE_AVAILABLE flag
- All internal imports (prax, cli, sys.path) replaced with standard lib
Daemon (FPLAN-0005): 41 files ported from internal assistant system
- Renamed assistant → daemon (Patrick approved)
- Entry point, 4 modules, 10 handlers, 5 example plugins
- Telegram, ai_mail, filelock made optional with graceful degradation
- Standalone cron scripts use absolute package imports
- Paths configurable via env vars (AIPASS_DAEMON_CONFIG, AIPASS_REGISTRY, AIPASS_WAKE_SCRIPT)
Both follow the same port-by-rewiring pattern as Memory Bank (FPLAN-0003).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- delete all files and directories related to app_development.example and website_design.example
- remove branch.py orchestrators, handlers, modules, and plugins example packages
- clean up legacy example code to reduce clutter and maintain only active standards
setup-workspace.sh was gitignored but required by Dockerfile COPY.
Building from a fresh clone would fail. Now tracked.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- allow tracking of specific hidden directories and files under spawn templates
- ensure agents can build properly with required template files
✨ feat(branch): add comprehensive branch template verification tool
- implemented verify_branch.py to compare branch vs template files
- supports ignoring files based on .registry_ignore.json patterns
- outputs missing, additional, and matched files for branch validation
- included usage instructions and error handling for robust operation
♻️ refactor(prax): fix logger branch logs path to use Path.home()
- replaced hardcoded "/home/aipass" with portable Path.home()
- allows logging directory creation to adapt to user environment
✨ feat(spawn): add default template files and ignore configs for agent branches
- added .backup_ignore.json, .migrations.json, .registry_ignore.json for agent templates
- introduced .template_registry.json to track template files and directories
- created local context and metadata files for branch identity and session tracking
- included dashboard and flow local markdown templates for branch status and management
- added artifacts birth_certificate template for branch registration metadata
✨ feat(spawn): add mock agent branch templates and backups for testing
- created mock branch with backup ignore and registry ignore files for efficient backups
- added template registry and migration definitions matching main agent template
- included local prompt, passport, observations, and dashboard templates for mock branch
- provided flow local markdown and artifact registration files for mock branch use
- duplicated verify_branch.py tool for mock branch environment consistency
♻️ refactor(spawn): unify verify_branch.py tool in agent and mock branches
- standardized branch verification script in both template sets
- ensures consistent branch-template comparison and ignores handling
- implement _find_registry() to locate AIPASS_REGISTRY.json dynamically
- update discover_branches() to resolve absolute branch paths consistently
- fix _is_branch_private() to use _find_registry() and private registry path correctly
- update readme_ops, verify checks, and cli_standard to resolve paths relative to current file
- adjust standards_audit to use discover_branches() for private branch path lookup
- improve robustness and flexibility by removing hardcoded home directory paths
📝 docs(gitignore): add local cheat sheets and Docker.md to gitignore
- ignore local cheat sheets and Docker.md files as they are not source code
♻️ refactor(architecture_check): fix branch root detection loop condition
- change loop condition to stop at filesystem root instead of home directory
- prevent infinite loop by checking if current directory equals its parent
♻️ refactor(readme_generator): default target to current working directory
- change default path from fixed user home subdirectory to current working dir
- improves usability and flexibility when running script without arguments
- replace hard-coded path example with resolve_branch usage
- add load_registry usage to show full registry retrieval
🐛 fix(pyproject): add watchdog dependency
- include watchdog>=3.0 in dependencies for file watching support
🧹 chore(docs): remove obsolete Docker.md file
- delete Docker cheat sheet as it is no longer relevant or maintained
- replace git and curl with python3-full package for dependencies
- create python virtualenv owned by user 1000 for permission consistency
- add entrypoint scripts in /etc/entrypoint.d to avoid shadowing by bind mounts
- override ENTRYPOINTD environment variable to use non-shadowed entrypoint scripts
- switch to user 1000 instead of coder user for container runtime
- use official base image entrypoint with fixuid and dumb-init for process management
- set default code-server workspace to /home/coder/workspace for consistency
📝 docs(readme): overhaul README to reflect current state and usage
- simplify introduction with focus on core AIPass features and status
- update quick start instructions for source install and basic commands
- add Docker usage example for isolated testing with VS Code
- provide core concepts for drone command router and seedgo standards
- rewrite seedgo plugin example and built-in plugin list with formatting
- remove old API examples and deprecated instructions
- add module architecture and status table for all 10 modules
- clarify configuration and environment variable usage
- update requirements and license sections for clarity
📦 build(scripts): add setup-workspace.sh for container initialization
- script ensures workspace directory is writable by coder user
- clones AIPass repo if not already present in workspace
- installs AIPass in editable mode to keep dependencies up to date
- designed to run as container entrypoint.d script for first boot setup
- add critical startup vs task mode instructions with exact greetings
- specify session entry greetings and steps after startup
- detail files to read on startup and verification commands
- clarify module directory structure and coding conventions
- emphasize core principles including testing and import rules
AIOSAI