takomi 2.1.8 → 2.1.10

package/.pi/README.md

@@ -8,6 +8,7 @@ It is intentionally separate from the existing cross-harness assets under `asset
 
 - `extensions/takomi-runtime/` - Pi runtime glue, embedded workflow playbooks, and orchestrator board tools
 - `extensions/takomi-subagents/` - Takomi-facing subagent wrapper over Pi-style execution semantics with resumable conversation IDs
+- `extensions/takomi-context-manager/` - Progressive context loading, skill manifests, policy packs, model-routing gates, and context diagnostics
 - `prompts/` - Pi-native prompt shortcuts
 - `agents/` - Pi-native specialist agent definitions, including a design-stage agent
 
@@ -39,6 +40,7 @@ Inside Pi, use:
 - `/takomi subagents status|expand|collapse|fullscreen|next|prev|toggle` to inspect or reshape the active subagent stack
 - `/takomi-status` to show lifecycle, gate, session, and active subagent state
 - `/takomi-reset` to reset session-local Takomi runtime state
+- `/context-report` to inspect prompt compaction, skill loading, policy gates, model routing corrections, and duplicate extension diagnostics
 - `takomi_board` actions now include stage expansion, task updates, multi-task dispatch, and redispatch support for review loops
 - The old standalone commands (`/takomi-genesis`, `/takomi-design`, `/takomi-build`, `/takomi-kickoff`, `/autoorch`, `/orch`, `/architect`, `/code`, `/review`, and the `/takomi-subagent*` variants) are folded into `/takomi` subcommands so slash autocomplete stays small.
 - prompt shortcuts are suffixed with `-prompt` to avoid collisions with runtime commands, e.g. `/orch-prompt`, `/build-prompt`, `/design-prompt`, `/genesis-prompt`, `/takomi-prompt`, `/prime-prompt`
@@ -67,6 +69,7 @@ Bundled with Takomi now:
 
 - `.pi/extensions/takomi-runtime/`
 - `.pi/extensions/takomi-subagents/`
+- `.pi/extensions/takomi-context-manager/`
 - `.pi/prompts/`
 - `.pi/agents/`
 - `.pi/themes/`
@@ -112,6 +115,11 @@ So when working on packaging, agents should distinguish between:
 - Active Takomi subagent work now streams through the native Pi-style result UI instead of Takomi's older below-editor stack.
 - Use Pi's native result expansion, `Alt+T`, or `/takomi subagents expand` to inspect detailed subagent output.
 - Takomi still tracks active runs internally for status, review continuity, and board synchronization, but it no longer opens a custom subagent fullscreen overlay.
+- `takomi-context-manager` reduces prompt bloat by replacing the always-on skill description dump with a names-only Skill Index plus progressive `skill_manifest`/`skill_load` tools.
+- `takomi-context-manager` treats `/takomi routing` as the source of truth for model-routing policy via `.pi/settings.json -> takomi.modelRoutingPolicyFile`.
+- `takomi-context-manager` gates `takomi_subagent` when model-routing context has not been loaded, provides the routing policy, and tells the agent to retry.
+- `takomi-context-manager` can correct safe wrong-provider model requests, block or pause on policy violations, and ask the user whether to retry with an approved model or stop.
+- `takomi-context-manager` detects known duplicate global/project Takomi extension paths in `context_report` to help diagnose tool registration conflicts.
 - `takomi_board` can:
   - create a Genesis-first lifecycle session by default
   - expand a lifecycle stage into additional tasks

package/README.md

@@ -45,6 +45,16 @@ takomi init
 
 Takomi's Pi-native subagent execution and terminal UI build on **[`pi-subagents`](https://github.com/nicobailon/pi-subagents)** by **Nico Bailon**. That package provides the underlying Pi extension for delegated subagent runs, including the native subagent result renderer, live progress/status display, single/parallel/chain execution support, session/artifact handling, and related subagent tooling. Takomi adds its own lifecycle orchestration, model-routing policy, workflow metadata, board/checklist context, and agent conventions on top of that foundation.
 
+### Context Manager
+
+Takomi now ships a Pi-native `takomi-context-manager` extension. It reduces prompt bloat with progressive context loading:
+
+- skill names are always visible, while descriptions and full `SKILL.md` files load only when needed
+- `skill_manifest`, `skill_load`, `policy_manifest`, `policy_load`, and `context_report` tools expose context on demand
+- `/takomi routing` remains the source of truth for model-routing policy
+- `takomi_subagent` is guarded by routing-policy context and can recover from wrong-provider model choices
+- `/context-report` shows prompt compaction, loaded skills/policies, blocked actions, model-routing corrections, and duplicate extension diagnostics
+
 
 ### Option A: Global Install (Best for Multi-IDE Users) ⭐
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "takomi",
-  "version": "2.1.8",
+  "version": "2.1.10",
   "description": "🎯 Stop wrestling with AI. Start building with purpose. The artisan's toolkit for agent workflows, Codex skills, and original Takomi capabilities like 21st.dev integration.",
   "type": "module",
   "bin": {

package/src/doctor.js

@@ -23,9 +23,11 @@ export async function runDoctor({ version, cwd = process.cwd() } = {}) {
   console.log(status(report.bundled.packageReady, 'Bundled .pi assets', report.bundled.targets.root));
   console.log(status(report.bundled.checks.runtime, 'Bundled takomi-runtime', report.bundled.targets.runtime));
   console.log(status(report.bundled.checks.subagents, 'Bundled takomi-subagents', report.bundled.targets.subagents));
+  console.log(status(report.bundled.checks.contextManager, 'Bundled takomi-context-manager', report.bundled.targets.contextManager));
   console.log(status(report.bundled.packageIncluded, 'Package includes .pi assets', report.bundled.packageIncluded ? 'yes' : 'no'));
   console.log(status(report.installed.runtimeInstalled, 'Installed takomi-runtime', report.installed.targets.extensions));
   console.log(status(report.installed.subagentsInstalled, 'Installed takomi-subagents', report.installed.targets.extensions));
+  console.log(status(report.installed.contextManagerInstalled, 'Installed takomi-context-manager', report.installed.targets.extensions));
   console.log(status(await fs.pathExists(`${report.installed.targets.extensions}/oauth-router`), 'Installed oauth-router', `${report.installed.targets.extensions}`));
   console.log(status(report.installed.coreInstalled, 'Installed Takomi core', path.join(path.dirname(report.installed.targets.root), 'src', 'pi-takomi-core')));
   console.log(status(report.installed.piSubagentsModuleInstalled, 'Installed pi-subagents module', path.join(report.installed.targets.root, 'node_modules', 'pi-subagents')));
@@ -54,7 +56,7 @@ export async function runDoctor({ version, cwd = process.cwd() } = {}) {
     console.log(pc.white('  - Package .pi assets before enabling takomi install pi in releases.'));
   }
 
-  if (!report.installed.runtimeInstalled || !report.installed.subagentsInstalled || !report.installed.coreInstalled || !report.installed.piSubagentsModuleInstalled) {
+  if (!report.installed.runtimeInstalled || !report.installed.subagentsInstalled || !report.installed.contextManagerInstalled || !report.installed.coreInstalled || !report.installed.piSubagentsModuleInstalled) {
     console.log(pc.white('  - Run takomi install pi to refresh the Pi harness, Takomi core, and pi-subagents runtime module.'));
   }
 

package/src/pi-harness.js

@@ -72,6 +72,7 @@ export function getBundledPiAssetTargets() {
     root,
     runtime: path.join(root, 'extensions', 'takomi-runtime'),
     subagents: path.join(root, 'extensions', 'takomi-subagents'),
+    contextManager: path.join(root, 'extensions', 'takomi-context-manager'),
     prompts: path.join(root, 'prompts'),
     agents: path.join(root, 'agents'),
     themes: path.join(root, 'themes'),
@@ -162,6 +163,7 @@ export async function inspectBundledPiAssets() {
     root: await fs.pathExists(targets.root),
     runtime: await fs.pathExists(targets.runtime),
     subagents: await fs.pathExists(targets.subagents),
+    contextManager: await fs.pathExists(targets.contextManager),
     prompts: await fs.pathExists(targets.prompts),
     agents: await fs.pathExists(targets.agents),
     themes: await fs.pathExists(targets.themes),
@@ -186,6 +188,7 @@ export async function inspectInstalledTakomiPiHarness(home = HOME) {
   const targets = getPiGlobalTargets(home);
   const runtime = path.join(targets.extensions, 'takomi-runtime');
   const subagents = path.join(targets.extensions, 'takomi-subagents');
+  const contextManager = path.join(targets.extensions, 'takomi-context-manager');
   const core = path.join(path.dirname(targets.root), 'src', 'pi-takomi-core');
   const piSubagentsModule = path.join(targets.root, 'node_modules', 'pi-subagents');
 
@@ -193,6 +196,7 @@ export async function inspectInstalledTakomiPiHarness(home = HOME) {
     targets,
     runtimeInstalled: await fs.pathExists(runtime),
     subagentsInstalled: await fs.pathExists(subagents),
+    contextManagerInstalled: await fs.pathExists(contextManager),
     coreInstalled: await fs.pathExists(core),
     piSubagentsModuleInstalled: await fs.pathExists(piSubagentsModule),
     promptsInstalled: await fs.pathExists(targets.prompts),

package/src/pi-installer.js

@@ -104,11 +104,13 @@ export async function installPiHarnessAssets(version = 'unknown') {
     copied.readme = await copyOwnedFile(readmeSrc, path.join(targets.root, 'README.md'));
   }
 
-  const extensionNames = ['takomi-runtime', 'takomi-subagents', 'oauth-router'];
-  for (const name of extensionNames) {
-    const src = path.join(srcRoot, 'extensions', name);
-    if (await fs.pathExists(src)) {
-      copied[`extension:${name}`] = await copyOwnedDirectory(src, path.join(targets.extensions, name));
+  const extensionsRoot = path.join(srcRoot, 'extensions');
+  if (await fs.pathExists(extensionsRoot)) {
+    const extensionEntries = await fs.readdir(extensionsRoot, { withFileTypes: true });
+    for (const entry of extensionEntries) {
+      if (!entry.isDirectory()) continue;
+      const src = path.join(extensionsRoot, entry.name);
+      copied[`extension:${entry.name}`] = await copyOwnedDirectory(src, path.join(targets.extensions, entry.name));
     }
   }
 
@@ -168,6 +170,7 @@ export async function validatePiHarnessInstall() {
   return {
     runtime: await fs.pathExists(path.join(targets.extensions, 'takomi-runtime')),
     subagents: await fs.pathExists(path.join(targets.extensions, 'takomi-subagents')),
+    contextManager: await fs.pathExists(path.join(targets.extensions, 'takomi-context-manager')),
     oauthRouter: await fs.pathExists(path.join(targets.extensions, 'oauth-router')),
     prompts: await fs.pathExists(targets.prompts),
     agents: await fs.pathExists(targets.agents),
@@ -183,7 +186,7 @@ export function printPiInstallSummary(result, validation) {
   console.log(pc.green('\n✔ Installed Takomi Pi harness assets'));
   console.log(pc.white(`  Root:       ${result.targets.root}`));
   console.log(pc.white(`  Manifest:   ${PI_MANIFEST_PATH}`));
-  console.log(pc.white(`  Extensions: ${validation.runtime && validation.subagents && validation.oauthRouter ? 'ok' : 'check needed'}`));
+  console.log(pc.white(`  Extensions: ${validation.runtime && validation.subagents && validation.contextManager && validation.oauthRouter ? 'ok' : 'check needed'}`));
   console.log(pc.white(`  Prompts:    ${validation.prompts ? 'ok' : 'missing'}`));
   console.log(pc.white(`  Agents:     ${validation.agents ? 'ok' : 'missing'}`));
   console.log(pc.white(`  Themes:     ${validation.themes ? 'ok' : 'missing'}`));