mission-control portable package

Portable Agent Plugins 1.0 package for SDLC management on Infiquetra's active boards — Operations, Asgard, and CAMPPS. It ships one shared CLI (scripts/sdlc_manager.py), seven Agent Skills over it, the board census, pagination, and template-sync helpers, and vendored board configuration. Claude-only files live under the client extension directory com.infiquetra.claude/; they are an adapter, not the identity of this package.

This tree is a derived artifact of infiquetra-claude-plugins at the commit recorded in PROVENANCE.json (upstream plugin version 2.15.2). Custody has not moved. The upstream repository remains the runtime source of truth; a needed byte change in copied content is an upstream filing, never a downstream patch.

What is in the package

Skills

All seven skills share the one CLI; each skill's SKILL.md documents the subset of the command surface it uses.

Read-only and GitHub-mutating subcommands

Every GitHub access this package performs goes through the gh CLI. The audited split of the CLI surface, as recorded in the port descriptor (ports/mission-control.json):

"Read-only" means the subcommand performs no GitHub write. A few read-only subcommands still write local state: issue prepare writes a draft and JSON sidecar under docs/sdlc-issue-drafts/ of the current repository, and config init-defaults seeds ~/.claude/sdlc-defaults.json. fields create-option performs no mutation of any kind — it discovers a field, prints its id and the options already on it, and stops. rollout status, board wip, and config show read the retired upstream beads-config.json; when the file is absent locally the loader first attempts a live gh api read of it from infiquetra-sdlc, and only if that read fails or returns nothing does the value degrade to {}, at which point these commands report zero rolled-out repositories rather than erroring.

One mutation route is an internal code path rather than a CLI verb: when issue create-prepared meets a repository that is not mapped to the requested project, it opens a mapping pull request — real git worktree add, commit, and push plus gh pr create — before continuing. The descriptor lists that path as _open_mapping_pr so the safety predicate treats the route as mutating.

Authentication and environment

• The gh CLI must be installed and authenticated (gh auth status); project-field writes additionally need the Projects write scope.
• The scripts delegate all GitHub access to the gh CLI and read no token environment variable themselves. gh manages its own credentials and itself honors GH_TOKEN, GITHUB_TOKEN, and GH_HOST — which is why the compatibility assessment strips both the GH_ and the GITHUB_ prefix from every subprocess it runs against this package.
• INFIQUETRA_SDLC_PATH is the only environment override the scripts read. It points at an infiquetra-sdlc checkout and defaults to ~/workspace/infiquetra/infiquetra-sdlc.

Configuration resolution

The catalog requires python>=3.12. sdlc_manager.py and sync_template_docs.py import PyYAML at module scope, so PyYAML must be installed before any command runs.

Resolution orders at startup, from sdlc_manager.py:

• Board and workflow schema (config/sdlc-schema.json) — network-first: read from infiquetra-sdlc on GitHub main via the gh API first, because a local checkout may be stale; on failure fall back to the vendored config/sdlc-schema.json inside this package, then to the local checkout's copy.
• Project mappings (config/project-mappings.json) — local-first: the INFIQUETRA_SDLC_PATH checkout, then the vendored copy, then the remote via the gh API.
• Board schema — the vendored config/board-schema.json; board_census.py --check reports drift against the live boards and --write regenerates it.

Client extension directory

Agent Plugins 1.0 puts client-specific files in an explicit extension directory rather than at the package root. This package's Claude adapter is com.infiquetra.claude/: the relocated Claude Code manifest, the four slash commands (board, issue, metrics, triage), and the sdlc-operator agent definition, all byte copies of the upstream client files. The portable manifest, skills, and scripts beside that directory carry no Claude loading convention.

Fleet Core bundle

sdlc_manager.py and executor_profile_lint.py consume three Fleet Core modules: intent_envelope, tier_palette, and the models.json registry. Agent Plugins 1.0 has no dependency field, so this package does not install Fleet Core at runtime. fleet-bundle.json declares the modules and their destinations, and scripts/bundle_fleet_module.py generates them under scripts/_bundled/ as digest-stamped build artifacts. The dropped fleet_commons_shim used Claude-specific runtime discovery; this package does not ship it.

Verify the stamps without writing:

python3 scripts/bundle_fleet_module.py --check

The Fleet Core source is the sibling package plugins/fleet-core/; deferred modules are named in its DEFERRED.md.

Validation in this repository

These commands run from the repository root. None of them contacts GitHub: the live operations above all go through the gh CLI, and every command below is a repository check or a usage probe that exercises import and argument parsing without credentials or a network call.

python3 scripts/bundle_fleet_module.py --check
python3 scripts/check_repo.py
python3 plugins/mission-control/scripts/sdlc_manager.py --help
python3 plugins/mission-control/scripts/board_census.py --help
python3 plugins/mission-control/scripts/check_pagination.py --help
python3 plugins/mission-control/scripts/sync_template_docs.py --help
python3 plugins/mission-control/scripts/executor_profile_lint.py --help
python3 -m unittest discover -s tests -v
python3 -m pytest plugins/mission-control/tests -q

The package's own pytest suite lives under plugins/mission-control/tests/ (upstream byte copies). This repository additionally enforces this README the way a consumer reads it — the opening paragraph must identify the portable package, every relative link must resolve, every documented python3 command above must actually run with the GH_ and GITHUB_ variables stripped, and no documented invocation may be mutating. That check is tests/test_mission_control_readme.py.

Further reading

• Port descriptor
• Portable port runbook
• Migration run plan
• Portable Fleet Core
• Repository commands
• Upstream source: infiquetra/infiquetra-claude-plugins