@ivoryheart/herdr-world 0.1.1 → 0.2.0-rc.2

package/LICENSE

@@ -1,5 +1,6 @@
 MIT License
 
+Copyright (c) 2026 Arthur
 Copyright (c) 2026 Kevin
 Copyright (c) 2026 IvoryHeart contributors
 

package/README.md

@@ -1,42 +1,181 @@
 # Herdr World
 
-Herdr World is a browser and mobile client for monitoring and controlling Herdr agents.
+<p align="center">
+  <img src="./web/public/herdr-world-logo.svg" alt="Herdr World ram mark" width="128" />
+</p>
 
-## Install
+A **visual control plane** for [Herdr](https://herdr.dev). Connect local and SSH
+hosts, select one host at a time in Office, Tree, Graph, or Spaces, and open its
+qualified terminals, files, changes, and agent history on desktop or mobile.
+**Requires a running Herdr server.**
 
-```bash
-npm install --global @ivoryheart/herdr-world
-herdr-world
-```
+## Screenshots
+
+### Desktop
+
+[![Office view showing the selected Herdr host and its agents][desktop-office]][desktop-office]
+
+Office shows the selected host's agent state at a glance. Tree and Graph expose
+the same qualified runtime, while Spaces keeps Herdr's full terminal and
+repository workflow one click away. Switch the host selector to replace the
+whole view; World keeps other managed connections observed in the background.
+
+<!-- markdownlint-disable MD033 -->
+
+<table width="100%">
+  <thead>
+    <tr>
+      <th width="33.33%" align="center">Tree</th>
+      <th width="33.33%" align="center">Graph</th>
+      <th width="33.33%" align="center">Spaces</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td width="33.33%" align="center" valign="top">
+        <a href="./docs/images/herdr-world-desktop-tree.png"><img src="./docs/images/herdr-world-desktop-tree.png" alt="Tree view of hosts, spaces, and agents" width="100%" /></a>
+      </td>
+      <td width="33.33%" align="center" valign="top">
+        <a href="./docs/images/herdr-world-desktop-graph.png"><img src="./docs/images/herdr-world-desktop-graph.png" alt="Graph view of hosts, spaces, and agents" width="100%" /></a>
+      </td>
+      <td width="33.33%" align="center" valign="top">
+        <a href="./docs/images/herdr-world-desktop-spaces.png"><img src="./docs/images/herdr-world-desktop-spaces.png" alt="Spaces terminal workspace" width="100%" /></a>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+The same Inspector can move with an agent while preserving its exact terminal
+and repository context. Files and agent history are first-class views, not a
+handoff to a separate application.
+
+<table width="100%">
+  <thead>
+    <tr>
+      <th width="50%" align="center">Files</th>
+      <th width="50%" align="center">Agent history</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td width="50%" align="center" valign="top">
+        <a href="./docs/images/herdr-world-desktop-files.png"><img src="./docs/images/herdr-world-desktop-files.png" alt="Office Inspector browsing files for the selected agent" width="100%" /></a>
+      </td>
+      <td width="50%" align="center" valign="top">
+        <a href="./docs/images/herdr-world-desktop-history.png"><img src="./docs/images/herdr-world-desktop-history.png" alt="Office Inspector showing the selected agent's session history" width="100%" /></a>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+### Mobile
+
+<table width="100%">
+  <thead>
+    <tr>
+      <th width="33.33%" align="center">Office</th>
+      <th width="33.33%" align="center">Tree</th>
+      <th width="33.33%" align="center">Spaces</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td width="33.33%" align="center" valign="top">
+        <a href="./docs/images/herdr-world-mobile-office.png"><img src="./docs/images/herdr-world-mobile-office.png" alt="Mobile Office view" width="100%" /></a>
+      </td>
+      <td width="33.33%" align="center" valign="top">
+        <a href="./docs/images/herdr-world-mobile-tree.png"><img src="./docs/images/herdr-world-mobile-tree.png" alt="Mobile Tree view" width="100%" /></a>
+      </td>
+      <td width="33.33%" align="center" valign="top">
+        <a href="./docs/images/herdr-world-mobile-spaces.png"><img src="./docs/images/herdr-world-mobile-spaces.png" alt="Mobile Spaces terminal" width="100%" /></a>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-enable MD033 -->
+
+Click any screenshot to open the full-resolution image.
 
-The package contains the tested Linux x64, macOS ARM64, and macOS x64 bridge binaries and the
-bundled web application. It requires Node.js 22.14.0 or newer and Linux glibc 2.34 or newer.
-Windows, Linux ARM64, musl Linux, and unknown libc environments are not supported.
+[desktop-office]: ./docs/images/herdr-world-desktop-office.png
 
-Package installation only installs files. It does not download or build native code, install Herdr,
-create a workspace, or start a process.
+## Quick start
 
-Herdr World still requires a running Herdr 0.8.2 or newer session using terminal protocol 20. Start
-Herdr from the directory containing the work it should manage, then run `herdr-world`. Use
-`herdr-world --help` for bridge options. The bridge binds to loopback by default; Host, Origin, and
-Content Security Policy checks are request protections, not user authentication.
+1. Install and start [Herdr](https://herdr.dev), or let Herdr World install and
+   start it later with `herdr-world herdr setup`.
+2. On Linux or macOS, install Herdr World with the standalone installer:
 
-The package includes the complete application legal notices and dependency inventories. The exact
-source release and package checksums are recorded in the corresponding GitHub release workflow.
+   ```bash
+   # Empty selects latest; use X.Y.Z (no v prefix) to pin a Herdr World version.
+   curl -fsSL \
+     https://github.com/IvoryHeart/herdr-world/releases/latest/download/install-herdr-world.sh \
+     | HERDR_WORLD_VERSION= sh
+   ```
 
-## Using Herdr's plugin
+   For 0.2.0 and newer releases, Homebrew (`brew install IvoryHeart/tap/herdr-world`)
+   and npm (`npm install --global @ivoryheart/herdr-world`) are alternative channels.
+   npm requires Node.js 22.14.0 or newer and downloads only the binary for the
+   current platform. On Windows, use npm or download the matching x64 or ARM64
+   archive from the [latest release](https://github.com/IvoryHeart/herdr-world/releases/latest).
+3. On Linux/macOS standalone installs, add `~/.local/bin` to `PATH`. Run
+   `herdr-world` (or `herdr-world.exe` from an extracted Windows archive) and open
+   the printed URL.
 
-The Herdr plugin is installed from the Herdr World GitHub repository, not from this npm package:
+Use the connection selector to add local sockets or an SSH destination. One World
+service owns every connection; each browser selects one operational host and stays
+on the same World origin. Office, Tree, Graph, visible counts, and search follow
+that selected host until simultaneous active-host interaction is supported.
+
+See [deployment](./docs/DEPLOYMENT.md) for checksums, profiles, authentication,
+updates, and services.
+
+## Install as a PWA
+
+**PWA installation is recommended for daily use:** a separate app window without
+browser tabs or the address bar. Open and authenticate with Herdr World, then install:
+
+- **iPhone/iPad Safari:** Share -> Add to Home Screen.
+- **macOS Safari 17+:** File -> Add to Dock.
+- **Chrome/Edge:** browser menu -> Install app.
+
+The process must stay running and reachable. **PWA mode is not offline access.**
+
+## Documentation
+
+- [Website](https://ivoryheart.github.io/herdr-world/) and
+  [hands-on tutorial](https://ivoryheart.github.io/herdr-world/tutorial/)
+  ([Markdown](./docs/TUTORIAL.md)): local work, mobile, and private remote access.
+- [Features and shortcuts](./FEATURES.md)
+- [Deployment](./docs/DEPLOYMENT.md): installation, configuration, services, builds.
+- [Architecture](./docs/ARCHITECTURE.md): system contracts.
+- [Repository knowledge map](./docs/knowledge-map.md) and
+  [foundation source guide](./docs/foundation-guide.md): contracts, module owners,
+  request paths, and focused tests for contributors and agents.
+- [Development](./docs/development.md), [packaging](./docs/packaging.md), and
+  [release process](./docs/release.md).
+- [Security](./SECURITY.md) and [contributing](./CONTRIBUTING.md).
+
+## Development
+
+Use Bun 1.4.1 or newer and a running Herdr server:
 
 ```bash
-herdr plugin install IvoryHeart/herdr-world --ref vX.Y.Z
+bun install --frozen-lockfile
+# Run in separate terminals:
+bun run dev:server
+bun run dev:web
 ```
 
-It installs the exact matching npm payload privately inside Herdr's managed plugin checkout and
-supervises its bridge for the invoking Herdr session. The plugin requires Node.js 22.14.0 or newer
-and npm at installation and runtime; it does not use this package's global installation or a
-Homebrew installation. Installation does not start the bridge immediately. Herdr's startup hook
-starts it on the next server restore; invoke the plugin's `open` or `start` action for an already
-running server. See the repository [plugin documentation](https://github.com/IvoryHeart/herdr-world#herdr-plugin)
-for configuration, lifecycle actions, startup and failure behavior, security, and the standalone
-distribution relationship.
+Open <http://localhost:5173>. See [CONTRIBUTING.md](./CONTRIBUTING.md) for checks
+and pull requests.
+
+## Security
+
+Herdr World controls terminals and modifies real files. Keep the default loopback
+binding; read [SECURITY.md](./SECURITY.md) before allowing another device access.
+
+## License
+
+Code: [MIT](./LICENSE). Bundled dependencies, fonts and brand assets retain their
+original terms; see [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md) and the
+generated [dependency licence texts](./DEPENDENCY_LICENSES.md).

package/bin/herdr-world.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { constants } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const platform = process.platform === "win32" ? "windows" : process.platform;
+const id = `${platform}-${process.arch}`;
+const supported = new Set([
+  "linux-x64",
+  "linux-arm64",
+  "darwin-x64",
+  "darwin-arm64",
+  "windows-x64",
+  "windows-arm64",
+]);
+if (!supported.has(id)) {
+  console.error(`Herdr World has no release binary for ${id}`);
+  process.exit(1);
+}
+if (
+  platform === "linux" &&
+  !process.report?.getReport()?.header.glibcVersionRuntime
+) {
+  console.error("Herdr World requires glibc on Linux");
+  process.exit(1);
+}
+
+const packageName = `@ivoryheart/herdr-world-${id}`;
+let binary;
+try {
+  const packageJson = fileURLToPath(
+    import.meta.resolve(`${packageName}/package.json`),
+  );
+  const platformVersion = JSON.parse(readFileSync(packageJson, "utf8")).version;
+  const launcherVersion = JSON.parse(
+    readFileSync(new URL("../package.json", import.meta.url), "utf8"),
+  ).version;
+  if (platformVersion !== launcherVersion) {
+    throw new Error("platform package version differs from the launcher");
+  }
+  binary = join(
+    dirname(packageJson),
+    "bin",
+    platform === "windows" ? "herdr-world.exe" : "herdr-world",
+  );
+} catch (error) {
+  console.error(
+    `Cannot use ${packageName}: ${error.message}. Reinstall with npm optional dependencies enabled.`,
+  );
+  process.exit(1);
+}
+
+const child = spawn(binary, process.argv.slice(2), { stdio: "inherit" });
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(signal, () => child.kill(signal));
+}
+child.on("error", (error) => {
+  console.error(`Could not start Herdr World: ${error.message}`);
+  process.exitCode = 1;
+});
+child.on("exit", (code, signal) => {
+  process.exitCode =
+    code ?? (signal ? 128 + (constants.signals[signal] ?? 1) : 1);
+});

package/package.json

@@ -1,34 +1,30 @@
 {
   "name": "@ivoryheart/herdr-world",
-  "version": "0.1.1",
-  "description": "Browser and mobile client for monitoring and controlling Herdr agents.",
-  "type": "module",
-  "bin": {
-    "herdr-world": "bin/herdr-world"
-  },
-  "engines": {
-    "node": ">=22.14.0"
-  },
+  "version": "0.2.0-rc.2",
+  "description": "Herdr World: Visualize and control your agents in Office and Graph across multiple hosts.",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/IvoryHeart/herdr-world.git"
   },
-  "bugs": {
-    "url": "https://github.com/IvoryHeart/herdr-world/issues"
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "bin": {
+    "herdr-world": "bin/herdr-world.mjs"
+  },
+  "optionalDependencies": {
+    "@ivoryheart/herdr-world-linux-x64": "0.2.0-rc.2",
+    "@ivoryheart/herdr-world-linux-arm64": "0.2.0-rc.2",
+    "@ivoryheart/herdr-world-darwin-x64": "0.2.0-rc.2",
+    "@ivoryheart/herdr-world-darwin-arm64": "0.2.0-rc.2",
+    "@ivoryheart/herdr-world-windows-x64": "0.2.0-rc.2",
+    "@ivoryheart/herdr-world-windows-arm64": "0.2.0-rc.2"
   },
-  "homepage": "https://ivoryheart.github.io/herdr-world/",
   "files": [
-    "bin/herdr-world",
-    "lib/herdr-world-launcher.sh",
-    "lib/bridges",
-    "share/herdr-world/web",
-    "docs",
-    "vendor",
-    "third_party",
-    "LICENSE",
-    "THIRD_PARTY_NOTICES.md",
-    "UPSTREAM.md"
+    "bin",
+    "README.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"

package/THIRD_PARTY_NOTICES.md

@@ -1,61 +0,0 @@
-# Third-party notices
-
-Herdr World contains code and assets from the projects below. The repository
-history, lockfiles, and referenced manifests provide the exact version record.
-
-## Herdr Web
-
-Herdr World is derived from
-[`kcosr/herdr-web`](https://github.com/kcosr/herdr-web), licensed under the MIT
-License, Copyright (c) 2026 Kevin. The retained MIT terms are in the repository
-[`LICENSE`](LICENSE). The current synchronized revision is recorded in
-[`UPSTREAM.md`](UPSTREAM.md).
-
-## Herdr compatibility source
-
-`vendor/herdr-compat` contains copied or adapted source from
-[`herdrdev/herdr`](https://github.com/herdrdev/herdr) v0.8.2 at commit
-`9eb521456ac0d19d3ab3d9d7cea3cca10baa8a4c`, licensed under Apache-2.0.
-The exact source paths, hashes, and local dispositions are recorded in
-[`vendor/herdr-compat/VENDOR-MANIFEST.toml`](vendor/herdr-compat/VENDOR-MANIFEST.toml).
-The license text is retained in
-[`third_party/licenses/Apache-2.0.txt`](third_party/licenses/Apache-2.0.txt).
-
-## Claw-Empire character assets and Office adaptations
-
-The character sprites in `web/public/world/characters` are copied from
-[`GreenSheep01201/claw-empire`](https://github.com/GreenSheep01201/claw-empire)
-at commit `66a24ea7df2435ef897c48c147deb7ec572c01c2`, licensed under
-Apache-2.0, Copyright 2026 GreenSheep01201 (seowongil@gmail.com).
-
-The Office geometry and drawing TypeScript files are modified adaptations of
-the historical sources identified by hash in [`docs/world-assets.md`](docs/world-assets.md).
-Herdr World's TypeScript port and subsequent modifications are documented
-there as modified material. The Apache-2.0 text is retained in
-[`third_party/licenses/Apache-2.0.txt`](third_party/licenses/Apache-2.0.txt).
-
-## PixiJS
-
-World rendering uses PixiJS 8.3.4, licensed under the MIT License, Copyright
-(c) 2013-2023 Mathew Groves and Chad Engler. Its license is retained in
-[`third_party/licenses/PixiJS-MIT.txt`](third_party/licenses/PixiJS-MIT.txt)
-and alongside the shipped World assets.
-
-## JetBrains Mono Nerd Font
-
-The terminal includes `JetBrainsMonoNerdFontMono-Regular.woff2` as a fallback
-for box-drawing, symbol, and private-use glyphs. The font is licensed under the
-SIL Open Font License 1.1, Copyright 2020 The JetBrains Mono Project Authors.
-The copyright notice and full license are retained in
-[`web/public/fonts/OFL.txt`](web/public/fonts/OFL.txt) and shipped alongside
-the font.
-
-## Other dependencies
-
-JavaScript and Rust dependency versions are pinned by `package-lock.json`,
-`web/package-lock.json`, `bridge/Cargo.lock`, and
-`vendor/herdr-compat/Cargo.lock`. The complete production npm and planned
-desktop Cargo closures, their selected licences, copyright notices, and full
-licence texts are checked in under
-[`third_party/dependencies`](third_party/dependencies). Release assembly fails
-when those generated inventories drift from the resolved dependency graphs.

package/UPSTREAM.md

@@ -1,65 +0,0 @@
-# Upstreams
-
-Herdr World is derived from
-[`kcosr/herdr-web`](https://github.com/kcosr/herdr-web) and runs against
-[`herdrdev/herdr`](https://github.com/herdrdev/herdr).
-
-The Git remotes are:
-
-```text
-origin    git@github.com:IvoryHeart/herdr-world.git
-upstream  git@github.com:kcosr/herdr-web.git
-```
-
-Current synchronization points:
-
-- Herdr Web: `4384c884da418ea3f3fb75954da5347b2e12f063`
-  (`v0.5.0` plus the JetBrains Mono Nerd Font fallback merged in upstream PR #74)
-- Herdr compatibility: Herdr `v0.8.2`, commit
-  `9eb521456ac0d19d3ab3d9d7cea3cca10baa8a4c`, terminal protocol `20`
-
-The 2026-08-30 Herdr audit also reviewed `master` at
-`4a3b04f59ba3b7d8a15cea187b23e1e80c343b0c`. No stable release newer than
-`v0.8.2` exists at that point. `master` advertises terminal protocol `21` and
-contains unreleased API additions, so those sources are not vendored or
-admitted by the protocol-20 bridge. The stable compatibility reference above
-remains unchanged until a release is available for a complete refresh and
-stock-daemon validation.
-
-Git history is the detailed synchronization record, and the Herdr Web commit
-above is a merge ancestor of this repository. `CHANGELOG.md` repeats only the
-per-release baseline correlation; it does not copy the upstream release history
-or maintain a separate adoption ledger.
-
-## Release Lineage Convention
-
-Herdr World and Herdr Web keep independent release identities and changelogs. A World version does
-not imply a matching Web version, and a Web version is never added as a World changelog section.
-Each World release instead records one exact Web baseline: the descriptive upstream version or
-marker together with the full synchronization commit from this file. The release helper renders
-that correlation as "Herdr Web baseline: Derived from …" and release validation requires it to
-match the synchronization point at the tagged commit.
-
-Use these terms consistently:
-
-- **Derived from** describes Herdr Web source synchronized into this repository and then changed
-  downstream.
-- **Compatible with** describes the external Herdr release and terminal protocol accepted by the
-  bridge.
-- **Depends on** is reserved for a package or runtime dependency that remains independently
-  installed and resolved; it does not describe copied or synchronized Web source.
-
-Record World-owned changes under the current World `Unreleased` section. An adopted upstream
-change may be mentioned when it changes the World product, with its upstream attribution and World
-integration PR, but do not reproduce the upstream release notes. Update this file's synchronization
-point before preparing a World release; the prepared changelog correlation is generated from it.
-
-To update:
-
-```bash
-git fetch upstream
-git merge upstream/main
-```
-
-Keep World implementation in its World-owned directories and resolve only the
-small integration seams when an upstream change touches them.

package/bin/herdr-world

@@ -1,133 +0,0 @@
-#!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { realpathSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { dirname, join, resolve } from "node:path";
-
-export const SUPPORTED_PLATFORMS = {
-  "linux-x64": "linux-x64",
-  "darwin-arm64": "macos-arm64",
-  "darwin-x64": "macos-x64",
-};
-
-export function parseGlibcVersion(value) {
-  const match = typeof value === "string" ? value.match(/^(\d+)\.(\d+)$/) : null;
-  return match ? { major: Number(match[1]), minor: Number(match[2]) } : null;
-}
-
-function compareVersions(left, right) {
-  if (left.major !== right.major) return left.major - right.major;
-  return left.minor - right.minor;
-}
-
-export function selectBridge({
-  platform = process.platform,
-  arch = process.arch,
-  report = process.report,
-} = {}) {
-  const key = `${platform}-${arch}`;
-  const target = SUPPORTED_PLATFORMS[key];
-  if (!target) {
-    throw new Error(`Herdr World does not support this platform or architecture: ${key}`);
-  }
-
-  if (platform !== "linux") return target;
-
-  const glibcValue = report?.getReport?.().header?.glibcVersionRuntime;
-  if (typeof glibcValue !== "string") {
-    throw new Error("Herdr World requires a detectable glibc runtime on Linux; musl or unknown libc is unsupported");
-  }
-  const glibc = parseGlibcVersion(glibcValue);
-  if (!glibc) {
-    throw new Error(`Herdr World could not parse the Linux glibc version: ${glibcValue}`);
-  }
-  if (compareVersions(glibc, { major: 2, minor: 34 }) < 0) {
-    throw new Error(`Herdr World requires glibc 2.34 or newer; found ${glibcValue}`);
-  }
-  return target;
-}
-
-export function packageHelp() {
-  return `Usage: herdr-world [OPTIONS]
-       herdr-world task-summary [TEXT] [--ttl-ms N] [--pane ID] [--session NAME]
-       herdr-world task-summary --clear [--pane ID] [--session NAME]
-
-Starts the Herdr World browser bridge for the selected Herdr session.
-
-The task-summary command reports bounded, expiring harness metadata for the
-current Herdr pane without starting the browser bridge.
-
-Options are forwarded to the bridge:
-  --host HOST                 Bind address (loopback by default)
-  --port PORT                 HTTP port (8787 by default)
-  --session NAME              Select a named Herdr session
-  --no-herdr-setup            Disable interactive Herdr setup
-  -h, --help                  Show this help without starting Herdr or a bridge
-
-The bridge requires Herdr 0.8.2 or newer with terminal protocol 20.
-`;
-}
-
-export function isHelpRequest(args) {
-  return args.includes("-h") || args.includes("--help");
-}
-
-export function runPackageLauncher(args = process.argv.slice(2), {
-  platform = process.platform,
-  arch = process.arch,
-  report = process.report,
-  packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), ".."),
-} = {}) {
-  if (isHelpRequest(args)) {
-    process.stdout.write(packageHelp());
-    return null;
-  }
-
-  const target = selectBridge({ platform, arch, report });
-  const bridge = join(packageRoot, "lib", "bridges", target, "herdr-world-bridge");
-  const launcher = join(packageRoot, "lib", "herdr-world-launcher.sh");
-  const staticDir = join(packageRoot, "share", "herdr-world", "web");
-  const child = spawn("/bin/bash", [launcher, ...args], {
-    env: {
-      ...process.env,
-      HERDR_WORLD_BRIDGE_BIN: bridge,
-      HERDR_WORLD_STATIC_DIR: staticDir,
-    },
-    stdio: "inherit",
-  });
-
-  const signalHandlers = new Map();
-  for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
-    const handler = () => child.kill(signal);
-    signalHandlers.set(signal, handler);
-    process.on(signal, handler);
-  }
-  child.once("error", (error) => {
-    console.error(`could not start Herdr World: ${error.message}`);
-    process.exitCode = 1;
-  });
-  child.once("exit", (code, signal) => {
-    if (signal) {
-      for (const [forwardedSignal, handler] of signalHandlers) {
-        process.removeListener(forwardedSignal, handler);
-      }
-      process.kill(process.pid, signal);
-    } else {
-      process.exitCode = code ?? 1;
-    }
-  });
-  return child;
-}
-
-if (
-  process.argv[1] &&
-  realpathSync(resolve(process.argv[1])) === realpathSync(fileURLToPath(import.meta.url))
-) {
-  try {
-    const result = runPackageLauncher();
-    if (!result) process.exit(0);
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-}

package/docs/world-assets.md

@@ -1,51 +0,0 @@
-# Pixel Office asset provenance
-
-The Herdr World Pixel Office port uses character assets traceable to the
-Claw-Empire repository at revision
-`66a24ea7df2435ef897c48c147deb7ec572c01c2`, under `public/sprites/`. The
-tracked PNGs are byte-identical to those source files. That source carries the
-Apache License 2.0 and the copyright notice `Copyright 2026 GreenSheep01201
-(seowongil@gmail.com)`. Herdr World has no build or runtime dependency on the
-reference workspace. The copied character sprites now live under
-`web/public/world/characters/`.
-
-The reference workspace is historical provenance only; contributors do not
-need to clone or start another repository to build, test, or run Herdr World.
-The release notice bundle MUST include the Apache-2.0 license and this
-attribution. The adapted TypeScript geometry/drawing files are modified files
-and MUST carry a prominent modification notice as required by Apache-2.0
-Section 4(b); the provenance manifest will identify the exact source hashes,
-copied-file hashes, and notices.
-
-The historical reference Office directory was untracked in the source
-checkout at port time, so that local directory has no source commit to cite.
-The immutable Extension 001 approval commit authorizing this port is
-`7be916e3c4713582c72665cd787ef0300658ea26`. The Claw-Empire revision and
-these SHA-256 values identify the exact copied assets:
-
-| Asset | SHA-256 |
-| --- | --- |
-| `1-D-1.png` | `97e11be5369a5865f9e0a7b1657af23fd5d7f4b244fb94010ebb7e9e66a3e004` |
-| `2-D-1.png` | `f3053d7f6bc2959ad375b1cfd23eb9fb1e34e7329ba837fd7518268459d0a83d` |
-| `3-D-1.png` | `eb8cb07677ec3ff81a43e019990b288ca3b858309fe51b2d5b52ccf3f8b855f5` |
-| `4-D-1.png` | `23dab1383ef8f98af148885e5f01c25063ce0e7b6d0ae6a255c5bdb83dae01f2` |
-| `5-D-1.png` | `32d8159b707fc64447fc6ab27a6a00ba2ddf318627fada114d43d5aef9c93fa9` |
-| `6-D-1.png` | `7ae5935cf9f454f0ea8ee099111fde50da5055a50a7b05c53a98e5eb914b3739` |
-| `7-D-1.png` | `4fb4bcf9046c66f7e4630edf636deb6d076a062e195c9dfb44caf713e9e46dcf` |
-| `8-D-1.png` | `63d8d576aff2f9973d38d24c0d0ca87498af8880c1326aceaa0c644c5df03d66` |
-| `9-D-1.png` | `1fc674238ce13ae382c07189d4422780e47bdd1417bf468bb492786cf211f4bf` |
-| `10-D-1.png` | `c4d22e7ccec30505873469a2e1cef76cf8435be84d71d3f201d84147de8f5738` |
-| `11-D-1.png` | `6e2c79f2fdb5afe8fd8c1537ba550a8ada9d301e4b493e4a528dbb37d3d4a549` |
-| `12-D-1.png` | `334595aa69f05095faa88227413dcddd6d1a2f177fbaeb625bd78f8dc7bcef34` |
-
-The geometry and drawing behavior are TypeScript adaptations of `office-geometry.js`,
-`office-drawing.js`, and the rendering portions of `office-scene.js`; their source hashes at port
-time were respectively:
-
-- `6ab54a94369e8695c3bac2cf94ac76bab62613563382e4a712944ff0ff70e028`
-- `56edfdd364ace64663e4a98c931d15d2ef5bfcb725acee8d8791e88f974fd210`
-- `f4975a6e840506a003f39153dfa6e32830d311624402980a1884ecb5351a1e3f`
-
-PixiJS `8.3.4` is pinned as an npm dependency. Its MIT license is retained at
-`web/public/world/LICENSE-PixiJS.txt`. The Claw-Empire Apache-2.0 license is a
-release requirement and is not inferred from PixiJS or any neighboring asset.