Readability: sync/async cleanup, DRY, type safety, config fixes (#55)

* fix: DRY for discover skills, auto organize imports, remove async for sync functions

* chore: looser ESLint, allow T[] for simple use, import order warns and no error, and make the config type safe

* chore: remove outDir (dist is the default), noEmit true we use tsdown for compilation (therefore no need for declaration)

* chore: ESLint config looser, both array styles are accepted

* chore: auto imports and DRY in tests

* fix: cmdList is not async anymore

* chore: async fix, type narrowing, dynamic import for existing function

* chore: format and lint

* docs: changeset for this patch

* Revert eslint scope creep and fix review consistency gaps

- Revert unrelated eslint.config.js changes (array-type, import/order)
- Remove remaining async/await from 9 scanner tests
- Use mockFetchNotOk() and requireFirstSkill() in staleness test
- Remove redundant non-null assertions in skills test
- Remove unnecessary await in scanIntentsOrFail

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Update changeset to cover all PR changes

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Kyle Mathews <mathews.kyle@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: 3 people

.changeset/neat-pots-melt.md

@@ -0,0 +1,5 @@
+---
+'@tanstack/intent': patch
+---
+
+Make `scanForIntents` and `scanLibrary` synchronous instead of returning Promises for purely synchronous work. Clean up unnecessary async/await throughout source and tests, extract DRY test helpers, and improve type narrowing.

packages/intent/src/cli.ts

@@ -35,7 +35,7 @@ async function scanIntentsOrFail(): Promise<ScanResult> {
   const { scanForIntents } = await import('./scanner.js')
 
   try {
-    return await scanForIntents()
+    return scanForIntents()
   } catch (err) {
     fail((err as Error).message)
   }

packages/intent/src/intent-library.ts

@@ -9,10 +9,10 @@ import type { LibraryScanResult } from './library-scanner.js'
 // Commands
 // ---------------------------------------------------------------------------
 
-async function cmdList(): Promise<void> {
+function cmdList(): void {
   let result: LibraryScanResult
   try {
-    result = await scanLibrary(process.argv[1]!)
+    result = scanLibrary(process.argv[1]!)
   } catch (err) {
     console.error((err as Error).message)
     process.exit(1)
@@ -90,7 +90,7 @@ const command = process.argv[2]
 switch (command) {
   case 'list':
   case undefined:
-    await cmdList()
+    cmdList()
     break
   case 'install':
     cmdInstall()

packages/intent/src/library-scanner.ts

@@ -101,10 +101,10 @@ function discoverSkills(skillsDir: string): Array<SkillEntry> {
 // Main scanner
 // ---------------------------------------------------------------------------
 
-export async function scanLibrary(
+export function scanLibrary(
   scriptPath: string,
   _projectRoot?: string,
-): Promise<LibraryScanResult> {
+): LibraryScanResult {
   const packages: Array<LibraryPackage> = []
   const warnings: Array<string> = []
   const visited = new Set<string>()

packages/intent/src/scanner.ts

@@ -318,7 +318,7 @@ function toVersionConflict(
 // Main scanner
 // ---------------------------------------------------------------------------
 
-export async function scanForIntents(root?: string): Promise<ScanResult> {
+export function scanForIntents(root?: string): ScanResult {
   const projectRoot = root ?? process.cwd()
   const packageManager = detectPackageManager(projectRoot)
   const nodeModulesDir = join(projectRoot, 'node_modules')

packages/intent/tests/library-scanner.test.ts

@@ -53,7 +53,7 @@ afterEach(() => {
 // ---------------------------------------------------------------------------
 
 describe('scanLibrary', () => {
-  it('returns the home package with its skills', async () => {
+  it('returns the home package with its skills', () => {
     const pkgDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(pkgDir, 'package.json'), {
       name: '@tanstack/router',
@@ -67,7 +67,7 @@ describe('scanLibrary', () => {
       description: 'File-based route definitions',
     })
 
-    const result = await scanLibrary(scriptPath(pkgDir), root)
+    const result = scanLibrary(scriptPath(pkgDir), root)
 
     expect(result.warnings).toEqual([])
     expect(result.packages).toHaveLength(1)
@@ -81,7 +81,7 @@ describe('scanLibrary', () => {
     )
   })
 
-  it('includes the full path to each SKILL.md', async () => {
+  it('includes the full path to each SKILL.md', () => {
     const pkgDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(pkgDir, 'package.json'), {
       name: '@tanstack/router',
@@ -91,13 +91,13 @@ describe('scanLibrary', () => {
     const skillDir = createDir(pkgDir, 'skills', 'routing')
     writeSkillMd(skillDir, { name: 'routing', description: 'Routing patterns' })
 
-    const result = await scanLibrary(scriptPath(pkgDir), root)
+    const result = scanLibrary(scriptPath(pkgDir), root)
 
     const skill = result.packages[0]!.skills[0]!
     expect(skill.path).toBe(join(pkgDir, 'skills', 'routing', 'SKILL.md'))
   })
 
-  it('recursively discovers deps with tanstack-intent keyword', async () => {
+  it('recursively discovers deps with tanstack-intent keyword', () => {
     // Home package: @tanstack/router, depends on @tanstack/query
     const routerDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(routerDir, 'package.json'), {
@@ -127,7 +127,7 @@ describe('scanLibrary', () => {
       description: 'Query and mutation patterns',
     })
 
-    const result = await scanLibrary(scriptPath(routerDir), root)
+    const result = scanLibrary(scriptPath(routerDir), root)
 
     expect(result.warnings).toEqual([])
     expect(result.packages).toHaveLength(2)
@@ -141,7 +141,7 @@ describe('scanLibrary', () => {
     expect(query.skills[0]!.description).toBe('Query and mutation patterns')
   })
 
-  it('discovers deps via peerDependencies', async () => {
+  it('discovers deps via peerDependencies', () => {
     const pkgDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(pkgDir, 'package.json'), {
       name: '@tanstack/router',
@@ -159,13 +159,13 @@ describe('scanLibrary', () => {
     const querySkill = createDir(queryDir, 'skills', 'fetching')
     writeSkillMd(querySkill, { name: 'fetching', description: 'Fetching' })
 
-    const result = await scanLibrary(scriptPath(pkgDir), root)
+    const result = scanLibrary(scriptPath(pkgDir), root)
 
     const names = result.packages.map((p) => p.name)
     expect(names).toContain('@tanstack/query')
   })
 
-  it('skips deps without tanstack-intent keyword or bin.intent', async () => {
+  it('skips deps without tanstack-intent keyword or bin.intent', () => {
     const pkgDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(pkgDir, 'package.json'), {
       name: '@tanstack/router',
@@ -183,13 +183,13 @@ describe('scanLibrary', () => {
     const reactSkill = createDir(reactDir, 'skills', 'hooks')
     writeSkillMd(reactSkill, { name: 'hooks', description: 'React hooks' })
 
-    const result = await scanLibrary(scriptPath(pkgDir), root)
+    const result = scanLibrary(scriptPath(pkgDir), root)
 
     const names = result.packages.map((p) => p.name)
     expect(names).not.toContain('react')
   })
 
-  it('follows deps with legacy bin.intent (backwards compat)', async () => {
+  it('follows deps with legacy bin.intent (backwards compat)', () => {
     const pkgDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(pkgDir, 'package.json'), {
       name: '@tanstack/router',
@@ -210,13 +210,13 @@ describe('scanLibrary', () => {
     const querySkill = createDir(queryDir, 'skills', 'fetching')
     writeSkillMd(querySkill, { name: 'fetching', description: 'Fetching' })
 
-    const result = await scanLibrary(scriptPath(pkgDir), root)
+    const result = scanLibrary(scriptPath(pkgDir), root)
 
     const names = result.packages.map((p) => p.name)
     expect(names).toContain('@tanstack/query')
   })
 
-  it('skips deps with other keywords but not tanstack-intent', async () => {
+  it('skips deps with other keywords but not tanstack-intent', () => {
     const pkgDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(pkgDir, 'package.json'), {
       name: '@tanstack/router',
@@ -234,13 +234,13 @@ describe('scanLibrary', () => {
     const libSkill = createDir(libDir, 'skills', 'core')
     writeSkillMd(libSkill, { name: 'core', description: 'Core patterns' })
 
-    const result = await scanLibrary(scriptPath(pkgDir), root)
+    const result = scanLibrary(scriptPath(pkgDir), root)
 
     const names = result.packages.map((p) => p.name)
     expect(names).not.toContain('some-lib')
   })
 
-  it('handles packages with no skills/ directory', async () => {
+  it('handles packages with no skills/ directory', () => {
     const pkgDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(pkgDir, 'package.json'), {
       name: '@tanstack/router',
@@ -249,13 +249,13 @@ describe('scanLibrary', () => {
     })
     // No skills/ directory
 
-    const result = await scanLibrary(scriptPath(pkgDir), root)
+    const result = scanLibrary(scriptPath(pkgDir), root)
 
     expect(result.packages).toHaveLength(1)
     expect(result.packages[0]!.skills).toEqual([])
   })
 
-  it('does not visit the same package twice (cycle detection)', async () => {
+  it('does not visit the same package twice (cycle detection)', () => {
     // router -> query -> router (circular)
     const routerDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(routerDir, 'package.json'), {
@@ -273,15 +273,15 @@ describe('scanLibrary', () => {
       dependencies: { '@tanstack/router': '^1.0.0' }, // circular back
     })
 
-    const result = await scanLibrary(scriptPath(routerDir), root)
+    const result = scanLibrary(scriptPath(routerDir), root)
 
     // Each package appears exactly once
     const names = result.packages.map((p) => p.name)
     expect(names).toHaveLength(2)
     expect(new Set(names).size).toBe(2)
   })
 
-  it('discovers sub-skills within a package', async () => {
+  it('discovers sub-skills within a package', () => {
     const pkgDir = createDir(root, 'node_modules', '@tanstack', 'router')
     writeJson(join(pkgDir, 'package.json'), {
       name: '@tanstack/router',
@@ -299,7 +299,7 @@ describe('scanLibrary', () => {
       description: 'Nested route patterns',
     })
 
-    const result = await scanLibrary(scriptPath(pkgDir), root)
+    const result = scanLibrary(scriptPath(pkgDir), root)
 
     const skills = result.packages[0]!.skills
     expect(skills).toHaveLength(2)
@@ -308,10 +308,10 @@ describe('scanLibrary', () => {
     expect(names).toContain('routing/nested-routes')
   })
 
-  it('returns a warning when home package.json cannot be found', async () => {
+  it('returns a warning when home package.json cannot be found', () => {
     const fakeScript = join(root, 'nowhere', 'bin', 'intent.js')
 
-    const result = await scanLibrary(fakeScript, root)
+    const result = scanLibrary(fakeScript, root)
 
     expect(result.packages).toEqual([])
     expect(result.warnings).toHaveLength(1)