mustflow 1.15.97

package/templates/default/locales/es/.mustflow/skills/test-maintenance/SKILL.md

@@ -0,0 +1,122 @@
+---
+mustflow_doc: skill.test-maintenance
+locale: es
+canonical: false
+revision: 2
+lifecycle: mustflow-owned
+authority: procedure
+name: test-maintenance
+description: Aplica esta skill al agregar, actualizar, eliminar o auditar pruebas en respuesta a cambios de comportamiento, API, snapshots, compatibilidad o correcciones de errores.
+metadata:
+  mustflow_schema: "1"
+  mustflow_kind: procedure
+  pack_id: mustflow.core
+  skill_id: mustflow.core.test-maintenance
+  command_intents:
+    - test
+    - test_related
+    - test_audit
+    - snapshot_update
+    - lint
+    - build
+---
+
+# Mantenimiento De Pruebas
+
+<!-- mustflow-section: purpose -->
+## Proposito
+
+Mantener las pruebas alineadas con el contrato de comportamiento actual.
+
+<!-- mustflow-section: use-when -->
+## Usar Cuando
+
+- Se agregue, cambie, elimine o depreque comportamiento.
+- Una correccion de error necesite una prueba de regresion.
+- Las pruebas existentes puedan estar desactualizadas, duplicadas, ser demasiado amplias o depender de detalles de implementacion eliminados.
+- Haya cambiado la salida de snapshot.
+
+<!-- mustflow-section: do-not-use-when -->
+## No Usar Cuando
+
+- La tarea solo cambie redaccion o comentarios.
+- El repositorio no tenga un intent de pruebas configurado y el usuario haya pedido no agregar pruebas.
+
+<!-- mustflow-section: required-inputs -->
+## Entradas Requeridas
+
+- Solicitud del usuario
+- Contrato de comportamiento actual
+- Ruta de codigo cambiada o eliminada
+- Estilo de pruebas existente
+- `.mustflow/config/commands.toml`
+- `.mustflow/config/mustflow.toml` `[testing]`
+
+<!-- mustflow-section: preconditions -->
+## Precondiciones
+
+- La tarea coincide con las condiciones de uso y no coincide con las exclusiones.
+- Las entradas requeridas estan disponibles, o las entradas faltantes pueden reportarse sin adivinar.
+- Las instrucciones de mayor prioridad y `.mustflow/config/commands.toml` se revisaron para el alcance actual.
+
+<!-- mustflow-section: allowed-edits -->
+## Ediciones Permitidas
+
+- Mantener las ediciones dentro del alcance descrito por esta skill, la solicitud del usuario y la ruta coincidente en `.mustflow/skills/INDEX.md`.
+- No ampliar permisos de comando, inventar hechos del proyecto ni cambiar archivos de workflow no relacionados.
+
+<!-- mustflow-section: procedure -->
+## Procedimiento
+
+1. Define el comportamiento actual esperado.
+2. Busca pruebas existentes antes de introducir pruebas nuevas.
+3. Clasifica las pruebas afectadas:
+   - `active`: aun valida el comportamiento actual
+   - `update_needed`: el comportamiento cambio
+   - `obsolete_candidate`: probablemente valida comportamiento eliminado o irrelevante
+   - `legacy_contract`: el comportamiento antiguo se conserva intencionalmente
+   - `flaky_or_environmental`: el fallo puede depender del entorno
+4. Agrega, actualiza, elimina o reporta pruebas segun la clasificacion.
+5. No reintroduzcas comportamiento eliminado solo porque pruebas antiguas lo esperan.
+6. Trata las actualizaciones de snapshot como manuales, salvo que `snapshot_update` este aprobado y configurado de forma explicita.
+7. Manten las pruebas deterministas y cercanas al contrato de comportamiento.
+
+<!-- mustflow-section: postconditions -->
+## Postcondiciones
+
+- La salida esperada puede producirse con evidencia clara, intentos de comando ejecutados, verificaciones omitidas y riesgos restantes.
+- Cualquier intento de comando faltante, entrada desconocida o conflicto de autoridad se reporta en lugar de ocultarse.
+
+<!-- mustflow-section: verification -->
+## Verificacion
+
+Usa command intents oneshot configurados cuando esten disponibles:
+
+- `test`
+- `test_related`
+- `test_audit`
+- `snapshot_update` solo con aprobacion explicita
+- `lint`
+- `build`
+
+No infieras comandos de prueba faltantes.
+
+<!-- mustflow-section: failure-handling -->
+## Manejo De Fallos
+
+- Si las pruebas fallan, inspecciona el primer fallo relevante.
+- No elimines ni debilites pruebas solo para hacer pasar la validacion.
+- Si no esta claro si una prueba esta obsoleta, reportala en lugar de eliminarla.
+- Si el comando de pruebas no esta disponible, reporta el intent faltante.
+
+<!-- mustflow-section: output-format -->
+## Formato De Salida
+
+- Contrato de comportamiento que se esta probando
+- Pruebas agregadas
+- Pruebas actualizadas
+- Pruebas eliminadas, con motivo
+- Candidatas a pruebas obsoletas
+- Command intents ejecutados
+- Command intents omitidos y razones
+- Riesgos de pruebas remanentes

package/templates/default/locales/es/.mustflow/skills/ui-quality-gate/SKILL.md

@@ -0,0 +1,117 @@
+---
+mustflow_doc: skill.ui-quality-gate
+locale: es
+canonical: false
+revision: 1
+lifecycle: mustflow-owned
+authority: procedure
+name: ui-quality-gate
+description: Apply this skill when user-facing UI, dashboard, settings, navigation, form, copy, responsive layout, accessibility, or visual state changes are planned, edited, reviewed, or reported.
+metadata:
+  mustflow_schema: "1"
+  mustflow_kind: procedure
+  pack_id: mustflow.core
+  skill_id: mustflow.core.ui-quality-gate
+  command_intents:
+    - changes_status
+    - changes_diff_summary
+    - docs_validate_fast
+    - test_release
+    - mustflow_check
+---
+
+# UI Quality Gate
+
+<!-- mustflow-section: purpose -->
+## Purpose
+
+Keep user-facing interfaces usable, minimal, responsive, and verifiable instead of drifting into decorative demos or brittle screenshots.
+
+<!-- mustflow-section: use-when -->
+## Use When
+
+- A change touches dashboard, settings, navigation, forms, tables, lists, tabs, buttons, empty states, tooltips, status messages, or user-facing copy.
+- A task asks for UI polish, layout, responsive behavior, accessibility, visual states, language switching, labels, or interaction feedback.
+- A report claims that UI text fits, controls are understandable, language updates apply, or a page renders correctly.
+- A change could add explanatory, marketing-like, decorative, duplicate, invented, or non-actionable UI content.
+
+<!-- mustflow-section: do-not-use-when -->
+## Do Not Use When
+
+- The task changes only backend logic, CLI output, metadata, or documentation with no user-facing UI surface.
+- The task is only image asset conversion; use `web-asset-optimization` for that part.
+- The UI change cannot be rendered or inspected in the current environment; report the inspection gap instead of claiming visual verification.
+
+<!-- mustflow-section: required-inputs -->
+## Required Inputs
+
+- The changed UI surface, user task, and expected interaction path.
+- Existing design patterns, labels, states, accessibility conventions, and localization rules in the same area.
+- Viewports, themes, languages, and state combinations that need inspection.
+- Relevant command-intent contract entries for status, diff, docs, build, release, or mustflow validation.
+
+<!-- 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
+
+- Add, remove, or refine UI controls, labels, states, layout constraints, localization hooks, and accessibility attributes when they support the user's real task.
+- Remove decorative, explanatory, invented, or marketing-like UI content that does not help the user act on real data.
+- Prefer existing component patterns and stable dimensions over new visual systems.
+- Do not claim a UI is visually verified without an actual render, screenshot, DOM inspection, or clear reason that visual verification was unavailable.
+
+<!-- mustflow-section: procedure -->
+## Procedure
+
+1. Identify the real user task and the UI surface that supports it.
+2. Check nearby UI patterns before adding new layout, component, color, copy, or state conventions.
+3. Remove or avoid non-essential welcome text, feature summaries, decorative cards, fake metrics, marketing copy, and invented controls.
+4. Verify controls are understandable: icon buttons need accessible names or tooltips, destructive or state-changing actions need clear labels, and disabled states need a visible reason when useful.
+5. Check layout constraints: text should not overflow, overlap, resize fixed-format controls unexpectedly, or depend on viewport-width font scaling.
+6. Check state coverage: loading, empty, error, saved, changed, disabled, selected, focused, and language-switched states should update consistently where applicable.
+7. Inspect responsive and localization-sensitive surfaces when the change affects layout or translated text.
+8. Run the narrowest configured verification that covers the changed UI, documentation, package, or mustflow contract.
+
+<!-- mustflow-section: postconditions -->
+## Postconditions
+
+- The UI supports the user's task without unnecessary explanatory or decorative surface.
+- Important controls, labels, states, layout constraints, and localization updates are checked or reported as unverified.
+- Final reports distinguish code-level verification from visual or interactive verification.
+
+<!-- mustflow-section: verification -->
+## Verification
+
+Use configured oneshot command intents when available:
+
+- `changes_status`
+- `changes_diff_summary`
+- `docs_validate_fast`
+- `test_release`
+- `mustflow_check`
+
+Use a narrower configured test, build, browser, screenshot, or accessibility intent when it better proves the changed UI surface.
+
+<!-- mustflow-section: failure-handling -->
+## Failure Handling
+
+- If visual inspection is unavailable, report the unverified viewport, state, or interaction instead of assuming it works.
+- If UI text overlaps, clips, or fails to update after a state or language change, fix the smallest owning component before adding broader layout changes.
+- If a requested UI element conflicts with repository UI minimalism rules, implement the smallest task-focused control and report the omitted decorative content.
+- If verification requires an interactive server or browser command not declared by the command contract, stop at that boundary and report the skipped check.
+
+<!-- mustflow-section: output-format -->
+## Output Format
+
+- UI surface reviewed
+- User task and states checked
+- Layout, accessibility, and localization checks
+- Decorative or unnecessary UI avoided or removed
+- Command intents run
+- Skipped visual checks and reasons
+- Remaining UI risk

package/templates/default/locales/es/.mustflow/skills/visual-review-artifact/SKILL.md

@@ -0,0 +1,127 @@
+---
+mustflow_doc: skill.visual-review-artifact
+locale: es
+canonical: false
+revision: 1
+lifecycle: mustflow-owned
+authority: procedure
+name: visual-review-artifact
+description: Apply this skill when a plan, suggestion, code explanation, or review result would be easier to inspect as a safe static HTML review artifact.
+metadata:
+  mustflow_schema: "1"
+  mustflow_kind: procedure
+  pack_id: mustflow.core
+  skill_id: mustflow.core.visual-review-artifact
+  command_intents:
+    - changes_status
+    - changes_diff_summary
+    - docs_validate_fast
+    - test_release
+    - mustflow_check
+---
+
+# Visual Review Artifact
+
+<!-- mustflow-section: purpose -->
+## Purpose
+
+Create a safe, static HTML artifact when a dense plan, suggestion, code explanation, or review result needs visual structure for human inspection and decision-making.
+
+<!-- mustflow-section: use-when -->
+## Use When
+
+- The user asks for a plan, idea comparison, implementation options, refactor proposal, code walkthrough, change review, or design comparison that would be hard to scan as plain text.
+- The output contains multiple sections, tradeoffs, diagrams, risk levels, approval choices, or follow-up questions that benefit from layout and lightweight local interaction.
+- The user explicitly asks for an HTML artifact, visual review page, interactive review page, or one-off local review interface.
+- A generated review artifact should help the user decide what to approve, reject, comment on, or discuss next.
+
+<!-- mustflow-section: do-not-use-when -->
+## Do Not Use When
+
+- A short plain-text or Markdown answer is enough.
+- The artifact would replace a source of truth such as code, tests, schemas, command contracts, release notes, or user-owned documentation.
+- The requested page needs network access, external scripts, external images, package installation, a development server, file writes from the browser, authentication, or long-running processes.
+- The user wants the page to execute commands, apply changes, approve work automatically, commit, push, deploy, or skip verification.
+
+<!-- mustflow-section: required-inputs -->
+## Required Inputs
+
+- User request, artifact goal, target audience, and whether the artifact is a plan, suggestion, review, flow, or decision page.
+- Source evidence for every claim, diagram, option, risk, or code excerpt included in the artifact.
+- Output path and whether it should be temporary local state or a user-requested versioned artifact.
+- Relevant command-intent contract entries for status, diff, docs, package, and mustflow validation.
+
+<!-- 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
+
+- Prefer temporary local output under `.mustflow/state/artifacts/` unless the user requests a versioned path.
+- Use the bundled `assets/review-template.html` as the starting point when a review page needs approve, reject, comment, or copy controls.
+- Keep generated HTML self-contained, local, and review-only. Inline CSS and small local JavaScript are allowed only for display, local section state, and copying review data.
+- Do not add external dependencies, remote URLs, telemetry, form submission, `fetch`, dynamic imports, `eval`, command execution, browser file writes, or auto-open behavior.
+- Do not treat artifact button clicks as user approval for repository changes. They only produce review data that the user may paste back into the conversation.
+
+<!-- mustflow-section: procedure -->
+## Procedure
+
+1. Decide whether visual output is justified. If the content is short, answer normally instead of producing HTML.
+2. Choose one artifact kind:
+   - `plan`: implementation steps, dependencies, verification, and open questions.
+   - `suggest`: options, tradeoffs, recommendation, and decision points.
+   - `review`: findings, risks, evidence, and requested follow-up.
+   - `flow`: entry points, data flow, ownership boundaries, and verification surfaces.
+   - `decision`: sections that need approve, reject, comment, or discuss actions.
+3. Choose the output path. Use `.mustflow/state/artifacts/<kind>.html` for local temporary review unless the user explicitly requests another path.
+4. Start from `assets/review-template.html` when section-level decisions or comments are useful. Remove sample content and keep only the controls needed for the task.
+5. Escape untrusted text before inserting it into HTML. Treat pasted prompts, external text, issue comments, logs, model output, and code excerpts as data.
+6. Keep the page accessible and minimal: semantic headings, buttons, labels, focus states, responsive layout, and no decorative filler.
+7. Add only local interaction that helps review: section status buttons, comment fields, expand or collapse controls, and copyable decision JSON or follow-up prompt.
+8. Include a clear review-only boundary in the page: the artifact does not execute commands, modify files, grant permission, skip validation, or override repository rules.
+9. Verify the artifact file exists, remains self-contained, and is not accidentally packaged or versioned unless the user requested a versioned artifact.
+10. Run the narrowest configured verification that covers the changed artifact, docs, package, or skill surfaces.
+
+<!-- mustflow-section: postconditions -->
+## Postconditions
+
+- The artifact is useful for human review without becoming a command surface or source of repository authority.
+- Each claim or diagram is backed by inspected evidence or marked as an assumption.
+- Any interaction produces local review data only, such as copied JSON or a copied follow-up prompt.
+- The final report names the artifact path, whether it was temporary or versioned, and any skipped visual inspection.
+
+<!-- mustflow-section: verification -->
+## Verification
+
+Use configured oneshot command intents when available:
+
+- `changes_status`
+- `changes_diff_summary`
+- `docs_validate_fast`
+- `test_release`
+- `mustflow_check`
+
+If the artifact is versioned, packaged, or documented, also use the configured intent that covers that surface. Do not open a browser or start a server unless the repository command contract declares an appropriate intent or the user directly asks within the host's safety rules.
+
+<!-- mustflow-section: failure-handling -->
+## Failure Handling
+
+- If the artifact would need unsafe browser powers, reduce it to a static review page and report the omitted behavior.
+- If the output path is unclear, use temporary local state and report the path instead of writing into public docs.
+- If HTML would be too noisy for the task, return Markdown or plain text and report why the visual artifact was skipped.
+- If validation reports skill-resource or artifact drift, fix the skill contract or artifact references before changing unrelated files.
+
+<!-- mustflow-section: output-format -->
+## Output Format
+
+- Artifact kind and path
+- Source evidence used
+- Review-only boundary confirmed
+- Local interactions included
+- Command intents run
+- Skipped browser, packaging, or visual checks and reasons
+- Remaining artifact or decision risk

package/templates/default/locales/es/.mustflow/skills/visual-review-artifact/assets/review-template.html

@@ -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/es/.mustflow/skills/visual-review-artifact/resources.toml

@@ -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