@brunobrise/xfeat 1.2.0 → 1.4.0

package/.github/workflows/ci.yml

@@ -2,9 +2,9 @@ name: CI
 
 on:
   push:
-    branches: [ "main" ]
+    branches: ["main"]
   pull_request:
-    branches: [ "main" ]
+    branches: ["main"]
 
 jobs:
   build:
@@ -15,13 +15,13 @@ jobs:
         node-version: [18.x, 20.x]
 
     steps:
-    - uses: actions/checkout@v4
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-    - run: npm ci
-    - run: npm run lint
-    - run: npm test
-    - run: npm audit --audit-level=critical
+      - uses: actions/checkout@v4
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: "npm"
+      - run: npm ci
+      - run: npm run lint
+      - run: npm test
+      - run: npm audit --audit-level=critical

package/.vscode/settings.json

@@ -1 +1 @@
-{}
+{}

package/README.md

@@ -11,11 +11,15 @@
 - **Agentic Source Code Reading:** Rather than guessing based off function identifiers, the AI utilizes a specialized `view_file` tool to selectively dive into the raw source code wherever AST context is insufficient.
 - **Automated Mermaid Diagrams:** Visually maps out how files interact at macro and global architecture levels.
 - **Structured Markdown Deliverables:** Produces a neat, hierarchical `FEATURES.md` report encompassing everything from the executive summary to granular file logic.
-- **Smart Directory Traversal:** Adheres to your local `.gitignore` rules to avoid processing build artifacts and generic dependencies.
+- **Smart Directory Traversal:** Adheres to your local `.gitignore` and optional custom `.xfeatignore` rules to avoid processing build artifacts and generic dependencies.
 
 ## How It Works
 
-The engine executes in an expanding 3-stage pipeline:
+The engine executes in an expanding 4-stage pipeline:
+
+0. **AI Pre-filtering (Stage 0):**
+   - Interactively requests permission to AI-filter the target files.
+   - Cleans the file list by intelligently removing trivial boilerplate, config files, and UI assets dynamically, saving time and tokens.
 
 1. **Micro Analysis (File-Level):**
    - Identifies granular structural signatures across source files.
@@ -94,6 +98,7 @@ The foundational Tree-sitter AST parser natively understands:
 - TypeScript (`.ts`, `.tsx`)
 - Python (`.py`)
 - Rust (`.rs`)
+- Go (`.go`)
 
 ## License
 

package/index.js

@@ -51,6 +51,17 @@ async function getIgnores(targetDir) {
   } catch (err) {
     // No .gitignore found, proceed with defaults
   }
+
+  try {
+    const xfeatignoreContent = await fs.readFile(
+      path.join(targetDir, ".xfeatignore"),
+      "utf8",
+    );
+    ig.add(xfeatignoreContent);
+  } catch (err) {
+    // No .xfeatignore found, silently continue
+  }
+
   return ig;
 }
 
@@ -154,7 +165,8 @@ async function extractStructure(filePath) {
       const isClass =
         type.includes("class") ||
         type.includes("struct") ||
-        type.includes("interface");
+        type.includes("interface") ||
+        type === "type_spec";
       const isFunction =
         type.includes("function") ||
         type.includes("method") ||
@@ -169,8 +181,14 @@ async function extractStructure(filePath) {
       if (isClass) {
         const nameNode =
           node.childForFieldName("name") ||
-          node.children.find((c) => c.type === "identifier");
-        if (nameNode) structure.classes.push(nameNode.text);
+          node.children.find((c) => c.type === "identifier") ||
+          node.children.find((c) => c.type === "type_identifier");
+        if (nameNode) {
+          structure.classes.push(nameNode.text);
+          if (ext === ".go" && /^[A-Z]/.test(nameNode.text)) {
+            structure.exports.push(nameNode.text);
+          }
+        }
       }
 
       if (isFunction) {
@@ -179,6 +197,9 @@ async function extractStructure(filePath) {
           node.children.find((c) => c.type === "identifier");
         if (nameNode && !nameNode.text.startsWith("__")) {
           structure.functions.push(nameNode.text);
+          if (ext === ".go" && /^[A-Z]/.test(nameNode.text)) {
+            structure.exports.push(nameNode.text);
+          }
         }
       }
 

package/index.test.js

@@ -53,6 +53,17 @@ def py_function():
       `,
     );
 
+    await fs.writeFile(
+      path.join(testDir, "sample.go"),
+      `
+      package main
+      import "fmt"
+      type MyGoStruct struct {}
+      func (m *MyGoStruct) GoMethod() {}
+      func GoFunction() {}
+      `,
+    );
+
     await fs.writeFile(path.join(testDir, "unsupported.txt"), "Hello world");
 
     // Initialize TreeSitter before testing extraction
@@ -132,6 +143,21 @@ def py_function():
       expect(structure.functions).toContain("rs_function");
     });
 
+    it("should extract AST structure for Go files", async () => {
+      const goFilePath = path.join(testDir, "sample.go");
+      const structure = await extractStructure(goFilePath);
+
+      expect(structure).not.toBeNull();
+      expect(structure.file).toBe(goFilePath);
+      expect(structure.classes).toContain("MyGoStruct");
+      expect(structure.functions).toContain("GoMethod");
+      expect(structure.functions).toContain("GoFunction");
+      expect(structure.exports).toContain("MyGoStruct");
+      expect(structure.exports).toContain("GoMethod");
+      expect(structure.exports).toContain("GoFunction");
+      expect(structure.imports).toContain('"fmt"');
+    });
+
     it("should return null for unsupported file extensions", async () => {
       const txtFilePath = path.join(testDir, "unsupported.txt");
       const structure = await extractStructure(txtFilePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brunobrise/xfeat",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Automated AI-driven CLI for codebase analysis and feature extraction.",
   "publishConfig": {
     "access": "public"
@@ -42,6 +42,7 @@
     "map-stream": "^0.0.7",
     "tree-sitter-bash": "^0.25.1",
     "tree-sitter-css": "^0.25.0",
+    "tree-sitter-go": "^0.25.0",
     "tree-sitter-html": "^0.23.2",
     "tree-sitter-javascript": "^0.25.0",
     "tree-sitter-json": "^0.24.8",