@shanyucoder/flowgrid 0.1.0

package/dist/graph/analyze/grill-check.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Grill-oriented check: surfaces askUser prompts for missing hashtags / commons.
+ * Thin wrapper so MCP tool names match the product vocabulary (/dev-grill-docs).
+ *
+ * Extended (API Reuse): detects duplicate URI paths across product surfaces.
+ * When a spec's path already exists in another surface without #reuse-api,
+ * emits a `duplicate-api-route` gap with suggestedTag: '#reuse-api'.
+ * The agent adds the tag — no A/B/C gate needed.
+ */
+import type { AnalyzeResult, ArtifactgraphConfig } from '../types.js';
+import type { IndexStore } from '../db/index-store.js';
+export interface GrillCheckInput {
+    repoRoot: string;
+    cfg: ArtifactgraphConfig;
+    /** Existing IR spec — preferred when past /dev-grill. */
+    specPath?: string;
+    /** Raw bullets — for early BA/dev notes before IR exists. */
+    bullets?: string;
+    store?: IndexStore;
+}
+/**
+ * Returns analyze result focused on confirm questions (A/B/C).
+ * Appends duplicate-api-route gaps when a spec defines paths that already
+ * exist in other surfaces and lack a #reuse-api tag.
+ * The suggested resolution is always: add #reuse-api tag.
+ */
+export declare function grillCheck(input: GrillCheckInput): AnalyzeResult;
+/**
+ * Persist member confirm so next analyzeBullets can skip cloud.
+ */
+export declare function recordGrillDecision(store: IndexStore, subject: string, choice: 'A' | 'B' | 'C', payload: Record<string, unknown>): void;

package/dist/graph/analyze/grill-check.js

@@ -0,0 +1,92 @@
+/**
+ * Grill-oriented check: surfaces askUser prompts for missing hashtags / commons.
+ * Thin wrapper so MCP tool names match the product vocabulary (/dev-grill-docs).
+ *
+ * Extended (API Reuse): detects duplicate URI paths across product surfaces.
+ * When a spec's path already exists in another surface without #reuse-api,
+ * emits a `duplicate-api-route` gap with suggestedTag: '#reuse-api'.
+ * The agent adds the tag — no A/B/C gate needed.
+ */
+import { existsSync } from 'node:fs';
+import { analyzeSpecFile } from './analyze-spec.js';
+import { analyzeBullets } from './analyze-bullets.js';
+import { parseSpecFile, loadAllApiRoutes, detectDuplicateRoutes } from './api-routes.js';
+import { resolveSpecPath } from '../config/resolve-paths.js';
+/**
+ * Returns analyze result focused on confirm questions (A/B/C).
+ * Appends duplicate-api-route gaps when a spec defines paths that already
+ * exist in other surfaces and lack a #reuse-api tag.
+ * The suggested resolution is always: add #reuse-api tag.
+ */
+export function grillCheck(input) {
+    let base;
+    if (input.specPath) {
+        base = analyzeSpecFile(input.repoRoot, input.cfg, input.specPath, input.store);
+    }
+    else if (input.bullets?.trim()) {
+        base = analyzeBullets(input.repoRoot, input.cfg, input.bullets, input.store);
+    }
+    else {
+        throw new Error('grill_check requires specPath or bullets');
+    }
+    // --- Duplicate route detection (only when specPath provided + store available) ---
+    if (input.specPath && input.store) {
+        const duplicateGaps = checkDuplicateRoutes(input.repoRoot, input.cfg, input.specPath, base.tags, input.store);
+        if (duplicateGaps.length > 0) {
+            base.gaps.push(...duplicateGaps);
+            // Suggest #reuse-api as draft tag so agent can auto-apply
+            if (!base.draftTags.includes('#reuse-api')) {
+                base.draftTags.push('#reuse-api');
+            }
+            base.cloudPromptSlice =
+                base.cloudPromptSlice +
+                    '\n\n## duplicate-api-route (apply #reuse-api to resolve)\n' +
+                    duplicateGaps.map((g) => `- ${g.message}`).join('\n');
+        }
+    }
+    return base;
+}
+/**
+ * Check the current spec file's routes against the indexed API routes.
+ * Returns gap list — suggestedTag '#reuse-api' on each.
+ * No askUser / A/B/C: the resolution is simply adding #reuse-api to the spec.
+ */
+function checkDuplicateRoutes(repoRoot, cfg, specPath, existingTags, store) {
+    // Already marked as reuse → nothing to flag
+    const hasReuseTag = existingTags.some((t) => t.includes('#reuse-api'));
+    if (hasReuseTag)
+        return [];
+    const abs = resolveSpecPath(repoRoot, cfg, specPath);
+    if (!existsSync(abs))
+        return [];
+    // Parse routes from the current spec
+    const specRoutes = parseSpecFile(abs, repoRoot);
+    if (specRoutes.length === 0)
+        return [];
+    // Load all indexed routes (hybrid: index or on-demand scan)
+    const allRoutes = loadAllApiRoutes(store, repoRoot, cfg);
+    // Build route set excluding the current spec
+    const currentSourceFile = specRoutes[0]?.sourceFile ?? '';
+    const otherRoutes = allRoutes.filter((r) => r.sourceFile !== currentSourceFile);
+    // Detect conflicts: current spec routes vs all others
+    const combined = [...specRoutes, ...otherRoutes];
+    const conflicts = detectDuplicateRoutes(combined).filter((c) => c.sources.some((s) => s !== currentSourceFile) && c.sources.includes(currentSourceFile));
+    return conflicts.map((conflict) => {
+        const otherSources = conflict.sources.filter((s) => s !== currentSourceFile);
+        return {
+            kind: 'duplicate-api-route',
+            message: `DUPLICATE_API_ROUTE: ${conflict.method} ${conflict.path} already defined in ${otherSources.join(', ')} — add #reuse-api to this spec`,
+            suggestedTag: '#reuse-api',
+            source: abs,
+            severity: 'warn',
+            confidence: 0.92,
+        };
+    });
+}
+/**
+ * Persist member confirm so next analyzeBullets can skip cloud.
+ */
+export function recordGrillDecision(store, subject, choice, payload) {
+    store.rememberDecision('grill-confirm', subject, { choice, ...payload });
+}
+//# sourceMappingURL=grill-check.js.map

package/dist/graph/analyze/grill-check.js.map

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

package/dist/graph/analyze/parity-check.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cross-surface parity: create≠edit validation, register≠change-password,
+ * FE≠BE empty policy (null / '' / [] / omit), type drift.
+ *
+ * Local-first: ingest structured findings (from IR scan or cloud same-turn),
+ * emit GapKind parity-drift + askUser for member — never cloud for the confirm.
+ */
+import type { AnalyzeResult } from '../types.js';
+import type { IndexStore } from '../db/index-store.js';
+export interface ParityCheckInput {
+    repoRoot: string;
+    projectId?: string;
+    /** Module dir with _legacy.trace.yaml + child bundles / ir/legacy.yaml */
+    moduleDir?: string;
+    /** Explicit findings file (yaml/json) from cloud archaeology */
+    findingsPath?: string;
+    /** Inline findings JSON string */
+    findingsJson?: string;
+    store?: IndexStore;
+}
+/** Compact schema block — append to cloudPromptSlice on /legacy-spec (1 turn). */
+export declare function parityCloudSchemaBlock(): string;
+export declare function parityCheck(input: ParityCheckInput): AnalyzeResult;
+/** Persist member parity choice (subject = finding id or field:name). */
+export declare function recordParityDecision(store: IndexStore, subject: string, choice: 'A' | 'B' | 'C', payload?: Record<string, unknown>): void;

package/dist/graph/analyze/parity-check.js

@@ -0,0 +1,406 @@
+/**
+ * Cross-surface parity: create≠edit validation, register≠change-password,
+ * FE≠BE empty policy (null / '' / [] / omit), type drift.
+ *
+ * Local-first: ingest structured findings (from IR scan or cloud same-turn),
+ * emit GapKind parity-drift + askUser for member — never cloud for the confirm.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { contextOrphanSchemaBlock, orphanToGap, parseContextOrphansDoc, scanModuleContextOrphans, } from './context-orphan.js';
+const SURFACE_HINTS = [
+    { re: /create|store|new|register|signup/i, surface: 'create' },
+    { re: /edit|update|modify/i, surface: 'edit' },
+    { re: /change[-_]?pass|password[-_]?change|reset[-_]?pass/i, surface: 'change-password' },
+    { re: /login|signin/i, surface: 'login' },
+    { re: /list|index|search/i, surface: 'list' },
+];
+/** Compact schema block — append to cloudPromptSlice on /legacy-spec (1 turn). */
+export function parityCloudSchemaBlock() {
+    return [
+        '## parityFindings (REQUIRED same turn — do not defer to grill)',
+        'Return YAML/JSON array. Local MCP will ask member A/B/C; do not ask in prose.',
+        'Each item: id, field, surfaces[], observed[{surface, required?, type?, empty?, rules?}],',
+        '  severity?: info|warn|error, options?: [{choice:A|B|C, label, canon?}]',
+        'empty enum: null | empty-string | omit | empty-array | unknown',
+        'Cover: create↔edit validate, register↔change-password, FE↔BE, null/\'\'/[]/omit.',
+        'Skip fields identical on all surfaces. Prefer machine fields over prose.',
+        '',
+        contextOrphanSchemaBlock(),
+    ].join('\n');
+}
+export function parityCheck(input) {
+    const findings = collectFindings(input);
+    const orphans = collectOrphans(input);
+    const remembered = rememberedParityIds(input.store);
+    // Field/rule drift: must confirm A/B/C (skip if already remembered)
+    const active = findings.filter((f) => !remembered.has(f.id) && !remembered.has(fieldKey(f.field)));
+    const gaps = [];
+    const askUser = [];
+    for (const f of active) {
+        const drift = describeDrift(f);
+        if (!drift)
+            continue;
+        const severity = f.severity ?? inferSeverity(f);
+        gaps.push({
+            kind: 'parity-drift',
+            id: f.id,
+            message: drift,
+            source: f.observed.map((o) => o.source).filter(Boolean).join('; ') || input.moduleDir,
+            severity,
+            confidence: 0.9,
+        });
+        askUser.push(f.askUser ?? buildAskUser(f));
+    }
+    // Context-orphan: warn only — never askUser / never gate
+    for (const o of orphans) {
+        gaps.push(orphanToGap(o));
+    }
+    const cloudPromptSlice = [
+        '## artifactgraph parity (confirm) + context-orphan (warn only)',
+        ...gaps
+            .filter((g) => g.kind === 'parity-drift')
+            .map((g) => `- [CONFIRM ${g.severity}] ${g.id}: ${g.message}`),
+        ...gaps
+            .filter((g) => g.kind === 'context-orphan')
+            .map((g) => `- [WARN only] ${g.id}: ${g.message}`),
+        gaps.length ? '' : '(no open parity-drift / context-orphan)',
+        '',
+        parityCloudSchemaBlock(),
+    ].join('\n');
+    const result = {
+        projectId: input.projectId,
+        repoRoot: input.repoRoot,
+        tags: [],
+        draftTags: [],
+        gaps,
+        askUser,
+        cloudPromptSlice,
+    };
+    input.store?.saveGapSnapshot(input.findingsPath ?? input.moduleDir, gaps);
+    return result;
+}
+/** Persist member parity choice (subject = finding id or field:name). */
+export function recordParityDecision(store, subject, choice, payload = {}) {
+    store.rememberDecision('parity-confirm', subject, { choice, ...payload });
+}
+function collectFindings(input) {
+    const out = [];
+    if (input.findingsJson?.trim()) {
+        out.push(...parseFindingsDoc(JSON.parse(input.findingsJson)));
+    }
+    if (input.findingsPath) {
+        out.push(...loadFindingsFile(input.repoRoot, input.findingsPath));
+    }
+    if (input.moduleDir) {
+        out.push(...scanModuleParity(input.repoRoot, input.moduleDir));
+    }
+    return mergeById(out);
+}
+function collectOrphans(input) {
+    const out = [];
+    if (input.findingsJson?.trim()) {
+        out.push(...parseContextOrphansDoc(JSON.parse(input.findingsJson)));
+    }
+    if (input.findingsPath) {
+        out.push(...loadOrphansFile(input.repoRoot, input.findingsPath));
+    }
+    if (input.moduleDir) {
+        out.push(...scanModuleContextOrphans(input.repoRoot, input.moduleDir));
+    }
+    return mergeOrphansById(out);
+}
+function loadOrphansFile(repoRoot, rel) {
+    const candidates = [
+        path.isAbsolute(rel) ? rel : path.join(repoRoot, rel),
+        path.isAbsolute(rel) ? '' : path.resolve(process.cwd(), rel),
+    ].filter(Boolean);
+    const abs = candidates.find((p) => existsSync(p));
+    if (!abs)
+        return [];
+    const raw = readFileSync(abs, 'utf8');
+    const doc = abs.endsWith('.json') ? JSON.parse(raw) : parseYaml(raw);
+    return parseContextOrphansDoc(doc);
+}
+function mergeOrphansById(list) {
+    const map = new Map();
+    for (const o of list)
+        map.set(o.id, o);
+    return [...map.values()];
+}
+function loadFindingsFile(repoRoot, rel) {
+    const candidates = [
+        path.isAbsolute(rel) ? rel : path.join(repoRoot, rel),
+        path.isAbsolute(rel) ? '' : path.resolve(process.cwd(), rel),
+    ].filter(Boolean);
+    const abs = candidates.find((p) => existsSync(p));
+    if (!abs)
+        throw new Error(`parity findings not found: ${candidates[0]}`);
+    const raw = readFileSync(abs, 'utf8');
+    const doc = abs.endsWith('.json') ? JSON.parse(raw) : parseYaml(raw);
+    return parseFindingsDoc(doc);
+}
+function parseFindingsDoc(doc) {
+    if (!doc || typeof doc !== 'object')
+        return [];
+    const root = doc;
+    const list = Array.isArray(doc)
+        ? doc
+        : Array.isArray(root.parityFindings)
+            ? root.parityFindings
+            : Array.isArray(root.findings)
+                ? root.findings
+                : [];
+    return list.map((item, i) => normalizeFinding(item, i)).filter(Boolean);
+}
+function normalizeFinding(raw, index) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const o = raw;
+    const field = String(o.field ?? o.name ?? '').trim();
+    if (!field)
+        return null;
+    const observed = normalizeObserved(o.observed);
+    const surfaces = Array.isArray(o.surfaces) && o.surfaces.length
+        ? o.surfaces.map(String)
+        : [...new Set(observed.map((x) => x.surface))];
+    if (surfaces.length < 2 && observed.length < 2)
+        return null;
+    return {
+        id: String(o.id ?? `${fieldKey(field)}.${index}`),
+        field,
+        surfaces,
+        observed,
+        severity: asSeverity(o.severity),
+        options: Array.isArray(o.options) ? o.options : undefined,
+        askUser: typeof o.askUser === 'string' ? o.askUser : undefined,
+    };
+}
+function normalizeObserved(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .map((item) => {
+        if (!item || typeof item !== 'object')
+            return null;
+        const o = item;
+        const surface = String(o.surface ?? '').trim();
+        if (!surface)
+            return null;
+        return {
+            surface,
+            required: typeof o.required === 'boolean' ? o.required : undefined,
+            type: o.type != null ? String(o.type) : undefined,
+            empty: 'empty' in o ? asEmpty(o.empty) : undefined,
+            rules: isPlain(o.rules) ? o.rules : undefined,
+            source: o.source != null ? String(o.source) : undefined,
+        };
+    })
+        .filter(Boolean);
+}
+/** Scan bundles under moduleDir — diff legacy.fields across surfaces. */
+function scanModuleParity(repoRoot, moduleDir) {
+    const abs = path.isAbsolute(moduleDir) ? moduleDir : path.join(repoRoot, moduleDir);
+    if (!existsSync(abs))
+        throw new Error(`moduleDir not found: ${abs}`);
+    const observations = [];
+    for (const file of listYamlFiles(abs)) {
+        const doc = parseYaml(readFileSync(file, 'utf8'));
+        const surface = inferSurface(file, doc);
+        const fields = extractFields(doc);
+        for (const f of fields) {
+            observations.push({
+                field: f.name,
+                surface: f.surface ?? surface,
+                required: f.required,
+                type: f.type,
+                empty: f.empty,
+                rules: f.rules,
+                source: file,
+            });
+        }
+    }
+    return groupToFindings(observations);
+}
+function extractFields(doc) {
+    const buckets = [];
+    const legacy = doc.legacy;
+    if (Array.isArray(legacy?.fields))
+        buckets.push(...legacy.fields);
+    if (Array.isArray(doc.fields))
+        buckets.push(...doc.fields);
+    const spec = doc.spec;
+    const ui = spec?.ui;
+    if (Array.isArray(ui?.fields))
+        buckets.push(...ui.fields);
+    const out = [];
+    for (const raw of buckets) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const o = raw;
+        const name = String(o.name ?? o.key ?? o.field ?? '').trim();
+        if (!name)
+            continue;
+        const validation = isPlain(o.validation) ? o.validation : undefined;
+        const rules = isPlain(o.rules)
+            ? o.rules
+            : validation;
+        out.push({
+            name,
+            surface: o.surface != null ? String(o.surface) : undefined,
+            required: typeof o.required === 'boolean'
+                ? o.required
+                : typeof validation?.required === 'boolean'
+                    ? validation.required
+                    : undefined,
+            type: o.type != null ? String(o.type) : undefined,
+            empty: 'empty' in o || 'emptyPolicy' in o ? asEmpty(o.empty ?? o.emptyPolicy) : undefined,
+            rules,
+        });
+    }
+    return out;
+}
+function groupToFindings(rows) {
+    const byField = new Map();
+    for (const r of rows) {
+        const k = fieldKey(r.field);
+        const list = byField.get(k) ?? [];
+        list.push(r);
+        byField.set(k, list);
+    }
+    const findings = [];
+    for (const [fk, list] of byField) {
+        const surfaces = [...new Set(list.map((x) => x.surface))];
+        if (surfaces.length < 2)
+            continue;
+        const fps = new Set(list.map((x) => fingerprint(x)));
+        if (fps.size < 2)
+            continue;
+        findings.push({
+            id: `${fk}.parity`,
+            field: list[0].field,
+            surfaces,
+            observed: list.map(({ field: _f, ...obs }) => obs),
+            severity: 'warn',
+        });
+    }
+    return findings;
+}
+function fingerprint(o) {
+    const rules = o.rules ? JSON.stringify(sortKeys(o.rules)) : '';
+    return [
+        o.required === undefined ? '?' : o.required ? 'req' : 'opt',
+        o.type ?? '?',
+        o.empty ?? '?',
+        rules,
+    ].join('|');
+}
+function describeDrift(f) {
+    if (f.observed.length < 2)
+        return null;
+    const parts = f.observed.map((o) => `${o.surface}:{${fingerprint(o)}}`);
+    const unique = new Set(parts);
+    if (unique.size < 2)
+        return null;
+    return `Field "${f.field}" drifts across ${f.surfaces.join(',')}: ${[...unique].join(' vs ')}`;
+}
+function buildAskUser(f) {
+    if (f.options?.length) {
+        return `[PARITY] ${f.id} (${f.field}): ${f.options.map((o) => `${o.choice}) ${o.label}`).join('  ')}`;
+    }
+    const empties = [...new Set(f.observed.map((o) => o.empty).filter(Boolean))];
+    if (empties.length > 1) {
+        return `[PARITY] ${f.id} empty policy for "${f.field}": A) null  B) empty-string  C) omit (defer=keep note)`;
+    }
+    return `[PARITY] ${f.id} "${f.field}" create/edit/API rules differ — A) pick stricter canon  B) keep drift + openQuestion  C) defer`;
+}
+function inferSeverity(f) {
+    const hasEmptyDrift = new Set(f.observed.map((o) => o.empty).filter(Boolean)).size > 1;
+    const hasTypeDrift = new Set(f.observed.map((o) => o.type).filter(Boolean)).size > 1;
+    if (hasEmptyDrift || hasTypeDrift)
+        return 'error';
+    return 'warn';
+}
+function inferSurface(file, doc) {
+    const id = String(doc.id ?? path.basename(path.dirname(file)));
+    for (const h of SURFACE_HINTS) {
+        if (h.re.test(id) || h.re.test(file))
+            return h.surface;
+    }
+    const profile = doc.gen?.codegen;
+    if (profile?.profile)
+        return String(profile.profile);
+    return id;
+}
+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;
+}
+function rememberedParityIds(store) {
+    if (!store)
+        return new Set();
+    return new Set(store.findDecisionsByKind('parity-confirm').map((d) => d.subject));
+}
+function mergeById(list) {
+    const map = new Map();
+    for (const f of list) {
+        const prev = map.get(f.id);
+        if (!prev) {
+            map.set(f.id, f);
+            continue;
+        }
+        map.set(f.id, {
+            ...prev,
+            ...f,
+            observed: [...prev.observed, ...f.observed],
+            surfaces: [...new Set([...prev.surfaces, ...f.surfaces])],
+        });
+    }
+    return [...map.values()];
+}
+function fieldKey(name) {
+    return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '.');
+}
+function asEmpty(v) {
+    if (v === undefined)
+        return undefined;
+    if (v === null)
+        return 'null';
+    const s = String(v);
+    if (['null', 'empty-string', 'omit', 'empty-array', 'unknown'].includes(s)) {
+        return s;
+    }
+    if (s === "''" || s === '""' || s === '')
+        return 'empty-string';
+    if (s === '[]')
+        return 'empty-array';
+    return 'unknown';
+}
+function asSeverity(v) {
+    if (v === 'info' || v === 'warn' || v === 'error')
+        return v;
+    return undefined;
+}
+function isPlain(v) {
+    return Boolean(v) && typeof v === 'object' && !Array.isArray(v);
+}
+function sortKeys(obj) {
+    return Object.fromEntries(Object.keys(obj).sort().map((k) => [k, obj[k]]));
+}
+//# sourceMappingURL=parity-check.js.map

package/dist/graph/analyze/parity-check.js.map

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

package/dist/graph/analyze/product-paths.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Product surface/module path helpers.
+ *
+ * Canonical (Docskit hub): product/surfaces/<surface>/CMP-* /...
+ * Legacy: product/surfaces/<surface>/modules/CMP-* /...
+ */
+/**
+ * Infer `surface/CMP-*` label from a file under the product tree.
+ * Prefers canonical layout; falls back to legacy `modules/` segment.
+ */
+export declare function inferSurfaceFromRepoPath(absPath: string, repoRoot: string): string;
+/** True when path uses the legacy modules/CMP-* segment. */
+export declare function isLegacyModulesCmpPath(filePath: string): boolean;

package/dist/graph/analyze/product-paths.js

@@ -0,0 +1,29 @@
+/**
+ * Product surface/module path helpers.
+ *
+ * Canonical (Docskit hub): product/surfaces/<surface>/CMP-* /...
+ * Legacy: product/surfaces/<surface>/modules/CMP-* /...
+ */
+import path from 'node:path';
+/**
+ * Infer `surface/CMP-*` label from a file under the product tree.
+ * Prefers canonical layout; falls back to legacy `modules/` segment.
+ */
+export function inferSurfaceFromRepoPath(absPath, repoRoot) {
+    const rel = path.relative(repoRoot, absPath).split(path.sep).join('/');
+    // Canonical: product/surfaces/<surface>/CMP-* /...
+    let m = rel.match(/^product\/surfaces\/([^/]+)\/(CMP-[^/]+)/i);
+    if (m)
+        return `${m[1]}/${m[2]}`;
+    // Legacy: product/surfaces/<surface>/modules/CMP-* /...
+    m = rel.match(/^product\/surfaces\/([^/]+)\/modules\/(CMP-[^/]+)/i);
+    if (m)
+        return `${m[1]}/${m[2]}`;
+    const parts = rel.split('/');
+    return parts.slice(0, Math.min(3, Math.max(parts.length - 1, 0))).join('/');
+}
+/** True when path uses the legacy modules/CMP-* segment. */
+export function isLegacyModulesCmpPath(filePath) {
+    return /(?:^|\/)product\/surfaces\/[^/]+\/modules\/CMP-/i.test(filePath.split(path.sep).join('/'));
+}
+//# sourceMappingURL=product-paths.js.map

package/dist/graph/analyze/product-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-paths.js","sourceRoot":"","sources":["../../../src/graph/analyze/product-paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,QAAgB;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEtE,mDAAmD;IACnD,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC9D,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE/B,wDAAwD;IACxD,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACnE,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE/B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC7E,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,OAAO,kDAAkD,CAAC,IAAI,CAC5D,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACnC,CAAA;AACH,CAAC"}

package/dist/graph/analyze/surface-paths.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Product surface/module path helpers.
+ *
+ * Canonical (FlowGrid docs hub): surfaces/<surface>/CMP-* /...
+ * Legacy: surfaces/<surface>/modules/CMP-* /...
+ */
+/**
+ * Infer `surface/CMP-*` label from a file under the product tree.
+ * Prefers canonical layout; falls back to legacy `modules/` segment.
+ */
+export declare function inferSurfaceFromRepoPath(absPath: string, repoRoot: string): string;
+/** True when path uses the legacy modules/CMP-* segment. */
+export declare function isLegacyModulesCmpPath(filePath: string): boolean;