ops portfolio
Portfolio management and cross-project visibility across all Wasteology projects. Provides unified status, git state, and strategic context queries across every registered project.
A "portfolio project" is anything declared in a manifests/builtin/*.toml file. See ops project for the registry itself; ops portfolio is the cross-cutting view on top of it.
When to Use
Cross-Project Visibility
status, git, and health give one-screen answers across every project — no cd-and-look-around required.
Natural-Language Queries
ask queries the lat.md knowledge graph across all projects; query translates English into SQL against the digest warehouse.
Strategic Alignment
okr-import and okr-sync keep project-to-OKR mappings up to date so the dashboard can show strategic context, not just engineering activity.
Subcommands
| Subcommand | Description |
|---|---|
status | Unified status across all portfolio projects |
git | Git status for all portfolio projects |
health | Health check all portfolio projects |
context | Strategic context for all portfolio projects |
ask | Ask a natural-language question across all project lat.md knowledge graphs |
query | Translate a natural-language question to SQL and run it against wg_digests |
infographic | Generate project infographics using the Art skill (Gemini) or NotebookLM |
okr-import | Import OKR definitions from a quarterly CSV export |
okr-sync | Snapshot current project-OKR alignments from manifests |
ops portfolio status
Unified status across every registered project — pulls health, recent failures, and pipeline state into a single table.
ops statusops status is optimized for the operational picture (current failures, recent errors). ops portfolio status is broader — it includes strategic-context fields and is portfolio-scoped by design.
ops portfolio git
Git state across every portfolio project: branch, dirty/clean, unpushed commits, last activity. Useful when you've been working across several repos and want to make sure nothing is stranded.
ops portfolio health
Runs each project's adapter health check in parallel. Reports adapter availability, downstream services, and recent error patterns.
ops portfolio context
Strategic context view — pulls the strategic positioning, OKR alignments, and category for each project. Best paired with the dashboard's Context tab.
ops portfolio ask
Ask a natural-language question that searches across every project's lat.md knowledge graph. The answer cites which project (and which section) the information came from.
ask requires a Gemini or OpenAI key configured via LAT_LLM_KEY (or one of its variants). Without a key, fall back to per-project lat search and lat locate.
ops portfolio query
Translate a plain-English question into SQL and run it against the wg_digests warehouse. Returns the result set inline and prints the generated SQL so you can audit it.
query is gated to SELECT-only statements against wg_digests. If the LLM generates anything mutating, it is rejected before execution.
ops portfolio infographic
Generate a visual infographic for a project using the Art skill (Gemini image gen) or NotebookLM. Useful for stakeholder decks and one-pagers.
OKR Tracking
Two complementary commands keep the strategic layer in sync with engineering reality.
ops portfolio okr-import
Import OKR definitions from a quarterly CSV export into wg_digests.okr_definitions. Run this once per quarter when the OKR doc is published.
ops portfolio okr-sync
Snapshot the current project-to-OKR alignments from each project's manifest into wg_digests.project_okr_alignments. Run this whenever a manifest's OKR mapping changes.
okr-import brings in the definitions (the OKRs themselves). okr-sync brings in the alignments (which project maps to which OKR). You generally do okr-import quarterly and okr-sync on demand.
Combined Workflows
# Morning check — full portfolio sweep
ops portfolio status
ops portfolio git
ops portfolio health
# Ask the knowledge graph a question
ops portfolio ask "Which projects depend on CieTrade data?"
# Pull data for a deck
ops portfolio query "Top 5 projects by commit count this quarter"
ops portfolio infographic wdp-import