portfolio_digest
Roll up every product's counts, health, and stage-coverage in one call (the multi-product `get_graph_digest`). The strategic-surface read that otherwise required `switch_product` + `get_graph_digest` per graph. Returns per-product summaries plus a portfolio rollup (totals, products-by-stage). Read-only; never mutates active-product state.
Arguments
scopearrayoptionalProduct IDs (or files) to summarise. Omit to summarise ALL products in the workspace.
coverage_profilearrayoptionalBatch-4 #22: coverage region ids (keys of the `coverage` block, e.g. understanding, discovery, building) to score each product against, so "is this product at parity?" is a direct read across the portfolio. Adds `coverage_profile_pct` to every product summary.
Returns
{ products: Array<{ product_id, file, title, stage, total_nodes, total_edges, health, coverage_pct, top_types }>, rollup: { products, total_nodes, total_edges, by_stage }, errored_products?, unmatched_scope? }health/coverage_pct come from computeGraphDigest, identical to what get_graph_digest reports per product.