instar 0.7.19 → 0.7.20

package/.claude/skills/setup-wizard/skill.md

@@ -557,7 +557,7 @@ Create the directory structure and write config files:
 mkdir -p .instar/state/sessions .instar/state/jobs .instar/logs
 ```
 
-**`.instar/config.json`**:
+**`.instar/config.json`** (messaging section shown with Telegram — use `"messaging": []` if Telegram was not configured):
 ```json
 {
   "projectName": "my-project",
@@ -581,7 +581,19 @@ mkdir -p .instar/state/sessions .instar/state/jobs .instar/logs
     "quotaThresholds": { "normal": 50, "elevated": 70, "critical": 85, "shutdown": 95 }
   },
   "users": [],
-  "messaging": [],
+  "messaging": [
+    {
+      "type": "telegram",
+      "enabled": true,
+      "config": {
+        "token": "<BOT_TOKEN from BotFather>",
+        "chatId": "<CHAT_ID from Step 3e>",
+        "lifelineTopicId": "<LIFELINE_THREAD_ID from Step 3e>",
+        "pollIntervalMs": 2000,
+        "stallTimeoutMinutes": 5
+      }
+    }
+  ],
   "monitoring": {
     "quotaTracking": false,
     "memoryMonitoring": true,

package/.vercel/README.txt

@@ -0,0 +1,11 @@
+> Why do I have a folder named ".vercel" in my project?
+The ".vercel" folder is created when you link a directory to a Vercel project.
+
+> What does the "project.json" file contain?
+The "project.json" file contains:
+- The ID of the Vercel project that you linked ("projectId")
+- The ID of the user or team your Vercel project is owned by ("orgId")
+
+> Should I commit the ".vercel" folder?
+No, you should not share the ".vercel" folder with anyone.
+Upon creation, it will be automatically added to your ".gitignore" file.

package/.vercel/project.json

@@ -0,0 +1 @@
+{"projectId":"prj_evM5LcItYL3IAmw8zNvEPGrHeaya","orgId":"team_dHctwIDcV3X9ydapQlCPHFGI","projectName":"claude-agent-kit"}

package/dist/commands/init.js

@@ -160,7 +160,7 @@ async function initFreshProject(projectName, options) {
             enabled: true,
             webhookUrl: 'https://dawn.bot-me.ai/api/instar/feedback',
             feedbackFile: path.join(stateDir, 'feedback.json'),
-            sharedSecret: randomUUID().replace(/-/g, ''),
+            sharedSecret: 'instar-rising-tide-v1',
         },
         dispatches: {
             enabled: true,
@@ -338,7 +338,7 @@ async function initExistingProject(options) {
             enabled: true,
             webhookUrl: 'https://dawn.bot-me.ai/api/instar/feedback',
             feedbackFile: path.join(stateDir, 'feedback.json'),
-            sharedSecret: randomUUID().replace(/-/g, ''),
+            sharedSecret: 'instar-rising-tide-v1',
         },
         dispatches: {
             enabled: true,

package/dist/core/SessionManager.js

@@ -127,20 +127,24 @@ export class SessionManager extends EventEmitter {
         if (this.tmuxSessionExists(tmuxSession)) {
             throw new Error(`tmux session "${tmuxSession}" already exists`);
         }
-        // Build Claude CLI arguments — no shell intermediary.
-        // tmux new-session executes the command directly (no bash -c needed)
-        // when given as separate arguments after the session options.
+        // Build Claude CLI arguments via bash wrapper.
+        // Must unset CLAUDECODE to prevent "cannot be launched inside another Claude Code session"
+        // error when instar itself runs inside Claude Code.
         const claudeArgs = ['--dangerously-skip-permissions'];
         if (options.model) {
             claudeArgs.push('--model', options.model);
         }
         claudeArgs.push('-p', options.prompt);
+        const claudeCmd = [this.config.claudePath, ...claudeArgs]
+            .map(a => a.replace(/'/g, "'\\''"))
+            .map(a => `'${a}'`)
+            .join(' ');
         try {
             execFileSync(this.config.tmuxPath, [
                 'new-session', '-d',
                 '-s', tmuxSession,
                 '-c', this.config.projectDir,
-                this.config.claudePath, ...claudeArgs,
+                'bash', '-c', `unset CLAUDECODE; exec ${claudeCmd}`,
             ], { encoding: 'utf-8' });
         }
         catch (err) {
@@ -371,11 +375,14 @@ export class SessionManager extends EventEmitter {
             ];
             if (options?.telegramTopicId) {
                 // Wrap in bash shell to export env var before Claude starts
+                // Also unset CLAUDECODE to prevent nested Claude Code errors
                 const claudeCmd = `${this.config.claudePath} --dangerously-skip-permissions`;
-                tmuxArgs.push('bash', '-c', `export INSTAR_TELEGRAM_TOPIC=${options.telegramTopicId} && exec ${claudeCmd}`);
+                tmuxArgs.push('bash', '-c', `unset CLAUDECODE; export INSTAR_TELEGRAM_TOPIC=${options.telegramTopicId} && exec ${claudeCmd}`);
             }
             else {
-                tmuxArgs.push(this.config.claudePath, '--dangerously-skip-permissions');
+                // Unset CLAUDECODE to prevent nested Claude Code errors
+                const claudeCmd = `${this.config.claudePath} --dangerously-skip-permissions`;
+                tmuxArgs.push('bash', '-c', `unset CLAUDECODE; exec ${claudeCmd}`);
             }
             execFileSync(this.config.tmuxPath, tmuxArgs, { encoding: 'utf-8' });
         }

package/dist/scheduler/JobScheduler.js

@@ -406,6 +406,12 @@ export class JobScheduler {
         else {
             summary += '\n_No output captured (session already closed)_';
         }
+        // Skip Telegram notification for successful jobs with no meaningful output
+        // Prevents empty notification spam (e.g., dispatch-check when dispatch is unconfigured)
+        if (!failed && (!output || !output.trim())) {
+            console.log(`[scheduler] Skipping notification for ${job.slug} — no meaningful output`);
+            return;
+        }
         // Send to the job's dedicated topic if available, otherwise fall back to generic messenger
         if (this.telegram && job.topicId) {
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "0.7.19",
+  "version": "0.7.20",
   "description": "Persistent autonomy infrastructure for AI agents",
   "type": "module",
   "main": "dist/index.js",