@telepath-computer/television 0.1.157 → 0.1.158

package/dist/cli.cjs

@@ -48121,6 +48121,16 @@ function hasTrailingSeparator(value) {
   const last = value.at(-1);
   return last === "/" || last === "\\";
 }
+function stripTrailingSeparators(value) {
+  let end = value.length;
+  while (end > 1 && (value[end - 1] === "/" || value[end - 1] === "\\")) {
+    end -= 1;
+  }
+  if (end === 2 && end < value.length && /^[A-Za-z]:$/.test(value.slice(0, 2))) {
+    end += 1;
+  }
+  return value.slice(0, end);
+}
 function artifactBasename(value) {
   const slash = value.lastIndexOf("/");
   const backslash = value.lastIndexOf("\\");
@@ -50374,8 +50384,7 @@ var ServerStore = class extends EventTarget {
       if (input.fields.url !== void 0) {
         throw new InvalidRequestError("artifact patch cannot set both path and url");
       }
-      const artifactPath = input.fields.path.trim();
-      this.validateArtifactPath(artifactPath);
+      const artifactPath = this.normalizeArtifactPath(input.fields.path.trim());
       pointerChanged = artifactPath !== artifact.path;
       updated = { ...updated, path: artifactPath };
     }
@@ -50752,8 +50761,7 @@ var ServerStore = class extends EventTarget {
         if (input.url !== void 0) {
           throw new InvalidRequestError("path artifacts cannot set url");
         }
-        const artifactPath = input.path.trim();
-        this.validateArtifactPath(artifactPath);
+        const artifactPath = this.normalizeArtifactPath(input.path.trim());
         return createArtifact({ ...input.id ? { id: input.id } : {}, kind: "path", title: input.title, path: artifactPath });
       }
       case "url": {
@@ -50771,32 +50779,40 @@ var ServerStore = class extends EventTarget {
       }
     }
   }
-  validateArtifactPath(artifactPath) {
+  /**
+   * Classify the supplied path by what is on disk and return the canonical
+   * form to persist: directory paths always end with a trailing separator,
+   * file paths never do. Callers may supply either form; the trailing
+   * separator on the stored string is a server-maintained invariant that
+   * routing (proxy, watcher, markdown gating, client dispatch) relies on
+   * without statting.
+   */
+  normalizeArtifactPath(artifactPath) {
     if (!import_node_path11.default.isAbsolute(artifactPath)) {
       throw new InvalidRequestError("path must be absolute");
     }
+    const stripped = stripTrailingSeparators(artifactPath);
     let stat;
     try {
-      (0, import_node_fs9.accessSync)(artifactPath, import_node_fs9.constants.R_OK);
-      stat = (0, import_node_fs9.statSync)(artifactPath);
+      (0, import_node_fs9.accessSync)(stripped, import_node_fs9.constants.R_OK);
+      stat = (0, import_node_fs9.statSync)(stripped);
     } catch {
       throw new InvalidRequestError(`path does not exist or is not readable: ${artifactPath}`);
     }
-    if (hasTrailingSeparator(artifactPath)) {
-      if (!stat.isDirectory()) {
-        throw new InvalidRequestError(`directory artifact path must resolve to a directory: ${artifactPath}`);
+    if (stat.isDirectory()) {
+      const canonical = hasTrailingSeparator(stripped) ? stripped : `${stripped}${import_node_path11.default.sep}`;
+      if (!DIRECTORY_INDEX_BASENAMES.some((basename) => (0, import_node_fs9.existsSync)(import_node_path11.default.join(canonical, basename)))) {
+        throw new InvalidRequestError(`directory artifact must contain index.html or index.htm: ${canonical}`);
       }
-      if (!DIRECTORY_INDEX_BASENAMES.some((basename) => (0, import_node_fs9.existsSync)(import_node_path11.default.join(artifactPath, basename)))) {
-        throw new InvalidRequestError(`directory artifact must contain index.html or index.htm: ${artifactPath}`);
-      }
-      return;
+      return canonical;
     }
     if (!stat.isFile()) {
-      throw new InvalidRequestError(`file artifact path must resolve to a regular file: ${artifactPath}`);
+      throw new InvalidRequestError(`path must resolve to a regular file or directory: ${artifactPath}`);
     }
-    if (!isAllowedArtifactFilePath(artifactPath)) {
-      throw new InvalidRequestError(`path extension must be one of .md, .markdown, .htm, .html: ${artifactPath}`);
+    if (!isAllowedArtifactFilePath(stripped)) {
+      throw new InvalidRequestError(`path extension must be one of .md, .markdown, .htm, .html: ${stripped}`);
     }
+    return stripped;
   }
   canInstallOnboardingArtifact() {
     return !(0, import_node_fs9.existsSync)(getOnboardingArtifactSentinelPath(this.storagePath)) && !this._artifacts.has(ONBOARDING_ARTIFACT_ID) && this.onboardingArtifactSourcePath !== void 0;
@@ -51045,8 +51061,8 @@ function resolveVercelSkillsInstallerBin() {
   return localRequire.resolve("skills/bin/cli.mjs");
 }
 function readCLIVersion() {
-  if ("0.1.157".length > 0) {
-    return "0.1.157";
+  if ("0.1.158".length > 0) {
+    return "0.1.158";
   }
   const devPackageJsonPath = import_node_path12.default.join(getDevPackageDir(), "package.json");
   if (!(0, import_node_fs10.existsSync)(devPackageJsonPath)) {
@@ -51506,8 +51522,8 @@ function createProgram(env, argv = []) {
     });
   });
   program2.command("create-path-artifact").description(
-    "Create a path artifact that points at an existing absolute markdown or HTML file, or at a directory path ending in a separator with an index.html/index.htm. Television records the pointer only; HTML and directory targets are read-only, and markdown targets are written through only by in-UI editor saves via PUT /markdown/<id>."
-  ).requiredOption("--screen <id>", "Target screen ID").requiredOption("--title <title>", "Artifact title").requiredOption("--path <path>", "Absolute path to an existing markdown/HTML file or indexed directory").option("--focus-artifact", "Focus the new artifact after creation").option("--no-focus", "Create the artifact in the background without changing focus").option("--port <number>", "Server port", parsePortOption).option("--storage-path <path>", "Directory containing the Television token").addHelpText("after", buildArtifactWorkflowHelpNote(true)).action(async (opts) => {
+    "Create a path artifact that points at an existing absolute markdown or HTML file, or at a directory with a root index.html/index.htm (trailing separator optional; the server detects file vs directory on disk). Television records the pointer only; HTML and directory targets are read-only, and markdown targets are written through only by in-UI editor saves via PUT /markdown/<id>."
+  ).requiredOption("--screen <id>", "Target screen ID").requiredOption("--title <title>", "Artifact title").requiredOption("--path <path>", "Absolute path to an existing markdown/HTML file or indexed directory (trailing separator optional)").option("--focus-artifact", "Focus the new artifact after creation").option("--no-focus", "Create the artifact in the background without changing focus").option("--port <number>", "Server port", parsePortOption).option("--storage-path <path>", "Directory containing the Television token").addHelpText("after", buildArtifactWorkflowHelpNote(true)).action(async (opts) => {
     const shouldFocus = resolveFocusDirective(argv, "create-path-artifact", "--focus-artifact");
     const artifactPath = opts.path.trim();
     const client = createAuthenticatedClient(opts);
@@ -51544,10 +51560,21 @@ function createProgram(env, argv = []) {
     writeJSON(env.stdout, { storagePath: getTelevisionStoragePath() });
   });
   program2.command("update-artifact").description(
-    "Update artifact metadata in place. Currently only --title is changeable; ID, kind, path, and URL are immutable in this slice."
-  ).requiredOption("--id <id>", "Artifact ID").requiredOption("--title <title>", "New title").option("--port <number>", "Server port", parsePortOption).option("--storage-path <path>", "Directory containing the Television token").action(async (opts) => {
+    "Update artifact metadata in place: --title on any artifact, --path to repoint a path artifact, --url to repoint a URL artifact. ID and kind are immutable. The server validates the new pointer; for path artifacts the target must exist (trailing separator optional) and the content watcher follows it."
+  ).requiredOption("--id <id>", "Artifact ID").option("--title <title>", "New title").option("--path <path>", "New absolute path for a path artifact: markdown/HTML file or indexed directory (trailing separator optional)").option("--url <url>", "New http(s) URL for a URL artifact").option("--port <number>", "Server port", parsePortOption).option("--storage-path <path>", "Directory containing the Television token").action(async (opts) => {
+    if (opts.title === void 0 && opts.path === void 0 && opts.url === void 0) {
+      throw createDirectiveError("tv update-artifact requires at least one of --title, --path, or --url.");
+    }
+    if (opts.path !== void 0 && opts.url !== void 0) {
+      throw createDirectiveError("tv update-artifact accepts --path or --url, not both; an artifact's kind is immutable.");
+    }
     const client = createAuthenticatedClient(opts);
-    await client.artifacts.update({ artifactID: opts.id, title: opts.title });
+    await client.artifacts.update({
+      artifactID: opts.id,
+      ...opts.title !== void 0 ? { title: opts.title } : {},
+      ...opts.path !== void 0 ? { path: opts.path.trim() } : {},
+      ...opts.url !== void 0 ? { url: opts.url.trim() } : {}
+    });
     writeLine(env.stdout, `Artifact ${opts.id} updated.`);
   });
   program2.command("delete-artifact").description(

package/dist/skills/television/SKILL.md

@@ -113,7 +113,7 @@ Commands group into four intents:
 
 - **Screen and display commands** — create, inspect, remove, or switch screens, or change the active display theme (`create-screen`, `list-screens`, `get-screen`, `remove-screen`, `focus-screen`, `focus-status`, `set-theme`).
 - **Artifact creation commands** — register path or URL artifacts (`create-path-artifact`, `create-url-artifact`).
-- **Artifact management commands** — inspect, retitle, focus, list, or delete existing artifacts (`delete-artifact`, `get-artifact`, `list-artifacts`, `update-artifact`, `focus-artifact`).
+- **Artifact management commands** — inspect, retitle, repoint, focus, list, or delete existing artifacts (`delete-artifact`, `get-artifact`, `list-artifacts`, `update-artifact`, `focus-artifact`).
 - **Server and environment commands** — operate on the Television server itself (`serve`, `status`, `stop`, `storage-path`, `skills install`).
 
 When the CLI rejects a command, follow the directive it prints rather than guessing flags.
@@ -270,9 +270,9 @@ Always tell the user where you put the file.
 
 - **Single markdown file** ending in `.md` or `.markdown`
 - **Single HTML file** ending in `.htm` or `.html`
-- **HTML directory** — a path ending in `/` or `\` whose root contains `index.html` or `index.htm`, plus any sibling assets
+- **HTML directory** — a directory whose root contains `index.html` or `index.htm`, plus any sibling assets
 
-The path must be absolute, existing, and readable by the server.
+The path must be absolute, existing, and readable by the server. A trailing separator is optional — the server checks the path on disk to decide whether it is a file or a directory.
 
 ## Authoring quality
 
@@ -348,10 +348,10 @@ Single-file example:
 tv create-path-artifact --screen "<screen-id>" --title "Artifact title" --path /absolute/path/to/report.html --focus-artifact
 ```
 
-Directory example:
+Directory example (trailing slash optional):
 
 ```bash
-tv create-path-artifact --screen "<screen-id>" --title "Artifact title" --path /absolute/path/to/dashboard/ --focus-artifact
+tv create-path-artifact --screen "<screen-id>" --title "Artifact title" --path /absolute/path/to/dashboard --focus-artifact
 ```
 
 A directory artifact needs root `index.html` or `index.htm`. Keep sibling assets relative so they resolve through the artifact proxy:
@@ -401,6 +401,15 @@ To retitle an artifact:
 tv update-artifact --id "<artifact-id>" --title "New title"
 ```
 
+To repoint an artifact at different content (same kind only — a path artifact takes `--path`, a URL artifact takes `--url`):
+
+```bash
+tv update-artifact --id "<artifact-id>" --path /absolute/path/to/new-target
+tv update-artifact --id "<artifact-id>" --url "https://example.com/next"
+```
+
+The new path follows the same rules as creation (file or indexed directory, trailing separator optional). Rendering follows the new pointer immediately, and for path artifacts the content watcher retargets with it. Prefer repointing over delete-and-recreate when the artifact should keep its identity and screen placement.
+
 Artifact repositioning on its current screen is a browser UI drag/drop gesture; the CLI does not expose layout mutation today.
 
 To move the same underlying path or URL to another screen, delete the existing artifact and create a new one on the target screen with the same `--path` or `--url`.