backend-skeleton 1.7.1 → 1.9.0

package/scanners/registry.mjs

@@ -81,7 +81,7 @@ async function loadOneAdapter(file, schema) {
 
 	// Validate only the JSON-shaped fields -- detect/scan/diagnostics/listReadSet are functions,
 	// which JSON Schema has no vocabulary for; checked separately below.
-	const { detect, scan, diagnostics, listReadSet, ...data } = descriptor;
+	const { detect, scan, diagnostics, listReadSet, introspectRoutes, ...data } = descriptor;
 	const validateFn = ajv().getSchema(schema.$id) ?? ajv().compile(schema);
 	if (!validateFn(data)) {
 		const details = (validateFn.errors ?? []).map((e) => `${e.instancePath || '(root)'} ${e.message}`).join('; ');
@@ -101,6 +101,9 @@ async function loadOneAdapter(file, schema) {
 	if (descriptor.listReadSet !== undefined && typeof descriptor.listReadSet !== 'function') {
 		return { error: { file, message: 'adapter.listReadSet, if present, must be a function' } };
 	}
+	if (descriptor.introspectRoutes !== undefined && typeof descriptor.introspectRoutes !== 'function') {
+		return { error: { file, message: 'adapter.introspectRoutes, if present, must be a function' } };
+	}
 	return { adapter: descriptor };
 }
 

package/scanners/render.mjs

@@ -47,6 +47,9 @@ export function renderScanMarkdown(report) {
 	lines.push(`**Terms**: ${report.terms.join(', ') || '(none)'}`);
 	lines.push(`**Adapter**: ${report.adapter} (confidence: ${report.confidence})`);
 	lines.push(`**API surface source**: ${report.api_surface_source}`);
+	if (report.runtime_introspection) {
+		lines.push(`**Runtime routes**: ${report.runtime_introspection.command.join(' ')} (${report.runtime_introspection.rails_env}, project ${report.runtime_introspection.project_root})`);
+	}
 	lines.push(`**Verdict**: \`${report.verdict}\``);
 	lines.push('');
 

package/scanners/text-util.mjs

@@ -17,9 +17,12 @@ export function lineNumberAt(text, index) {
 import { execFileSync } from 'node:child_process';
 import path from 'node:path';
 
-export function listRgFiles(dir, globs, excludeGlobs = []) {
+export function listRgFiles(dir, globs, excludeGlobs = [], execFn = execFileSync) {
 	try {
-		const out = execFileSync('rg', ['--files', ...globs.flatMap((g) => ['-g', g]), ...excludeGlobs.flatMap((g) => ['-g', g]), dir], { encoding: 'utf8' });
+		// A production Rails monorepo (Discourse) emits >1 MiB of paths for `-g '*.rb'`.
+		// Node's default execFileSync buffer then throws ENOBUFS, which the intentional "no files"
+		// catch below cannot distinguish and used to turn the entire scan into an empty result.
+		const out = execFn('rg', ['--files', ...globs.flatMap((g) => ['-g', g]), ...excludeGlobs.flatMap((g) => ['-g', g]), dir], { encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 });
 		return out.split('\n').filter(Boolean).sort(); // O6: rg --files order isn't guaranteed.
 	} catch {
 		return []; // rg exits 1 on "no files matched" -- not an error, just nothing to report

package/schemas/oracle-manifest.schema.json

@@ -11,7 +11,7 @@
     "adapters": {
       "type": "object",
       "propertyNames": {
-        "enum": ["java-spring", "python-fastapi", "typescript-express", "javascript-express", "generic-grep"]
+        "enum": ["java-spring", "ruby-rails", "python-fastapi", "typescript-express", "javascript-express", "generic-grep"]
       },
       "additionalProperties": {
         "type": "array",

package/schemas/scan-report.schema.json

@@ -18,6 +18,18 @@
       "type": "boolean"
     },
     "path_prefix_signals": { "type": "array" },
+    "runtime_introspection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "command", "project_root", "rails_env", "status"],
+      "properties": {
+        "kind": { "const": "rails-routes" },
+        "command": { "type": "array", "items": { "type": "string" } },
+        "project_root": { "type": "string" },
+        "rails_env": { "type": "string" },
+        "status": { "const": "used" }
+      }
+    },
     "related_modules": {
       "type": "array",
       "items": {