openclacky 1.5.4 → 1.5.6

data/lib/clacky/default_extensions/ext-studio/panels/studio/view.js

@@ -1,4 +1,4 @@
-// Extension & Creation — full-page workspace mounted from the sidebar.
+// Creator Center - full-page workspace mounted from the sidebar.
 // One rail entry opens a page (#ext/ext-studio) with two top tabs:
 //   • Extensions — local extension picker + verify (debug) + pack/publish
 //   • Skills     — cloud/local skills, publish, iterate, create new
@@ -8,8 +8,8 @@
 (function () {
   const STUDIO_I18N = {
     en: {
-      "nav.entry": "Extension & Creation",
-      "ws.title": "Extension & Creation",
+      "nav.entry": "Creator Center",
+      "ws.title": "Creator Center",
       "tab.extensions": "Extensions",
       "tab.skills": "Skills",
       "ext.debug.section": "Debug",
@@ -37,6 +37,7 @@
       "publish.changelog.placeholder": "What changed in this version?",
       "publish.force": "Publish a new version (already published)",
       "btn.publish": "Publish to marketplace",
+      "btn.publishBrand": "Publish to brand",
       "btn.publishing": "Publishing…",
       "btn.pack": "Pack (.zip)",
       "btn.packing": "Packing…",
@@ -78,6 +79,9 @@
       "pub.title.new": "Publish to the marketplace",
       "pub.title.update": "Publish a new version",
       "pub.intro": "\"{{name}}\" will be packed and uploaded to the extension marketplace, where anyone can discover and install it.",
+      "pub.brand.title.new": "Publish to brand",
+      "pub.brand.title.update": "Publish new version to brand",
+      "pub.brand.intro": "\"{{name}}\" will be packed and uploaded to your brand's extension library, where only your brand's users can install it.",
       "pub.version.new": "First release · v{{ver}}",
       "pub.version.update": "v{{prev}} → v{{ver}}",
       "pub.version.missing": "No version in ext.yml — add a \"version\" field before publishing.",
@@ -130,6 +134,7 @@
       "extlist.verify.errors": "{{n}} error(s)",
       "extlist.verify.warnings": "{{n}} warning(s)",
       "extlist.btn.publish": "Publish to Marketplace",
+      "extlist.btn.publishBrand": "Publish to Brand",
       "extlist.btn.update": "Update",
       "extlist.btn.pack": "Pack (.zip)",
       "extlist.btn.packing": "Packing…",
@@ -146,7 +151,7 @@
       "extlist.newExt.label": "Create a new extension",
       "extlist.newExt.hint": "Opens an AI session that scaffolds and builds it for you.",
       "extlist.newExt.btn": "Create New Extension",
-      "extlist.newExt.seed": "I want to build a new OpenClacky extension. Help me get started: ask me what the extension should do, then scaffold it and build it out step by step.",
+      "extlist.newExt.seed": "I want to build a new extension. Help me get started: ask me what the extension should do, then scaffold it and build it out step by step.",
       "unit.panel": "panel",
       "unit.panels": "panels",
       "unit.agent": "agent",
@@ -193,10 +198,10 @@
       "skills.publishing": "Publishing…",
     },
     zh: {
-      "nav.entry": "扩展与创作",
-      "ws.title": "扩展与创作",
+      "nav.entry": "创作者中心",
+      "ws.title": "创作者中心",
       "tab.extensions": "扩展",
-      "tab.skills": "创作",
+      "tab.skills": "技能",
       "ext.debug.section": "调试",
       "ext.publish.section": "发布",
       "debug.tab": "调试",
@@ -222,6 +227,7 @@
       "publish.changelog.placeholder": "这个版本改了什么？",
       "publish.force": "发布新版本（已发布过）",
       "btn.publish": "发布到市场",
+      "btn.publishBrand": "发布到品牌",
       "btn.publishing": "发布中…",
       "btn.pack": "打包 (.zip)",
       "btn.packing": "打包中…",
@@ -263,6 +269,9 @@
       "pub.title.new": "发布到市场",
       "pub.title.update": "发布新版本",
       "pub.intro": "「{{name}}」将被打包并上传到扩展市场，任何人都能发现并安装它。",
+      "pub.brand.title.new": "发布到品牌",
+      "pub.brand.title.update": "发布新版本到品牌",
+      "pub.brand.intro": "「{{name}}」将被打包并上传到你的品牌扩展库，仅品牌下的用户可安装使用。",
       "pub.version.new": "首次发布 · v{{ver}}",
       "pub.version.update": "v{{prev}} → v{{ver}}",
       "pub.version.missing": "ext.yml 里没有 version — 请先补上 version 字段再发布。",
@@ -315,6 +324,7 @@
       "extlist.verify.errors": "{{n}} 个错误",
       "extlist.verify.warnings": "{{n}} 个警告",
       "extlist.btn.publish": "发布到市场",
+      "extlist.btn.publishBrand": "发布到品牌",
       "extlist.btn.update": "更新到市场",
       "extlist.btn.pack": "打包(.zip)",
       "extlist.btn.packing": "打包中…",
@@ -328,10 +338,10 @@
       "extlist.unpublish.confirm": "确定要从市场下架 {{id}} 吗？",
       "extlist.publishing": "发布中…",
       "extlist.needLicense": "发布需要已激活的用户授权。",
-      "extlist.newExt.label": "新建扩展",
+      "extlist.newExt.label": "创建新扩展",
       "extlist.newExt.hint": "打开一个 AI 会话，帮你生成并开发它。",
-      "extlist.newExt.btn": "新建扩展",
-      "extlist.newExt.seed": "我想开发一个新的 OpenClacky 扩展。请引导我开始：先问清楚这个扩展要做什么，然后帮我搭好骨架并一步步开发出来。",
+      "extlist.newExt.btn": "创建新扩展",
+      "extlist.newExt.seed": "我想开发一个新的扩展。请引导我开始：先问清楚这个扩展要做什么，然后帮我搭好骨架并一步步开发出来。",
       "unit.panel": "个面板",
       "unit.panels": "个面板",
       "unit.agent": "个 Agent",
@@ -351,13 +361,13 @@
       "meta.saved": "已保存",
       "meta.save.err": "保存失败：{{msg}}",
 
-      "skills.section.cloud": "云端 Skills",
+      "skills.section.cloud": "云端技能",
       "skills.section.cloudHint": "已发布到平台",
-      "skills.section.local": "本地 Skills",
+      "skills.section.local": "本地技能",
       "skills.section.localHint": "可发布",
-      "skills.cloud.empty": "还没有发布任何 skill。",
-      "skills.cloud.locked": "成为创作者后才能上传并发布 skill。",
-      "skills.local.empty": "所有本地 skill 都已发布。",
+      "skills.cloud.empty": "还没有发布任何技能。",
+      "skills.cloud.locked": "成为创作者后才能上传并发布技能。",
+      "skills.local.empty": "所有本地技能都已发布。",
       "skills.badge.published": "已发布",
       "skills.badge.unpublished": "未发布",
       "skills.changed": "有本地改动",
@@ -367,14 +377,14 @@
       "skills.btn.update": "更新",
       "skills.btn.upToDate": "已是最新",
       "skills.btn.iterate": "迭代",
-      "skills.iterate.prompt": "更新 skill：",
+      "skills.iterate.prompt": "更新技能：",
       "skills.shadow.label": "本地覆盖",
-      "skills.shadow.tooltip": "本地副本覆盖了同名品牌 skill",
-      "skills.newSkill.label": "用 /skill-creator 创建新 skill",
-      "skills.newSkill.btn": "创建新 Skill",
-      "skills.promo.text": "发布你的 skill，打造自己的品牌。",
+      "skills.shadow.tooltip": "本地副本覆盖了同名品牌技能",
+      "skills.newSkill.label": "用 /skill-creator 创建新技能",
+      "skills.newSkill.btn": "创建新技能",
+      "skills.promo.text": "发布你的技能，打造自己的品牌。",
       "skills.promo.link": "了解更多 →",
-      "skills.locked": "发布云端 skill 需要创作者授权。",
+      "skills.locked": "发布云端技能需要创作者授权。",
       "skills.publishing": "发布中…",
     },
   };
@@ -389,6 +399,10 @@
 
   function api(path) { return `/api/ext/ext-studio${path}`; }
 
+  function toast(msg, type) {
+    if (window.Clacky && Clacky.Modal && Clacky.Modal.toast) Clacky.Modal.toast(msg, type || "info");
+  }
+
   async function getJson(path) {
     const res = await fetch(api(path));
     const data = await res.json();
@@ -597,8 +611,12 @@
   // `prevVersionOrPromise` may be a value or a Promise.
   // Resolves true when a publish succeeded, false otherwise.
 
-  function runPublishFlow(ext, prevVersionOrPromise, { onPublishDone } = {}) {
+  function runPublishFlow(ext, prevVersionOrPromise, { onPublishDone, origin } = {}) {
     return new Promise((resolve) => {
+      const isBrand = origin === "self";
+      const titleNew = isBrand ? t("pub.brand.title.new") : t("pub.title.new");
+      const titleUpdate = isBrand ? t("pub.brand.title.update") : t("pub.title.update");
+      const introText = isBrand ? t("pub.brand.intro", { name: ext.name }) : t("pub.intro", { name: ext.name });
       let currentVersion = ext.version || "";
       let isUpdate = false;
 
@@ -628,7 +646,7 @@
       status.style.display = "none";
 
       const bodyChildren = [
-        el("p", { class: "studio-modal-intro", text: t("pub.intro", { name: ext.name }) }),
+        el("p", { class: "studio-modal-intro", text: introText }),
         verField,
         notesField,
         status,
@@ -636,7 +654,7 @@
 
       let done = false;
       const modal = openModal({
-        title: t("pub.title.new"),
+        title: titleNew,
         body: el("div", null, bodyChildren),
         buttons: [
           { label: t("pub.btn.cancel"), keepOpen: false, onClick: () => { if (!done) resolve(false); } },
@@ -657,7 +675,7 @@
         if (done || !prevVersion) return;
         isUpdate = true;
         const titleEl = modal.overlay.querySelector(".studio-modal-title");
-        if (titleEl) titleEl.textContent = t("pub.title.update");
+        if (titleEl) titleEl.textContent = titleUpdate;
         if (prevVersion !== currentVersion) {
           currentVersion = prevVersion;
           verInput.value = currentVersion;
@@ -708,6 +726,7 @@
             ext_id: ext.id,
             force: isUpdate,
             changelog: notes.value.trim(),
+            origin: origin || "marketplace",
           });
 
           if (data === null) { resetButtons(); return; }
@@ -1280,7 +1299,27 @@
         })
         .catch(() => null);
       const ok = await runPublishFlow(ext, prevVersionPromise, { onPublishDone: loadPublished });
-      if (ok) loadPublished();
+      if (ok) {
+        toast(t("pub.success"), "success");
+        loadPublished();
+      }
+    }
+
+    async function doPublishBrand() {
+      const ext = store.selected();
+      if (!ext) return;
+      await confirmReadme(ext, { onSaved: () => rebuild() });
+      const prevVersionPromise = getJson("/published_brand")
+        .then((data) => {
+          const match = (data.extensions || []).find((e) => e.id === ext.id);
+          return match ? match.version : null;
+        })
+        .catch(() => null);
+      const ok = await runPublishFlow(ext, prevVersionPromise, { onPublishDone: loadPublished, origin: "self" });
+      if (ok) {
+        toast(t("pub.success"), "success");
+        loadPublished();
+      }
     }
 
     async function doPack() {
@@ -1368,6 +1407,9 @@
 
       const bar = el("div", { class: "studio-actions" });
       bar.appendChild(el("button", { class: "studio-btn studio-btn-primary studio-publish-btn", text: t("btn.publish"), onclick: doPublish }));
+      if (typeof Brand !== "undefined" && Brand.userLicensed) {
+        bar.appendChild(el("button", { class: "studio-btn studio-publish-brand-btn", text: t("btn.publishBrand"), onclick: doPublishBrand }));
+      }
       bar.appendChild(el("button", { class: "studio-btn studio-btn-ghost studio-pack-btn", text: t("btn.pack"), onclick: doPack }));
       container.appendChild(bar);
 
@@ -1413,6 +1455,7 @@
   function createExtensionsPanel() {
     let container = null;
     let cloud = [];
+    let brandCloud = [];
 
     function licensed() {
       return !(typeof Brand !== "undefined" && Brand.branded && !Brand.userLicensed);
@@ -1426,6 +1469,16 @@
       } catch (_e) {
         cloud = [];
       }
+      if (typeof Brand !== "undefined" && Brand.userLicensed) {
+        try {
+          const data = await getJson("/published_brand");
+          brandCloud = data.extensions || [];
+        } catch (_e) {
+          brandCloud = [];
+        }
+      } else {
+        brandCloud = [];
+      }
     }
 
     function createExtension(idea) {
@@ -1501,6 +1554,15 @@
       pub.addEventListener("click", () => doPublish(ext, cloudEntry ? cloudEntry.version : null));
       actions.appendChild(pub);
 
+      if (typeof Brand !== "undefined" && Brand.userLicensed) {
+        const brandEntry = brandCloud.find((c) => c.id === ext.id);
+        const brandPub = el("button", { class: "studio-btn", text: t("extlist.btn.publishBrand") });
+        brandPub.disabled = !!ext.error_count;
+        brandPub.title = ext.error_count ? t("extlist.verify.errors", { n: ext.error_count }) : "";
+        brandPub.addEventListener("click", () => doPublish(ext, brandEntry ? brandEntry.version : null, "self"));
+        actions.appendChild(brandPub);
+      }
+
       actions.appendChild(el("button", { class: "studio-btn", text: t("extlist.btn.iterate"), onclick: () => createExtension(t("extlist.iterate.seed", { id: ext.id })) }));
       const packBtn = el("button", { class: "studio-btn studio-btn-ghost", text: t("extlist.btn.pack") });
       packBtn.addEventListener("click", () => doPack(ext, packBtn));
@@ -1546,10 +1608,10 @@
       }
     }
 
-    async function doPublish(ext, prevVersion) {
+    async function doPublish(ext, prevVersion, origin) {
       await confirmReadme(ext, { onSaved: () => { reload().then(rebuild); } });
       const onDone = async () => { await reload(); rebuild(); };
-      const ok = await runPublishFlow(ext, prevVersion, { onPublishDone: onDone });
+      const ok = await runPublishFlow(ext, prevVersion, { onPublishDone: onDone, origin });
       if (ok) { await reload(); rebuild(); }
     }
 
@@ -1567,28 +1629,29 @@
       return box;
     }
 
-    function rebuild() {
+    function rebuild(headerActions) {
       if (!container) return;
       container.innerHTML = "";
 
-      const newBox = el("div", { class: "studio-skill-promo" });
-      newBox.appendChild(el("p", { class: "studio-skill-promo-text", text: t("extlist.newExt.label") }));
-      newBox.appendChild(el("p", { class: "studio-skill-hint", text: t("extlist.newExt.hint") }));
-      const newBar = el("div", { class: "studio-actions" });
-      newBar.appendChild(el("button", { class: "studio-btn studio-btn-primary", text: t("extlist.newExt.btn"), onclick: () => createExtension(t("extlist.newExt.seed")) }));
-      newBox.appendChild(newBar);
-      container.appendChild(newBox);
+      if (headerActions) {
+        headerActions.innerHTML = "";
+        headerActions.appendChild(el("button", {
+          class: "studio-btn studio-btn-primary",
+          text: t("extlist.newExt.btn"),
+          onclick: () => createExtension(t("extlist.newExt.seed")),
+        }));
+      }
 
       container.appendChild(section("extlist.section.cloud", "extlist.section.cloudHint", cloud, cloudCard, "extlist.cloud.empty"));
       container.appendChild(section("extlist.section.local", "extlist.section.localHint", store.extensions, localCard, "extlist.local.empty"));
     }
 
     return {
-      async attach(root) {
+      async attach(root, headerActions) {
         container = el("div", { class: "studio-panel" });
         root.appendChild(container);
         container.innerHTML = _skeletonHtml();
-        try { await reload(); rebuild(); }
+        try { await reload(); rebuild(headerActions); }
         catch (e) { container.innerHTML = ""; container.appendChild(el("p", { class: "studio-empty", text: t("err.generic", { msg: e.message }) })); }
       },
     };
@@ -1723,24 +1786,27 @@
       return box;
     }
 
-    function rebuild() {
+    function rebuild(headerActions) {
       if (!container) return;
       container.innerHTML = "";
 
-      if (locked) {
-        const promo = el("div", { class: "studio-skill-promo" });
-        promo.appendChild(el("p", { class: "studio-skill-promo-text", text: t("skills.promo.text") }));
-        promo.appendChild(el("p", { class: "studio-empty", text: t("skills.locked") }));
-        container.appendChild(promo);
+      if (headerActions) {
+        headerActions.innerHTML = "";
+        const newBtn = el("button", {
+          class: "studio-btn studio-btn-primary",
+          text: t("skills.newSkill.btn"),
+          onclick: () => createSkill(null),
+        });
+        newBtn.disabled = locked;
+        newBtn.title = locked ? t("skills.locked") : "";
+        headerActions.appendChild(newBtn);
       }
 
-      const newBox = el("div", { class: "studio-skill-promo" });
-      newBox.appendChild(el("p", { class: "studio-skill-promo-text", text: t("skills.newSkill.btn") }));
-      newBox.appendChild(el("p", { class: "studio-skill-hint", text: t("skills.newSkill.label") }));
-      const newBar = el("div", { class: "studio-actions" });
-      newBar.appendChild(el("button", { class: "studio-btn studio-btn-primary", text: t("skills.newSkill.btn"), onclick: () => createSkill(null) }));
-      newBox.appendChild(newBar);
-      container.appendChild(newBox);
+      if (locked) {
+        const lockHint = el("p", { class: "studio-empty", text: t("skills.locked") });
+        lockHint.style.marginBottom = "12px";
+        container.appendChild(lockHint);
+      }
 
       const cloudEmptyKey = locked ? "skills.cloud.locked" : "skills.cloud.empty";
       container.appendChild(section("skills.section.cloud", "skills.section.cloudHint", cloud, cloudCard, cloudEmptyKey));
@@ -1748,11 +1814,11 @@
     }
 
     return {
-      async attach(root) {
+      async attach(root, headerActions) {
         container = el("div", { class: "studio-panel" });
         root.appendChild(container);
         container.innerHTML = _skeletonHtml();
-        try { await reload(); rebuild(); }
+        try { await reload(); rebuild(headerActions); }
         catch (e) { container.innerHTML = ""; container.appendChild(el("p", { class: "studio-empty", text: t("err.generic", { msg: e.message }) })); }
       },
     };
@@ -1768,6 +1834,8 @@
 
     const header = el("div", { class: "studio-page-head" });
     header.appendChild(el("h2", { class: "studio-page-title", text: t("ws.title") }));
+    const headerActions = el("div", { class: "studio-page-head-actions" });
+    header.appendChild(headerActions);
     page.appendChild(header);
 
     const tabsBar = el("div", { class: "studio-tabs" });
@@ -1785,8 +1853,9 @@
       active = id;
       Array.from(tabsBar.children).forEach((b) => b.classList.toggle("studio-tab-active", b.dataset.tab === id));
       body.innerHTML = "";
+      headerActions.innerHTML = "";
       const tab = tabs.find((t2) => t2.id === id);
-      if (tab) tab.build(body);
+      if (tab) tab.build(body, headerActions);
     }
 
     tabs.forEach((tab) => {
@@ -1799,12 +1868,12 @@
     select("extensions");
   }
 
-  function buildExtensionsTab(root) {
-    createExtensionsPanel().attach(root);
+  function buildExtensionsTab(root, headerActions) {
+    createExtensionsPanel().attach(root, headerActions);
   }
 
-  function buildSkillsTab(root) {
-    createSkillsPanel().attach(root);
+  function buildSkillsTab(root, headerActions) {
+    createSkillsPanel().attach(root, headerActions);
   }
 
   function navRow(labelKey, onClick) {
@@ -1904,8 +1973,10 @@
     .studio-published-row { display: flex; align-items: center; justify-content: space-between; gap: 8px; padding: 8px 0; font-size: 12px; border-bottom: 1px solid var(--color-border-primary); }
     .studio-published-name { display: flex; align-items: center; gap: 6px; color: var(--color-text-primary); }
     .studio-page { width: 100%; }
-    .studio-page-head { margin-bottom: 20px; }
+    .studio-page-head { display: flex; align-items: center; justify-content: space-between; margin-bottom: 20px; }
+    .studio-page-head-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }
     .studio-page-title { margin: 0; font-size: 22px; font-weight: 600; color: var(--color-text-primary); }
+    .studio-btn-sm { padding: 5px 12px; font-size: 12px; }
     .studio-tabs { display: flex; gap: 4px; border-bottom: 1px solid var(--color-border-primary); margin-bottom: 24px; }
     .studio-tab { padding: 8px 16px; border: none; background: transparent; color: var(--color-text-tertiary); cursor: pointer; font-size: 14px; font-weight: 500; border-bottom: 2px solid transparent; margin-bottom: -1px; }
     .studio-tab:hover { color: var(--color-text-primary); }

data/lib/clacky/default_extensions/ext-studio/skills/ext-develop/SKILL.md

@@ -24,7 +24,7 @@ Seven `contributes:` types (use one, several, or all):
 - `panels`   — WebUI panels (a `view.js`, no build step, no React, no iframe)
 - `api`      — one backend file `api/handler.rb`, mounted at `/api/ext/<id>/`
 - `skills`   — a `SKILL.md` under `skills/<id>/` (prompt-only capability)
-- `agents`   — a `system_prompt.md`; can reference `panels: [id]` and `skills: [id]`
+- `agents`   — a `system_prompt.md`; can reference `panels: [id]` and `skills: [id]`; `hidden: true` hides from the new-session picker
 - `channels` — an IM adapter
 - `patches`  — monkey-patch a real class (advanced, supply-chain risk)
 - `hooks`    — lifecycle hooks like `before_tool_use` (advanced)
@@ -92,10 +92,12 @@ exactly three capabilities:
 
 ```js
 Clacky.ext.ui.mount(slot, spec, opts)     // inject UI into a named slot
-Clacky.ext.subscribe(event, handler)      // observe host store events (read-only)
+Clacky.ext.subscribe(event, handler)      // observe store events + live session events (read-only)
 Clacky.ext.api.register(name, fn)         // expose a named data source; api.resolve(name)
 ```
 
+**`subscribe(event, handler)`** - two event families: (1) host **store** events (`skills:changed`, `tasks:changed`, `profile:changed`, …) and (2) **live session events** mirrored from the WebSocket stream — conversation (`session:assistant-message`, `session:tool-call`, `session:tool-result`), status/errors (`session:error`, `session:warning`, `session:update`), lifecycle (`session:renamed`, `session:deleted`, …). Payload is `{ sessionId, ...wsFields }`. Full list in the "Core Events" section of the extend-webui docs. Handlers are read-only.
+
 **`ui.mount(slot, spec, opts)`** — `spec` is either `(container, ctx, runtime) => …` or
 `{ create?, render }`. The render function:
 - gets a host-owned `container` DOM element — append into it, **or** return a Node / HTML
@@ -200,7 +202,7 @@ Response helpers: `json` / `text(str)` / `send_data(bytes, content_type:, filena
   dir (`ext_dir` / `File.join(ext_dir, ...)`) — uninstall deletes the whole package, so
   anything there is lost. Package-internal writes are only for disposable caches.
 - Host context (white-listed): `session_manager`, `registry`, `agent_config`, `config`
-  (from ext.yml), `logger`, `ext_id`, `ext_dir`.
+  (from ext.yml), `logger`, `ext_id`, `ext_dir`, `project_manager`.
 - Drive sessions from the backend: `create_session(prompt:, profile:, …)`,
   `submit_task(session_id, prompt)`, `dispatch_to_session(session_id, prompt)` (runs a
   side task on a fork and returns its reply without touching the conversation).
@@ -208,6 +210,12 @@ Response helpers: `json` / `text(str)` / `send_data(bytes, content_type:, filena
   and the 200-session cleanup skips - use it for dedicated extension sessions you
   manage yourself. Still reachable by `session_id` via `submit_task` /
   `dispatch_to_session` / `registry.with_session`; forking resets `hidden` to false.
+- **Projects**: `project_manager.all` lists projects, `find(id)` returns one (or
+  `nil`), `create(name:, working_dir:, …)` / `update(id, …)` / `delete(id)` mutate.
+  Pass `project_id:` to `create_session` to bind a session to a project - its
+  `working_dir` is inherited (unless overridden) and `agent.project_id` is persisted.
+  A panel can also `fetch("/api/projects")` directly (same-origin, no-auth; see
+  [Host API](/docs/extend-host-api)).
 - Public (no-auth) endpoints: call `public_endpoint("/path")` in the class **and** set
   `public: true` at ext.yml top level — both are required.
 
@@ -464,7 +472,7 @@ scaffold, verify, and reload is the whole job. Only publish when the user explic
 to share, ship, or list the extension for others. Never publish on your own initiative or
 as a "wrap up" of the build.
 
-The **Extension & Creation panel** has a Publish button — prefer it for a
+The **Creator Center panel** has a Publish button — prefer it for a
 guided flow. Use the CLI below for scripted/CI publishing.
 
 ### Before publishing

data/lib/clacky/default_extensions/git/ext.yml

@@ -1,6 +1,9 @@
 id: git
 name: Git
+display_name: Git
+display_name_zh: Git
 description: Changes panel — a friendly view of what the AI changed in the working tree
+description_zh: 变更面板 — 直观查看 AI 在工作区的每一处修改
 version: "0.1.0"
 author: OpenClacky
 homepage: https://www.openclacky.com

data/lib/clacky/default_extensions/meeting/ext.yml

@@ -1,6 +1,9 @@
 id: meeting
 name: Meeting
+display_name: Meeting
+display_name_zh: 会议
 description: Real-time meeting transcription and AI assistant
+description_zh: 实时会议转录与 AI 助手
 version: "0.1.0"
 author: OpenClacky
 homepage: https://www.openclacky.com

data/lib/clacky/default_extensions/time_machine/ext.yml

@@ -1,6 +1,9 @@
 id: time_machine
 name: Time Machine
+display_name: Time Machine
+display_name_zh: 时间机器
 description: Vertical timeline of session tasks with per-task diff and one-click restore
+description_zh: 会话任务时间轴，支持按任务查看差异并一键还原
 version: "0.1.0"
 author: OpenClacky
 homepage: https://www.openclacky.com
@@ -9,3 +12,4 @@ contributes:
   panels:
     - id: time_machine
       view: panels/time_machine/view.js
+      attach: ["*"]

data/lib/clacky/default_searchers/tavily.rb

@@ -0,0 +1,98 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+# encoding: utf-8
+
+#
+# Clacky Tavily Searcher — CLI interface
+#
+# Usage:
+#   ruby tavily.rb "<query>" [max_results]
+#
+# Input:
+#   ENV["CLACKY_SEARCH_KEY"] — Tavily API key (set from ~/.clacky/search.yml)
+#
+# Output:
+#   stdout — JSON array of {"title","url","snippet"}
+#   stderr — error messages
+#   exit 0 — success
+#   exit 1 — failure
+#
+# Dependencies: none (stdlib only)
+#
+# This file lives in ~/.clacky/searchers/ and can be modified by the user.
+# Copy it as a starting point for other providers (Serper, Brave, an internal
+# search service...) — anything honouring the contract above works.
+#
+# VERSION: 1
+
+require "net/http"
+require "json"
+require "uri"
+
+API_URL = "https://api.tavily.com/search"
+TIMEOUT = 20
+
+def fail_with(message)
+  warn message
+  exit 1
+end
+
+query = ARGV[0].to_s.strip
+max_results = (ARGV[1] || 10).to_i
+max_results = 10 if max_results <= 0
+
+fail_with("Usage: tavily.rb \"<query>\" [max_results]") if query.empty?
+
+api_key = ENV["CLACKY_SEARCH_KEY"].to_s.strip
+fail_with("Tavily API key is not configured") if api_key.empty?
+
+uri = URI(API_URL)
+http = Net::HTTP.new(uri.host, uri.port)
+http.use_ssl = true
+http.open_timeout = TIMEOUT
+http.read_timeout = TIMEOUT
+
+request = Net::HTTP::Post.new(uri)
+request["Content-Type"] = "application/json"
+request["Authorization"] = "Bearer #{api_key}"
+request.body = JSON.generate(
+  query: query,
+  search_depth: "basic",
+  max_results: [max_results, 20].min,
+  include_answer: false,
+  include_images: false,
+  include_raw_content: false
+)
+
+begin
+  response = http.request(request)
+rescue StandardError => e
+  fail_with("Tavily request failed: #{e.message}")
+end
+
+unless response.is_a?(Net::HTTPSuccess)
+  detail = begin
+    JSON.parse(response.body)["detail"] || response.body
+  rescue StandardError
+    response.body
+  end
+  fail_with("Tavily returned #{response.code}: #{detail.to_s[0, 200]}")
+end
+
+begin
+  payload = JSON.parse(response.body)
+rescue JSON::ParserError => e
+  fail_with("Tavily returned malformed JSON: #{e.message}")
+end
+
+results = Array(payload["results"]).filter_map do |item|
+  next unless item.is_a?(Hash)
+
+  url = item["url"].to_s
+  next if url.empty?
+
+  snippet = item["content"].to_s.gsub(/\s+/, " ").strip
+  { "title" => item["title"].to_s, "url" => url, "snippet" => snippet[0, 400] }
+end
+
+puts JSON.generate(results)

data/lib/clacky/default_skills/new/SKILL.md

@@ -17,20 +17,25 @@ When user wants to create a new Rails project:
 ## Process Steps
 
 ### 0. Ask Project Type and Requirement
-Before doing anything, use `request_user_feedback` to ask the user two things:
-
-```
-project_type: "demo" or "production"
-requirement: one-sentence description of what they want to build
+Before doing anything, call `request_user_feedback` with a structured prompt. Use the following as a guide:
+
+zh:
+```json
+{
+  "question": "请选择项目类型，并用一句话描述你想做什么：",
+  "context": "开始新项目前需要知道项目类型和需求，请先完成填写。",
+  "options": ["⚡ Demo — 无数据库，AI 自由发挥，快速原型", "🏗️ Production — 真实应用，可部署，完整 Rails 配置"]
+}
 ```
 
-Card content:
-- Title: "🚀 New Project"
-- Two options for project type:
-  - **⚡ Demo** — no database, AI builds freely, quick prototype
-  - **🏗️ Production** — real app, ready to deploy, full Rails setup
-- One text input: "Describe your project in one sentence"
-- Confirm button: "Let's go!"
+en:
+```json
+{
+  "question": "Choose a project type and describe what you want to build in one sentence:",
+  "context": "Tell us what kind of project to create so we can get started.",
+  "options": ["⚡ Demo — no database, AI builds freely, quick prototype", "🏗️ Production — real app, ready to deploy, full Rails setup"]
+}
+```
 
 **Based on user's choice:**
 - If **Demo**: do NOT follow the Rails setup steps below. Instead, freely build a simple HTML/CSS/JS (or React) prototype directly in the working directory based on their requirement. Use your creativity.