scai 0.1.53 → 0.1.55

package/README.md

@@ -58,12 +58,6 @@ No more struggling to write pull request descriptions by hand. `scai git review`
 
 > ⚠️ These features are in **beta** — feedback welcome!
 
-## 🙌 Feedback
-
-Questions, ideas, or bugs?  
-Ping [@ticcr](https://bsky.app/profile/ticcr.xyz) on Bluesky — I'd love to hear your thoughts!
-
-
 ---
 
 ### 🔑 Setting Up Authentication (Required)
@@ -71,7 +65,7 @@ Ping [@ticcr](https://bsky.app/profile/ticcr.xyz) on Bluesky — I'd love to hea
 To interact with GitHub and create pull requests, `scai` needs a personal access token with **repo** permissions.
 
 1. **Create your GitHub Access Token**
-   Follow this link to generate a token: [https://github.com/settings/tokens?type=beta](https://github.com/settings/tokens?type=beta)
+   Follow this link to generate a token: [https://github.com/settings/personal-access-tokens](https://github.com/settings/personal-access-tokens)
 
    Make sure you enable at least:
 
@@ -99,7 +93,7 @@ To interact with GitHub and create pull requests, `scai` needs a personal access
    This is the repo from which scai will look up pull requests that can be reviewed. 
 
 ---
-
+## ⚒️ Usage Overview
 ### 🧠 How to Use `scai git review`
 
 ```bash
@@ -116,20 +110,67 @@ This will show you pull requests assigned to you for review:
   * ✅ Explanation of why the changes matter
   * ✅ Optional changelog bullets
 
-You’ll be shown a preview and asked to confirm before pushing or opening a PR.
 
-#### Flags
+SCAI supports an integrated review flow for GitHub pull requests. To get started:
 
-You can override behavior like this:
+1. **Set your working index directory (once per repo):**
 
-```bash
-scai git review -a
+   ```sh
+   scai set index-dir .
+   ```
+
+2. **Authenticate with GitHub:**
+
+   ```sh
+   scai auth set
+   scai auth check
+   ```
+
+3. **Fetch and review pull requests:**
+
+   ```sh
+   scai git review
+   ```
+
+   Use `-a` to list all PRs that require your review:
+
+   ```sh
+   scai git review -a
+   ```
+
+#### Example Workflow
+
+```sh
+$ scai git review -a
+🔍 Fetching pull requests and diffs...
+📦 Resolving GitHub repo info from indexDir: ./
+🔗 Git origin URL: git@github.com:org/repo.git
+✅ Parsed: owner='org', repo='repo'
+👤 Authenticated user: username
+
+📦 Open Pull Requests with review requested:
+1) #123 - Fix login timeout bug
+2) #122 - Upgrade dependencies
+
+👉 Choose a PR to review [1-2]: 1
+✅ Model response received.
+
+💡 AI-suggested review:
+
+Solid improvement — this patch improves session stability and handles async state more reliably. 
+You might consider renaming `sessionManager` to better reflect its dual role in auth and persistence.
+
+---
+1) ✅ Approve
+2) ❌ Reject
+3) ✍️ Edit
+4) Write your own review
+5) 🚪 Cancel
 ```
-This will show you all pull requests that have not yet been reviewed. 
 
-## ⚒️ Usage Overview
 
-### 🔧 Git Commit Suggestions
+
+### 🔧  How to Use `scai git sugg`
 
 Use AI to suggest a meaningful commit message based on your staged code:
 
@@ -183,7 +224,7 @@ scai gen tests <file>
 ```
 
 * `summ`: Summarize a file
-* `comm`: Add comments or refactor suggestions
+* `comm`: Add comments to a file
 * `changelog`: Update or create `CHANGELOG.md` from Git diff
 * `tests`: Create Jest test stubs (ALPHA)
 
@@ -271,17 +312,40 @@ You won't gain much value from the index unless you scope it to one repository.
 
 5. **Natural-language questions:**
 
+### 🧠 Natural-language questions
+
+Ask questions about your codebase using `scai ask`.
+
+You can run it in two ways:
+
+1. **Inline question**
+
    ```bash
    scai ask "How does mapcontrol work?"
    ```
 
-`find` and `ask` rely on that index—without it they will return no useful results.
+2. **Interactive prompt**
 
-## 🔄 Breaking Change in v0.1.47
+   ```bash
+   scai ask
+   ```
+
+   **Press enter**
+   , then type your question when prompted:
 
-> 🛠️ As of `v0.1.47`, the internal database schema has changed, and may well change in the future.
+   ```
+   > How does mapcontrol work?
+   ```
 
-🚨 **OBS**: The **Migrate** command is for **internal use only**. Do **not** run it unless explicitly instructed, as it may delete existing data or corrupt your local database.
+   </br>
+
+### 🚨 **OBS** 🚨
+
+`find` and `ask` rely on that index—without it they will return no useful results.
+
+---
+
+ Note the **Migrate** command is for **internal use only**. Do **not** run it unless explicitly instructed, as it may delete existing data or corrupt your local database.
 
 If you're upgrading from an earlier version, please run the following commands to avoid indexing issues:
 
@@ -289,6 +353,7 @@ If you're upgrading from an earlier version, please run the following commands t
 scai reset-db
 scai index
 ```
+</br>
 
 ---
 
@@ -299,7 +364,7 @@ scai index
   ```bash
   scai reset-db
   ```
-* **Manual backup of `~/.scai`:**
+* **Backup only of `~/.scai`:**
 
   ```bash
   scai backup
@@ -314,7 +379,6 @@ For custom pipelines on a single file:
 ```bash
 scai src/file.ts -m summary,comments
 ```
-
 ---
 
 ## 🔐 License & Fair Use
@@ -332,10 +396,21 @@ You may **not**:
 * ❌ Resell as a product or service
 * ❌ Claim ownership of the tool
 
+</br>
+
 ### 📄 License
 
 Free for personal and internal company use only.
 Commercial use (resale, SaaS, inclusion in paid tools) is prohibited.
 Contact me for commercial licensing.
 
-```
+---
+
+</br>
+
+## 🙌 Feedback
+
+Questions, ideas, or bugs?  
+Ping [@ticcr](https://bsky.app/profile/ticcr.xyz) on Bluesky — I'd love to hear your thoughts!
+
+---

package/dist/commands/ReviewCmd.js

@@ -30,17 +30,13 @@ export async function getPullRequestsForReview(token, owner, repo, username, bra
                 filtered.push({ pr, diff });
             }
             catch (err) {
-                console.warn(`⚠️ Could not fetch diff for PR #${pr.number}: ${err.message}`);
                 failedPRs.push(pr);
             }
         }
     }
     if (failedPRs.length > 0) {
-        console.warn(`\n⚠️ Skipped ${failedPRs.length} PR(s) due to diff fetch failures:`);
-        for (const pr of failedPRs) {
-            console.warn(`  - #${pr.number}: ${pr.title}`);
-        }
-        console.warn('These PRs will not be included in the review summary.\n');
+        const failedList = failedPRs.map(pr => `#${pr.number}`).join(', ');
+        console.warn(`⚠️ Skipped ${failedPRs.length} PR(s) (${failedList}) due to diff fetch errors.`);
     }
     return filtered;
 }
@@ -80,8 +76,8 @@ function askReviewApproval(suggestion) {
         console.log('1) ✅ Approve');
         console.log('2) ❌ Reject');
         console.log('3) ✍️ Edit');
-        console.log('4) Write your own review');
-        console.log('5) 🚪 Cancel');
+        console.log('4) ⌨️ Write your own review');
+        console.log('5) 🚫 Cancel');
         const rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout,

package/dist/utils/fileTree.js

@@ -9,7 +9,7 @@ export function generateFocusedFileTree(rootDir, focusPath, maxDepth = 2) {
 }
 function generateFileTree(dir, depth, highlightPath, prefix = '') {
     if (depth < 0)
-        return '';
+        return ''; // Stop at maxDepth
     let output = '';
     const entries = fs.readdirSync(dir, { withFileTypes: true });
     const sorted = entries.sort((a, b) => Number(b.isDirectory()) - Number(a.isDirectory()));
@@ -18,11 +18,13 @@ function generateFileTree(dir, depth, highlightPath, prefix = '') {
         const connector = isLast ? '└── ' : '├── ';
         const fullPath = path.join(dir, entry.name);
         const isHighlighted = highlightPath && path.resolve(fullPath) === path.resolve(highlightPath);
+        // If it is a directory, recurse and reduce depth
         if (entry.isDirectory()) {
             output += `${prefix}${connector}${entry.name}/\n`;
             output += generateFileTree(fullPath, depth - 1, highlightPath, prefix + (isLast ? '    ' : '│   '));
         }
         else {
+            // Highlight the file if it matches the focusPath
             const name = isHighlighted ? `➡️ ${entry.name}` : entry.name;
             output += `${prefix}${connector}${name}\n`;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scai",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "type": "module",
   "bin": {
     "scai": "./dist/index.js"