@shanyucoder/flowgrid 0.1.0

package/dist/graph/analyze/api-routes.js

@@ -0,0 +1,370 @@
+/**
+ * API Route Indexer — scan, index, and query OpenAPI / backend-spec YAML files.
+ *
+ * Responsibilities:
+ * - Glob product repo for `01-backend-spec.yaml` / `02-openapi.yaml` files
+ * - Parse `paths:` (OpenAPI 3.x standard) + `routes:` / `endpoints:` (custom format)
+ * - Upsert into SQLite `api_route` table via IndexStore
+ * - Expose query (index-first, on-demand fallback) + duplicate detector
+ *
+ * Strategy (hybrid):
+ *   1. If SQLite index is fresh (< 24h) → use index
+ *   2. If index is empty / stale → on-demand glob scan → also write back to index
+ *
+ * SSOT: product repo YAML files. MCP indexes only — never owns specs.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { inferSurfaceFromRepoPath } from './surface-paths.js';
+// ---------------------------------------------------------------------------
+// Glob helpers (no external glob library — use recursive readdir)
+// ---------------------------------------------------------------------------
+const API_SPEC_FILENAMES = new Set(['01-backend-spec.yaml', '02-openapi.yaml', 'openapi.yaml']);
+const INDEX_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 24 hours
+function walkForSpecs(dir, collected) {
+    if (!existsSync(dir))
+        return;
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.startsWith('.') || entry === 'node_modules')
+            continue;
+        const full = path.join(dir, entry);
+        let st;
+        try {
+            st = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory()) {
+            walkForSpecs(full, collected);
+        }
+        else if (st.isFile() && API_SPEC_FILENAMES.has(entry)) {
+            collected.push(full);
+        }
+    }
+}
+function resolveSpecGlobs(repoRoot, cfg) {
+    const collected = [];
+    // Use explicit apiSpecRoots if configured
+    if (cfg.apiSpecRoots?.length) {
+        for (const rel of cfg.apiSpecRoots) {
+            // Treat as prefix directories (strip ** glob suffix) for our simple walker
+            const baseDir = rel.split('*')[0].replace(/\/$/, '');
+            if (baseDir)
+                walkForSpecs(path.join(repoRoot, baseDir), collected);
+        }
+        return [...new Set(collected)];
+    }
+    // Derive from specRoots — walk those dirs and filter by filename
+    if (cfg.specRoots?.length) {
+        for (const rel of cfg.specRoots) {
+            const baseDir = rel.split('*')[0].replace(/\/$/, '');
+            if (baseDir)
+                walkForSpecs(path.join(repoRoot, baseDir), collected);
+        }
+        return [...new Set(collected)];
+    }
+    // Last resort: walk common product surfaces path
+    walkForSpecs(path.join(repoRoot, 'surfaces'), collected);
+    return [...new Set(collected)];
+}
+// ---------------------------------------------------------------------------
+// YAML parsers — handle both OpenAPI 3.x and custom backend-spec formats
+// ---------------------------------------------------------------------------
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+/** Infer action from URI path suffix or operation verb. */
+function inferAction(uriPath, method, operationId) {
+    if (operationId) {
+        const lower = operationId.toLowerCase();
+        if (lower.includes('create') || lower.includes('store'))
+            return 'create';
+        if (lower.includes('update') || lower.includes('edit'))
+            return 'update';
+        if (lower.includes('delete') || lower.includes('destroy') || lower.includes('remove'))
+            return 'delete';
+        if (lower.includes('duplicate') || lower.includes('clone') || lower.includes('copy'))
+            return 'duplicate';
+        if (lower.includes('detail') || lower.includes('show') || lower.includes('get'))
+            return 'detail';
+        if (lower.includes('list') || lower.includes('index'))
+            return 'list';
+    }
+    // Derive from URI suffix
+    const segments = uriPath.split('/').filter(Boolean);
+    const last = segments[segments.length - 1] ?? '';
+    if (!last)
+        return method === 'get' ? 'list' : '';
+    if (last === 'create' || last === 'store')
+        return 'create';
+    if (last === 'update' || last === 'edit')
+        return 'update';
+    if (last === 'delete' || last === 'destroy')
+        return 'delete';
+    if (last === 'duplicate' || last === 'clone')
+        return 'duplicate';
+    if (last === 'detail' || last === 'show')
+        return 'detail';
+    if (/^\{.+\}$/.test(last)) {
+        // {id} — infer from method
+        if (method === 'get')
+            return 'detail';
+        if (method === 'put' || method === 'patch')
+            return 'update';
+        if (method === 'delete')
+            return 'delete';
+    }
+    if (method === 'post')
+        return 'create';
+    if (method === 'get')
+        return 'list';
+    return '';
+}
+/** Extract surface/module id from file path heuristics (canonical + legacy). */
+function inferSurface(absPath, repoRoot) {
+    return inferSurfaceFromRepoPath(absPath, repoRoot);
+}
+/**
+ * Parse one spec file → array of ApiRouteEntry.
+ * Handles both OpenAPI `paths:` and custom `routes:` / `endpoints:` formats.
+ */
+export function parseSpecFile(absPath, repoRoot) {
+    let raw;
+    try {
+        raw = readFileSync(absPath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    let doc;
+    try {
+        doc = parseYaml(raw);
+    }
+    catch {
+        return [];
+    }
+    if (!doc || typeof doc !== 'object')
+        return [];
+    const sourceFile = path.relative(repoRoot, absPath);
+    const surface = inferSurface(absPath, repoRoot);
+    const entries = [];
+    // --- OpenAPI 3.x: paths: { '/foo': { get: { operationId, ... } } }
+    const openApiPaths = doc['paths'];
+    if (openApiPaths && typeof openApiPaths === 'object') {
+        for (const [uriPath, pathItem] of Object.entries(openApiPaths)) {
+            if (!pathItem || typeof pathItem !== 'object')
+                continue;
+            for (const method of HTTP_METHODS) {
+                const op = pathItem[method];
+                if (!op)
+                    continue;
+                entries.push({
+                    path: uriPath,
+                    method: method.toUpperCase(),
+                    action: inferAction(uriPath, method, op['operationId']),
+                    sourceFile,
+                    surface,
+                });
+            }
+        }
+        return entries;
+    }
+    // --- Custom backend-spec format: routes: [{ method, path, action, ... }]
+    const customRoutes = doc['routes'];
+    if (Array.isArray(customRoutes)) {
+        for (const r of customRoutes) {
+            const uriPath = String(r['path'] ?? r['uri'] ?? '');
+            const method = String(r['method'] ?? 'GET').toUpperCase();
+            if (!uriPath)
+                continue;
+            entries.push({
+                path: uriPath,
+                method,
+                action: String(r['action'] ?? inferAction(uriPath, method.toLowerCase())),
+                sourceFile,
+                surface,
+            });
+        }
+        return entries;
+    }
+    // --- Custom backend-spec format: endpoints: [{ method, path, ... }]
+    const customEndpoints = doc['endpoints'];
+    if (Array.isArray(customEndpoints)) {
+        for (const ep of customEndpoints) {
+            const uriPath = String(ep['path'] ?? ep['url'] ?? '');
+            const method = String(ep['method'] ?? 'GET').toUpperCase();
+            if (!uriPath)
+                continue;
+            entries.push({
+                path: uriPath,
+                method,
+                action: String(ep['action'] ?? inferAction(uriPath, method.toLowerCase())),
+                sourceFile,
+                surface,
+            });
+        }
+    }
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// Index (rebuild)
+// ---------------------------------------------------------------------------
+/**
+ * Scan product repo for API spec YAML files, parse routes, insert into SQLite.
+ * Returns total route count indexed.
+ */
+export function indexApiRoutes(store, repoRoot, cfg) {
+    const specFiles = resolveSpecGlobs(repoRoot, cfg);
+    store.clearApiRoutes();
+    let count = 0;
+    for (const absPath of specFiles) {
+        const parsed = parseSpecFile(absPath, repoRoot);
+        for (const entry of parsed) {
+            store.insertApiRoute({
+                route_path: entry.path,
+                method: entry.method,
+                action: entry.action,
+                source_file: entry.sourceFile,
+                surface: entry.surface,
+            });
+            count++;
+        }
+    }
+    store.setMeta('apiRoutesIndexedAt', new Date().toISOString());
+    store.setMeta('apiRoutesCount', String(count));
+    return count;
+}
+// ---------------------------------------------------------------------------
+// Query (hybrid: index first, fallback on-demand scan)
+// ---------------------------------------------------------------------------
+function isIndexFresh(store) {
+    const indexedAt = store.getMeta('apiRoutesIndexedAt');
+    if (!indexedAt)
+        return false;
+    const age = Date.now() - new Date(indexedAt).getTime();
+    return age < INDEX_MAX_AGE_MS;
+}
+function rowToEntry(row) {
+    return {
+        path: row.route_path,
+        method: row.method,
+        action: row.action,
+        sourceFile: row.source_file,
+        surface: row.surface,
+    };
+}
+/**
+ * Find API routes matching path + optional method/entity.
+ * Uses SQLite index when fresh; scans on-demand as fallback.
+ */
+export function findApiRoutes(store, repoRoot, cfg, opts) {
+    const useIndex = isIndexFresh(store) && store.countApiRoutes() > 0;
+    let rows;
+    if (useIndex) {
+        // Exact match first
+        rows = store.findApiRoutes(opts.path, opts.method);
+        // If no exact match, try prefix (path without trailing action segment)
+        if (rows.length === 0 && opts.path.includes('/')) {
+            const prefix = opts.path.replace(/\/[^/]+$/, '') + '%';
+            rows = store.findApiRoutes(prefix, opts.method);
+        }
+    }
+    else {
+        // On-demand scan (also writes back to index)
+        const all = scanApiRoutesDirect(repoRoot, cfg);
+        store.clearApiRoutes();
+        for (const e of all) {
+            store.insertApiRoute({
+                route_path: e.path,
+                method: e.method,
+                action: e.action,
+                source_file: e.sourceFile,
+                surface: e.surface,
+            });
+        }
+        store.setMeta('apiRoutesIndexedAt', new Date().toISOString());
+        store.setMeta('apiRoutesCount', String(all.length));
+        rows = all
+            .filter((e) => {
+            const pathMatch = e.path === opts.path || e.path.startsWith(opts.path.replace(/\/[^/]+$/, ''));
+            const methodMatch = !opts.method || e.method === opts.method.toUpperCase();
+            return pathMatch && methodMatch;
+        })
+            .map((e) => ({
+            route_path: e.path,
+            method: e.method,
+            action: e.action,
+            source_file: e.sourceFile,
+            surface: e.surface,
+        }));
+    }
+    let results = rows.map(rowToEntry);
+    // Entity fuzzy match — filter by entity name in path
+    if (opts.entity && results.length === 0) {
+        const entityLower = opts.entity.toLowerCase();
+        const allRows = store.listAllApiRoutes();
+        results = allRows
+            .filter((r) => r.route_path.toLowerCase().includes(entityLower))
+            .map(rowToEntry);
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// On-demand scan (stateless)
+// ---------------------------------------------------------------------------
+/** Scan all spec YAML files directly without using the index. */
+export function scanApiRoutesDirect(repoRoot, cfg) {
+    const specFiles = resolveSpecGlobs(repoRoot, cfg);
+    const all = [];
+    for (const f of specFiles) {
+        all.push(...parseSpecFile(f, repoRoot));
+    }
+    return all;
+}
+// ---------------------------------------------------------------------------
+// Duplicate detection
+// ---------------------------------------------------------------------------
+/**
+ * Given a list of routes, return any path+method that appears in more than one
+ * source file (structural conflict candidates).
+ */
+export function detectDuplicateRoutes(routes) {
+    const map = new Map();
+    for (const r of routes) {
+        const key = `${r.method}:${r.path}`;
+        if (!map.has(key))
+            map.set(key, new Set());
+        map.get(key).add(r.sourceFile);
+    }
+    const conflicts = [];
+    for (const [key, sources] of map.entries()) {
+        if (sources.size > 1) {
+            const [method, ...pathParts] = key.split(':');
+            conflicts.push({
+                path: pathParts.join(':'),
+                method: method,
+                sources: [...sources],
+            });
+        }
+    }
+    return conflicts;
+}
+/**
+ * Load all currently indexed routes (or scan on-demand if stale).
+ * Convenience wrapper for grill_check duplicate detection.
+ */
+export function loadAllApiRoutes(store, repoRoot, cfg) {
+    const useIndex = isIndexFresh(store) && store.countApiRoutes() > 0;
+    if (useIndex) {
+        return store.listAllApiRoutes().map(rowToEntry);
+    }
+    return scanApiRoutesDirect(repoRoot, cfg);
+}
+//# sourceMappingURL=api-routes.js.map

package/dist/graph/analyze/api-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-routes.js","sourceRoot":"","sources":["../../../src/graph/analyze/api-routes.ts"],"names":[],"mappings":"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"}

package/dist/graph/analyze/context-orphan.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Context orphan = action data-scope mismatch (NOT "btn is named export/send").
+ *
+ * Screen displays hotel + rooms (+ other related visible on UI).
+ * A button (export / send mail / anything) uses order / campaign / … data
+ * that is NOT in that display set → warn member.
+ */
+import type { ContextOrphanFinding, Gap } from '../types.js';
+export declare function contextOrphanSchemaBlock(): string;
+export declare function parseContextOrphansDoc(doc: unknown): ContextOrphanFinding[];
+export declare function scanModuleContextOrphans(repoRoot: string, moduleDir: string): ContextOrphanFinding[];
+export declare function orphanToGap(f: ContextOrphanFinding): Gap;

package/dist/graph/analyze/context-orphan.js

@@ -0,0 +1,229 @@
+/**
+ * Context orphan = action data-scope mismatch (NOT "btn is named export/send").
+ *
+ * Screen displays hotel + rooms (+ other related visible on UI).
+ * A button (export / send mail / anything) uses order / campaign / … data
+ * that is NOT in that display set → warn member.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+export function contextOrphanSchemaBlock() {
+    return [
+        '## contextOrphans (same turn — WARN ONLY, no A/B/C)',
+        'Warn when action.usesData is NOT a subset of screenData (what the UI shows).',
+        'Example: list shows hotel+rooms; action uses order rows → orphan.',
+        'NOT about the verb (export/mail); about WHICH DATA the action touches.',
+        'Each: id, hostSurface, screenData[], action:{id,label?,kind?,usesData[]}, reason?',
+        'Do NOT ask member to unify — surface as warning only (no gate / no remember required).',
+        'Skip when usesData ⊆ screenData (incl. related child data shown on the same screen).',
+    ].join('\n');
+}
+export function parseContextOrphansDoc(doc) {
+    if (!doc || typeof doc !== 'object')
+        return [];
+    const root = doc;
+    const list = Array.isArray(root.contextOrphans)
+        ? root.contextOrphans
+        : Array.isArray(root.orphans)
+            ? root.orphans
+            : [];
+    return list.map((item, i) => normalizeOrphan(item, i)).filter(Boolean);
+}
+export function scanModuleContextOrphans(repoRoot, moduleDir) {
+    const abs = path.isAbsolute(moduleDir) ? moduleDir : path.join(repoRoot, moduleDir);
+    if (!existsSync(abs))
+        return [];
+    const out = [];
+    for (const file of listYamlFiles(abs)) {
+        const doc = parseYaml(readFileSync(file, 'utf8'));
+        out.push(...orphansFromDoc(doc, file));
+    }
+    return out;
+}
+export function orphanToGap(f) {
+    return {
+        kind: 'context-orphan',
+        id: f.id,
+        message: f.reason ??
+            `Action "${f.action.label ?? f.action.id}" usesData=[${f.action.usesData.join(',')}] ` +
+                `but screen ${f.hostSurface} displays [${f.screenData.join(',')}]`,
+        source: f.source,
+        // Cap at warn — orphan is advisory only, never blocks handoff
+        severity: f.severity === 'info' ? 'info' : 'warn',
+        confidence: 0.88,
+    };
+}
+function normalizeOrphan(raw, index) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const o = raw;
+    const actionRaw = o.action;
+    if (!actionRaw || typeof actionRaw !== 'object')
+        return null;
+    const action = actionRaw;
+    const hostSurface = String(o.hostSurface ?? o.surface ?? '').trim();
+    const actionId = String(action.id ?? action.name ?? action.label ?? '').trim();
+    const screenData = toStrList(o.screenData ?? o.displays ?? o.hostData);
+    const usesData = toStrList(action.usesData ?? action.data ?? action.operatesOn ?? action.entity ?? action.target);
+    if (!hostSurface || !actionId || !screenData.length || !usesData.length)
+        return null;
+    if (isSubset(usesData, screenData))
+        return null;
+    return {
+        id: String(o.id ?? `${slug(hostSurface)}.${slug(actionId)}.${index}`),
+        hostSurface,
+        screenData,
+        action: {
+            id: actionId,
+            label: action.label != null ? String(action.label) : undefined,
+            kind: action.kind != null ? String(action.kind) : undefined,
+            usesData,
+        },
+        reason: typeof o.reason === 'string' ? o.reason : undefined,
+        severity: o.severity === 'info' || o.severity === 'warn' || o.severity === 'error'
+            ? o.severity
+            : 'warn',
+        options: Array.isArray(o.options)
+            ? o.options
+            : undefined,
+        askUser: typeof o.askUser === 'string' ? o.askUser : undefined,
+        source: o.source != null ? String(o.source) : undefined,
+    };
+}
+function orphansFromDoc(doc, file) {
+    const screenData = screenDataFromDoc(doc, file);
+    if (!screenData.length)
+        return [];
+    const hostSurface = String(doc.id ?? path.basename(path.dirname(file)));
+    const out = [];
+    for (const a of extractActions(doc)) {
+        if (!a.usesData.length)
+            continue;
+        if (isSubset(a.usesData, screenData))
+            continue;
+        out.push({
+            id: `${slug(hostSurface)}.${slug(a.id)}.orphan`,
+            hostSurface,
+            screenData,
+            action: a,
+            reason: `Action uses [${a.usesData.join(',')}] but screen displays [${screenData.join(',')}]`,
+            severity: 'warn',
+            source: file,
+        });
+    }
+    return out;
+}
+function screenDataFromDoc(doc, file) {
+    const explicit = toStrList(doc.legacy?.screenData ??
+        doc.review?.screenData);
+    if (explicit.length)
+        return explicit;
+    const names = [];
+    const spec = doc.spec;
+    for (const raw of Array.isArray(spec?.entities) ? spec.entities : []) {
+        if (raw && typeof raw === 'object') {
+            const e = raw;
+            const n = String(e.name ?? e.id ?? e.key ?? '').trim();
+            if (n)
+                names.push(n);
+        }
+    }
+    for (const raw of Array.isArray(spec?.relationships) ? spec.relationships : []) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const r = raw;
+        for (const k of ['to', 'target', 'entity', 'child', 'name']) {
+            if (r[k])
+                names.push(String(r[k]));
+        }
+    }
+    const gen = doc.gen;
+    const codegen = gen?.codegen;
+    if (codegen?.entity)
+        names.push(String(codegen.entity));
+    if (!names.length) {
+        const id = String(doc.id ?? path.basename(path.dirname(file)));
+        const m = id.match(/^[a-z]+-([a-z0-9]+)/i);
+        if (m?.[1])
+            names.push(m[1]);
+    }
+    return uniqSlugged(names);
+}
+function extractActions(doc) {
+    const buckets = [];
+    const design = doc.design;
+    if (Array.isArray(design?.actions))
+        buckets.push(...design.actions);
+    const legacy = doc.legacy;
+    if (Array.isArray(legacy?.ui))
+        buckets.push(...legacy.ui);
+    if (Array.isArray(legacy?.behaviors))
+        buckets.push(...legacy.behaviors);
+    const out = [];
+    for (const raw of buckets) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const o = raw;
+        const id = String(o.id ?? o.name ?? o.key ?? o.action ?? o.label ?? '').trim();
+        if (!id)
+            continue;
+        const usesData = toStrList(o.usesData ?? o.data ?? o.operatesOn ?? o.entity ?? o.target);
+        if (!usesData.length)
+            continue;
+        out.push({
+            id,
+            label: o.label != null ? String(o.label) : undefined,
+            kind: o.kind != null ? String(o.kind) : o.type != null ? String(o.type) : undefined,
+            usesData,
+        });
+    }
+    return out;
+}
+function isSubset(uses, screen) {
+    const set = new Set(screen.map(slug));
+    return uses.every((u) => set.has(slug(u)));
+}
+function toStrList(v) {
+    if (v == null)
+        return [];
+    if (Array.isArray(v))
+        return v.map(String).map((s) => s.trim()).filter(Boolean);
+    const s = String(v).trim();
+    return s ? [s] : [];
+}
+function uniqSlugged(names) {
+    const seen = new Set();
+    const out = [];
+    for (const n of names) {
+        const k = slug(n);
+        if (!k || seen.has(k))
+            continue;
+        seen.add(k);
+        out.push(n);
+    }
+    return out;
+}
+function slug(s) {
+    return s.trim().toLowerCase().replace(/[^a-z0-9]+/g, '');
+}
+function listYamlFiles(dir) {
+    const out = [];
+    const walk = (d, depth) => {
+        if (depth > 6)
+            return;
+        for (const name of readdirSync(d)) {
+            if (name.startsWith('.') || name === 'node_modules' || name === 'md')
+                continue;
+            const p = path.join(d, name);
+            const st = statSync(p);
+            if (st.isDirectory())
+                walk(p, depth + 1);
+            else if (/\.(ya?ml)$/i.test(name) && !name.includes('test.yaml'))
+                out.push(p);
+        }
+    };
+    walk(dir, 0);
+    return out;
+}
+//# sourceMappingURL=context-orphan.js.map

package/dist/graph/analyze/context-orphan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-orphan.js","sourceRoot":"","sources":["../../../src/graph/analyze/context-orphan.ts"],"names":[],"mappings":"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"}