@1agh/maude 0.20.0 → 0.22.0

package/plugins/design/templates/_shell.html

@@ -85,7 +85,12 @@
           "react/jsx-dev-runtime": "/_canvas-runtime/react_jsx-dev-runtime.js",
           "pixi.js": "/_canvas-runtime/pixi-js.js",
           "motion": "/_canvas-runtime/motion.js",
-          "motion/react": "/_canvas-runtime/motion_react.js"
+          "motion/react": "/_canvas-runtime/motion_react.js",
+          "yjs": "/_canvas-runtime/yjs.js",
+          "y-protocols/sync": "/_canvas-runtime/y-protocols_sync.js",
+          "y-protocols/awareness": "/_canvas-runtime/y-protocols_awareness.js",
+          "lib0/decoding": "/_canvas-runtime/lib0_decoding.js",
+          "lib0/encoding": "/_canvas-runtime/lib0_encoding.js"
         }
       }
     </script>
@@ -153,6 +158,32 @@
               if (msg.mode === 'hard' || !msg.file || (canvasRel && msg.file === canvasRel)) {
                 location.reload();
               }
+            } else if (msg.mode === 'meta') {
+              // Phase 8 — canvas-meta sidecar changed. Filter to our own canvas:
+              // `<canvasRel>.meta.json` strip → must equal canvasRel without ext.
+              if (!canvasRel || !msg.file) return;
+              const metaBase = msg.file.replace(/\.meta\.json$/i, '');
+              const myBase = canvasRel.replace(/\.(tsx|html)$/i, '');
+              if (metaBase !== myBase) return;
+              // Echo guard — when WE just PATCHed the meta, skip the round-trip.
+              const lastSelf = (window).__maude_last_meta_self_write_at || 0;
+              if (Date.now() - lastSelf < 2000) return;
+              // Re-fetch + broadcast to the canvas via window event. canvas-lib
+              // listens for `maude:meta-refreshed` and re-applies layout +
+              // viewport in-place (no full reload — preserves tool / undo state).
+              const metaFileParam = encodeURIComponent(designRel + '/' + canvasRel);
+              fetch('/_api/canvas-meta?file=' + metaFileParam, {
+                headers: { 'Cache-Control': 'no-store' },
+              })
+                .then((r) => (r.ok ? r.json() : null))
+                .then((j) => {
+                  if (!j || typeof j !== 'object') return;
+                  window.__canvas_meta__ = j;
+                  document.dispatchEvent(new CustomEvent('maude:meta-refreshed', { detail: j }));
+                })
+                .catch(() => {
+                  /* network blip — next interaction will retry */
+                });
             }
           } catch (e) {
             console.warn('[canvas-shell] HMR message parse error', e);
@@ -185,6 +216,11 @@
         // The fetch runs in parallel with imports; failure is non-fatal (the
         // canvas falls through to default grid + fit-to-screen).
         const metaFileParam = encodeURIComponent(designRel + '/' + canvasRel);
+        // Phase 8 — expose designRel + canvasRel-without-prefix on window so
+        // collab-slug derivation can strip the prefix consistently with
+        // server-side api.fileSlug (which trims paths.designRel).
+        window.__canvas_design_rel__ = designRel;
+        window.__canvas_rel__ = canvasRel;
         const metaFetch = fetch('/_api/canvas-meta?file=' + metaFileParam, {
           headers: { 'Cache-Control': 'no-store' },
         })

package/plugins/flow/.claude-plugin/config.schema.json

@@ -6,6 +6,10 @@
   "additionalProperties": false,
   "required": ["name"],
   "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Pointer to this schema (editor support). Stripped at consumption time."
+    },
     "name": {
       "type": "string",
       "description": "Short project / product name. Resolves the `<project>` placeholder in commands and file paths (e.g. `.ai/<project>-prd.md` → `.ai/<name>-prd.md`)."
@@ -304,6 +308,14 @@
         }
       }
     },
+    "quality": {
+      "type": "object",
+      "description": "Map of gate name → shell command string. Gate names are free-form (conventional names: `lint`, `format`, `typecheck`, `tests`, `build`). Each command is executed as-is via `eval` by the slash command that consumes the gate. Missing gate → slash command emits a one-line warning and skips (never fabricates a command). v1 deliberately keeps this a flat string map — no per-gate object shape, no `order`, no `scope`. Populate via `maude doctor --fix`, which detects from `package.json` scripts + tool presence. Existing user values are never overwritten — additions only.",
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
     "integrations": {
       "type": "object",
       "additionalProperties": false,

package/plugins/flow/dependencies.json

@@ -0,0 +1,143 @@
+{
+  "$schema": "./dependencies.schema.json",
+  "version": "1",
+  "plugin": "flow",
+  "dependencies": [
+    {
+      "id": "node",
+      "type": "cli",
+      "hardness": "hard",
+      "check": {
+        "command": "node --version",
+        "expectExit": 0,
+        "minVersion": "20.0.0"
+      },
+      "install": {
+        "preferred": "https://nodejs.org/en/download",
+        "darwin": "brew install node@22"
+      },
+      "autoInstall": false,
+      "usedBy": ["commands/init.md"],
+      "docsUrl": "https://nodejs.org"
+    },
+    {
+      "id": "git",
+      "type": "cli",
+      "hardness": "hard",
+      "check": {
+        "command": "git --version",
+        "expectExit": 0
+      },
+      "install": {
+        "darwin": "brew install git",
+        "linux": "apt-get install -y git || dnf install -y git"
+      },
+      "autoInstall": false,
+      "usedBy": ["commands/init.md", "commands/done.md", "commands/quick.md"],
+      "docsUrl": "https://git-scm.com"
+    },
+    {
+      "id": "maude",
+      "type": "cli",
+      "hardness": "soft",
+      "check": {
+        "command": "maude --version",
+        "expectExit": 0
+      },
+      "install": {
+        "preferred": "npm i -g @1agh/maude"
+      },
+      "autoInstall": false,
+      "fallbackBehavior": "/flow:init and /flow:done work without maude CLI but cannot read/write workflows.config.json via `maude config`.",
+      "usedBy": ["commands/init.md"],
+      "docsUrl": "https://github.com/1aGh/maude"
+    },
+    {
+      "id": "agent-browser",
+      "type": "cli",
+      "hardness": "soft",
+      "check": {
+        "command": "agent-browser --version",
+        "expectExit": 0
+      },
+      "install": {
+        "preferred": "npm i -g @anthropic-ai/agent-browser"
+      },
+      "autoInstall": true,
+      "fallbackBehavior": "/flow:scenario and a11y-auditor degrade to screenshot-less reports. Web scenarios cannot run.",
+      "usedBy": [
+        "commands/scenario.md",
+        "commands/validate.md",
+        "commands/utils-verify.md",
+        "agents/scenario-runner.md",
+        "agents/a11y-auditor.md",
+        "skills/agent-browser/SKILL.md"
+      ],
+      "docsUrl": "https://github.com/anthropics/agent-browser"
+    },
+    {
+      "id": "agent-device",
+      "type": "cli",
+      "hardness": "soft",
+      "check": {
+        "command": "agent-device --version",
+        "expectExit": 0
+      },
+      "install": {
+        "preferred": "Requires Xcode + Android SDK. See agent-device docs."
+      },
+      "autoInstall": false,
+      "fallbackBehavior": "/flow:scenario skips native (iOS/Android) variants. Web variants still run via agent-browser.",
+      "usedBy": [
+        "commands/scenario.md",
+        "agents/scenario-runner.md",
+        "skills/agent-device/SKILL.md"
+      ],
+      "docsUrl": "https://github.com/anthropics/agent-device"
+    },
+    {
+      "id": "jq",
+      "type": "system-tool",
+      "hardness": "soft",
+      "check": {
+        "command": "jq --version",
+        "expectExit": 0
+      },
+      "install": {
+        "darwin": "brew install jq",
+        "linux": "apt-get install -y jq || dnf install -y jq",
+        "win32": "winget install jqlang.jq"
+      },
+      "autoInstall": false,
+      "fallbackBehavior": "Slash commands' bash blocks that read .ai/workflows.config.json via jq cannot run. /flow:validate and /flow:utils-verify quality gates need this.",
+      "usedBy": [
+        "commands/validate.md",
+        "commands/utils-verify.md",
+        "commands/quick.md",
+        "commands/done.md"
+      ]
+    },
+    {
+      "id": "askuserquestion-mcp",
+      "type": "mcp",
+      "hardness": "soft",
+      "check": {
+        "mcp": "AskUserQuestion",
+        "tool": "ask"
+      },
+      "fallbackBehavior": "Question prompts fall back to numbered-prose chat. No multi-select UI.",
+      "usedBy": ["skills/question-protocol/SKILL.md"]
+    },
+    {
+      "id": "terminal-skills-mcp",
+      "type": "mcp",
+      "hardness": "soft",
+      "check": {
+        "mcp": "terminal-skills",
+        "tool": "search_skills"
+      },
+      "fallbackBehavior": "skill-loader falls back to built-in plugin skills → matching agents → WebFetch on library docs.",
+      "usedBy": ["skills/skill-loader/SKILL.md"]
+    }
+  ]
+}

package/plugins/flow/dependencies.schema.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "maude plugin — runtime dependency manifest",
+  "description": "Declares CLI binaries, MCP servers, and runtime packages the plugin's commands / agents / skills shell out to. Consumed by maude doctor (cli/commands/doctor.mjs) and preflight.sh / preflight.mjs. Schema is shared between plugins — each plugin ships its own dependencies.json + (symlink to) this schema.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "plugin", "dependencies"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "1",
+      "description": "Manifest schema version. Bumped when the dependency entry shape changes incompatibly."
+    },
+    "plugin": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Plugin name (matches plugins/<plugin>/.claude-plugin/plugin.json `name`)."
+    },
+    "dependencies": {
+      "type": "array",
+      "minItems": 0,
+      "items": { "$ref": "#/$defs/Dependency" }
+    }
+  },
+  "$defs": {
+    "Dependency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "type", "hardness", "check"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9._-]*$",
+          "description": "Unique identifier within the manifest. Lowercase, hyphenated."
+        },
+        "type": {
+          "type": "string",
+          "enum": ["cli", "mcp", "node-package", "bun-package", "system-tool"],
+          "description": "What kind of dependency. `cli` = on PATH; `mcp` = MCP server / tool; `node-package` / `bun-package` = installed via npm/bun; `system-tool` = OS-provided (curl, jq)."
+        },
+        "hardness": {
+          "type": "string",
+          "enum": ["hard", "soft"],
+          "description": "`hard` = missing blocks plugin use; `soft` = graceful degradation possible (fallback path, warning only)."
+        },
+        "check": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "How to detect presence. For CLI/system-tool/package: shell command + expected exit. For MCP: tool name to probe.",
+          "properties": {
+            "command": {
+              "type": "string",
+              "description": "Shell command executed via `bash -c`. Pipes allowed. Defaults to `<id> --version`."
+            },
+            "expectExit": {
+              "type": "integer",
+              "default": 0,
+              "description": "Expected exit code. Anything else = missing/broken."
+            },
+            "minVersion": {
+              "type": "string",
+              "description": "Minimum semver. Comparator extracts `vX.Y.Z` from check.command stdout."
+            },
+            "mcp": {
+              "type": "string",
+              "description": "MCP server name. For type=mcp only."
+            },
+            "tool": {
+              "type": "string",
+              "description": "Specific tool name on the MCP server. For type=mcp only."
+            }
+          }
+        },
+        "install": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Install commands per platform. `preferred` is OS-agnostic / fallback; per-platform keys override.",
+          "properties": {
+            "preferred": { "type": "string" },
+            "darwin": { "type": "string" },
+            "linux": { "type": "string" },
+            "win32": { "type": "string" }
+          }
+        },
+        "autoInstall": {
+          "type": "boolean",
+          "default": false,
+          "description": "If true, `maude doctor --fix` may run install.preferred after per-dep confirmation prompt."
+        },
+        "fallbackBehavior": {
+          "type": "string",
+          "description": "What the plugin does when this soft dep is missing. Human-readable; surfaces in maude doctor's report."
+        },
+        "usedBy": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Repo-relative paths (or path globs) of plugin files that reference this dependency. Aids debugging — doctor surfaces this when explaining a miss."
+        },
+        "docsUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Where to read more."
+        }
+      }
+    }
+  }
+}