@telepath-computer/television 0.1.83 → 0.1.85

package/dist/cli.cjs

@@ -50093,7 +50093,7 @@ 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 = "Television guidance is split across bundled skills. For screens, lifecycle work, and the `tv` CLI, read the `television` skill. For artifact authoring, use `tv skills install` or `tv skills show`, then let the matching `artifact-*` skill guide the output.";
 var CLIDirectiveError = class extends Error {
   name = "CLIDirectiveError";
 };
@@ -50123,8 +50123,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.85".length > 0) {
+    return "0.1.85";
   }
   const devPackageJsonPath = import_node_path7.default.join(getDevPackageDir(), "package.json");
   if (!(0, import_node_fs4.existsSync)(devPackageJsonPath)) {
@@ -50132,101 +50132,80 @@ function readCLIVersion() {
   }
   return JSON.parse((0, import_node_fs4.readFileSync)(devPackageJsonPath, "utf8")).version;
 }
-function listKnownArtifactTypeDocs() {
-  if ('["artifact-types/calendar.md","artifact-types/table.md"]'.length > 0) {
-    return JSON.parse('["artifact-types/calendar.md","artifact-types/table.md"]');
-  }
-  const televisionSkillsWorkspaceDir = import_node_path7.default.resolve(getDevPackageDir(), "../skills");
-  if (!(0, import_node_fs4.existsSync)(televisionSkillsWorkspaceDir)) {
-    return [];
-  }
-  return (0, import_node_fs4.readdirSync)(televisionSkillsWorkspaceDir, { withFileTypes: true }).filter((entry) => entry.isDirectory() && /^artifact-/.test(entry.name)).map((entry) => entry.name.slice("artifact-".length)).sort((a, b) => a.localeCompare(b)).map((slug) => `artifact-types/${slug}.md`);
-}
-function formatArtifactTypeDocsList() {
-  const docs = listKnownArtifactTypeDocs();
-  return docs.length > 0 ? docs.map((doc) => `  - ${doc}`).join("\n") : "  - artifact-types/<name>.md";
+var FRONTMATTER_DELIMITER = "---\n";
+var FRONTMATTER_DELIMITER_LENGTH = FRONTMATTER_DELIMITER.length;
+function splitFrontmatter(text) {
+  if (!text.startsWith(FRONTMATTER_DELIMITER)) {
+    return { frontmatter: {}, body: text };
+  }
+  const closing = text.indexOf("\n---", FRONTMATTER_DELIMITER_LENGTH);
+  if (closing === -1) {
+    return { frontmatter: {}, body: text };
+  }
+  const block = text.slice(FRONTMATTER_DELIMITER_LENGTH, closing);
+  const after = text.slice(closing + FRONTMATTER_DELIMITER_LENGTH);
+  const body = after.startsWith("\n") ? after.slice(1) : after;
+  const frontmatter = {};
+  for (const rawLine of block.split("\n")) {
+    const line = rawLine.trim();
+    if (line === "" || line.startsWith("#")) continue;
+    const colon = line.indexOf(":");
+    if (colon === -1) continue;
+    const key = line.slice(0, colon).trim();
+    let value = line.slice(colon + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    frontmatter[key] = value;
+  }
+  return { frontmatter, body };
+}
+function readBundledSkill(skillRoot) {
+  const skillMarkdownPath = import_node_path7.default.join(skillRoot, "SKILL.md");
+  if (!(0, import_node_fs4.existsSync)(skillMarkdownPath)) {
+    throw new Error(`Bundled skill is missing SKILL.md at ${skillMarkdownPath}.`);
+  }
+  const markdown = (0, import_node_fs4.readFileSync)(skillMarkdownPath, "utf8");
+  const { frontmatter } = splitFrontmatter(markdown);
+  const name = frontmatter.name?.trim();
+  const description = frontmatter.description?.trim();
+  if (!name || !description) {
+    throw new Error(`Bundled skill has invalid frontmatter at ${skillMarkdownPath}.`);
+  }
+  return { name, description, markdown, root: skillRoot };
+}
+function listBundledSkills(collectionRoot) {
+  return (0, import_node_fs4.readdirSync)(collectionRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => readBundledSkill(import_node_path7.default.join(collectionRoot, entry.name))).sort((a, b) => a.name.localeCompare(b.name));
+}
+function resolveBundledSkill(collectionRoot, skillName) {
+  const skillRoot = import_node_path7.default.join(collectionRoot, skillName);
+  if (!(0, import_node_fs4.existsSync)(skillRoot)) {
+    throw createDirectiveError(`tv skills show could not find bundled skill \`${skillName}\`.`);
+  }
+  return readBundledSkill(skillRoot);
 }
 function buildAgentHelpNote() {
   return [
     "",
     "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)."
+    "  Television guidance is split across bundled skills.",
+    "  For screens, lifecycle work, and the `tv` CLI, read `television`.",
+    "  For artifact authoring, install or inspect the bundled skills with `tv skills install` or `tv skills show`.",
+    "  Then use the matching `artifact-*` skill, such as `artifact-calendar` or `artifact-table`."
   ].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`."
+    "  For Television lifecycle work, read `television`."
   ];
   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(formatArtifactTypeDocsList());
+    lines.push("  For artifact authoring, install or inspect the bundled skills with `tv skills install` or `tv skills show`.");
+    lines.push("  Then use the matching `artifact-*` skill, such as `artifact-calendar` or `artifact-table`.");
   }
   return lines.join("\n");
 }
-function getBundledTelevisionSkillRoot(bundledTelevisionSkillsCollectionRoot) {
-  return import_node_path7.default.join(bundledTelevisionSkillsCollectionRoot, "television");
-}
-function readSkillManifest(skillRoot) {
-  const empty = { version: void 0, descriptions: /* @__PURE__ */ new Map() };
-  const manifestPath = import_node_path7.default.join(skillRoot, ".skill-manifest.json");
-  if (!(0, import_node_fs4.existsSync)(manifestPath)) return empty;
-  try {
-    const raw = (0, import_node_fs4.readFileSync)(manifestPath, "utf8");
-    const parsed = JSON.parse(raw);
-    if (typeof parsed !== "object" || parsed === null) return empty;
-    const root = parsed;
-    const version2 = typeof root.version === "string" ? root.version : void 0;
-    const files = Array.isArray(root.files) ? root.files : [];
-    const entries = [];
-    for (const entry of files) {
-      if (typeof entry === "object" && entry !== null && typeof entry.path === "string" && typeof entry.description === "string") {
-        entries.push([entry.path, entry.description]);
-      }
-    }
-    return { version: version2, descriptions: new Map(entries) };
-  } catch {
-    return empty;
-  }
-}
-function listSkillFiles(skillRoot, prefix = "") {
-  const entries = (0, import_node_fs4.readdirSync)(skillRoot, { withFileTypes: true }).filter((entry) => !entry.name.startsWith(".")).sort((a, b) => a.name.localeCompare(b.name));
-  const files = [];
-  for (const entry of entries) {
-    const relativePath = prefix === "" ? entry.name : import_node_path7.default.posix.join(prefix, entry.name);
-    const absolutePath = import_node_path7.default.join(skillRoot, entry.name);
-    if (entry.isDirectory()) {
-      files.push(...listSkillFiles(absolutePath, relativePath));
-      continue;
-    }
-    files.push(relativePath);
-  }
-  return files;
-}
-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.");
-  }
-  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.");
-  }
-  if (!(0, import_node_fs4.existsSync)(resolved)) {
-    throw createDirectiveError(`tv skills show could not find ${relativePath} in the television skill.`);
-  }
-  return resolved;
-}
 function commandNameFromArgv(argv) {
   const commandName = argv.find((value) => !value.startsWith("-"));
   return commandName ?? "tv";
@@ -50287,7 +50266,7 @@ function resolveBundledSkillsRoot() {
   if (builtPath && (0, import_node_fs4.existsSync)(builtPath)) {
     return builtPath;
   }
-  const devPath = import_node_path7.default.resolve(getDevPackageDir(), "../skills/dist/skills");
+  const devPath = import_node_path7.default.resolve(getDevPackageDir(), "../skills/dist");
   return (0, import_node_fs4.existsSync)(devPath) ? devPath : void 0;
 }
 function isInTempDirectory(inputPath) {
@@ -50747,11 +50726,11 @@ If you wish to display temporary content to the user, use an internal artifact i
     const result = await client.viewer.focus(focusInput);
     writeLine(env.stdout, `Focused artifact ${result.artifactID} on screen ${result.screenID}.`);
   });
-  const skillsCommand = program2.command("skills").description("Install the bundled Television skill").addHelpText("after", [
+  const skillsCommand = program2.command("skills").description("Manage the bundled Television skills").addHelpText("after", [
     "",
-    "This command group manages the bundled `television` skill.",
-    "`tv skills install` installs or reinstalls it globally through the `skills` package.",
-    "`tv skills show` lists bundled skill files or prints one directly, which is useful for agents that need the content without running the interactive installer."
+    "This command group manages the bundled Television skill collection.",
+    "`tv skills install` installs or reinstalls every bundled Television skill globally through the `skills` package.",
+    "`tv skills show` lists each bundled skill or prints one SKILL.md directly, which is useful for agents that need the content without running the interactive installer."
   ].join("\n"));
   skillsCommand.command("path").description("Print the bundled Television skills collection root").action(() => {
     const bundledTelevisionSkillsCollectionRoot = env.resolveBundledSkillsRoot();
@@ -50760,41 +50739,36 @@ If you wish to display temporary content to the user, use an internal artifact i
     }
     writeLine(env.stdout, bundledTelevisionSkillsCollectionRoot);
   });
-  skillsCommand.command("install").description("Install or reinstall the bundled Television skill globally").allowUnknownOption(true).action(async function() {
+  skillsCommand.command("install").description("Install or reinstall all bundled Television skills globally").allowUnknownOption(true).action(async function() {
     const bundledTelevisionSkillsCollectionRoot = env.resolveBundledSkillsRoot();
     if (!bundledTelevisionSkillsCollectionRoot) {
       throw new Error("Could not resolve the bundled Television skills root.");
     }
     await env.runSkillsInstaller(["add", bundledTelevisionSkillsCollectionRoot, "--global"]);
   });
-  skillsCommand.command("show").description("List bundled Television skill files or print one by relative path").argument("[path]", "Relative path within the television skill root").action((relativePath) => {
+  skillsCommand.command("show").description("List bundled Television skills or print one SKILL.md by name").argument("[skill]", "Bundled skill name").action((skillName) => {
     const bundledTelevisionSkillsCollectionRoot = env.resolveBundledSkillsRoot();
     if (!bundledTelevisionSkillsCollectionRoot) {
       throw new Error("Could not resolve the bundled Television skills root.");
     }
-    const skillRoot = getBundledTelevisionSkillRoot(bundledTelevisionSkillsCollectionRoot);
-    if (!(0, import_node_fs4.existsSync)(skillRoot)) {
-      throw new Error(`Could not resolve the bundled television skill root at ${skillRoot}.`);
+    if (skillName === void 0) {
+      const bundledSkills = listBundledSkills(bundledTelevisionSkillsCollectionRoot);
+      bundledSkills.forEach((skill2, index) => {
+        writeLine(env.stdout, `${skill2.name} \u2014 ${skill2.description}`);
+        writeLine(env.stdout, `  ${skill2.root}`);
+        if (index < bundledSkills.length - 1) {
+          writeLine(env.stdout, "");
+        }
+      });
+      return;
     }
-    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:");
+    const skill = resolveBundledSkill(bundledTelevisionSkillsCollectionRoot, skillName);
+    writeLine(env.stdout, `Path: ${skill.root}`);
+    writeLine(env.stdout, "---");
+    env.stdout.write(skill.markdown);
+    if (!skill.markdown.endsWith("\n")) {
       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>");
-      return;
     }
-    const filepath = resolveSkillFilePath(skillRoot, relativePath);
-    env.stdout.write((0, import_node_fs4.readFileSync)(filepath, "utf8"));
   });
   program2.command("stop").description("Stop the Television system service").action(async () => {
     const daemon = env.createDaemon();

package/dist/skills/{television/artifact-types/calendar.md → artifact-calendar/SKILL.md}

@@ -1,29 +1,37 @@
 ---
-description: Authoring conventions for the calendar artifact kind.
+name: artifact-calendar
+description: Author self-contained HTML calendar artifacts using the bundled calendar-week elements and copied calendar assets.
 ---
 
 # Authoring a calendar week
 
+Before authoring the artifact, read `house-style.md` in this skill folder.
+
 A working-week calendar with a generated header strip, all-day band, time axis,
 and timed event grid. The agent only authors a single `<calendar-week>` plus
 flat sibling `<calendar-event>` children. The component renders the rest.
 
 ## Required assets
 
-Every calendar artifact must load both the canonical stylesheet and the
-calendar element bundle:
+Every calendar artifact must be self-contained. Read `calendar.css` and
+`calendar.js` from this skill folder and carry them into the artifact output
+instead of referencing `/skills/artifact-calendar/...` URLs.
+
+For a Television internal artifact bundle, copy both files into the artifact's
+`public/` directory and reference them relatively:
 
 ```html
 <link rel="stylesheet" href="/canonical/v1/styles.css" />
-<link rel="stylesheet" href="/skills/artifact-calendar/calendar.css" />
-<script type="module" src="/skills/artifact-calendar/calendar.js"></script>
+<link rel="stylesheet" href="./calendar.css" />
+<script type="module" src="./calendar.js"></script>
 ```
 
-`/skills/artifact-calendar/calendar.js` and
-`/skills/artifact-calendar/calendar.css` are the built skill-local assets
-served by artifactory from the package's `dist/` output. They register the
-custom elements and provide the calendar-specific chrome styling. Do not
-inline or reimplement those elements yourself.
+For a standalone single-file HTML artifact, inline the contents of
+`calendar.css` and `calendar.js` directly into `<style>` and
+`<script type="module">` tags so the output stays self-contained.
+
+`calendar.js` registers the custom elements. `calendar.css` provides the
+calendar-specific chrome styling. Do not reimplement those elements yourself.
 
 ## Markup contract
 
@@ -119,8 +127,8 @@ Those are internal chrome and CSS targets created by `<calendar-week>`.
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>Team Week</title>
     <link rel="stylesheet" href="/canonical/v1/styles.css" />
-    <link rel="stylesheet" href="/skills/artifact-calendar/calendar.css" />
-    <script type="module" src="/skills/artifact-calendar/calendar.js"></script>
+    <link rel="stylesheet" href="./calendar.css" />
+    <script type="module" src="./calendar.js"></script>
     <style>
       html, body { margin: 0; min-height: 100vh; }
       calendar-week { height: 100vh; }

package/dist/skills/artifact-calendar/calendar.css

@@ -0,0 +1 @@
+calendar-event{display:contents}calendar-event .event-block{pointer-events:none;z-index:2}calendar-event .event-block-inner{background:var(--event-bg-timed, var(--neutral-100));border-left:3px solid var(--event-border-color, var(--neutral-300));border-radius:4px;box-shadow:inset 0 0 0 .5px var(--neutral-200)}calendar-grid calendar-event .event-block{grid-column:calc(var(--day-index) + 1);grid-row:1 / -1;position:relative;z-index:0}calendar-grid calendar-event .event-block-inner{position:absolute;top:calc(var(--y-start) * 100%);height:calc((var(--y-end) - var(--y-start)) * 100%);left:calc(2px + var(--cascade-depth, 0) * 6px);right:2px;padding:var(--space-4) var(--space-8);overflow:hidden;pointer-events:auto;z-index:calc(1 + var(--cascade-depth, 0))}calendar-allday calendar-event .event-block{grid-column:calc(var(--day-start) + 1) / span var(--day-span);grid-row:var(--lane-index);padding:2px}calendar-allday calendar-event .event-block-inner{background:var(--event-bg-all-day, var(--event-bg-timed, var(--neutral-100)));border-left:var( --event-all-day-border, 3px solid var(--event-border-color, var(--neutral-300)) );padding:1px var(--space-8);display:flex;align-items:center;pointer-events:auto}calendar-event[color=red]{--event-bg-timed: var(--red-100);--event-bg-all-day: var(--red-200);--event-border-color: var(--red-500);--event-all-day-border: none}calendar-event[color=orange]{--event-bg-timed: var(--orange-100);--event-bg-all-day: var(--orange-200);--event-border-color: var(--orange-500);--event-all-day-border: none}calendar-event[color=yellow]{--event-bg-timed: var(--yellow-100);--event-bg-all-day: var(--yellow-200);--event-border-color: var(--yellow-500);--event-all-day-border: none}calendar-event[color=green]{--event-bg-timed: var(--green-100);--event-bg-all-day: var(--green-200);--event-border-color: var(--green-500);--event-all-day-border: none}calendar-event[color=blue]{--event-bg-timed: var(--blue-100);--event-bg-all-day: var(--blue-200);--event-border-color: var(--blue-500);--event-all-day-border: none}calendar-event[color=purple]{--event-bg-timed: var(--purple-100);--event-bg-all-day: var(--purple-200);--event-border-color: var(--purple-500);--event-all-day-border: none}calendar-event h3{margin:0;font-size:var(--text-sm);font-weight:600;color:var(--color-text);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}calendar-time-axis{display:contents}calendar-time-axis .hour-label{grid-column:time-left / days-start;grid-row-start:calc(var(--hour-index) + 1);align-self:start;padding:var(--space-2) var(--space-8);font-size:round(calc(var(--text-sm) / var(--text-scale)),1px);color:var(--color-text-muted);text-align:right;white-space:nowrap;transform:translateY(-50%)}calendar-time-axis .hour-label[data-hour="0"]{visibility:hidden;width:0;height:0;padding:0;overflow:hidden}calendar-week{display:grid;grid-template-columns:[time-left] auto [days-start] repeat(var(--day-count, 0),minmax(0,1fr)) [days-end];grid-template-rows:[headers] auto [allday] auto [hours-start] repeat(var(--hour-count, 0),minmax(var(--hour-min-height, 4rem),1fr)) [hours-end];width:100%;height:100%;overflow:auto;background:var(--color-surface);font-family:inherit;color:var(--color-text)}calendar-week>calendar-headers,calendar-week>calendar-allday,calendar-week>calendar-grid{display:grid;grid-column:1 / -1;grid-template-columns:subgrid;min-width:0}calendar-week>calendar-headers{grid-row:headers / allday;position:sticky;top:0;z-index:3;background:var(--color-surface);border-top:.5px solid var(--color-border);border-bottom:1px solid var(--color-border)}calendar-headers>calendar-day{grid-column:calc(var(--day-index) + 1);display:flex;align-items:baseline;gap:var(--space-2);padding:var(--space-12);font-size:var(--text-sm);border-left:.5px solid var(--color-border-muted)}calendar-headers>calendar-day:last-of-type{border-right:.5px solid var(--color-border-muted)}calendar-headers>calendar-day .weekday{text-transform:uppercase;letter-spacing:.04em;color:var(--color-text-muted)}calendar-headers>calendar-day .date-num{color:var(--color-text)}calendar-week>calendar-allday{grid-row:allday / hours-start;grid-template-rows:repeat(var(--allday-lane-count, 1),auto);position:sticky;top:var(--headers-height, 0px);z-index:2;border-bottom:1px solid var(--color-border);background:var(--color-surface)}calendar-allday>calendar-cell{grid-column:calc(var(--day-index) + 1);grid-row:1;border-left:.5px solid var(--color-border-muted)}calendar-allday>calendar-cell:last-of-type{border-right:.5px solid var(--color-border-muted)}calendar-week>calendar-grid{grid-row:hours-start / hours-end;grid-template-rows:subgrid;position:relative}calendar-grid>calendar-column{grid-column:calc(var(--day-index) + 1);grid-row:1 / -1;border-left:.5px solid var(--color-border-muted);background-image:repeating-linear-gradient(to bottom,transparent 0,transparent calc(100% / var(--hour-count) - .5px),var(--color-border-muted) calc(100% / var(--hour-count) - .5px),var(--color-border-muted) calc(100% / var(--hour-count)))}calendar-grid>calendar-column:last-of-type{border-right:.5px solid var(--color-border-muted)}calendar-grid>.start-hour-marker{grid-column:2;grid-row-start:calc(var(--start-hour) + 1);width:0;height:0}calendar-grid>.now-line-faint,calendar-grid>.now-line{grid-row:1 / -1;position:relative;pointer-events:none;z-index:1}calendar-grid>.now-line-faint{grid-column:2 / -1}calendar-grid>.now-line{grid-column:calc(var(--day-index) + 1)}calendar-grid>.now-line-faint:before,calendar-grid>.now-line:before{content:"";position:absolute;left:0;right:0;top:calc(var(--y-fraction) * 100%);height:1px;transform:translateY(-.5px)}calendar-grid>.now-line-faint:before{background:#e7202240}calendar-grid>.now-line:before{background:#e72022}calendar-grid>.now-line:after{content:"";position:absolute;left:0;top:calc(var(--y-fraction) * 100%);width:.5rem;height:.5rem;border-radius:50%;background:#e72022;transform:translate(-50%,-50%)}