intentdna 1.2.3 → 1.4.0

package/dist/schema/types.d.ts

@@ -82,6 +82,20 @@ export interface RoleDef {
     success_criteria?: string[];
     failure_modes?: string[];
 }
+/** Handoff artifact type — what kind of artifact is passed between steps */
+export type HandoffType = "file" | "directory" | "test_result" | "git_commit" | "summary" | "state";
+/** A single artifact consumed or produced by a workflow step */
+export interface HandoffArtifact {
+    type: HandoffType;
+    path?: string;
+    from?: string;
+    description: string;
+}
+/** Handoff declaration for a workflow step */
+export interface StepHandoff {
+    consumes?: HandoffArtifact[];
+    produces?: HandoffArtifact[];
+}
 /** Transition condition between workflow steps */
 export interface TransitionDef {
     from: string;
@@ -124,6 +138,7 @@ export interface WorkflowStepDef {
     prompt?: string;
     completion?: CompletionCheck[];
     checkpoints?: StepCheckpoint[];
+    handoff?: StepHandoff;
 }
 /** Top-level workflow definition */
 export interface WorkflowDef {
@@ -133,6 +148,8 @@ export interface WorkflowDef {
     transitions?: TransitionDef[];
     retry_policy?: RetryPolicy;
     max_rounds?: number;
+    produces?: HandoffArtifact[];
+    consumes?: HandoffArtifact[];
 }
 export interface EpigeneticEffect {
     gene?: string;
@@ -166,6 +183,16 @@ export interface DNAMetadata {
     gene_count: number;
     epigenetic_marker_count: number;
 }
+/** MCP server dependency declaration */
+export interface MCPServerDef {
+    description: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    timeout?: number;
+    optional?: boolean;
+}
 export interface IntentDNA {
     $schema?: string;
     version: string;
@@ -179,6 +206,7 @@ export interface IntentDNA {
     workflow?: WorkflowDef;
     workflows?: Record<string, WorkflowDef>;
     variables?: Record<string, string | VariableDef>;
+    mcp?: Record<string, MCPServerDef>;
     epigenetic: {
         markers: EpigeneticMarker[];
     };
@@ -225,6 +253,29 @@ export interface StepCheckpointIR {
     step_id: string;
     checkpoints: StepCheckpoint[];
 }
+/** Handoff chain entry — tracks what each step consumes/produces */
+export interface HandoffChainEntry {
+    step_id: string;
+    produces?: HandoffArtifact[];
+    consumes?: HandoffArtifact[];
+}
+/** Workflow-partitioned IR — isolates constraints per workflow */
+export interface WorkflowIR {
+    workflow_name: string;
+    namespace: string;
+    step_checkpoints: StepCheckpointIR[];
+    active_roles: string[];
+    handoff_chain: HandoffChainEntry[];
+}
+/** Record of artifacts completed by a step — used for cross-session resume */
+export interface CompletedArtifactEntry {
+    step_id: string;
+    artifacts: {
+        type: string;
+        path: string;
+        verified_at: string;
+    }[];
+}
 /** Runtime workflow state written to .dna/state/workflow.json */
 export interface WorkflowState {
     active: boolean;
@@ -234,6 +285,7 @@ export interface WorkflowState {
     iteration: number;
     session_id: string;
     started_at: string;
+    completed_artifacts?: CompletedArtifactEntry[];
 }
 export interface ConstraintIR {
     prompt_directives: PromptDirective[];
@@ -249,6 +301,7 @@ export interface ConstraintIR {
     role_scope?: ScopeDef;
     roles_scope_map?: RoleScopeEntry[];
     step_checkpoints?: StepCheckpointIR[];
+    workflows_ir?: WorkflowIR[];
 }
 /** A compiled workflow step with resolved metadata */
 export interface WorkflowStep {
@@ -261,6 +314,7 @@ export interface WorkflowStep {
     prompt: string | null;
     completion: CompletionCheck[] | null;
     checkpoints: StepCheckpoint[] | null;
+    handoff: StepHandoff | null;
 }
 /** A group of steps that can execute in parallel */
 export interface ParallelGroup {

package/dist/schema/validate.js

@@ -393,6 +393,35 @@ export function validateDNA(dna) {
             errors.push(...validateWorkflow(wfDef, roleNamesSet, `workflows.${wfName}`));
         }
     }
+    // Validate mcp
+    if (dna.mcp) {
+        for (const [name, server] of Object.entries(dna.mcp)) {
+            const mcpPath = `mcp.${name}`;
+            if (!server.description) {
+                errors.push({ path: `${mcpPath}.description`, message: "MCP server requires 'description'" });
+            }
+            // Must have either command or url
+            if (!server.command && !server.url) {
+                errors.push({ path: mcpPath, message: "MCP server requires either 'command' or 'url'" });
+            }
+            // Can't have both command and url
+            if (server.command && server.url) {
+                errors.push({ path: mcpPath, message: "MCP server cannot have both 'command' and 'url'" });
+            }
+            // timeout must be positive
+            if (server.timeout !== undefined && server.timeout <= 0) {
+                errors.push({ path: `${mcpPath}.timeout`, message: "timeout must be positive" });
+            }
+            // env values must be strings
+            if (server.env) {
+                for (const [envKey, envVal] of Object.entries(server.env)) {
+                    if (typeof envVal !== "string") {
+                        errors.push({ path: `${mcpPath}.env.${envKey}`, message: "env value must be a string" });
+                    }
+                }
+            }
+        }
+    }
     // Validate epigenetic markers
     for (let i = 0; i < (dna.epigenetic?.markers?.length ?? 0); i++) {
         const marker = dna.epigenetic.markers[i];

package/dist/templates/code-review-pipeline.dna.yaml

@@ -80,10 +80,22 @@ workflow:
       role: implementer
       description: Implement the feature
       prompt: "Implement task {{task_id}} according to the design document."
+      handoff:
+        produces:
+          - type: git_commit
+            description: "Implementation commit"
     - id: review
       role: reviewer
       description: Review the implementation
       prompt: "Review all changes for task {{task_id}}. Output PASS or FAIL."
+      handoff:
+        consumes:
+          - type: git_commit
+            from: implement
+            description: "Implementation to review"
+        produces:
+          - type: summary
+            description: "Review verdict (PASS/FAIL)"
   transitions:
     - from: review
       to: implement

package/dist/templates/flutter-refactoring-rescue.dna.yaml

@@ -130,13 +130,33 @@ workflows:
         role: investigator
         description: Trace the broken chain in v1 and v2, identify first breakpoint
         prompt: "Trace the call chain for '{{feature}}' in v1 ({{v1_path}}) and v2 ({{v2_path}}). Find where v2 breaks."
+        handoff:
+          produces:
+            - type: summary
+              description: "Breakpoint analysis with file paths and line numbers"
       - id: fix
         role: surgeon
         depends_on: [trace]
         description: Fix the identified breakpoint
         prompt: "Fix the breakpoint identified by investigator. Copy logic from v1, change one file only."
+        handoff:
+          consumes:
+            - type: summary
+              from: trace
+              description: "Breakpoint analysis from investigator"
+          produces:
+            - type: git_commit
+              description: "Single-file fix commit"
       - id: verify
         role: investigator
         depends_on: [fix]
         description: Verify the fix with adb
         prompt: "Run the feature on device. adb screencap + logcat. Compare with v1 behavior."
+        handoff:
+          consumes:
+            - type: git_commit
+              from: fix
+              description: "Fix commit to verify"
+          produces:
+            - type: summary
+              description: "Verification result with screenshots"

package/dist/templates/flutter-rewrite.dna.yaml

@@ -190,11 +190,27 @@ workflows:
         role: scanner
         description: "Scan v1 module in {{v1_path}}/. Output behavior doc to {{behavior_docs}}/$ARGUMENTS.md. List all user actions with call chains."
         prompt: "Scan module '$ARGUMENTS' in {{v1_path}}/. For each page, list: action → function() → return value. Output to {{behavior_docs}}/$ARGUMENTS.md. Then immediately proceed to write_tests."
+        handoff:
+          produces:
+            - type: file
+              path: "{{behavior_docs}}/$ARGUMENTS.md"
+              description: "Behavior document for module"
       - id: write_tests
         role: test_writer
         depends_on: [scan]
         description: "Read {{behavior_docs}}/$ARGUMENTS.md, write tests in {{test_path}}/$ARGUMENTS/, run baseline, commit."
         prompt: "Read {{behavior_docs}}/$ARGUMENTS.md. Write tests in {{test_path}}/$ARGUMENTS/. Test ALL layers: logic, widget, navigation. Run tests, record red/green baseline. Append baseline to behavior doc. Git commit: behavior-lock($ARGUMENTS): X tests (Y red, Z skipped)"
+        handoff:
+          consumes:
+            - type: file
+              path: "{{behavior_docs}}/$ARGUMENTS.md"
+              description: "Behavior document from scan step"
+          produces:
+            - type: directory
+              path: "{{test_path}}/$ARGUMENTS/"
+              description: "Test files for module"
+            - type: git_commit
+              description: "Behavior lock commit"
 
   rescue:
     name: Rescue
@@ -204,6 +220,13 @@ workflows:
         role: investigator
         description: "Run tests, assess current state, pick next targets."
         prompt: "Run tests in {{test_path}}/$ARGUMENTS/. Categorize all non-passing tests: 1) RED (failing) — highest priority, fix first. 2) SKIPPED-logic — state/notifier/service tests, fix second. 3) SKIPPED-widget — widget/UI/navigation tests, fix after logic is done. For the highest priority category, pick a batch of related tests. Trace: what does v1 do vs what does v2 do? Find the breakpoints. Report findings and the plan for this round."
+        handoff:
+          produces:
+            - type: summary
+              description: "Investigation findings and breakpoint analysis"
+            - type: test_result
+              path: "{{test_path}}/$ARGUMENTS/"
+              description: "Current test state assessment"
       - id: fix
         role: surgeon
         depends_on: [investigate]
@@ -212,11 +235,27 @@ workflows:
           - assert: clean_working_tree
             message: "Commit all changes before proceeding to report step"
         prompt: "Fix the identified breakpoints. Read v1 in {{v1_path}}/. Rewrite in v2 style in {{v2_path}}/. Logic tests: implement notifier/state/service code. Widget tests: copy widget from v1, change bindings (Obx→Consumer, Get.to→context.go), set up widget test infra (ProviderScope, mock providers, GoRouter) if needed. Run tests after each fix. Red→green or Skipped→green = done. Still failing = revert and re-analyze. Maximize test coverage per round. When done, commit all changes: rescue($ARGUMENTS): round N — X passed (+Y)"
+        handoff:
+          consumes:
+            - type: summary
+              from: investigate
+              description: "Investigation findings from investigate step"
+          produces:
+            - type: git_commit
+              description: "Rescue round commit"
       - id: report
         role: investigator
         depends_on: [fix]
         description: "Summarize round, guide next steps."
         prompt: "Run full test suite in {{test_path}}/$ARGUMENTS/. Report: 1) passed/skipped/failed delta vs last round. 2) List remaining skipped tests by category (logic vs widget vs platform). 3) If skipped tests remain, end with: Run /rescue $ARGUMENTS to continue. 4) If all tests pass, end with: Module $ARGUMENTS rescue complete."
+        handoff:
+          consumes:
+            - type: git_commit
+              from: fix
+              description: "Committed fix from surgeon"
+          produces:
+            - type: summary
+              description: "Round summary with test delta"
 
   core-align:
     name: Core Align

package/dist/templates/full-pipeline.dna.yaml

@@ -110,18 +110,47 @@ workflow:
       description: Read task and produce design document
       run_if: "round == 1"
       prompt: "Read task {{task_id}} from BOARD.md. Produce a design document."
+      handoff:
+        produces:
+          - type: file
+            path: "docs/tasks/{{task_id}}.md"
+            description: "Design document for task"
     - id: implement
       role: implementer
       description: Implement according to design
       prompt: "Implement task {{task_id}} following the design document."
+      handoff:
+        consumes:
+          - type: file
+            path: "docs/tasks/{{task_id}}.md"
+            description: "Design document from planner"
+        produces:
+          - type: git_commit
+            description: "Implementation commit"
     - id: test
       role: tester
       description: Run tests and fix failures
       prompt: "Run tests. Fix failures. Add missing tests for {{task_id}}."
+      handoff:
+        consumes:
+          - type: git_commit
+            from: implement
+            description: "Implementation to test"
+        produces:
+          - type: test_result
+            description: "Test results after fixes"
     - id: review
       role: reviewer
       description: Review and output verdict
       prompt: "Review changes for {{task_id}}. Output PASS or FAIL."
+      handoff:
+        consumes:
+          - type: test_result
+            from: test
+            description: "Test results to review"
+        produces:
+          - type: summary
+            description: "Review verdict (PASS/FAIL)"
   transitions:
     - from: review
       to: implement

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intentdna",
-  "version": "1.2.3",
+  "version": "1.4.0",
   "description": "Intent DNA — Declarative policy layer for AI agent behavior",
   "type": "module",
   "main": "dist/index.js",
@@ -33,6 +33,7 @@
   ],
   "files": [
     "dist",
+    ".claude-plugin",
     "README.md",
     "LICENSE"
   ],