@compilr-dev/sdk 0.5.5 → 0.5.6

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, } from './skills/index.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, } 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, } from './skills/index.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, } from './skills/index.js';
 // =============================================================================
 // Contextual Actions (skill invocations with context)
 // =============================================================================

package/dist/project-types/configs.js

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

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, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, } 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, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, } from './platform-skills.js';

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

@@ -18,8 +18,9 @@ export declare const sessionNotesSkill: Skill;
 export declare const buildSkill: Skill;
 export declare const scaffoldSkill: Skill;
 export declare const outlineSkill: Skill;
+export declare const literatureReviewSkill: Skill;
 /**
- * All platform-specific skills (10 total).
+ * All platform-specific skills (11 total).
  * These skills reference platform tools (backlog, workitems, documents, projects)
  * and belong in the SDK rather than in generic agent/coding libraries.
  */

package/dist/skills/platform-skills.js

@@ -990,11 +990,115 @@ Create one work item per section:
 ✓ User has reviewed and approved the outline`,
     tags: ['research', 'planning', 'outline'],
 });
+export const literatureReviewSkill = defineSkill({
+    name: 'literature-review',
+    description: 'Analyze sources from the Knowledge Base — extract findings, link to claims, identify gaps',
+    prompt: `You are in LITERATURE REVIEW MODE. Your goal is to systematically analyze the sources in the Knowledge Base and connect them to the Research Model's sections and claims.
+
+## When to Use
+- Sources have been added to the Knowledge Base but not yet analyzed
+- The Research Model has sections/claims that need source support
+- User wants to understand how sources relate to their argument
+- User wants to identify gaps in their source coverage
+
+## Prerequisites
+- A Research Model should exist (run /outline first if not)
+- Sources should be in the Knowledge Base (upload PDFs, paste text, or import URLs)
+
+## Step 1: Assess Current State
+
+1. Use \`research_model_get\` with scope: "overview" to see the current model
+2. Use \`research_model_get\` with scope: "sources" to see which sources are already registered and analyzed
+3. Review the Knowledge Base content (pinned items are in context; read non-pinned files as needed)
+
+Report to the user:
+- "You have X sources in the model, Y analyzed, Z unanalyzed"
+- "The Knowledge Base has N files available"
+- "X claims currently lack source support"
+
+## Step 2: Register New Sources
+
+For each KB document not yet in the Research Model:
+1. Read the document content (use \`read_file\` if not pinned)
+2. Extract citation information: authors, title, year, venue, type
+3. Register it: \`research_model_update\` with op: "source_add", source: { citeKey, citation: { type, title, authors, year, venue } }
+4. Note: generate a short, memorable citeKey (e.g., "smith2024", "jones-ml-2023")
+
+Ask the user to confirm the extracted citation info for each source, or batch-confirm if there are many.
+
+## Step 3: Analyze Each Source
+
+For each unanalyzed source:
+1. Read the full content from the KB
+2. Extract key findings relevant to the paper's research questions
+3. Identify the source's methodology and limitations
+4. Determine relevance: primary (directly addresses research questions), secondary (provides context), or background (general knowledge)
+5. Update the source: \`research_model_update\` with op: "source_update", sourceId: "...", updates: { keyFindings: [...], relevance: "primary|secondary|background", analyzed: true, tags: [...] }
+
+Present a summary of each source's key findings to the user.
+
+## Step 4: Link Sources to Claims
+
+For each section in the model:
+1. Read the section's existing claims (\`research_model_get\` with sectionId)
+2. For each claim, identify which analyzed sources support or contradict it
+3. Link them: \`research_model_update\` with op: "claim_link_source", sectionId, claimId, sourceRef: { sourceId, relevance: "brief note" }, relation: "supporting" or "contradicting"
+4. Update evidence strength based on the linked sources:
+   - strong: multiple supporting sources, no contradictions
+   - moderate: at least one supporting source
+   - weak: tangential support only
+   - contested: sources disagree
+   - unsupported: no sources linked
+
+If a source suggests a claim that doesn't exist yet, propose adding it:
+- \`research_model_update\` with op: "claim_add", sectionId, claim: { statement, type: "derived" }
+
+## Step 5: Identify Gaps
+
+After linking sources to claims, analyze gaps:
+1. Run \`research_model_validate\` to get warnings
+2. Report:
+   - **Unsupported claims** — claims with no source references (need more sources or should be marked as original analysis)
+   - **Orphan sources** — sources not linked to any claim (may not be relevant, or claims are missing)
+   - **Thin sections** — sections with few claims or few sources
+   - **Missing perspectives** — if all sources agree, note the lack of counter-arguments
+
+Suggest next steps:
+- "Section X needs more sources on [topic] — consider searching for..."
+- "Source Y has findings relevant to Section Z but no claim captures this yet"
+- "The paper lacks counter-arguments on [claim] — consider adding a limitations discussion"
+
+## Step 6: Synthesize Themes
+
+If multiple sources have been analyzed, provide a thematic synthesis:
+- Group sources by the themes they address
+- Note where sources agree, where they disagree, and what's novel
+- Map themes to research questions
+- Suggest how themes should be organized in the Literature Review section
+
+## Rules
+- Analyze sources ONE AT A TIME — don't rush through multiple sources
+- Ask the user to confirm citation info before saving (batch OK for many sources)
+- Always distinguish between the source's claims and the user's interpretation
+- Note methodological differences between sources when relevant
+- Use citeKeys consistently when referencing sources
+- If a source is irrelevant to the research, say so — not every KB file needs to be in the model
+- Keep evidence strength assessments conservative — "moderate" is better than over-claiming "strong"
+
+## Completion Criteria
+✓ All relevant KB sources are registered in the model
+✓ Each source has been analyzed (keyFindings, relevance, tags)
+✓ Sources are linked to relevant claims
+✓ Evidence strength updated for linked claims
+✓ Gaps identified and reported
+✓ User has reviewed the source-claim mappings`,
+    tags: ['research', 'analysis', 'sources'],
+});
 // =============================================================================
 // Aggregate export
 // =============================================================================
 /**
- * All platform-specific skills (10 total).
+ * All platform-specific skills (11 total).
  * These skills reference platform tools (backlog, workitems, documents, projects)
  * and belong in the SDK rather than in generic agent/coding libraries.
  */
@@ -1009,4 +1113,5 @@ export const platformSkills = [
     buildSkill,
     scaffoldSkill,
     outlineSkill,
+    literatureReviewSkill,
 ];

package/package.json

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