dsh-wisp 0.6.0

package/build.mjs

@@ -0,0 +1,169 @@
+/* ============================================================================
+   build.mjs — inline the sprites into lib/client.js.
+
+   lib/client.template.js holds the whole browser half with one placeholder,
+   __SPRITES__. This script replaces it with a small object of data URIs:
+
+       { idle: "data:image/webp;base64,…", happy: …, sleepy: …, work: … }
+
+   Embedding rather than shipping asset files is deliberate: the delivered
+   plugin is a single self-contained file, so a share carries no path, no
+   extra route, and no missing-asset failure mode.
+
+   RUN
+     node build.mjs                      # default tier: 1024x1536
+     node build.mjs --tier=hi            # 2048x3072 masters  (~3x the bundle)
+     node build.mjs --tier=md            # 512x768
+     node build.mjs --tier=sm            # 256x384  (--small is an alias)
+     node build.mjs --from assets/       # optional, defaults to ./assets
+
+   WHICH SOURCE IS INLINED MATTERS FOR SHARPNESS. assets/ carries four tiers per
+   mood, all downsampled from one 2048x3072 master:
+
+     <mood>.webp      1024x1536   default   sharp to devicePixelRatio ~4.9 at the
+                                            shipped render size (210x315 CSS px)
+     <mood>_md.webp    512x768              the pre-0.4 size
+     <mood>_sm.webp    256x384              smallest
+     <mood>_hi.webp   2048x3072             headroom for a much larger wisp
+
+   The default is the smallest tier that is sharp on every realistic display; the
+   tiers above it add bytes, not visible pixels, until she is drawn much bigger.
+   ========================================================================== */
+
+import { readFileSync, writeFileSync, existsSync, readdirSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join, resolve } from 'node:path'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const argv = process.argv.slice(2)
+const flagValue = (name, fallback) => {
+  const at = argv.indexOf(name)
+  if (at >= 0 && argv[at + 1] !== undefined) return argv[at + 1]
+  const inline = argv.find((a) => a.startsWith(`${name}=`))
+  return inline ? inline.slice(name.length + 1) : fallback
+}
+const assetsDir = resolve(here, flagValue('--from', 'assets'))
+const templatePath = join(here, 'lib', 'client.template.js')
+const outPath = join(here, 'lib', 'client.js')
+
+const MOODS = ['idle', 'happy', 'sleepy', 'work']
+
+/** Preference order per tier: the first hit wins, later entries are fallbacks. */
+const TIERS = {
+  hi: ['_hi', '', '_md', '_sm'],
+  full: ['', '_hi', '_md', '_sm'],
+  md: ['_md', '', '_sm'],
+  sm: ['_sm', '_md', ''],
+}
+const alias = argv.includes('--small') ? 'sm' : argv.includes('--hi') ? 'hi' : argv.includes('--md') ? 'md' : 'full'
+const tier = flagValue('--tier', alias)
+if (TIERS[tier] === undefined) {
+  console.error(`build: unknown --tier "${tier}" (expected one of ${Object.keys(TIERS).join(', ')})`)
+  process.exit(1)
+}
+
+if (!existsSync(assetsDir)) {
+  console.error(`build: assets directory not found: ${assetsDir}`)
+  process.exit(1)
+}
+
+const pickFile = (mood) => {
+  for (const suffix of TIERS[tier]) {
+    for (const ext of ['.webp', '.png']) {
+      const p = join(assetsDir, `${mood}${suffix}${ext}`)
+      if (existsSync(p)) return p
+    }
+  }
+  return null
+}
+
+const sprites = {}
+let total = 0
+for (const mood of MOODS) {
+  const file = pickFile(mood)
+  if (!file) {
+    console.error(`build: no sprite for mood "${mood}" in ${assetsDir}`)
+    process.exit(1)
+  }
+  const bytes = readFileSync(file)
+  total += bytes.length
+  const ext = file.slice(file.lastIndexOf('.') + 1).toLowerCase()
+  const mime = ext === 'png' ? 'image/png' : 'image/webp'
+  sprites[mood] = `data:${mime};base64,${bytes.toString('base64')}`
+  console.log(`  ${mood.padEnd(7)} ${String(Math.round(bytes.length / 1024)).padStart(4)} KB  <- ${file.slice(here.length + 1)}`)
+}
+
+const PLACEHOLDER = '__SPRITES_LITERAL__'
+const template = readFileSync(templatePath, 'utf8')
+const placeholderCount = template.split(PLACEHOLDER).length - 1
+if (placeholderCount !== 1) {
+  // Exactly one occurrence, and it must NOT sit inside a comment. An earlier
+  // revision used `/*__SPRITES__*/{}` as the placeholder; the substitution then
+  // left `/*{…}`, the whole injected table became a block comment, SPRITES
+  // silently evaluated to {}, and every sprite rendered as a broken image.
+  console.error(`build: template must contain ${PLACEHOLDER} exactly once (found ${placeholderCount})`)
+  process.exit(1)
+}
+
+const literal = '{\n' + MOODS.map((m) => `      ${m}: '${sprites[m]}',`).join('\n') + '\n    }'
+const out = template.replace(PLACEHOLDER, literal)
+
+if (out.includes(PLACEHOLDER)) {
+  console.error('build: placeholder survived the substitution; refusing to write a broken bundle')
+  process.exit(1)
+}
+
+/* ---- guard: never call a global the dynamic client runner traps ----------
+   setTimeout/setInterval/clearTimeout/clearInterval/fetch/require are shadowed
+   by THROWING parameters in a client half, so a call to one is a guaranteed
+   runtime crash that no bundler reports. The pattern demands a real call, so
+   the prose in the file header (which names them without parentheses) is not a
+   false positive. verify-wisp.mjs proves the same thing by executing the bundle
+   with all six shadowed by traps. */
+const TRAPPED_CALL = /(setTimeout|setInterval|clearTimeout|clearInterval|fetch|require)\s*\(/
+const trapped = out.match(TRAPPED_CALL)
+if (trapped) {
+  console.error(`build: the bundle calls the trapped global "${trapped[1]}" — the client half would throw at runtime`)
+  process.exit(1)
+}
+
+/* ---- guard: the stamped version must match package.json ------------------ */
+const pkg = JSON.parse(readFileSync(join(here, 'package.json'), 'utf8'))
+const stamped = out.match(/const VERSION = '([^']+)'/)
+if (!stamped) {
+  console.error('build: client half carries no VERSION constant; the mount log would lie about the running build')
+  process.exit(1)
+}
+if (stamped[1] !== pkg.version) {
+  console.error(`build: version drift — client stamps ${stamped[1]}, package.json says ${pkg.version}`)
+  process.exit(1)
+}
+
+// Prove the injected table survives parsing before writing anything.
+const table = out.match(/const SPRITES = \{([\s\S]*?)\n {4}\}/)
+if (!table || MOODS.some((m) => !new RegExp(`\\b${m}:\\s*'data:image/`).test(table[1]))) {
+  console.error('build: the injected SPRITES table is missing sprites; aborting')
+  process.exit(1)
+}
+try {
+  // Evaluate exactly that statement to be certain it is not commented out.
+  const value = new Function(`${table[0]}\nreturn SPRITES`)()
+  if (MOODS.some((m) => typeof value[m] !== 'string' || value[m].indexOf('data:image/') !== 0)) {
+    console.error(`build: SPRITES evaluated to ${JSON.stringify(Object.keys(value))}; aborting`)
+    process.exit(1)
+  }
+} catch (error) {
+  console.error(`build: injected SPRITES table does not evaluate (${error.message}); aborting`)
+  process.exit(1)
+}
+
+writeFileSync(outPath, out, 'utf8')
+
+const kb = (n) => (n / 1024).toFixed(1)
+console.log(`\n  sprites total   ${kb(total)} KB`)
+console.log(`  base64 inlined  ${kb(out.length)} KB`)
+console.log(`  wrote           lib/client.js`)
+
+if (assetsDir !== join(here, 'assets') && readdirSync(assetsDir).length === 0) {
+  console.warn('\n  warning: assets directory is empty')
+}

package/cordis.patch.yml

@@ -0,0 +1,51 @@
+# Bundle patch for dsh-wisp.
+#
+# A profile points at this file through its own `dsh.bundle.patch` field; the
+# loader reads it as a top-level YAML array of patch entries, exactly like the
+# shipped bundles do.
+#
+# THE ROW BELOW POINTS AT THE HOST HALF — `dsh-wisp`, not `dsh-wisp/client`.
+#
+# This distinction is the whole reason the plugin failed to load three times.
+# The loader imports this name as an ES module. `dsh-wisp` resolves to
+# lib/index.js, which is a valid ES module. `dsh-wisp/client` resolves to
+# lib/client.js, which is a classic browser script beginning with
+# `window.__ModuleLoader__.load(...)` — the host cannot import that, so
+# `entry.fiber` stayed undefined and @deepseek-ai/dsh-app-boot reported its
+# terse `"failed to import"`.
+#
+# The browser half still ships: it is discovered through package.json
+# `exports["./client"]` (dsh-client-modules reads that, it does not import it)
+# and delivered to the page by the /plugins bundle route.
+#
+# Config keys the client half accepts — every one optional, every one clamped to
+# a sane range, so a typo degrades to the default instead of leaving an
+# unusable companion on screen:
+#   right             distance from the right edge in px     (default 26)
+#   bottom            distance from the bottom edge in px    (default 46)
+#   size              render scale, 0.4–8                    (default 4)
+#                     -> drawn 560x840 CSS px from the 2048x3072 sprite tier
+#   sleepAfterMs      idle time before dozing off in ms      (default 90000)
+#   reactions         react to agent-busy / composer text    (default true)
+#   persist           remember where she was dragged to      (default true)
+#   celebrate         cheer when a run finishes              (default true)
+#   celebrateAfterMs  only celebrate runs at least this long  (default 2500)
+#   happyMs           how long the happy state lasts          (default 1100)
+#   chatterMs         idle line interval; 0 = stay quiet      (default 0)
+#   wander            stroll around on her own while idle     (default true)
+#   wanderMs          how often she considers a stroll        (default 45000)
+#   wanderRange       how far one stroll may travel, in px    (default 260)
+#
+# Example — add a `config:` block to the row below:
+#
+#   - insert:
+#       - id: wisp
+#         name: "dsh-wisp"
+#         config:
+#           bottom: 90
+#           size: 1.2
+#           chatterMs: 300000
+
+- insert:
+    - id: wisp
+      name: "dsh-wisp"