@aiready/agent-grounding 0.13.0 → 0.13.2

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/agent-grounding@0.12.0 build /Users/pengcao/projects/aiready/packages/agent-grounding
+> @aiready/agent-grounding@0.13.2 build /Users/pengcao/projects/aiready/packages/agent-grounding
 > tsup src/index.ts src/cli.ts --format cjs,esm --dts
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -9,16 +9,16 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-CJS dist/cli.js   16.65 KB
-CJS dist/index.js 12.42 KB
-CJS ⚡️ Build success in 51ms
 ESM dist/cli.mjs            5.16 KB
+ESM dist/index.mjs          1.18 KB
 ESM dist/chunk-AWAS2KB5.mjs 9.83 KB
-ESM dist/index.mjs          1.30 KB
-ESM ⚡️ Build success in 50ms
+ESM ⚡️ Build success in 114ms
+CJS dist/cli.js   16.65 KB
+CJS dist/index.js 12.30 KB
+CJS ⚡️ Build success in 114ms
 DTS Build start
-DTS ⚡️ Build success in 1988ms
+DTS ⚡️ Build success in 4182ms
 DTS dist/cli.d.ts    20.00 B
-DTS dist/index.d.ts  2.49 KB
+DTS dist/index.d.ts  2.54 KB
 DTS dist/cli.d.mts   20.00 B
-DTS dist/index.d.mts 2.49 KB
+DTS dist/index.d.mts 2.54 KB

package/.turbo/turbo-test.log

@@ -1,18 +1,19 @@
 
 
-> @aiready/agent-grounding@0.12.0 test /Users/pengcao/projects/aiready/packages/agent-grounding
+> @aiready/agent-grounding@0.13.1 test /Users/pengcao/projects/aiready/packages/agent-grounding
 > vitest run
 
 [?25l
  RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/agent-grounding
 
- ✓ src/__tests__/provider.test.ts (2 tests) 6ms
- ✓ src/__tests__/scoring.test.ts (2 tests) 2ms
- ✓ src/__tests__/analyzer.test.ts (3 tests) 559ms
+ ✓ src/__tests__/provider.test.ts (2 tests) 29ms
+ ✓ src/__tests__/scoring.test.ts (2 tests) 25ms
+ ✓ src/__tests__/analyzer.test.ts (3 tests) 504ms
+       ✓ should detect deep directories and vague file names  429ms
 
  Test Files  3 passed (3)
       Tests  7 passed (7)
-   Start at  16:14:19
-   Duration  3.12s (transform 817ms, setup 0ms, import 6.90s, tests 567ms, environment 25ms)
+   Start at  02:00:17
+   Duration  3.04s (transform 719ms, setup 0ms, import 4.70s, tests 558ms, environment 0ms)
 
 [?25h

package/dist/index.d.mts

@@ -1,9 +1,10 @@
-import { ToolProvider, Issue, IssueType, ScanOptions, ToolScoringOutput } from '@aiready/core';
+import * as _aiready_core from '@aiready/core';
+import { Issue, IssueType, ScanOptions, ToolScoringOutput } from '@aiready/core';
 
 /**
  * Agent Grounding Tool Provider
  */
-declare const AgentGroundingProvider: ToolProvider;
+declare const AgentGroundingProvider: _aiready_core.ToolProvider;
 
 interface AgentGroundingOptions extends ScanOptions {
     /** Max directory depth before flagging as "too deep" */

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-import { ToolProvider, Issue, IssueType, ScanOptions, ToolScoringOutput } from '@aiready/core';
+import * as _aiready_core from '@aiready/core';
+import { Issue, IssueType, ScanOptions, ToolScoringOutput } from '@aiready/core';
 
 /**
  * Agent Grounding Tool Provider
  */
-declare const AgentGroundingProvider: ToolProvider;
+declare const AgentGroundingProvider: _aiready_core.ToolProvider;
 
 interface AgentGroundingOptions extends ScanOptions {
     /** Max directory depth before flagging as "too deep" */

package/dist/index.js

@@ -324,41 +324,38 @@ function calculateGroundingScore(report) {
 }
 
 // src/provider.ts
-var AgentGroundingProvider = {
+var AgentGroundingProvider = (0, import_core3.createProvider)({
   id: import_core3.ToolName.AgentGrounding,
   alias: ["agent-grounding", "grounding", "navigation"],
-  async analyze(options) {
-    const report = await analyzeAgentGrounding(
-      options
-    );
-    const results = report.issues.map((i) => ({
-      fileName: i.location.file,
-      issues: [i],
+  version: "0.9.5",
+  defaultWeight: 10,
+  async analyzeReport(options) {
+    return analyzeAgentGrounding(options);
+  },
+  getResults(report) {
+    return report.issues.map((issue) => ({
+      fileName: issue.location.file,
+      issues: [issue],
       metrics: {
         agentGroundingScore: report.summary.score
       }
     }));
-    return import_core3.SpokeOutputSchema.parse({
-      results,
-      summary: report.summary,
-      metadata: {
-        toolName: import_core3.ToolName.AgentGrounding,
-        version: "0.9.5",
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        rawData: report.rawData
-      }
-    });
   },
-  score(output, options) {
+  getSummary(report) {
+    return report.summary;
+  },
+  getMetadata(report) {
+    return { rawData: report.rawData };
+  },
+  score(output) {
     const report = {
       summary: output.summary,
       rawData: output.metadata.rawData,
       recommendations: output.summary.recommendations || []
     };
     return calculateGroundingScore(report);
-  },
-  defaultWeight: 10
-};
+  }
+});
 
 // src/index.ts
 import_core4.ToolRegistry.register(AgentGroundingProvider);

package/dist/index.mjs

@@ -8,44 +8,41 @@ import { ToolRegistry } from "@aiready/core";
 
 // src/provider.ts
 import {
-  ToolName,
-  SpokeOutputSchema
+  createProvider,
+  ToolName
 } from "@aiready/core";
-var AgentGroundingProvider = {
+var AgentGroundingProvider = createProvider({
   id: ToolName.AgentGrounding,
   alias: ["agent-grounding", "grounding", "navigation"],
-  async analyze(options) {
-    const report = await analyzeAgentGrounding(
-      options
-    );
-    const results = report.issues.map((i) => ({
-      fileName: i.location.file,
-      issues: [i],
+  version: "0.9.5",
+  defaultWeight: 10,
+  async analyzeReport(options) {
+    return analyzeAgentGrounding(options);
+  },
+  getResults(report) {
+    return report.issues.map((issue) => ({
+      fileName: issue.location.file,
+      issues: [issue],
       metrics: {
         agentGroundingScore: report.summary.score
       }
     }));
-    return SpokeOutputSchema.parse({
-      results,
-      summary: report.summary,
-      metadata: {
-        toolName: ToolName.AgentGrounding,
-        version: "0.9.5",
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        rawData: report.rawData
-      }
-    });
   },
-  score(output, options) {
+  getSummary(report) {
+    return report.summary;
+  },
+  getMetadata(report) {
+    return { rawData: report.rawData };
+  },
+  score(output) {
     const report = {
       summary: output.summary,
       rawData: output.metadata.rawData,
       recommendations: output.summary.recommendations || []
     };
     return calculateGroundingScore(report);
-  },
-  defaultWeight: 10
-};
+  }
+});
 
 // src/index.ts
 ToolRegistry.register(AgentGroundingProvider);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/agent-grounding",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "description": "Measures how well an AI agent can navigate a codebase autonomously without human assistance",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -40,7 +40,7 @@
     "chalk": "^5.3.0",
     "commander": "^14.0.0",
     "glob": "^13.0.0",
-    "@aiready/core": "0.23.0"
+    "@aiready/core": "0.23.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/__tests__/provider.test.ts

@@ -18,7 +18,7 @@ describe('Agent Grounding Provider', () => {
     const output = await AgentGroundingProvider.analyze({ rootDir: '.' });
 
     expect(output.summary.score).toBe(90);
-    expect(output.metadata.toolName).toBe('agent-grounding');
+    expect(output.metadata!.toolName).toBe('agent-grounding');
   });
 
   it('should score an output', () => {

package/src/__tests__/scoring.test.ts

@@ -5,9 +5,12 @@ import { ToolName } from '@aiready/core';
 
 describe('Agent Grounding Scoring', () => {
   const mockReport: AgentGroundingReport = {
+    issues: [],
     summary: {
       score: 65,
       rating: 'moderate',
+      filesAnalyzed: 0,
+      directoriesAnalyzed: 0,
       dimensions: {
         structureClarityScore: 60,
         selfDocumentationScore: 70,
@@ -16,7 +19,6 @@ describe('Agent Grounding Scoring', () => {
         domainConsistencyScore: 65,
       },
     },
-    results: [],
     rawData: {
       totalFiles: 20,
       totalDirectories: 5,
@@ -27,6 +29,8 @@ describe('Agent Grounding Scoring', () => {
       totalExports: 50,
       untypedExports: 10,
       inconsistentDomainTerms: 5,
+      barrelExports: 0,
+      domainVocabularySize: 0,
     },
     recommendations: ['Fix vague filenames'],
   };
@@ -50,6 +54,7 @@ describe('Agent Grounding Scoring', () => {
   it('should set high priority for low scores', () => {
     const lowScoreReport: AgentGroundingReport = {
       ...mockReport,
+      issues: [],
       summary: {
         ...mockReport.summary,
         score: 40,

package/src/provider.ts

@@ -1,11 +1,8 @@
 import {
-  ToolProvider,
+  AnalysisResult,
+  createProvider,
   ToolName,
-  SpokeOutput,
   ScanOptions,
-  ToolScoringOutput,
-  AnalysisResult,
-  SpokeOutputSchema,
 } from '@aiready/core';
 import { analyzeAgentGrounding } from './analyzer';
 import { calculateGroundingScore } from './scoring';
@@ -14,44 +11,35 @@ import { AgentGroundingOptions, AgentGroundingReport } from './types';
 /**
  * Agent Grounding Tool Provider
  */
-export const AgentGroundingProvider: ToolProvider = {
+export const AgentGroundingProvider = createProvider({
   id: ToolName.AgentGrounding,
   alias: ['agent-grounding', 'grounding', 'navigation'],
-
-  async analyze(options: ScanOptions): Promise<SpokeOutput> {
-    const report = await analyzeAgentGrounding(
-      options as AgentGroundingOptions
-    );
-
-    const results: AnalysisResult[] = report.issues.map((i) => ({
-      fileName: i.location.file,
-      issues: [i] as any[],
+  version: '0.9.5',
+  defaultWeight: 10,
+  async analyzeReport(options: ScanOptions) {
+    return analyzeAgentGrounding(options as AgentGroundingOptions);
+  },
+  getResults(report): AnalysisResult[] {
+    return report.issues.map((issue) => ({
+      fileName: issue.location.file,
+      issues: [issue] as any[],
       metrics: {
         agentGroundingScore: report.summary.score,
       },
     }));
-
-    return SpokeOutputSchema.parse({
-      results,
-      summary: report.summary,
-      metadata: {
-        toolName: ToolName.AgentGrounding,
-        version: '0.9.5',
-        timestamp: new Date().toISOString(),
-        rawData: report.rawData,
-      },
-    });
   },
-
-  score(output: SpokeOutput, options: ScanOptions): ToolScoringOutput {
+  getSummary(report) {
+    return report.summary;
+  },
+  getMetadata(report) {
+    return { rawData: report.rawData };
+  },
+  score(output) {
     const report = {
       summary: output.summary,
       rawData: (output.metadata as any).rawData,
       recommendations: (output.summary as any).recommendations || [],
     } as unknown as AgentGroundingReport;
-
     return calculateGroundingScore(report);
   },
-
-  defaultWeight: 10,
-};
+});