@cubis/foundry 0.3.39 → 0.3.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/README.md +64 -0
  2. package/bin/cubis.js +382 -25
  3. package/mcp/README.md +72 -8
  4. package/mcp/config.json +3 -0
  5. package/mcp/dist/index.js +315 -68
  6. package/mcp/src/config/index.test.ts +1 -0
  7. package/mcp/src/config/schema.ts +5 -0
  8. package/mcp/src/index.ts +40 -9
  9. package/mcp/src/server.ts +66 -10
  10. package/mcp/src/telemetry/tokenBudget.ts +114 -0
  11. package/mcp/src/tools/index.ts +7 -0
  12. package/mcp/src/tools/skillBrowseCategory.ts +22 -5
  13. package/mcp/src/tools/skillBudgetReport.ts +128 -0
  14. package/mcp/src/tools/skillGet.ts +18 -0
  15. package/mcp/src/tools/skillListCategories.ts +19 -6
  16. package/mcp/src/tools/skillSearch.ts +22 -5
  17. package/mcp/src/tools/skillTools.test.ts +61 -9
  18. package/mcp/src/vault/manifest.test.ts +19 -1
  19. package/mcp/src/vault/manifest.ts +12 -1
  20. package/mcp/src/vault/scanner.test.ts +1 -0
  21. package/mcp/src/vault/scanner.ts +1 -0
  22. package/mcp/src/vault/types.ts +6 -0
  23. package/package.json +1 -1
  24. package/workflows/skills/code-documenter/references/images/create-key.png +0 -0
  25. package/workflows/skills/code-documenter/references/images/dashboard-annotated.png +0 -0
  26. package/workflows/skills/documentation-templates/docs/api.md +16 -0
  27. package/workflows/skills/documentation-templates/docs/architecture.md +23 -0
  28. package/workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md +35 -1
  29. package/workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md +38 -3
  30. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/AGENTS.md +35 -1
  31. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md +35 -1
  32. package/workflows/workflows/agent-environment-setup/platforms/cursor/rules/.cursorrules +28 -0
  33. package/workflows/workflows/agent-environment-setup/platforms/windsurf/rules/.windsurfrules +28 -0
@@ -32,11 +32,39 @@ Before starting ANY task, the agent MUST:
32
32
 
33
33
  ## 3) Skill Loading Policy
34
34
 
35
+ ## MCP-first Skill Discovery Order (Required)
36
+
37
+ 1. Use `skill_search` first to narrow candidate skills.
38
+ 2. Use `skill_browse_category` second to inspect category-level candidates.
39
+ 3. Use `skill_get` only for final selected skills that must be loaded.
40
+ 4. Keep pointer-first flow; avoid loading full skill text prematurely.
41
+
42
+ ## Skill Log Completion Block (Required)
43
+
44
+ After finishing skill selection/loading, publish:
45
+
46
+ - `selected_skills`: skill IDs selected for the task
47
+ - `loaded_skills`: skill IDs loaded via `skill_get`
48
+ - `skipped_skills`: considered but not loaded
49
+
50
+ ## Context Budget Block (Required, Estimated)
51
+
52
+ Immediately after the Skill Log block, publish estimated budget fields:
53
+
54
+ - `full_catalog_est_tokens`
55
+ - `loaded_est_tokens`
56
+ - `estimated_savings_tokens`
57
+ - `estimated_savings_percent`
58
+
59
+ Mark all context/token values as deterministic estimates (not provider metering).
60
+
35
61
  1. Load only skills needed for the active request.
36
62
  2. Prefer progressive disclosure: start from `SKILL.md`, then specific sections.
37
63
  3. Keep context lean; avoid loading unrelated skill documents.
38
64
  4. If a mapped skill is missing, continue with best fallback and state it.
39
65
 
66
+ After the skill log is complete, append the Context Budget block in the same response/update.
67
+
40
68
  ## 4) Request Classifier
41
69
 
42
70
  1. Question/explanation requests: answer directly.