@shanyucoder/flowgrid 0.1.0

package/dist/graph/analyze/analyze-bullets.js.map

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

package/dist/graph/analyze/analyze-spec.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Analyze an existing ir/spec.yaml (or any YAML with tags/codegen).
+ *
+ * Local-first: compare tags + codegen block against registries → Gap[].
+ * High-confidence gaps can be fixed without cloud; low-confidence go into cloudPromptSlice.
+ */
+import type { AnalyzeResult, ArtifactgraphConfig } from '../types.js';
+import type { IndexStore } from '../db/index-store.js';
+/**
+ * Core analyzer for a single spec file.
+ */
+export declare function analyzeSpecFile(repoRoot: string, cfg: ArtifactgraphConfig, specPath: string, store?: IndexStore): AnalyzeResult;

package/dist/graph/analyze/analyze-spec.js

@@ -0,0 +1,249 @@
+/**
+ * Analyze an existing ir/spec.yaml (or any YAML with tags/codegen).
+ *
+ * Local-first: compare tags + codegen block against registries → Gap[].
+ * High-confidence gaps can be fixed without cloud; low-confidence go into cloudPromptSlice.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+import { loadRegistries } from '../registry/load-registries.js';
+import { resolveSpecPath } from '../config/resolve-paths.js';
+import { parityCloudSchemaBlock } from './parity-check.js';
+import { isBeStack, isFeStack } from '../lexicon/infer-lane.js';
+function asTags(doc) {
+    const tags = [...(doc.tags ?? [])];
+    for (const m of doc.marks ?? []) {
+        if (m.tag)
+            tags.push(m.tag);
+    }
+    return tags.map((t) => t.trim());
+}
+function hasPrefix(tags, prefix) {
+    return tags.some((t) => t.replace(/\s+/g, ' ').startsWith(prefix));
+}
+/**
+ * Core analyzer for a single spec file.
+ */
+export function analyzeSpecFile(repoRoot, cfg, specPath, store) {
+    const abs = resolveSpecPath(repoRoot, cfg, specPath);
+    if (!existsSync(abs)) {
+        throw new Error(`Spec not found: ${abs}`);
+    }
+    const doc = parseYaml(readFileSync(abs, 'utf8'));
+    const tags = asTags(doc);
+    const regs = loadRegistries(repoRoot, cfg);
+    const gaps = [];
+    const askUser = [];
+    const fe = isFeStack(cfg);
+    const be = isBeStack(cfg);
+    // --- codegen readiness ---
+    if (!doc.codegen?.profile) {
+        gaps.push({
+            kind: 'missing-codegen-profile',
+            message: 'Missing codegen.profile — stack gen will refuse.',
+            source: abs,
+            severity: 'error',
+            confidence: 0.95,
+        });
+    }
+    const profile = doc.codegen?.profile;
+    // --- shell / pattern for FE stacks only ---
+    if (fe && (profile === 'list' || profile === 'create' || profile === 'edit')) {
+        if (!hasPrefix(tags, '#shell:')) {
+            const suggested = profile === 'list' ? '#shell: DataListPage' : '#shell: DataFormPage';
+            gaps.push({
+                kind: 'missing-hashtag',
+                message: `No #shell: tag for profile=${profile}`,
+                suggestedTag: suggested,
+                source: abs,
+                severity: 'warn',
+                confidence: 0.9,
+            });
+            askUser.push(`[GRILL-MARK] Missing shell for ${profile}. Apply ${suggested}? (B=mark)`);
+        }
+        else {
+            const knownShells = ['DataListPage', 'DataFormPage'];
+            const shellTag = tags.find(t => t.startsWith('#shell:'))?.split(':')[1]?.trim();
+            if (shellTag && !knownShells.includes(shellTag)) {
+                gaps.push({
+                    kind: 'needs-component',
+                    message: `Unknown #shell: ${shellTag} — template may be missing. FE will render a <slot>, BE will render a TODO comment.`,
+                    source: abs,
+                    severity: 'warn',
+                    confidence: 0.8,
+                });
+            }
+        }
+        if (!hasPrefix(tags, '#pattern:')) {
+            gaps.push({
+                kind: 'missing-hashtag',
+                message: 'No #pattern: tag (usually CRUD)',
+                suggestedTag: '#pattern: CRUD',
+                source: abs,
+                severity: 'info',
+                confidence: 0.85,
+            });
+        }
+    }
+    // --- columns without component → FE only ---
+    if (fe) {
+        for (const col of doc.ui?.columns ?? []) {
+            if (col.key && !col.component) {
+                const tag = `#needs-component: cell-${col.key}:Mo${pascal(col.key)}:label`;
+                gaps.push({
+                    kind: 'needs-component',
+                    message: `Column "${col.key}" has no component — prototype should implement or mark needs-component`,
+                    suggestedTag: tag,
+                    source: abs,
+                    severity: 'warn',
+                    confidence: 0.7,
+                });
+                askUser.push(`[GRILL-MARK] Column ${col.key}: A) local cell  B) ${tag}  C) defer`);
+            }
+        }
+    }
+    // --- BE: endpoint/dto tags when api profile without marks ---
+    if (be && profile && !tags.some((t) => t.includes('#needs-endpoint'))) {
+        if (/(index|list|store|show|update|destroy|resource|api)/i.test(profile)) {
+            gaps.push({
+                kind: 'registry-miss',
+                message: `BE profile=${profile} with no #needs-endpoint tag`,
+                suggestedTag: '#needs-endpoint',
+                source: abs,
+                severity: 'info',
+                confidence: 0.65,
+            });
+        }
+    }
+    // --- already tagged needs-* / #missing_info stay visible in inventory ---
+    for (const t of tags) {
+        if (t.includes('#needs-component')) {
+            gaps.push({
+                kind: 'needs-component',
+                message: `Spec already marks: ${t}`,
+                suggestedTag: t,
+                source: abs,
+                severity: 'info',
+                confidence: 1,
+            });
+        }
+        if (t.includes('#needs-ui')) {
+            gaps.push({
+                kind: 'needs-ui',
+                message: `Spec already marks: ${t}`,
+                suggestedTag: t,
+                source: abs,
+                severity: 'info',
+                confidence: 1,
+            });
+        }
+        if (t.includes('#needs-common') || t.includes('#needs-unit-test')) {
+            gaps.push({
+                kind: t.includes('unit') ? 'needs-unit-test' : 'needs-common',
+                message: `Spec already marks: ${t}`,
+                suggestedTag: t,
+                source: abs,
+                severity: 'info',
+                confidence: 1,
+            });
+        }
+        if (t.includes('#needs-endpoint') || t.includes('#needs-dto')) {
+            gaps.push({
+                kind: 'registry-miss',
+                message: `Spec already marks: ${t}`,
+                suggestedTag: t,
+                source: abs,
+                severity: 'info',
+                confidence: 1,
+            });
+        }
+        if (t.includes('#missing_info')) {
+            gaps.push({
+                kind: 'missing-info',
+                message: `Business gap ${t} — re-check ArtifactGraph/registry, micro-scope, propose options; do not invent; write product SSOT only after member confirm`,
+                suggestedTag: t,
+                source: abs,
+                severity: 'warn',
+                confidence: 0.95,
+            });
+            askUser.push(`[MISSING-INFO] Resolve ${t}: A) fill from member answer  B) keep empty + defer  C) promote common only after confirm`);
+        }
+    }
+    // Inline / note occurrences not listed under tags/marks
+    const rawText = readFileSync(abs, 'utf8');
+    if (rawText.includes('#missing_info') && !tags.some((t) => t.includes('#missing_info'))) {
+        gaps.push({
+            kind: 'missing-info',
+            message: 'Spec body contains #missing_info — treat as open business gap; grill hard gate before inventing or overwriting SSOT',
+            suggestedTag: '#missing_info',
+            source: abs,
+            severity: 'warn',
+            confidence: 0.9,
+        });
+        askUser.push('[MISSING-INFO] Inline #missing_info found: A) promote into tags/marks + ask member  B) keep note  C) defer');
+    }
+    // --- non-legacy: confirm generated blocks with member (LOCAL, not cloud) ---
+    const origin = String(doc.specOrigin ?? '');
+    const isLegacy = origin === 'legacy' || abs.includes('_legacy');
+    if (!isLegacy && (doc.codegen?.profile || tags.length > 0)) {
+        askUser.push('[GRILL-CONFIRM] Blocks/tags đề xuất từ IR (không clone legacy). Member xác nhận đúng trước khi gen? (yes / edit / defer) — local only, không cloud');
+        gaps.push({
+            kind: 'missing-hashtag',
+            message: 'Non-legacy spec: confirm generated blocks/tags with member before gen (local askUser)',
+            source: abs,
+            severity: 'info',
+            confidence: 0.95,
+        });
+    }
+    // --- unit hint (FE list or BE index) ---
+    if (regs.unitPatterns.length &&
+        !tags.some((t) => t.includes('#needs-unit') || t.includes('#unit:'))) {
+        const unitProfile = fe && profile === 'list';
+        const beIndex = be && profile && /index|list/i.test(profile);
+        if (unitProfile || beIndex) {
+            gaps.push({
+                kind: 'needs-unit-test',
+                message: unitProfile
+                    ? 'List profile with no unit-test tags — consider unit-gen after prototype'
+                    : 'Index/list API with no unit-test tags — consider unit-gen',
+                source: abs,
+                severity: 'info',
+                confidence: 0.6,
+            });
+        }
+    }
+    const unresolved = gaps.filter((g) => g.confidence < 0.8 || g.severity !== 'info');
+    let cloudPromptSlice = formatCloudSlice(unresolved, tags);
+    if (isLegacy) {
+        cloudPromptSlice = `${cloudPromptSlice}\n\n${parityCloudSchemaBlock()}`;
+    }
+    const result = {
+        projectId: cfg.projectId,
+        repoRoot,
+        specPath: abs,
+        tags,
+        draftTags: [],
+        gaps,
+        askUser,
+        cloudPromptSlice,
+    };
+    store?.saveGapSnapshot(abs, gaps);
+    return result;
+}
+function pascal(s) {
+    return s
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((p) => p[0].toUpperCase() + p.slice(1))
+        .join('');
+}
+/** Compact text for cloud — NEVER dump full registry. */
+function formatCloudSlice(gaps, tags) {
+    const lines = [
+        '## artifactgraph unresolved (local preflight)',
+        `existing tags: ${tags.slice(0, 20).join(', ') || '(none)'}`,
+        ...gaps.map((g) => `- [${g.severity}/${g.kind} c=${g.confidence}] ${g.message}${g.suggestedTag ? ` → ${g.suggestedTag}` : ''}`),
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=analyze-spec.js.map

package/dist/graph/analyze/analyze-spec.js.map

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

package/dist/graph/analyze/api-routes.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 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 type { ArtifactgraphConfig } from '../types.js';
+import type { IndexStore } from '../db/index-store.js';
+export interface ApiRouteEntry {
+    /** URI path, e.g. /api/v1/users/{id}/update */
+    path: string;
+    /** HTTP method, uppercased: GET | POST | PUT | PATCH | DELETE */
+    method: string;
+    /** Action derived from URI suffix or operation ID: create | update | detail | delete | duplicate | list */
+    action: string;
+    /** Relative source file path from repo root */
+    sourceFile: string;
+    /** Surface / module id (derived from directory structure) */
+    surface: string;
+}
+export interface DuplicateRouteConflict {
+    path: string;
+    method: string;
+    /** All source files that define this path+method */
+    sources: string[];
+}
+/**
+ * Parse one spec file → array of ApiRouteEntry.
+ * Handles both OpenAPI `paths:` and custom `routes:` / `endpoints:` formats.
+ */
+export declare function parseSpecFile(absPath: string, repoRoot: string): ApiRouteEntry[];
+/**
+ * Scan product repo for API spec YAML files, parse routes, insert into SQLite.
+ * Returns total route count indexed.
+ */
+export declare function indexApiRoutes(store: IndexStore, repoRoot: string, cfg: ArtifactgraphConfig): number;
+/**
+ * Find API routes matching path + optional method/entity.
+ * Uses SQLite index when fresh; scans on-demand as fallback.
+ */
+export declare function findApiRoutes(store: IndexStore, repoRoot: string, cfg: ArtifactgraphConfig, opts: {
+    path: string;
+    method?: string;
+    entity?: string;
+}): ApiRouteEntry[];
+/** Scan all spec YAML files directly without using the index. */
+export declare function scanApiRoutesDirect(repoRoot: string, cfg: ArtifactgraphConfig): ApiRouteEntry[];
+/**
+ * Given a list of routes, return any path+method that appears in more than one
+ * source file (structural conflict candidates).
+ */
+export declare function detectDuplicateRoutes(routes: ApiRouteEntry[]): DuplicateRouteConflict[];
+/**
+ * Load all currently indexed routes (or scan on-demand if stale).
+ * Convenience wrapper for grill_check duplicate detection.
+ */
+export declare function loadAllApiRoutes(store: IndexStore, repoRoot: string, cfg: ArtifactgraphConfig): ApiRouteEntry[];