@compilr-dev/sdk 0.7.13 → 0.7.15

package/dist/agent.js

@@ -99,9 +99,7 @@ class CompilrAgentImpl {
             apiKey: config?.apiKey,
         });
         // Resolve preset — non-software projects get 'general' by default
-        const defaultPreset = config?.projectCategory && config.projectCategory !== 'software'
-            ? 'general'
-            : 'coding';
+        const defaultPreset = config?.projectCategory && config.projectCategory !== 'software' ? 'general' : 'coding';
         const preset = resolvePreset(config?.preset ?? defaultPreset);
         // Build system prompt
         let systemPrompt;
@@ -239,6 +237,41 @@ class CompilrAgentImpl {
                 : [];
             mergedHooks.beforeLLM = [...existingHooks, ...capabilityHooks];
         }
+        // Build observation mask config — SDK defaults include platform tools
+        const observationMask = config?.context?.observationMask !== false
+            ? {
+                maskAfterTurns: 3,
+                minCharsToMask: 200,
+                alwaysMaskEarly: [
+                    // Coding tools (agents library defaults)
+                    'read_file',
+                    'bash',
+                    'bash_output',
+                    'grep',
+                    'glob',
+                    // Platform document/model tools (large results)
+                    'project_document_get',
+                    'project_document_list',
+                    'backlog_read',
+                    'workitem_query',
+                    // Factory model tools
+                    'app_model_get',
+                    'research_model_get',
+                    'business_model_get',
+                    'brand_model_get',
+                    'curriculum_model_get',
+                    'book_model_get',
+                    // Other large-output tools
+                    'anchor_list',
+                    'artifact_list',
+                    'plan_get',
+                ],
+                // Merge user overrides if provided
+                ...(typeof config?.context?.observationMask === 'object'
+                    ? config.context.observationMask
+                    : {}),
+            }
+            : false;
         this.agent = new Agent({
             provider,
             systemPrompt,
@@ -246,6 +279,7 @@ class CompilrAgentImpl {
             toolTimeoutMs: config?.toolTimeoutMs,
             contextManager,
             autoContextManagement: contextManager !== undefined,
+            observationMask: contextManager ? observationMask : undefined,
             hooks: mergedHooks,
             pins: {},
             permissions: {
@@ -279,13 +313,15 @@ class CompilrAgentImpl {
         }
     }
     async run(message, options) {
-        // Set external listener so constructor's onEvent can forward events
+        // Set external listener so constructor's onEvent can forward events.
+        // Do NOT also pass onEvent to agent.run() — the underlying Agent's emit()
+        // already calls both this.onEvent (constructor) AND options.onEvent (per-run).
+        // Passing the same callback via both paths would double-deliver every event.
         this.externalEventListener = options?.onEvent;
         try {
             const result = await this.agent.run(message, {
                 signal: options?.signal ?? this.abortController.signal,
                 maxIterations: options?.maxIterations,
-                onEvent: options?.onEvent,
                 toolFilter: options?.toolFilter,
             });
             return toRunResult(result);

package/dist/capabilities/packs.js

@@ -261,13 +261,26 @@ export const CAPABILITY_PACKS = {
         id: 'factory_models',
         label: 'Structured Models',
         tools: [
-            'app_model_get', 'app_model_update', 'app_model_validate',
-            'research_model_get', 'research_model_update', 'research_model_validate',
-            'bibliography_generate', 'bibtex_import',
-            'business_model_get', 'business_model_update', 'business_model_validate',
-            'brand_model_get', 'brand_model_update', 'brand_model_validate',
-            'curriculum_model_get', 'curriculum_model_update', 'curriculum_model_validate',
-            'book_model_get', 'book_model_update', 'book_model_validate',
+            'app_model_get',
+            'app_model_update',
+            'app_model_validate',
+            'research_model_get',
+            'research_model_update',
+            'research_model_validate',
+            'bibliography_generate',
+            'bibtex_import',
+            'business_model_get',
+            'business_model_update',
+            'business_model_validate',
+            'brand_model_get',
+            'brand_model_update',
+            'brand_model_validate',
+            'curriculum_model_get',
+            'curriculum_model_update',
+            'curriculum_model_validate',
+            'book_model_get',
+            'book_model_update',
+            'book_model_validate',
         ],
         readOnly: false,
         promptModules: ['factory-tool-hints'],
@@ -279,8 +292,12 @@ export const CAPABILITY_PACKS = {
         id: 'factory_scaffold',
         label: 'Code Scaffolding',
         tools: [
-            'factory_scaffold', 'factory_list_toolkits',
-            'research_scaffold', 'business_scaffold', 'content_scaffold', 'book_scaffold',
+            'factory_scaffold',
+            'factory_list_toolkits',
+            'research_scaffold',
+            'business_scaffold',
+            'content_scaffold',
+            'book_scaffold',
         ],
         readOnly: false,
         promptModules: ['factory-tool-hints'],

package/dist/config.d.ts

@@ -1,7 +1,7 @@
 /**
  * SDK configuration types
  */
-import type { LLMProvider, Message, Tool, ToolPermission, HooksConfig, AnchorInput, AgentEvent, ToolExecutionResult, DelegationConfig } from '@compilr-dev/agents';
+import type { LLMProvider, Message, Tool, ToolPermission, HooksConfig, AnchorInput, AgentEvent, ToolExecutionResult, DelegationConfig, ObservationMaskConfig } from '@compilr-dev/agents';
 import type { Preset } from './presets/types.js';
 import type { ToolProfile } from './team/tool-config.js';
 import type { ConditionalModule } from './capabilities/hook.js';
@@ -100,6 +100,12 @@ export interface ContextConfig {
     compactionThreshold?: number;
     /** Threshold (0-1) to trigger emergency summarization. Default: 0.9 */
     summarizationThreshold?: number;
+    /**
+     * Observation masking — replaces old tool results with compact placeholders.
+     * When omitted, SDK defaults are used (includes platform tools in alwaysMaskEarly).
+     * Set to false to disable masking entirely.
+     */
+    observationMask?: Partial<ObservationMaskConfig> | false;
 }
 /**
  * Usage information for the agent

package/dist/platform/tools/document-tools.d.ts

@@ -1,15 +1,22 @@
 /**
  * Document Tools — CRUD operations for project documents.
  *
- * 4 tools: project_document_add, project_document_get,
- *          project_document_list, project_document_delete
+ * 5 tools: project_document_add, project_document_get,
+ *          project_document_list, project_document_delete,
+ *          project_document_patch
  *
  * Ported from CLI's src/tools/document-db.ts.
  */
 import type { PlatformToolsConfig } from '../context.js';
-export declare function createDocumentTools(config: PlatformToolsConfig): import("@compilr-dev/agents").Tool<{
+export declare function createDocumentTools(config: PlatformToolsConfig): (import("@compilr-dev/agents").Tool<{
     project_id?: number;
     doc_type: string;
     title: string;
     content: string;
-}>[];
+}> | import("@compilr-dev/agents").Tool<{
+    project_id?: number;
+    doc_type: string;
+    operation: string;
+    content: string;
+    section_heading?: string;
+}>)[];

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

@@ -1,8 +1,9 @@
 /**
  * Document Tools — CRUD operations for project documents.
  *
- * 4 tools: project_document_add, project_document_get,
- *          project_document_list, project_document_delete
+ * 5 tools: project_document_add, project_document_get,
+ *          project_document_list, project_document_delete,
+ *          project_document_patch
  *
  * Ported from CLI's src/tools/document-db.ts.
  */
@@ -10,19 +11,41 @@ import { defineTool, createSuccessResult, createErrorResult } from '@compilr-dev
 /** All valid document types — keep in sync with DocumentType in types.ts. */
 const DOC_TYPE_ENUM = [
     // Software
-    'prd', 'architecture', 'design', 'notes', 'plan',
+    'prd',
+    'architecture',
+    'design',
+    'notes',
+    'plan',
     // Structured models
-    'app-model', 'research-model', 'business-model', 'brand-model', 'curriculum-model', 'book-model',
+    'app-model',
+    'research-model',
+    'business-model',
+    'brand-model',
+    'curriculum-model',
+    'book-model',
     // Research
-    'outline', 'literature-review', 'abstract', 'methodology', 'bibliography',
+    'outline',
+    'literature-review',
+    'abstract',
+    'methodology',
+    'bibliography',
     // Business
-    'executive-summary', 'market-analysis', 'financial-model', 'pitch',
+    'executive-summary',
+    'market-analysis',
+    'financial-model',
+    'pitch',
     // Content & Marketing
-    'editorial-calendar', 'article',
+    'editorial-calendar',
+    'article',
     // Tech Docs
-    'getting-started', 'api-reference', 'tutorial',
+    'getting-started',
+    'api-reference',
+    'tutorial',
     // General
-    'draft', 'review', 'session-notes', 'chapter',
+    'draft',
+    'review',
+    'session-notes',
+    'chapter',
 ];
 // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export function createDocumentTools(config) {
@@ -225,10 +248,133 @@ export function createDocumentTools(config) {
             }
         },
     });
+    // ---------------------------------------------------------------------------
+    // project_document_patch
+    // ---------------------------------------------------------------------------
+    const projectDocumentPatchTool = defineTool({
+        name: 'project_document_patch',
+        description: 'Patch a project document without reading the full content. ' +
+            'Supports append, prepend, and replace_section operations. ' +
+            'The full document is read and modified server-side — only the patch content goes through context.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                doc_type: {
+                    type: 'string',
+                    enum: DOC_TYPE_ENUM,
+                    description: 'Document type to patch',
+                },
+                operation: {
+                    type: 'string',
+                    enum: ['append', 'prepend', 'replace_section'],
+                    description: 'append: add content to end. ' +
+                        'prepend: add content to beginning. ' +
+                        'replace_section: replace content under a markdown heading (## Heading).',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Content to insert or replace with',
+                },
+                section_heading: {
+                    type: 'string',
+                    description: 'Required for replace_section. The exact markdown heading text (e.g., "## Section 4: Results"). ' +
+                        'Replaces everything from this heading to the next heading of equal or higher level (or end of document).',
+                },
+                project_id: {
+                    type: 'number',
+                    description: 'Override active project.',
+                },
+            },
+            required: ['doc_type', 'operation', 'content'],
+        },
+        execute: async (input) => {
+            try {
+                const projectId = input.project_id ?? ctx.currentProjectId;
+                if (!projectId) {
+                    return createErrorResult('No project specified and no active project. Use project_get or /projects to select a project first.');
+                }
+                const doc = await ctx.documents.getByType(projectId, input.doc_type);
+                if (!doc) {
+                    return createErrorResult(`No ${input.doc_type} document found. Use project_document_add to create it first.`);
+                }
+                let newContent;
+                switch (input.operation) {
+                    case 'append':
+                        newContent = doc.content + '\n\n' + input.content;
+                        break;
+                    case 'prepend':
+                        newContent = input.content + '\n\n' + doc.content;
+                        break;
+                    case 'replace_section': {
+                        if (!input.section_heading) {
+                            return createErrorResult('section_heading is required for replace_section operation.');
+                        }
+                        const heading = input.section_heading.trim();
+                        // Determine heading level from the target
+                        const headingLevel = heading.match(/^(#{1,6})\s/)?.[1]?.length ?? 2;
+                        // Find the heading in the document
+                        const lines = doc.content.split('\n');
+                        let sectionStart = -1;
+                        let sectionEnd = lines.length;
+                        for (let i = 0; i < lines.length; i++) {
+                            const line = lines[i].trim();
+                            if (sectionStart === -1) {
+                                // Look for the target heading
+                                if (line === heading) {
+                                    sectionStart = i;
+                                }
+                            }
+                            else {
+                                // Look for the next heading of same or higher level
+                                const nextMatch = line.match(/^(#{1,6})\s/);
+                                if (nextMatch && nextMatch[1].length <= headingLevel) {
+                                    sectionEnd = i;
+                                    break;
+                                }
+                            }
+                        }
+                        if (sectionStart === -1) {
+                            return createErrorResult(`Section "${heading}" not found in document. Available headings: ${lines
+                                .filter((l) => l.trim().match(/^#{1,6}\s/))
+                                .map((l) => l.trim())
+                                .join(', ') || '(none)'}`);
+                        }
+                        // Replace the section (heading + body) with new content
+                        const before = lines.slice(0, sectionStart).join('\n');
+                        const after = lines.slice(sectionEnd).join('\n');
+                        newContent = [before, input.content, after].filter((s) => s.length > 0).join('\n\n');
+                        break;
+                    }
+                    default:
+                        return createErrorResult(`Unknown operation: ${input.operation}. Use append, prepend, or replace_section.`);
+                }
+                const updated = await ctx.documents.update(doc.id, { content: newContent });
+                if (!updated) {
+                    return createErrorResult('Failed to update document.');
+                }
+                return createSuccessResult({
+                    success: true,
+                    message: `Document "${doc.title}" patched (${input.operation})`,
+                    document: {
+                        id: updated.id,
+                        docType: updated.docType,
+                        title: updated.title,
+                        contentLength: updated.content.length,
+                        previousLength: doc.content.length,
+                        updatedAt: updated.updatedAt.toISOString(),
+                    },
+                });
+            }
+            catch (error) {
+                return createErrorResult(`Failed to patch document: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    });
     return [
         projectDocumentAddTool,
         projectDocumentGetTool,
         projectDocumentListTool,
         projectDocumentDeleteTool,
+        projectDocumentPatchTool,
     ];
 }

package/dist/project-types/action-meta.js

@@ -55,29 +55,129 @@ export const ACTION_META_REGISTRY = {
         description: 'Review the paper',
     },
     // ── Business Plan project actions ──────────────────────────────────────────
-    'business-vision': { id: 'business-vision', label: 'Vision', icon: 'Target', description: 'Define your business' },
-    'market-analysis': { id: 'market-analysis', label: 'Market', icon: 'TrendingUp', description: 'Analyze the market' },
-    'competitor-analysis': { id: 'competitor-analysis', label: 'Competitors', icon: 'Swords', description: 'Map competition' },
+    'business-vision': {
+        id: 'business-vision',
+        label: 'Vision',
+        icon: 'Target',
+        description: 'Define your business',
+    },
+    'market-analysis': {
+        id: 'market-analysis',
+        label: 'Market',
+        icon: 'TrendingUp',
+        description: 'Analyze the market',
+    },
+    'competitor-analysis': {
+        id: 'competitor-analysis',
+        label: 'Competitors',
+        icon: 'Swords',
+        description: 'Map competition',
+    },
     // ── Content & Marketing actions ───────────────────────────────────────────
-    'brand-setup': { id: 'brand-setup', label: 'Brand', icon: 'Palette', description: 'Set up brand identity' },
-    'content-strategy': { id: 'content-strategy', label: 'Strategy', icon: 'Target', description: 'Define pillars' },
-    'content-calendar': { id: 'content-calendar', label: 'Calendar', icon: 'Calendar', description: 'Plan content' },
-    'create-content': { id: 'create-content', label: 'Create', icon: 'PenTool', description: 'Write content' },
-    'content-review': { id: 'content-review', label: 'Review', icon: 'CheckCircle', description: 'Check quality' },
+    'brand-setup': {
+        id: 'brand-setup',
+        label: 'Brand',
+        icon: 'Palette',
+        description: 'Set up brand identity',
+    },
+    'content-strategy': {
+        id: 'content-strategy',
+        label: 'Strategy',
+        icon: 'Target',
+        description: 'Define pillars',
+    },
+    'content-calendar': {
+        id: 'content-calendar',
+        label: 'Calendar',
+        icon: 'Calendar',
+        description: 'Plan content',
+    },
+    'create-content': {
+        id: 'create-content',
+        label: 'Create',
+        icon: 'PenTool',
+        description: 'Write content',
+    },
+    'content-review': {
+        id: 'content-review',
+        label: 'Review',
+        icon: 'CheckCircle',
+        description: 'Check quality',
+    },
     // ── Book actions ─────────────────────────────────────────────────────────
-    'book-outline': { id: 'book-outline', label: 'Outline', icon: 'BookOpen', description: 'Plan structure' },
-    'character-design': { id: 'character-design', label: 'Characters', icon: 'Users', description: 'Build cast' },
-    'plot-threads': { id: 'plot-threads', label: 'Threads', icon: 'GitBranch', description: 'Map plot lines' },
-    'scene-breakdown': { id: 'scene-breakdown', label: 'Scenes', icon: 'Layers', description: 'Detail scenes' },
-    'book-review': { id: 'book-review', label: 'Review', icon: 'CheckCircle', description: 'Structure check' },
+    'book-outline': {
+        id: 'book-outline',
+        label: 'Outline',
+        icon: 'BookOpen',
+        description: 'Plan structure',
+    },
+    'character-design': {
+        id: 'character-design',
+        label: 'Characters',
+        icon: 'Users',
+        description: 'Build cast',
+    },
+    'plot-threads': {
+        id: 'plot-threads',
+        label: 'Threads',
+        icon: 'GitBranch',
+        description: 'Map plot lines',
+    },
+    'scene-breakdown': {
+        id: 'scene-breakdown',
+        label: 'Scenes',
+        icon: 'Layers',
+        description: 'Detail scenes',
+    },
+    'book-review': {
+        id: 'book-review',
+        label: 'Review',
+        icon: 'CheckCircle',
+        description: 'Structure check',
+    },
     // ── Course / Training actions ─────────────────────────────────────────────
-    'curriculum-design': { id: 'curriculum-design', label: 'Curriculum', icon: 'School', description: 'Define structure' },
-    'lesson-plan': { id: 'lesson-plan', label: 'Lessons', icon: 'BookOpen', description: 'Plan lessons' },
-    'assessment-design': { id: 'assessment-design', label: 'Assess', icon: 'ClipboardCheck', description: 'Create assessments' },
-    'course-review': { id: 'course-review', label: 'Review', icon: 'CheckCircle', description: 'Quality check' },
-    'financial-model': { id: 'financial-model', label: 'Financials', icon: 'DollarSign', description: 'Build projections' },
-    'pitch-outline': { id: 'pitch-outline', label: 'Pitch', icon: 'Rocket', description: 'Structure a pitch' },
-    'business-review': { id: 'business-review', label: 'Review', icon: 'ShieldCheck', description: 'Validate the plan' },
+    'curriculum-design': {
+        id: 'curriculum-design',
+        label: 'Curriculum',
+        icon: 'School',
+        description: 'Define structure',
+    },
+    'lesson-plan': {
+        id: 'lesson-plan',
+        label: 'Lessons',
+        icon: 'BookOpen',
+        description: 'Plan lessons',
+    },
+    'assessment-design': {
+        id: 'assessment-design',
+        label: 'Assess',
+        icon: 'ClipboardCheck',
+        description: 'Create assessments',
+    },
+    'course-review': {
+        id: 'course-review',
+        label: 'Review',
+        icon: 'CheckCircle',
+        description: 'Quality check',
+    },
+    'financial-model': {
+        id: 'financial-model',
+        label: 'Financials',
+        icon: 'DollarSign',
+        description: 'Build projections',
+    },
+    'pitch-outline': {
+        id: 'pitch-outline',
+        label: 'Pitch',
+        icon: 'Rocket',
+        description: 'Structure a pitch',
+    },
+    'business-review': {
+        id: 'business-review',
+        label: 'Review',
+        icon: 'ShieldCheck',
+        description: 'Validate the plan',
+    },
     // ── Work item actions ────────────────────────────────────────────────────
     build: {
         id: 'build',

package/dist/project-types/configs.js

@@ -340,7 +340,11 @@ export const businessPlanConfig = {
         { role: 'writer', label: 'Writer', description: 'Clear, persuasive business writing' },
     ],
     documentTemplates: [
-        { type: 'business-model', label: 'Business Model', description: 'Structured business model (identity, market, competitors, financials)' },
+        {
+            type: 'business-model',
+            label: 'Business Model',
+            description: 'Structured business model (identity, market, competitors, financials)',
+        },
         { type: 'executive-summary', label: 'Executive Summary', description: 'Business overview' },
         {
             type: 'market-analysis',
@@ -351,7 +355,15 @@ export const businessPlanConfig = {
         { type: 'pitch', label: 'Pitch Narrative', description: 'Investor pitch content' },
         { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
     ],
-    projectActions: ['business-vision', 'market-analysis', 'competitor-analysis', 'financial-model', 'pitch-outline', 'business-review', 'session-notes'],
+    projectActions: [
+        'business-vision',
+        'market-analysis',
+        'competitor-analysis',
+        'financial-model',
+        'pitch-outline',
+        'business-review',
+        'session-notes',
+    ],
     workItemActions: ['refine-item', 'explain'],
     workItemLabels: {
         feature: { short: 'ML', full: 'Milestone' },
@@ -419,23 +431,61 @@ export const contentConfig = {
             description: 'Plan content for the period',
             completionCheck: 'has-workitems',
         },
-        { id: 'create', label: 'Create', description: 'Write copy and visual briefs', completionCheck: 'has-workitems' },
-        { id: 'review', label: 'Review', description: 'Check voice and brand consistency', completionCheck: 'manual' },
-        { id: 'publish', label: 'Publish', description: 'Finalize and publish', completionCheck: 'manual' },
+        {
+            id: 'create',
+            label: 'Create',
+            description: 'Write copy and visual briefs',
+            completionCheck: 'has-workitems',
+        },
+        {
+            id: 'review',
+            label: 'Review',
+            description: 'Check voice and brand consistency',
+            completionCheck: 'manual',
+        },
+        {
+            id: 'publish',
+            label: 'Publish',
+            description: 'Finalize and publish',
+            completionCheck: 'manual',
+        },
     ],
     suggestedAgents: [
-        { role: 'strategist', label: 'Content Strategist', description: 'Planning, ideation, calendar, repurposing' },
-        { role: 'writer', label: 'Copywriter', description: 'Headlines, captions, CTAs, long-form copy' },
+        {
+            role: 'strategist',
+            label: 'Content Strategist',
+            description: 'Planning, ideation, calendar, repurposing',
+        },
+        {
+            role: 'writer',
+            label: 'Copywriter',
+            description: 'Headlines, captions, CTAs, long-form copy',
+        },
         { role: 'designer', label: 'Visual Director', description: 'Visual briefs from Brand Model' },
-        { role: 'editor', label: 'Editor', description: 'Voice consistency, quality review, on-brand checks' },
+        {
+            role: 'editor',
+            label: 'Editor',
+            description: 'Voice consistency, quality review, on-brand checks',
+        },
     ],
     documentTemplates: [
-        { type: 'brand-model', label: 'Brand Model', description: 'Brand identity, voice, visual guidelines, audience, strategy' },
+        {
+            type: 'brand-model',
+            label: 'Brand Model',
+            description: 'Brand identity, voice, visual guidelines, audience, strategy',
+        },
         { type: 'editorial-calendar', label: 'Editorial Calendar', description: 'Content schedule' },
         { type: 'article', label: 'Article', description: 'Blog post or article draft' },
         { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
     ],
-    projectActions: ['brand-setup', 'content-strategy', 'content-calendar', 'create-content', 'content-review', 'session-notes'],
+    projectActions: [
+        'brand-setup',
+        'content-strategy',
+        'content-calendar',
+        'create-content',
+        'content-review',
+        'session-notes',
+    ],
     workItemActions: ['refine-item', 'explain'],
     workItemLabels: {
         feature: { short: 'PC', full: 'Content Piece' },
@@ -607,16 +657,34 @@ export const courseConfig = {
         },
     ],
     suggestedAgents: [
-        { role: 'instructor', label: 'Instructor', description: 'Curriculum design, sequencing, pedagogy' },
-        { role: 'content-designer', label: 'Content Designer', description: 'Lesson planning, exercises, assessments' },
+        {
+            role: 'instructor',
+            label: 'Instructor',
+            description: 'Curriculum design, sequencing, pedagogy',
+        },
+        {
+            role: 'content-designer',
+            label: 'Content Designer',
+            description: 'Lesson planning, exercises, assessments',
+        },
         { role: 'reviewer', label: 'Reviewer', description: 'Pedagogical quality, balance, coverage' },
     ],
     documentTemplates: [
-        { type: 'curriculum-model', label: 'Curriculum', description: 'Course structure, modules, lessons, assessments' },
+        {
+            type: 'curriculum-model',
+            label: 'Curriculum',
+            description: 'Course structure, modules, lessons, assessments',
+        },
         { type: 'notes', label: 'Lesson Notes', description: 'Lesson content and materials' },
         { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
     ],
-    projectActions: ['curriculum-design', 'lesson-plan', 'assessment-design', 'course-review', 'session-notes'],
+    projectActions: [
+        'curriculum-design',
+        'lesson-plan',
+        'assessment-design',
+        'course-review',
+        'session-notes',
+    ],
     workItemActions: ['refine-item', 'explain'],
     workItemLabels: {
         feature: { short: 'LS', full: 'Lesson' },
@@ -687,20 +755,48 @@ export const bookConfig = {
             description: 'Break chapters into scenes',
             completionCheck: 'has-workitems',
         },
-        { id: 'draft', label: 'Draft', description: 'Write chapter drafts', completionCheck: 'has-workitems' },
+        {
+            id: 'draft',
+            label: 'Draft',
+            description: 'Write chapter drafts',
+            completionCheck: 'has-workitems',
+        },
         { id: 'review', label: 'Review', description: 'Structural review', completionCheck: 'manual' },
     ],
     suggestedAgents: [
-        { role: 'plotter', label: 'Plotter', description: 'Story architecture, beats, pacing, plot threads' },
-        { role: 'character-dev', label: 'Character Dev', description: 'Characters, arcs, relationships, voice' },
-        { role: 'scene-writer', label: 'Scene Writer', description: 'Scene construction, setting, POV, transitions' },
+        {
+            role: 'plotter',
+            label: 'Plotter',
+            description: 'Story architecture, beats, pacing, plot threads',
+        },
+        {
+            role: 'character-dev',
+            label: 'Character Dev',
+            description: 'Characters, arcs, relationships, voice',
+        },
+        {
+            role: 'scene-writer',
+            label: 'Scene Writer',
+            description: 'Scene construction, setting, POV, transitions',
+        },
     ],
     documentTemplates: [
-        { type: 'book-model', label: 'Book Model', description: 'Story structure, characters, plot threads, beats' },
+        {
+            type: 'book-model',
+            label: 'Book Model',
+            description: 'Story structure, characters, plot threads, beats',
+        },
         { type: 'notes', label: 'Chapter Draft', description: 'Chapter content' },
         { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
     ],
-    projectActions: ['book-outline', 'character-design', 'plot-threads', 'scene-breakdown', 'book-review', 'session-notes'],
+    projectActions: [
+        'book-outline',
+        'character-design',
+        'plot-threads',
+        'scene-breakdown',
+        'book-review',
+        'session-notes',
+    ],
     workItemActions: ['refine-item', 'explain'],
     workItemLabels: {
         feature: { short: 'CH', full: 'Chapter' },

package/dist/project-types/index.js

@@ -25,10 +25,10 @@ export const PROJECT_TYPES = [
 ];
 /** Type aliases — legacy or alternative IDs that map to a canonical config */
 const TYPE_ALIASES = {
-    'generated': 'web', // Legacy: factory-scaffolded projects before type selection
-    'cli': 'web',
-    'api': 'web',
-    'library': 'web',
+    generated: 'web', // Legacy: factory-scaffolded projects before type selection
+    cli: 'web',
+    api: 'web',
+    library: 'web',
 };
 /** Get a project type config by ID. Falls back to general. */
 export function getProjectTypeConfig(typeId) {

package/dist/project-types/skill-meta.js

@@ -107,29 +107,149 @@ export const SKILL_META_REGISTRY = {
         category: 'research',
     },
     // ── Business Plan Skills ──────────────────────────────────────────────────
-    'business-vision': { id: 'business-vision', label: 'Business Vision', description: 'Define business identity and value proposition', icon: 'Target', category: 'planning' },
-    'market-analysis': { id: 'market-analysis', label: 'Market Analysis', description: 'Analyze market size, trends, and segments', icon: 'TrendingUp', category: 'analysis' },
-    'competitor-analysis': { id: 'competitor-analysis', label: 'Competitor Analysis', description: 'Map competitive landscape', icon: 'Swords', category: 'analysis' },
-    'financial-model': { id: 'financial-model', label: 'Financial Model', description: 'Build revenue and cost projections', icon: 'DollarSign', category: 'analysis' },
-    'pitch-outline': { id: 'pitch-outline', label: 'Pitch Outline', description: 'Structure an investor pitch', icon: 'Rocket', category: 'planning' },
-    'business-review': { id: 'business-review', label: 'Business Review', description: 'Validate the business plan', icon: 'ShieldCheck', category: 'analysis' },
+    'business-vision': {
+        id: 'business-vision',
+        label: 'Business Vision',
+        description: 'Define business identity and value proposition',
+        icon: 'Target',
+        category: 'planning',
+    },
+    'market-analysis': {
+        id: 'market-analysis',
+        label: 'Market Analysis',
+        description: 'Analyze market size, trends, and segments',
+        icon: 'TrendingUp',
+        category: 'analysis',
+    },
+    'competitor-analysis': {
+        id: 'competitor-analysis',
+        label: 'Competitor Analysis',
+        description: 'Map competitive landscape',
+        icon: 'Swords',
+        category: 'analysis',
+    },
+    'financial-model': {
+        id: 'financial-model',
+        label: 'Financial Model',
+        description: 'Build revenue and cost projections',
+        icon: 'DollarSign',
+        category: 'analysis',
+    },
+    'pitch-outline': {
+        id: 'pitch-outline',
+        label: 'Pitch Outline',
+        description: 'Structure an investor pitch',
+        icon: 'Rocket',
+        category: 'planning',
+    },
+    'business-review': {
+        id: 'business-review',
+        label: 'Business Review',
+        description: 'Validate the business plan',
+        icon: 'ShieldCheck',
+        category: 'analysis',
+    },
     // ── Content & Marketing Skills ───────────────────────────────────────────
-    'brand-setup': { id: 'brand-setup', label: 'Brand Setup', description: 'Define brand identity, voice, and visual guidelines', icon: 'Palette', category: 'planning' },
-    'content-strategy': { id: 'content-strategy', label: 'Content Strategy', description: 'Define content pillars and cadence', icon: 'Target', category: 'planning' },
-    'content-calendar': { id: 'content-calendar', label: 'Content Calendar', description: 'Plan content for a period', icon: 'Calendar', category: 'planning' },
-    'create-content': { id: 'create-content', label: 'Create Content', description: 'Write copy and visual brief', icon: 'PenTool', category: 'development' },
-    'content-review': { id: 'content-review', label: 'Content Review', description: 'Review for brand consistency', icon: 'CheckCircle', category: 'analysis' },
+    'brand-setup': {
+        id: 'brand-setup',
+        label: 'Brand Setup',
+        description: 'Define brand identity, voice, and visual guidelines',
+        icon: 'Palette',
+        category: 'planning',
+    },
+    'content-strategy': {
+        id: 'content-strategy',
+        label: 'Content Strategy',
+        description: 'Define content pillars and cadence',
+        icon: 'Target',
+        category: 'planning',
+    },
+    'content-calendar': {
+        id: 'content-calendar',
+        label: 'Content Calendar',
+        description: 'Plan content for a period',
+        icon: 'Calendar',
+        category: 'planning',
+    },
+    'create-content': {
+        id: 'create-content',
+        label: 'Create Content',
+        description: 'Write copy and visual brief',
+        icon: 'PenTool',
+        category: 'development',
+    },
+    'content-review': {
+        id: 'content-review',
+        label: 'Content Review',
+        description: 'Review for brand consistency',
+        icon: 'CheckCircle',
+        category: 'analysis',
+    },
     // ── Course / Training Skills ─────────────────────────────────────────────
-    'curriculum-design': { id: 'curriculum-design', label: 'Curriculum', description: 'Define modules and learning objectives', icon: 'School', category: 'planning' },
-    'lesson-plan': { id: 'lesson-plan', label: 'Lesson Plan', description: 'Break modules into lessons', icon: 'BookOpen', category: 'planning' },
-    'assessment-design': { id: 'assessment-design', label: 'Assessment', description: 'Create quizzes and exercises', icon: 'ClipboardCheck', category: 'planning' },
-    'course-review': { id: 'course-review', label: 'Course Review', description: 'Pedagogical quality check', icon: 'CheckCircle', category: 'analysis' },
+    'curriculum-design': {
+        id: 'curriculum-design',
+        label: 'Curriculum',
+        description: 'Define modules and learning objectives',
+        icon: 'School',
+        category: 'planning',
+    },
+    'lesson-plan': {
+        id: 'lesson-plan',
+        label: 'Lesson Plan',
+        description: 'Break modules into lessons',
+        icon: 'BookOpen',
+        category: 'planning',
+    },
+    'assessment-design': {
+        id: 'assessment-design',
+        label: 'Assessment',
+        description: 'Create quizzes and exercises',
+        icon: 'ClipboardCheck',
+        category: 'planning',
+    },
+    'course-review': {
+        id: 'course-review',
+        label: 'Course Review',
+        description: 'Pedagogical quality check',
+        icon: 'CheckCircle',
+        category: 'analysis',
+    },
     // ── Book Skills ──────────────────────────────────────────────────────────
-    'book-outline': { id: 'book-outline', label: 'Book Outline', description: 'Define structure, beats, and chapters', icon: 'BookOpen', category: 'planning' },
-    'character-design': { id: 'character-design', label: 'Characters', description: 'Build character profiles and relationships', icon: 'Users', category: 'planning' },
-    'plot-threads': { id: 'plot-threads', label: 'Plot Threads', description: 'Define and track narrative threads', icon: 'GitBranch', category: 'planning' },
-    'scene-breakdown': { id: 'scene-breakdown', label: 'Scenes', description: 'Break chapters into scenes', icon: 'Layers', category: 'development' },
-    'book-review': { id: 'book-review', label: 'Book Review', description: 'Structural review of the book', icon: 'CheckCircle', category: 'analysis' },
+    'book-outline': {
+        id: 'book-outline',
+        label: 'Book Outline',
+        description: 'Define structure, beats, and chapters',
+        icon: 'BookOpen',
+        category: 'planning',
+    },
+    'character-design': {
+        id: 'character-design',
+        label: 'Characters',
+        description: 'Build character profiles and relationships',
+        icon: 'Users',
+        category: 'planning',
+    },
+    'plot-threads': {
+        id: 'plot-threads',
+        label: 'Plot Threads',
+        description: 'Define and track narrative threads',
+        icon: 'GitBranch',
+        category: 'planning',
+    },
+    'scene-breakdown': {
+        id: 'scene-breakdown',
+        label: 'Scenes',
+        description: 'Break chapters into scenes',
+        icon: 'Layers',
+        category: 'development',
+    },
+    'book-review': {
+        id: 'book-review',
+        label: 'Book Review',
+        description: 'Structural review of the book',
+        icon: 'CheckCircle',
+        category: 'analysis',
+    },
     // ── Builtin Skills (agents library) ──────────────────────────────────────
     'code-review': {
         id: 'code-review',

package/dist/system-prompt/modules.js

@@ -216,7 +216,7 @@ Key categories:
 - **Git**: git_status, git_diff, git_log, git_commit, git_branch
 - **Project Management**: project_get, project_list, project_create, project_update
 - **Work Items**: workitem_query, workitem_add, workitem_update, workitem_next
-- **Documents**: project_document_add, project_document_get, project_document_list
+- **Documents**: project_document_add, project_document_get, project_document_list, project_document_patch
 - **Planning**: plan_create, plan_get, plan_list
 - **Runners**: run_tests, run_lint
 - **Anchors**: anchor_add, anchor_list, anchor_remove
@@ -225,7 +225,10 @@ Key categories:
 
 Project documents (drafts, outlines, analyses, plans) are stored in the **database**, not the filesystem.
 - **Read**: \`project_document_get({ doc_type: "outline" })\` or \`project_document_list()\`
-- **Write**: \`project_document_add({ doc_type: "outline", title: "...", content: "..." })\`
+- **Write (new)**: \`project_document_add({ doc_type: "outline", title: "...", content: "..." })\`
+- **Patch (update without reading)**: \`project_document_patch({ doc_type: "draft", operation: "append", content: "## New Section\\n..." })\`
+  - Operations: \`append\`, \`prepend\`, \`replace_section\` (with \`section_heading\`)
+  - Prefer patch over add when updating large documents — avoids reading the full content into context
 - Do NOT use write_file or edit for project documents — always use these database tools
 - **Software doc_types**: prd, architecture, design, notes, plan
 - **Research doc_types**: outline, literature-review, abstract, methodology, bibliography

package/dist/team/tool-config.js

@@ -77,6 +77,7 @@ const TOOL_NAMES = {
     PROJECT_DOCUMENT_GET: 'document_get',
     PROJECT_DOCUMENT_LIST: 'document_list',
     PROJECT_DOCUMENT_DELETE: 'document_delete',
+    PROJECT_DOCUMENT_PATCH: 'document_patch',
     // Plans
     PLAN_CREATE: 'plan_create',
     PLAN_UPDATE: 'plan_update',
@@ -255,6 +256,7 @@ export const TOOL_GROUPS = {
             TOOL_NAMES.PROJECT_DOCUMENT_GET,
             TOOL_NAMES.PROJECT_DOCUMENT_LIST,
             TOOL_NAMES.PROJECT_DOCUMENT_DELETE,
+            TOOL_NAMES.PROJECT_DOCUMENT_PATCH,
         ],
         readOnly: false,
         tier: 'meta',
@@ -306,13 +308,26 @@ export const TOOL_GROUPS = {
     factory_models: {
         label: 'Structured Models',
         tools: [
-            'app_model_get', 'app_model_update', 'app_model_validate',
-            'research_model_get', 'research_model_update', 'research_model_validate',
-            'bibliography_generate', 'bibtex_import',
-            'business_model_get', 'business_model_update', 'business_model_validate',
-            'brand_model_get', 'brand_model_update', 'brand_model_validate',
-            'curriculum_model_get', 'curriculum_model_update', 'curriculum_model_validate',
-            'book_model_get', 'book_model_update', 'book_model_validate',
+            'app_model_get',
+            'app_model_update',
+            'app_model_validate',
+            'research_model_get',
+            'research_model_update',
+            'research_model_validate',
+            'bibliography_generate',
+            'bibtex_import',
+            'business_model_get',
+            'business_model_update',
+            'business_model_validate',
+            'brand_model_get',
+            'brand_model_update',
+            'brand_model_validate',
+            'curriculum_model_get',
+            'curriculum_model_update',
+            'curriculum_model_validate',
+            'book_model_get',
+            'book_model_update',
+            'book_model_validate',
         ],
         readOnly: false,
         tier: 'meta',
@@ -321,8 +336,12 @@ export const TOOL_GROUPS = {
     factory_scaffold: {
         label: 'Code Scaffolding',
         tools: [
-            'factory_scaffold', 'factory_list_toolkits',
-            'research_scaffold', 'business_scaffold', 'content_scaffold', 'book_scaffold',
+            'factory_scaffold',
+            'factory_list_toolkits',
+            'research_scaffold',
+            'business_scaffold',
+            'content_scaffold',
+            'book_scaffold',
         ],
         readOnly: false,
         tier: 'meta',
@@ -390,7 +409,18 @@ export const TOOL_PROFILES = {
         'dependencies',
     ],
     // Docs - documentation + project documents
-    docs: ['file_read', 'file_write', 'interaction', 'handoff', 'guide', 'meta', 'project', 'search', 'documents', 'factory_models'],
+    docs: [
+        'file_read',
+        'file_write',
+        'interaction',
+        'handoff',
+        'guide',
+        'meta',
+        'project',
+        'search',
+        'documents',
+        'factory_models',
+    ],
     // DevOps - CI/CD tasks
     devops: [
         'file_read',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.7.13",
+  "version": "0.7.15",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -68,7 +68,7 @@
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.78.0",
-    "@compilr-dev/agents": "^0.3.27",
+    "@compilr-dev/agents": "^0.3.28",
     "@compilr-dev/agents-coding": "^1.0.2",
     "@eslint/js": "^9.39.1",
     "@opentelemetry/api": "^1.9.0",