@rubytech/create-maxy-code 0.1.557 → 0.1.559

package/payload/platform/plugins/admin/mcp/dist/lib/roster-census.d.ts

@@ -0,0 +1,14 @@
+export interface RosterCensusInput {
+    /** `<accountDir>/agents/admin/AGENTS.md` — the admin's routing prose. */
+    agentsMdPath: string;
+    /** `<accountDir>/specialists/agents` — the directory spawn-context reads. */
+    specialistsAgentsDir: string;
+}
+export interface RosterCensusResult {
+    declared: number;
+    dispatchable: number;
+    /** Declared names with no `<name>.md` in the dispatch directory. */
+    orphaned: string[];
+}
+export declare function runRosterCensus(input: RosterCensusInput): RosterCensusResult;
+//# sourceMappingURL=roster-census.d.ts.map

package/payload/platform/plugins/admin/mcp/dist/lib/roster-census.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster-census.d.ts","sourceRoot":"","sources":["../../src/lib/roster-census.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAgB5E"}

package/payload/platform/plugins/admin/mcp/dist/lib/roster-census.js

@@ -0,0 +1,18 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export function runRosterCensus(input) {
+    const body = existsSync(input.agentsMdPath)
+        ? readFileSync(input.agentsMdPath, "utf8")
+        : "";
+    const declared = [];
+    for (const match of body.matchAll(/^- \*\*specialists:([^*]+)\*\*:/gm)) {
+        declared.push(match[1]);
+    }
+    const orphaned = declared.filter((name) => !existsSync(join(input.specialistsAgentsDir, `${name}.md`)));
+    return {
+        declared: declared.length,
+        dispatchable: declared.length - orphaned.length,
+        orphaned,
+    };
+}
+//# sourceMappingURL=roster-census.js.map

package/payload/platform/plugins/admin/mcp/dist/lib/roster-census.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster-census.js","sourceRoot":"","sources":["../../src/lib/roster-census.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA+BjC,MAAM,UAAU,eAAe,CAAC,KAAwB;IACtD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC;QACzC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC;QAC1C,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,mCAAmC,CAAC,EAAE,CAAC;QACvE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC,CACtE,CAAC;IACF,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,YAAY,EAAE,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM;QAC/C,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/admin/skills/platform-architecture/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: platform-architecture
 description: Use when grounding any documented-surface claim about what Maxy ships — plugins, skills, specialists, install/deploy flows, internals. This is the install catalogue, not evidence of what is enabled on the current account. For install state on this account, call `capabilities-here`; for documented surface, cite the `Source:` URL inline.
-content-hash: sha256:954efb55d2fa57e9dcf65b855682a265cc70e1b6739d32bce4a59fcd2b0297c6
+content-hash: sha256:0a9fdc97ea6caba4625dfee58ef5c504befcd1adfef8c892330bf95b3c17c3ee
 brand: maxy-code
 product-name: Maxy
 ---
@@ -2346,6 +2346,48 @@ A 25-component design system (title slides, metric cards, quotes, comparison tab
 
 This is a frozen, vendored copy of the open-source Slides™ framework (MIT). It ships installed and available on every account; enable it per session like any other plugin if it is not already active.
 
+---
+# Making Videos
+Source: https://docs.getmaxy.com/video-production.md
+
+# Making videos
+
+Maxy makes real video files on your own device. No upload, no external service, no subscription. Ask for one in plain words.
+
+> "Make me three social reels about the free trial."
+>
+> "Can I have that in portrait and landscape?"
+>
+> "Record that page playing its animation."
+
+## What you get
+
+An MP4 file, silent, at whatever size you need. Portrait (1080x1920) for stories and reels, landscape (1920x1080) for a website or a presentation, or any other shape you ask for. Each video comes with a poster image, which is the still that shows before someone presses play.
+
+Ask for another shape at any time and the same content is recut for it. You do not have to describe it again.
+
+## Two kinds of video
+
+**Made from scratch.** The agent designs the video itself, in your brand's colours and type, and animates it frame by frame. This is what you want for a social reel, an explainer, or anything with a message to land.
+
+**A recording of a page.** If you already have a page that animates, the agent can record it playing. Useful when the page is the thing you want to show.
+
+## How long it takes
+
+A short reel takes a few minutes. A long recording of a full page can take considerably longer. The agent tells you when it starts and comes back when it is done.
+
+## What to check
+
+The agent looks at four frames from every video it makes before telling you it is finished, so a video that came out blank or with text running off the edge gets caught and re-rendered. You should still watch it. Text that is correct but reads badly is a judgement only you can make.
+
+## Where the files go
+
+Finished videos land in your account's output folder, and the agent sends them to you in the chat. Ask for them on a web page and they get published to your site with everything on one page you can open on a phone.
+
+## Fonts
+
+Videos use the fonts installed on your device. If you want a specific brand font and it has never been used on this device before, say so — it may need installing first.
+
 ---
 # Connectors
 Source: https://docs.getmaxy.com/connectors.md

package/payload/platform/plugins/admin/skills/video-production/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: video-production
+description: >
+  Produce real MP4 video on the device — social reels, animated explainers, motion
+  graphics, and screen recordings of a web page playing its own animation. Renders
+  portrait (1080x1920), landscape (1920x1080) or any size, silent, H.264. Use when
+  asked for a video, a reel, an MP4, an animation, a motion graphic, a screen
+  recording, a social clip, or "can you make that move".
+---
+
+# Video Production
+
+**Invoked from `specialists:content-producer`** when the brief asks for moving picture rather than a still or a document.
+
+The device already has everything this needs: a headless browser and `ffmpeg` with H.264. Nothing is uploaded and no external service is called. The whole pipeline is one script.
+
+## When to use
+
+Activate when the brief wants a **video file**: a social reel, an animated explainer, a motion graphic, a clip of an existing page animating, or a recut of an existing video into another shape.
+
+Do **not** activate for a still image (`image-generate`), a PDF (`a4-print-documents`), a slide deck (`deck-pages`), or a screenshot (`browser-screenshot`). Those have their own skills and their own tools.
+
+## The one command
+
+```
+node "$PLATFORM_ROOT/plugins/admin/skills/video-production/render.mjs" \
+  --mode <reel|page> --target <path|file:|http:> --out <dir> --name <slug> \
+  --width <px> --height <px> [--frames <n>] [--dsf <n>] [--mobile] [--pre '<js>'] [--port 9333]
+```
+
+It resolves the browser, launches its own copy, captures every frame, encodes, writes a poster and four verification stills, tears the browser down and removes the frames. Do not run `ffmpeg` yourself, and do not use the `browser-*` tools for this — they drive the platform's shared browser, whose session you would steal.
+
+| Flag | Meaning |
+|---|---|
+| `--mode` | `reel` for an HTML file you author, `page` for a page that animates itself |
+| `--target` | A file path, a `file:` URL, or an `http:` URL |
+| `--out` | Where the MP4 and poster land |
+| `--name` | Slug for the output files and for `run=` in every log line |
+| `--width` / `--height` | 1080x1920 portrait, 1920x1080 landscape, or anything else |
+| `--frames` | **Required in `page` mode.** Ignored in `reel` mode, which reads `window.__frames` |
+| `--dsf` | Device scale factor. Above 1 renders a small CSS viewport at full output size |
+| `--mobile` | Emulate a mobile viewport, so the page takes its narrow layout |
+| `--pre` | JavaScript run once after load, before capture. Scroll to the animation and start it |
+
+`--name` is a path component, not a label: letters, digits, dot, dash and underscore only. Render one video at a time. Two runs sharing a `--name` delete each other's frames at start, and two sharing a `--port` fight over the same browser — give each its own `--name` and its own `--port` if you must overlap them.
+
+## Choosing the mode
+
+**`reel`** — you author the HTML. It defines `window.__frames` and `window.__seek(i)`, and the driver seeks frame by frame, so the timeline is exact and nothing races. This is the mode for anything designed as a video. Load `references/reel-authoring.md` before writing the file; it carries the contract and the layout traps that cost a re-render last time.
+
+**`page`** — the target is a page that animates on its own, and you want a recording of it. The driver advances Chrome's virtual clock one frame at a time, so the page's own animation is captured frame-accurately rather than at whatever speed the device manages. You must supply `--frames`, because the page does not declare a length.
+
+In `page` mode, serve the site locally and point at `127.0.0.1`, or use a `file:` URL. Navigating to the public https URL times out. Start a server with `python3 -m http.server <port> --bind 127.0.0.1` from the site directory, and stop it when you are done.
+
+Use `--pre` to put the page in its starting state, for example:
+
+```
+--pre 'window.scrollTo(0, document.querySelector(".hero").getBoundingClientRect().top + scrollY - 28); document.getElementById("btnPlay").click()'
+```
+
+## Long renders
+
+A few hundred frames takes minutes and will exceed the two-minute Bash bound. Run it detached and poll for the marker. Never use `sleep` on its own; the harness refuses it.
+
+```bash
+nohup node "$PLATFORM_ROOT/plugins/admin/skills/video-production/render.mjs" \
+  --mode reel --target ./reel.html --out "$OUT" --name reel-1 \
+  --width 1080 --height 1920 > /tmp/reel-1.log 2>&1 &
+```
+
+then
+
+```bash
+until grep -q "op=exit\|op=chromium-missing\|op=frames-missing\|op=capture-failed" /tmp/reel-1.log; do sleep 20; done; tail -20 /tmp/reel-1.log
+```
+
+## Verification is not optional
+
+The driver prints four still paths on its `op=stills` line. **Read all four.** A render can finish, probe clean and still be wrong: a wrapped counter, a clipped headline, a frozen animation. Reading the stills is the only step that catches it, and it is how the last landscape cut was caught wrapping at step 13.
+
+Check three things in the log before you report success:
+
+- `op=capture-done` — `bytesMax` must be clearly larger than `bytesMin`. If they are nearly equal, every frame is identical and the video is frozen, however valid the file.
+- `op=encode` — `wxh` and `codec` are read back from the file, not from the command. Confirm they are what you asked for.
+- `op=exit` — `framesDirRemoved=true`, and the closing `[video-census]` shows `frameDirs=0 chromiumLive=0`.
+
+## Where the files go
+
+Write the MP4 and poster to `<accountDir>/output/<slug>/`. That is the delivery surface: the main session sends from there, and the same file shows in the Artefacts panel.
+
+Never write to a new top-level directory in the account. `fs-schema-guard` refuses anything outside the layout in `SCHEMA.md`, and a blocked write mid-render wastes the whole run.
+
+To put the videos on a page, hand the finished directory to `publish-site`. That skill owns publishing; this one stops at the file.
+
+## When it fails
+
+| Log line | What it means | What to do |
+|---|---|---|
+| `op=chromium-missing` | No browser recorded at `platform/config/chromium-binary.path` | Report it. The install has no browser registered; this is not something to work around with a guessed path |
+| `op=tool-missing tool=ffmpeg` | `ffmpeg` absent | Report it. It is a base install dependency, so its absence is an install fault |
+| `op=frames-missing` | `reel` mode and the page defines no `window.__frames` | Fix the HTML against `references/reel-authoring.md` |
+| `op=navigate-failed` | The page would not load | Check the URL. A public https URL will do this; serve locally instead |
+| `op=capture-failed` | Four screenshot attempts failed at one frame | The browser died mid-run. Check device memory, then re-run |
+| `op=survives-stop alive=true` | The browser outlived teardown | An orphan is holding the port. Report it with the pid from the line |
+
+Every one of these exits non-zero and tears the browser down first. None of them writes a partial MP4.

package/payload/platform/plugins/admin/skills/video-production/__tests__/registration.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# A skill is not shipped when its SKILL.md exists. It is shipped when all four
+# registration surfaces agree, and nothing else in the tree fails when one of
+# them silently disappears. This test is that missing failure.
+#
+# Run: bash platform/plugins/admin/skills/video-production/__tests__/registration.sh
+# Exits 0 when every surface is registered, 1 naming each one that is not.
+
+set -uo pipefail
+
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+PLATFORM="$(cd "$HERE/../../../../.." && pwd -P)"
+
+SLUG="video-production"
+OWNED_TS="$PLATFORM/plugins/admin/mcp/src/content-producer-authoring-skills.ts"
+SKILL_MD="$PLATFORM/plugins/admin/skills/$SLUG/SKILL.md"
+PLUGIN_MD="$PLATFORM/plugins/admin/PLUGIN.md"
+PRODUCER_MD="$PLATFORM/templates/specialists/agents/content-producer.md"
+
+fails=0
+
+check() { # <label> <file> <fixed-string> <why>
+  local label="$1" file="$2" needle="$3" why="$4"
+  if [ ! -f "$file" ]; then
+    echo "FAIL $label — file missing: $file"
+    fails=$((fails + 1))
+    return
+  fi
+  if grep -qF -- "$needle" "$file"; then
+    echo "PASS $label"
+  else
+    echo "FAIL $label — '$needle' absent from $file"
+    echo "     why it matters: $why"
+    fails=$((fails + 1))
+  fi
+}
+
+check "owned-set" "$OWNED_TS" "\"$SLUG\"" \
+  "the admin seat would author this inline instead of dispatching content-producer, and admin-skills-bootstrap.sh would offer it on the admin surface"
+
+check "skill-declaration" "$SKILL_MD" "specialists:content-producer" \
+  "admin-skills-bootstrap.sh reads this exact string; without it the skill is reported as missing-declaration and excluded"
+
+check "plugin-catalogue" "$PLUGIN_MD" "skills/$SLUG/SKILL.md" \
+  "the skill would be absent from the admin plugin's discovery table"
+
+check "producer-branch" "$PRODUCER_MD" "Skill $SLUG" \
+  "content-producer would improvise a pipeline instead of loading the skill — the exact failure this skill exists to prevent"
+
+if [ "$fails" -ne 0 ]; then
+  echo "registration.sh: $fails of 4 surfaces unregistered"
+  exit 1
+fi
+echo "registration.sh: all 4 surfaces registered"

package/payload/platform/plugins/admin/skills/video-production/references/reel-authoring.md

@@ -0,0 +1,83 @@
+# Authoring a reel
+
+A reel is one self-contained HTML file that draws a single frame on demand. The driver never waits for it, never races it, and never guesses how long it runs. The file tells the driver both things itself.
+
+## The two globals
+
+```js
+window.__frames = 512;              // an integer: how many frames exist
+window.__seek = function (f) { ... }; // paint frame f, synchronously
+```
+
+`__seek(f)` must paint frame `f` from the index alone. Given the same `f` it must always produce the same picture, whatever came before it.
+
+That rules out three things:
+
+- `requestAnimationFrame`, `setTimeout`, `setInterval`, or anything else that waits.
+- CSS `transition` and `animation`. Both advance on wall-clock time, which the driver has stopped.
+- State carried between calls. A counter that increments each time `__seek` runs makes the output depend on capture order.
+
+Compute every visual property from `f`. The driver seeks, screenshots, seeks, screenshots. Nothing moves in between.
+
+Call `window.__seek(0)` once at the end of your script, so the page is not blank before the driver starts.
+
+## The shape that works
+
+The reels that shipped used a cut list, a running start table, and a total:
+
+```js
+var CUTS = [
+  // [frames, kicker, headline, line, railIndex]
+  [42, "",            "One workflow",      "From the first click to the day they decide.", -1],
+  [72, "Moment one",  "The form",          "Short on purpose. A few questions, then a booking link.", 0],
+  [72, "Moment two",  "The meeting",       "Why, what, when, who, where, how.", 1]
+];
+var OUTRO = 100;
+var starts = [], t = 0;
+CUTS.forEach(function (c) { starts.push(t); t += c[0]; });
+window.__frames = t + OUTRO;
+```
+
+`__seek(f)` then finds the current cut by walking `starts`, computes `local = f - starts[k]`, and drives every animated property off `local` and `frac = local / c[0]`.
+
+Easing is a pure function of a fraction, so it stays deterministic:
+
+```js
+function ease(t) { return t < 0 ? 0 : t > 1 ? 1 : 1 - Math.pow(1 - t, 3); }
+```
+
+A two-frame flash on each cut is `local < 2`. A wipe is `width = Math.min(1, frac * 2.2) * 420 + "px"`. A fade-in over the first seven frames is `ease(Math.min(1, local / 7))`.
+
+## At 30 frames a second
+
+The driver encodes at 30 fps, so frame counts are durations: 42 frames is 1.4 seconds, 72 is 2.4, 512 is just over 17. Write the cut list in frames and read it as time.
+
+## Layout traps
+
+These all bit the reels that shipped.
+
+**Size the counter for its largest value, not its first.** A step counter laid out against "Step 1 of 13" wrapped when it reached 13, and the landscape cut had to be rendered twice. Set the widest string you will ever show, then check it.
+
+**Headlines need a size class.** At 1080 wide, a headline over about 14 characters overflows at the display size. The shipped reels dropped from 132px to 104px on the long ones:
+
+```js
+big.className = c[2].length > 14 ? "small" : "";
+```
+
+**Fix the page to the output size.** `html, body { width: 1080px; height: 1920px; overflow: hidden }`. Any scrollbar or overflow shows up in every frame.
+
+**Landscape is not portrait with different numbers.** A 1920x1080 recut needs its own type sizes and its own line breaks. Re-check the counter and the headline class after the swap.
+
+## Fonts
+
+The reel renders with whatever the device has installed. Check first:
+
+```bash
+fc-list : family | tr ',' '\n' | sort -u | grep -iE 'archivo|inter'
+```
+
+The shipped reels used Archivo and Inter because both were present on that device. Always give a real fallback stack (`'Archivo', system-ui, sans-serif`) so a missing font degrades instead of breaking the layout. A font that is absent will not be fetched: the driver blocks background networking.
+
+## Checking before you commit to a full render
+
+A 512-frame render takes a while. Render a short probe first by temporarily lowering `__frames`, read the stills, then restore it.