toga-ai 1.0.1004 → 1.0.1005

package/knowledge.js

@@ -32,6 +32,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 
 const ROOT = path.join(__dirname, 'knowledge');
 const REGISTRY = path.join(ROOT, 'registry.json');
@@ -1048,10 +1049,31 @@ function cmdSkills(args) {
  * every resolved knowledge doc in the main session; the gate detects it and releases.
  *
  * This command intentionally does nothing but confirm — the gate keys off the command
- * itself, so no shared state is needed here.
+ * itself, so no shared state is needed here. The gate only allows the exact 3-word form, so
+ * the session id comes from the env (as the hooks read it), never a flag. After the confirm
+ * line it repeats the /rename line when /start saved a session title; else nothing extra.
  */
+const MAX_SESSION_TITLE_LENGTH = 60;
+
+// Saved "<TICKET>: <short>" title from /start (start-helper.js set-title), or ''.
+function currentSessionTitle() {
+    const sid = String(process.env.CLAUDE_SESSION_ID || process.env.CLAUDE_CODE_SESSION_ID || '').replace(/[^A-Za-z0-9_-]/g, '');
+    if (!sid) return '';
+    const dir = process.env.TOGA_SESSIONS_DIR || path.join(os.homedir(), '.claude', 'toga-sessions');
+    try {
+        const t = JSON.parse(fs.readFileSync(path.join(dir, sid + '.json'), 'utf8')).sessionTitle;
+        return typeof t === 'string' ? t.replace(/[\u0000-\u001f\u007f`]+/g, ' ').trim().slice(0, MAX_SESSION_TITLE_LENGTH) : '';
+    } catch (e) {
+        if (e.code !== 'ENOENT') console.error('currentSessionTitle: ' + e.message);
+        return '';
+    }
+}
+
 function cmdKickoffPrimed() {
     console.log('Team knowledge base primed in the main session — start gate released. Priming was synchronous; no subagents ran during it.');
+    const title = currentSessionTitle();
+    // Same text as skills/start/scripts/start-helper.js cmdSetTitle tellDeveloper — keep in sync.
+    if (title) console.log('Reminder — tell the developer: Paste this to name the session: `/rename ' + title + '`');
 }
 
 function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toga-ai",
-  "version": "1.0.1004",
+  "version": "1.0.1005",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",

package/skills/start/SKILL.md

@@ -102,7 +102,9 @@ prefix words only if needed to stay short; never "TOGa". Max 60 characters. Save
 node ".../start-helper.js" set-title --session <sid> --title "<T>: <short>"
 ```
 
-Then tell the developer in one line: "Paste this to name the session: `/rename <title>`".
+**Send the `tellDeveloper` line now — never skip, never defer.** Team rule for every developer.
+Put it in its own message, as its own plain line (not in a code block), BEFORE you start Step 4.
+Do not wait for the Step 8 brief. Example: Paste this to name the session: `/rename TRUE-82605: ClickUp workflow`
 The SessionStart hook also offers it as the session title on resume/compact, only when the
 developer has not named the session.
 
@@ -239,11 +241,14 @@ Status flow: to do -> in progress (/start) -> development finished (/finish).
 ## Step 8 — Brief
 
 Show a short brief, then propose the plan (multi-agent for non-trivial work, as in the old
-kickoff Step 6: planner -> implement -> reviewers; auto-review rules apply):
+kickoff Step 6: planner -> implement -> reviewers; auto-review rules apply).
+Start the brief with the rename line, as its own plain line ABOVE the code block:
+
+**Name this session:** `/rename <session title>`
 
 ```
 Ticket:     <T> — <title>  (<status>, <list>)
-Session:    <session title>  (paste: /rename <session title>)
+Session:    <session title>
 Apps:       <repos>  (core: <core>)
 Clients:    <clients>
 Task type:  <type>

package/skills/start/scripts/start-helper.js

@@ -357,7 +357,14 @@ function cmdSetTitle(args) {
   if (title.length > MAX_TITLE_LENGTH) return fail('title is longer than ' + MAX_TITLE_LENGTH + ' characters');
   r.s.sessionTitle = prefix + title.slice(prefix.length);
   writeSession(r.sid, r.s);
-  print({ ok: true, sessionId: r.sid, ticket: r.s.ticket, sessionTitle: r.s.sessionTitle });
+  print({
+    ok: true,
+    sessionId: r.sid,
+    ticket: r.s.ticket,
+    sessionTitle: r.s.sessionTitle,
+    // Same text as knowledge.js cmdKickoffPrimed reminder — keep in sync.
+    tellDeveloper: 'Paste this to name the session: `/rename ' + r.s.sessionTitle + '`',
+  });
 }
 
 /* Secret scan for text Claude is about to post (PR body, PM comment). Prints hit TYPES only. */