@songsid/agend 2.1.7-beta.2 → 2.1.7-beta.4

package/dist/website-tips-renderer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Pure rendering helpers shared by scripts/generate-tips-html.mjs (the build
+ * artefact generator) and tests/website-tips-generator.test.ts (the
+ * consistency check that compares generated output against committed files).
+ *
+ * Having the render logic here — rather than copied inside the test — means
+ * the test always exercises the real production code path and cannot silently
+ * diverge from the generator.
+ */
+export declare const LEVELS: readonly ["beginner", "intermediate", "advanced"];
+export type Locale = "en" | "zh";
+export declare const COPY: {
+    readonly en: {
+        readonly lang: "en";
+        readonly description: "Practical AgEnD guidance, from first chat to fleet operations.";
+        readonly intro: "300 practical notes, grouped from everyday use to advanced fleet operations.";
+        readonly switchLabel: "繁體中文";
+        readonly switchHref: "./tips-zh.html";
+        readonly home: "Home";
+        readonly count: "tips";
+        readonly levels: {
+            readonly beginner: readonly ["Beginner", "Everyday chat and core concepts"];
+            readonly intermediate: readonly ["Intermediate", "Commands, Backends, and coordination"];
+            readonly advanced: readonly ["Advanced", "Configuration, reliability, and troubleshooting"];
+        };
+    };
+    readonly zh: {
+        readonly lang: "zh-TW";
+        readonly description: "從第一次對話到 Fleet 維運的 AgEnD 實用提示。";
+        readonly intro: "300 條實用提示，從日常操作一路整理到進階 Fleet 維運。";
+        readonly switchLabel: "English";
+        readonly switchHref: "./tips-en.html";
+        readonly home: "首頁";
+        readonly count: "條提示";
+        readonly levels: {
+            readonly beginner: readonly ["入門", "日常對話與核心概念"];
+            readonly intermediate: readonly ["中階", "指令、Backend 與協作"];
+            readonly advanced: readonly ["進階", "設定、可靠性與疑難排解"];
+        };
+    };
+};
+export declare function escapeHtml(value: string): string;
+export interface Tip {
+    id: string;
+    level: "beginner" | "intermediate" | "advanced";
+    text_en: string;
+    text_zh: string;
+    tags?: string[];
+}
+export declare function renderTip(tip: Tip, locale: Locale): string;
+export declare function renderPage(tips: Tip[], locale: Locale): string;

package/dist/website-tips-renderer.js

@@ -0,0 +1,138 @@
+/**
+ * Pure rendering helpers shared by scripts/generate-tips-html.mjs (the build
+ * artefact generator) and tests/website-tips-generator.test.ts (the
+ * consistency check that compares generated output against committed files).
+ *
+ * Having the render logic here — rather than copied inside the test — means
+ * the test always exercises the real production code path and cannot silently
+ * diverge from the generator.
+ */
+export const LEVELS = ["beginner", "intermediate", "advanced"];
+export const COPY = {
+    en: {
+        lang: "en",
+        description: "Practical AgEnD guidance, from first chat to fleet operations.",
+        intro: "300 practical notes, grouped from everyday use to advanced fleet operations.",
+        switchLabel: "繁體中文",
+        switchHref: "./tips-zh.html",
+        home: "Home",
+        count: "tips",
+        levels: {
+            beginner: ["Beginner", "Everyday chat and core concepts"],
+            intermediate: ["Intermediate", "Commands, Backends, and coordination"],
+            advanced: ["Advanced", "Configuration, reliability, and troubleshooting"],
+        },
+    },
+    zh: {
+        lang: "zh-TW",
+        description: "從第一次對話到 Fleet 維運的 AgEnD 實用提示。",
+        intro: "300 條實用提示，從日常操作一路整理到進階 Fleet 維運。",
+        switchLabel: "English",
+        switchHref: "./tips-en.html",
+        home: "首頁",
+        count: "條提示",
+        levels: {
+            beginner: ["入門", "日常對話與核心概念"],
+            intermediate: ["中階", "指令、Backend 與協作"],
+            advanced: ["進階", "設定、可靠性與疑難排解"],
+        },
+    },
+};
+export function escapeHtml(value) {
+    return String(value)
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+export function renderTip(tip, locale) {
+    const text = locale === "zh" ? tip.text_zh : tip.text_en;
+    const tags = (tip.tags ?? []).map(tag => `<span class="tag">${escapeHtml(tag)}</span>`).join("");
+    const tagRow = tags ? `\n            <div class="tags" aria-label="Backend tags">${tags}</div>` : "";
+    return `<article class="tip-card" id="${escapeHtml(tip.id)}" data-tip-id="${escapeHtml(tip.id)}" data-level="${tip.level}">
+            <a class="tip-id" href="#${escapeHtml(tip.id)}">${escapeHtml(tip.id)}</a>
+            <p>${escapeHtml(text)}</p>${tagRow}
+          </article>`;
+}
+export function renderPage(tips, locale) {
+    const copy = COPY[locale];
+    const sections = LEVELS.map(level => {
+        const levelTips = tips.filter(tip => tip.level === level);
+        const [heading, subtitle] = copy.levels[level];
+        return `<section class="tips-section" id="${level}">
+      <div class="section-heading">
+        <div>
+          <span class="eyebrow">${escapeHtml(level)}</span>
+          <h2>${escapeHtml(heading)}</h2>
+          <p>${escapeHtml(subtitle)}</p>
+        </div>
+        <span class="level-count">${levelTips.length} ${escapeHtml(copy.count)}</span>
+      </div>
+      <div class="tips-grid">
+        ${levelTips.map(tip => renderTip(tip, locale)).join("\n        ")}
+      </div>
+    </section>`;
+    }).join("\n");
+    return `<!doctype html>
+<html lang="${copy.lang}">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>AgEnD Tips</title>
+  <meta name="description" content="${escapeHtml(copy.description)}">
+  <link rel="icon" type="image/svg+xml" href="./favicon.svg">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;600&family=Noto+Sans+TC:wght@400;500;700&display=swap" rel="stylesheet">
+  <style>
+    :root { color-scheme: dark; --bg:#0d1117; --surface:#161b22; --raised:#1c2129; --border:#30363d; --text:#f0f6fc; --secondary:#8b949e; --muted:#6e7681; --accent:#2aabee; --accent-dim:rgba(42,171,238,.1); }
+    * { box-sizing: border-box; }
+    html { scroll-behavior: smooth; scroll-padding-top: 5.5rem; }
+    body { margin:0; background:var(--bg); color:var(--text); font-family:Inter,"Noto Sans TC",system-ui,sans-serif; line-height:1.65; }
+    body::before { content:""; position:fixed; inset:0; pointer-events:none; opacity:.22; background-image:radial-gradient(circle,var(--border) 1px,transparent 1px); background-size:24px 24px; mask-image:linear-gradient(to bottom,black,transparent 42rem); }
+    a { color:inherit; }
+    nav { position:sticky; top:0; z-index:10; height:64px; border-bottom:1px solid rgba(48,54,61,.7); background:rgba(13,17,23,.86); backdrop-filter:blur(14px); }
+    .nav-inner { max-width:1152px; height:100%; margin:auto; padding:0 24px; display:flex; align-items:center; justify-content:space-between; gap:20px; }
+    .brand { color:var(--accent); font:700 18px/1 "JetBrains Mono",monospace; text-decoration:none; }
+    .nav-actions { display:flex; align-items:center; gap:12px; font-size:14px; color:var(--secondary); }
+    .nav-actions a { text-decoration:none; border:1px solid var(--border); border-radius:10px; padding:6px 11px; transition:.2s ease; }
+    .nav-actions a:hover { color:var(--text); border-color:var(--secondary); }
+    main { position:relative; max-width:1152px; margin:auto; padding:72px 24px 96px; }
+    .hero { max-width:780px; margin-bottom:64px; }
+    .hero .kicker,.eyebrow { color:var(--accent); font:600 12px/1.4 "JetBrains Mono",monospace; letter-spacing:.12em; text-transform:uppercase; }
+    h1 { margin:13px 0 16px; font-size:clamp(42px,7vw,72px); line-height:1.02; letter-spacing:-.045em; }
+    .hero p { color:var(--secondary); font-size:18px; margin:0; }
+    .jump-links { display:flex; flex-wrap:wrap; gap:10px; margin-top:28px; }
+    .jump-links a { text-decoration:none; color:var(--secondary); background:var(--surface); border:1px solid var(--border); border-radius:999px; padding:7px 13px; font-size:13px; }
+    .jump-links a:hover { color:var(--accent); border-color:var(--accent); }
+    .tips-section { margin-top:72px; }
+    .section-heading { display:flex; justify-content:space-between; align-items:end; gap:24px; padding-bottom:20px; border-bottom:1px solid var(--border); margin-bottom:20px; }
+    .section-heading h2 { margin:5px 0 2px; font-size:30px; letter-spacing:-.025em; }
+    .section-heading p { margin:0; color:var(--secondary); }
+    .level-count { white-space:nowrap; color:var(--muted); font:500 13px/1.4 "JetBrains Mono",monospace; }
+    .tips-grid { display:grid; grid-template-columns:repeat(2,minmax(0,1fr)); gap:12px; }
+    .tip-card { position:relative; display:grid; grid-template-columns:64px 1fr; gap:14px; align-items:start; padding:18px; background:rgba(22,27,34,.94); border:1px solid var(--border); border-radius:14px; transition:transform .2s ease,border-color .2s ease; }
+    .tip-card:hover { transform:translateY(-2px); border-color:var(--accent); }
+    .tip-card:target { border-color:var(--accent); box-shadow:0 0 0 3px var(--accent-dim); }
+    .tip-id { padding-top:2px; color:var(--accent); font:600 11px/1.5 "JetBrains Mono",monospace; text-decoration:none; }
+    .tip-card p { margin:0; color:#d8dee4; font-size:14px; }
+    .tags { grid-column:2; display:flex; flex-wrap:wrap; gap:6px; margin-top:2px; }
+    .tag { color:var(--secondary); background:var(--raised); border:1px solid var(--border); border-radius:999px; padding:2px 8px; font:500 10px/1.5 "JetBrains Mono",monospace; }
+    footer { border-top:1px solid var(--border); color:var(--muted); font-size:13px; }
+    .footer-inner { max-width:1152px; margin:auto; padding:30px 24px; display:flex; justify-content:space-between; gap:16px; }
+    @media (max-width:760px) { main { padding-top:48px; } .tips-grid { grid-template-columns:1fr; } .section-heading { align-items:start; flex-direction:column; gap:8px; } .tip-card { grid-template-columns:56px 1fr; } .footer-inner { flex-direction:column; } }
+  </style>
+</head>
+<body>
+  <nav><div class="nav-inner"><a class="brand" href="./">AgEnD</a><div class="nav-actions"><a href="./">${escapeHtml(copy.home)}</a><a href="${copy.switchHref}" hreflang="${locale === "zh" ? "en" : "zh-TW"}">${escapeHtml(copy.switchLabel)}</a></div></div></nav>
+  <main>
+    <header class="hero"><span class="kicker">Knowledge library</span><h1>AgEnD Tips</h1><p>${escapeHtml(copy.intro)}</p><div class="jump-links">${LEVELS.map(level => `<a href="#${level}">${escapeHtml(copy.levels[level][0])}</a>`).join("")}</div></header>
+    ${sections}
+  </main>
+  <footer><div class="footer-inner"><span><strong>AgEnD</strong> · Multi-Agent, One Conversation</span><span>Generated from <code>src/tips.ts</code></span></div></footer>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=website-tips-renderer.js.map

package/dist/website-tips-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-tips-renderer.js","sourceRoot":"","sources":["../src/website-tips-renderer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@songsid/agend",
-  "version": "2.1.7-beta.2",
+  "version": "2.1.7-beta.4",
   "description": "Multi-agent fleet daemon — run any coding CLI (Claude, Gemini, Codex, OpenCode) from Telegram",
   "type": "module",
   "bin": {