Allocation drift against targets, with the trades that would correct it
One command in the Portfolio pack, available in the CLI, as an MCP tool and as a JavaScript import: portfolio drift-monitor.
What it needs, and why
Every input is checked before anything is calculated. current, target and value are required; the rest refine the answer.
| Input | Required | The question it asks | Why it matters |
|---|---|---|---|
current | yes | What is the current allocation, as percentages by sleeve? | Drift is measured against the targets sleeve by sleeve. |
target | yes | What is the target allocation? | Needed to measure drift. |
value | yes | What is the total portfolio value? | Trade sizes are a share of total value. |
Requests it answers
- “is the portfolio off target”
- “do they need rebalancing”
- “how far has it drifted”
An agent with this pack loaded picks the command from phrasing like that, asks for whatever input is missing, and reports the figures with the method that produced them.
Run it
node bin/wealth-skills.js portfolio drift-monitor --current '{"equity":68,"fixedIncome":32}' --target '{"equity":60,"fixedIncome":40}' --value 1000000 --band 5Limits it inherits from wealth-portfolio
- Tax-loss harvesting checks only purchases in the 30 days *before* the sale, across the lots supplied. Confirm separately that nothing substantially identical is bought in the 30 days after, including in IRA and spouse accounts. Replacement candidates track a different index, but whether a fund is "substantially identical" is a judgment for the advisor or tax professional. No replacement is suggested for total-bond funds.
- Backtests use approximate embedded annual returns and capture drawdowns at year-end only.
- Forward-simulation regime assumptions are illustrative, not forecasts; pass your firm's capital market assumptions for client work.
- VaR is parametric normal and only as good as the volatility you supply.
The full pack, its other 10 commands and what it deliberately leaves alone are on the Portfolio page.