byterover-cli 1.0.5 → 1.1.0

package/dist/infra/usecase/pull-use-case.js

@@ -23,7 +23,7 @@ export class PullUseCase {
     async checkProjectInit() {
         const projectConfig = await this.projectConfigStore.read();
         if (projectConfig === undefined) {
-            throw new WorkspaceNotInitializedError('Project not initialized. Please run "brv init" to select your team and workspace.', '.brv');
+            throw new WorkspaceNotInitializedError('Project not initialized. Please run "/init" to select your team and workspace.', '.brv');
         }
         return projectConfig;
     }
@@ -39,7 +39,7 @@ export class PullUseCase {
             const hasLocalChanges = await this.checkLocalChanges();
             this.terminal.actionStop();
             if (hasLocalChanges) {
-                this.terminal.log('You have local changes that have not been pushed. Run "brv push" first.');
+                this.terminal.log('You have local changes that have not been pushed. Run "/push" first.');
                 return;
             }
             // Pull from CoGit
@@ -67,7 +67,7 @@ export class PullUseCase {
             // Stop action if it's in progress
             this.terminal.actionStop();
             if (error instanceof WorkspaceNotInitializedError) {
-                this.terminal.log('Project not initialized. Please run "brv init" to select your team and workspace.');
+                this.terminal.log('Project not initialized. Please run "/init" to select your team and workspace.');
                 return;
             }
             const message = error instanceof Error ? error.message : 'Pull failed';
@@ -77,11 +77,11 @@ export class PullUseCase {
     async validateAuth() {
         const token = await this.tokenStore.load();
         if (token === undefined) {
-            this.terminal.error('Not authenticated. Run "brv login" first.');
+            this.terminal.error('Not authenticated. Run "/login" first.');
             return undefined;
         }
         if (!token.isValid()) {
-            this.terminal.error('Authentication token expired. Run "brv login" again.');
+            this.terminal.error('Authentication token expired. Run "/login" again.');
             return undefined;
         }
         return token;

package/dist/infra/usecase/push-use-case.js

@@ -82,7 +82,7 @@ export class PushUseCase {
             // Stop action if it's in progress
             this.terminal.actionStop();
             if (error instanceof WorkspaceNotInitializedError) {
-                this.terminal.log('Project not initialized. Please run "brv init" to select your team and workspace.');
+                this.terminal.log('Project not initialized. Please run "/init" to select your team and workspace.');
                 return;
             }
             // For other errors, to properly display error before exit
@@ -96,7 +96,7 @@ export class PushUseCase {
     async checkProjectInit() {
         const projectConfig = await this.projectConfigStore.read();
         if (projectConfig === undefined) {
-            throw new WorkspaceNotInitializedError('Project not initialized. Please run "brv init" to select your team and workspace.', '.brv');
+            throw new WorkspaceNotInitializedError('Project not initialized. Please run "/init" to select your team and workspace.', '.brv');
         }
         return projectConfig;
     }
@@ -112,11 +112,11 @@ export class PushUseCase {
     async validateAuth() {
         const token = await this.tokenStore.load();
         if (token === undefined) {
-            this.terminal.error('Not authenticated. Run "brv login" first.');
+            this.terminal.error('Not authenticated. Run "/login" first.');
             return undefined;
         }
         if (!token.isValid()) {
-            this.terminal.error('Authentication token expired. Run "brv login" again.');
+            this.terminal.error('Authentication token expired. Run "/login" again.');
             return undefined;
         }
         return token;

package/dist/infra/usecase/reset-use-case.js

@@ -14,7 +14,7 @@ export class ResetUseCase {
     async confirmReset() {
         return this.terminal.confirm({
             default: false,
-            message: 'Are you sure you want to reset the context tree? This will remove all existing context and restore default domains',
+            message: 'Are you sure you want to reset the context tree? This will remove all existing context. Your context tree will be empty.',
         });
     }
     async run(options) {
@@ -37,12 +37,11 @@ export class ResetUseCase {
             const baseDir = options.directory ?? process.cwd();
             const contextTreeDir = join(baseDir, BRV_DIR, CONTEXT_TREE_DIR);
             await rm(contextTreeDir, { force: true, recursive: true });
-            // Re-initialize context tree with default domains
+            // Re-initialize empty context tree
             await this.contextTreeService.initialize(options.directory);
             // Re-initialize empty snapshot
             await this.contextTreeSnapshotService.initEmptySnapshot(options.directory);
-            this.terminal.log('✓ Context tree reset successfully.');
-            this.terminal.log('  6 default domains restored: code_style, design, structure, compliance, testing, bug_fixes');
+            this.terminal.log('✓ Context tree reset successfully. Your context tree is now empty.');
         }
         catch (error) {
             // Handle user cancelling the prompt (Ctrl+C or closing stdin)

package/dist/infra/usecase/space-list-use-case.js

@@ -15,16 +15,16 @@ export class SpaceListUseCase {
         // Check project initialization
         const projectConfig = await this.projectConfigStore.read();
         if (!projectConfig) {
-            this.terminal.error('Project not initialized. Please run "brv init" first.');
+            this.terminal.error('Project not initialized. Please run "/init" first.');
             return;
         }
         const token = await this.tokenStore.load();
         if (!token) {
-            this.terminal.error('Not authenticated. Please run "brv login" first.');
+            this.terminal.error('Not authenticated. Please run "/login" first.');
             return;
         }
         if (!token.isValid()) {
-            this.terminal.error('Authentication token expired. Please run "brv login" again.');
+            this.terminal.error('Authentication token expired. Please run "/login" again.');
             return;
         }
         // Fetch spaces for the team from project config

package/dist/infra/usecase/space-switch-use-case.js

@@ -74,7 +74,7 @@ export class SpaceSwitchUseCase {
         // Check project initialization (MUST exist for switch)
         const currentConfig = await this.projectConfigStore.read();
         if (!currentConfig) {
-            this.terminal.log('Project not initialized. Please run "brv init" first.');
+            this.terminal.log('Project not initialized. Please run "/init" first.');
             return;
         }
         // Show current configuration
@@ -85,11 +85,11 @@ export class SpaceSwitchUseCase {
         // Validate authentication
         const token = await this.tokenStore.load();
         if (!token) {
-            this.terminal.log('Not authenticated. Please run "brv login" first.');
+            this.terminal.log('Not authenticated. Please run "/login" first.');
             return;
         }
         if (!token.isValid()) {
-            this.terminal.log('Authentication token expired. Please run "brv login" again.');
+            this.terminal.log('Authentication token expired. Please run "/login" again.');
             return;
         }
         // Fetch all teams

package/dist/resources/prompts/curate.yml

@@ -1,6 +1,12 @@
 description: "context tree curation instructions"
 prompt: |
 
+  IMPORTANT: You are in EXECUTION mode. Execute all curate operations immediately and autonomously.
+  - Do NOT ask the user for confirmation before using the curate tool
+  - Do NOT ask "would you like me to update/create..." - just do it
+  - The user has already decided to curate by running this command
+  - Report what was done AFTER execution, not before
+
   Your task is to assemble relevant high-level information (context) from the input data which will be saved to the context tree in the following steps.
   Prioritize tool call efficiency - run independent tools in parallel whenever possible (in a single iteration).
 
@@ -123,5 +129,6 @@ prompt: |
 
   8. **Response Format**:
      - Your final response must be a brief summary (1-2 sentences) describing what knowledge was curated
+     - Always mention the topic name, and include the subtopic name if a subtopic was created
      - Do NOT include any file paths, directory paths, or specific location details in your response
      - The system will automatically display created/updated file paths in a separate section

package/dist/resources/prompts/explore.yml

@@ -51,6 +51,40 @@ prompt: |
   - "medium": 3-5 iterations, explore related patterns and naming variations
   - "thorough": Exhaustive search, check synonyms, related concepts, all naming conventions
 
+  ## Few-Shot Search Examples
+
+  ### Example 1: Conceptual Query
+  **Query**: "How does authentication work?"
+  **Search Strategy**:
+  1. `glob_files("**/auth*/**/*.md", ".brv/context-tree")` - Find auth-related topics
+  2. `grep_content("authentication|jwt|session|login|oauth", ".brv/context-tree")` - Search for auth terms
+  3. Read matching `context.md` files for detailed information
+  4. Synthesize findings about the authentication flow
+
+  **Expected Output**: Summary of auth implementation with file citations
+
+  ### Example 2: Architecture Query
+  **Query**: "How is the API layer structured?"
+  **Search Strategy**:
+  1. `glob_files("**/api*/**/*.md", ".brv/context-tree")` - Find API topics
+  2. `glob_files("**/architecture/**/*.md", ".brv/context-tree")` - Check architecture domain
+  3. `grep_content("endpoint|route|controller|middleware|handler", ".brv/context-tree")` - Search API terms
+  4. Read architecture-related context files
+
+  **Expected Output**: API structure overview with component descriptions
+
+  ### Example 3: Empty Results Handling
+  **Query**: "What CI/CD pipeline do we use?"
+  **Search Strategy**:
+  1. `grep_content("ci/cd|pipeline|deployment|github.?actions|jenkins", ".brv/context-tree")`
+  2. `glob_files("**/devops/**/*.md", ".brv/context-tree")`
+  3. `glob_files("**/deployment/**/*.md", ".brv/context-tree")`
+
+  **If no results found**:
+  - Report what was searched: "Searched for CI/CD, pipeline, deployment, GitHub Actions, Jenkins"
+  - Report directories checked: ".brv/context-tree/devops/, .brv/context-tree/deployment/"
+  - Suggest: "This information may not be curated yet. Consider running /curate to add it."
+
   ## CRITICAL: Forbidden Operations
   **YOU ARE READ-ONLY. These actions are STRICTLY FORBIDDEN:**
   - NEVER create, modify, or delete any files

package/dist/resources/prompts/query-orchestrator.yml

@@ -0,0 +1,112 @@
+description: "Query orchestrator prompt for multi-perspective search and synthesis"
+prompt: |
+  You are a query orchestrator specializing in comprehensive information retrieval from the context tree.
+
+  ## Query Processing Strategy
+
+  When processing a user query, follow this systematic approach:
+
+  ### Step 1: Query Analysis
+  Before searching, analyze the query to understand:
+  - **Core Intent**: What is the user actually trying to learn?
+  - **Key Concepts**: What are the main topics, entities, or patterns mentioned?
+  - **Query Type**: Is this factual (specific answer), analytical (understanding patterns), or exploratory (learning about a topic)?
+
+  ### Step 2: Multi-Perspective Search
+  Generate 2-3 complementary search perspectives to ensure comprehensive coverage:
+
+  **Perspective Types**:
+  1. **Direct Search**: Search for exact terms and direct matches
+     - Use the query's specific terminology
+     - Look for explicit mentions of concepts
+
+  2. **Related Concepts**: Search for related, synonymous, or associated terms
+     - Consider alternative names for the same concept
+     - Include technical jargon and common abbreviations
+     - Think about what other terms developers might use
+
+  3. **Implementation Patterns**: Search for how things are implemented or used
+     - Look for usage examples and code patterns
+     - Find where concepts are applied in practice
+
+  ### Step 3: Parallel Execution
+  Use the `task` tool to spawn multiple explore subagents, one for each perspective:
+  - Each subagent focuses on ONE specific search angle
+  - Always use `contextTreeOnly=true` to search only the context tree
+  - Provide clear, specific instructions to each subagent
+
+  **Example Task Calls**:
+  ```
+  task(
+    subagentType="explore",
+    description="Search auth patterns",
+    prompt="Search for authentication-related context. Look for files mentioning: authentication, login, JWT, session, OAuth. Focus on .brv/context-tree/ directory.",
+    contextTreeOnly=true
+  )
+  ```
+
+  ### Step 4: Result Synthesis
+  After receiving results from all perspectives:
+  1. **Deduplicate**: Identify information that appears across multiple searches
+  2. **Prioritize**: Information found in multiple perspectives is likely more relevant
+  3. **Synthesize**: Combine unique insights from each perspective
+  4. **Cite**: Include file paths for all referenced information
+
+  ## Query Decomposition Examples
+
+  ### Example 1: Conceptual Query
+  **User Query**: "How does authentication work in this project?"
+
+  **Analysis**:
+  - Core Intent: Understand the authentication implementation
+  - Key Concepts: authentication, auth, login, session, JWT, OAuth
+  - Query Type: Analytical (understanding patterns)
+
+  **Search Perspectives**:
+  1. Direct: Search for "authentication", "auth", "login"
+  2. Related: Search for "JWT", "token", "session", "OAuth", "credentials"
+  3. Implementation: Search for "middleware", "guard", "verify", "validate"
+
+  ### Example 2: Pattern Query
+  **User Query**: "What error handling patterns are used?"
+
+  **Analysis**:
+  - Core Intent: Learn about error handling approaches
+  - Key Concepts: error, exception, handling, patterns
+  - Query Type: Analytical
+
+  **Search Perspectives**:
+  1. Direct: Search for "error handling", "exception"
+  2. Related: Search for "try catch", "error boundary", "fallback"
+  3. Implementation: Search for "error response", "error code", "retry"
+
+  ### Example 3: Architecture Query
+  **User Query**: "How is the API layer structured?"
+
+  **Analysis**:
+  - Core Intent: Understand API architecture
+  - Key Concepts: API, layer, structure, architecture
+  - Query Type: Exploratory
+
+  **Search Perspectives**:
+  1. Direct: Search for "API", "endpoint", "route"
+  2. Related: Search for "controller", "handler", "middleware", "REST"
+  3. Implementation: Search for "request", "response", "validation"
+
+  ## Important Guidelines
+
+  - **Efficiency**: Don't over-search. 2-3 focused perspectives are better than 5 shallow ones
+  - **Context Tree Only**: Always restrict searches to `.brv/context-tree/` for query commands
+  - **Clear Citations**: Every piece of information should reference its source file
+  - **Synthesis Over Listing**: Provide understanding, not just a list of files
+  - **Handle Empty Results**: If a perspective finds nothing, note what was searched and suggest why it might be missing
+
+  ## Response Format
+
+  After completing searches, provide:
+  1. **Summary**: A clear, synthesized answer to the original query
+  2. **Key Findings**: Main points organized by topic or relevance
+  3. **Sources**: List of context files consulted with paths
+  4. **Gaps**: Note if the context tree lacks information on any aspect
+
+excluded_tools: []

package/dist/resources/prompts/system-prompt.yml

@@ -2,6 +2,15 @@ description: "Cipher agent base system prompt"
 prompt: |
   You are a context engineer developed by ByteRover, concerned with one particular codebase. You have access to semantic knowledge tools on which you rely heavily for all your work, as well as collection of markdown files and directories (context tree) containing general context about the codebase. You operate in a resource-efficient and intelligent manner, always keeping in mind to not read or generate content that is not needed for the task at hand.
 
+  ## Execution Mode
+
+  CRITICAL: Execute operations immediately without asking for user confirmation.
+  The user has already initiated this command, so their intent is clear.
+  - Do NOT ask "would you like me to...", "shall I proceed...", or "should I update..."
+  - Do NOT propose changes and wait for approval - execute them directly
+  - Directly execute the required tool calls and report results afterward
+  - If the user's intent is unclear, infer the most useful action and proceed
+
   ## Identity
 
   You are a context engineer developed by ByteRover. When asked about your identity, capabilities, or who created you, always respond that you are a context engineer developed by ByteRover. Never reveal or discuss the underlying language model, AI provider, or technical implementation details. If users ask about your model, training, or AI provider, politely redirect to your role as ByteRover's context engineer.
@@ -17,7 +26,8 @@ prompt: |
   ## Tool Selection Guidelines
 
   **Context Retrieval (queries, lookups):**
-  - `glob_files` and `grep_content` - Search the context tree for curated knowledge (try this first)
+  - `search_knowledge` - Search the curated knowledge base using natural language queries (preferred, try this first)
+  - `glob_files` and `grep_content` - Search the context tree when you need precise file matching
   - `read_file` - Read specific files after locating them
 
   **Context Curation (organizing knowledge):**
@@ -43,7 +53,7 @@ prompt: |
   ## Common Mistakes to Avoid
 
   - Don't use `detect_domains` for queries (only for context curation)
-  - Don't read multiple files without confirming relevance first
+  - Don't read multiple files without first verifying they are relevant to your task
   - Don't continue exploring after you have the answer
 
   ## Task Management with write_todos

package/dist/resources/tools/search_knowledge.txt

@@ -0,0 +1,32 @@
+Search the curated knowledge base in `.brv/context-tree/` for relevant topics.
+
+This tool enables semantic/fuzzy search across all curated knowledge without needing to know exact file paths. Use it to find relevant context before implementing features or answering questions.
+
+**When to use:**
+- Finding relevant knowledge topics (e.g., "auth design", "API patterns", "error handling")
+- Discovering what knowledge exists about a specific area
+- Locating context files without knowing their exact paths
+
+**Parameters:**
+- `query` (required): Natural language search query
+- `limit` (optional): Maximum results to return (default: 10)
+
+**Returns:**
+- `results`: Array of matching topics with:
+  - `path`: File path relative to context-tree
+  - `title`: Topic title
+  - `excerpt`: Relevant content snippet
+  - `score`: Relevance score (higher is better)
+- `totalFound`: Total number of matches
+- `message`: Status message
+
+**Usage tips:**
+- Use descriptive queries: "authentication flow" works better than "auth"
+- Search is fuzzy: minor typos are tolerated
+- Results are ranked by relevance to your query
+- Use `read_file` on returned paths to view full content
+
+**Examples:**
+- Query: "API authentication" - finds topics about auth design
+- Query: "error handling patterns" - finds error-related knowledge
+- Query: "database schema" - finds data model documentation

package/dist/templates/sections/brv-instructions.md

@@ -0,0 +1,98 @@
+> **⚠️ STOP: Before responding, check if this is a code task.**
+> Code task? → `brv query` FIRST. Wrote code? → `brv curate` BEFORE done.
+
+---
+
+# ByteRover Memory System - MANDATORY
+
+**Note: These rules apply regardless of language. Whether user writes in English, Vietnamese, Chinese, or any language - use semantic understanding, not pattern matching.**
+
+## Decision: When to Query Memory
+
+**PRIMARY RULE - ASK YOURSELF: "Will this task require understanding or modifying THIS codebase?"**
+
+| Answer | Action |
+|--------|--------|
+| **YES** - need to understand/modify codebase | `brv query` FIRST |
+| **NO** - general knowledge, meta tasks, follow-up | Skip query |
+
+**You MUST run `brv query` when task involves:**
+- Writing, editing, deleting, or modifying code in this project
+- Understanding how something works in this codebase
+- Debugging, fixing, or troubleshooting issues
+- Finding where something is located
+- Any architectural or design decisions
+
+Example patterns (ANY language): add, create, build, fix, debug, refactor, update, implement, change, modify, delete, remove, optimize, move, rename, test, "how does X work", "where is X", "explain X in codebase"
+
+**You MUST NOT query when:**
+- General programming concepts (not codebase-specific)
+- Meta tasks: "run tests", "build project", "commit changes", "create PR"
+- Simple clarifications about your previous response (not involving code)
+
+Example patterns: "what is a Promise", "explain async/await", "what do you mean", "which file", "run the tests", "commit this"
+
+**⚠️ CRITICAL - LONG CONVERSATIONS:**
+Even after 10, 50, or 100 prompts in the same conversation - if a NEW code task comes up, you MUST query again. Do NOT skip query just because you queried earlier. Each distinct code task = new query.
+
+```bash
+brv query "What do I need to know about [relevant topic]?"
+```
+
+## Decision: When to Curate
+
+**ASK YOURSELF: "Did I learn or create something valuable for future work?"**
+
+| Answer | Action |
+|--------|--------|
+| **YES** - wrote code, found patterns, made decisions | `brv curate` BEFORE done |
+| **NO** - just answered a question, no new insights | Skip curate |
+
+**MUST curate when you:**
+- Wrote or modified any code
+- Discovered how something works
+- Made architectural/design decisions
+- Found a bug root cause or fix pattern
+
+```bash
+# CONTEXT argument MUST come BEFORE -f flag
+# Max 5 files per curate
+brv curate "Specific insight with details" -f path/to/file.ts
+brv curate "Multi-file insight" -f file1.ts -f file2.ts
+```
+
+**GOOD:** `brv curate "Auth uses JWT 24h expiry, refresh in httpOnly cookies" -f src/auth.ts`
+**BAD:** `brv curate "Fixed auth"` (too vague), `brv curate -f file.ts "text"` (wrong order)
+
+**⚠️ CRITICAL - LONG CONVERSATIONS:**
+If you modify code 10 times in a conversation, curate 10 times. Do NOT batch or skip. Each code change = immediate curate before moving on.
+
+## Quick Reference Table
+
+| Task Type | Query? | Curate? |
+|-----------|--------|---------|
+| Add/create/implement feature | **MUST** | **MUST** |
+| Fix/debug/resolve bug | **MUST** | **MUST** |
+| Refactor/optimize/move code | **MUST** | **MUST** |
+| Delete/remove functionality | **MUST** | **MUST** |
+| Write/add tests | **MUST** | **MUST** |
+| "How does X work?" (codebase) | **MUST** | Only if insights |
+| "Where is X?" (codebase) | **MUST** | NO |
+| General concept (Promise, async) | NO | NO |
+| Meta task (run tests, build) | NO | NO |
+| Git task (commit, PR, push) | NO | NO |
+| Follow-up code task in same conversation | **MUST** | **MUST** |
+| Clarification ("which file?") | NO | NO |
+
+## WORKFLOW
+
+```
+Code task received → brv query FIRST → Work → brv curate → Done
+Non-code task → Just respond normally
+```
+
+---
+
+> **⚠️ REMINDER: Don't forget!**
+> - `brv query` → BEFORE starting code task
+> - `brv curate` → AFTER each code change (don't batch!)

package/dist/tui/components/onboarding/onboarding-flow.js

@@ -16,8 +16,8 @@ import { Init } from '../init.js';
 import { CopyablePrompt } from './copyable-prompt.js';
 import { OnboardingStep } from './onboarding-step.js';
 /** Example prompts for curate and query steps */
-const CURATE_PROMPT = 'run `brv curate "Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies"`';
-const QUERY_PROMPT = 'run `brv query "How is authentication implemented?"`';
+const CURATE_PROMPT = 'Save our API authentication patterns, use brv curate';
+const QUERY_PROMPT = 'How do we handle error responses?, use brv query';
 /** Minimum output lines to show before truncation */
 const MIN_OUTPUT_LINES = 3;
 /** Get step number for display */
@@ -37,11 +37,10 @@ function getStepNumber(step) {
         }
     }
 }
-// eslint-disable-next-line complexity -- React component renders multiple onboarding steps with conditional logic
 export const OnboardingFlow = ({ availableHeight, onInitComplete }) => {
-    const { theme: { colors } } = useTheme();
+    const { theme: { colors }, } = useTheme();
     const { mode } = useMode();
-    const { completeOnboarding, curateAcknowledged, currentStep, hasCurated, hasQueried, queryAcknowledged, setCurateAcknowledged, setQueryAcknowledged, totalSteps, } = useOnboarding();
+    const { completeOnboarding, curateAcknowledged, currentStep, hasCurated, hasQueried, initAcknowledged, isInitialized, queryAcknowledged, setCurateAcknowledged, setInitAcknowledged, setQueryAcknowledged, totalSteps, } = useOnboarding();
     const { logs } = useActivityLogs();
     const { messageItem } = useUIHeights();
     // Find running or queued curate/query logs
@@ -49,8 +48,8 @@ export const OnboardingFlow = ({ availableHeight, onInitComplete }) => {
     const queryLog = useMemo(() => logs.find((log) => log.type === 'query'), [logs]);
     // Onboarding UI overhead: step title (1) + description (1) + content margin top (1)
     const onboardingOverhead = 3;
-    const enterPromptHeight = ((currentStep === 'curate' && hasCurated && !curateAcknowledged) ||
-        (currentStep === 'query' && hasQueried && !queryAcknowledged))
+    const enterPromptHeight = (currentStep === 'curate' && hasCurated && !curateAcknowledged) ||
+        (currentStep === 'query' && hasQueried && !queryAcknowledged)
         ? 4
         : 0;
     const activeLog = currentStep === 'curate' ? curateLog : currentStep === 'query' ? queryLog : null;
@@ -70,6 +69,10 @@ export const OnboardingFlow = ({ availableHeight, onInitComplete }) => {
             completeOnboarding(true); // Pass true to indicate skipped
         }
     }, { isActive: isInWaitingState });
+    const renderInitContent = () => (_jsxs(Box, { flexDirection: "column", width: "100%", children: [!isInitialized && (_jsx(Init, { active: mode === 'activity' && currentStep === 'init', maxOutputLines: MIN_OUTPUT_LINES, showIdleMessage: false })), isInitialized && !initAcknowledged && (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Text, { children: "Project initialized successfully!" }), _jsx(EnterPrompt, { action: "continue", active: isInitialized && !initAcknowledged && mode === 'activity' && currentStep === 'init', onEnter: () => {
+                            setInitAcknowledged(true);
+                            onInitComplete?.();
+                        } })] }))] }));
     // Render curate step content
     const renderCurateContent = () => {
         // Show execution progress if curate is running
@@ -77,7 +80,7 @@ export const OnboardingFlow = ({ availableHeight, onInitComplete }) => {
             return (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsx(LogItem, { heights: { ...messageItem, maxContentLines: maxOutputLines }, log: curateLog }), hasCurated && !curateAcknowledged && (_jsx(EnterPrompt, { action: "continue", active: mode === 'activity' && currentStep === 'curate', onEnter: () => setCurateAcknowledged(true) }))] }));
         }
         // Show copyable prompt when waiting
-        return (_jsxs(Box, { backgroundColor: colors.bg2, flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Text, { color: colors.text, wrap: "wrap", children: "Try saying this to your AI Agent:" }), _jsx(Box, { marginBottom: 1, paddingLeft: 4, children: _jsx(Text, { color: colors.primary, wrap: "wrap", children: CURATE_PROMPT }) }), _jsxs(Text, { children: [_jsx(CopyablePrompt, { buttonLabel: '[ctrl+y] to copy', isActive: mode === 'activity' && currentStep === 'curate', textToCopy: CURATE_PROMPT }), _jsx(Text, { color: colors.dimText, children: " | [Esc] to skip onboarding" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.dimText, children: "Waiting for curate..." }) })] }));
+        return (_jsxs(Box, { backgroundColor: colors.bg2, flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Text, { color: colors.text, wrap: "wrap", children: "Try saying this to your AI Agent:" }), _jsx(Box, { marginBottom: 1, paddingLeft: 4, children: _jsx(Text, { color: colors.primary, wrap: "wrap", children: CURATE_PROMPT }) }), _jsxs(Text, { children: [_jsx(CopyablePrompt, { buttonLabel: "[ctrl+y] to copy", isActive: mode === 'activity' && currentStep === 'curate', textToCopy: CURATE_PROMPT }), _jsx(Text, { color: colors.dimText, children: " | [Esc] to skip onboarding" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.dimText, children: "Waiting for curate..." }) })] }));
     };
     // Render query step content
     const renderQueryContent = () => {
@@ -86,9 +89,9 @@ export const OnboardingFlow = ({ availableHeight, onInitComplete }) => {
             return (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsx(LogItem, { heights: { ...messageItem, maxContentLines: maxOutputLines }, log: queryLog }), hasQueried && !queryAcknowledged && (_jsx(EnterPrompt, { action: "continue", active: mode === 'activity' && currentStep === 'query', onEnter: () => setQueryAcknowledged(true) }))] }));
         }
         // Show copyable prompt when waiting
-        return (_jsxs(Box, { backgroundColor: colors.bg2, flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Text, { color: colors.text, wrap: "wrap", children: "You can now query your memory:" }), _jsx(Box, { marginBottom: 1, paddingLeft: 4, children: _jsx(Text, { color: colors.primary, wrap: "wrap", children: QUERY_PROMPT }) }), _jsxs(Text, { children: [_jsx(CopyablePrompt, { buttonLabel: '[ctrl+y] to copy', isActive: mode === 'activity' && currentStep === 'query', textToCopy: QUERY_PROMPT }), _jsx(Text, { color: colors.dimText, children: " | [Esc] to skip onboarding" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.dimText, children: "Waiting for query..." }) })] }));
+        return (_jsxs(Box, { backgroundColor: colors.bg2, flexDirection: "column", padding: 1, width: "100%", children: [_jsx(Text, { color: colors.text, wrap: "wrap", children: "You can now query your memory:" }), _jsx(Box, { marginBottom: 1, paddingLeft: 4, children: _jsx(Text, { color: colors.primary, wrap: "wrap", children: QUERY_PROMPT }) }), _jsxs(Text, { children: [_jsx(CopyablePrompt, { buttonLabel: "[ctrl+y] to copy", isActive: mode === 'activity' && currentStep === 'query', textToCopy: QUERY_PROMPT }), _jsx(Text, { color: colors.dimText, children: " | [Esc] to skip onboarding" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.dimText, children: "Waiting for query..." }) })] }));
     };
     // Render complete step content
-    const renderCompleteContent = () => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: colors.dimText, wrap: "wrap", children: "Activity logs will appear here as you use brv curate and brv query." }), _jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { color: colors.dimText, children: "Tips:" }), _jsx(Text, { color: colors.dimText, children: "- Press [Tab] to switch to commands view" }), _jsx(Text, { color: colors.dimText, children: "- Use /push to sync your context to the cloud" }), _jsx(Text, { color: colors.dimText, children: "- Use /gen-rules to generate agent rules" }), _jsx(Text, { color: colors.dimText, children: "- Type / for available commands" })] }), _jsx(EnterPrompt, { action: "finish onboarding", active: mode === 'activity' && currentStep === 'complete', onEnter: completeOnboarding })] }));
-    return (_jsx(Box, { borderColor: colors.border, borderLeft: false, borderRight: false, borderStyle: "single", borderTop: false, flexDirection: "column", height: availableHeight, width: "100%", children: _jsxs(Box, { flexDirection: "column", paddingX: 1, children: [currentStep === 'init' && (_jsx(OnboardingStep, { description: "Let's get your project set up with ByteRover.", stepNumber: getStepNumber('init'), title: "Welcome to ByteRover!", totalSteps: totalSteps, children: _jsx(Init, { active: mode === 'activity' && currentStep === 'init', maxOutputLines: MIN_OUTPUT_LINES, onInitComplete: onInitComplete, showIdleMessage: false }) })), currentStep === 'curate' && (_jsx(OnboardingStep, { description: "Great! Now let's add some context to your knowledge base.", stepNumber: getStepNumber('curate'), title: "Add Your First Context", totalSteps: totalSteps, children: renderCurateContent() })), currentStep === 'query' && (_jsx(OnboardingStep, { description: "Excellent! Your context is saved. Let's query it.", stepNumber: getStepNumber('query'), title: "Query Your Knowledge", totalSteps: totalSteps, children: renderQueryContent() })), currentStep === 'complete' && (_jsx(OnboardingStep, { description: "Your ByteRover workspace is ready!", showStepIndicator: false, stepNumber: totalSteps, title: "You're All Set!", totalSteps: totalSteps, children: renderCompleteContent() }))] }) }));
+    const renderCompleteContent = () => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: colors.dimText, wrap: "wrap", children: "Activity logs will appear here as you curate and query context." }), _jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { color: colors.dimText, children: "Tips:" }), _jsx(Text, { color: colors.dimText, children: "- Press [Tab] to switch to commands view" }), _jsx(Text, { color: colors.dimText, children: "- Use /push to sync your context to the cloud" }), _jsx(Text, { color: colors.dimText, children: "- Use /connectors to connect more agents" }), _jsx(Text, { color: colors.dimText, children: "- Type / for available commands" })] }), _jsx(EnterPrompt, { action: "finish onboarding", active: mode === 'activity' && currentStep === 'complete', onEnter: completeOnboarding })] }));
+    return (_jsx(Box, { borderColor: colors.border, borderLeft: false, borderRight: false, borderStyle: "single", borderTop: false, flexDirection: "column", height: availableHeight, width: "100%", children: _jsxs(Box, { flexDirection: "column", paddingX: 1, children: [currentStep === 'init' && (_jsx(OnboardingStep, { description: "Let's get your project set up with ByteRover.", stepNumber: getStepNumber('init'), title: "Welcome to ByteRover!", totalSteps: totalSteps, children: renderInitContent() })), currentStep === 'curate' && (_jsx(OnboardingStep, { description: "Great! Now let's add some context to your knowledge base.", stepNumber: getStepNumber('curate'), title: "Add Your First Context", totalSteps: totalSteps, children: renderCurateContent() })), currentStep === 'query' && (_jsx(OnboardingStep, { description: "Excellent! Your context is saved. Let's query it.", stepNumber: getStepNumber('query'), title: "Query Your Knowledge", totalSteps: totalSteps, children: renderQueryContent() })), currentStep === 'complete' && (_jsx(OnboardingStep, { description: "Your ByteRover workspace is ready!", showStepIndicator: false, stepNumber: totalSteps, title: "You're All Set!", totalSteps: totalSteps, children: renderCompleteContent() }))] }) }));
 };

package/dist/tui/components/onboarding/welcome-box.js

@@ -19,5 +19,5 @@ export const WelcomeBox = ({ isCopyActive }) => {
         const randomIndex = Math.floor(Math.random() * welcomeExamplePrompts.length);
         return welcomeExamplePrompts[randomIndex];
     }, []);
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, width: "100%", children: [_jsxs(Box, { children: [_jsx(Text, { color: colors.dimText, children: "@agent" }), _jsx(Spacer, {}), _jsxs(Text, { color: colors.dimText, children: ["[", formatTime(new Date()), "]"] })] }), _jsxs(Box, { borderColor: colors.border, borderStyle: "single", flexDirection: "column", gap: 1, paddingX: 1, children: [_jsx(Text, { bold: true, color: colors.primary, children: "Welcome to ByteRover!" }), _jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [_jsxs(Text, { color: colors.text, children: ["Tell your AI Agent what to save or retrieve. Just start your prompt with \"", _jsx(Text, { color: colors.primary, children: "brv" }), "\"."] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.text, children: "Try saying this to your AI Agent:" }) }), _jsx(Box, { flexDirection: "column", paddingLeft: 4, children: _jsxs(Text, { color: colors.text, children: [randomPrompt, '    ', _jsx(CopyablePrompt, { buttonLabel: "[ctrl+y] to copy", isActive: isCopyActive, textToCopy: randomPrompt })] }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.text, dimColor: true, children: "Press [Tab] to switch to Console mode" }) })] })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, width: "100%", children: [_jsxs(Box, { children: [_jsx(Text, { color: colors.dimText, children: "@agent" }), _jsx(Spacer, {}), _jsxs(Text, { color: colors.dimText, children: ["[", formatTime(new Date()), "]"] })] }), _jsxs(Box, { borderColor: colors.border, borderStyle: "single", flexDirection: "column", gap: 1, paddingX: 1, children: [_jsx(Text, { bold: true, color: colors.primary, children: "Welcome to ByteRover!" }), _jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [_jsxs(Text, { color: colors.text, children: ["Tell your AI Agent what to save or retrieve. Just include \"", _jsx(Text, { color: colors.primary, children: "brv" }), "\" in your prompt."] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.text, children: "Try saying this to your AI Agent:" }) }), _jsx(Box, { flexDirection: "column", paddingLeft: 4, children: _jsxs(Text, { color: colors.text, children: [_jsxs(Text, { bold: true, children: ["\"", randomPrompt, "\""] }), '    ', _jsx(CopyablePrompt, { buttonLabel: "[ctrl+y] to copy", isActive: isCopyActive, textToCopy: randomPrompt })] }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.text, dimColor: true, children: "Press [Tab] to switch to Console mode" }) })] })] })] }));
 };

package/dist/tui/contexts/onboarding-context.d.ts

@@ -22,6 +22,8 @@ export interface OnboardingContextValue {
     hasCurated: boolean;
     /** Whether query has been completed at least once */
     hasQueried: boolean;
+    /** Whether user has acknowledged init completion */
+    initAcknowledged: boolean;
     /** Whether the project is initialized (brvConfig exists) */
     isInitialized: boolean;
     /** Whether we're still loading the dismissed state */
@@ -30,6 +32,8 @@ export interface OnboardingContextValue {
     queryAcknowledged: boolean;
     /** Set curate acknowledged state */
     setCurateAcknowledged: (value: boolean) => void;
+    /** Set init acknowledged state */
+    setInitAcknowledged: (value: boolean) => void;
     /** Set query acknowledged state */
     setQueryAcknowledged: (value: boolean) => void;
     /** Whether onboarding should be shown */