@seanyao/roll 3.610.1 → 3.611.2

package/skills/scripts/audit-skills.mjs

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+function readText(file) {
+  return fs.readFileSync(file, "utf8");
+}
+
+function stripYamlQuotes(value) {
+  const trimmed = value.trim();
+  if (
+    (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+    (trimmed.startsWith("'") && trimmed.endsWith("'"))
+  ) {
+    return trimmed.slice(1, -1);
+  }
+  return trimmed;
+}
+
+export function parseFrontmatter(text) {
+  if (!text.startsWith("---\n")) {
+    return { fields: {}, body: text, ok: false };
+  }
+
+  const end = text.indexOf("\n---", 4);
+  if (end === -1) {
+    return { fields: {}, body: text, ok: false };
+  }
+
+  const raw = text.slice(4, end);
+  const bodyStart = text.indexOf("\n", end + 4);
+  const body = bodyStart === -1 ? "" : text.slice(bodyStart + 1);
+  const fields = {};
+  const lines = raw.split(/\r?\n/);
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index];
+    const blockMatch = line.match(/^([A-Za-z0-9_.-]+):\s*\|\s*$/);
+    if (blockMatch) {
+      const key = blockMatch[1];
+      const blockLines = [];
+      index += 1;
+      while (index < lines.length) {
+        const next = lines[index];
+        if (/^\S[^:]*:/.test(next)) {
+          index -= 1;
+          break;
+        }
+        blockLines.push(next.replace(/^  ?/, ""));
+        index += 1;
+      }
+      fields[key] = blockLines.join("\n").trim();
+      continue;
+    }
+
+    const scalarMatch = line.match(/^([A-Za-z0-9_.-]+):\s*(.*)$/);
+    if (scalarMatch) {
+      fields[scalarMatch[1]] = stripYamlQuotes(scalarMatch[2]);
+    }
+  }
+
+  return { fields, body, ok: true };
+}
+
+export function wordCount(text) {
+  const words = text.trim().split(/\s+/).filter(Boolean);
+  return words.length;
+}
+
+function walkFiles(dir) {
+  if (!fs.existsSync(dir)) return [];
+  return fs
+    .readdirSync(dir, { withFileTypes: true })
+    .flatMap((entry) => {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) return walkFiles(full);
+      if (entry.isFile()) return [full];
+      return [];
+    });
+}
+
+function toPosix(relativePath) {
+  return relativePath.split(path.sep).join("/");
+}
+
+function collectSpokeFiles(skillDir) {
+  return ["references", "assets", "scripts"].flatMap((dirName) => {
+    const base = path.join(skillDir, dirName);
+    return walkFiles(base).map((file) => toPosix(path.relative(skillDir, file)));
+  });
+}
+
+function collectReferencedSpokes(body) {
+  const refs = new Set();
+  const patterns = [
+    /\]\(((?:references|assets|scripts)\/[^)#\s]+)(?:#[^)]+)?\)/g,
+    /`((?:references|assets|scripts)\/[^`#]+)(?:#[^`]*)?`/g,
+  ];
+
+  for (const pattern of patterns) {
+    for (const match of body.matchAll(pattern)) {
+      refs.add(match[1].replace(/^\.\//, ""));
+    }
+  }
+
+  return [...refs].sort();
+}
+
+export function parseSkillFile(file) {
+  const text = readText(file);
+  const { fields, body, ok } = parseFrontmatter(text);
+  const skillDir = path.dirname(file);
+  const description = fields.description ?? "";
+  const spokeFiles = collectSpokeFiles(skillDir);
+  const referencedSpokes = collectReferencedSpokes(body);
+
+  return {
+    name: fields.name ?? path.basename(skillDir),
+    file,
+    frontmatterOk: ok,
+    lines: text.trimEnd().split(/\r?\n/).length,
+    description,
+    descriptionWordCount: wordCount(description),
+    descriptionLoadTrigger: /^Load when\b/i.test(description),
+    hasWhenNotToUse: /^##\s+When Not to Use\b/im.test(body),
+    hasGotchas: /^##\s+(Gotchas|Known Failure Modes)\b/im.test(body),
+    hasReviewedWaiver: /Reviewed Waiver:/i.test(body),
+    auxiliaryDirs: ["scripts", "references", "assets"].filter((dirName) =>
+      fs.existsSync(path.join(skillDir, dirName)),
+    ),
+    spokeFiles,
+    referencedSpokes,
+    missingSpokeRefs: referencedSpokes.filter((ref) => !spokeFiles.includes(ref)),
+    unreferencedSpokes: spokeFiles.filter((filePath) => !referencedSpokes.includes(filePath)),
+  };
+}
+
+export function findSkillFiles(skillsDir) {
+  return fs
+    .readdirSync(skillsDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => path.join(skillsDir, entry.name, "SKILL.md"))
+    .filter((file) => fs.existsSync(file))
+    .sort();
+}
+
+function loadRouteCases(routeFile) {
+  if (!fs.existsSync(routeFile)) {
+    return { skills: {} };
+  }
+  return JSON.parse(readText(routeFile));
+}
+
+function routeCoverageFor(skillName, routes) {
+  const entry = routes.skills?.[skillName] ?? {};
+  const positive = Array.isArray(entry.positive) ? entry.positive : [];
+  const negative = Array.isArray(entry.negative) ? entry.negative : [];
+  return {
+    positive,
+    negative,
+    hasMinimumCoverage: positive.length >= 2 && negative.length >= 2,
+  };
+}
+
+function violationsFor(skill, routeCoverage) {
+  const violations = [];
+
+  if (!skill.frontmatterOk) violations.push("frontmatter-missing-or-invalid");
+  if (!skill.descriptionLoadTrigger) violations.push("description-not-load-trigger");
+  if (skill.descriptionWordCount > 50) violations.push("description-over-50-words");
+  if (!routeCoverage.hasMinimumCoverage) violations.push("route-fixture-coverage-missing");
+  if (!skill.hasGotchas) violations.push("gotchas-missing");
+  if (skill.lines > 250 && !skill.hasReviewedWaiver) violations.push("hub-over-250-lines");
+  for (const missing of skill.missingSpokeRefs) violations.push(`missing-spoke-ref:${missing}`);
+  for (const extra of skill.unreferencedSpokes) violations.push(`unreferenced-spoke:${extra}`);
+
+  return violations;
+}
+
+export function auditSkills({ skillsDir, routeFile }) {
+  const routes = loadRouteCases(routeFile);
+  const skills = findSkillFiles(skillsDir).map((file) => {
+    const skill = parseSkillFile(file);
+    const routeCoverage = routeCoverageFor(skill.name, routes);
+    return {
+      ...skill,
+      routeCoverage: {
+        positiveCount: routeCoverage.positive.length,
+        negativeCount: routeCoverage.negative.length,
+        hasMinimumCoverage: routeCoverage.hasMinimumCoverage,
+      },
+      violations: violationsFor(skill, routeCoverage),
+    };
+  });
+
+  const summary = {
+    skills: skills.length,
+    violations: skills.reduce((count, skill) => count + skill.violations.length, 0),
+    over250: skills.filter((skill) => skill.lines > 250).length,
+    withGotchas: skills.filter((skill) => skill.hasGotchas).length,
+    loadTriggerDescriptions: skills.filter((skill) => skill.descriptionLoadTrigger).length,
+    withAuxiliaryFiles: skills.filter((skill) => skill.spokeFiles.length > 0).length,
+  };
+
+  return { summary, skills };
+}
+
+function printHuman(report) {
+  console.log(`Skill audit: ${report.summary.skills} skills`);
+  console.log(`Load-trigger descriptions: ${report.summary.loadTriggerDescriptions}/${report.summary.skills}`);
+  console.log(`Gotchas coverage: ${report.summary.withGotchas}/${report.summary.skills}`);
+  console.log(`Skills over 250 lines: ${report.summary.over250}`);
+  console.log(`Skills with auxiliary files: ${report.summary.withAuxiliaryFiles}`);
+  console.log(`Violations: ${report.summary.violations}`);
+
+  for (const skill of report.skills) {
+    const markers = [];
+    markers.push(`${skill.lines} lines`);
+    markers.push(`${skill.descriptionWordCount} desc words`);
+    markers.push(`${skill.routeCoverage.positiveCount}+/${skill.routeCoverage.negativeCount}- route cases`);
+    if (skill.spokeFiles.length > 0) markers.push(`${skill.spokeFiles.length} spokes`);
+    const status = skill.violations.length === 0 ? "ok" : skill.violations.join(", ");
+    console.log(`- ${skill.name}: ${status} (${markers.join("; ")})`);
+  }
+}
+
+function parseArgs(argv) {
+  const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+  const options = {
+    skillsDir: root,
+    routeFile: path.join(root, "route-cases", "skills.json"),
+    json: false,
+    strict: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--json") options.json = true;
+    else if (arg === "--strict") options.strict = true;
+    else if (arg === "--skills-dir") {
+      index += 1;
+      options.skillsDir = path.resolve(argv[index]);
+    } else if (arg === "--routes") {
+      index += 1;
+      options.routeFile = path.resolve(argv[index]);
+    } else {
+      throw new Error(`Unknown argument: ${arg}`);
+    }
+  }
+
+  return options;
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const report = auditSkills(options);
+  if (options.json) console.log(JSON.stringify(report, null, 2));
+  else printHuman(report);
+
+  if (options.strict && report.summary.violations > 0) {
+    process.exitCode = 1;
+  }
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch((error) => {
+    console.error(error.message);
+    process.exitCode = 1;
+  });
+}

package/skills/scripts/test-audit-skills.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+import assert from "node:assert/strict";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { auditSkills, parseSkillFile } from "./audit-skills.mjs";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const fixtureRoot = path.join(root, "tests", "fixtures", "skill-audit");
+
+const quoted = parseSkillFile(path.join(fixtureRoot, "quoted-skill", "SKILL.md"));
+assert.equal(quoted.name, "quoted-skill");
+assert.equal(quoted.description, "Load when quoted scalar YAML should parse cleanly.");
+assert.equal(quoted.descriptionLoadTrigger, true);
+
+const block = parseSkillFile(path.join(fixtureRoot, "block-skill", "SKILL.md"));
+assert.equal(block.name, "block-skill");
+assert.match(block.description, /Load when block descriptions/);
+assert.equal(block.descriptionLoadTrigger, true);
+
+const minimal = parseSkillFile(path.join(fixtureRoot, "minimal-skill", "SKILL.md"));
+assert.equal(minimal.hasGotchas, false);
+assert.equal(minimal.hasWhenNotToUse, false);
+
+const spoke = parseSkillFile(path.join(fixtureRoot, "spoke-skill", "SKILL.md"));
+assert.deepEqual(spoke.spokeFiles, ["references/runbook.md"]);
+assert.deepEqual(spoke.referencedSpokes, ["references/runbook.md"]);
+assert.deepEqual(spoke.missingSpokeRefs, []);
+assert.deepEqual(spoke.unreferencedSpokes, []);
+
+const report = auditSkills({
+  skillsDir: fixtureRoot,
+  routeFile: path.join(fixtureRoot, "route-cases.json"),
+});
+assert.equal(report.summary.skills, 4);
+assert.equal(report.skills.find((skill) => skill.name === "minimal-skill").violations.includes("gotchas-missing"), true);
+assert.equal(report.skills.find((skill) => skill.name === "spoke-skill").violations.length, 0);
+
+console.log("audit-skills tests passed");

package/skills/tests/fixtures/skill-audit/block-skill/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: block-skill
+description: |
+  Load when block descriptions span more than one physical line
+  but still describe one routing trigger.
+---
+
+# Block Skill
+
+## Gotchas
+
+- Preserve indentation when parsing block descriptions.

package/skills/tests/fixtures/skill-audit/minimal-skill/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: minimal-skill
+description: "Load when missing optional sections should not crash the audit."
+---
+
+# Minimal Skill
+
+This intentionally omits optional sections.

package/skills/tests/fixtures/skill-audit/quoted-skill/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: quoted-skill
+description: "Load when quoted scalar YAML should parse cleanly."
+---
+
+# Quoted Skill
+
+## Gotchas
+
+- Keep quoted descriptions parseable without requiring a YAML dependency.

package/skills/tests/fixtures/skill-audit/route-cases.json

@@ -0,0 +1,21 @@
+{
+  "version": 1,
+  "skills": {
+    "quoted-skill": {
+      "positive": ["parse a quoted description", "audit scalar YAML frontmatter"],
+      "negative": ["parse block YAML only", "ignore all skill files"]
+    },
+    "block-skill": {
+      "positive": ["parse a block description", "audit multiline YAML frontmatter"],
+      "negative": ["parse quoted YAML only", "skip description checks"]
+    },
+    "minimal-skill": {
+      "positive": ["confirm missing optional sections do not crash", "audit a tiny skill"],
+      "negative": ["validate spoke references", "require gotchas to parse frontmatter"]
+    },
+    "spoke-skill": {
+      "positive": ["validate spoke references", "find auxiliary runbooks"],
+      "negative": ["audit only frontmatter", "ignore references directories"]
+    }
+  }
+}

package/skills/tests/fixtures/skill-audit/spoke-skill/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: spoke-skill
+description: "Load when auxiliary files and references need integrity checks."
+---
+
+# Spoke Skill
+
+Read [the runbook](references/runbook.md) when executing the full workflow.
+
+## Gotchas
+
+- Every spoke file must be referenced by the hub.

package/skills/tests/fixtures/skill-audit/spoke-skill/references/runbook.md

@@ -0,0 +1,3 @@
+# Spoke Runbook
+
+Fixture-only reference file.

package/lib/i18n/slides.sh

@@ -1,3 +0,0 @@
-
-_i18n_set en slides.unknown_subcommand "Unknown subcommand: %s"
-_i18n_set zh slides.unknown_subcommand "未知子命令：%s"

package/lib/i18n/slides_build.sh

@@ -1,38 +0,0 @@
-
-_i18n_set en slides_build.unknown_option_1 "Unknown option: %s"
-_i18n_set zh slides_build.unknown_option_1 "未知选项: %s"
-_i18n_set en slides_build.unexpected_argument_1 "Unexpected argument: %s"
-_i18n_set zh slides_build.unexpected_argument_1 "多余参数: %s"
-_i18n_set en slides_build.slides_toolchain_missing_re_run_roll "Slides toolchain missing — re-run 'roll setup'"
-_i18n_set zh slides_build.slides_toolchain_missing_re_run_roll "渲染工具缺失，请运行 roll setup"
-_i18n_set en slides_build.deck_md "  deck.md"
-_i18n_set zh slides_build.deck_md "校验失败，请先修复上方提示再重试。"
-_i18n_set en slides_build.template_not_found "Template not found: %s"
-_i18n_set zh slides_build.template_not_found "未找到模板：%s"
-_i18n_set en slides_build.render_failed_for "Render failed for %s"
-_i18n_set zh slides_build.render_failed_for "渲染失败：%s"
-_i18n_set en slides_build.rendered "Rendered → %s"
-_i18n_set zh slides_build.rendered "渲染完成 → %s"
-
-# US-DECK-012: build failure recovery paths
-_i18n_set en slides_build.validation_failed_for "Validation failed for %s"
-_i18n_set zh slides_build.validation_failed_for "校验失败：%s"
-_i18n_set en slides_build.hint_fix_and_rerun "Hint: fix the issues above in %s and re-run 'roll slides build %s'"
-_i18n_set zh slides_build.hint_fix_and_rerun "提示：请按上方提示修复 %s，然后重新运行 'roll slides build %s'"
-_i18n_set en slides_build.available_templates "Available templates:"
-_i18n_set zh slides_build.available_templates "可用模板："
-_i18n_set en slides_build.templates_list_hint "Hint: 'roll slides templates' lists all installed templates"
-_i18n_set zh slides_build.templates_list_hint "提示：'roll slides templates' 列出所有已安装模板"
-_i18n_set en slides_build.renderer_crashed_for "Renderer crashed for %s"
-_i18n_set zh slides_build.renderer_crashed_for "渲染器崩溃：%s"
-_i18n_set en slides_build.see_full_error_logs "See full error: roll slides logs %s"
-_i18n_set zh slides_build.see_full_error_logs "查看完整错误：roll slides logs %s"
-_i18n_set en slides_build.last_5_lines_of_renderer_output "Last 5 lines of renderer output:"
-_i18n_set zh slides_build.last_5_lines_of_renderer_output "渲染器最后 5 行："
-
-_i18n_set en slides_build.usage_roll_slides_build_slug_no "Usage: roll slides build <slug> [--no-open]"
-_i18n_set zh slides_build.usage_roll_slides_build_slug_no "用法: roll slides build <slug> [--no-open]"
-_i18n_set en slides_build.en_deck "[EN:  未找到 deck 文件：%s...]"
-_i18n_set zh slides_build.en_deck "  未找到 deck 文件：%s"
-_i18n_set en slides_build.en_roll_slides_new "[EN:  提示：先运行 'roll slides new \"<主题>\"' 生成新的幻灯片。...]"
-_i18n_set zh slides_build.en_roll_slides_new "  提示：先运行 'roll slides new \"<主题>\"' 生成新的幻灯片。"

package/lib/i18n/slides_delete.sh

@@ -1,19 +0,0 @@
-
-_i18n_set en slides_delete.unknown_option_1 "Unknown option: %s"
-_i18n_set zh slides_delete.unknown_option_1 "未知选项: %s"
-_i18n_set en slides_delete.unexpected_argument_1 "Unexpected argument: %s"
-_i18n_set zh slides_delete.unexpected_argument_1 "多余参数: %s"
-_i18n_set en slides_delete.deck_not_found "Deck not found: %s"
-_i18n_set zh slides_delete.deck_not_found "未找到幻灯片：%s"
-_i18n_set en slides_delete.non_interactive_terminal_must_use_force "Non-interactive terminal: must use --force to delete"
-_i18n_set zh slides_delete.non_interactive_terminal_must_use_force "非交互终端：需使用 --force 参数"
-_i18n_set en slides_delete.cancelled "Cancelled"
-_i18n_set zh slides_delete.cancelled "已取消"
-_i18n_set en slides_delete.deleted "Deleted %s"
-_i18n_set zh slides_delete.deleted "已删除 %s"
-
-_i18n_set en slides_delete.usage_roll_slides_delete_slug_force "Usage: roll slides delete <slug> [--force]"
-_i18n_set zh slides_delete.usage_roll_slides_delete_slug_force "用法: roll slides delete <slug> [--force]"
-
-_i18n_set en slides_delete.prompt 'Delete deck "%s"? (y/N)'
-_i18n_set zh slides_delete.prompt '删除幻灯片 "%s"？(y/N)'

package/lib/i18n/slides_list.sh

@@ -1,14 +0,0 @@
-
-_i18n_set en slides_list.unknown_option_1 "Unknown option: %s"
-_i18n_set zh slides_list.unknown_option_1 "未知选项: %s"
-_i18n_set en slides_list.unexpected_argument_1 "Unexpected argument: %s"
-_i18n_set zh slides_list.unexpected_argument_1 "多余参数: %s"
-_i18n_set en slides_list.no_decks_found_under_roll_slides "No decks found under .roll/slides/"
-_i18n_set zh slides_list.no_decks_found_under_roll_slides "无幻灯片"
-_i18n_set en slides_list.no_decks_found_under_roll_slides_2 "No decks found under .roll/slides/"
-_i18n_set zh slides_list.no_decks_found_under_roll_slides_2 "无幻灯片"
-
-_i18n_set en slides_list.en_roll_slides_new "[EN:  提示：运行 'roll slides new \"<主题>\"' 创建第一个幻灯片。...]"
-_i18n_set zh slides_list.en_roll_slides_new "  提示：运行 'roll slides new \"<主题>\"' 创建第一个幻灯片。"
-_i18n_set en slides_list.en_roll_slides_new_2 "[EN:  提示：运行 'roll slides new \"<主题>\"' 创建第一个幻灯片。...]"
-_i18n_set zh slides_list.en_roll_slides_new_2 "  提示：运行 'roll slides new \"<主题>\"' 创建第一个幻灯片。"

package/lib/i18n/slides_logs.sh

@@ -1,12 +0,0 @@
-
-_i18n_set en slides_logs.unknown_option_1 "Unknown option: %s"
-_i18n_set zh slides_logs.unknown_option_1 "未知选项: %s"
-_i18n_set en slides_logs.unexpected_argument_1 "Unexpected argument: %s"
-_i18n_set zh slides_logs.unexpected_argument_1 "多余参数: %s"
-_i18n_set en slides_logs.deck_not_found "Deck not found: %s"
-_i18n_set zh slides_logs.deck_not_found "未找到幻灯片：%s"
-_i18n_set en slides_logs.no_failure_records_for "No failure records for %s"
-_i18n_set zh slides_logs.no_failure_records_for "该幻灯片没有失败记录"
-
-_i18n_set en slides_logs.usage_roll_slides_logs_slug "Usage: roll slides logs <slug>"
-_i18n_set zh slides_logs.usage_roll_slides_logs_slug "用法: roll slides logs <slug>"

package/lib/i18n/slides_new.sh

@@ -1,15 +0,0 @@
-
-_i18n_set en slides_new.unknown_option_1 "Unknown option: %s"
-_i18n_set zh slides_new.unknown_option_1 "未知选项: %s"
-_i18n_set en slides_new.unexpected_argument_1 "Unexpected argument: %s"
-_i18n_set zh slides_new.unexpected_argument_1 "多余参数: %s"
-
-_i18n_set en slides_new.en_roll_slides_new_template "[EN:  用法：roll slides new \"<主题>\" [--template <模板名>] [...]"
-_i18n_set zh slides_new.en_roll_slides_new_template "  用法：roll slides new \"<主题>\" [--template <模板名>] [--quiet] [--no-build]"
-_i18n_set en slides_new.en_slug "[EN:  无法从主题派生 slug：%s...]"
-_i18n_set zh slides_new.en_slug "  无法从主题派生 slug：%s"
-_i18n_set en slides_new.en_roll_slides_build "[EN:下一步：roll slides build %s...]"
-_i18n_set zh slides_new.en_roll_slides_build "下一步：roll slides build %s"
-
-_i18n_set en slides_new.template_requires_value "--template requires a value"
-_i18n_set zh slides_new.template_requires_value "--template 需要一个值"

package/lib/i18n/slides_preview.sh

@@ -1,14 +0,0 @@
-
-_i18n_set en slides_preview.unknown_option_1 "Unknown option: %s"
-_i18n_set zh slides_preview.unknown_option_1 "未知选项: %s"
-_i18n_set en slides_preview.unexpected_argument_1 "Unexpected argument: %s"
-_i18n_set zh slides_preview.unexpected_argument_1 "多余参数: %s"
-_i18n_set en slides_preview.preview "Preview → %s"
-_i18n_set zh slides_preview.preview "打开预览 → %s"
-
-_i18n_set en slides_preview.usage_roll_slides_preview_slug_no "Usage: roll slides preview <slug> [--no-open]"
-_i18n_set zh slides_preview.usage_roll_slides_preview_slug_no "用法: roll slides preview <slug> [--no-open]"
-_i18n_set en slides_preview.en_html "[EN:  未找到已渲染的 HTML：%s...]"
-_i18n_set zh slides_preview.en_html "  未找到已渲染的 HTML：%s"
-_i18n_set en slides_preview.en_roll_slides_build "[EN:  提示：先运行 'roll slides build %s' 渲染幻灯片。...]"
-_i18n_set zh slides_preview.en_roll_slides_build "  提示：先运行 'roll slides build %s' 渲染幻灯片。"

package/lib/i18n/slides_templates.sh

@@ -1,7 +0,0 @@
-
-_i18n_set en slides_templates.unknown_option_1 "Unknown option: %s"
-_i18n_set zh slides_templates.unknown_option_1 "未知选项: %s"
-_i18n_set en slides_templates.unexpected_argument_1 "Unexpected argument: %s"
-_i18n_set zh slides_templates.unexpected_argument_1 "多余参数: %s"
-_i18n_set en slides_templates.no_templates_found "No templates found"
-_i18n_set zh slides_templates.no_templates_found "无可用模板"

package/lib/slides/components/README.md

@@ -1,123 +0,0 @@
-# Slide Components Library
-
-Reusable Mustache partials for slide layouts. Each partial is a self-contained
-HTML fragment consumed by `lib/slides-render.py`. Partials use CSS classes from
-the introduction-v3 template and require no additional stylesheets.
-
-## Layout Reference
-
-| Layout      | Partial File       | Use When                                   | Avoid When                          |
-|-------------|--------------------|--------------------------------------------|-------------------------------------|
-| `plain`     | `plain.html`       | Free-form text, no structure needed        | Data has compare / flow / timeline  |
-| `cards-2`   | `cards-2.html`     | 2 parallel concepts, side-by-side feature  | 3+ items (use cards-3/cards-4)      |
-| `cards-3`   | `cards-3.html`     | 3 pillars, triple option, 3-step summary   | 2 items (use cards-2)               |
-| `cards-4`   | `cards-4.html`     | 4 quadrants, pricing tiers, team roles     | <4 items (too sparse)               |
-| `compare`   | `compare.html`     | Before/after, problem/solution, old/new    | Unrelated items (use cards)         |
-| `pipeline`  | `pipeline.html`    | Sequential flow, CI/CD, process steps      | Unordered items (use cards)         |
-| `timeline`  | `timeline.html`    | Chronological events, history, roadmap     | Single event (use highlight)        |
-| `quote`     | `quote.html`       | Testimonial, key takeaway, memorable line  | Multi-paragraph prose (use plain)   |
-| `highlight` | `highlight.html`   | Callout, warning, important note           | Normal body text (use plain)        |
-
-## Field Tables
-
-### cards-2 / cards-3 / cards-4
-
-| Variable        | Required | Type   | Description                     |
-|-----------------|----------|--------|---------------------------------|
-| `cards`         | yes      | array  | Array of card objects           |
-| `cards[].title_en` | yes   | string | Card title (English)            |
-| `cards[].title_zh` | yes   | string | Card title (Chinese)            |
-| `cards[].body_en`  | yes   | string | Card body HTML (English, raw)   |
-| `cards[].body_zh`  | yes   | string | Card body HTML (Chinese, raw)   |
-| `accent_color`  | no       | string | Unused — reserved for future    |
-
-### compare
-
-| Variable             | Required | Type   | Description                     |
-|----------------------|----------|--------|---------------------------------|
-| `left_title_en`      | yes      | string | Left column heading (EN)        |
-| `left_title_zh`      | yes      | string | Left column heading (ZH)        |
-| `right_title_en`     | yes      | string | Right column heading (EN)       |
-| `right_title_zh`     | yes      | string | Right column heading (ZH)       |
-| `left_items`         | yes      | array  | Left column items               |
-| `left_items[].text_en` | yes    | string | Item text (EN)                  |
-| `left_items[].text_zh` | yes    | string | Item text (ZH)                  |
-| `right_items`        | yes      | array  | Right column items              |
-| `right_items[].text_en` | yes   | string | Item text (EN)                  |
-| `right_items[].text_zh` | yes   | string | Item text (ZH)                  |
-
-### pipeline
-
-| Variable            | Required | Type   | Description                     |
-|---------------------|----------|--------|---------------------------------|
-| `stages`            | yes      | array  | Pipeline stages in order        |
-| `stages[].title_en` | yes      | string | Stage title (EN)                |
-| `stages[].title_zh` | yes      | string | Stage title (ZH)                |
-| `stages[].desc_en`  | yes      | string | Stage description (EN)          |
-| `stages[].desc_zh`  | yes      | string | Stage description (ZH)          |
-| `stages[].css_class` | yes     | string | CSS class: `pipe-idea`, `pipe-backlog`, `pipe-build`, `pipe-verify`, or `pipe-release` |
-
-### timeline
-
-| Variable            | Required | Type   | Description                     |
-|---------------------|----------|--------|---------------------------------|
-| `items`             | yes      | array  | Timeline entries (chronological)|
-| `items[].title_en`  | yes      | string | Entry title (EN)                |
-| `items[].title_zh`  | yes      | string | Entry title (ZH)                |
-| `items[].body_en`   | yes      | string | Entry body HTML (EN, raw)       |
-| `items[].body_zh`   | yes      | string | Entry body HTML (ZH, raw)       |
-
-### quote
-
-| Variable  | Required | Type   | Description                     |
-|-----------|----------|--------|---------------------------------|
-| `text_en` | yes      | string | Quote text (EN)                 |
-| `text_zh` | yes      | string | Quote text (ZH)                 |
-
-### highlight
-
-| Variable  | Required | Type   | Description                     |
-|-----------|----------|--------|---------------------------------|
-| `body_en` | yes      | string | Body HTML (EN, raw)             |
-| `body_zh` | yes      | string | Body HTML (ZH, raw)             |
-
-### plain
-
-| Variable  | Required | Type   | Description                     |
-|-----------|----------|--------|---------------------------------|
-| `body_en` | yes      | string | Body HTML (EN, raw)             |
-| `body_zh` | yes      | string | Body HTML (ZH, raw)             |
-
-## CSS Classes
-
-Every class name in these partials is copied verbatim from the introduction-v3
-template (`lib/slides/templates/introduction-v3.html`). Do **not** introduce
-new class names — the template's CSS is the single source of truth.
-
-## Usage
-
-Partials are consumed by `lib/slides-render.py` when a `deck.md` slide declares
-a `layout` field. A slide that omits `layout` renders as `plain`.
-
-For the user-facing walkthrough — per-layout `deck.md` examples, rendered
-screenshots, and how `$roll-deck` picks a layout — see the Layouts section of
-the slides guide: [`guide/en/slides.md`](../../../guide/en/slides.md#layouts)
-([中文](../../../guide/zh/slides.md#layouts布局)). Field names in this file,
-that guide, and `skills/roll-deck/SKILL.md` are kept in sync — change one,
-change all three.
-
-```markdown
-### Slide 3: Architecture Overview
-
-layout: cards-3
-title_en: Three Layers
-title_zh: 三层架构
-
-body_en: |
-  1. {{#cards}}...{{/cards}}
-body_zh: |
-  1. {{#cards}}...{{/cards}}
-```
-
-The renderer inlines the partial's HTML into the template and resolves
-Mustache variables and sections from the slide context.

package/lib/slides/components/cards-2.html

@@ -1,9 +0,0 @@
-<!-- cards-2: requires cards[].{title_en,title_zh,body_en,body_zh}, optional accent_color -->
-<div class="cards cards-2">
-{{#cards}}
-<div class="card">
-<h3><span class="lang-en">{{title_en}}</span><span class="lang-zh">{{title_zh}}</span></h3>
-<p><span class="lang-en">{{{body_en}}}</span><span class="lang-zh">{{{body_zh}}}</span></p>
-</div>
-{{/cards}}
-</div>