create_portfolio
Create a portfolio entity in the portfolio document (`.upg/portfolio.upg`): the investment / grouping container products and operating functions belong to. A first-class wrapper over `create_node({type:"portfolio"})` (closes gap G2 / #39). `kind` sets the posture: owned (default), watched (the only kind that relaxes product grading), or the owned-side groupings strategic / internal / gtm (e.g. a Go-to-Market portfolio of revenue operating_functions). The portfolio document is created on demand.
Arguments
titlestringrequiredPortfolio name (e.g. "Go-to-Market", "Internal Functions")
descriptionstringoptionalThe portfolio's strategic focus
kindstringoptionalInvestment posture / grouping (default owned). Only watched relaxes product grading.
parent_portfolio_idstringoptionalParent portfolio id for nesting (a sub-portfolio)
hierarchy_modelstringoptionalHow products are structured within this portfolio
Returns
{ node, portfolio_file, written_to }node is the typed UPGPortfolio record persisted to portfolios[].