@myagentroam/node 0.9.98 → 0.9.100

package/dist/service/code-navigation/ecmascript-path-specifier-resolver.js

@@ -1,4 +1,5 @@
 import { posix } from 'node:path';
+import { trailingPathCandidateScore } from './path-specifier-resolver.js';
 const importExtensionMappings = [
     { importExtension: '.js', sourceExtensions: ['.ts', '.tsx'] },
     { importExtension: '.jsx', sourceExtensions: ['.tsx'] },
@@ -8,11 +9,12 @@ const importExtensionMappings = [
 const extensionlessSourceExtensions = ['.ts', '.tsx', '.js', '.jsx'];
 function accepts(value) {
     return (/^(?:\.\.?\/)[A-Za-z0-9_./$-]+$/u.test(value) ||
+        /^@\/[A-Za-z0-9_./$-]+$/u.test(value) ||
         /^(?:@?[A-Za-z0-9_$-]+)(?:\/[A-Za-z0-9_.$-]+)+$/u.test(value));
 }
 function matches(path, currentPath, specifier) {
     if (!specifier.startsWith('.'))
-        return sourceFileStem(path) === sourceFileStem(specifier);
+        return unresolvedSpecifierScore(path, specifier) !== undefined;
     const resolved = resolveRelative(currentPath, specifier);
     return (resolved !== undefined &&
         candidates(resolved).some((candidate) => path === candidate ||
@@ -23,7 +25,7 @@ function matches(path, currentPath, specifier) {
 }
 function score(path, currentPath, specifier) {
     if (!specifier.startsWith('.'))
-        return path.length;
+        return unresolvedSpecifierScore(path, specifier) ?? Number.MAX_SAFE_INTEGER;
     const resolved = resolveRelative(currentPath, specifier);
     if (resolved === undefined)
         return Number.MAX_SAFE_INTEGER;
@@ -72,6 +74,19 @@ function sourceFileStem(path) {
     const name = path.slice(path.lastIndexOf('/') + 1);
     return name.replace(/(?:\.d)?\.[^.]+$/u, '');
 }
+function unresolvedSpecifierScore(path, specifier) {
+    const normalizedSpecifier = specifier.startsWith('@/') ? specifier.slice(2) : specifier;
+    return trailingPathCandidateScore(path, unresolvedCandidates(normalizedSpecifier));
+}
+function unresolvedCandidates(specifier) {
+    return candidates(specifier).flatMap((candidate) => [
+        candidate,
+        `${candidate}/index.ts`,
+        `${candidate}/index.tsx`,
+        `${candidate}/index.js`,
+        `${candidate}/index.jsx`
+    ]);
+}
 export const ecmascriptPathSpecifierResolver = {
     id: 'ecmascript.path-specifier',
     accepts,

package/dist/service/code-navigation/path-specifier-resolver.js

@@ -4,3 +4,23 @@ export function matchesPathSuffix(path, suffix) {
 export function shortestPathScore(path) {
     return path.length;
 }
+export function trailingPathCandidateScore(path, candidates) {
+    let best;
+    for (const [candidateIndex, candidate] of candidates.entries()) {
+        const pathSegments = path.split('/');
+        const candidateSegments = candidate.split('/');
+        let matchedSegments = 0;
+        while (matchedSegments < pathSegments.length &&
+            matchedSegments < candidateSegments.length &&
+            pathSegments[pathSegments.length - matchedSegments - 1] ===
+                candidateSegments[candidateSegments.length - matchedSegments - 1])
+            matchedSegments += 1;
+        if (matchedSegments === 0)
+            continue;
+        const unmatchedSegments = candidateSegments.length - matchedSegments;
+        const leadingPathSegments = pathSegments.length - matchedSegments;
+        const candidateScore = unmatchedSegments * 10_000 + candidateIndex * 100 + leadingPathSegments;
+        best = best === undefined ? candidateScore : Math.min(best, candidateScore);
+    }
+    return best;
+}

package/dist/service/code-navigation/stylesheet-path-specifier-resolver.js

@@ -1,15 +1,21 @@
 import { posix } from 'node:path';
+import { trailingPathCandidateScore } from './path-specifier-resolver.js';
 function accepts(value) {
     return /^(?:\.\.?\/)?[A-Za-z0-9_./$+@ -]+$/u.test(value);
 }
 function createResolver(languageId, extensions, partials = false) {
     const candidates = (currentPath, specifier) => pathCandidates(currentPath, specifier, extensions, partials);
+    const aliasCandidates = (specifier) => pathCandidates('', specifier.slice(2), extensions, partials);
     return {
         id: `${languageId}.path-specifier`,
         accepts,
-        directCandidates: candidates,
-        matches: (path, currentPath, specifier) => candidates(currentPath, specifier).includes(path),
+        directCandidates: (currentPath, specifier) => specifier.startsWith('@/') ? [] : candidates(currentPath, specifier),
+        matches: (path, currentPath, specifier) => specifier.startsWith('@/')
+            ? trailingPathCandidateScore(path, aliasCandidates(specifier)) !== undefined
+            : candidates(currentPath, specifier).includes(path),
         score: (path, currentPath, specifier) => {
+            if (specifier.startsWith('@/'))
+                return (trailingPathCandidateScore(path, aliasCandidates(specifier)) ?? Number.MAX_SAFE_INTEGER);
             const index = candidates(currentPath, specifier).indexOf(path);
             return index >= 0 ? index : Number.MAX_SAFE_INTEGER;
         }

package/dist/service/workspace-code-navigation-service.js

@@ -3,6 +3,7 @@ import { constants } from 'node:fs';
 import { access, open, realpath, rename, rm, stat, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { relative, resolve, sep } from 'node:path';
+import { isNavigationSymbol } from '@myagentroam/code-navigation';
 import { supportsSymbolNavigationPath } from '@myagentroam/code-navigation/symbol-navigation';
 import { workspaceFileReferenceSchema } from '@myagentroam/protocol';
 import { bundledCtagsPath, BUNDLED_CTAGS_VERSION, repairBundledCtagsExecutable } from '../ctags-binary.js';
@@ -87,6 +88,7 @@ export class WorkspaceCodeNavigationService {
     async definition(workspace, input) {
         const path = input.path;
         const symbol = input.symbol;
+        const includeReferences = input.includeReferences;
         const reference = input.reference === undefined
             ? undefined
             : workspaceFileReferenceSchema.safeParse(input.reference);
@@ -95,7 +97,8 @@ export class WorkspaceCodeNavigationService {
             path.length > 4096 ||
             (typeof symbol === 'string' && reference !== undefined) ||
             (typeof symbol !== 'string' && reference === undefined) ||
-            (typeof symbol === 'string' && !isSymbol(symbol)) ||
+            (typeof symbol === 'string' && !isNavigationSymbol(path, symbol)) ||
+            (includeReferences !== undefined && typeof includeReferences !== 'boolean') ||
             (reference !== undefined && !reference.success))
             throw new Error('SYMBOL_DEFINITION_INVALID');
         if (reference !== undefined) {
@@ -171,7 +174,9 @@ export class WorkspaceCodeNavigationService {
                 });
             }
         }
-        const references = await this.findReferences(workspace, requestedSymbol, targets);
+        const references = includeReferences === false
+            ? { matches: [], truncated: false }
+            : await this.findReferences(workspace, requestedSymbol, targets);
         return {
             state: fresh ? 'READY' : 'STALE',
             targets: targets.slice(0, MAX_RESULTS),
@@ -595,9 +600,6 @@ function emptyDefinitionResult(input) {
 function isCtagsSourcePath(path) {
     return supportsSymbolNavigationPath(path);
 }
-function isSymbol(value) {
-    return value.length > 0 && value.length <= 512 && /^[\p{L}_$][\p{L}\p{N}_$]*$/u.test(value);
-}
 function buildFailure(error) {
     return error instanceof Error && error.message === 'SYMBOL_INDEX_LIMIT_EXCEEDED'
         ? 'SYMBOL_INDEX_LIMIT_EXCEEDED'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.9.98",
+  "version": "0.9.100",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -30,9 +30,9 @@
     "npm": "11.12.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/agent": "0.9.98",
-    "@myagentroam/protocol": "0.9.98",
-    "@myagentroam/code-navigation": "0.9.98"
+    "@myagentroam/agent": "0.9.100",
+    "@myagentroam/code-navigation": "0.9.100",
+    "@myagentroam/protocol": "0.9.100"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"