@telepath-computer/television 0.1.83 → 0.1.84

package/dist/cli.cjs

@@ -50093,10 +50093,18 @@ function findCardIDInNode(node, artifactID) {
 var import_meta = {};
 var DAEMON_NAME = "com.television.server";
 var MAX_PORT = 65535;
-var HELP_POINTER = "Load/read the installed `television` skill. Start with `SKILL.md` for the mental model and the artifact-vs-chat decision. If the skill is not installed, you can use `tv skills install` (interactive, not agent-friendly) or `tv skills show` (agent-friendly, prints bundled skill files directly). For CLI commands, focus, and screen placement, read `cli-capabilities.md`. For artifact lifecycle work, read `artifact-workflow.md`. For HTML artifact work, also read `html-house-style.md` and the relevant `artifact-types/*.md` companion doc.";
+var HELP_POINTER = "Load/read the installed `television` skill. If the skill is not installed, the bundled content is reachable via `tv skills show` \u2014 no arguments lists the relative paths and their descriptions; passing a relative path prints that file. Key relative paths (arguments to `tv skills show`): `SKILL.md` for the mental model and the artifact-vs-chat decision; `cli-capabilities.md` for commands, focus, and screen placement; `artifact-workflow.md` for artifact lifecycle work; `html-house-style.md` for HTML artifact authoring; `artifact-types/<kind>.md` for kind-specific authoring.";
 var CLIDirectiveError = class extends Error {
   name = "CLIDirectiveError";
 };
+var CLISilentExitError = class extends Error {
+  name = "CLISilentExitError";
+  silentExitCode;
+  constructor(silentExitCode = 1) {
+    super("");
+    this.silentExitCode = silentExitCode;
+  }
+};
 function writeJSON(output, value) {
   output.write(`${JSON.stringify(value)}
 `);
@@ -50123,8 +50131,8 @@ function resolveVercelSkillsInstallerBin() {
   return localRequire.resolve("skills/bin/cli.mjs");
 }
 function readCLIVersion() {
-  if ("0.1.83".length > 0) {
-    return "0.1.83";
+  if ("0.1.84".length > 0) {
+    return "0.1.84";
   }
   const devPackageJsonPath = import_node_path7.default.join(getDevPackageDir(), "package.json");
   if (!(0, import_node_fs4.existsSync)(devPackageJsonPath)) {
@@ -50151,24 +50159,30 @@ function buildAgentHelpNote() {
     "",
     "Agent workflow note:",
     "  Load/read the installed `television` skill before Television work.",
-    "  `SKILL.md` carries the mental model and the artifact-vs-chat decision.",
-    "  `cli-capabilities.md` covers commands, focus, and screen placement.",
-    "  For artifact lifecycle work, read `artifact-workflow.md`.",
-    "  For HTML artifacts, also read `html-house-style.md`.",
-    "  Known artifact-type docs:",
-    formatArtifactTypeDocsList(),
-    "  If the Television skill is not installed, you can use `tv skills install` (interactive) or `tv skills show` (agent-friendly, prints the bundled skill files directly)."
+    "  If the skill is not installed, the bundled content is reachable via the CLI:",
+    "    tv skills show                     lists relative paths and descriptions",
+    "    tv skills show <relative-path>     prints one file",
+    "  Key relative paths (arguments to `tv skills show`):",
+    "    SKILL.md             \u2014 mental model and artifact-vs-chat decision",
+    "    cli-capabilities.md  \u2014 commands, focus, screen placement",
+    "    artifact-workflow.md \u2014 artifact lifecycle",
+    "    html-house-style.md  \u2014 HTML artifact authoring",
+    "  Known artifact-type relative paths:",
+    formatArtifactTypeDocsList()
   ].join("\n");
 }
 function buildArtifactWorkflowHelpNote(includeHTMLNote) {
   const lines = [
     "",
     "Agent note:",
-    "  If you are an agent doing artifact lifecycle work, load/read the `television` skill and `artifact-workflow.md`."
+    "  If you are an agent doing artifact lifecycle work, load/read the `television` skill \u2014 in particular `artifact-workflow.md`.",
+    "  If the skill is not installed, read it with `tv skills show artifact-workflow.md`."
   ];
   if (includeHTMLNote) {
-    lines.push("  If you are authoring an HTML artifact, also read `html-house-style.md`.");
-    lines.push("  Known artifact-type docs:");
+    lines.push(
+      "  If you are authoring an HTML artifact, also read `html-house-style.md` (`tv skills show html-house-style.md`)."
+    );
+    lines.push("  Known artifact-type relative paths (arguments to `tv skills show`):");
     lines.push(formatArtifactTypeDocsList());
   }
   return lines.join("\n");
@@ -50215,17 +50229,33 @@ function listSkillFiles(skillRoot, prefix = "") {
 function resolveSkillFilePath(skillRoot, relativePath) {
   const normalized = import_node_path7.default.posix.normalize(relativePath);
   if (normalized.startsWith("../") || normalized === ".." || import_node_path7.default.isAbsolute(relativePath)) {
-    throw createDirectiveError("tv skills show requires a relative path within the television skill root.");
+    return { kind: "invalid-path" };
   }
   const resolved = import_node_path7.default.join(skillRoot, normalized);
   const relativeResolved = import_node_path7.default.relative(skillRoot, resolved);
   if (relativeResolved.startsWith("..") || import_node_path7.default.isAbsolute(relativeResolved)) {
-    throw createDirectiveError("tv skills show requires a relative path within the television skill root.");
+    return { kind: "invalid-path" };
   }
   if (!(0, import_node_fs4.existsSync)(resolved)) {
-    throw createDirectiveError(`tv skills show could not find ${relativePath} in the television skill.`);
+    return { kind: "not-found" };
   }
-  return resolved;
+  return { kind: "ok", absolutePath: resolved };
+}
+function writeSkillListing(stdout, skillRoot) {
+  const manifest = readSkillManifest(skillRoot);
+  if (manifest.version !== void 0) {
+    writeLine(stdout, `Television skill content version: ${manifest.version}`);
+    writeLine(stdout, "");
+  }
+  writeLine(stdout, "Relative paths inside the bundled `television` skill:");
+  writeLine(stdout, "");
+  for (const file2 of listSkillFiles(skillRoot)) {
+    const description = manifest.descriptions.get(file2);
+    writeLine(stdout, description ? `${file2} \u2014 ${description}` : file2);
+  }
+  writeLine(stdout, "");
+  writeLine(stdout, `Television skill root: ${skillRoot}`);
+  writeLine(stdout, "To read one file directly: tv skills show <relative-path>");
 }
 function commandNameFromArgv(argv) {
   const commandName = argv.find((value) => !value.startsWith("-"));
@@ -50777,24 +50807,19 @@ If you wish to display temporary content to the user, use an internal artifact i
       throw new Error(`Could not resolve the bundled television skill root at ${skillRoot}.`);
     }
     if (relativePath === void 0) {
-      const manifest = readSkillManifest(skillRoot);
-      if (manifest.version !== void 0) {
-        writeLine(env.stdout, `Television skill content version: ${manifest.version}`);
-        writeLine(env.stdout, "");
-      }
-      writeLine(env.stdout, "Relative paths inside the bundled `television` skill:");
-      writeLine(env.stdout, "");
-      for (const file2 of listSkillFiles(skillRoot)) {
-        const description = manifest.descriptions.get(file2);
-        writeLine(env.stdout, description ? `${file2} \u2014 ${description}` : file2);
-      }
-      writeLine(env.stdout, "");
-      writeLine(env.stdout, `Television skill root: ${skillRoot}`);
-      writeLine(env.stdout, "To read one file directly: tv skills show <relative-path>");
+      writeSkillListing(env.stdout, skillRoot);
+      return;
+    }
+    const result = resolveSkillFilePath(skillRoot, relativePath);
+    if (result.kind === "ok") {
+      env.stdout.write((0, import_node_fs4.readFileSync)(result.absolutePath, "utf8"));
       return;
     }
-    const filepath = resolveSkillFilePath(skillRoot, relativePath);
-    env.stdout.write((0, import_node_fs4.readFileSync)(filepath, "utf8"));
+    const preamble = result.kind === "invalid-path" ? `tv skills show: "${relativePath}" is not a relative path inside the bundled television skill.` : `tv skills show: no bundled Television skill file at "${relativePath}".`;
+    writeLine(env.stdout, preamble);
+    writeLine(env.stdout, "");
+    writeSkillListing(env.stdout, skillRoot);
+    throw new CLISilentExitError(1);
   });
   program2.command("stop").description("Stop the Television system service").action(async () => {
     const daemon = env.createDaemon();
@@ -50837,6 +50862,9 @@ async function runCLI(argv, environment = {}) {
     await program2.parseAsync(argv, { from: "user" });
     return 0;
   } catch (error48) {
+    if (error48 instanceof CLISilentExitError) {
+      return error48.silentExitCode;
+    }
     if (error48 instanceof Error && "exitCode" in error48) {
       const commanderError = error48;
       if (commanderError.exitCode === 0) return 0;