@crewx/sdk 0.9.0-rc.41 → 0.9.0-rc.43

package/dist/paths.d.ts

@@ -3,3 +3,4 @@ export declare function resolveDefaultAgentsYaml(): {
     yamlPath: string;
     dir: string;
 };
+export declare function resolveWorkflowTemplatesPath(override?: string): string;

package/dist/wi/create.d.ts

@@ -0,0 +1,48 @@
+export type WiStatus = 'draft' | 'approved' | 'in-progress' | 'done' | 'cancelled';
+export interface WiCreateInput {
+    title: string;
+    assignee?: string;
+    body?: string;
+    board?: string;
+    source?: string;
+    depends_on?: string[];
+}
+export interface WiBatchCreateInput {
+    board: string;
+    source?: string;
+    items: Array<{
+        key?: string;
+        title: string;
+        assignee?: string;
+        depends_on?: string[];
+        body: string;
+    }>;
+}
+export interface WiCreatedSummary {
+    wi_id: string;
+    title: string;
+    status: WiStatus;
+    priority?: string;
+    assignee?: string;
+    depends_on: string[];
+    blocks: string[];
+    date?: string;
+    board?: string;
+    source: string;
+    screens: string[];
+    path: string;
+    mtime: number;
+}
+export interface WiCreatedDetail {
+    summary: WiCreatedSummary;
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export interface WiBatchCreateResult {
+    created: WiCreatedDetail[];
+}
+export declare class WiCreateError extends Error {
+    constructor(message: string);
+}
+export declare function createWorkInstruction(workspacePath: string, input: WiCreateInput): Promise<WiCreatedDetail>;
+export declare function createWorkInstructionBatch(workspacePath: string, input: WiBatchCreateInput): Promise<WiBatchCreateResult>;

package/dist/wi/select.d.ts

@@ -0,0 +1,20 @@
+export type WiSelectableStatus = 'draft' | 'approved' | 'in-progress' | 'done' | 'cancelled';
+export interface WiSummary {
+    wi_id: string;
+    status: WiSelectableStatus;
+    depends_on?: string[];
+}
+export type SelectNextWiResult = {
+    pick: string;
+} | {
+    blocked: true;
+    reason: string;
+} | {
+    cycle: string[];
+} | {
+    done: true;
+};
+export declare function selectNextWi(wis: WiSummary[], opts: {
+    batch: string[];
+    exclude?: string[];
+}): SelectNextWiResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/sdk",
-  "version": "0.9.0-rc.41",
+  "version": "0.9.0-rc.43",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -50,6 +50,11 @@
       "import": "./dist/repository/index.js",
       "require": "./dist/repository/index.js"
     },
+    "./desktop": {
+      "types": "./dist/desktop/index.d.ts",
+      "import": "./dist/desktop/index.js",
+      "require": "./dist/desktop/index.js"
+    },
     "./package.json": "./package.json"
   },
   "browser": {
@@ -60,7 +65,9 @@
     "./dist/layout/loader.js": false,
     "./dist/esm/layout/loader.js": false,
     "./dist/repository/index.js": false,
-    "./dist/esm/repository/index.js": false
+    "./dist/esm/repository/index.js": false,
+    "./dist/desktop/index.js": false,
+    "./dist/esm/desktop/index.js": false
   },
   "files": [
     "dist",

package/templates/workflows/wi-default-flow.yaml

@@ -0,0 +1,65 @@
+# workflows/wi-default-flow.yaml
+workflows:
+  wi-default-flow:
+    metadata:
+      name: "WI Default Loop"
+      description: "Default flow for running a WI on a work board (min: human verify)"
+
+    state:
+      wi_id: ""
+      wi_content: ""
+      assignee: ""
+      execute_result: ""
+
+    nodes:
+      start_gate:
+        type: approval
+        description: "Approve before starting the WI"
+        assignee: "@crewx_pm"
+        on_approve: execute
+        on_reject: done
+        ui:
+          label: "Start"
+
+      execute:
+        type: agent_task
+        description: "Run the WI with the assigned agent"
+        agent: "{{assignee}}"
+        mode: execute
+        input: |
+          Run this WI.
+          WI ID: {{wi_id}}
+          Instruction:
+          {{wi_content}}
+          After finishing, summarize changed files, verify results, remaining issues.
+        output: execute_result
+        next: accept_gate
+        ui:
+          label: "Execute"
+
+      accept_gate:
+        type: approval
+        description: "Review and accept the WI result (human verify)"
+        assignee: "@crewx_pm"
+        on_approve: cleanup
+        on_reject: execute
+        ui:
+          label: "Review"
+
+      cleanup:
+        type: agent_task
+        description: "Mark the WI done and clean up handoff items"
+        agent: crewx
+        mode: execute
+        input: |
+          Complete WI {{wi_id}}: mark done, record memory if needed, commit,
+          report worktree/branch cleanup needs.
+        next: done
+        ui:
+          label: "Complete"
+
+      done:
+        type: end
+        description: "The WI loop is done"
+        ui:
+          label: "Done"

package/templates/workflows/wi-plan-flow.yaml

@@ -0,0 +1,140 @@
+workflows:
+  wi-plan-flow:
+    metadata:
+      name: "WI Plan Flow"
+      description: "Turn a one-line board goal into a gated batch of draft WIs."
+    timeout: 1800
+    max_iterations: 8
+    state:
+      board_id: ""
+      goal: ""
+      source: "manual"
+      research_notes: ""
+      plan_batch: {}
+      materialize_result: {}
+      plan_feedback: ""
+      cancelled_items: []
+    nodes:
+      research:
+        type: agent_task
+        agent: planner
+        mode: query
+        input: |
+          Research the board goal and constraints before planning WIs.
+
+          Board: {{board_id}}
+          Goal: {{goal}}
+          Source: {{source}}
+
+          Previously cancelled draft items that must not be suggested again:
+          {{cancelled_items}}
+        output: research_notes
+        next: draft_plan
+
+      draft_plan:
+        type: agent_task
+        agent: planner
+        mode: query
+        input: |
+          Produce JSON only. Do not create files.
+
+          Board: {{board_id}}
+          Goal: {{goal}}
+          Source: {{source}}
+          Research:
+          {{research_notes}}
+
+          Rejection feedback from the previous gate, if any:
+          {{plan_feedback}}
+
+          Avoid re-suggesting cancelled draft items:
+          {{cancelled_items}}
+
+          Give every item a short unique "key" (e.g. "c1", "c2") — WI ids do
+          not exist yet at plan time, so cross-item dependencies must
+          reference the depending-on item's "key", never a WI id.
+
+          Required JSON shape:
+          {
+            "board": "{{board_id}}",
+            "source": "{{source}}",
+            "count": 2,
+            "titles": ["..."],
+            "change_note": "required when plan_feedback is non-empty",
+            "alternatives": ["..."],
+            "items": [
+              { "key": "c1", "title": "...", "assignee": "developer", "depends_on": [], "body": "..." },
+              { "key": "c2", "title": "...", "assignee": "developer", "depends_on": ["c1"], "body": "..." }
+            ]
+          }
+        output: plan_batch
+        output_format: json
+        output_schema:
+          type: object
+          required: [board, count, titles, alternatives, items]
+          properties:
+            board:
+              type: string
+            source:
+              type: string
+            count:
+              type: number
+            titles:
+              type: array
+              items:
+                type: string
+            change_note:
+              type: string
+            alternatives:
+              type: array
+              minItems: 1
+              items:
+                type: string
+            items:
+              type: array
+              minItems: 1
+              items:
+                type: object
+                required: [key, title, body]
+                properties:
+                  key:
+                    type: string
+                    description: "Short unique local id (e.g. c1). Referenced by other items' depends_on — not a WI id."
+                  title:
+                    type: string
+                  assignee:
+                    type: string
+                  depends_on:
+                    type: array
+                    items:
+                      type: string
+                    description: "References to other items' key, not WI ids."
+                  body:
+                    type: string
+        next: plan_gate
+
+      plan_gate:
+        type: approval
+        description: |
+          Review the draft WI batch.
+
+          Count/titles/change note preview:
+          {{plan_batch}}
+
+          Approve to create draft WI files. Reject with a reason to revise the plan.
+        assignee: "@crewx_pm"
+        on_approve: materialize
+        on_reject: draft_plan
+
+      materialize:
+        type: skill_task
+        skill: wi
+        args: ["create-batch"]
+        stdin: "{{plan_batch}}"
+        output: materialize_result
+        output_format: json
+        next: done
+
+      done:
+        type: end
+        description: "Draft WI batch materialized."