@tritard/waterbrother 0.16.40 → 0.16.41

package/README.md

@@ -304,6 +304,10 @@ Current Telegram behavior:
 - room administration is owner-only, and only owners/editors can hold the operator lock
 - `/room` status now shows the active executor surface plus provider/model/runtime identity
 - repo-first concept resolution now covers Waterbrother itself, Roundtable, Telegram, shared rooms, the gateway, runtime profiles, approvals, and sessions
+- collaboration how-to questions now answer from local state too, including:
+  - how to invite a partner
+  - how to share the current project
+  - how to make a new project
 - in Telegram groups, Waterbrother only responds when directly targeted: slash commands, `@botname` mentions, or replies to a bot message
 - in Telegram groups, directly targeted messages are now classified as chat, planning, or execution; explicit execution should use `/run <prompt>`
 - in Telegram group `chat` or `plan` flows, targeted Waterbrother/project questions are now answered directly from local repo state instead of returning only a generic planner hint

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tritard/waterbrother",
-  "version": "0.16.40",
+  "version": "0.16.41",
   "description": "Waterbrother: bring-your-own-model coding CLI with local tools, sessions, operator modes, and approval controls",
   "type": "module",
   "bin": {

package/src/self-awareness.js

@@ -258,6 +258,9 @@ export function resolveLocalConceptQuestion(text = "", manifest = {}) {
   const mentionsRoundtable = /\bround[\s-]?table\b/.test(lower);
   const asksWhatIs = /^(what('| i)?s|what is|tell me about|explain)\b/.test(lower) || /\bwhat is\b/.test(lower);
   const asksHowToUseRoundtable = mentionsRoundtable && /\b(how do i|how to|add to|join|use|set up|enable|create)\b/.test(lower);
+  const asksHowToInvitePartner = /\b(invite|add)\b/.test(lower) && /\b(partner|teammate|teammates|teammember|collaborator|member)\b/.test(lower);
+  const asksHowToShareProject = /\b(how do i|how to|share)\b/.test(lower) && /\b(this project|project)\b/.test(lower);
+  const asksHowToMakeProject = /\b(how do i|how to|make|create|start)\b/.test(lower) && /\b(new project|project)\b/.test(lower);
   const sourcesFor = (...keys) => keys.map((key) => manifest.sourceHints?.[key]).filter(Boolean);
   const withSources = (lines, sources = []) => [
     ...lines,
@@ -280,6 +283,35 @@ export function resolveLocalConceptQuestion(text = "", manifest = {}) {
     ], sources);
   }
 
+  if (asksHowToInvitePartner) {
+    const sources = sourcesFor("roundtableDocs", "telegramDocs", "sharedState");
+    return withSources([
+      "To collaborate with a Telegram partner, there are two separate steps.",
+      "First, add the human to the Telegram group/chat itself using normal Telegram controls.",
+      "Second, add them to the Waterbrother shared room with `waterbrother room invite <member-id> [owner|editor|observer]` or `/invite <user-id> [owner|editor|observer]`.",
+      "Then the invited person accepts with `waterbrother room invite accept <invite-id>` or `/accept-invite <invite-id>`.",
+      "If this repo is not shared yet, start with `waterbrother project share`."
+    ], sources);
+  }
+
+  if (asksHowToShareProject) {
+    const sources = sourcesFor("roundtableDocs", "sharedState");
+    return withSources([
+      "To share the current project, run `waterbrother project share` in the repo.",
+      "In an interactive terminal, Waterbrother will guide room mode, room runtime profile, and the first invite.",
+      "After that, use `waterbrother room status`, `waterbrother room invite <member-id> [owner|editor|observer]`, and `waterbrother room mode <chat|plan|execute>` to manage collaboration."
+    ], sources);
+  }
+
+  if (asksHowToMakeProject) {
+    const sources = sourcesFor("roundtableDocs", "telegramDocs", "readme");
+    return withSources([
+      "To make a new project from the TUI, use `/new-project <name>`.",
+      "That creates a folder on `~/Desktop/<name>`, switches the live session into it, and now asks whether the new project should be shared.",
+      "From Telegram, use `/new-project <name>` to create the folder and switch the linked session there. Then use `waterbrother project share` or the TUI sharing prompt if you want collaboration enabled."
+    ], sources);
+  }
+
   if ((/\bshared project\b/.test(lower) || /\bshared room\b/.test(lower) || /\broom mode\b/.test(lower)) && asksWhatIs) {
     const sources = sourcesFor("sharedState", "roundtableDocs", "roundtable");
     return withSources([