dsh-workflow-map 0.0.0-stage → 0.3.2

package/src/client/StepDetail.js

@@ -0,0 +1,250 @@
+/**
+ * StepDetail.js - "what did this step deliver": the PAE step report plus the step's own statistics,
+ * inline under the selected step card (and a one-line summary in the column header).
+ *
+ * Two sources, deliberately kept apart:
+ * report plan.stepReports[stepIndex] — summary / artifacts / exit_code / status. PAE
+ * rewrites this after every step; a step that has not reported yet says so.
+ * stats the step's own nodes (tool count, distinct files, first/last clock) — the
+ * counts come from the nodes the host actually sent, and when the host's
+ * 300-node cap bit, the block says how many nodes it could not count.
+ *
+ * There is NO "blank" state: a step without a report renders "no report for this step yet".
+ *
+ * Pure: `h` and `say` are injected. The open/closed state is a plain number (the step whose
+ * detail the user closed) so it survives re-renders without React state in the renderer.
+ *
+ * Inlined into client.js by tools/build-client.mjs (single-file browser half).
+ */
+
+/** Host/PAE report vocabulary → the panel's status chip. */
+var WF_REPORT_STATUS = new Map([
+  ["success", "done"],
+  ["succeeded", "done"],
+  ["completed", "done"],
+  ["done", "done"],
+  ["failed", "failed"],
+  ["failure", "failed"],
+  ["error", "failed"],
+  ["skipped", "skipped"],
+  ["pending", "pending"],
+  ["running", "running"],
+]);
+
+function wfReportStatusKey(report) {
+  var raw = report && typeof report.status === "string" ? report.status.trim().toLowerCase() : "";
+  var status = WF_REPORT_STATUS.get(raw) || "pending";
+  return status === "failed"
+    ? "panel.status.failed"
+    : status === "done"
+      ? "panel.status.done"
+      : status === "skipped"
+        ? "panel.status.skipped"
+        : status === "running"
+          ? "panel.status.running"
+          : "panel.status.pending";
+}
+
+/**
+ * The detail for a step index is OPEN by default. `closed` remembers the one step whose
+ * detail the user folded away (the "i" button / Escape), so selecting another step opens
+ * that step's detail without resurrecting the folded one.
+ */
+function wfStepDetailOpen(closed, stepIndex) {
+  var closedIndex = wfFinite(closed);
+  var index = wfFinite(stepIndex);
+  if (closedIndex === null || index === null) return true;
+  return Math.round(closedIndex) !== Math.round(index);
+}
+
+/** "i" on the selected step: open ↔ closed. */
+function wfStepDetailToggle(closed, stepIndex) {
+  return wfStepDetailOpen(closed, stepIndex) ? Math.round(stepIndex) : null;
+}
+
+/** "i" on another step: select it and open its detail. */
+function wfStepDetailOpenFor(stepIndex) {
+  return { selectedStep: Math.round(stepIndex), closedStep: null };
+}
+
+/** The one-line summary pinned in the left column's header. */
+function wfRenderStepHead(h, detail, say) {
+  if (!detail) return null;
+  return h(
+    "span",
+    { className: "wf-col-sub wf-step-head", key: "step-head", "data-step-index": detail.index },
+    say("panel.step.head", {
+      n: detail.index + 1,
+      tools: detail.tools,
+      files: detail.files,
+    })
+  );
+}
+
+/**
+ * The block under the selected card. `detail` is built by store.js wfBuildStepDetail:
+ * {index, planIndex, title, status, statusKey, tools, files, nodes, truncated,
+ * startedAt, endedAt, report|null}.
+ */
+function wfRenderStepDetail(h, detail, say, actions, ctx) {
+  if (!detail || wfFinite(detail.index) === null) return null;
+  var fire = actions || {};
+  var report = detail.report && typeof detail.report === "object" ? detail.report : null;
+  var artifacts = report && Array.isArray(report.artifacts) ? report.artifacts : [];
+  var startedAt = wfFinite(detail.startedAt);
+  var endedAt = wfFinite(detail.endedAt);
+  var startClock = wfFormatClock(startedAt);
+  var endClock = wfFormatClock(endedAt);
+  var duration = startedAt !== null && startedAt > 0 && endedAt !== null && endedAt > startedAt ? endedAt - startedAt : null;
+  var exitCode = report && wfFinite(report.exitCode) !== null ? Math.round(report.exitCode) : null;
+
+  var head = h(
+    "div",
+    { className: "wf-step-detail-head", key: "head" },
+    h("span", { className: "wf-step-detail-title", key: "title" }, say("panel.step.detailtitle", { n: detail.index + 1 })),
+    h(
+      "span",
+      { className: "wf-step-detail-state", key: "status", "data-status": detail.status },
+      say(detail.statusKey || "panel.status.pending")
+    ),
+    h(
+      "button",
+      {
+        type: "button",
+        className: "wf-detail-close",
+        key: "close",
+        "data-wf-step-close": detail.index,
+        title: say("panel.step.detailclose"),
+        "aria-label": say("panel.step.detailclose"),
+        onClick: function () {
+          if (typeof fire.onCloseStepDetail === "function") fire.onCloseStepDetail(detail.index);
+        },
+      },
+      "×"
+    )
+  );
+
+  var reportChildren = [
+    h(
+      "div",
+      { className: "wf-detail-block-head", key: "head" },
+      h("span", { className: "wf-detail-label", key: "label" }, say("panel.step.report")),
+      report
+        ? h("span", { className: "wf-detail-chip", key: "state", "data-state": report.status }, say(wfReportStatusKey(report)))
+        : null
+    ),
+  ];
+
+  if (!report) {
+    reportChildren.push(h("div", { className: "wf-detail-empty", key: "empty" }, say("panel.step.noreport")));
+  } else {
+    reportChildren.push(
+      h(
+        "div",
+        { className: "wf-detail-summary-text", key: "summary" },
+        report.summary === "" ? say("panel.step.nosummary") : report.summary
+      )
+    );
+    reportChildren.push(
+      h(
+        "div",
+        { className: "wf-detail-group", key: "artifacts", "data-artifacts": artifacts.length },
+        h(
+          "span",
+          { className: "wf-detail-sublabel", key: "label" },
+          h("span", { className: "wf-detail-glyph", key: "glyph", "aria-hidden": "true" }, "▤"),
+          say("panel.step.artifacts") + " · " + artifacts.length
+        ),
+        artifacts.length === 0
+          ? h("div", { className: "wf-detail-empty", key: "none" }, say("panel.step.noartifacts"))
+          : h(
+              "div",
+              { className: "wf-detail-rows", key: "rows" },
+              artifacts.map(function (artifact, position) {
+                var split = wfDetailPath(artifact);
+                return h(
+                  "button",
+                  {
+                    type: "button",
+                    className: "wf-detail-file",
+                    key: "artifact-" + position,
+                    "data-wf-copy": split.path,
+                    "data-wf-copy-label": split.base,
+                    "data-copy-state": "idle",
+                    title: say("panel.detail.copypath") + " — " + split.path,
+                    "aria-label": say("panel.detail.copypath") + " " + split.path,
+                    onClick: function (event) {
+                      if (typeof fire.onCopy === "function") {
+                        fire.onCopy(split.path, event && event.currentTarget ? event.currentTarget : null);
+                      }
+                    },
+                  },
+                  h("span", { className: "wf-detail-base", key: "base" }, split.base),
+                  split.dir === "" ? null : h("span", { className: "wf-detail-dir", key: "dir", title: split.dir }, split.dir),
+                  h("span", { className: "wf-copy-status", key: "status", "aria-live": "polite" }, "")
+                );
+              })
+            )
+      )
+    );
+    reportChildren.push(
+      h(
+        "div",
+        { className: "wf-detail-meta", key: "exit" },
+        h("span", { key: "exit" }, say("panel.step.exit") + " " + (exitCode === null ? "—" : String(exitCode)))
+      )
+    );
+  }
+
+  var reportBlock = h(
+    "div",
+    { className: "wf-detail-block", key: "report", "data-block": "report" },
+    reportChildren
+  );
+
+  var stats = h(
+    "div",
+    { className: "wf-step-detail-stats", key: "stats", "data-truncated": detail.truncated > 0 ? "true" : "false" },
+    h("span", { key: "tools" }, say("panel.step.tools", { count: detail.tools })),
+    h("span", { key: "files" }, say("panel.step.files", { count: detail.files })),
+    h("span", { key: "nodes" }, say("panel.step.nodescount", { count: detail.nodes })),
+    detail.truncated > 0
+      ? h("span", { className: "wf-detail-note", key: "trunc" }, say("panel.step.truncatedcount", { count: detail.truncated }))
+      : null
+  );
+
+  var timing =
+    startClock === "" && endClock === ""
+      ? h("div", { className: "wf-detail-meta", key: "time", "data-time": "none" }, say("panel.step.unknowntime"))
+      : h(
+          "div",
+          { className: "wf-detail-meta", key: "time", "data-time": "known" },
+          h("span", { key: "start" }, say("panel.detail.started") + " " + (startClock || "—")),
+          h("span", { key: "end" }, say("panel.detail.ended") + " " + (endClock || "—")),
+          h(
+            "span",
+            { key: "duration" },
+            say("panel.detail.duration") + " " + (duration === null ? "—" : wfFormatDuration(duration))
+          )
+        );
+
+  return h(
+    "div",
+    {
+      className: "wf-step-detail",
+      key: "step-detail-" + detail.index,
+      id: "wf-step-detail-" + detail.index,
+      role: "region",
+      "data-dsh-workflow-map": "step-detail",
+      "data-step-index": detail.index,
+      "data-plan-index": detail.planIndex === null ? undefined : detail.planIndex,
+      "data-report": report ? "true" : "false",
+      "data-status": detail.status,
+      "aria-label": say("panel.step.detailaria", { n: detail.index + 1 }),
+    },
+    head,
+    reportBlock,
+    stats,
+    timing
+  );
+}

package/src/client/export.js

@@ -0,0 +1,280 @@
+/**
+ * export.js — the workflow snapshot (Markdown / JSON) and its two delivery
+ * paths (clipboard, Blob download).
+ *
+ * Source of truth is the SAME wire view the panel renders plus the already-derived
+ * model (statuses, selection, the active node). No second interpretation of the
+ * session is invented here: step count and node count come from model.steps /
+ * view.steps, and a node's title is exactly what NodeCard.js shows.
+ *
+ * Object URLs are kept in one module list and revoked when the panel unmounts, so a
+ * download does not leak a Blob for the lifetime of the page.
+ *
+ * Pure apart from wfSnapshotDownload (which receives every browser API through
+ * `env` in tests). Inlined into client.js by tools/build-client.mjs.
+ */
+
+var WF_SNAPSHOT_SCHEMA = "dsh-workflow-map.snapshot/v1";
+var WF_SNAPSHOT_URLS = [];
+
+function wfSnapshotMime(kind) {
+  return kind === "json" ? "application/json;charset=utf-8" : "text/markdown;charset=utf-8";
+}
+
+function wfSnapshotExtension(kind) {
+  return kind === "json" ? "json" : "md";
+}
+
+/**
+ * Session ids on this harness look like `session-f069ece7-…`. Drop that prefix,
+ * then take the first 8 alphanumerics, so the filename is `workflow-f069ece7.md`
+ * instead of the useless `workflow-session-.md` a naive slice would produce.
+ */
+function wfSnapshotTag(sessionId) {
+  var flat = typeof sessionId === "string" ? sessionId : "";
+  flat = flat.replace(/^session-/, "").replace(/[^A-Za-z0-9]/g, "");
+  if (flat === "") flat = "session";
+  return flat.slice(0, 8);
+}
+
+function wfSnapshotFileName(sessionId, kind) {
+  return "workflow-" + wfSnapshotTag(sessionId) + "." + wfSnapshotExtension(kind);
+}
+
+function wfSnapshotClock(ms) {
+  var value = wfFinite(ms);
+  if (value === null) return "—";
+  var date = new Date(value);
+  if (!isFinite(date.getTime())) return "—";
+  function pad(value2) {
+    var text = String(value2);
+    return text.length < 2 ? "0" + text : text;
+  }
+  return date.getFullYear() + "-" + pad(date.getMonth() + 1) + "-" + pad(date.getDate()) + " " +
+    pad(date.getHours()) + ":" + pad(date.getMinutes()) + ":" + pad(date.getSeconds());
+}
+
+function wfSnapshotIso(ms) {
+  var value = wfFinite(ms);
+  if (value === null) return "";
+  var date = new Date(value);
+  return isFinite(date.getTime()) ? date.toISOString() : "";
+}
+
+function wfSnapshotFlat(text) {
+  return typeof text === "string" ? text.replace(/\s+/g, " ").trim() : "";
+}
+
+/** Whitelist one wire node exactly like store.js does for the panel. */
+function wfSnapshotNode(raw, activeNodeId, say) {
+  var node = raw && typeof raw === "object" ? raw : {};
+  var category = wfNodeCategory(node);
+  var parts = wfNodeTitleParts(node, category, say);
+  var title = parts.verb === "" ? parts.target : parts.verb + " · " + parts.target;
+  var fileList = [];
+  if (Array.isArray(node.files)) {
+    for (var i = 0; i < node.files.length; i += 1) {
+      var file = node.files[i];
+      if (!file || typeof file.path !== "string" || file.path === "") continue;
+      fileList.push({ path: file.path, action: typeof file.action === "string" ? file.action : "" });
+    }
+  }
+  var errorText = typeof node.error === "string" ? wfSnapshotFlat(node.error) : "";
+  var resultHead = wfSnapshotFlat(node.resultHead);
+  var status = errorText !== "" ? "error" : wfNodeStatus(node, activeNodeId);
+  if (status === "pending" && resultHead !== "") status = "done";
+  return {
+    id: typeof node.id === "string" ? node.id : "",
+    kind: typeof node.kind === "string" ? node.kind : "other",
+    tool: typeof node.tool === "string" ? node.tool : "",
+    category: category,
+    title: title,
+    detail: wfSnapshotFlat(node.detail).slice(0, 300),
+ // The host already capped argsText at 200 chars; preserve its newlines because a
+ // command's shape is part of what the snapshot is for (the panel shows it pre-wrap).
+    argsText: typeof node.argsText === "string" ? node.argsText.slice(0, 200) : "",
+    status: status,
+    seq: wfFinite(node.seq),
+    at: wfFinite(node.at),
+    durationMs: wfFinite(node.durationMs),
+    files: fileList,
+    resultHead: resultHead.slice(0, 200),
+    error: errorText.slice(0, 200),
+  };
+}
+
+/** Model steps (derived status) + the view's nodeIds, joined node by node. */
+function wfSnapshotSteps(model, view, say) {
+  var viewSteps = view && Array.isArray(view.steps) ? view.steps : [];
+  var rawNodes = view && Array.isArray(view.nodes) ? view.nodes : [];
+  var byId = Object.create(null);
+  for (var n = 0; n < rawNodes.length; n += 1) {
+    if (rawNodes[n] && typeof rawNodes[n].id === "string") byId[rawNodes[n].id] = rawNodes[n];
+  }
+  var steps = model && Array.isArray(model.steps) ? model.steps : [];
+  var out = [];
+  for (var i = 0; i < steps.length; i += 1) {
+    var row = steps[i] || {};
+    var wireStep = viewSteps[i] && typeof viewSteps[i] === "object" ? viewSteps[i] : {};
+    var ids = Array.isArray(wireStep.nodeIds) ? wireStep.nodeIds : [];
+    var activeNodeId =
+      model && model.selected === row.index && model.flow && typeof model.flow.activeNodeId === "string"
+        ? model.flow.activeNodeId
+        : null;
+    var nodes = [];
+    for (var k = 0; k < ids.length; k += 1) {
+      var found = byId[ids[k]];
+      if (found) nodes.push(wfSnapshotNode(found, activeNodeId, say));
+    }
+    var nodeCount = wfFinite(row.nodeCount) === null ? nodes.length : Math.round(row.nodeCount);
+    out.push({
+      index: wfFinite(row.index) === null ? i : row.index,
+      planIndex: wfFinite(row.planIndex) === null ? null : row.planIndex,
+      title: typeof row.title === "string" ? row.title : "—",
+      status: typeof row.status === "string" ? row.status : "pending",
+      statusLabel: typeof say === "function" ? say(row.statusKey) : String(row.statusKey || row.status || "—"),
+      percent: wfFinite(row.percent),
+      percentSource: typeof row.percentSource === "string" ? row.percentSource : "none",
+      startedAt: wfFinite(row.startedAt),
+      endedAt: wfFinite(row.endedAt),
+      nodeCount: nodeCount,
+      truncated: Math.max(0, nodeCount - nodes.length),
+      nodes: nodes,
+    });
+  }
+  return out;
+}
+
+/** The JSON body. `schema` is present even when every other field is empty. */
+function wfBuildSnapshot(model, view, sessionId, nowMs, say) {
+  var now = wfFinite(nowMs) === null ? Date.now() : nowMs;
+  var steps = wfSnapshotSteps(model, view, say);
+  return {
+    schema: WF_SNAPSHOT_SCHEMA,
+    generatedAt: wfSnapshotIso(now),
+    generatedAtMs: Math.round(now),
+    sessionId: typeof sessionId === "string" ? sessionId : "",
+    task: model && typeof model.task === "string" ? model.task : "",
+    progress: model && model.progress ? {
+      done: model.progress.done,
+      total: model.progress.total,
+      percent: model.progress.percent,
+    } : { done: 0, total: 0, percent: 0 },
+    steps: steps,
+  };
+}
+
+function wfSnapshotJson(model, view, sessionId, nowMs, say) {
+  return JSON.stringify(wfBuildSnapshot(model, view, sessionId, nowMs, say), null, 2);
+}
+
+/** Markdown mirrors the panel's visible vocabulary: status, progress, node title. */
+function wfSnapshotMarkdown(model, view, sessionId, nowMs, say) {
+  var snapshot = wfBuildSnapshot(model, view, sessionId, nowMs, say);
+  var lines = [];
+  lines.push("# 总任务");
+  lines.push("");
+  lines.push(wfSnapshotFlat(snapshot.task) || "—");
+  lines.push("");
+  lines.push("- 生成时间：" + wfSnapshotClock(snapshot.generatedAtMs));
+  lines.push("- 会话：" + (snapshot.sessionId || "—"));
+  lines.push(
+    "- 进度：" + snapshot.progress.done + "/" + snapshot.progress.total + " 步 · " + snapshot.progress.percent + "%"
+  );
+  lines.push("");
+  lines.push("## 分步");
+  for (var i = 0; i < snapshot.steps.length; i += 1) {
+    var step = snapshot.steps[i];
+    var percent = wfFinite(step.percent) === null ? "—" : Math.round(step.percent) + "%";
+    lines.push("");
+    lines.push("### " + (i + 1) + ". " + wfSnapshotFlat(step.title) + "（" + step.statusLabel + " · " + percent + "）");
+    if (step.nodes.length === 0) {
+      lines.push("- （无节点）");
+      continue;
+    }
+    for (var n = 0; n < step.nodes.length; n += 1) {
+      var node = step.nodes[n];
+      var tool = node.tool !== "" ? node.tool : node.kind || "—";
+      var files = node.files.length + " 文件";
+      var duration = wfFormatDuration(node.durationMs) || "—";
+      lines.push("- " + tool + " · " + wfSnapshotFlat(node.title) + " · " + files + " · " + duration);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+
+function wfSnapshotText(kind, model, view, sessionId, nowMs, say) {
+  return kind === "json"
+    ? wfSnapshotJson(model, view, sessionId, nowMs, say)
+    : wfSnapshotMarkdown(model, view, sessionId, nowMs, say);
+}
+
+/**
+ * Copy one snapshot and paint the 1.5 s acknowledgement on `element` (the same
+ * helper the node detail uses, so the two copy paths cannot diverge).
+ */
+function wfCopySnapshot(kind, model, view, sessionId, nowMs, say, element, env) {
+  return wfCopyWithFeedback(wfSnapshotText(kind, model, view, sessionId, nowMs, say), element, say, env);
+}
+
+/**
+ * Download through Blob + URL.createObjectURL. Every browser object is injectable
+ * so Node can assert the filename and the revoke path without a DOM.
+ */
+function wfSnapshotDownload(kind, text, sessionId, env) {
+  var scope = env || {};
+  var doc = scope.document || (typeof document !== "undefined" ? document : null);
+  var BlobImpl = scope.Blob || (typeof Blob !== "undefined" ? Blob : null);
+  var URLImpl = scope.URL || (typeof URL !== "undefined" ? URL : null);
+  if (!doc || typeof BlobImpl !== "function" || !URLImpl || typeof URLImpl.createObjectURL !== "function") {
+    return { ok: false, reason: "unsupported", filename: "" };
+  }
+  if (typeof URLImpl.revokeObjectURL !== "function") {
+    return { ok: false, reason: "unsupported", filename: "" };
+  }
+  var filename = wfSnapshotFileName(sessionId, kind);
+  var anchor = doc.createElement("a");
+  if (!anchor) return { ok: false, reason: "unsupported", filename: filename };
+  var url = URLImpl.createObjectURL(new BlobImpl([text], { type: wfSnapshotMime(kind) }));
+  WF_SNAPSHOT_URLS.push(url);
+  anchor.href = url;
+  anchor.download = filename;
+  if (anchor.style) anchor.style.display = "none";
+  if (doc.body && typeof doc.body.appendChild === "function") doc.body.appendChild(anchor);
+  if (typeof anchor.click === "function") anchor.click();
+  if (anchor.parentNode && typeof anchor.parentNode.removeChild === "function") anchor.parentNode.removeChild(anchor);
+  return { ok: true, reason: "", filename: filename, url: url };
+}
+
+/** Release every object URL the panel created. Called from the mount cleanup. */
+function wfReleaseSnapshotUrls(env) {
+  var scope = env || {};
+  var URLImpl = scope.URL || (typeof URL !== "undefined" ? URL : null);
+  var revoked = 0;
+  for (var i = 0; i < WF_SNAPSHOT_URLS.length; i += 1) {
+    if (URLImpl && typeof URLImpl.revokeObjectURL === "function") {
+      try {
+        URLImpl.revokeObjectURL(WF_SNAPSHOT_URLS[i]);
+        revoked += 1;
+      } catch (error) {
+ /* an already-revoked URL is not an error */
+      }
+    }
+  }
+  WF_SNAPSHOT_URLS = [];
+  return revoked;
+}
+
+function wfSnapshotUrlCount() {
+  return WF_SNAPSHOT_URLS.length;
+}
+
+/** The component's mount cleanup: a Blob URL must not outlive the panel. */
+function wfUseSnapshotUrls() {
+  React.useEffect(function () {
+    return function () {
+      wfReleaseSnapshotUrls();
+    };
+  }, []);
+}