Field Access Report: show access paths for all reachable types, including direct root field return types (#109)

* Field Access Report: show access paths for all reachable types, including direct root field return types

- Fix bug: direct return types (e.g. Query.employee: Employee) now show access paths
- Unified color coding for access paths (red/yellow/green/gray)
- Improved UI grouping and badge logic for both root and custom types
- Updated docs to reflect new logic and bug fix

Tested: All types now display correct access paths and color coding. Lint and type checks pass.

* fixed unused exports

Author: carloseberhardt

docs/architecture.md

@@ -79,6 +79,9 @@ The StepZen VS Code extension follows a layered architecture with clear separati
 - **SDL Linking**: Traverse `@sdl(files: [...])` directives safely
 - **AST Processing**: Parse and analyze GraphQL documents
 
+> **Note:**
+> The logic for traversing the schema graph to determine all access paths to a type (used in the Field Access Report) is currently implemented as a utility in the report service. In the future, this may be refactored into the SchemaIndexer or a dedicated schema traversal service for broader reuse and testability. (TODO)
+
 #### 4. VS Code API Layer
 
 - **Integration Points**: Commands, CodeLens, WebViews, Diagnostics

docs/field-policies-feature.md

@@ -0,0 +1,68 @@
+/**
+ * Copyright IBM Corp. 2025
+ * Assisted by CursorAI
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Import the compiled services
+const { SchemaIndexService } = require('./out/services/SchemaIndexService');
+const { FieldPolicyParser } = require('./out/services/fieldPolicyParser');
+const { generateFieldAccessReportData } = require('./out/services/fieldAccessReport');
+
+async function generateReports() {
+  const fixturesDir = path.join(__dirname, 'src/test/fixtures/field-policies');
+  const schemaDir = path.join(__dirname, 'src/test/fixtures/schema-sample');
+
+  // Set up schema index
+  const schemaIndex = new SchemaIndexService();
+  const schemaEntry = path.join(schemaDir, 'index.graphql');
+  await schemaIndex.scan(schemaEntry);
+
+  const policyParser = new FieldPolicyParser();
+  
+  // Get all YAML fixture files
+  const fixtureFiles = fs.readdirSync(fixturesDir)
+    .filter(file => file.endsWith('.yaml'))
+    .map(file => file.replace('.yaml', ''));
+
+  console.log('\n=== FIELD ACCESS REPORT GENERATION ===\n');
+
+  for (const fixtureName of fixtureFiles) {
+    const configPath = path.join(fixturesDir, `${fixtureName}.yaml`);
+    const configContent = fs.readFileSync(configPath, 'utf8');
+
+    console.log(`\n--- ${fixtureName} ---`);
+    console.log(`Policy Config:`);
+    console.log(configContent);
+    
+    try {
+      const report = await generateFieldAccessReportData(schemaIndex, policyParser, configContent);
+      
+      console.log(`\nGenerated Report:`);
+      console.log(JSON.stringify(report, null, 2));
+      
+      // Check if there's an existing expected report
+      const expectedReportPath = path.join(fixturesDir, `${fixtureName}.report.json`);
+      if (fs.existsSync(expectedReportPath)) {
+        const expectedReport = JSON.parse(fs.readFileSync(expectedReportPath, 'utf8'));
+        console.log(`\nExisting Expected Report:`);
+        console.log(JSON.stringify(expectedReport, null, 2));
+        
+        console.log(`\nMatch: ${JSON.stringify(report) === JSON.stringify(expectedReport) ? 'YES' : 'NO'}`);
+      } else {
+        console.log(`\nNo existing expected report found for ${fixtureName}`);
+      }
+      
+    } catch (error) {
+      console.error(`\nError generating report: ${error}`);
+    }
+    
+    console.log(`\n${'='.repeat(50)}`);
+  }
+
+  console.log('\n=== END OF REPORT GENERATION ===\n');
+}
+
+generateReports().catch(console.error); 

generate-reports.js

@@ -101,6 +101,23 @@
         "category": "StepZen"
       },
       {
+        "command": "stepzen.createFieldPolicy",
+        "title": "Create Field Policy",
+        "category": "StepZen"
+      },
+      {
+        "command": "stepzen.fieldAccessReport",
+        "title": "Generate Field Access Report",
+        "category": "StepZen"
+      },
+      {
+        "command": "stepzen.openPolicyEditor",
+        "title": "Open Policy Editor",
+        "category": "StepZen"
+      },
+      {
+        "command": "stepzen.createFieldPolicyFromPattern",
+        "title": "Create Field Policy from Pattern",
         "command": "stepzen.lintGraphql",
         "title": "Lint GraphQL Schema",
         "category": "StepZen"
@@ -250,6 +267,8 @@
     }
   },
   "dependencies": {
-    "graphql": "^16.11.0"
+    "@types/js-yaml": "^4.0.9",
+    "graphql": "^16.11.0",
+    "js-yaml": "^4.1.0"
   }
 }