@chenguangyao/devflow-kit 0.1.43 → 0.1.44

package/schemas/workflow-confirmation-surface.schema.json

@@ -31,10 +31,12 @@
   "definitions": {
     "actionMap": {
       "type": "object",
-      "required": ["picker", "applySelection", "check", "confirm"],
+      "required": ["picker", "applySelection", "applySelectionFile", "card", "check", "confirm"],
       "properties": {
         "picker": { "type": "string" },
         "applySelection": { "type": "string" },
+        "applySelectionFile": { "type": "string" },
+        "card": { "type": "string" },
         "check": { "type": "string" },
         "confirm": { "type": "string" }
       },

package/schemas/workflow-picker.schema.json

@@ -56,6 +56,8 @@
         "locked",
         "source",
         "status",
+        "after",
+        "before",
         "installed",
         "command"
       ],
@@ -73,6 +75,8 @@
         "locked": { "type": "boolean" },
         "source": { "type": ["string", "null"] },
         "status": { "type": ["string", "null"] },
+        "after": { "type": ["string", "null"] },
+        "before": { "type": ["string", "null"] },
         "installed": { "type": "boolean" },
         "command": { "type": ["string", "null"] }
       },
@@ -80,11 +84,12 @@
     },
     "actionMap": {
       "type": "object",
-      "required": ["card", "check", "applySelection", "confirm", "suggest"],
+      "required": ["card", "check", "applySelection", "applySelectionFile", "confirm", "suggest"],
       "properties": {
         "card": { "type": "string" },
         "check": { "type": "string" },
         "applySelection": { "type": "string" },
+        "applySelectionFile": { "type": "string" },
         "confirm": { "type": "string" },
         "suggest": { "type": "string" }
       },

package/schemas/workflow-selection-result.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://devflow.dev/schemas/workflow-selection-result.schema.json",
+  "title": "devflow workflow selection result surface",
+  "description": "Machine-readable successful response returned by devflow flow apply-selection --json.",
+  "type": "object",
+  "required": [
+    "type",
+    "slug",
+    "ok",
+    "added",
+    "disabled",
+    "skipped",
+    "diff",
+    "actions",
+    "nextAction"
+  ],
+  "properties": {
+    "type": { "const": "workflow_selection_result_surface" },
+    "slug": { "type": "string" },
+    "ok": { "const": true },
+    "added": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "disabled": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "skipped": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["step", "reason"],
+        "properties": {
+          "step": { "type": ["string", "null"] },
+          "reason": { "type": "string" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "diff": {
+      "type": "object",
+      "required": ["added", "disabled", "moved", "verifyReports"],
+      "properties": {
+        "added": { "type": "array", "items": { "type": "string" } },
+        "disabled": { "type": "array", "items": { "type": "string" } },
+        "moved": { "type": "array", "items": { "type": "string" } },
+        "verifyReports": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": true
+    },
+    "actions": {
+      "type": "object",
+      "required": ["picker", "applySelection", "applySelectionFile", "card", "check", "confirm"],
+      "properties": {
+        "picker": { "type": "string" },
+        "applySelection": { "type": "string" },
+        "applySelectionFile": { "type": "string" },
+        "card": { "type": "string" },
+        "check": { "type": "string" },
+        "confirm": { "type": "string" }
+      },
+      "additionalProperties": true
+    },
+    "nextAction": { "type": "string" }
+  },
+  "additionalProperties": true
+}

package/schemas/workflow-selection.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://devflow.dev/schemas/workflow-selection.schema.json",
+  "title": "devflow workflow selection input",
+  "description": "Input accepted by devflow flow apply-selection --selection=<json>. UI may send a minimal items list or the edited workflow picker surface.",
+  "oneOf": [
+    { "$ref": "#/definitions/selection", "title": "Minimal workflow selection" },
+    { "$ref": "#/definitions/pickerSurface", "title": "Edited workflow picker surface" },
+    { "$ref": "#/definitions/chatSelection", "title": "Edited workflow chat selection" }
+  ],
+  "definitions": {
+    "selection": {
+      "type": "object",
+      "required": ["items"],
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/item" }
+        }
+      },
+      "additionalProperties": true
+    },
+    "pickerSurface": {
+      "type": "object",
+      "required": ["type", "groups"],
+      "properties": {
+        "type": { "const": "workflow_picker_surface" },
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["items"],
+            "properties": {
+              "items": {
+                "type": "array",
+                "items": { "$ref": "#/definitions/item" }
+              }
+            },
+            "additionalProperties": true
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "chatSelection": {
+      "type": "object",
+      "required": ["type", "groups"],
+      "properties": {
+        "type": { "const": "workflow_chat_selection" },
+        "layout": { "const": "linear-checkboxes" },
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["items"],
+            "properties": {
+              "id": { "type": "string" },
+              "label": { "type": "string" },
+              "items": {
+                "type": "array",
+                "items": { "$ref": "#/definitions/item" }
+              }
+            },
+            "additionalProperties": true
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "item": {
+      "type": "object",
+      "required": ["step", "selected"],
+      "properties": {
+        "step": { "type": "string" },
+        "skill": { "type": "string" },
+        "selected": { "type": "boolean" },
+        "reason": { "type": ["string", "null"] },
+        "after": { "type": ["string", "null"] },
+        "before": { "type": ["string", "null"] }
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/schemas/workflow-ui-command-result.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://devflow.dev/schemas/workflow-ui-command-result.schema.json",
+  "title": "devflow workflow UI command result surface",
+  "description": "Stable command result surface returned by devflow local workflow UI host mutation endpoints.",
+  "type": "object",
+  "required": ["type", "schema", "ok", "slug", "output", "error"],
+  "properties": {
+    "type": {
+      "const": "workflow_ui_command_result"
+    },
+    "schema": {
+      "const": "https://devflow.dev/schemas/workflow-ui-command-result.schema.json"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "slug": {
+      "type": "string"
+    },
+    "output": {
+      "type": "string"
+    },
+    "error": {
+      "type": ["string", "null"]
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/workflow-ui-error.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://devflow.dev/schemas/workflow-ui-error.schema.json",
+  "title": "devflow workflow UI error surface",
+  "description": "Stable error surface returned by devflow local workflow UI host endpoints.",
+  "type": "object",
+  "required": ["type", "schema", "ok", "code", "message"],
+  "properties": {
+    "type": {
+      "const": "workflow_ui_error"
+    },
+    "schema": {
+      "const": "https://devflow.dev/schemas/workflow-ui-error.schema.json"
+    },
+    "ok": {
+      "const": false
+    },
+    "code": {
+      "type": "string",
+      "enum": [
+        "invalid-workflow-selection",
+        "invalid-json-body",
+        "invalid-checkpoint-resolution",
+        "request-body-too-large",
+        "route-not-found",
+        "devflow-command-failed",
+        "devflow-json-missing",
+        "workflow-ui-error"
+      ]
+    },
+    "message": {
+      "type": "string"
+    },
+    "details": {},
+    "command": {
+      "type": "string"
+    },
+    "exitCode": {
+      "type": "number"
+    },
+    "stdout": {
+      "type": "string"
+    },
+    "stderr": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": true
+}

package/scripts/render-workflow-ui-prototype.js

@@ -10,7 +10,12 @@ const childProcess = require('child_process');
 function renderWorkflowUiPrototype(options = {}) {
   const root = options.root || path.resolve(__dirname, '..');
   const fixtures = options.pickers && options.card
-    ? { pickers: options.pickers, card: options.card }
+    ? {
+      pickers: options.pickers,
+      card: options.card,
+      selectionResults: options.selectionResults || [],
+      policyCards: options.policyCards || [],
+    }
     : loadFixtureSurfaces({ root });
   const sourceLabel = options.sourceLabel || fixtures.card.slug || fixtures.card.baseRecipe?.id || 'workflow';
 
@@ -35,7 +40,9 @@ function renderWorkflowUiPrototype(options = {}) {
     `      <code>${escapeHtml(sourceLabel)} · ${escapeHtml(fixtures.card.actions.picker || fixtures.card.nextAction || '-')}</code>`,
     '    </section>',
     fixtures.pickers.map((entry) => renderPickerSurface(entry.surface, entry.title)).join('\n'),
+    (fixtures.selectionResults || []).map(renderSelectionResultSurface).join('\n'),
     renderConfirmationSurface(fixtures.card),
+    (fixtures.policyCards || []).map(renderPolicyConfirmationSurface).join('\n'),
     '  </main>',
     '</body>',
     '</html>',
@@ -50,6 +57,12 @@ function loadFixtureSurfaces({ root = path.resolve(__dirname, '..') } = {}) {
       { title: '风险推荐', surface: readJson(root, 'test/fixtures/workflow-surfaces/picker-risk-recommended.json') },
     ],
     card: readJson(root, 'test/fixtures/workflow-surfaces/confirmation-card.json'),
+    selectionResults: [
+      readJson(root, 'test/fixtures/workflow-surfaces/selection-result.json'),
+    ],
+    policyCards: [
+      readJson(root, 'test/fixtures/workflow-surfaces/policy-confirmation-card.json'),
+    ],
   };
 }
 
@@ -57,15 +70,36 @@ function loadWorkflowSurfacesFromCli({
   root = path.resolve(__dirname, '..'),
   slug,
   cwd = process.cwd(),
+  selection = null,
+  selectionFile = null,
   execFileSync = childProcess.execFileSync,
 } = {}) {
   if (!slug) throw new Error('loadWorkflowSurfacesFromCli requires slug');
   const picker = runDevflowJson(root, cwd, ['flow', 'picker', `--slug=${slug}`, '--json'], execFileSync);
+  let selectionArgs = null;
+  if (selection) {
+    selectionArgs = ['flow', 'apply-selection', `--slug=${slug}`, `--selection=${selection}`, '--json'];
+  } else if (selectionFile) {
+    selectionArgs = picker.actions?.applySelectionFile
+      ? actionToDevflowArgs(picker.actions.applySelectionFile, { '<file>': selectionFile })
+      : ['flow', 'apply-selection', `--slug=${slug}`, `--selection-file=${selectionFile}`, '--json'];
+  }
+  const selectionSurface = selectionArgs
+    ? runDevflowJson(root, cwd, selectionArgs, execFileSync)
+    : null;
   const card = runDevflowJson(root, cwd, ['flow', 'card', `--slug=${slug}`, '--json'], execFileSync);
-  return {
+  const surfaces = {
     pickers: [{ title: '当前 workflow', surface: picker }],
     card,
+    selectionResults: [],
+    policyCards: [],
   };
+  if (selectionSurface?.type === 'workflow_policy_confirmation_surface') {
+    surfaces.policyCards.push(selectionSurface);
+  } else if (selectionSurface) {
+    surfaces.selectionResults.push(selectionSurface);
+  }
+  return surfaces;
 }
 
 function runDevflowJson(root, cwd, args, execFileSync) {
@@ -77,6 +111,45 @@ function runDevflowJson(root, cwd, args, execFileSync) {
   return JSON.parse(String(out));
 }
 
+function actionToDevflowArgs(action, replacements = {}) {
+  const tokens = splitActionTokens(action).map((token) => replacePlaceholders(token, replacements));
+  if (tokens[0] !== 'devflow') {
+    throw new Error(`unsupported workflow action: ${action}`);
+  }
+  return tokens.slice(1);
+}
+
+function splitActionTokens(action) {
+  const tokens = [];
+  let token = '';
+  let quote = null;
+  for (const ch of String(action)) {
+    if (quote) {
+      if (ch === quote) quote = null;
+      else token += ch;
+    } else if (ch === '\'' || ch === '"') {
+      quote = ch;
+    } else if (/\s/.test(ch)) {
+      if (token) {
+        tokens.push(token);
+        token = '';
+      }
+    } else {
+      token += ch;
+    }
+  }
+  if (token) tokens.push(token);
+  return tokens;
+}
+
+function replacePlaceholders(value, replacements) {
+  let out = value;
+  for (const [placeholder, replacement] of Object.entries(replacements)) {
+    out = out.split(placeholder).join(replacement);
+  }
+  return out;
+}
+
 function readJson(root, rel) {
   return JSON.parse(fs.readFileSync(path.join(root, rel), 'utf8'));
 }
@@ -147,6 +220,55 @@ function renderConfirmationSurface(surface) {
   ].join('\n');
 }
 
+function renderSelectionResultSurface(surface) {
+  return [
+    '    <section class="surface result" data-surface="workflow-selection-result" aria-label="Workflow selection result">',
+    `      <div class="surface-head"><h2>选择已应用</h2><span>${escapeHtml(surface.type)} / ${surface.ok ? 'ok' : 'blocked'}</span></div>`,
+    '      <div class="result-grid">',
+    renderResultMetric('新增', surface.added),
+    renderResultMetric('禁用', surface.disabled),
+    renderResultMetric('移动', surface.diff?.moved || []),
+    renderResultMetric('验证报告', surface.diff?.verifyReports || []),
+    '      </div>',
+    '      <div class="actions">',
+    `        <button type="button">continue</button>`,
+    `        <code>${escapeHtml(surface.nextAction)}</code>`,
+    `        <code>${escapeHtml(surface.actions.picker)}</code>`,
+    '      </div>',
+    '    </section>',
+  ].join('\n');
+}
+
+function renderResultMetric(label, values = []) {
+  const text = values.length ? values.join(', ') : '-';
+  return [
+    '        <div>',
+    `          <small>${escapeHtml(label)}</small>`,
+    `          <strong>${escapeHtml(text)}</strong>`,
+    '        </div>',
+  ].join('\n');
+}
+
+function renderPolicyConfirmationSurface(surface) {
+  const card = surface.confirmationCard;
+  const secondary = (card.secondaryActions || [])[0];
+  return [
+    '    <section class="surface policy" data-surface="workflow-policy-card" aria-label="Workflow policy confirmation card">',
+    `      <div class="surface-head"><h2>${escapeHtml(card.title || '确认 workflow 风险')}</h2><span>${escapeHtml(card.type)} / ${escapeHtml(surface.checkpoint.status || '-')}</span></div>`,
+    `      <p>${escapeHtml(card.question || surface.checkpoint.summary || '')}</p>`,
+    '      <div class="risk-box">',
+    `        <strong>${escapeHtml(surface.checkpoint.summary || '-')}</strong>`,
+    `        <small>${escapeHtml(surface.checkpoint.id)} · ${escapeHtml(surface.checkpoint.phase || '-')}</small>`,
+    '      </div>',
+    '      <div class="actions">',
+    `        <button type="button">${escapeHtml(card.primaryAction.id)}</button>`,
+    `        <code>${escapeHtml(card.primaryAction.command)}</code>`,
+    secondary ? `        <code>${escapeHtml(secondary.command)}</code>` : '',
+    '      </div>',
+    '    </section>',
+  ].filter(Boolean).join('\n');
+}
+
 function renderTimelineStep(step, num) {
   const tags = [
     step.required ? 'required' : null,
@@ -188,11 +310,17 @@ function renderCss() {
     '    small { color: var(--muted); font-size: 12px; line-height: 1.35; }',
     '    li p { color: var(--warn); font-size: 12px; margin: 0; }',
     '    .command-row, .actions { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 14px; align-items: center; }',
+    '    .result { border-color: #95c9bf; background: #f5fbf9; }',
+    '    .result-grid { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 10px; }',
+    '    .result-grid div { display: grid; gap: 5px; border: 1px solid var(--line); border-radius: 8px; background: white; padding: 12px; min-height: 72px; }',
+    '    .result-grid strong { overflow-wrap: anywhere; }',
+    '    .policy { border-color: #e3b16f; background: #fffaf3; }',
+    '    .risk-box { display: grid; gap: 4px; margin-top: 12px; border: 1px solid #e3b16f; border-radius: 8px; background: white; padding: 12px; }',
     '    .timeline { display: grid; grid-template-columns: repeat(8, minmax(96px, 1fr)); gap: 8px; overflow-x: auto; padding-bottom: 4px; }',
     '    .timeline li { min-width: 96px; border: 1px solid var(--line); border-radius: 8px; padding: 10px; background: var(--panel); display: grid; gap: 5px; }',
     '    .timeline span { display: grid; place-items: center; width: 22px; height: 22px; border-radius: 999px; background: var(--accent); color: white; font-size: 12px; font-weight: 700; }',
     '    button { border: 0; border-radius: 6px; padding: 8px 12px; background: var(--accent); color: white; font-weight: 700; }',
-    '    @media (max-width: 860px) { .toolbar { align-items: start; flex-direction: column; } .groups { grid-template-columns: 1fr; } .timeline { grid-template-columns: repeat(4, minmax(96px, 1fr)); } }',
+    '    @media (max-width: 860px) { .toolbar { align-items: start; flex-direction: column; } .groups, .result-grid { grid-template-columns: 1fr; } .timeline { grid-template-columns: repeat(4, minmax(96px, 1fr)); } }',
   ].join('\n');
 }
 
@@ -234,7 +362,13 @@ if (require.main === module) {
   const args = parseArgs(process.argv.slice(2));
   const root = args.root || path.resolve(__dirname, '..');
   const surfaces = args.slug
-    ? loadWorkflowSurfacesFromCli({ root, slug: args.slug, cwd: args.cwd || process.cwd() })
+    ? loadWorkflowSurfacesFromCli({
+      root,
+      slug: args.slug,
+      cwd: args.cwd || process.cwd(),
+      selection: args.selection || null,
+      selectionFile: args.selectionFile || null,
+    })
     : loadFixtureSurfaces({ root });
   const options = {
     root,
@@ -257,6 +391,8 @@ function parseArgs(argv) {
     else if (arg.startsWith('--cwd=')) out.cwd = arg.slice('--cwd='.length);
     else if (arg.startsWith('--root=')) out.root = arg.slice('--root='.length);
     else if (arg.startsWith('--out=')) out.out = arg.slice('--out='.length);
+    else if (arg.startsWith('--selection=')) out.selection = arg.slice('--selection='.length);
+    else if (arg.startsWith('--selection-file=')) out.selectionFile = arg.slice('--selection-file='.length);
   }
   return out;
 }
@@ -265,6 +401,7 @@ module.exports = {
   renderWorkflowUiPrototype,
   loadFixtureSurfaces,
   loadWorkflowSurfacesFromCli,
+  actionToDevflowArgs,
   outputPathFor,
   writePrototype,
   parseArgs,

package/scripts/workflow-adapter-client-example.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const client = require('../src/client/workflow-adapter-client.js');
+
+function parseArgs(argv) {
+  const flags = {};
+  for (const arg of argv) {
+    if (!arg.startsWith('--')) continue;
+    const eq = arg.indexOf('=');
+    if (eq === -1) flags[arg.slice(2)] = true;
+    else flags[arg.slice(2, eq)] = arg.slice(eq + 1);
+  }
+  return flags;
+}
+
+function parseSelectedSteps(flags) {
+  const raw = flags.steps || flags.selected || '';
+  if (!raw || raw === true) return null;
+  return String(raw).split(',').map((item) => item.trim()).filter(Boolean);
+}
+
+function readSurface(flags) {
+  if (flags['surface-json']) return JSON.parse(String(flags['surface-json']));
+  const file = flags['surface-file'];
+  if (!file || file === true) throw new Error('usage: node scripts/workflow-adapter-client-example.js --surface-file=<adapter.json> [--host=<name>]');
+  return JSON.parse(fs.readFileSync(path.resolve(file), 'utf8'));
+}
+
+function readCatalog(flags) {
+  if (flags['catalog-json']) return JSON.parse(String(flags['catalog-json']));
+  const file = flags['catalog-file'];
+  if (!file || file === true) return null;
+  return JSON.parse(fs.readFileSync(path.resolve(file), 'utf8'));
+}
+
+async function main(argv = process.argv.slice(2)) {
+  const flags = parseArgs(argv);
+  const catalog = readCatalog(flags);
+  if (catalog) {
+    process.stdout.write(client.renderCatalogExample(catalog, { host: flags.host }));
+    process.stdout.write('\n');
+    return;
+  }
+
+  const surface = readSurface(flags);
+  if (flags.submit === true || flags['dry-run'] === true) {
+    const selected = parseSelectedSteps(flags) || client.collectDefaultSelectedSteps(surface);
+    const result = await client.submitSelection(surface, selected, { dryRun: flags['dry-run'] === true });
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    return;
+  }
+  process.stdout.write(client.renderHostExample(surface, { host: flags.host }));
+  process.stdout.write('\n');
+}
+
+if (require.main === module) {
+  main().catch((err) => {
+    process.stderr.write(`${err.message}\n`);
+    process.exitCode = 2;
+  });
+}
+
+module.exports = client;