@agentuity/cli 1.0.38 → 1.0.40

package/dist/cmd/build/app-router-detector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * App Router Detector
+ *
+ * Parses the user's `src/app.ts` to detect whether they pass a `router` property
+ * to `createApp()`. If detected, resolves the router variable(s) to their import
+ * sources and mount paths.
+ *
+ * This allows the build tooling to derive route metadata from the actual code-based
+ * route tree instead of relying on filesystem-based discovery.
+ */
+import type { Logger } from '../../types';
+/**
+ * A resolved mount point from `createApp({ router })`.
+ */
+export interface DetectedRouteMount {
+    /** Mount path (e.g., '/api', '/api/v1') */
+    path: string;
+    /** Absolute file path of the router module */
+    routerFile: string;
+}
+/**
+ * Result of detecting explicit router usage in app.ts.
+ */
+export interface AppRouterDetection {
+    /** Whether `createApp({ router })` was found */
+    detected: boolean;
+    /** Resolved mount points with their router files */
+    mounts: DetectedRouteMount[];
+}
+/**
+ * Detect whether `src/app.ts` uses `createApp({ router })`.
+ *
+ * Parses the file with acorn-loose, finds `createApp()` calls,
+ * and resolves router variables to their import source files.
+ *
+ * Returns `{ detected: false, mounts: [] }` when:
+ * - `src/app.ts` doesn't exist
+ * - `createApp()` is called without a `router` property
+ * - Router variables can't be resolved to files
+ */
+export declare function detectExplicitRouter(rootDir: string, logger: Logger): Promise<AppRouterDetection>;
+//# sourceMappingURL=app-router-detector.d.ts.map

package/dist/cmd/build/app-router-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-router-detector.d.ts","sourceRoot":"","sources":["../../../src/cmd/build/app-router-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAU1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAgHD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC,CAgB7B"}

package/dist/cmd/build/app-router-detector.js

@@ -0,0 +1,253 @@
+/**
+ * App Router Detector
+ *
+ * Parses the user's `src/app.ts` to detect whether they pass a `router` property
+ * to `createApp()`. If detected, resolves the router variable(s) to their import
+ * sources and mount paths.
+ *
+ * This allows the build tooling to derive route metadata from the actual code-based
+ * route tree instead of relying on filesystem-based discovery.
+ */
+import * as acornLoose from 'acorn-loose';
+import { join, dirname, resolve } from 'node:path';
+import { existsSync, statSync } from 'node:fs';
+/**
+ * Resolve an import path to an actual file on disk.
+ * Tries the path as-is, then with common extensions.
+ */
+function resolveImportFile(fromDir, importPath) {
+    if (!importPath.startsWith('.') && !importPath.startsWith('/')) {
+        return null; // Package import — can't resolve
+    }
+    const basePath = resolve(fromDir, importPath);
+    const extensions = ['.ts', '.tsx', '/index.ts', '/index.tsx'];
+    if (existsSync(basePath)) {
+        try {
+            if (statSync(basePath).isFile())
+                return basePath;
+        }
+        catch {
+            // ignore
+        }
+    }
+    for (const ext of extensions) {
+        const candidate = basePath + ext;
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Extract the `router` property value from a `createApp()` call's argument object.
+ *
+ * Handles three forms:
+ * - `createApp({ router: myVar })` → plain Hono, default /api mount
+ * - `createApp({ router: { path: '/v1', router: myVar } })` → single RouteMount
+ * - `createApp({ router: [{ path: '/v1', router: v1 }, ...] })` → array of RouteMounts
+ */
+function extractRouterFromCreateApp(callNode) {
+    // createApp() must have at least one argument (the config object)
+    if (!callNode.arguments || callNode.arguments.length === 0) {
+        return null;
+    }
+    const configArg = callNode.arguments[0];
+    if (configArg.type !== 'ObjectExpression') {
+        return null;
+    }
+    // Find the `router` property
+    const routerProp = configArg.properties?.find((p) => p.type === 'Property' && p.key?.type === 'Identifier' && p.key?.name === 'router');
+    if (!routerProp) {
+        return null; // No router property — file-based routing
+    }
+    const routerValue = routerProp.value;
+    // Form 1: Plain Hono variable → createApp({ router: myRouter })
+    if (routerValue.type === 'Identifier') {
+        return [{ path: '/api', varName: routerValue.name }];
+    }
+    // Form 2: Single RouteMount → createApp({ router: { path: '/v1', router: myRouter } })
+    if (routerValue.type === 'ObjectExpression') {
+        const mount = extractRouteMountFromObject(routerValue);
+        return mount ? [mount] : null;
+    }
+    // Form 3: Array of RouteMounts → createApp({ router: [{ path: '/v1', router: v1 }, ...] })
+    if (routerValue.type === 'ArrayExpression') {
+        const mounts = [];
+        for (const element of routerValue.elements || []) {
+            if (element?.type === 'ObjectExpression') {
+                const mount = extractRouteMountFromObject(element);
+                if (mount)
+                    mounts.push(mount);
+            }
+        }
+        return mounts.length > 0 ? mounts : null;
+    }
+    return null;
+}
+/**
+ * Extract { path, router } from an object literal AST node.
+ */
+function extractRouteMountFromObject(objNode) {
+    let path;
+    let varName;
+    for (const prop of objNode.properties || []) {
+        if (prop.type !== 'Property' || prop.key?.type !== 'Identifier')
+            continue;
+        if (prop.key.name === 'path' && prop.value?.type === 'Literal') {
+            path = String(prop.value.value);
+        }
+        if (prop.key.name === 'router' && prop.value?.type === 'Identifier') {
+            varName = prop.value.name;
+        }
+    }
+    return path && varName ? { path, varName } : null;
+}
+/**
+ * Detect whether `src/app.ts` uses `createApp({ router })`.
+ *
+ * Parses the file with acorn-loose, finds `createApp()` calls,
+ * and resolves router variables to their import source files.
+ *
+ * Returns `{ detected: false, mounts: [] }` when:
+ * - `src/app.ts` doesn't exist
+ * - `createApp()` is called without a `router` property
+ * - Router variables can't be resolved to files
+ */
+export async function detectExplicitRouter(rootDir, logger) {
+    const noDetection = { detected: false, mounts: [] };
+    // Look for app.ts in src/ (standard location)
+    const appFile = join(rootDir, 'src', 'app.ts');
+    if (!existsSync(appFile)) {
+        // Also try root-level app.ts
+        const rootAppFile = join(rootDir, 'app.ts');
+        if (!existsSync(rootAppFile)) {
+            logger.trace('[router-detect] No app.ts found');
+            return noDetection;
+        }
+        return detectInFile(rootAppFile, logger);
+    }
+    return detectInFile(appFile, logger);
+}
+async function detectInFile(appFile, logger) {
+    const noDetection = { detected: false, mounts: [] };
+    const appDir = dirname(appFile);
+    try {
+        const source = await Bun.file(appFile).text();
+        const transpiler = new Bun.Transpiler({ loader: 'ts', target: 'bun' });
+        const contents = transpiler.transformSync(source);
+        // Quick check: skip AST parsing if createApp is not called with router
+        if (!contents.includes('createApp') || !contents.includes('router')) {
+            logger.trace('[router-detect] No createApp + router pattern found in %s', appFile);
+            return noDetection;
+        }
+        const ast = acornLoose.parse(contents, {
+            locations: true,
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+        });
+        // Build import map: variable name → import path
+        const importMap = new Map();
+        for (const node of ast.body || []) {
+            if (node.type === 'ImportDeclaration' && node.source?.value) {
+                for (const spec of node.specifiers || []) {
+                    if (spec.local?.name) {
+                        importMap.set(spec.local.name, String(node.source.value));
+                    }
+                }
+            }
+        }
+        // Walk all statements looking for createApp() calls
+        const routerMounts = findCreateAppRouterCalls(ast, importMap);
+        if (!routerMounts || routerMounts.length === 0) {
+            logger.trace('[router-detect] createApp() found but no router property');
+            return noDetection;
+        }
+        // Resolve each router variable to its file
+        const mounts = [];
+        for (const { path, varName } of routerMounts) {
+            const importPath = importMap.get(varName);
+            if (!importPath) {
+                logger.debug('[router-detect] Router variable %s is not imported — may be defined locally', varName);
+                // Could be defined in the same file — skip for now
+                continue;
+            }
+            const resolvedFile = resolveImportFile(appDir, importPath);
+            if (!resolvedFile) {
+                logger.warn('[router-detect] Could not resolve import %s for router variable %s', importPath, varName);
+                continue;
+            }
+            logger.trace('[router-detect] Found router mount: %s → %s (%s)', path, varName, resolvedFile);
+            mounts.push({ path, routerFile: resolvedFile });
+        }
+        if (mounts.length === 0) {
+            logger.debug('[router-detect] Router variables found but none could be resolved to files');
+            return noDetection;
+        }
+        logger.debug('[router-detect] Detected %d explicit router mount(s) in %s', mounts.length, appFile);
+        return { detected: true, mounts };
+    }
+    catch (error) {
+        logger.warn('[router-detect] Failed to parse %s: %s', appFile, error instanceof Error ? error.message : String(error));
+        return noDetection;
+    }
+}
+/**
+ * Walk the AST looking for `createApp({ router: ... })` calls.
+ * Handles:
+ * - `createApp({ router })` (top-level expression)
+ * - `const app = await createApp({ router })` (variable declaration)
+ * - `export const app = await createApp({ router })` (exported)
+ */
+function findCreateAppRouterCalls(ast, importMap) {
+    for (const node of ast.body || []) {
+        // Check expression statements: createApp({ router })
+        if (node.type === 'ExpressionStatement') {
+            const result = checkForCreateAppCall(node.expression, importMap);
+            if (result)
+                return result;
+        }
+        // Check variable declarations: const app = await createApp({ router })
+        if (node.type === 'VariableDeclaration') {
+            for (const decl of node.declarations || []) {
+                if (decl.init) {
+                    const result = checkForCreateAppCall(decl.init, importMap);
+                    if (result)
+                        return result;
+                }
+            }
+        }
+        // Check exports: export const app = await createApp({ router })
+        if (node.type === 'ExportNamedDeclaration' && node.declaration) {
+            if (node.declaration.type === 'VariableDeclaration') {
+                for (const decl of node.declaration.declarations || []) {
+                    if (decl.init) {
+                        const result = checkForCreateAppCall(decl.init, importMap);
+                        if (result)
+                            return result;
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Check if an expression node is a `createApp({ router })` call.
+ * Unwraps `await` expressions.
+ */
+function checkForCreateAppCall(expr, importMap) {
+    if (!expr)
+        return null;
+    // Unwrap AwaitExpression: await createApp(...)
+    if (expr.type === 'AwaitExpression' && expr.argument) {
+        return checkForCreateAppCall(expr.argument, importMap);
+    }
+    // Check for createApp({ router })
+    if (expr.type === 'CallExpression' &&
+        expr.callee?.type === 'Identifier' &&
+        expr.callee?.name === 'createApp') {
+        return extractRouterFromCreateApp(expr);
+    }
+    return null;
+}
+//# sourceMappingURL=app-router-detector.js.map

package/dist/cmd/build/app-router-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-router-detector.js","sourceRoot":"","sources":["../../../src/cmd/build/app-router-detector.ts"],"names":[],"mappings":"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"}

package/dist/cmd/build/ast.d.ts

@@ -13,7 +13,17 @@ export declare function parseEvalMetadata(rootDir: string, filename: string, con
     }>
 ]>;
 export declare function parseAgentMetadata(rootDir: string, filename: string, contents: string, projectId: string, deploymentId: string): Promise<[string, Map<string, string>] | undefined>;
-export declare function parseRoute(rootDir: string, filename: string, projectId: string, deploymentId: string, visitedFiles?: Set<string>, mountedSubrouters?: Set<string>): Promise<BuildMetadata['routes']>;
+export interface ParseRouteOptions {
+    visitedFiles?: Set<string>;
+    mountedSubrouters?: Set<string>;
+    /**
+     * Explicit mount prefix for this router file, derived from code-based routing
+     * (e.g., from `createApp({ router })` or `.route()` calls).
+     * When provided, overrides the filesystem-derived mount path.
+     */
+    mountPrefix?: string;
+}
+export declare function parseRoute(rootDir: string, filename: string, projectId: string, deploymentId: string, visitedFilesOrOptions?: Set<string> | ParseRouteOptions, mountedSubrouters?: Set<string>): Promise<BuildMetadata['routes']>;
 /**
  * Result of workbench analysis
  */

package/dist/cmd/build/ast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/cmd/build/ast.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAqIxE,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpF;AAoTD,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC9C,OAAO,CACT;IACC,MAAM;IACN,KAAK,CAAC;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACF,CACD,CAyNA;AAID,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAqPpD;AAokBD,wBAAsB,UAAU,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAC1B,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAwxBlC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAoCjF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CA+BvF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgOlE;AA+DD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CA8LlB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAsLnE;AA+BD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0EhE"}
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/cmd/build/ast.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAqIxE,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpF;AAoTD,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC9C,OAAO,CACT;IACC,MAAM;IACN,KAAK,CAAC;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACF,CACD,CAyNA;AAID,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAqPpD;AA4pBD,MAAM,WAAW,iBAAiB;IACjC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,UAAU,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,iBAAiB,EACvD,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAo+BlC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAoCjF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CA+BvF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgOlE;AA+DD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CA8LlB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAsLnE;AA+BD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0EhE"}