@officexapp/vidfarm-devcli 0.21.54 → 0.21.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@officexapp/vidfarm-devcli",
-  "version": "0.21.54",
+  "version": "0.21.56",
   "description": "Local bridge for the Vidfarm Trackpad Editor. `vidfarm serve <template_id>` boots the FULL editor on localhost (disk-backed records/storage, free in-process render); edit composition.html on disk (Claude Code, Codex, etc.) and the browser live-morphs it.",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
     "dist/src/devcli/captions.js",
     "dist/src/devcli/clip-store.js",
     "dist/src/devcli/clips.js",
+    "dist/src/devcli/clipper-run.js",
     "dist/src/devcli/composition-edit.js",
     "dist/src/devcli/consult.js",
     "dist/src/devcli/cost-mode.js",
@@ -45,6 +46,7 @@
     "dist/src/devcli/stills.js",
     "dist/src/devcli/storyboard.js",
     "dist/src/devcli/telemetry.js",
+    "dist/src/devcli/update-check.js",
     "dist/src/devcli/timeline-edit.js",
     "dist/src/devcli/transitions.js",
     "dist/src/hyperframes/composition.js",
@@ -111,6 +113,8 @@
     "test:clips": "node --import tsx --test test/clip-curation.test.ts",
     "test:social-download": "node --import tsx --test test/video-download-media.test.ts test/social-download-lookup.test.ts",
     "test:qa": "node --import tsx --test test/qa-check.test.ts",
+    "test:clipper-run": "node --import tsx --test test/clipper-run.test.ts",
+    "test:update-check": "node --import tsx --test test/update-check.test.ts",
     "test:studio-brand": "node --import tsx --test test/studio-brand.test.ts",
     "test:stickers": "node --import tsx --test test/sticker-pack.test.ts test/plate-key.test.ts",
     "test:social-recycle": "node --import tsx --test test/social-recycle.test.ts",
@@ -122,7 +126,7 @@
     "test:consult": "node --import tsx --test test/consult.test.ts",
     "test:agent-imagegen": "node --import tsx --test test/agent-imagegen.test.ts",
     "test:social-meta": "node --import tsx --test test/social-meta.test.ts",
-    "check:skills": "node scripts/build-director-skill-rollup.mjs --check && node scripts/check-skill-routes.mjs && node scripts/check-skill-nav.mjs",
+    "check:skills": "node scripts/sync-skill-version.mjs --check && node scripts/build-director-skill-rollup.mjs --check && node scripts/check-skill-routes.mjs && node scripts/check-skill-nav.mjs",
     "benchmark:editor-chat": "node --import tsx scripts/benchmark-editor-chat-harness.mjs",
     "cdk:deploy:prod-serverless": "npm run build && dotenv -e .env.production -- npx aws-cdk deploy --app 'node dist/infra/cdk/bin/vidfarm-prod.js'",
     "cdk:synth:staging-serverless": "npm run build && dotenv -e .env.staging -- npx aws-cdk synth --app 'node dist/infra/cdk/bin/vidfarm-serverless-staging.js'",

package/public/serve-shells/editor.html

@@ -348,6 +348,33 @@
   transition:opacity var(--rk-dur) var(--rk-ease),background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease)}
 .rk-aichat-frow:hover .rk-dir-kebab,.rk-dir-kebab:focus-visible{opacity:1}
 .rk-dir-kebab:hover{background:var(--rk-n-100);color:var(--rk-ink);border-color:var(--rk-border)}
+/* vector-note badge — the "does this thing say what it is?" signal. Always
+   visible (a missing note must read as a gap, not as nothing). */
+.rk-dir-note{flex:none;font-family:inherit;font-size:11px;font-weight:800;line-height:1;cursor:pointer;
+  padding:5px 8px;border-radius:999px;white-space:nowrap;max-width:120px;overflow:hidden;text-overflow:ellipsis;
+  transition:background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease),color var(--rk-dur) var(--rk-ease)}
+.rk-dir-note.is-empty{border:1px dashed var(--rk-border-strong,#d9d2c6);background:transparent;color:var(--rk-n-500,#8b8377)}
+.rk-dir-note.is-empty:hover{border-color:var(--rk-gold-600,#d99e00);color:var(--rk-gold-700,#a16207);background:var(--rk-gold-tint,#fff7e0)}
+.rk-dir-note.is-set{border:1px solid transparent;background:var(--rk-gold-tint,#fff7e0);color:var(--rk-gold-700,#a16207)}
+.rk-dir-note.is-set:hover{border-color:var(--rk-gold-600,#d99e00)}
+/* the note popover (body-appended, plain colors for portability) */
+.rk-dir-notepanel{position:fixed;z-index:2147483000;width:min(360px,calc(100vw - 24px));background:#fff;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-lg,12px);
+  box-shadow:var(--rk-shadow-md,0 10px 30px rgba(40,30,10,.16));padding:12px;display:grid;gap:8px}
+.rk-dir-notehead{font-size:12.5px;font-weight:800;color:var(--rk-ink,#2b2620);overflow-wrap:anywhere}
+.rk-dir-notehint{font-size:11.5px;line-height:1.45;color:var(--rk-text-muted,#78716c)}
+.rk-dir-notearea{font-family:inherit;font-size:12.5px;line-height:1.5;color:var(--rk-ink,#2b2620);width:100%;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-md,8px);padding:8px 9px;resize:vertical;background:#fff}
+.rk-dir-notearea:focus{outline:none;border-color:var(--rk-gold-600,#d99e00)}
+.rk-dir-notearea[readonly]{background:var(--rk-n-100,#f2efe9);color:var(--rk-text-muted,#78716c)}
+.rk-dir-notefoot{display:flex;align-items:center;gap:8px}
+.rk-dir-notestatus{flex:1;font-size:11px;font-weight:700;color:var(--rk-text-muted,#78716c);overflow-wrap:anywhere}
+.rk-dir-notestatus.is-ok{color:#2f7d32}
+.rk-dir-notestatus.is-err{color:#b4341f}
+.rk-dir-notebtn{font-family:inherit;font-size:12px;font-weight:800;cursor:pointer;border-radius:999px;padding:7px 13px;
+  border:1px solid transparent;background:var(--rk-gold-500,#fcb900);color:var(--rk-ink,#2b2620)}
+.rk-dir-notebtn:disabled{opacity:.6;cursor:default}
+.rk-dir-notebtn.is-ghost{background:transparent;border-color:var(--rk-border,#e6e1d8);color:var(--rk-text-muted,#78716c)}
 /* kebab popup + copy toast (appended to <body>, so plain colors not tokens for
    portability onto any host page) */
 .rk-dir-menu{position:fixed;z-index:2147483000;min-width:150px;background:#fff;border:1px solid var(--rk-border,#e6e1d8);

package/public/serve-shells/library-files.html

@@ -363,6 +363,33 @@
   transition:opacity var(--rk-dur) var(--rk-ease),background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease)}
 .rk-aichat-frow:hover .rk-dir-kebab,.rk-dir-kebab:focus-visible{opacity:1}
 .rk-dir-kebab:hover{background:var(--rk-n-100);color:var(--rk-ink);border-color:var(--rk-border)}
+/* vector-note badge — the "does this thing say what it is?" signal. Always
+   visible (a missing note must read as a gap, not as nothing). */
+.rk-dir-note{flex:none;font-family:inherit;font-size:11px;font-weight:800;line-height:1;cursor:pointer;
+  padding:5px 8px;border-radius:999px;white-space:nowrap;max-width:120px;overflow:hidden;text-overflow:ellipsis;
+  transition:background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease),color var(--rk-dur) var(--rk-ease)}
+.rk-dir-note.is-empty{border:1px dashed var(--rk-border-strong,#d9d2c6);background:transparent;color:var(--rk-n-500,#8b8377)}
+.rk-dir-note.is-empty:hover{border-color:var(--rk-gold-600,#d99e00);color:var(--rk-gold-700,#a16207);background:var(--rk-gold-tint,#fff7e0)}
+.rk-dir-note.is-set{border:1px solid transparent;background:var(--rk-gold-tint,#fff7e0);color:var(--rk-gold-700,#a16207)}
+.rk-dir-note.is-set:hover{border-color:var(--rk-gold-600,#d99e00)}
+/* the note popover (body-appended, plain colors for portability) */
+.rk-dir-notepanel{position:fixed;z-index:2147483000;width:min(360px,calc(100vw - 24px));background:#fff;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-lg,12px);
+  box-shadow:var(--rk-shadow-md,0 10px 30px rgba(40,30,10,.16));padding:12px;display:grid;gap:8px}
+.rk-dir-notehead{font-size:12.5px;font-weight:800;color:var(--rk-ink,#2b2620);overflow-wrap:anywhere}
+.rk-dir-notehint{font-size:11.5px;line-height:1.45;color:var(--rk-text-muted,#78716c)}
+.rk-dir-notearea{font-family:inherit;font-size:12.5px;line-height:1.5;color:var(--rk-ink,#2b2620);width:100%;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-md,8px);padding:8px 9px;resize:vertical;background:#fff}
+.rk-dir-notearea:focus{outline:none;border-color:var(--rk-gold-600,#d99e00)}
+.rk-dir-notearea[readonly]{background:var(--rk-n-100,#f2efe9);color:var(--rk-text-muted,#78716c)}
+.rk-dir-notefoot{display:flex;align-items:center;gap:8px}
+.rk-dir-notestatus{flex:1;font-size:11px;font-weight:700;color:var(--rk-text-muted,#78716c);overflow-wrap:anywhere}
+.rk-dir-notestatus.is-ok{color:#2f7d32}
+.rk-dir-notestatus.is-err{color:#b4341f}
+.rk-dir-notebtn{font-family:inherit;font-size:12px;font-weight:800;cursor:pointer;border-radius:999px;padding:7px 13px;
+  border:1px solid transparent;background:var(--rk-gold-500,#fcb900);color:var(--rk-ink,#2b2620)}
+.rk-dir-notebtn:disabled{opacity:.6;cursor:default}
+.rk-dir-notebtn.is-ghost{background:transparent;border-color:var(--rk-border,#e6e1d8);color:var(--rk-text-muted,#78716c)}
 /* kebab popup + copy toast (appended to <body>, so plain colors not tokens for
    portability onto any host page) */
 .rk-dir-menu{position:fixed;z-index:2147483000;min-width:150px;background:#fff;border:1px solid var(--rk-border,#e6e1d8);
@@ -1523,7 +1550,7 @@ button.rk-clips-thumb{appearance:none;-webkit-appearance:none;border:0;margin:0;
   </div>
 
   <div class="rk-files-explorer">
-    <div data-rk-directory data-mode="standalone" data-show-upload="true" data-upload-placement="toolbar" data-show-multiselect="true" data-primary-click="preview" data-enable-shares="true"></div>
+    <div data-rk-directory data-mode="standalone" data-show-upload="true" data-upload-placement="toolbar" data-show-multiselect="true" data-primary-click="preview" data-enable-shares="true" data-url-base="/library" data-url-root="/library/files"></div>
   </div>
 </main>
 

package/public/serve-shells/library-raws.html

@@ -363,6 +363,33 @@
   transition:opacity var(--rk-dur) var(--rk-ease),background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease)}
 .rk-aichat-frow:hover .rk-dir-kebab,.rk-dir-kebab:focus-visible{opacity:1}
 .rk-dir-kebab:hover{background:var(--rk-n-100);color:var(--rk-ink);border-color:var(--rk-border)}
+/* vector-note badge — the "does this thing say what it is?" signal. Always
+   visible (a missing note must read as a gap, not as nothing). */
+.rk-dir-note{flex:none;font-family:inherit;font-size:11px;font-weight:800;line-height:1;cursor:pointer;
+  padding:5px 8px;border-radius:999px;white-space:nowrap;max-width:120px;overflow:hidden;text-overflow:ellipsis;
+  transition:background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease),color var(--rk-dur) var(--rk-ease)}
+.rk-dir-note.is-empty{border:1px dashed var(--rk-border-strong,#d9d2c6);background:transparent;color:var(--rk-n-500,#8b8377)}
+.rk-dir-note.is-empty:hover{border-color:var(--rk-gold-600,#d99e00);color:var(--rk-gold-700,#a16207);background:var(--rk-gold-tint,#fff7e0)}
+.rk-dir-note.is-set{border:1px solid transparent;background:var(--rk-gold-tint,#fff7e0);color:var(--rk-gold-700,#a16207)}
+.rk-dir-note.is-set:hover{border-color:var(--rk-gold-600,#d99e00)}
+/* the note popover (body-appended, plain colors for portability) */
+.rk-dir-notepanel{position:fixed;z-index:2147483000;width:min(360px,calc(100vw - 24px));background:#fff;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-lg,12px);
+  box-shadow:var(--rk-shadow-md,0 10px 30px rgba(40,30,10,.16));padding:12px;display:grid;gap:8px}
+.rk-dir-notehead{font-size:12.5px;font-weight:800;color:var(--rk-ink,#2b2620);overflow-wrap:anywhere}
+.rk-dir-notehint{font-size:11.5px;line-height:1.45;color:var(--rk-text-muted,#78716c)}
+.rk-dir-notearea{font-family:inherit;font-size:12.5px;line-height:1.5;color:var(--rk-ink,#2b2620);width:100%;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-md,8px);padding:8px 9px;resize:vertical;background:#fff}
+.rk-dir-notearea:focus{outline:none;border-color:var(--rk-gold-600,#d99e00)}
+.rk-dir-notearea[readonly]{background:var(--rk-n-100,#f2efe9);color:var(--rk-text-muted,#78716c)}
+.rk-dir-notefoot{display:flex;align-items:center;gap:8px}
+.rk-dir-notestatus{flex:1;font-size:11px;font-weight:700;color:var(--rk-text-muted,#78716c);overflow-wrap:anywhere}
+.rk-dir-notestatus.is-ok{color:#2f7d32}
+.rk-dir-notestatus.is-err{color:#b4341f}
+.rk-dir-notebtn{font-family:inherit;font-size:12px;font-weight:800;cursor:pointer;border-radius:999px;padding:7px 13px;
+  border:1px solid transparent;background:var(--rk-gold-500,#fcb900);color:var(--rk-ink,#2b2620)}
+.rk-dir-notebtn:disabled{opacity:.6;cursor:default}
+.rk-dir-notebtn.is-ghost{background:transparent;border-color:var(--rk-border,#e6e1d8);color:var(--rk-text-muted,#78716c)}
 /* kebab popup + copy toast (appended to <body>, so plain colors not tokens for
    portability onto any host page) */
 .rk-dir-menu{position:fixed;z-index:2147483000;min-width:150px;background:#fff;border:1px solid var(--rk-border,#e6e1d8);

package/public/serve-shells/tools-clipper.html

@@ -363,6 +363,33 @@
   transition:opacity var(--rk-dur) var(--rk-ease),background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease)}
 .rk-aichat-frow:hover .rk-dir-kebab,.rk-dir-kebab:focus-visible{opacity:1}
 .rk-dir-kebab:hover{background:var(--rk-n-100);color:var(--rk-ink);border-color:var(--rk-border)}
+/* vector-note badge — the "does this thing say what it is?" signal. Always
+   visible (a missing note must read as a gap, not as nothing). */
+.rk-dir-note{flex:none;font-family:inherit;font-size:11px;font-weight:800;line-height:1;cursor:pointer;
+  padding:5px 8px;border-radius:999px;white-space:nowrap;max-width:120px;overflow:hidden;text-overflow:ellipsis;
+  transition:background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease),color var(--rk-dur) var(--rk-ease)}
+.rk-dir-note.is-empty{border:1px dashed var(--rk-border-strong,#d9d2c6);background:transparent;color:var(--rk-n-500,#8b8377)}
+.rk-dir-note.is-empty:hover{border-color:var(--rk-gold-600,#d99e00);color:var(--rk-gold-700,#a16207);background:var(--rk-gold-tint,#fff7e0)}
+.rk-dir-note.is-set{border:1px solid transparent;background:var(--rk-gold-tint,#fff7e0);color:var(--rk-gold-700,#a16207)}
+.rk-dir-note.is-set:hover{border-color:var(--rk-gold-600,#d99e00)}
+/* the note popover (body-appended, plain colors for portability) */
+.rk-dir-notepanel{position:fixed;z-index:2147483000;width:min(360px,calc(100vw - 24px));background:#fff;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-lg,12px);
+  box-shadow:var(--rk-shadow-md,0 10px 30px rgba(40,30,10,.16));padding:12px;display:grid;gap:8px}
+.rk-dir-notehead{font-size:12.5px;font-weight:800;color:var(--rk-ink,#2b2620);overflow-wrap:anywhere}
+.rk-dir-notehint{font-size:11.5px;line-height:1.45;color:var(--rk-text-muted,#78716c)}
+.rk-dir-notearea{font-family:inherit;font-size:12.5px;line-height:1.5;color:var(--rk-ink,#2b2620);width:100%;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-md,8px);padding:8px 9px;resize:vertical;background:#fff}
+.rk-dir-notearea:focus{outline:none;border-color:var(--rk-gold-600,#d99e00)}
+.rk-dir-notearea[readonly]{background:var(--rk-n-100,#f2efe9);color:var(--rk-text-muted,#78716c)}
+.rk-dir-notefoot{display:flex;align-items:center;gap:8px}
+.rk-dir-notestatus{flex:1;font-size:11px;font-weight:700;color:var(--rk-text-muted,#78716c);overflow-wrap:anywhere}
+.rk-dir-notestatus.is-ok{color:#2f7d32}
+.rk-dir-notestatus.is-err{color:#b4341f}
+.rk-dir-notebtn{font-family:inherit;font-size:12px;font-weight:800;cursor:pointer;border-radius:999px;padding:7px 13px;
+  border:1px solid transparent;background:var(--rk-gold-500,#fcb900);color:var(--rk-ink,#2b2620)}
+.rk-dir-notebtn:disabled{opacity:.6;cursor:default}
+.rk-dir-notebtn.is-ghost{background:transparent;border-color:var(--rk-border,#e6e1d8);color:var(--rk-text-muted,#78716c)}
 /* kebab popup + copy toast (appended to <body>, so plain colors not tokens for
    portability onto any host page) */
 .rk-dir-menu{position:fixed;z-index:2147483000;min-width:150px;background:#fff;border:1px solid var(--rk-border,#e6e1d8);

package/public/serve-shells/tools-image.html

@@ -363,6 +363,33 @@
   transition:opacity var(--rk-dur) var(--rk-ease),background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease)}
 .rk-aichat-frow:hover .rk-dir-kebab,.rk-dir-kebab:focus-visible{opacity:1}
 .rk-dir-kebab:hover{background:var(--rk-n-100);color:var(--rk-ink);border-color:var(--rk-border)}
+/* vector-note badge — the "does this thing say what it is?" signal. Always
+   visible (a missing note must read as a gap, not as nothing). */
+.rk-dir-note{flex:none;font-family:inherit;font-size:11px;font-weight:800;line-height:1;cursor:pointer;
+  padding:5px 8px;border-radius:999px;white-space:nowrap;max-width:120px;overflow:hidden;text-overflow:ellipsis;
+  transition:background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease),color var(--rk-dur) var(--rk-ease)}
+.rk-dir-note.is-empty{border:1px dashed var(--rk-border-strong,#d9d2c6);background:transparent;color:var(--rk-n-500,#8b8377)}
+.rk-dir-note.is-empty:hover{border-color:var(--rk-gold-600,#d99e00);color:var(--rk-gold-700,#a16207);background:var(--rk-gold-tint,#fff7e0)}
+.rk-dir-note.is-set{border:1px solid transparent;background:var(--rk-gold-tint,#fff7e0);color:var(--rk-gold-700,#a16207)}
+.rk-dir-note.is-set:hover{border-color:var(--rk-gold-600,#d99e00)}
+/* the note popover (body-appended, plain colors for portability) */
+.rk-dir-notepanel{position:fixed;z-index:2147483000;width:min(360px,calc(100vw - 24px));background:#fff;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-lg,12px);
+  box-shadow:var(--rk-shadow-md,0 10px 30px rgba(40,30,10,.16));padding:12px;display:grid;gap:8px}
+.rk-dir-notehead{font-size:12.5px;font-weight:800;color:var(--rk-ink,#2b2620);overflow-wrap:anywhere}
+.rk-dir-notehint{font-size:11.5px;line-height:1.45;color:var(--rk-text-muted,#78716c)}
+.rk-dir-notearea{font-family:inherit;font-size:12.5px;line-height:1.5;color:var(--rk-ink,#2b2620);width:100%;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-md,8px);padding:8px 9px;resize:vertical;background:#fff}
+.rk-dir-notearea:focus{outline:none;border-color:var(--rk-gold-600,#d99e00)}
+.rk-dir-notearea[readonly]{background:var(--rk-n-100,#f2efe9);color:var(--rk-text-muted,#78716c)}
+.rk-dir-notefoot{display:flex;align-items:center;gap:8px}
+.rk-dir-notestatus{flex:1;font-size:11px;font-weight:700;color:var(--rk-text-muted,#78716c);overflow-wrap:anywhere}
+.rk-dir-notestatus.is-ok{color:#2f7d32}
+.rk-dir-notestatus.is-err{color:#b4341f}
+.rk-dir-notebtn{font-family:inherit;font-size:12px;font-weight:800;cursor:pointer;border-radius:999px;padding:7px 13px;
+  border:1px solid transparent;background:var(--rk-gold-500,#fcb900);color:var(--rk-ink,#2b2620)}
+.rk-dir-notebtn:disabled{opacity:.6;cursor:default}
+.rk-dir-notebtn.is-ghost{background:transparent;border-color:var(--rk-border,#e6e1d8);color:var(--rk-text-muted,#78716c)}
 /* kebab popup + copy toast (appended to <body>, so plain colors not tokens for
    portability onto any host page) */
 .rk-dir-menu{position:fixed;z-index:2147483000;min-width:150px;background:#fff;border:1px solid var(--rk-border,#e6e1d8);

package/public/serve-shells/tools-video.html

@@ -363,6 +363,33 @@
   transition:opacity var(--rk-dur) var(--rk-ease),background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease)}
 .rk-aichat-frow:hover .rk-dir-kebab,.rk-dir-kebab:focus-visible{opacity:1}
 .rk-dir-kebab:hover{background:var(--rk-n-100);color:var(--rk-ink);border-color:var(--rk-border)}
+/* vector-note badge — the "does this thing say what it is?" signal. Always
+   visible (a missing note must read as a gap, not as nothing). */
+.rk-dir-note{flex:none;font-family:inherit;font-size:11px;font-weight:800;line-height:1;cursor:pointer;
+  padding:5px 8px;border-radius:999px;white-space:nowrap;max-width:120px;overflow:hidden;text-overflow:ellipsis;
+  transition:background var(--rk-dur) var(--rk-ease),border-color var(--rk-dur) var(--rk-ease),color var(--rk-dur) var(--rk-ease)}
+.rk-dir-note.is-empty{border:1px dashed var(--rk-border-strong,#d9d2c6);background:transparent;color:var(--rk-n-500,#8b8377)}
+.rk-dir-note.is-empty:hover{border-color:var(--rk-gold-600,#d99e00);color:var(--rk-gold-700,#a16207);background:var(--rk-gold-tint,#fff7e0)}
+.rk-dir-note.is-set{border:1px solid transparent;background:var(--rk-gold-tint,#fff7e0);color:var(--rk-gold-700,#a16207)}
+.rk-dir-note.is-set:hover{border-color:var(--rk-gold-600,#d99e00)}
+/* the note popover (body-appended, plain colors for portability) */
+.rk-dir-notepanel{position:fixed;z-index:2147483000;width:min(360px,calc(100vw - 24px));background:#fff;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-lg,12px);
+  box-shadow:var(--rk-shadow-md,0 10px 30px rgba(40,30,10,.16));padding:12px;display:grid;gap:8px}
+.rk-dir-notehead{font-size:12.5px;font-weight:800;color:var(--rk-ink,#2b2620);overflow-wrap:anywhere}
+.rk-dir-notehint{font-size:11.5px;line-height:1.45;color:var(--rk-text-muted,#78716c)}
+.rk-dir-notearea{font-family:inherit;font-size:12.5px;line-height:1.5;color:var(--rk-ink,#2b2620);width:100%;
+  border:1px solid var(--rk-border,#e6e1d8);border-radius:var(--rk-r-md,8px);padding:8px 9px;resize:vertical;background:#fff}
+.rk-dir-notearea:focus{outline:none;border-color:var(--rk-gold-600,#d99e00)}
+.rk-dir-notearea[readonly]{background:var(--rk-n-100,#f2efe9);color:var(--rk-text-muted,#78716c)}
+.rk-dir-notefoot{display:flex;align-items:center;gap:8px}
+.rk-dir-notestatus{flex:1;font-size:11px;font-weight:700;color:var(--rk-text-muted,#78716c);overflow-wrap:anywhere}
+.rk-dir-notestatus.is-ok{color:#2f7d32}
+.rk-dir-notestatus.is-err{color:#b4341f}
+.rk-dir-notebtn{font-family:inherit;font-size:12px;font-weight:800;cursor:pointer;border-radius:999px;padding:7px 13px;
+  border:1px solid transparent;background:var(--rk-gold-500,#fcb900);color:var(--rk-ink,#2b2620)}
+.rk-dir-notebtn:disabled{opacity:.6;cursor:default}
+.rk-dir-notebtn.is-ghost{background:transparent;border-color:var(--rk-border,#e6e1d8);color:var(--rk-text-muted,#78716c)}
 /* kebab popup + copy toast (appended to <body>, so plain colors not tokens for
    portability onto any host page) */
 .rk-dir-menu{position:fixed;z-index:2147483000;min-width:150px;background:#fff;border:1px solid var(--rk-border,#e6e1d8);

package/update.md

@@ -28,11 +28,21 @@ have yet. **Always update both together.**
 Worth ten seconds, because it tells you which breaking-change notes below actually apply:
 
 ```bash
-vidfarm --version            # devcli version
-npm view @officexapp/vidfarm-devcli version   # latest published
+vidfarm update-check         # BOTH halves, installed vs published, with a verdict
+vidfarm --version            # devcli version + the installed skill version
 cat skills-lock.json         # which skill packs are installed, and from where
 ```
 
+`vidfarm update-check` is the one to reach for — it reads the installed devcli, the installed
+skill's `skill_version`, the npm registry and the published `vidfarm.cc/SKILL.md`, and tells you
+which half is behind. It reports **offline as offline**, never as outdated.
+
+**Agents: check on a cadence, not on every command.** `vidfarm update-check --if-stale --quiet` is a
+no-op unless the last check is over 24 hours old, and prints nothing at all when you are current, so
+it is safe to leave at the top of every session. When it does report an update, tell the user and
+offer it — never update silently. If they decline, record it with `vidfarm update-check --skip`:
+that version stays quiet and a newer one asks again. **Honour the skip.** `--unskip` undoes it.
+
 ### 2. Remove the old skill
 
 There is no `skills remove` command — a skill is just a directory plus a lock entry, so delete both.