@compilr-dev/sdk 0.1.16 → 0.1.17

package/dist/index.d.ts

@@ -45,7 +45,7 @@ export { type ModelTier, type TierInfo, type ProviderModelMap, MODEL_TIERS, TIER
 export { assembleTools, deduplicateTools } from './tools.js';
 export { MetaToolsRegistry, createMetaTools, META_TOOLS_SYSTEM_PROMPT_PREFIX, } from './meta-tools/index.js';
 export type { MetaToolStats, MetaTools } from './meta-tools/index.js';
-export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './system-prompt/index.js';
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './system-prompt/index.js';
 export type { SystemPromptContext, BuildResult, SystemPromptModule, ModuleConditions, } from './system-prompt/index.js';
 export type { ProjectType, ProjectStatus, RepoPattern, WorkflowMode, LifecycleState, WorkItemType, WorkItemStatus, WorkItemPriority, GuidedStep, DocumentType, PlanStatus, Project, WorkItem, ProjectDocument, Plan, PlanSummary, PlanWithWorkItem, HistoryEntry, CreateProjectInput, UpdateProjectInput, ProjectListOptions, CreateWorkItemInput, UpdateWorkItemInput, QueryWorkItemsInput, CreateDocumentInput, UpdateDocumentInput, CreatePlanInput, UpdatePlanInput, ListPlansOptions, WorkItemQueryResult, ProjectListResult, BulkCreateItem, IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, IAnchorService, IArtifactService, IEpisodeService, AnchorData, ArtifactType, ArtifactData, ArtifactSummaryData, WorkEpisode, ProjectWorkSummary, PlatformContext, PlatformToolsConfig, PlatformHooks, StepCriteria, } from './platform/index.js';
 export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, } from './platform/index.js';

package/dist/index.js

@@ -71,7 +71,7 @@ export {
 // Builder
 SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, 
 // Module constants
-ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, 
+ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, 
 // Module utilities
 shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './system-prompt/index.js';
 // =============================================================================

package/dist/platform/tools/anchor-tools.js

@@ -18,10 +18,7 @@ export function createAnchorTools(config) {
     // ---------------------------------------------------------------------------
     const anchorAddTool = defineTool({
         name: 'anchor_add',
-        description: 'Add critical information that must survive context compaction. ' +
-            'Use this for: project context, important decisions, user preferences, ' +
-            'architectural constraints, or any information that should persist across the entire conversation. ' +
-            'Anchors are always included at the top of the context window.',
+        description: 'Add critical info that survives context compaction. Always included at top of context.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -32,14 +29,12 @@ export function createAnchorTools(config) {
                 priority: {
                     type: 'string',
                     enum: ['critical', 'safety', 'info'],
-                    description: 'Priority level. "critical" for must-never-forget info (user preferences, key constraints), ' +
-                        '"safety" for safety-related context, "info" for general helpful context.',
+                    description: 'Priority: critical (must-never-forget), safety, or info',
                 },
                 scope: {
                     type: 'string',
                     enum: ['global', 'project'],
-                    description: 'Scope for the anchor. "global" persists across all projects, ' +
-                        '"project" is specific to the current project (requires active project).',
+                    description: 'Scope: global (all projects) or project (current only)',
                 },
                 tags: {
                     type: 'array',

package/dist/platform/tools/artifact-tools.js

@@ -18,23 +18,22 @@ export function createArtifactTools(config) {
     // ---------------------------------------------------------------------------
     const artifactSaveTool = defineTool({
         name: 'artifact_save',
-        description: 'Save a new artifact or update an existing one. Artifacts are named pieces of work that can be referenced by other agents. ' +
-            'Types: design (architecture/API specs), plan (task breakdowns), review (code reviews), decision (architectural decisions), note (general notes).',
+        description: 'Save or update a named artifact that can be referenced by other agents.',
         inputSchema: {
             type: 'object',
             properties: {
                 name: {
                     type: 'string',
-                    description: 'Artifact name (human-readable, unique within team). Example: "API Design v2", "Sprint 5 Plan", "Auth Module Review"',
+                    description: 'Artifact name (unique within team)',
                 },
                 type: {
                     type: 'string',
                     enum: ['design', 'plan', 'review', 'decision', 'note'],
-                    description: 'Artifact type: design (architecture), plan (task breakdown), review (feedback), decision (trade-off analysis), note (general)',
+                    description: 'Artifact type',
                 },
                 content: {
                     type: 'string',
-                    description: 'Full artifact content in markdown format. Should be complete and self-contained.',
+                    description: 'Content (markdown)',
                 },
                 summary: {
                     type: 'string',

package/dist/platform/tools/backlog-tools.js

@@ -52,9 +52,7 @@ export function createBacklogTools(config) {
     // ---------------------------------------------------------------------------
     const backlogReadTool = defineTool({
         name: 'backlog_read',
-        description: 'Read backlog items from the project. ' +
-            'Use filters to narrow results. Use id parameter to get a specific item. ' +
-            'Returns items sorted by priority (critical first) then by creation date.',
+        description: 'Read backlog items sorted by priority. Use id for a specific item.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -83,7 +81,8 @@ export function createBacklogTools(config) {
                 },
                 limit: {
                     type: 'number',
-                    description: 'Maximum items to return (default: 20)',
+                    description: 'Max items to return',
+                    default: 20,
                 },
             },
             required: [],
@@ -157,9 +156,7 @@ export function createBacklogTools(config) {
     // ---------------------------------------------------------------------------
     const backlogWriteTool = defineTool({
         name: 'backlog_write',
-        description: 'Create, update, or delete backlog items. ' +
-            'Actions: add (new item), update (modify existing), delete (remove), replace (full list). ' +
-            'IDs are auto-generated for new items based on type (e.g., FEAT-001, BUG-002).',
+        description: 'Create, update, delete, or replace backlog items. IDs auto-generated.',
         inputSchema: {
             type: 'object',
             properties: {

package/dist/platform/tools/document-tools.js

@@ -15,7 +15,7 @@ export function createDocumentTools(config) {
     // ---------------------------------------------------------------------------
     const projectDocumentAddTool = defineTool({
         name: 'project_document_add',
-        description: 'Add or update a project document (PRD, architecture, design, notes). If a document of the same type exists, it will be updated.',
+        description: 'Add or update a project document. Upserts if same type exists.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -34,7 +34,7 @@ export function createDocumentTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: ['doc_type', 'title', 'content'],
@@ -85,7 +85,7 @@ export function createDocumentTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: ['doc_type'],
@@ -132,7 +132,7 @@ export function createDocumentTools(config) {
             properties: {
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: [],
@@ -179,7 +179,7 @@ export function createDocumentTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: ['doc_type'],

package/dist/platform/tools/episode-tools.js

@@ -18,10 +18,7 @@ export function createEpisodeTools(config) {
     // ---------------------------------------------------------------------------
     const recallWorkTool = defineTool({
         name: 'recall_work',
-        description: 'Query work history — episodes of what agents have done in this project. ' +
-            'Returns episodes with agent attribution, effort level, and affected files. ' +
-            'Use before destructive operations to check what work would be affected. ' +
-            'Use to understand what has been done in this session or by other agents.',
+        description: 'Query work history episodes with agent attribution and affected files.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -40,7 +37,8 @@ export function createEpisodeTools(config) {
                 },
                 recent: {
                     type: 'number',
-                    description: 'Return N most recent episodes (default: 20)',
+                    description: 'Most recent episodes to return',
+                    default: 20,
                 },
             },
         },

package/dist/platform/tools/plan-tools.js

@@ -14,17 +14,17 @@ export function createPlanTools(config) {
     // ---------------------------------------------------------------------------
     const planCreateTool = defineTool({
         name: 'plan_create',
-        description: 'Create a new plan for the current project. Plans are used to document implementation approaches before coding. The plan is created with "draft" status.',
+        description: 'Create a new plan for the project. Created with "draft" status.',
         inputSchema: {
             type: 'object',
             properties: {
                 name: {
                     type: 'string',
-                    description: 'Plan name (kebab-case, 3-5 words). Example: "auth-jwt-migration", "add-dark-mode-toggle"',
+                    description: 'Plan name (kebab-case)',
                 },
                 content: {
                     type: 'string',
-                    description: 'Plan content in markdown format. Should include: Context, Goals, Steps, Verification sections.',
+                    description: 'Plan content (markdown)',
                 },
                 work_item_id: {
                     type: 'number',
@@ -32,7 +32,7 @@ export function createPlanTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: ['name', 'content'],
@@ -78,7 +78,7 @@ export function createPlanTools(config) {
     // ---------------------------------------------------------------------------
     const planUpdateTool = defineTool({
         name: 'plan_update',
-        description: 'Update an existing plan. Can update content, status, or work item link. Status transitions: draft→approved→in_progress→completed. Any status can transition to "abandoned".',
+        description: 'Update plan content, status, or work item link.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -154,7 +154,7 @@ export function createPlanTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Required when using name lookup. Defaults to active project.',
+                    description: 'Override active project (required for name lookup).',
                 },
             },
             required: [],
@@ -223,7 +223,8 @@ export function createPlanTools(config) {
                 status: {
                     type: 'string',
                     enum: ['draft', 'approved', 'in_progress', 'completed', 'abandoned', 'all'],
-                    description: 'Filter by status (default: all)',
+                    description: 'Filter by status',
+                    default: 'all',
                 },
                 work_item_id: {
                     type: 'number',
@@ -231,16 +232,18 @@ export function createPlanTools(config) {
                 },
                 limit: {
                     type: 'number',
-                    description: 'Maximum plans to return (default: 20)',
+                    description: 'Max plans to return',
+                    default: 20,
                 },
                 order_by: {
                     type: 'string',
                     enum: ['updated_desc', 'updated_asc', 'created_desc', 'name_asc'],
-                    description: 'Sort order (default: updated_desc)',
+                    description: 'Sort order',
+                    default: 'updated_desc',
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: [],

package/dist/platform/tools/project-tools.js

@@ -19,14 +19,13 @@ export function createProjectTools(config) {
     // ---------------------------------------------------------------------------
     const projectGetTool = defineTool({
         name: 'project_get',
-        description: 'Get the active project for the current directory, or get a project by ID/name. ' +
-            'Returns project details including metadata, workflow state, and last context.',
+        description: 'Get active project or look up by ID/name/path.',
         inputSchema: {
             type: 'object',
             properties: {
                 project_id: {
                     type: 'number',
-                    description: 'Project ID to look up (optional - uses active project or cwd detection if not provided)',
+                    description: 'Project ID to look up',
                 },
                 name: {
                     type: 'string',
@@ -113,7 +112,7 @@ export function createProjectTools(config) {
     // ---------------------------------------------------------------------------
     const projectCreateTool = defineTool({
         name: 'project_create',
-        description: 'Create a new tracked project. This promotes a directory to a tracked project with workflow support.',
+        description: 'Create a new tracked project with workflow support.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -141,7 +140,8 @@ export function createProjectTools(config) {
                 workflow_mode: {
                     type: 'string',
                     enum: ['flexible', 'guided'],
-                    description: 'Workflow mode: flexible (default) or guided',
+                    description: 'Workflow mode',
+                    default: 'flexible',
                 },
                 language: {
                     type: 'string',
@@ -219,13 +219,13 @@ export function createProjectTools(config) {
     // ---------------------------------------------------------------------------
     const projectUpdateTool = defineTool({
         name: 'project_update',
-        description: 'Update an existing project. Can update status, description, workflow mode, lifecycle state, and other fields.',
+        description: 'Update an existing project.',
         inputSchema: {
             type: 'object',
             properties: {
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to update a different project.',
+                    description: 'Override active project.',
                 },
                 status: {
                     type: 'string',
@@ -325,11 +325,13 @@ export function createProjectTools(config) {
                 status: {
                     type: 'string',
                     enum: ['active', 'paused', 'completed', 'archived', 'all'],
-                    description: 'Filter by status (default: all)',
+                    description: 'Filter by status',
+                    default: 'all',
                 },
                 limit: {
                     type: 'number',
-                    description: 'Maximum number of projects to return (default: 20)',
+                    description: 'Max results',
+                    default: 20,
                 },
             },
             required: [],

package/dist/platform/tools/workitem-tools.js

@@ -12,7 +12,7 @@
  * - workitem_advance_step imports from ../workflow.js (SDK's module)
  */
 import { defineTool, createSuccessResult, createErrorResult } from '@compilr-dev/agents';
-import { getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, STEP_ORDER, } from '../workflow.js';
+import { getNextStep, isValidTransition, getStepCriteria, formatStepDisplay } from '../workflow.js';
 // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export function createWorkItemTools(config) {
     const { context: ctx, hooks } = config;
@@ -21,16 +21,15 @@ export function createWorkItemTools(config) {
     // ---------------------------------------------------------------------------
     const workitemQueryTool = defineTool({
         name: 'workitem_query',
-        description: 'Query PERSISTENT work items from the project backlog (stored in database). ' +
-            'For session todos shown in footer, use todo_read. ' +
-            'Supports filtering by status, type, priority, owner, and search.',
+        description: 'Query work items from the project backlog. Supports filtering by status, type, priority, owner, and search.',
         inputSchema: {
             type: 'object',
             properties: {
                 status: {
                     type: 'string',
                     enum: ['backlog', 'in_progress', 'completed', 'skipped', 'all'],
-                    description: 'Filter by status (default: all)',
+                    description: 'Filter by status',
+                    default: 'all',
                 },
                 type: {
                     type: 'string',
@@ -52,15 +51,17 @@ export function createWorkItemTools(config) {
                 },
                 limit: {
                     type: 'number',
-                    description: 'Maximum items to return (default: 50)',
+                    description: 'Max items to return',
+                    default: 50,
                 },
                 offset: {
                     type: 'number',
-                    description: 'Offset for pagination (default: 0)',
+                    description: 'Pagination offset',
+                    default: 0,
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: [],
@@ -120,8 +121,7 @@ export function createWorkItemTools(config) {
     // ---------------------------------------------------------------------------
     const workitemAddTool = defineTool({
         name: 'workitem_add',
-        description: 'Add a PERSISTENT work item to the project backlog (stored in database). ' +
-            'For session-level tasks shown in footer, use todo_write.',
+        description: 'Add a work item to the project backlog.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -141,7 +141,8 @@ export function createWorkItemTools(config) {
                 priority: {
                     type: 'string',
                     enum: ['critical', 'high', 'medium', 'low'],
-                    description: 'Priority (default: medium)',
+                    description: 'Priority',
+                    default: 'medium',
                 },
                 estimated_effort: {
                     type: 'string',
@@ -154,7 +155,7 @@ export function createWorkItemTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: ['type', 'title'],
@@ -199,8 +200,7 @@ export function createWorkItemTools(config) {
     // ---------------------------------------------------------------------------
     const workitemUpdateTool = defineTool({
         name: 'workitem_update',
-        description: 'Update a PERSISTENT work item in the project backlog (stored in database). ' +
-            'Can update status, priority, owner, title, description, and more.',
+        description: 'Update a work item in the project backlog.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -210,7 +210,7 @@ export function createWorkItemTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
                 status: {
                     type: 'string',
@@ -311,7 +311,7 @@ export function createWorkItemTools(config) {
     // ---------------------------------------------------------------------------
     const workitemNextTool = defineTool({
         name: 'workitem_next',
-        description: 'Get the next work item to work on (highest priority backlog item). Useful for guided mode to pick the next task.',
+        description: 'Get the next highest-priority backlog item to work on.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -322,7 +322,7 @@ export function createWorkItemTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: [],
@@ -376,7 +376,7 @@ export function createWorkItemTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: ['item_id'],
@@ -410,13 +410,13 @@ export function createWorkItemTools(config) {
     // ---------------------------------------------------------------------------
     const workitemStatusCountsTool = defineTool({
         name: 'workitem_status_counts',
-        description: 'Get counts of work items by status for the current project. Useful for showing progress.',
+        description: 'Get work item counts by status for progress tracking.',
         inputSchema: {
             type: 'object',
             properties: {
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: [],
@@ -448,10 +448,7 @@ export function createWorkItemTools(config) {
     // ---------------------------------------------------------------------------
     const workitemAdvanceStepTool = defineTool({
         name: 'workitem_advance_step',
-        description: `Advance a work item to the next guided workflow step.\n` +
-            `Steps progress in order: ${STEP_ORDER.join(' → ')} → complete.\n` +
-            `Use this tool when the criteria for the current step are met.\n` +
-            `The agent should explicitly call this to advance - it provides visibility and audit trail.`,
+        description: 'Advance a work item to the next guided workflow step. Call when step criteria are met.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -469,7 +466,7 @@ export function createWorkItemTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: ['item_id', 'reason'],
@@ -576,8 +573,7 @@ export function createWorkItemTools(config) {
     // ---------------------------------------------------------------------------
     const workitemClaimTool = defineTool({
         name: 'workitem_claim',
-        description: 'Claim an unassigned PERSISTENT work item from project backlog. ' +
-            'For session todos in footer, use todo_claim.',
+        description: 'Claim an unassigned work item from the project backlog.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -591,7 +587,7 @@ export function createWorkItemTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: ['item_id', 'agent_id'],
@@ -639,8 +635,7 @@ export function createWorkItemTools(config) {
     // ---------------------------------------------------------------------------
     const workitemHandoffTool = defineTool({
         name: 'workitem_handoff',
-        description: 'Hand off a PERSISTENT work item (from project backlog) to another agent. ' +
-            'For session todos in footer, use todo_handoff.',
+        description: 'Hand off a work item to another agent.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -658,7 +653,7 @@ export function createWorkItemTools(config) {
                 },
                 project_id: {
                     type: 'number',
-                    description: 'Optional. Defaults to active project. Only needed to target a different project.',
+                    description: 'Override active project.',
                 },
             },
             required: ['item_id', 'to_agent_id'],

package/dist/system-prompt/index.d.ts

@@ -31,4 +31,4 @@
  * ```
  */
 export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, type SystemPromptContext, type BuildResult, } from './builder.js';
-export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, type SystemPromptModule, type ModuleConditions, } from './modules.js';
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, type SystemPromptModule, type ModuleConditions, } from './modules.js';

package/dist/system-prompt/index.js

@@ -31,4 +31,4 @@
  * ```
  */
 export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, } from './builder.js';
-export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './modules.js';
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './modules.js';

package/dist/system-prompt/modules.d.ts

@@ -69,6 +69,11 @@ export declare const TOOL_USAGE_DIRECT_MODULE: SystemPromptModule;
  * disambiguation, file pagination, edit matching, suggest quality.
  */
 export declare const TOOL_USAGE_HINTS_MODULE: SystemPromptModule;
+/**
+ * Platform tool hints module - behavioral guidance extracted from tool descriptions
+ * Only included when meta-tools are enabled
+ */
+export declare const PLATFORM_TOOL_HINTS_MODULE: SystemPromptModule;
 /**
  * Tool usage module (meta-tools) - only if enableMetaTools=true
  * Explains how to use specialized tools via meta-tools

package/dist/system-prompt/modules.js

@@ -161,6 +161,24 @@ export const TOOL_USAGE_HINTS_MODULE = {
 - **edit matching:** \`edit\` uses exact string matching. Provide enough surrounding context to make the match unique. If the match fails, read the file first to get the exact text.
 - **suggest quality:** Suggestions should be specific and actionable (e.g., "run npm test" not "continue working").`,
 };
+/**
+ * Platform tool hints module - behavioral guidance extracted from tool descriptions
+ * Only included when meta-tools are enabled
+ */
+export const PLATFORM_TOOL_HINTS_MODULE = {
+    id: 'platform-tool-hints',
+    name: 'Platform Tool Hints',
+    estimatedTokens: 120,
+    conditions: { enableMetaTools: true },
+    content: `## Platform Tool Hints
+
+- **workitem_* vs todo_***: workitem_* tools manage PERSISTENT backlog items (database). todo_* tools manage ephemeral session tasks (footer display). Use workitem_claim/workitem_handoff for persistent ownership, todo_claim/todo_handoff for session tasks.
+- **project_id**: All project/workitem/document/plan tools default to the active project. Only pass project_id to target a different project.
+- **Plan status flow**: draft → approved → in_progress → completed. Any → abandoned. abandoned → draft.
+- **Anchors**: Use "critical" priority sparingly (user prefs, safety constraints). Most anchors should be "info" priority with "project" scope.
+- **Artifacts**: Types: design, plan, review, decision, note. Names must be unique within team.
+- **recall_work**: Check before destructive ops to see what work would be affected.`,
+};
 /**
  * Tool usage module (meta-tools) - only if enableMetaTools=true
  * Explains how to use specialized tools via meta-tools
@@ -313,6 +331,7 @@ export const ALL_MODULES = [
     TODO_MANAGEMENT_MODULE,
     TOOL_USAGE_DIRECT_MODULE,
     TOOL_USAGE_HINTS_MODULE,
+    PLATFORM_TOOL_HINTS_MODULE, // Conditional: enableMetaTools
     TOOL_USAGE_META_MODULE, // Conditional: enableMetaTools
     DELEGATION_MODULE,
     GIT_SAFETY_MODULE, // Conditional: hasGit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",