byterover-cli 1.0.4 → 1.0.5

package/dist/resources/tools/curate.txt

@@ -1,22 +1,67 @@
-Curate knowledge topics with atomic operations. This tool manages the knowledge structure using four operation types:
+Curate knowledge topics with atomic operations. This tool manages the knowledge structure using four operation types and supports a two-part context model: Raw Concept + Narrative.
+
+**Content Structure (Two-Part Model):**
+- **rawConcept**: Captures essential metadata and technical footprint
+  - task: What is the task related to this concept
+  - changes: Array of changes induced in the codebase
+  - files: Array of related files
+  - flow: The execution flow of this concept
+  - timestamp: When created/modified (ISO 8601 format, e.g., 2025-03-18)
+- **narrative**: Captures descriptive and structural context
+  - structure: Code structure documentation (e.g., "clients/redis_client.go")
+  - dependencies: Dependency management information (e.g., "Singleton, init when service starts")
+  - features: Feature documentation (e.g., "User permission can be stale for up to 300 seconds")
+- **snippets**: Code/text snippets (legacy support, optional)
+- **relations**: Related topics using @domain/topic notation
 
 **Operations:**
-1. **ADD** - Create new domain/topic/subtopic with context.md
-   - Requires: path, content (snippets and/or relations), reason
-   - Example: { type: "ADD", path: "code_style/error-handling", content: { snippets: ["..."], relations: ["logging/basics"] }, reason: "New pattern identified" }
+1. **ADD** - Create new titled context file in domain/topic/subtopic
+   - Requires: path, title, content, reason
+   - Example with Raw Concept + Narrative:
+     {
+       type: "ADD",
+       path: "structure/caching",
+       title: "Redis User Permissions",
+       content: {
+         rawConcept: {
+           task: "Introduce Redis cache for getUserPermissions(userId)",
+           changes: ["Cached result using remote Redis", "Redis client: singleton"],
+           files: ["services/permission_service.go", "clients/redis_client.go"],
+           flow: "getUserPermissions -> check Redis -> on miss query DB -> store result -> return",
+           timestamp: "2025-03-18"
+         },
+         narrative: {
+           structure: "# Redis client\n- clients/redis_client.go",
+           dependencies: "# Redis client\n- Singleton, init when service starts",
+           features: "# Authorization\n- User permission can be stale for up to 300 seconds"
+         },
+         relations: ["@structure/database"]
+       },
+       reason: "New caching pattern"
+     }
+   - Creates: structure/caching/redis_user_permissions.md
+
+2. **UPDATE** - Modify existing titled context file (full replacement)
+   - Requires: path, title, content, reason
+   - Supports same content structure as ADD
+
+3. **MERGE** - Combine source file into target file, delete source
+   - Requires: path (source), title (source file), mergeTarget (destination path), mergeTargetTitle (destination file), reason
+   - Example: { type: "MERGE", path: "code_style/old_topic", title: "Old Guide", mergeTarget: "code_style/new_topic", mergeTargetTitle: "New Guide", reason: "Consolidating" }
+   - Raw concepts and narratives are intelligently merged
 
-2. **UPDATE** - Modify existing context.md (full replacement)
-   - Requires: path, content, reason
-   - Example: { type: "UPDATE", path: "code_style/error-handling", content: { snippets: ["Updated content"] }, reason: "Improved guidance" }
+4. **DELETE** - Remove specific file or entire folder
+   - Requires: path, title (optional), reason
+   - With title: deletes specific file; without title: deletes entire folder
 
-3. **MERGE** - Combine source topic into target, delete source
-   - Requires: path (source), mergeTarget (destination), reason
-   - Example: { type: "MERGE", path: "code_style/old-topic", mergeTarget: "code_style/new-topic", reason: "Consolidating duplicates" }
+**Path format:** domain/topic or domain/topic/subtopic (uses snake_case automatically)
+**File naming:** Titles are converted to snake_case (e.g., "Best Practices" -> "best_practices.md")
 
-4. **DELETE** - Remove topic/subtopic folder recursively
-   - Requires: path, reason
-   - Example: { type: "DELETE", path: "code_style/deprecated-topic", reason: "No longer relevant" }
+**Domain constraints:**
+- Predefined domains: code_style, design, structure, compliance, testing, bug_fixes
+- Up to 3 additional custom domains are allowed
+- Always prefer predefined domains when possible
 
-**Path format:** domain/topic or domain/topic/subtopic
+**Backward Compatibility:** Existing context entries using only snippets and relations continue to work.
 
-**Output:** Returns applied operations with status (success/failed) and a summary of counts.
+**Output:** Returns applied operations with status (success/failed), filePath (for created/modified files), and a summary of counts.

package/dist/tui/components/inline-prompts/inline-confirm.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 /**
  * InlineConfirm Component
  *
@@ -28,5 +28,5 @@ export function InlineConfirm({ default: defaultValue = true, message, onConfirm
             onConfirm(defaultValue);
         }
     };
-    return (_jsxs(Box, { children: [_jsx(Text, { color: colors.secondary, children: "? " }), _jsxs(Text, { color: colors.text, children: [message, " "] }), _jsxs(Text, { color: colors.secondary, children: [hint, " "] }), _jsx(TextInput, { onChange: setInput, onSubmit: handleSubmit, value: input })] }));
+    return (_jsx(Box, { children: _jsxs(Text, { color: colors.text, children: [message, "?", ' ', _jsxs(Text, { color: colors.secondary, children: [hint, " "] }), _jsx(TextInput, { onChange: setInput, onSubmit: handleSubmit, value: input })] }) }));
 }

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

@@ -37,6 +37,7 @@ 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 { mode } = useMode();

package/dist/tui/views/command-view.js

@@ -301,6 +301,21 @@ export const CommandView = ({ availableHeight }) => {
                 setActivePrompt(null);
                 const needReloadAuth = trimmed.startsWith('/login') || trimmed.startsWith('/logout');
                 const needReloadBrvConfig = trimmed.startsWith('/space switch') || trimmed.startsWith('/init');
+                const needNewSession = trimmed.startsWith('/new');
+                // Handle /new command - create new session and clear messages
+                if (needNewSession && client) {
+                    try {
+                        const response = await client.request('agent:newSession', { reason: 'User requested new session' });
+                        if (response.success) {
+                            // Clear the messages to start fresh
+                            setMessages([]);
+                            clearTasks();
+                        }
+                    }
+                    catch {
+                        // Error handling - the command already showed feedback
+                    }
+                }
                 // Refresh state after commands that change auth or project state
                 if (needReloadAuth || needReloadBrvConfig) {
                     clearTasks();

package/dist/utils/file-validator.js

@@ -7,11 +7,11 @@ import path from 'node:path';
  * @param filePath - The file path to normalize
  * @returns Normalized absolute path
  */
-function normalizeFilePath(filePath) {
+function normalizeFilePath(filePath, baseDir) {
     // Expand tilde to home directory
     const expanded = filePath.startsWith('~') ? filePath.replace(/^~/, os.homedir()) : filePath;
-    // Resolve to absolute path
-    const absolute = path.resolve(expanded);
+    // Resolve to absolute path using baseDir for relative paths
+    const absolute = path.isAbsolute(expanded) ? expanded : path.resolve(baseDir ?? process.cwd(), expanded);
     // Resolve symlinks (only if file exists)
     try {
         return fs.realpathSync(absolute);
@@ -57,8 +57,11 @@ function isTextFile(filePath) {
  * @returns Validation result with normalized path or error message
  */
 export function validateFileForCurate(filePath, projectRoot) {
-    // Normalize path
-    const normalized = normalizeFilePath(filePath);
+    // Normalize projectRoot first to ensure consistent behavior
+    // This handles cases where projectRoot might be relative
+    const normalizedProjectRoot = normalizeFilePath(projectRoot);
+    // Normalize file path using normalizedProjectRoot as base for relative paths
+    const normalized = normalizeFilePath(filePath, normalizedProjectRoot);
     // Check existence
     if (!fs.existsSync(normalized)) {
         return { error: `File does not exist: ${filePath}`, valid: false };
@@ -68,8 +71,7 @@ export function validateFileForCurate(filePath, projectRoot) {
     if (!stats.isFile()) {
         return { error: `Path is not a file: ${filePath}`, valid: false };
     }
-    // Check within project (normalized paths for reliable comparison)
-    const normalizedProjectRoot = normalizeFilePath(projectRoot);
+    // Check within project (both paths are already normalized)
     if (!normalized.startsWith(normalizedProjectRoot + path.sep) && normalized !== normalizedProjectRoot) {
         return { error: `File is outside project directory: ${filePath}`, valid: false };
     }

package/oclif.manifest.json

@@ -9,7 +9,7 @@
           "required": false
         }
       },
-      "description": "Curate context to the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv start\n\nGood examples:\n- \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n- \"API rate limit is 100 req/min per user. Implemented using Redis with sliding window in rateLimiter.ts\"\nBad examples:\n- \"Authentication\" or \"JWT tokens\" (too vague, lacks context)\n- \"Rate limiting\" (no implementation details or file references)",
+      "description": "Curate context to the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv\n\nGood examples:\n- \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n- \"API rate limit is 100 req/min per user. Implemented using Redis with sliding window in rateLimiter.ts\"\nBad examples:\n- \"Authentication\" or \"JWT tokens\" (too vague, lacks context)\n- \"Rate limiting\" (no implementation details or file references)",
       "examples": [
         "# Curate context - queues task for background processing",
         "<%= config.bin %> <%= command.id %> \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"",
@@ -75,7 +75,7 @@
           "required": true
         }
       },
-      "description": "Query and retrieve information from the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv start\n\nGood:\n- \"How is user authentication implemented?\"\n- \"What are the API rate limits and where are they enforced?\"\nBad:\n- \"auth\" or \"authentication\" (too vague, not a question)\n- \"show me code\" (not specific about what information is needed)",
+      "description": "Query and retrieve information from the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv\n\nGood:\n- \"How is user authentication implemented?\"\n- \"What are the API rate limits and where are they enforced?\"\nBad:\n- \"auth\" or \"authentication\" (too vague, not a question)\n- \"show me code\" (not specific about what information is needed)",
       "examples": [
         "# Ask questions about patterns, decisions, or implementation details",
         "<%= config.bin %> <%= command.id %> What are the coding standards?",
@@ -198,5 +198,5 @@
       ]
     }
   },
-  "version": "1.0.4"
+  "version": "1.0.5"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"

package/dist/config/context-tree-domains.d.ts

@@ -1,29 +0,0 @@
-/**
- * Domain configurations for the context tree structure.
- * Each domain represents a specific area of knowledge in the project.
- *
- * @deprecated Domains are now created dynamically based on content semantics.
- * This file is kept for backward compatibility only.
- */
-export interface DomainConfig {
-    description: string;
-    name: string;
-}
-/**
- * Example domain names for reference only.
- * Domains are now created dynamically by the agent based on content.
- *
- * @deprecated Domains are created dynamically. These are kept as examples only.
- */
-export declare const EXAMPLE_DOMAIN_NAMES: readonly ["authentication", "api_design", "data_models", "error_handling", "ui_components", "testing_patterns", "configuration", "logging", "security", "performance"];
-/**
- * @deprecated Domains are now created dynamically based on content semantics.
- * The agent will create domain names that are semantically meaningful for the curated content.
- * This constant is kept for backward compatibility but is no longer used.
- */
-export declare const DEFAULT_CONTEXT_TREE_DOMAINS: DomainConfig[];
-/**
- * Alias for backward compatibility.
- * @deprecated Domains are created dynamically. This constant is no longer used.
- */
-export declare const CONTEXT_TREE_DOMAINS: DomainConfig[];

package/dist/config/context-tree-domains.js

@@ -1,29 +0,0 @@
-/**
- * Example domain names for reference only.
- * Domains are now created dynamically by the agent based on content.
- *
- * @deprecated Domains are created dynamically. These are kept as examples only.
- */
-export const EXAMPLE_DOMAIN_NAMES = [
-    'authentication',
-    'api_design',
-    'data_models',
-    'error_handling',
-    'ui_components',
-    'testing_patterns',
-    'configuration',
-    'logging',
-    'security',
-    'performance',
-];
-/**
- * @deprecated Domains are now created dynamically based on content semantics.
- * The agent will create domain names that are semantically meaningful for the curated content.
- * This constant is kept for backward compatibility but is no longer used.
- */
-export const DEFAULT_CONTEXT_TREE_DOMAINS = [];
-/**
- * Alias for backward compatibility.
- * @deprecated Domains are created dynamically. This constant is no longer used.
- */
-export const CONTEXT_TREE_DOMAINS = DEFAULT_CONTEXT_TREE_DOMAINS;