t136: Plugin System for Private Extension Repos

[marcusquinn]

Task ID: t136 | Status: open | Estimate: ~1d (ai:6h test:3h read:3h)
Logged: 2026-02-07
Tags: plan architecture plugins

Subtasks

• t136.1 Add plugin support to .aidevops.json schema ~1h blocked-by:none ref:GH#728 completed:2026-02-09 pr:feat: add plugin schema to .aidevops.json and document plugin system (t136.1) #755
• t136.2 Add plugins.json config and CLI commands ~2h blocked-by:t136.1 ref:GH#729 completed:2026-02-09 pr:feat: add 'aidevops plugin' CLI commands for plugin management (t136.2) #759
• t136.3 Extend setup.sh to deploy plugins ~2h blocked-by:t136.2 ref:GH#730 completed:2026-02-09 pr:feat: extend setup.sh to deploy plugins during aidevops update (t136.3) #762
• t136.4 Create plugin template ~1h blocked-by:t136.2 ref:GH#731 completed:2026-02-09 pr:feat: add plugin template and 'aidevops plugin init' command (t136.4) #763
• t136.5 Scaffold aidevops-pro and aidevops-anon repos ~2h blocked-by:t136.3,t136.4 ref:GH#732 assignee:marcusquinn started:2026-02-09T17:00:18Z completed:2026-02-09

Notes

Namespaced plugin architecture (pro.md + pro/) to avoid clashes. Plugin AGENTS.md points to main framework. Minimal CI (local linting only) for private repos. aidevops update deploys main + all plugins. Open questions: license (MIT vs proprietary), Gitea Actions availability, plugin deploy order, subagent index strategy.

Plan: Purpose

Create a plugin architecture for aidevops that allows private extension repos (aidevops-pro, aidevops-anon) to overlay additional agents and scripts onto the base framework. Plugins are git repos that extend aidevops without modifying the core, enabling tiered access (public/pro/private) and fast evolution of specialized features.

Plan: Progress

• (2026-02-07) Phase 1: Add plugin support to .aidevops.json schema ~1h (t136.1)
  • Add plugin field with name, base_repo, namespace
  • Update aidevops init to detect and configure plugin repos
  • Add features: ["plugin"] option
• (2026-02-07) Phase 2: Add plugins.json config and CLI commands ~2h (t136.2)
  • Create ~/.config/aidevops/plugins.json schema
  • Add aidevops plugin add/list/enable/disable/remove/update commands
  • Support GitHub and Gitea URLs
• (2026-02-07) Phase 3: Extend setup.sh to deploy plugins ~2h (t136.3)
  • Add deploy_plugins() function after deploy_aidevops_agents()
  • Respect namespace (deploy to ~/.aidevops/agents/{namespace}/)
  • Handle script prefix convention ({namespace}-*.sh)
• (2026-02-07) Phase 4: Create plugin template ~1h (t136.4)
  • aidevops plugin create <name> scaffolds structure
  • Template AGENTS.md, README.md, .aidevops.json, .github/workflows/ci.yml
  • Minimal GHA (ShellCheck + Secretlint + Markdownlint)
• (2026-02-07) Phase 5: Scaffold aidevops-pro and aidevops-anon repos ~2h (t136.5)
  • Create repos on GitHub and Gitea
  • Initialize with plugin template
  • Test full workflow: clone → init → update → verify deployment

Plan: Decision Log

• Decision: Namespaced directories (pro.md + pro/) not overlay
  Rationale: Overlay model causes collisions if main adds same path later. Namespace guarantees no conflicts.
  Date: 2026-02-07
• Decision: Plugin AGENTS.md points to main framework, not duplicates
  Rationale: Single source of truth for framework docs. Plugins only document their additions.
  Date: 2026-02-07
• Decision: Minimal CI for private repos (local linting only)
  Rationale: SonarCloud/Codacy/CodeRabbit require public repos for free tier. ShellCheck/Secretlint/Markdownlint work locally.
  Date: 2026-02-07
• Decision: aidevops init detects plugin repos via .aidevops.json plugin field
  Rationale: Consistent initialization, AI assistants know it's a plugin context.
  Date: 2026-02-07

---

Synced from TODO.md by issue-sync-helper.sh

[alex-solovyev]

Verification Report

All 5 subtasks completed and verified. Plugin system is fully functional.

Subtask Status

Subtask	PR	Merged	Deliverable
t136.1 Add plugin schema	#755	2026-02-09	.agents/aidevops/plugins.md, plugin schema in aidevops.sh
t136.2 Add CLI commands	#759	2026-02-09	cmd_plugin() — add, list, update, remove commands
t136.3 Extend setup.sh deploy	#762	2026-02-09	Plugin namespace preservation during aidevops update
t136.4 Create plugin template	#763	2026-02-09	.agents/templates/plugin-template/ (3 files)
t136.5 Scaffold pro/anon repos	#792	2026-02-09	External repos scaffolded

Verification Checks

• aidevops plugin list — works, exits 0
• cmd_plugin() at aidevops.sh:2095 — add/list/update/remove all routed
• setup.sh:2545-2622 — plugin namespaces preserved during clean deploy
• Plugin template has proper placeholders ({{PLUGIN_NAME}}, {{REPO_URL}}, {{NAMESPACE}})
• Documentation complete in .agents/aidevops/plugins.md

Closing as complete.