@compilr-dev/sdk 0.5.6 → 0.5.7

package/dist/index.d.ts

@@ -61,7 +61,7 @@ export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskU
 export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, ProjectAnchorStore, } from './platform/index.js';
 export type { ProjectAnchorStoreConfig } from './platform/index.js';
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, } from './skills/index.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, } from './skills/index.js';
 export { ACTION_REGISTRY, getActionsForContext, getActionById, resolveActionPrompt, buildContextSummary, getSuggestedRole, } from './actions/index.js';
 export type { ActionContext, ActionDefinition } from './actions/index.js';
 export { PROJECT_TYPES, getProjectTypeConfig, getProjectTypesByCategory, generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, } from './project-types/index.js';

package/dist/index.js

@@ -139,7 +139,7 @@ export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getSt
 // =============================================================================
 // Platform Skills (platform-specific prompt expansions)
 // =============================================================================
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, } from './skills/index.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, } from './skills/index.js';
 // =============================================================================
 // Contextual Actions (skill invocations with context)
 // =============================================================================

package/dist/project-types/configs.js

@@ -154,8 +154,8 @@ export const researchConfig = {
         { type: 'bibliography', label: 'Bibliography', description: 'References and citations' },
         { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
     ],
-    projectActions: ['outline', 'literature-review', 'session-notes'],
-    workItemActions: ['explain'],
+    projectActions: ['outline', 'literature-review', 'draft-section', 'session-notes'],
+    workItemActions: ['draft-section', 'explain'],
     workItemLabels: {
         feature: { short: 'SC', full: 'Section' },
         bug: { short: 'RV', full: 'Revision' },

package/dist/skills/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Platform Skills — barrel export
  */
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, } from './platform-skills.js';

package/dist/skills/index.js

@@ -1,4 +1,4 @@
 /**
  * Platform Skills — barrel export
  */
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, } from './platform-skills.js';

package/dist/skills/platform-skills.d.ts

@@ -19,6 +19,7 @@ export declare const buildSkill: Skill;
 export declare const scaffoldSkill: Skill;
 export declare const outlineSkill: Skill;
 export declare const literatureReviewSkill: Skill;
+export declare const draftSectionSkill: Skill;
 /**
  * All platform-specific skills (11 total).
  * These skills reference platform tools (backlog, workitems, documents, projects)

package/dist/skills/platform-skills.js

@@ -1094,6 +1094,118 @@ If multiple sources have been analyzed, provide a thematic synthesis:
 ✓ User has reviewed the source-claim mappings`,
     tags: ['research', 'analysis', 'sources'],
 });
+export const draftSectionSkill = defineSkill({
+    name: 'draft-section',
+    description: 'Draft a paper section using the outline, claims, and linked sources',
+    prompt: `You are in DRAFT SECTION MODE. Your goal is to write or revise a section of the research paper, guided by the Research Model's outline, claims, and linked sources.
+
+## When to Use
+- A section has status "outlined" and needs its first draft
+- A section needs revision based on reviewer feedback
+- The user wants to expand a section with more detail
+
+## Step 1: Select the Section
+
+1. Use \`research_model_get\` with scope: "sections" to see all sections and their status
+2. If the user didn't specify which section, suggest the next logical one:
+   - Methodology first (grounds the paper)
+   - Literature Review (needed early)
+   - Results / Findings (core content)
+   - Discussion (interpretation)
+   - Introduction and Conclusion last (summaries)
+3. Confirm the section choice with the user
+
+## Step 2: Gather Section Context
+
+For the chosen section:
+1. Use \`research_model_get\` with sectionId to get the section's purpose, claims, and notes
+2. Read any existing draft file (if the section has been drafted before)
+3. For each claim with linked sources, read the source content from KB to understand the evidence
+4. Check the citation style from the model: \`research_model_get\` with scope: "overview"
+
+Summarize to the user:
+- "Section: {title}"
+- "Purpose: {purpose}"
+- "Claims to address: {list}"
+- "Sources available: {list with citeKeys}"
+
+## Step 3: Draft the Section
+
+Write the section following these guidelines:
+
+**Structure:**
+- Start with a topic sentence that states the section's purpose
+- Address each claim in the section in a logical order
+- Use transitions between paragraphs
+- End with a connection to the next section (or summary for final sections)
+
+**Citations:**
+- Use the project's citation style for in-text citations
+- APA: (Author, Year) or Author (Year)
+- MLA: (Author Page) or Author (Page)
+- IEEE: [citeKey] or [N]
+- Chicago: (Author Year) or Author (Year)
+- Harvard: (Author Year) or Author (Year)
+- Cite sources for every non-original claim
+- When multiple sources support a claim, cite them together
+
+**Academic Tone:**
+- Formal but clear — avoid jargon without definition
+- Use hedging language where appropriate ("suggests", "indicates", "appears to")
+- Distinguish between established facts and interpretations
+- Use active voice for the author's contributions, passive for general findings
+
+**Length:**
+- Respect the section's targetWordCount if set
+- If not set, aim for appropriate length based on scope:
+  - Journal article section: 500-1500 words
+  - Thesis chapter: 2000-5000 words
+  - Literature review section: 800-2000 words
+
+## Step 4: Write the File
+
+1. Determine the file path: \`{project_path}/sections/{section_order}-{section_slug}.md\`
+   - e.g., \`sections/01-introduction.md\`, \`sections/03-methodology.md\`
+2. Write the draft using \`write_file\` or \`edit_file\` (if revising)
+3. Include a header comment: \`<!-- Section: {title} | Status: drafted | Rev: {model revision} -->\`
+
+## Step 5: Update the Model
+
+After writing:
+1. Update section status: \`research_model_update\` with op: "section_update", sectionId, updates: { status: "drafted", actualWordCount: N }
+2. If new claims emerged during writing, add them: \`research_model_update\` with op: "claim_add"
+3. If evidence strength changed based on closer reading, update claims
+
+## Step 6: Generate Bibliography (if needed)
+
+If this is the first section being drafted or the user requests it:
+1. Use \`bibliography_generate\` with format: "markdown" to produce the references list
+2. Write it to \`{project_path}/sections/references.md\`
+
+## Step 7: Summary
+
+Report to the user:
+- Section drafted: title, word count, file path
+- Claims addressed: list with evidence strength
+- Citations used: list of citeKeys
+- Suggestions: any gaps noticed, claims that need more support
+
+## Rules
+- NEVER fabricate citations — only cite sources that exist in the Research Model
+- If a claim lacks source support, note it explicitly rather than inventing a reference
+- Maintain consistency with previously drafted sections (terminology, tense, voice)
+- If the section has subsections in the model, draft them as ## subheadings
+- Read existing drafted sections first to maintain consistent style
+- Ask the user about tone preferences if this is the first section being drafted
+
+## Completion Criteria
+✓ Section file written with proper citations
+✓ Model updated (status: drafted, actualWordCount)
+✓ All claims in the section are addressed in the text
+✓ In-text citations match the project's citation style
+✓ User has reviewed the draft`,
+    tags: ['research', 'writing', 'drafting'],
+});
 // =============================================================================
 // Aggregate export
 // =============================================================================
@@ -1114,4 +1226,5 @@ export const platformSkills = [
     scaffoldSkill,
     outlineSkill,
     literatureReviewSkill,
+    draftSectionSkill,
 ];

package/package.json

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