@shanyucoder/flowgrid 0.1.0

package/dist/docs/scan/ids.js

@@ -0,0 +1,237 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/** Old flat C4 + ADR paths — redirect stubs only (not SSOT). */
+const REDIRECT_STUB_RE = /(?:^|\/)architecture\/(?:landscape|context|containers|dynamics|deployments)(?:\/|$)|(?:^|\/)product\/shared\/adr(?:\/|$)/;
+const ID_RE = /\b((?:CMP|FLOW|DEP|ADR|SC|TC)-[A-Za-z0-9][A-Za-z0-9_-]*|(?:W|API|UI)-[A-Z]{2}-[A-Z0-9]+-\d{3})\b/g;
+/** Scan roots for MD (arc42 × product). */
+export const SCAN_MD_DIRS = [
+    'architecture',
+    'overview',
+    'surfaces',
+];
+/** Canonical home for each ID kind (architecture-core). */
+export const CANONICAL_DIR = {
+    FLOW: 'architecture/03-business-process',
+    DEP: 'architecture/07-deployment',
+    ADR: 'architecture/09-decisions',
+    CMP: 'surfaces',
+    W: 'surfaces',
+    API: 'surfaces',
+    UI: 'surfaces',
+};
+export function kindOf(id) {
+    const p = id.split('-')[0];
+    if (['CMP', 'FLOW', 'DEP', 'ADR', 'W', 'API', 'UI'].includes(p)) {
+        return p;
+    }
+    return 'OTHER';
+}
+export function isRedirectStub(relOrAbs, docsRoot) {
+    const rel = docsRoot
+        ? path.relative(docsRoot, path.isAbsolute(relOrAbs) ? relOrAbs : path.join(docsRoot, relOrAbs))
+        : relOrAbs;
+    return REDIRECT_STUB_RE.test(rel.split(path.sep).join('/'));
+}
+export function walkMdFiles(root, relDirs) {
+    const out = [];
+    for (const rel of relDirs) {
+        const base = path.join(root, rel);
+        if (!fs.existsSync(base))
+            continue;
+        walk(base, out);
+    }
+    return out;
+}
+function walk(dir, out) {
+    for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (ent.name === 'node_modules' || ent.name.startsWith('.'))
+            continue;
+        const p = path.join(dir, ent.name);
+        if (ent.isDirectory())
+            walk(p, out);
+        else if (/\.(md|markdown)$/i.test(ent.name))
+            out.push(p);
+    }
+}
+export function extractIdsFromText(text) {
+    const s = new Set();
+    for (const m of text.matchAll(ID_RE)) {
+        const id = m[1];
+        // DYN-* deprecated — do not index as live IDs
+        if (id.startsWith('DYN-'))
+            continue;
+        s.add(id);
+    }
+    return s;
+}
+function fileRank(docsRoot, id, absFile) {
+    const rel = relToRoot(docsRoot, absFile);
+    if (isRedirectStub(rel))
+        return 100;
+    const kind = kindOf(id);
+    if (kind === 'FLOW' && path.basename(absFile).startsWith(id)) {
+        if (rel.startsWith('architecture/03-business-process') || rel.includes('/common/processes/'))
+            return 0;
+    }
+    const home = CANONICAL_DIR[kind];
+    if (home && rel.startsWith(home)) {
+        if (kind === 'ADR' && path.basename(absFile).startsWith(id.split('-').slice(0, 2).join('-'))) {
+            return 0;
+        }
+        if (kind === 'CMP' && (rel.includes(`/${id}`) || rel.includes(`/${id}/`)))
+            return 0;
+        if ((kind === 'W' || kind === 'API' || kind === 'UI') && rel.includes(`/${id}/`))
+            return 0;
+        return 1;
+    }
+    return 10;
+}
+function sortFiles(docsRoot, id, files) {
+    return [...files].sort((a, b) => fileRank(docsRoot, id, a) - fileRank(docsRoot, id, b) || a.localeCompare(b));
+}
+export function indexIds(docsRoot) {
+    const files = walkMdFiles(docsRoot, [...SCAN_MD_DIRS]).filter((f) => !isRedirectStub(f, docsRoot));
+    const map = new Map();
+    for (const f of files) {
+        const base = path.basename(f, path.extname(f));
+        if (/^FLOW-/.test(base))
+            add(map, base, f);
+        const adr = base.match(/^(ADR-\d+)/);
+        if (adr) {
+            add(map, adr[1], f);
+            add(map, base, f); // ADR-001-arc42-toc slug form
+        }
+        // Hub path: surfaces/<surface>/CMP-*/...
+        // Legacy: surfaces/<surface>/modules/CMP-*/...
+        const cmpFolder = f.match(/[\\/]product[\\/]surfaces[\\/][^\\/]+[\\/](?:modules[\\/])?(CMP-[A-Za-z0-9][A-Za-z0-9_-]*)[\\/]/i);
+        if (cmpFolder) {
+            add(map, cmpFolder[1], f);
+            const short = cmpFolder[1].match(/^(CMP-[A-Za-z0-9]+)/);
+            if (short)
+                add(map, short[1], f);
+        }
+        // Code folders: surfaces/.../CMP-*/<slug>/code/{W|API|UI}-*
+        const codeFolder = f.match(/[\\/]code[\\/]((?:W|API|UI)-[A-Z]{2}-[A-Z0-9]+-\d{3})[\\/]/i);
+        if (codeFolder)
+            add(map, codeFolder[1], f);
+    }
+    for (const f of files) {
+        const text = fs.readFileSync(f, 'utf8');
+        for (const id of extractIdsFromText(text))
+            add(map, id, f);
+    }
+    for (const [id, meta] of map) {
+        meta.files = sortFiles(docsRoot, id, meta.files);
+        meta.primary = meta.files[0];
+    }
+    return map;
+}
+function add(map, id, file) {
+    const existing = map.get(id);
+    if (existing) {
+        if (!existing.files.includes(file))
+            existing.files.push(file);
+    }
+    else {
+        map.set(id, { id, kind: kindOf(id), files: [file] });
+    }
+}
+export function relToRoot(docsRoot, abs) {
+    return path.relative(docsRoot, abs).split(path.sep).join('/');
+}
+function flowMetaFromFile(docsRoot, abs) {
+    const head = fs.existsSync(abs) ? fs.readFileSync(abs, 'utf8').split('\n').slice(0, 12).join('\n') : '';
+    return {
+        id: path.basename(abs, '.md'),
+        file: relToRoot(docsRoot, abs),
+        domain: head.match(/^domain:\s*(.+)$/m)?.[1]?.trim(),
+        status: head.match(/^status:\s*(.+)$/m)?.[1]?.trim(),
+    };
+}
+/** Catalog FLOW-*.md plus LCA common/processes (dedupe by id, catalog wins). */
+export function listFlowProcessFiles(docsRoot) {
+    const byId = new Map();
+    const catalog = path.join(docsRoot, 'architecture/03-business-process');
+    if (fs.existsSync(catalog)) {
+        for (const n of fs.readdirSync(catalog)) {
+            if (!n.startsWith('FLOW-') || !n.endsWith('.md'))
+                continue;
+            const meta = flowMetaFromFile(docsRoot, path.join(catalog, n));
+            byId.set(meta.id, meta);
+        }
+    }
+    const surfaces = path.join(docsRoot, 'surfaces');
+    const walk = (dir) => {
+        if (!fs.existsSync(dir))
+            return;
+        for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (ent.name.startsWith('.') || ent.name === 'node_modules')
+                continue;
+            const p = path.join(dir, ent.name);
+            if (ent.isDirectory()) {
+                if (ent.name === 'processes' && path.basename(dir) === 'common') {
+                    for (const n of fs.readdirSync(p)) {
+                        if (!n.startsWith('FLOW-') || !n.endsWith('.md'))
+                            continue;
+                        const meta = flowMetaFromFile(docsRoot, path.join(p, n));
+                        if (!byId.has(meta.id))
+                            byId.set(meta.id, meta);
+                    }
+                }
+                walk(p);
+            }
+        }
+    };
+    walk(surfaces);
+    return [...byId.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+/** Expected on-disk path for kinds that have a file/folder SSOT. */
+export function expectedCanonicalPath(docsRoot, id) {
+    const kind = kindOf(id);
+    if (kind === 'FLOW') {
+        const catalog = path.join(docsRoot, 'architecture/03-business-process', `${id}.md`);
+        if (fs.existsSync(catalog))
+            return catalog;
+        const listed = listFlowProcessFiles(docsRoot).find((p) => p.id === id);
+        return listed ? path.join(docsRoot, listed.file) : catalog;
+    }
+    if (kind === 'ADR') {
+        const dir = path.join(docsRoot, 'architecture/09-decisions');
+        if (!fs.existsSync(dir))
+            return null;
+        const prefix = id.match(/^(ADR-\d+)/)?.[1] ?? id;
+        const hit = fs.readdirSync(dir).find((n) => n.startsWith(prefix) && n.endsWith('.md'));
+        return hit ? path.join(dir, hit) : path.join(dir, `${id}.md`);
+    }
+    if (kind === 'CMP') {
+        return null; // Too expensive to find canonical CMP here since it's nested deep in surfaces
+    }
+    if (kind === 'W' || kind === 'API' || kind === 'UI') {
+        // Prefer folder under surfaces/**/code/<id>/
+        const hits = [];
+        const walkCode = (dir) => {
+            if (!fs.existsSync(dir))
+                return;
+            for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+                if (ent.name.startsWith('.') || ent.name === 'node_modules')
+                    continue;
+                const p = path.join(dir, ent.name);
+                if (ent.isDirectory()) {
+                    if (ent.name === id)
+                        hits.push(path.join(p, 'index.md'));
+                    else
+                        walkCode(p);
+                }
+            }
+        };
+        walkCode(path.join(docsRoot, 'product'));
+        walkCode(path.join(docsRoot, 'surfaces'));
+        return hits[0] ?? null;
+    }
+    // DEP lives as a heading inside chapter index — return chapter file
+    const chapter = CANONICAL_DIR[kind];
+    if (chapter)
+        return path.join(docsRoot, chapter, 'index.md');
+    return null;
+}
+//# sourceMappingURL=ids.js.map

package/dist/docs/scan/ids.js.map

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

package/dist/docs/scan/links.d.ts

@@ -0,0 +1,10 @@
+import { type HubId } from './ids.js';
+export type LinkHit = {
+    file: string;
+    href: string;
+    ok: boolean;
+    reason?: string;
+};
+export declare function validateMdLinks(docsRoot: string, files: string[]): LinkHit[];
+export declare function depsFromFiles(files: string[], selfId: string): string[];
+export declare function dependentsOf(id: string, index: Map<string, HubId>, docsRoot: string): string[];

package/dist/docs/scan/links.js

@@ -0,0 +1,98 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { extractIdsFromText } from './ids.js';
+const MD_LINK_RE = /\[([^\]]*)\]\(([^)]+)\)/g;
+export function validateMdLinks(docsRoot, files) {
+    const hits = [];
+    for (const file of files) {
+        const text = fs.readFileSync(file, 'utf8');
+        const dir = path.dirname(file);
+        for (const m of text.matchAll(MD_LINK_RE)) {
+            let href = m[2].trim();
+            if (!href || href.startsWith('http') || href.startsWith('mailto:') || href.startsWith('#')) {
+                continue;
+            }
+            // strip hash/query
+            const hash = href.indexOf('#');
+            if (hash >= 0)
+                href = href.slice(0, hash);
+            if (!href)
+                continue;
+            // VitePress absolute from site root
+            let target;
+            if (href.startsWith('/')) {
+                target = path.join(docsRoot, href.replace(/^\//, ''));
+            }
+            else {
+                target = path.resolve(dir, href);
+            }
+            // try as file, as dir/index.md, as .md
+            const ok = resolveExisting(target);
+            hits.push({
+                file,
+                href: m[2].trim(),
+                ok,
+                reason: ok ? undefined : 'missing',
+            });
+        }
+    }
+    return hits.filter((h) => !h.ok);
+}
+function resolveExisting(target) {
+    if (fs.existsSync(target)) {
+        const st = fs.statSync(target);
+        if (st.isFile())
+            return true;
+        if (st.isDirectory()) {
+            if (fs.existsSync(path.join(target, 'index.md')))
+                return true;
+            // non-empty dir (e.g. journeys/) counts as ok for folder links
+            try {
+                if (fs.readdirSync(target).length > 0)
+                    return true;
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    if (fs.existsSync(target + '.md'))
+        return true;
+    if (fs.existsSync(path.join(target, 'index.md')))
+        return true;
+    if (fs.existsSync(target.replace(/\/$/, '') + '.md'))
+        return true;
+    return false;
+}
+export function depsFromFiles(files, selfId) {
+    const deps = new Set();
+    for (const f of files) {
+        if (!fs.existsSync(f))
+            continue;
+        const text = fs.readFileSync(f, 'utf8');
+        for (const id of extractIdsFromText(text)) {
+            if (id !== selfId)
+                deps.add(id);
+        }
+    }
+    return [...deps].sort();
+}
+export function dependentsOf(id, index, docsRoot) {
+    const out = [];
+    for (const [other, meta] of index) {
+        if (other === id)
+            continue;
+        for (const f of meta.files) {
+            const abs = path.isAbsolute(f) ? f : path.join(docsRoot, f);
+            if (!fs.existsSync(abs))
+                continue;
+            const text = fs.readFileSync(abs, 'utf8');
+            if (extractIdsFromText(text).has(id)) {
+                out.push(other);
+                break;
+            }
+        }
+    }
+    return out.sort();
+}
+//# sourceMappingURL=links.js.map

package/dist/docs/scan/links.js.map

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

package/dist/docs/scan/route.d.ts

@@ -0,0 +1,8 @@
+/** Topic → arc42 chapter + skill (architecture-core / C4-SKILL-MCP-NOTES). */
+export type RouteHit = {
+    chapter: string;
+    path: string;
+    skill: string;
+    note?: string;
+};
+export declare function routeTopic(topic: string): RouteHit[];

package/dist/docs/scan/route.js

@@ -0,0 +1,114 @@
+/** Topic → arc42 chapter + skill (architecture-core / C4-SKILL-MCP-NOTES). */
+const ROUTES = [
+    {
+        keys: ['intro', 'introduction', '01', 'scope', 'overview'],
+        hit: {
+            chapter: '01',
+            path: 'overview/',
+            skill: '/overview',
+            note: 'product overview',
+        },
+    },
+    {
+        keys: ['constraint', '02'],
+        hit: { chapter: '02', path: 'architecture/02-constraints/', skill: '/architecture' },
+    },
+    {
+        keys: ['process', 'flow', 'journey', 'sequence', '03'],
+        hit: {
+            chapter: '03',
+            path: 'architecture/03-business-process/',
+            skill: '/business-process',
+        },
+    },
+    {
+        keys: ['strategy', 'solution', '04'],
+        hit: {
+            chapter: '04',
+            path: 'architecture/04-solution-strategy/',
+            skill: '/architecture',
+            note: 'prose → ADR via /decision',
+        },
+    },
+    {
+        keys: ['component', 'cmp', 'module'],
+        hit: { chapter: 'module', path: 'surfaces/', skill: '/module' },
+    },
+    {
+        keys: ['surface', 'channel'],
+        hit: { chapter: 'surface', path: 'surfaces/', skill: '/surfaces' },
+    },
+    {
+        keys: ['deploy', 'dep', '07'],
+        hit: {
+            chapter: '07',
+            path: 'architecture/07-deployment/',
+            skill: '/deployment',
+            note: 'stub-first — do not invent topology',
+        },
+    },
+    {
+        keys: ['cross', 'security', 'observ', 'config', '08'],
+        hit: {
+            chapter: '08',
+            path: 'architecture/08-cross-cutting/',
+            skill: '/cross-cutting',
+        },
+    },
+    {
+        keys: ['adr', 'decision', '09'],
+        hit: { chapter: '09', path: 'architecture/09-decisions/', skill: '/decision' },
+    },
+    {
+        keys: ['quality', '10'],
+        hit: {
+            chapter: '10',
+            path: 'architecture/10-quality/',
+            skill: '/architecture',
+            note: 'stub',
+        },
+    },
+    {
+        keys: ['risk', '11'],
+        hit: {
+            chapter: '11',
+            path: 'architecture/11-risks/',
+            skill: '/architecture',
+            note: 'stub',
+        },
+    },
+    {
+        keys: ['glossary', '12'],
+        hit: {
+            chapter: '12',
+            path: 'architecture/12-glossary/',
+            skill: '/architecture',
+            note: 'stub',
+        },
+    },
+];
+export function routeTopic(topic) {
+    const t = topic.toLowerCase();
+    const hits = [];
+    for (const r of ROUTES) {
+        if (r.keys.some((k) => t.includes(k)))
+            hits.push(r.hit);
+    }
+    if (hits.length === 0) {
+        hits.push({
+            chapter: '?',
+            path: 'architecture/',
+            skill: '/architecture',
+            note: 'No keyword match — ask which layer',
+        });
+    }
+    const seen = new Set();
+    return hits.filter((h) => {
+        const k = h.skill + h.path;
+        if (seen.has(k))
+            return false;
+        seen.add(k);
+        return true;
+    });
+}
+//# sourceMappingURL=route.js.map

package/dist/docs/scan/route.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * Turn user bullet text into draft tags + gaps WITHOUT calling the cloud.
+ *
+ * Heuristics (local-first):
+ * - registries aliasIndex + design shells (FE)
+ * - R2.1 registry-tags lexicon keywordHints (lane fe | be from stack)
+ * - R3.1 via explicit plans lane (not auto here)
+ * - Prior decisions in SQLite raise confidence
+ *
+ * Output is a draft — writing YAML is a later apply step (after member confirm).
+ */
+import type { AnalyzeResult, ArtifactgraphConfig } from '../types.js';
+import type { IndexStore } from '../db/index-store.js';
+/**
+ * @param bullets Free-text lines from the user (BA/dev), not full IR yet
+ */
+export declare function analyzeBullets(repoRoot: string, cfg: ArtifactgraphConfig, bullets: string, store?: IndexStore): AnalyzeResult;

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

@@ -0,0 +1,137 @@
+/**
+ * Turn user bullet text into draft tags + gaps WITHOUT calling the cloud.
+ *
+ * Heuristics (local-first):
+ * - registries aliasIndex + design shells (FE)
+ * - R2.1 registry-tags lexicon keywordHints (lane fe | be from stack)
+ * - R3.1 via explicit plans lane (not auto here)
+ * - Prior decisions in SQLite raise confidence
+ *
+ * Output is a draft — writing YAML is a later apply step (after member confirm).
+ */
+import { loadRegistries } from '../registry/load-registries.js';
+import { suggestTags } from '../lexicon/load-lexicon.js';
+import { inferSuggestLane, isBeStack, isFeStack } from '../lexicon/infer-lane.js';
+/**
+ * @param bullets Free-text lines from the user (BA/dev), not full IR yet
+ */
+export function analyzeBullets(repoRoot, cfg, bullets, store) {
+    const text = bullets.toLowerCase();
+    const regs = loadRegistries(repoRoot, cfg);
+    const draftTags = [];
+    const gaps = [];
+    const askUser = [];
+    const lane = inferSuggestLane(cfg);
+    const fe = isFeStack(cfg);
+    const be = isBeStack(cfg);
+    let profile = 'unknown';
+    if (/(list|table|search|filter|danh sách|bảng)/i.test(bullets))
+        profile = 'list';
+    else if (/(create|form|new|tạo|form nhập)/i.test(bullets))
+        profile = 'create';
+    else if (/(detail|show|chi tiết)/i.test(bullets))
+        profile = 'detail';
+    const fromLex = suggestTags({ repoRoot, cfg, lane, bullets, limit: 16 });
+    if (fromLex.draftTags.length) {
+        draftTags.push(...fromLex.draftTags);
+    }
+    else if (fe && profile === 'list') {
+        draftTags.push('#shell: DataListPage', '#pattern: CRUD', '#style: shadcn/ui');
+    }
+    else if (fe && profile === 'create') {
+        draftTags.push('#shell: DataFormPage', '#pattern: CRUD', '#style: shadcn/ui');
+    }
+    else if (fe && profile === 'detail') {
+        draftTags.push('#shell: DataDetailPage', '#pattern: CRUD', '#style: shadcn/ui');
+    }
+    if (fe) {
+        for (const [alias, canonical] of Object.entries(regs.aliasToCanonical)) {
+            if (alias.length < 4)
+                continue;
+            if (text.includes(alias)) {
+                if (regs.designShells.includes(canonical)) {
+                    draftTags.push(`#shell: ${canonical}`);
+                }
+                else {
+                    draftTags.push(`#ui: ${canonical}`);
+                }
+            }
+        }
+        if (/(status|trạng thái).*(chip|badge|tag)/i.test(bullets)) {
+            const tag = '#needs-component: cell-status:MoStatusChip:label';
+            const remembered = store?.findDecisions('column:status') ?? [];
+            const confidence = remembered.length ? 0.92 : 0.75;
+            draftTags.push(tag);
+            gaps.push({
+                kind: 'needs-component',
+                message: 'Bullets mention status chip — draft needs-component',
+                suggestedTag: tag,
+                severity: 'warn',
+                confidence,
+            });
+            if (confidence < 0.85) {
+                askUser.push(`[GRILL-MARK] Status column: A) plain text  B) ${tag}  C) defer`);
+            }
+        }
+    }
+    if (be) {
+        if (/(endpoint|route|controller|api resource)/i.test(bullets) && !draftTags.some((t) => t.includes('#needs-endpoint'))) {
+            const tag = '#needs-endpoint';
+            draftTags.push(tag);
+            gaps.push({
+                kind: 'registry-miss',
+                message: 'Bullets mention API surface — draft needs-endpoint',
+                suggestedTag: tag,
+                severity: 'warn',
+                confidence: 0.72,
+            });
+            askUser.push(`[GRILL-MARK] API scope: A) mark ${tag}  B) defer`);
+        }
+        if (/(dto|request body|response|validator|payload)/i.test(bullets) && !draftTags.some((t) => t.includes('#needs-dto'))) {
+            const tag = '#needs-dto';
+            draftTags.push(tag);
+            gaps.push({
+                kind: 'registry-miss',
+                message: 'Bullets mention DTO/validation — draft needs-dto',
+                suggestedTag: tag,
+                severity: 'warn',
+                confidence: 0.7,
+            });
+        }
+    }
+    if (profile === 'unknown' && !fromLex.draftTags.length) {
+        gaps.push({
+            kind: 'missing-codegen-profile',
+            message: be
+                ? 'Could not infer REST action (index/store/show/…) — need clarifying question or cloud'
+                : 'Could not infer list/create/detail from bullets — need clarifying question or cloud',
+            severity: 'error',
+            confidence: 0.4,
+        });
+        askUser.push(be ? 'REST action? index | store | show | update | destroy | other' : 'Profile? list | create | detail | other');
+    }
+    const uniqueDraft = [...new Set(draftTags)];
+    const cloudPromptSlice = [
+        '## bullet analyze (local)',
+        `lane: ${lane}`,
+        `inferred profile: ${profile}`,
+        `draft tags: ${uniqueDraft.join(', ') || '(none)'}`,
+        fromLex.sourcePaths.length
+            ? `lexicon: ${fromLex.sourcePaths.join(', ')}`
+            : 'lexicon: (not configured)',
+        ...gaps.filter((g) => g.confidence < 0.8).map((g) => `- ${g.message}`),
+        '',
+        '### user bullets',
+        bullets.trim().slice(0, 2000),
+    ].join('\n');
+    return {
+        projectId: cfg.projectId,
+        repoRoot,
+        tags: [],
+        draftTags: uniqueDraft,
+        gaps,
+        askUser,
+        cloudPromptSlice,
+    };
+}
+//# sourceMappingURL=analyze-bullets.js.map