Joseph Magly
afc9dad1b2
* docs(policy): allow low-impact contributor courtesy cleanup * chore(aiwg): migrate to shared BT6 maintainer plugin * chore: reconcile delivery validation
115 lines
4.3 KiB
Markdown
115 lines
4.3 KiB
Markdown
# BT6 Maintainer Plugin
|
|
|
|
Cross-repository maintenance for BT6 research and support tooling. The plugin
|
|
provides queue audit, pull-request audit, external-provider assessment, issue
|
|
stewardship, and conservative merge-train workflows that adapt to each repository's configured tracker,
|
|
delivery policy, validation commands, and research/data risk surfaces.
|
|
|
|
## What this is
|
|
|
|
A marketplace delivery wrapper whose payload is the `bt6-maintainer` addon. It
|
|
generalizes the proven T3MP3ST maintainer workflow for BT6 codebases without
|
|
assuming a particular repository, tracker host, language, or application stack.
|
|
|
|
The core is read-only by default. Comments, labels, issue closure, reviews,
|
|
merges, releases, and other tracker mutations require explicit operator
|
|
authorization after the exact target repository and current PR head SHA have
|
|
been verified.
|
|
|
|
## Layout
|
|
|
|
```
|
|
.aiwg/plugins/bt6-maintainer/
|
|
├── manifest.json # Bundle metadata (validated by aiwg)
|
|
├── README.md # This file
|
|
└── payload/
|
|
├── manifest.json # Portable addon payload
|
|
├── config/ # Repository profile schema
|
|
├── agents/
|
|
├── skills/
|
|
├── rules/
|
|
├── capabilities/
|
|
├── templates/
|
|
└── provenance/
|
|
```
|
|
|
|
## Usage
|
|
|
|
On AIWG 2026.7.24 or newer, place the wrapper under the consuming repository's
|
|
`.aiwg/plugins/` directory and deploy it directly:
|
|
|
|
```bash
|
|
consumer_root=/absolute/path/to/consumer
|
|
mkdir -p "$consumer_root/.aiwg/plugins/bt6-maintainer"
|
|
cp -R .aiwg/plugins/bt6-maintainer/. \
|
|
"$consumer_root/.aiwg/plugins/bt6-maintainer/"
|
|
cd "$consumer_root"
|
|
aiwg use bt6-maintainer
|
|
```
|
|
|
|
Direct Git installation of a standalone repository that contains its wrapper at
|
|
`.aiwg/plugins/<id>/` is tracked by AIWG #1997. Until that lands, pin and copy
|
|
the wrapper or extract a packaged provider archive rather than accepting an
|
|
`unknown` zero-artifact install.
|
|
|
|
Create `.aiwg/bt6-maintainer.yaml` in a consuming repository using
|
|
`payload/templates/bt6-repository-profile.yaml` as the starting point. When the
|
|
file is absent, the skills derive safe read-only defaults from git and
|
|
`.aiwg/aiwg.config`; they must stop rather than guess when tracker authority or
|
|
the canonical repository is ambiguous.
|
|
|
|
Inspect health:
|
|
```bash
|
|
aiwg doctor --project-local
|
|
```
|
|
|
|
AIWG #1998 currently prevents reliable automated removal of freshly deployed
|
|
namespaced skill files. Inspect provider paths and preserve the registry record
|
|
needed for recovery; do not use `--force` without verifying exact ownership.
|
|
|
|
## Packaging status
|
|
|
|
The wrapper follows AIWG's project-local plugin schema and contains an addon
|
|
payload under `payload/`. AIWG 2026.7.24 validates, packages, and directly
|
|
deploys the wrapper. Remaining lifecycle gaps are:
|
|
|
|
- [#1996](https://git.integrolabs.net/roctinam/aiwg/issues/1996) — legacy
|
|
`install-plugin --source` crashes;
|
|
- [#1997](https://git.integrolabs.net/roctinam/aiwg/issues/1997) — `aiwg install`
|
|
does not discover nested standalone wrappers and reports zero-artifact success;
|
|
- [#1998](https://git.integrolabs.net/roctinam/aiwg/issues/1998) — immediate
|
|
deploy/remove misclassifies generated skill files as mutated.
|
|
|
|
Validate the wrapper and smoke-test its payload:
|
|
|
|
```bash
|
|
npm run check
|
|
npm run test:smoke
|
|
```
|
|
|
|
The smoke test deploys the payload as a project-local addon in an isolated
|
|
temporary repository for provider parity. Direct wrapper deployment is also
|
|
covered during adoption; automated removal remains outside the passing smoke
|
|
gate until #1998 is resolved.
|
|
|
|
## Supported repository families
|
|
|
|
- Research acquisition, corpus, citation, and provenance tools.
|
|
- Knowledge-base, indexing, search, and synthesis services.
|
|
- Analyst and support utilities with local and hosted model integrations.
|
|
- CLI, API, web, and MCP tools that share backend/frontend contracts.
|
|
- Libraries and automation repositories with similar issue/PR operations.
|
|
|
|
## Provider support
|
|
|
|
- Claude: full addon deployment (agents, skills, and guardrail rule).
|
|
- Codex: full deployment through AIWG's shared Agent Skills surface plus agent
|
|
TOMLs and guardrail rule on AIWG 2026.7.24 or newer.
|
|
|
|
## Source and license
|
|
|
|
This work is derived from the T3MP3ST project-local maintainer addon at commit
|
|
`b192577b5462d2f7388e91c83b4cb2874ab99c03`. See
|
|
`payload/provenance/SOURCE.md`. The source and this derivative are licensed
|
|
under AGPL-3.0.
|