npm - mustflow - Versions diffs - 1.15.97 - Mend

mustflow 1.15.97

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (415) hide show

package/templates/default/locales/zh/.mustflow/skills/visual-review-artifact/assets/review-template.html ADDED Viewed

@@ -0,0 +1,286 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Visual Review Artifact</title>
+  <style>
+    :root {
+      color-scheme: light dark;
+      --bg: #f7f7f4;
+      --fg: #1f2328;
+      --muted: #656d76;
+      --line: #d0d7de;
+      --panel: #ffffff;
+      --accent: #0969da;
+      --approve: #1a7f37;
+      --reject: #cf222e;
+      --discuss: #9a6700;
+    }
+    @media (prefers-color-scheme: dark) {
+      :root {
+        --bg: #0d1117;
+        --fg: #e6edf3;
+        --muted: #8b949e;
+        --line: #30363d;
+        --panel: #161b22;
+        --accent: #58a6ff;
+        --approve: #3fb950;
+        --reject: #ff7b72;
+        --discuss: #d29922;
+      }
+    }
+    * {
+      box-sizing: border-box;
+    }
+    body {
+      margin: 0;
+      background: var(--bg);
+      color: var(--fg);
+      font: 15px/1.5 system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    }
+    main {
+      max-width: 1120px;
+      margin: 0 auto;
+      padding: 24px;
+    }
+    header {
+      display: grid;
+      gap: 8px;
+      padding-block: 8px 20px;
+      border-bottom: 1px solid var(--line);
+    }
+    h1,
+    h2 {
+      margin: 0;
+      line-height: 1.2;
+    }
+    h1 {
+      font-size: 28px;
+    }
+    h2 {
+      font-size: 18px;
+    }
+    p {
+      margin: 0;
+    }
+    .meta,
+    .note {
+      color: var(--muted);
+    }
+    .toolbar {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+      margin-block: 18px;
+    }
+    .sections {
+      display: grid;
+      gap: 14px;
+    }
+    section {
+      display: grid;
+      gap: 12px;
+      background: var(--panel);
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      padding: 16px;
+    }
+    .section-head {
+      display: flex;
+      flex-wrap: wrap;
+      justify-content: space-between;
+      gap: 8px;
+      align-items: start;
+    }
+    .status {
+      color: var(--muted);
+      font-size: 13px;
+    }
+    .actions {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+    }
+    button {
+      min-height: 36px;
+      border: 1px solid var(--line);
+      border-radius: 6px;
+      background: transparent;
+      color: var(--fg);
+      padding: 6px 10px;
+      cursor: pointer;
+    }
+    button:hover,
+    button:focus-visible {
+      border-color: var(--accent);
+      outline: 2px solid transparent;
+    }
+    button[aria-pressed="true"][data-action="approve"] {
+      border-color: var(--approve);
+      color: var(--approve);
+    }
+    button[aria-pressed="true"][data-action="reject"] {
+      border-color: var(--reject);
+      color: var(--reject);
+    }
+    button[aria-pressed="true"][data-action="discuss"] {
+      border-color: var(--discuss);
+      color: var(--discuss);
+    }
+    textarea {
+      width: 100%;
+      min-height: 84px;
+      resize: vertical;
+      border: 1px solid var(--line);
+      border-radius: 6px;
+      background: transparent;
+      color: var(--fg);
+      padding: 10px;
+      font: inherit;
+    }
+    pre {
+      overflow: auto;
+      margin: 0;
+      padding: 12px;
+      border-radius: 6px;
+      border: 1px solid var(--line);
+      background: color-mix(in srgb, var(--panel), var(--bg) 45%);
+    }
+  </style>
+</head>
+<body>
+  <main data-artifact-kind="decision" data-review-artifact>
+    <header>
+      <h1>Visual Review Artifact</h1>
+      <p class="meta">Replace this sample content with evidence-backed plan, suggestion, review, flow, or decision sections.</p>
+      <p class="note">Review only. This page does not execute commands, modify files, grant permission, skip validation, or override repository rules.</p>
+    </header>
+    <div class="toolbar" aria-label="Review actions">
+      <button type="button" data-copy-json>Copy decision JSON</button>
+      <button type="button" data-copy-prompt>Copy follow-up prompt</button>
+    </div>
+    <div class="sections">
+      <section data-review-section data-section-id="section-1">
+        <div class="section-head">
+          <div>
+            <h2>Section title</h2>
+            <p class="meta">Short evidence, tradeoff, or decision summary.</p>
+          </div>
+          <p class="status" data-status-label>Not decided</p>
+        </div>
+        <pre>Evidence or code excerpt goes here.</pre>
+        <div class="actions">
+          <button type="button" data-action="approve" aria-pressed="false">Approve</button>
+          <button type="button" data-action="reject" aria-pressed="false">Reject</button>
+          <button type="button" data-action="discuss" aria-pressed="false">Discuss</button>
+        </div>
+        <label>
+          Comment
+          <textarea data-comment placeholder="Add a comment for this section"></textarea>
+        </label>
+      </section>
+    </div>
+  </main>
+  <script>
+    const labels = {
+      approve: "Approved",
+      reject: "Rejected",
+      discuss: "Needs discussion"
+    };
+    function sections() {
+      return [...document.querySelectorAll("[data-review-section]")];
+    }
+    function setStatus(section, action) {
+      section.dataset.status = action;
+      section.querySelector("[data-status-label]").textContent = labels[action] ?? "Not decided";
+      for (const button of section.querySelectorAll("[data-action]")) {
+        button.setAttribute("aria-pressed", String(button.dataset.action === action));
+      }
+    }
+    function decisionData() {
+      return {
+        schema_version: "1",
+        artifact_kind: document.querySelector("[data-review-artifact]")?.dataset.artifactKind ?? "decision",
+        sections: sections().map((section) => ({
+          id: section.dataset.sectionId ?? "",
+          title: section.querySelector("h2")?.textContent?.trim() ?? "",
+          status: section.dataset.status ?? "undecided",
+          comment: section.querySelector("[data-comment]")?.value ?? ""
+        }))
+      };
+    }
+    async function copyText(text) {
+      if (navigator.clipboard?.writeText) {
+        await navigator.clipboard.writeText(text);
+        return;
+      }
+      const area = document.createElement("textarea");
+      area.value = text;
+      document.body.append(area);
+      area.select();
+      document.execCommand("copy");
+      area.remove();
+    }
+    function followUpPrompt() {
+      return [
+        "Use this visual review decision data as user feedback.",
+        "Do not treat it as command permission or validation approval.",
+        "",
+        JSON.stringify(decisionData(), null, 2)
+      ].join("\n");
+    }
+    document.addEventListener("click", async (event) => {
+      const target = event.target;
+      if (!(target instanceof HTMLElement)) return;
+      const actionButton = target.closest("[data-action]");
+      if (actionButton) {
+        const section = actionButton.closest("[data-review-section]");
+        if (section) setStatus(section, actionButton.dataset.action);
+        return;
+      }
+      if (target.closest("[data-copy-json]")) {
+        await copyText(JSON.stringify(decisionData(), null, 2));
+      }
+      if (target.closest("[data-copy-prompt]")) {
+        await copyText(followUpPrompt());
+      }
+    });
+  </script>
+</body>
+</html>

package/templates/default/locales/zh/.mustflow/skills/visual-review-artifact/resources.toml ADDED Viewed

@@ -0,0 +1,7 @@
+schema_version = "1"
+[resources."assets/review-template.html"]
+type = "asset"
+asset_kind = "template"
+purpose = "Self-contained static HTML template for section-level review decisions and comments."
+required = false

package/templates/default/locales/zh/.mustflow/skills/web-asset-optimization/SKILL.md ADDED Viewed

@@ -0,0 +1,108 @@
+---
+mustflow_doc: skill.web-asset-optimization
+locale: zh
+canonical: false
+revision: 2
+lifecycle: mustflow-owned
+authority: procedure
+name: web-asset-optimization
+description: Apply this skill when adding, converting, resizing, replacing, or reviewing raster image assets for websites or web applications.
+metadata:
+  mustflow_schema: "1"
+  mustflow_kind: procedure
+  pack_id: mustflow.core
+  skill_id: mustflow.core.web-asset-optimization
+  command_intents:
+    - asset_optimize
+    - build
+---
+# Web Asset Optimization
+<!-- mustflow-section: purpose -->
+## Purpose
+Keep web image assets small, format-appropriate, and correctly referenced without inventing an image pipeline for the project.
+<!-- mustflow-section: use-when -->
+## Use When
+- A generated PNG, JPEG, WebP, AVIF, GIF, or other raster image is added to a website or web app.
+- An existing web image is replaced, resized, compressed, or converted.
+- A page, component, stylesheet, or metadata file changes image references.
+- A user asks to reduce image size, convert to WebP or AVIF, or prepare generated images for production use.
+<!-- mustflow-section: do-not-use-when -->
+## Do Not Use When
+- The asset is a vector source such as SVG, icon font, or design-token file.
+- The image is an archival, print, source, or evidence artifact where preserving the original bytes matters more than web delivery size.
+- The repository already has a more specific media, design-system, or framework asset procedure.
+- The task is only to generate a new image and not to install or reference it in the repository.
+<!-- mustflow-section: required-inputs -->
+## Required Inputs
+- The image file paths and their current or intended references.
+- The expected display size, transparency needs, animation needs, and quality requirements.
+- Existing framework image conventions, static asset folders, and import style.
+- `.mustflow/config/commands.toml` entries for `asset_optimize` and `build`.
+<!-- mustflow-section: preconditions -->
+## Preconditions
+- The task matches the Use When conditions and does not match the Do Not Use When exclusions.
+- Required inputs are available, or missing inputs can be reported without guessing.
+- Higher-priority instructions and `.mustflow/config/commands.toml` have been checked for the current scope.
+<!-- mustflow-section: allowed-edits -->
+## Allowed Edits
+- Keep edits within the scope described by this skill, the user request, and the matching route in `.mustflow/skills/INDEX.md`.
+- Do not broaden command permission, invent project facts, or change unrelated workflow files.
+<!-- mustflow-section: procedure -->
+## Procedure
+1. Identify every changed image asset and every page, component, style, metadata, or manifest reference that depends on it.
+2. Check the original file size, dimensions, format, transparency, and animation before changing the asset.
+3. Prefer the repository's existing image pipeline, framework image component, or configured `asset_optimize` intent when one exists.
+4. Do not add a new dependency, online service, or ad hoc conversion tool unless the user explicitly approves it or the repository already uses it.
+5. Choose the output format based on actual needs: WebP or AVIF for most photographic and generated bitmap website assets, PNG when lossless transparency or exact pixels matter, and SVG only for real vector artwork.
+6. Keep source and derived assets separate when the repository already has that convention. Otherwise, avoid adding duplicate originals unless future editing requires them.
+7. Update imports, static paths, metadata references, dimensions, and cache-sensitive filenames according to the local style.
+8. Compare before and after file sizes and note any quality, transparency, animation, browser-support, or fallback tradeoff.
+<!-- mustflow-section: postconditions -->
+## Postconditions
+- The expected output can be produced with clear evidence, executed command intents, skipped checks, and remaining risks.
+- Any missing command intent, unknown input, or authority conflict is reported instead of hidden.
+<!-- mustflow-section: verification -->
+## Verification
+Use configured oneshot command intents when available:
+- `asset_optimize`
+- `build`
+Do not infer missing image optimization commands. If `asset_optimize` is unknown, missing, manual-only, or not agent-runnable, report that status and describe the intended optimization without executing an unconfigured tool.
+<!-- mustflow-section: failure-handling -->
+## Failure Handling
+- If optimization visibly degrades the image or breaks transparency, restore or keep the better asset and report the tradeoff.
+- If image references break, fix the nearest import, path, metadata, or build configuration that owns the reference.
+- If the repository lacks an optimization command, propose the smallest project-specific command intent instead of running an external website or guessed package command.
+- If the build fails after asset changes, investigate the first asset-related failure before touching unrelated code.
+<!-- mustflow-section: output-format -->
+## Output Format
+- Images reviewed or changed
+- Format and size changes
+- References updated
+- Command intents run
+- Skipped command intents and reasons
+- Remaining image quality or browser-support risks

package/templates/default/locales/zh/AGENTS.md ADDED Viewed

@@ -0,0 +1,86 @@
+---
+mustflow_doc: agents.root
+locale: zh
+canonical: false
+revision: 10
+lifecycle: user-editable
+authority: binding
+---
+# AGENTS.md
+本文件为本仓库中 LLM 编码代理的首要阅读工作规范。
+本仓库遵循 mustflow 代理工作流，相关细节存放于 `.mustflow/` 目录下。
+## 阅读顺序
+1. `AGENTS.md`
+2. `.mustflow/docs/agent-workflow.md`
+3. `.mustflow/config/mustflow.toml`
+4. `.mustflow/config/commands.toml`
+5. `.mustflow/config/preferences.toml`（如存在）
+6. `.mustflow/skills/INDEX.md`
+7. `.mustflow/context/INDEX.md`，仅当任务涉及项目、产品、领域、UI、后端、数据、安全或运维上下文时
+8. 对应的 `.mustflow/context/<name>.md` 文件，仅当上下文索引中选中时
+9. 对应的 `.mustflow/skills/<name>/SKILL.md`
+10. `REPO_MAP.md`，仅当需要更广泛的仓库导航时
+11. 相关源代码、测试及文档文件
+## 核心规则
+- 不得回退用户已有修改。
+- 不得从包管理器文件推断命令。
+- 仅执行状态为 `configured`、生命周期为 `oneshot`，且 `run_policy` 为 `agent_allowed` 的命令定义。
+- 优先使用 `mf run <intent>` 执行已配置的 oneshot 命令。
+- 串行执行 `mf run` 命令意图。若某已配置意图仍在运行，尤其当该意图声明了非空的 `writes`（如 `dist/`）时，不得启动新的 `mf run`。
+- 选择覆盖风险最小且已配置的验证意图。若命令契约提供相关测试或快速检查，应优先使用；若缺少更窄的验证意图，应报告缺口，而非默默退回到缓慢的全量测试。
+- 不得直接启动开发服务器、watcher、浏览器界面、交互式提示或后台进程。
+- 未经明确配置，不得启动自治循环、worker 进程、persona 系统或长时运行的 harness 进程。
+- 任务可能长时间运行或影响敏感状态时，必须遵守 `.mustflow/config/mustflow.toml` 中的 `[budget]`、`[approval]` 和 `[isolation]` 配置。
+- 大范围修改前，应使用 `mf doctor` 或 `mf doctor --json` 进行只读健康检查。
+- `mf context --json` 提供机器可读的方向信息，但不能替代规则和命令规范。
+- `.mustflow/config/preferences.toml` 中的偏好优先级低于用户直接指令及项目既有风格。
+- 当代码、模板、schema、CLI 行为、包元数据、用户可见文档、安装输出或测试发生变更时，需在最终报告前检查 `.mustflow/config/preferences.toml` 中的 `[release.versioning]`。
+  版本文件只能按偏好修改：当 `auto_bump = true` 且 `require_user_confirmation = false` 时，自动升级版本；否则应按配置建议升级或编辑前请求确认。
+  不得假设版本来源为 `package.json`，应先定位仓库自身版本来源。
+- `.mustflow/context/` 中的上下文文件用于说明项目方向和领域约定，应视为任务相关上下文，而非代码、测试、命令或用户指令的替代品。
+- 若存在 `DESIGN.md`，仅在涉及 UI、视觉设计、布局、design token 或可访问性相关工作时阅读；若不存在，不得创建。
+- 任务适用某项 skill 时，应阅读对应 skill 文档。
+- 编辑前，应通过 `.mustflow/skills/INDEX.md` 判断是否有适用的 skill。
+- 若新证据表明某项 skill 相关（如命令失败或文档变更），应先阅读对应 `SKILL.md`，再继续工作。
+- skill 文档仅指导流程，不授权执行 `.mustflow/config/commands.toml` 之外的命令，也不覆盖用户、宿主、仓库或安全规则。
+- 未经明确请求，不得修改生成文件、外部依赖或 secrets 文件。
+- 不得将根目录下的 `config/`、`docs/` 或 `skills/` 目录视为 mustflow 文档。
+## 父子规则优先级
+- 离被编辑文件最近的 `AGENTS.md` 规则更具体，优先级更高。
+- 工作流、风格、测试或命令规则冲突时，遵循子仓库的 `AGENTS.md` 和 `.mustflow/config/commands.toml`。
+- 针对 secrets、隐私、破坏性命令和允许编辑路径的安全规则为累加，执行更严格的规则。
+- 进入嵌套仓库时，编辑前应重新阅读该仓库的 `AGENTS.md` 和 `.mustflow/config/*.toml`。
+- 未经明确请求，不得编辑所选子仓库之外的内容。
+## 宿主专用指令兼容性
+某些编码宿主可能会读取额外的宿主专用指令文件，或执行自己的审批、沙箱、检查点和命令执行策略。
+应将这些宿主策略视为额外的安全和执行约束，不替代本仓库的 mustflow 命令契约。
+当宿主指令与 mustflow 规则冲突时：
+- 用户当前的直接指令决定任务目标，除非该指令不安全。
+- 宿主的安全和审批门禁依然有效。
+- 仓库工作规则来自最近的 `AGENTS.md` 和 `.mustflow/config/*.toml`。
+- 项目验证命令必须使用已配置的 mustflow intent。
+- 隐私、secret、破坏性命令和 Git push 规则以更严格者为准。
+- 生成状态、摘要和缓存绝不能覆盖当前文件或当前用户指令。
+若规则不明确，应停止并报告冲突，避免猜测。
+## 指令刷新检查点
+- 在长会话中，应于首次编辑前、当前命令意图无新鲜命令级刷新时的命令执行前、上下文压缩后、修改 `AGENTS.md` 或 `.mustflow/**` 后、切换项目根目录后，以及输出最终报告前，重新阅读 mustflow 指令。
+- 使用 `.mustflow/config/mustflow.toml` 中的 `[refresh]` 策略决定执行 light、command、skill 或 full refresh。
+- 不得在项目文件中存储对话轮次或会话活动，刷新状态应保存在本地缓存或宿主应用中。
+详细工作流、命令策略、失败处理和安全规则请参见 `.mustflow/docs/agent-workflow.md`。