instar 0.7.5 → 0.7.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/skills/setup-wizard/skill.md +43 -0
- package/.vercel/README.txt +11 -0
- package/.vercel/project.json +1 -0
- package/dist/cli.js +0 -0
- package/dist/commands/setup.js +42 -1
- package/package.json +1 -1
|
@@ -582,6 +582,49 @@ Offer to start the server.
|
|
|
582
582
|
|
|
583
583
|
**Important:** Do NOT present a list of CLI commands. The setup's job is to get the user FROM the terminal TO their agent. After starting the server, the user talks to their agent (through Telegram), not to the CLI. The terminal was just the on-ramp.
|
|
584
584
|
|
|
585
|
+
## Phase 6: Post-Setup Feedback (Optional)
|
|
586
|
+
|
|
587
|
+
After the server is running (or setup is complete), ask the user if they'd like to share feedback on the setup experience. Keep it light — one question, not a survey.
|
|
588
|
+
|
|
589
|
+
> "One last thing — how was this setup experience? Any rough spots or things you wish were different?"
|
|
590
|
+
>
|
|
591
|
+
> "Your feedback helps improve Instar for everyone. Totally optional."
|
|
592
|
+
|
|
593
|
+
Present options:
|
|
594
|
+
1. **Share feedback** — "I have thoughts"
|
|
595
|
+
2. **Skip** — "No, I'm good"
|
|
596
|
+
|
|
597
|
+
If they choose to share:
|
|
598
|
+
- Let them type freely — don't constrain the format
|
|
599
|
+
- Ask a follow-up if useful: "Anything else? Any features you expected that weren't here?"
|
|
600
|
+
|
|
601
|
+
Then save the feedback. Write it to `.instar/state/setup-feedback.json`:
|
|
602
|
+
|
|
603
|
+
```json
|
|
604
|
+
{
|
|
605
|
+
"timestamp": "2026-02-22T01:00:00.000Z",
|
|
606
|
+
"instarVersion": "0.7.x",
|
|
607
|
+
"setupMode": "project" | "personal",
|
|
608
|
+
"telegramConfigured": true | false,
|
|
609
|
+
"browserAutomationUsed": "playwright" | "manual" | "none",
|
|
610
|
+
"feedback": "User's free-form text here",
|
|
611
|
+
"os": "darwin" | "linux" | "win32",
|
|
612
|
+
"nodeVersion": "v20.x.x"
|
|
613
|
+
}
|
|
614
|
+
```
|
|
615
|
+
|
|
616
|
+
Also forward it via the feedback webhook if the server is running:
|
|
617
|
+
|
|
618
|
+
```bash
|
|
619
|
+
curl -s -X POST "http://localhost:${PORT}/feedback" \
|
|
620
|
+
-H 'Content-Type: application/json' \
|
|
621
|
+
-d '{"type":"improvement","title":"[Setup Feedback] User experience report","description":"...their feedback...","context":"setupMode=project, telegram=true, browser=playwright"}'
|
|
622
|
+
```
|
|
623
|
+
|
|
624
|
+
If the server isn't running yet, the local file is enough — the agent can forward it later when the server starts.
|
|
625
|
+
|
|
626
|
+
**This feedback is gold.** Common patterns in setup feedback directly inform what to improve next. Every user who takes 30 seconds to share their experience makes the next user's setup better.
|
|
627
|
+
|
|
585
628
|
## Tone
|
|
586
629
|
|
|
587
630
|
- Warm and conversational — first meeting between user and their agent
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
> Why do I have a folder named ".vercel" in my project?
|
|
2
|
+
The ".vercel" folder is created when you link a directory to a Vercel project.
|
|
3
|
+
|
|
4
|
+
> What does the "project.json" file contain?
|
|
5
|
+
The "project.json" file contains:
|
|
6
|
+
- The ID of the Vercel project that you linked ("projectId")
|
|
7
|
+
- The ID of the user or team your Vercel project is owned by ("orgId")
|
|
8
|
+
|
|
9
|
+
> Should I commit the ".vercel" folder?
|
|
10
|
+
No, you should not share the ".vercel" folder with anyone.
|
|
11
|
+
Upon creation, it will be automatically added to your ".gitignore" file.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"projectId":"prj_evM5LcItYL3IAmw8zNvEPGrHeaya","orgId":"team_dHctwIDcV3X9ydapQlCPHFGI","projectName":"claude-agent-kit"}
|
package/dist/cli.js
CHANGED
|
File without changes
|
package/dist/commands/setup.js
CHANGED
|
@@ -21,7 +21,8 @@ import path from 'node:path';
|
|
|
21
21
|
import pc from 'picocolors';
|
|
22
22
|
import { input, confirm, select, number } from '@inquirer/prompts';
|
|
23
23
|
import { Cron } from 'croner';
|
|
24
|
-
import { detectClaudePath, ensureStateDir } from '../core/Config.js';
|
|
24
|
+
import { detectClaudePath, ensureStateDir, getInstarVersion } from '../core/Config.js';
|
|
25
|
+
import { FeedbackManager } from '../core/FeedbackManager.js';
|
|
25
26
|
import { ensurePrerequisites } from '../core/Prerequisites.js';
|
|
26
27
|
import { UserManager } from '../users/UserManager.js';
|
|
27
28
|
/**
|
|
@@ -457,6 +458,46 @@ async function runClassicSetup() {
|
|
|
457
458
|
console.log(' For a richer experience, set up Telegram later with your agent\'s help.');
|
|
458
459
|
}
|
|
459
460
|
}
|
|
461
|
+
// ── Post-setup feedback ──────────────────────────────────────────
|
|
462
|
+
console.log();
|
|
463
|
+
const wantsFeedback = await confirm({
|
|
464
|
+
message: 'Quick question — how did the setup go? Want to share feedback?',
|
|
465
|
+
default: false,
|
|
466
|
+
});
|
|
467
|
+
if (wantsFeedback) {
|
|
468
|
+
const feedbackText = await input({
|
|
469
|
+
message: 'What went well, what was confusing, or what would you change?',
|
|
470
|
+
});
|
|
471
|
+
if (feedbackText.trim()) {
|
|
472
|
+
try {
|
|
473
|
+
const version = getInstarVersion();
|
|
474
|
+
const fm = new FeedbackManager({
|
|
475
|
+
enabled: true,
|
|
476
|
+
webhookUrl: 'https://dawn.bot-me.ai/api/instar/feedback',
|
|
477
|
+
feedbackFile: path.join(stateDir, 'feedback.json'),
|
|
478
|
+
version,
|
|
479
|
+
});
|
|
480
|
+
await fm.submit({
|
|
481
|
+
type: 'improvement',
|
|
482
|
+
title: 'Setup wizard feedback',
|
|
483
|
+
description: feedbackText.trim(),
|
|
484
|
+
agentName: config.projectName || 'unknown',
|
|
485
|
+
instarVersion: version,
|
|
486
|
+
nodeVersion: process.version,
|
|
487
|
+
os: process.platform,
|
|
488
|
+
context: JSON.stringify({
|
|
489
|
+
setupMode: 'classic',
|
|
490
|
+
telegramConfigured: !!telegramConfig?.chatId,
|
|
491
|
+
gitDetected: detectGitRepo(projectDir).isRepo,
|
|
492
|
+
}),
|
|
493
|
+
});
|
|
494
|
+
console.log(pc.green(' Thanks! Your feedback helps make Instar better for everyone.'));
|
|
495
|
+
}
|
|
496
|
+
catch {
|
|
497
|
+
console.log(pc.dim(' Feedback saved locally. Thanks!'));
|
|
498
|
+
}
|
|
499
|
+
}
|
|
500
|
+
}
|
|
460
501
|
console.log();
|
|
461
502
|
}
|
|
462
503
|
/**
|