misakanet 2.44.0 → 2.44.2

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "misakanet",
-  "version": "2.44.0",
+  "version": "2.44.2",
   "description": "Failure-memory network for AI coding agents: search evidence-rated failure lessons, submit new failures, and turn crashes into reusable knowledge.",
   "author": {
     "name": "Ikalus1988",

package/lib/client.js

@@ -126,17 +126,20 @@ window.__ModuleLoader__.load({
 		var en = {
 			"guide.description": "What this session asked, what came back, and what you filed",
 			"panel.asked": "What this session asked",
-			"panel.asked.none": "No MisakaNet search has run in this session yet.",
+			"panel.asked.none": "No MisakaNet search has run in this session yet — the entry point is the composer: type /misakanet, then what broke.",
 			"panel.reports": "Reports you filed",
 			"panel.reports.none": "Nothing filed from this session.",
 			"panel.trust": "How much these lessons are trusted",
-			"panel.trust.none": "No lesson surfaced yet.",
+			"panel.trust.none": "No lesson surfaced yet — the entry point is the composer: type /misakanet, then what broke.",
+			"panel.hint.open": "Open the search box over the composer",
+			"panel.hint.openLabel": "Open the search box",
+			"panel.hint.openTitle": "Opens the composer's own MisakaNet overlay, which carries the same instruction. It does not type into the composer: a view occupant receives props, and the draft is reachable only from a live session scope, so nothing here can put `/misakanet ` in the box for you.",
 			"panel.activity": "Your activity",
 			"panel.voice": "Voice",
 			"panel.voice.on": "Voice cues: on",
 			"panel.voice.off": "Voice cues: off",
 			"overlay.searching": "Searching…",
-			"overlay.empty": "Type what broke after /misakanet, e.g. /misakanet pip install timeout",
+			"overlay.empty": "After /misakanet, type what broke, e.g. /misakanet pip install timeout",
 			"overlay.none": "No lesson covers this yet. Ask the agent to file it (misakanet_submit_intake), or file it at misakanet.org — that is how the next person finds it here.",
 			"overlay.failed": "Search failed: {error} — the library is at misakanet.org; nothing was sent but the query.",
 			"overlay.footnote": "Reads are anonymous. This overlay sends only the query to misakanet.org; your votes and reports are the only other things a page ever sends.",
@@ -169,11 +172,13 @@ window.__ModuleLoader__.load({
 			"unit.votes": "votes",
 			"unit.report": "report",
 			"unit.reports": "reports",
+			"unit.reportFiled": "report filed",
+			"unit.reportsFiled": "reports filed",
 			"panel.asked.searching": "searching…",
 			"panel.asked.noMatch": "no lesson matched",
 			"panel.asked.top": "· top: ",
 			"panel.asked.noQuery": "(no query text)",
-			"panel.asked.nothingFound": "nothing found",
+			"panel.asked.nothingFound": "found nothing",
 			"panel.asked.voteHelpful": "Helpful",
 			"panel.asked.voteNotHelpful": "not helpful",
 			"panel.asked.voteNone": "not voted",
@@ -212,8 +217,6 @@ window.__ModuleLoader__.load({
 			"panel.trust.footnote": "The level is the lesson's own stored evidence. The count is other people's confirmations, not yours: one makes the reuse event appear, the second is what agents read as E4.",
 			"panel.activity.session": "this session: ",
 			"panel.activity.browser": "on this browser: ",
-			"panel.activity.reused": " reused · ",
-			"panel.activity.filed": " filed · ",
 			"panel.activity.conversion": "conversion",
 			"panel.activity.scope": "The browser column survives a reload; the session column is rebuilt from this conversation's transcript and starts again in a new session.",
 			"panel.voice.cue": "The cue is the server's own choice for the last search (",
@@ -240,7 +243,23 @@ window.__ModuleLoader__.load({
 			"settings.invalidJson": "invalid JSON",
 			"settings.what.form": "form",
 			"settings.what.row": "row",
-			"panel.activity.withLesson": " with a lesson · ",
+			// The counter strip and the activity line below are the two places a reader meets these
+			// numbers, and every word between them is a lookup: the unit words are `unit.*`, the rest are
+			// one-slot templates. Both halves are needed, because where the words go differs — English
+			// writes the plural noun then the verb (`{count} surfaced`), a language that takes a measure
+			// word before its noun writes one phrase (`{n} {unit}命中过课程`). Concatenating either half at
+			// the call site is what made the Chinese panel read `0 with a lesson · 0 lessons surfaced`,
+			// and splitting the phrase across two slots later made it read `1 篇 篇被课程复用`.
+			"panel.strip.hitTpl": "{count} hit · ",
+			"panel.strip.missTpl": "{count} found nothing · ",
+			"panel.strip.surfacedTpl": "{count} surfaced · ",
+			"panel.strip.helpfulTpl": "({n} helpful) · ",
+			"panel.strip.convertedTpl": "({n} became a lesson)",
+			"panel.activity.reusedTpl": "{count} reused · ",
+			"panel.activity.reportsTpl": "{count} · ",
+			"panel.activity.filedTpl": "{count}",
+			"unit.conversion": "conversion",
+			"unit.conversions": "conversions",
 			"footer.session": "session: ",
 			"footer.actionHint": "Copy the MisakaNet summary of the session that last used it",
 			"settings.copyPatch": "Copy patch snippet",
@@ -250,17 +269,20 @@ window.__ModuleLoader__.load({
 		var zh = {
 			"guide.description": "本会话问过什么、拿回了什么、你报了什么",
 			"panel.asked": "本会话问过什么",
-			"panel.asked.none": "本会话还没有发起过 MisakaNet 检索。",
+			"panel.asked.none": "本会话还没有发起过 MisakaNet 检索 —— 入口就在输入框：先打 /misakanet，再写清楚出了什么问题。",
 			"panel.reports": "你报过的问题",
 			"panel.reports.none": "本会话没有报过任何问题。",
 			"panel.trust": "这些课程的可信度",
-			"panel.trust.none": "还没有命中过课程。",
+			"panel.trust.none": "还没有命中过课程 —— 入口就在输入框：先打 /misakanet，再写清楚出了什么问题。",
+			"panel.hint.open": "在输入框上方打开检索框",
+			"panel.hint.openLabel": "打开检索框",
+			"panel.hint.openTitle": "打开输入框自己的 MisakaNet 浮层，里面写着同样的用法。它不会替你在输入框里打字：视图组件只拿得到 props，草稿只有活的 session 作用域才能改，所以从这里没办法替你填入「/misakanet 」。",
 			"panel.activity": "你的活动",
 			"panel.voice": "语音",
 			"panel.voice.on": "语音提示：开",
 			"panel.voice.off": "语音提示：关",
 			"overlay.searching": "检索中……",
-			"overlay.empty": "在 /misakanet 后面写清楚出了什么问题，例如 /misakanet pip install 超时",
+			"overlay.empty": "在 /misakanet 后面写清楚出了什么问题，例如 /misakanet pip install 超时。",
 			"overlay.none": "还没有课程覆盖这个问题。可以让 agent 报料（misakanet_submit_intake），或直接去 misakanet.org 提交 —— 下一个人就能在这里搜到它。",
 			"overlay.failed": "检索失败：{error} —— 课程库在 misakanet.org；这次只发出了查询本身。",
 			"overlay.footnote": "读取是匿名的。这个浮层只把查询发给 misakanet.org；除此之外，页面只会发出你的投票与报料。",
@@ -293,11 +315,13 @@ window.__ModuleLoader__.load({
 			"unit.votes": "票",
 			"unit.report": "条报料",
 			"unit.reports": "条报料",
+			"unit.reportFiled": "条报料",
+			"unit.reportsFiled": "条报料",
 			"panel.asked.searching": "检索中……",
 			"panel.asked.noMatch": "没有命中任何课程",
 			"panel.asked.top": "· 最佳：",
 			"panel.asked.noQuery": "（没记下查询原文）",
-			"panel.asked.nothingFound": "没有命中",
+			"panel.asked.nothingFound": "没查到结果",
 			"panel.asked.voteHelpful": "有用",
 			"panel.asked.voteNotHelpful": "没用",
 			"panel.asked.voteNone": "未投票",
@@ -336,8 +360,6 @@ window.__ModuleLoader__.load({
 			"panel.trust.footnote": "等级来自课程自己存的证据；计数是别人的确认，不是你的：前者让复用事件出现，后者才是 agent 读到的 E4。",
 			"panel.activity.session": "本会话：",
 			"panel.activity.browser": "本浏览器：",
-			"panel.activity.reused": " 次复用 · ",
-			"panel.activity.filed": " 条报料 · ",
 			"panel.activity.conversion": "转化",
 			"panel.activity.scope": "浏览器那一列能跨刷新保留；会话那一列由本次对话的转录重建，换一个会话就从零开始。",
 			"panel.voice.cue": "提示音是服务端为上一次检索自己选的（",
@@ -364,7 +386,16 @@ window.__ModuleLoader__.load({
 			"settings.invalidJson": "JSON 不合法",
 			"settings.what.form": "表单",
 			"settings.what.row": "条目",
-			"panel.activity.withLesson": " 篇命中课程 · ",
+			"panel.strip.hitTpl": "{n} {unit}命中过课程 · ",
+			"panel.strip.missTpl": "{n} {unit}没命中 · ",
+			"panel.strip.surfacedTpl": "{n} {unit}命中过课程 · ",
+			"panel.strip.helpfulTpl": "（{n} 有用） · ",
+			"panel.strip.convertedTpl": "（{n} 转化为课程）",
+			"panel.activity.reusedTpl": "{n} {unit}被课程复用 · ",
+			"panel.activity.reportsTpl": "{n} {unit} · ",
+			"panel.activity.filedTpl": "{n} {unit}",
+			"unit.conversion": "次转化",
+			"unit.conversions": "次转化",
 			"footer.session": "会话：",
 			"footer.actionHint": "复制最近一次使用 MisakaNet 的那个会话的摘要",
 			"settings.copyPatch": "复制 patch 片段",
@@ -959,11 +990,21 @@ var DEFAULT_MCP_URL = "https://misakanet.org/mcp";
 		 *
 		 * `many` is explicit rather than `singular + "s"` because English is not regular: the first
 		 * version of this helper printed "2 searchs", which its own verification run showed and the
-		 * commit message then misquoted. Passing the plural at the call site makes the irregular one
-		 * impossible to get wrong silently.
+		 * commit message then misquoted.
+		 *
+		 * The fallback keeps `many` optional, but it may only ever *derive an English plural*. A unit
+		 * that is not an English word — every `unit.*` key holds a Chinese one under zh — does not
+		 * pluralize with a trailing "s", so appending one did not make the count wrong in a way a reader
+		 * could parse: it made `count(0, "票")` print `"票s"` and `count(0, "转化")` print `"转化s"`,
+		 * which is the screenshot this file was fixed from. A unit that is not `[A-Za-z]…` therefore
+		 * keeps its singular in the plural slot, and the guard is the *character class*, not a list of
+		 * nouns: a new unit in a language this helper has never seen cannot grow an English plural.
+		 * Where English itself is irregular the call site still passes `many`, because no default can
+		 * know "search" wants "searches".
 		 */
 		function count(n, singular, many) {
-			return n + " " + (n === 1 ? singular : many || singular + "s");
+			var plural = many || (/^[A-Za-z][A-Za-z '\u2019-]*$/.test(singular) ? singular + "s" : singular);
+			return n + " " + (n === 1 ? singular : plural);
 		}
 
 		/** mm:ss for today, else the date — the event's own time, never the render time. */
@@ -1301,11 +1342,17 @@ var DEFAULT_MCP_URL = "https://misakanet.org/mcp";
 			rows.push(h("div", { key: "scope", style: DIM },
 				T("panel.counters")));
 
+			// The strip and the activity line below are the two places a reader meets these counters, and
+			// every word between the numbers is a lookup. Hard-coding it at the call site is what made the
+			// Chinese panel read `0 with a lesson · 0 lessons surfaced · 0 became a lesson` — the numbers
+			// were right and the sentence was English.
 			rows.push(h("div", { key: "strip", style: Object.assign({}, BOX, { marginTop: "8px" }) },
-				count(searches.length, T("unit.search"), T("unit.searches")) + " · " + withLesson + " with a lesson · " +
-				noMatch + " " + T("panel.asked.nothingFound") + " · " + count(lessons.length, "lesson") + " surfaced · " +
-				count(votes.length, T("unit.vote")) + " (" + helpful + " helpful) · " +
-				count(intakes.length, "report") + " (" + converted + " became a lesson)"));
+				count(searches.length, T("unit.search"), T("unit.searches")) + " · " +
+				T("panel.strip.hitTpl", { count: count(withLesson, T("unit.lesson"), T("unit.lessons")), n: withLesson, unit: T("unit.lessons") }) +
+				T("panel.strip.missTpl", { count: count(noMatch, T("unit.lesson"), T("unit.lessons")), n: noMatch, unit: T("unit.lessons") }) +
+				T("panel.strip.surfacedTpl", { count: count(lessons.length, T("unit.lesson"), T("unit.lessons")), n: lessons.length, unit: T("unit.lessons") }) +
+				count(votes.length, T("unit.vote"), T("unit.votes")) + " " + T("panel.strip.helpfulTpl", { count: count(helpful, T("unit.vote"), T("unit.votes")), n: helpful, unit: T("unit.votes") }) +
+				count(intakes.length, T("unit.report"), T("unit.reports")) + " " + T("panel.strip.convertedTpl", { count: count(converted, T("unit.report"), T("unit.reports")), n: converted, unit: T("unit.reports") })));
 
 			// ① what this session asked
 			//
@@ -1352,9 +1399,47 @@ var DEFAULT_MCP_URL = "https://misakanet.org/mcp";
 				);
 			}
 
+			/**
+			 * The entry point, which the panel is the first place a person looks for and the last place
+			 * it used to mention.
+			 *
+			 * The real entry is the composer's `/misakanet` source, and the empty states below said only
+			 * what was missing (`panel.asked.none`, `panel.trust.none`). What was checked before settling
+			 * for a hint plus this one button:
+			 *
+			 * * **Prefilling the composer is out of reach.** The draft lives behind
+			 *   `ctx.conversation.input.for(actx).setDraft(text)` — a *session-scoped* service the panel
+			 *   cannot hold: a view occupant is handed props, and the panel's `apply(ctx)` is the client
+			 *   root. Reaching it would mean injecting a service this plugin does not declare, which on a
+			 *   line without it is the dead-button case this file already refuses (see the deferred
+			 *   `sidebarRightTabs` inject). So no prefilled `/misakanet ` and no text that claims one.
+			 * * **Opening the overlay is in reach**, because it is this module's own state: the card
+			 *   registered on `conversation.input.overlay` renders from `overlayOf(sessionId)`, and the
+			 *   panel receives that same session id. `runOverlaySearch(sessionId, "")` is the module's one
+			 *   opener; it starts no request for an empty query and sends nothing — it just puts
+			 *   `overlay.empty` in front of the person, where the instruction now is.
+			 *
+			 * The button is offered only with a session id (the `main` seat gets none): without one there is
+			 * no overlay to open, and a button that cannot do what its label says is worse than the text.
+			 */
+			function openOverlayFromPanel() {
+				if (!sessionId) return;
+				runOverlaySearch(sessionId, "");
+			}
+
+			/** The section's own empty-state sentence, plus the overlay opener when a session can take it. */
+			function entryPointHint(key, message) {
+				return h("div", { key: key, style: DIM },
+					T(message) + " ",
+					sessionId ? h("button", {
+						type: "button", style: BUTTON, title: T("panel.hint.openTitle"),
+						onClick: openOverlayFromPanel,
+					}, T("panel.hint.openLabel")) : null);
+			}
+
 			rows.push(h("div", { key: "s1", style: { marginTop: "12px", fontWeight: 600 } }, T("panel.asked")));
 			if (!searches.length) {
-				rows.push(h("div", { key: "s1e", style: DIM }, T("panel.asked.none")));
+				rows.push(entryPointHint("s1e", "panel.asked.none"));
 			} else {
 				var searchRows = searches.slice().reverse().slice(0, 20).map(function (entry) {
 					var key = "q" + entry.callId + entry.at;
@@ -1466,7 +1551,7 @@ var DEFAULT_MCP_URL = "https://misakanet.org/mcp";
 			// reuse signal (E3), two or more is E4 — which is also why the rule below is stated once.
 			rows.push(h("div", { key: "s3", style: { marginTop: "12px", fontWeight: 600 } }, T("panel.trust")));
 			if (!lessons.length) {
-				rows.push(h("div", { key: "s3e", style: DIM }, T("panel.trust.none")));
+				rows.push(entryPointHint("s3e", "panel.trust.none"));
 			} else {
 				// The rule once, not per row: it is the same sentence for every lesson, and repeating it
 				// four times buries the numbers it is there to explain.
@@ -1492,12 +1577,16 @@ var DEFAULT_MCP_URL = "https://misakanet.org/mcp";
 			// ④ your activity, two scopes
 			rows.push(h("div", { key: "s4", style: { marginTop: "12px", fontWeight: 600 } }, T("panel.activity")));
 			rows.push(h("div", { key: "s4r", style: BOX },
-				h("div", {}, T("panel.activity.session") + count(searches.length, "search", "searches") + " · " + count(lessons.length, "lesson") +
-					T("panel.activity.reused") + count(votes.length, "vote") + " · " + count(intakes.length, "report") + T("panel.activity.filed") +
-					count(converted, T("panel.activity.conversion"))),
+				h("div", {}, T("panel.activity.session") + count(searches.length, T("unit.search"), T("unit.searches")) + " · " +
+					T("panel.activity.reusedTpl", { count: count(lessons.length, T("unit.lesson"), T("unit.lessons")), n: lessons.length, unit: T("unit.lessons") }) +
+					count(votes.length, T("unit.vote"), T("unit.votes")) + " · " +
+					T("panel.activity.reportsTpl", { count: count(intakes.length, T("unit.reportFiled"), T("unit.reportsFiled")), n: intakes.length, unit: T("unit.reportsFiled") }) +
+					T("panel.activity.filedTpl", { count: count(converted, T("unit.conversion"), T("unit.conversions")), n: converted, unit: T("unit.conversions") })),
 				h("div", {}, T("panel.activity.browser") + count(stats.searches || 0, T("unit.search"), T("unit.searches")) + " · " +
-					count(stats.lessonsReused || 0, "lesson") + " reused · " + count(stats.votes || 0, "vote") + " · " +
-					count(stats.reportsFiled || 0, "report") + " filed · " + count(stats.reportsConverted || 0, "conversion")),
+					T("panel.activity.reusedTpl", { count: count(stats.lessonsReused || 0, T("unit.lesson"), T("unit.lessons")), n: stats.lessonsReused || 0, unit: T("unit.lessons") }) +
+					count(stats.votes || 0, T("unit.vote"), T("unit.votes")) + " · " +
+					T("panel.activity.reportsTpl", { count: count(stats.reportsFiled || 0, T("unit.reportFiled"), T("unit.reportsFiled")), n: stats.reportsFiled || 0, unit: T("unit.reportsFiled") }) +
+					T("panel.activity.filedTpl", { count: count(stats.reportsConverted || 0, T("unit.conversion"), T("unit.conversions")), n: stats.reportsConverted || 0, unit: T("unit.conversions") })),
 				h("div", { style: DIM }, T("panel.activity.scope"))));
 
 			// ⑤ voice

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "misakanet",
-  "version": "2.44.0",
+  "version": "2.44.2",
   "license": "Apache-2.0",
   "description": "MisakaNet failure-memory skill — evidence-rated failure lessons for AI agents. DSH bundle: registers the MCP tools as mcp__misakanet__* (misakanet_search/get_lesson/…), served by the public Streamable HTTP endpoint https://misakanet.org/mcp — live tools from an npm install, in any profile, with no local python. A profile that prefers the repo's own stdio server can override the bundle row.",
   "icon": "icon.svg",