@telepath-computer/television 0.1.173 → 0.1.175

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.cjs CHANGED
@@ -52695,8 +52695,8 @@ var Server = class {
52695
52695
  };
52696
52696
  };
52697
52697
  function readServerPackageVersion() {
52698
- if ("0.1.173".length > 0) {
52699
- return telemetryVersion("0.1.173");
52698
+ if ("0.1.175".length > 0) {
52699
+ return telemetryVersion("0.1.175");
52700
52700
  }
52701
52701
  const packageJsonPath = import_node_path11.default.resolve(import_node_path11.default.dirname((0, import_node_url.fileURLToPath)(import_meta.url)), "..", "package.json");
52702
52702
  if (!(0, import_node_fs9.existsSync)(packageJsonPath)) return telemetryVersion("0.0.0");
@@ -53769,8 +53769,8 @@ function resolveVercelSkillsInstallerBin() {
53769
53769
  return localRequire.resolve("skills/bin/cli.mjs");
53770
53770
  }
53771
53771
  function readCLIVersion() {
53772
- if ("0.1.173".length > 0) {
53773
- return "0.1.173";
53772
+ if ("0.1.175".length > 0) {
53773
+ return "0.1.175";
53774
53774
  }
53775
53775
  const devPackageJsonPath = import_node_path15.default.join(getDevPackageDir(), "package.json");
53776
53776
  if (!(0, import_node_fs12.existsSync)(devPackageJsonPath)) {
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: television
3
- description: Mental model, when to create artifacts, and how Television's bundled skills fit together. Read for screen, artifact, and CLI work.
3
+ description: Mental model, when to create artifacts, how Television's bundled skills fit together, and where the admin guide lives. Read for screen, artifact, and CLI work, and before installing, upgrading, or reconfiguring Television.
4
4
  ---
5
5
 
6
6
 
@@ -68,11 +68,23 @@ Questions to keep straight:
68
68
 
69
69
  Those questions interact, but they are not the same question.
70
70
 
71
+ ## Administration: install, upgrade, and server configuration
72
+
73
+ The deployed Television administrator guide lives at `https://television.run/install.md`. Fetch and follow it whenever the user asks for installation, an upgrade, an uninstall, or any administrative change to how Television is configured or deployed — network binding and listeners, auth and tokens, ports, the persistent daemon, Docker setups, the desktop client, or troubleshooting an unreachable or unhealthy server. This skill deliberately does not duplicate that material.
74
+
75
+ **Fetch the full raw content — never a summary.** Many agent web fetch tools auto-summarize pages. The guide's details are load-bearing, and a summarized version is insufficient to administer from. Retrieve the verbatim markdown, for example:
76
+
77
+ ```bash
78
+ curl -fsS https://television.run/install.md
79
+ ```
80
+
81
+ Read the entire document before acting. If your web fetch tool returned a summary, refetch with a method that returns the raw markdown.
82
+
71
83
  ## Telemetry awareness and control
72
84
 
73
85
  Television collects anonymous, content-free telemetry by default to understand early usage and improve the product. Telemetry records predefined usage events and content-free classifications; it does not record artifact paths or URLs, artifact titles, screen names, theme names, file contents, or user-authored text.
74
86
 
75
- If the user wants to opt out, you turn telemetry off for them by running `tv telemetry disable` against the running server (`tv telemetry enable` turns it back on); `tv status` reports the current telemetry state. The command needs a live server. Television also honors the standard `DO_NOT_TRACK` environment variable when it is set, but `tv telemetry disable` is the intended way to opt out. When an agent operates the server, start it with `tv serve --installed-by-agent <agent-runtime-harness-name>` so Television can record the agent runtime harness name without recording user content. Use the software running the agent, such as Codex, Claude Code, Hermes, OpenClaw, or Pi; do not use a personalized nickname, persona name, model name, or any value with version numbers or qualifiers.
87
+ If the user wants to opt out, you turn telemetry off for them by running `tv telemetry disable` against the running server (`tv telemetry enable` turns it back on); `tv status` reports the current telemetry state. The command needs a live server. Television also honors the standard `DO_NOT_TRACK` environment variable when it is set, but `tv telemetry disable` is the intended way to opt out. Install- and upgrade-time telemetry duties — the disclosure to give the user and the `--installed-by-agent` flag are covered in the admin guide (see the Administration section above).
76
88
 
77
89
  ## Related skills
78
90
 
@@ -126,13 +138,9 @@ When the CLI rejects a command, follow the directive it prints rather than guess
126
138
 
127
139
  ### Server operation notes
128
140
 
129
- `tv serve` starts the local server. Use `tv serve --auth` for normal operation and every agent-managed install; bare `tv serve` still binds `127.0.0.1` and is tokenless for compatibility. Do not present auth/no-auth as a setup decision: work out network reach with the user, then install with `--auth`. Tokenless starts print a warning because local processes and browser pages the operator opens can control the server. Use `--no-auth` only if the user explicitly asks to run without a token. Use `--listen <ipv4>` (repeatable or comma-separated) to add IPv4 listeners; any `--listen` requires an explicit global auth choice, and agents supply `--auth`. Workflow commands connect to `localhost:<port>` only; use `--port`, `TELEVISION_PORT`, or the default `32848` rather than `--server`. When targeting non-default storage, pass `--storage-path` or set `TELEVISION_STORAGE_PATH` so the CLI reads the matching token from `<storagePath>/state/token`.
130
-
131
- `tv serve --persist` installs or refreshes the user system service. It captures the serve flags and relevant environment at install time (`--listen`, `--auth`/`--no-auth`, `--port`, `--storage-path`, `PATH`, `TELEVISION_PORT`, `TELEVISION_STORAGE_PATH`). Rerun it after changing listen/auth/port settings, PATH, or the Node/TV install. The refresh is non-atomic: if uninstall succeeds but install fails, fix the env and rerun `tv serve --persist`.
132
-
133
- `tv serve --persist-uninstall` removes the service and is equivalent to `tv stop`. Both are idempotent and print `{ "status": "stopped" }` whether or not a service was installed.
141
+ `tv status` reports server health and, when supported, system service status. Workflow commands connect to `localhost:<port>` only; use `--port`, `TELEVISION_PORT`, or the default `32848` rather than `--server`. When targeting non-default storage, pass `--storage-path` or set `TELEVISION_STORAGE_PATH` so the CLI reads the matching token from `<storagePath>/state/token`.
134
142
 
135
- `tv status` reports server health and, when supported, system service status.
143
+ Starting, installing, upgrading, or reconfiguring the server — `tv serve` flags, listeners, auth and tokens, ports, the persistent daemon (`--persist`), stopping and uninstalling (`tv stop`) — is administrator work covered by the deployed admin guide, not this skill. Before doing any of it, fetch the full raw guide as described in the Administration section of this skill; do not work from the command names alone or from a summary.
136
144
 
137
145
  ## Read vs mutate
138
146