@yosai/cli 0.2.1-test.1 → 0.2.1-test.10

package/dist/skills/yos-doc/references/few-shot.draft.json

@@ -0,0 +1,195 @@
+{
+  "title": "示例：Agent few-shot",
+  "attachments": [],
+  "content": {
+    "type": "doc",
+    "content": [
+      {
+        "type": "paragraph",
+        "attrs": { "indent": 0, "textAlign": null },
+        "content": [
+          { "type": "text", "text": "这是一段" },
+          { "type": "text", "marks": [{ "type": "bold" }], "text": "加粗" },
+          { "type": "text", "text": "与" },
+          {
+            "type": "text",
+            "marks": [
+              {
+                "type": "link",
+                "attrs": {
+                  "href": "https://example.com",
+                  "target": "_blank",
+                  "rel": "noopener noreferrer nofollow",
+                  "class": "yos-docs-editor-link",
+                  "title": null
+                }
+              }
+            ],
+            "text": "链接"
+          },
+          { "type": "text", "text": "。" }
+        ]
+      },
+      {
+        "type": "callout",
+        "attrs": {
+          "emoji": "💡",
+          "backgroundColor": "#e1eafe",
+          "borderColor": "#80a7f9"
+        },
+        "content": [
+          {
+            "type": "paragraph",
+            "attrs": { "indent": 0, "textAlign": null },
+            "content": [{ "type": "text", "text": "高亮提示：优先写清验收标准。" }]
+          }
+        ]
+      },
+      {
+        "type": "heading",
+        "attrs": { "level": 2, "indent": 0, "textAlign": null, "collapsed": false },
+        "content": [{ "type": "text", "text": "清单" }]
+      },
+      {
+        "type": "bulletList",
+        "content": [
+          {
+            "type": "listItem",
+            "attrs": { "collapsed": false },
+            "content": [
+              {
+                "type": "paragraph",
+                "attrs": { "indent": 0, "textAlign": null },
+                "content": [{ "type": "text", "text": "第一项" }]
+              }
+            ]
+          },
+          {
+            "type": "listItem",
+            "attrs": { "collapsed": false },
+            "content": [
+              {
+                "type": "paragraph",
+                "attrs": { "indent": 0, "textAlign": null },
+                "content": [{ "type": "text", "text": "第二项" }]
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "type": "taskList",
+        "content": [
+          {
+            "type": "taskItem",
+            "attrs": { "checked": false },
+            "content": [
+              {
+                "type": "paragraph",
+                "attrs": { "indent": 0, "textAlign": null },
+                "content": [{ "type": "text", "text": "待办示例" }]
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "type": "codeBlock",
+        "attrs": {
+          "language": "typescript",
+          "wrap": false,
+          "caption": "示例",
+          "collapsed": false,
+          "regionFolds": []
+        },
+        "content": [{ "type": "text", "text": "export const ok = true;\n" }]
+      },
+      {
+        "type": "table",
+        "content": [
+          {
+            "type": "tableRow",
+            "attrs": { "height": null },
+            "content": [
+              {
+                "type": "tableHeader",
+                "attrs": {
+                  "colspan": 1,
+                  "rowspan": 1,
+                  "colwidth": null,
+                  "align": null,
+                  "backgroundColor": null
+                },
+                "content": [
+                  {
+                    "type": "paragraph",
+                    "attrs": { "indent": 0, "textAlign": null },
+                    "content": [{ "type": "text", "text": "列 A" }]
+                  }
+                ]
+              },
+              {
+                "type": "tableHeader",
+                "attrs": {
+                  "colspan": 1,
+                  "rowspan": 1,
+                  "colwidth": null,
+                  "align": null,
+                  "backgroundColor": null
+                },
+                "content": [
+                  {
+                    "type": "paragraph",
+                    "attrs": { "indent": 0, "textAlign": null },
+                    "content": [{ "type": "text", "text": "列 B" }]
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            "type": "tableRow",
+            "attrs": { "height": null },
+            "content": [
+              {
+                "type": "tableCell",
+                "attrs": {
+                  "colspan": 1,
+                  "rowspan": 1,
+                  "colwidth": null,
+                  "align": null,
+                  "backgroundColor": null
+                },
+                "content": [
+                  {
+                    "type": "paragraph",
+                    "attrs": { "indent": 0, "textAlign": null },
+                    "content": [{ "type": "text", "text": "1" }]
+                  }
+                ]
+              },
+              {
+                "type": "tableCell",
+                "attrs": {
+                  "colspan": 1,
+                  "rowspan": 1,
+                  "colwidth": null,
+                  "align": null,
+                  "backgroundColor": null
+                },
+                "content": [
+                  {
+                    "type": "paragraph",
+                    "attrs": { "indent": 0, "textAlign": null },
+                    "content": [{ "type": "text", "text": "2" }]
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      },
+      { "type": "horizontalRule" }
+    ]
+  }
+}

package/dist/skills/yos-doc/scripts/validate-runtime-doc.mjs

@@ -0,0 +1,370 @@
+/**
+ * CLI 用纯 ESM 校验（与 src/utils/agent/validateDocDraft.ts 保持同步）。
+ * 供 ./yos-doc.mjs 使用（同步自 @yos/doc-editor@0.0.41），避免 Node 直接跑 TS 的扩展名问题。
+ */
+
+export const AGENT_DOC_ROOT = "doc";
+
+export const AGENT_TIER_A_NODES = [
+  "doc",
+  "paragraph",
+  "heading",
+  "blockquote",
+  "horizontalRule",
+  "hardBreak",
+  "bulletList",
+  "orderedList",
+  "listItem",
+  "taskList",
+  "taskItem",
+  "codeBlock",
+  "callout",
+  "table",
+  "tableRow",
+  "tableHeader",
+  "tableCell",
+  "text",
+];
+
+export const AGENT_TIER_B_NODES = ["columnBlock", "column", "image"];
+
+export const AGENT_FORBIDDEN_NODES = [
+  "mindmap",
+  "flowchart",
+  "video",
+  "audio",
+  "file",
+];
+
+export const AGENT_ALLOWED_MARKS = [
+  "bold",
+  "italic",
+  "strike",
+  "underline",
+  "code",
+  "link",
+  "textStyle",
+  "highlight",
+];
+
+export const AGENT_FORBIDDEN_MARKS = ["glossaryTerm"];
+
+export const AGENT_NODE_ATTR_KEYS = {
+  paragraph: ["indent", "textAlign"],
+  heading: ["level", "indent", "textAlign", "collapsed"],
+  orderedList: ["start", "type"],
+  listItem: ["collapsed"],
+  taskItem: ["checked"],
+  codeBlock: ["language", "wrap", "caption", "collapsed", "regionFolds"],
+  callout: ["emoji", "backgroundColor", "borderColor"],
+  tableRow: ["height"],
+  tableHeader: ["colspan", "rowspan", "colwidth", "align", "backgroundColor"],
+  tableCell: ["colspan", "rowspan", "colwidth", "align", "backgroundColor"],
+  columnBlock: ["widths"],
+  image: [
+    "src",
+    "mediaId",
+    "alt",
+    "title",
+    "width",
+    "height",
+    "align",
+    "caption",
+    "originalSrc",
+    "uploadStatus",
+    "uploadId",
+  ],
+};
+
+export const AGENT_MARK_ATTR_KEYS = {
+  link: ["href", "target", "rel", "class", "title"],
+  textStyle: ["color"],
+  highlight: ["color"],
+};
+
+export function allowedNodesForTier(tier) {
+  const nodes = new Set(AGENT_TIER_A_NODES);
+  if (tier === "B") {
+    for (const name of AGENT_TIER_B_NODES) {
+      nodes.add(name);
+    }
+  }
+  return nodes;
+}
+
+const ALLOWED_MARKS = new Set(AGENT_ALLOWED_MARKS);
+const FORBIDDEN_MARKS = new Set(AGENT_FORBIDDEN_MARKS);
+const FORBIDDEN_NODES = new Set(AGENT_FORBIDDEN_NODES);
+const TEXT_ALIGN = new Set(["left", "center", "right", "justify"]);
+const IMAGE_ALIGN = new Set(["left", "center", "right"]);
+
+function push(issues, path, message) {
+  issues.push({ path, message });
+}
+
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function isHttpUrl(value) {
+  return /^https?:\/\//i.test(value);
+}
+
+function validateAttrKeys(issues, path, type, attrs, allowedMap) {
+  if (attrs === undefined || attrs === null) {
+    return {};
+  }
+  if (!isRecord(attrs)) {
+    push(issues, `${path}.attrs`, "attrs 必须是对象");
+    return null;
+  }
+  const allowed = allowedMap[type];
+  if (!allowed) {
+    if (Object.keys(attrs).length > 0) {
+      push(issues, `${path}.attrs`, `type "${type}" 不应带 attrs`);
+    }
+    return attrs;
+  }
+  const allowedSet = new Set(allowed);
+  for (const key of Object.keys(attrs)) {
+    if (!allowedSet.has(key)) {
+      push(issues, `${path}.attrs.${key}`, `未知 attrs 键 "${key}"`);
+    }
+  }
+  return attrs;
+}
+
+function validateMarks(issues, path, marks) {
+  if (marks === undefined) {
+    return;
+  }
+  if (!Array.isArray(marks)) {
+    push(issues, path, "marks 必须是数组");
+    return;
+  }
+  marks.forEach((mark, index) => {
+    const markPath = `${path}[${index}]`;
+    if (!isRecord(mark) || typeof mark.type !== "string") {
+      push(issues, markPath, "mark 须含 string type");
+      return;
+    }
+    if (FORBIDDEN_MARKS.has(mark.type)) {
+      push(issues, markPath, `禁止 mark "${mark.type}"（Agent 勿生成）`);
+      return;
+    }
+    if (!ALLOWED_MARKS.has(mark.type)) {
+      push(issues, markPath, `未知 mark "${mark.type}"`);
+      return;
+    }
+    validateAttrKeys(
+      issues,
+      markPath,
+      mark.type,
+      mark.attrs,
+      AGENT_MARK_ATTR_KEYS,
+    );
+    if (mark.type === "link") {
+      const href = isRecord(mark.attrs) ? mark.attrs.href : undefined;
+      if (typeof href !== "string" || !href.trim()) {
+        push(issues, `${markPath}.attrs.href`, "link 需要非空 href");
+      }
+    }
+  });
+}
+
+function validateNodeSemantics(issues, path, type, attrs, content) {
+  if (type === "heading") {
+    const level = attrs.level;
+    if (
+      level !== undefined &&
+      (typeof level !== "number" || level < 1 || level > 6)
+    ) {
+      push(issues, `${path}.attrs.level`, "level 须为 1～6");
+    }
+  }
+  if (type === "paragraph" || type === "heading") {
+    const align = attrs.textAlign;
+    if (
+      align !== undefined &&
+      align !== null &&
+      (typeof align !== "string" || !TEXT_ALIGN.has(align))
+    ) {
+      push(
+        issues,
+        `${path}.attrs.textAlign`,
+        "textAlign 须为 null 或 left/center/right/justify",
+      );
+    }
+    const indent = attrs.indent;
+    if (
+      indent !== undefined &&
+      (typeof indent !== "number" || indent < 0 || indent > 8)
+    ) {
+      push(issues, `${path}.attrs.indent`, "indent 须为 0～8");
+    }
+  }
+  if (type === "columnBlock") {
+    if (!Array.isArray(content) || content.length < 2 || content.length > 5) {
+      push(issues, `${path}.content`, "columnBlock 须含 2～5 个 column");
+    }
+    const widths = attrs.widths;
+    if (widths !== undefined) {
+      if (
+        !Array.isArray(widths) ||
+        !widths.every((w) => typeof w === "number")
+      ) {
+        push(issues, `${path}.attrs.widths`, "widths 须为 number[]");
+      } else if (Array.isArray(content) && widths.length !== content.length) {
+        push(issues, `${path}.attrs.widths`, "widths.length 须等于列数");
+      }
+    }
+  }
+  if (type === "image") {
+    const mediaId = attrs.mediaId;
+    if (mediaId !== undefined && mediaId !== "" && mediaId !== null) {
+      push(
+        issues,
+        `${path}.attrs.mediaId`,
+        "Agent 勿编造 mediaId，请留空并由宿主 upload",
+      );
+    }
+    if (attrs.uploadStatus != null && attrs.uploadStatus !== "") {
+      push(issues, `${path}.attrs.uploadStatus`, "Agent 勿写 uploadStatus");
+    }
+    if (
+      attrs.uploadId !== undefined &&
+      attrs.uploadId !== "" &&
+      attrs.uploadId !== null
+    ) {
+      push(issues, `${path}.attrs.uploadId`, "Agent 勿写 uploadId");
+    }
+    const src = attrs.src;
+    if (src != null && src !== "") {
+      if (typeof src !== "string" || !isHttpUrl(src)) {
+        push(issues, `${path}.attrs.src`, "image.src 仅允许 http(s) URL");
+      }
+    }
+    const align = attrs.align;
+    if (
+      align !== undefined &&
+      (typeof align !== "string" || !IMAGE_ALIGN.has(align))
+    ) {
+      push(issues, `${path}.attrs.align`, "align 须为 left/center/right");
+    }
+  }
+}
+
+function validateNode(issues, path, node, allowedNodes) {
+  if (!isRecord(node)) {
+    push(issues, path, "节点必须是对象");
+    return;
+  }
+  const type = node.type;
+  if (typeof type !== "string" || !type) {
+    push(issues, path, "缺少 type");
+    return;
+  }
+  if (FORBIDDEN_NODES.has(type)) {
+    push(issues, path, `禁止节点 "${type}"（属 C 档，勿由 Agent 生成）`);
+    return;
+  }
+  if (!allowedNodes.has(type)) {
+    push(
+      issues,
+      path,
+      `节点 "${type}" 不在当前档位白名单（可用 --tier B 放开分栏/外链图）`,
+    );
+    return;
+  }
+
+  if (type === "text") {
+    if (typeof node.text !== "string") {
+      push(issues, `${path}.text`, "text 节点须有 string text");
+    }
+    validateMarks(issues, `${path}.marks`, node.marks);
+    if (node.content !== undefined) {
+      push(issues, `${path}.content`, "text 节点不应有 content");
+    }
+    return;
+  }
+
+  const attrs = validateAttrKeys(
+    issues,
+    path,
+    type,
+    node.attrs,
+    AGENT_NODE_ATTR_KEYS,
+  );
+  if (attrs) {
+    validateNodeSemantics(issues, path, type, attrs, node.content);
+  }
+
+  if (node.marks !== undefined) {
+    push(issues, `${path}.marks`, "仅 text 节点可有 marks");
+  }
+
+  const atomTypes = new Set(["horizontalRule", "hardBreak", "image"]);
+  if (atomTypes.has(type)) {
+    if (
+      node.content !== undefined &&
+      Array.isArray(node.content) &&
+      node.content.length
+    ) {
+      push(issues, `${path}.content`, `${type} 不应有 content`);
+    }
+    return;
+  }
+
+  if (node.content === undefined) {
+    return;
+  }
+  if (!Array.isArray(node.content)) {
+    push(issues, `${path}.content`, "content 必须是数组");
+    return;
+  }
+  node.content.forEach((child, index) => {
+    validateNode(issues, `${path}.content[${index}]`, child, allowedNodes);
+  });
+}
+
+function validateAttachments(issues, attachments) {
+  if (attachments === undefined) {
+    return;
+  }
+  if (!Array.isArray(attachments)) {
+    push(issues, "attachments", "attachments 必须是数组");
+    return;
+  }
+  if (attachments.length > 0) {
+    push(
+      issues,
+      "attachments",
+      "Agent 默认勿生成 attachments（媒体由宿主 DocMediaHooks 上传）；请使用 []",
+    );
+  }
+}
+
+/** @param {object} draft @param {{ tier?: 'A'|'B' }} [options] */
+export function validateDocDraft(draft, options = {}) {
+  const tier = options.tier ?? "A";
+  const allowedNodes = allowedNodesForTier(tier);
+  const issues = [];
+
+  if (typeof draft.title !== "string") {
+    push(issues, "title", "title 必须是 string");
+  }
+
+  validateAttachments(issues, draft.attachments);
+
+  const content = draft.content;
+  if (!isRecord(content)) {
+    push(issues, "content", "content 必须是对象");
+    return { ok: false, issues };
+  }
+  if (content.type !== AGENT_DOC_ROOT) {
+    push(issues, "content.type", `根节点 type 必须是 "${AGENT_DOC_ROOT}"`);
+  }
+  validateNode(issues, "content", content, allowedNodes);
+
+  return { ok: issues.length === 0, issues };
+}