pcl-mcp 0.1.0

package/dist/src/scanner.js

@@ -0,0 +1,290 @@
+// src/scanner.ts
+// Scan repo for existing .md files, classify them by PCL type, and transform into product/ structure.
+import { readdir, readFile, stat, writeFile, access, mkdir } from "node:fs/promises";
+import { join, relative, basename, dirname, extname } from "node:path";
+import { constants } from "node:fs";
+import matter from "gray-matter";
+// ─── Constants ───────────────────────────────────────────────────────────────
+const SKIP_DIRS = new Set([
+    "node_modules", "dist", ".git", "product", ".next", ".nuxt",
+    ".output", "build", "coverage", "__pycache__", ".cache",
+]);
+const SKIP_FILES = new Set([
+    "CLAUDE.md", "CHANGELOG.md", "LICENSE.md", "LICENSE",
+    "CODE_OF_CONDUCT.md", "CONTRIBUTING.md", "SECURITY.md",
+]);
+const TYPE_PLURAL = {
+    product: "",
+    persona: "personas",
+    journey: "journeys",
+    spec: "specs",
+    decision: "decisions",
+    domain: "domain",
+};
+const RULES = [
+    {
+        type: "persona",
+        dirs: /^(personas?|users?|user-research)$/i,
+        files: /^(persona-.*|.*-persona)\.md$/i,
+        fmKeys: ["role", "primary_goal", "jobs_to_be_done", "biggest_fear"],
+        contentPatterns: [
+            /primary goal/i, /jobs to be done/i, /anti[- ]?patterns?/i, /tech level/i,
+        ],
+    },
+    {
+        type: "journey",
+        dirs: /^(journeys?|user-journeys?|flows?)$/i,
+        files: /^(journey-.*|.*-journey|.*-flow)\.md$/i,
+        fmKeys: ["trigger", "success_state", "steps", "failure_modes"],
+        contentPatterns: [
+            /user journey/i, /\btrigger\b/i, /success state/i, /failure mode/i,
+        ],
+    },
+    {
+        type: "spec",
+        dirs: /^(specs?|specifications?|features?|requirements?)$/i,
+        files: /^(spec-.*|.*-spec|feature-.*|.*-feature|.*-requirement)\.md$/i,
+        fmKeys: ["acceptance_criteria", "out_of_scope", "design_ref"],
+        contentPatterns: [
+            /acceptance criteria/i, /out of scope/i, /\brequirement\b/i,
+        ],
+    },
+    {
+        type: "decision",
+        dirs: /^(decisions?|adrs?|architecture-decisions?)$/i,
+        files: /^(adr-.*|.*-adr|decision-.*)\.md$/i,
+        fmKeys: ["context", "decision", "consequences"],
+        contentPatterns: [
+            /architecture decision/i, /alternatives rejected/i, /\bconsequences?\b/i,
+        ],
+    },
+    {
+        type: "domain",
+        dirs: /^(domain|rules?|business-rules?|policies?)$/i,
+        files: /^(rules-.*|.*-rules|policy-.*)\.md$/i,
+        fmKeys: ["critical"],
+        contentPatterns: [
+            /business rule/i, /\binvariant\b/i, /must never/i, /must always/i,
+        ],
+    },
+    {
+        type: "product",
+        dirs: /(?!)/, // never matches on dir alone
+        files: /^(product|product-brief.*|product-overview.*)\.md$/i,
+        fmKeys: ["tagline", "problem", "solution", "tech_stack", "primary_persona"],
+        contentPatterns: [
+            /north star/i, /\bvision\b/i, /what this product is/i,
+        ],
+    },
+];
+// ─── 1a. scanRepo — find all .md files ───────────────────────────────────────
+export async function scanRepo(rootDir) {
+    const results = [];
+    async function walk(dir) {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (SKIP_DIRS.has(entry.name) || entry.name.startsWith("."))
+                    continue;
+                await walk(fullPath);
+            }
+            else if (entry.isFile() && extname(entry.name) === ".md") {
+                if (SKIP_FILES.has(entry.name))
+                    continue;
+                results.push({
+                    path: fullPath,
+                    relativePath: relative(rootDir, fullPath),
+                });
+            }
+        }
+    }
+    await walk(rootDir);
+    return results;
+}
+// ─── 1b. classifyFile — heuristic classification ─────────────────────────────
+export function classifyFile(filePath, fm, body) {
+    const fileName = basename(filePath);
+    const dirName = basename(dirname(filePath));
+    const fmKeys = Object.keys(fm);
+    let bestType = null;
+    let bestScore = 0;
+    for (const rule of RULES) {
+        let score = 0;
+        // Directory name match (high weight: 0.4)
+        if (rule.dirs.test(dirName)) {
+            score += 0.4;
+        }
+        // Filename match (medium weight: 0.25)
+        if (rule.files.test(fileName)) {
+            score += 0.25;
+        }
+        // Frontmatter keys match (high weight: up to 0.4)
+        const fmMatches = rule.fmKeys.filter((k) => fmKeys.includes(k)).length;
+        if (rule.fmKeys.length > 0 && fmMatches > 0) {
+            // Need at least 2 fm key matches for decision type to avoid false positives
+            // (many files have a generic "context" or "decision" key)
+            const minMatches = rule.type === "decision" ? 2 : 1;
+            if (fmMatches >= minMatches) {
+                score += 0.4 * (fmMatches / rule.fmKeys.length);
+            }
+        }
+        // Content keyword match (low weight: up to 0.15)
+        const contentMatches = rule.contentPatterns.filter((p) => p.test(body)).length;
+        if (contentMatches > 0) {
+            score += 0.15 * (contentMatches / rule.contentPatterns.length);
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestType = rule.type;
+        }
+    }
+    // Minimum threshold to classify
+    if (bestType === null || bestScore < 0.25)
+        return null;
+    return { type: bestType, confidence: Math.min(bestScore, 1) };
+}
+// ─── 1c. transformFile — generate PCL frontmatter ────────────────────────────
+function slugify(str) {
+    return str
+        .toLowerCase()
+        .replace(/\.md$/, "")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+function extractFirstHeading(body) {
+    const match = body.match(/^#\s+(.+)$/m);
+    return match ? match[1].trim() : null;
+}
+export function transformFile(filePath, fm, body, type, mtime) {
+    const fileName = basename(filePath, ".md");
+    const slug = slugify(fileName);
+    const heading = extractFirstHeading(body);
+    const newFm = { ...fm };
+    switch (type) {
+        case "persona":
+            newFm.id ??= slug;
+            newFm.name ??= fm.title ?? heading ?? fileName;
+            newFm.role ??= "";
+            newFm.primary_goal ??= "";
+            newFm.jobs_to_be_done ??= [];
+            newFm.anti_patterns ??= [];
+            newFm.channels ??= [];
+            break;
+        case "journey":
+            newFm.id ??= slug;
+            newFm.name ??= fm.title ?? heading ?? fileName;
+            newFm.persona ??= "";
+            newFm.trigger ??= "";
+            newFm.success_state ??= "";
+            newFm.failure_modes ??= [];
+            newFm.steps ??= [];
+            break;
+        case "spec":
+            newFm.id ??= slug;
+            newFm.title ??= fm.name ?? heading ?? fileName;
+            newFm.status ??= "draft";
+            newFm.acceptance_criteria ??= [];
+            newFm.out_of_scope ??= [];
+            break;
+        case "decision":
+            newFm.id ??= slug;
+            newFm.title ??= fm.name ?? heading ?? fileName;
+            newFm.status ??= "accepted";
+            newFm.date ??= mtime.toISOString().slice(0, 10);
+            newFm.context ??= "";
+            newFm.decision ??= "";
+            newFm.consequences ??= [];
+            newFm.alternatives_rejected ??= [];
+            break;
+        case "domain":
+            newFm.id ??= slug;
+            newFm.critical ??= false;
+            newFm.title ??= fm.name ?? heading ?? fileName;
+            break;
+        case "product":
+            newFm.name ??= fm.title ?? heading ?? fileName;
+            newFm.tagline ??= "";
+            newFm.problem ??= "";
+            newFm.solution ??= "";
+            newFm.primary_persona ??= "";
+            newFm.tech_stack ??= [];
+            newFm.stage ??= "prototype";
+            break;
+    }
+    // Determine target path
+    const subDir = TYPE_PLURAL[type];
+    const targetPath = subDir
+        ? join(subDir, `${slug}.md`)
+        : "product.md";
+    return { frontmatter: newFm, body, targetPath };
+}
+// ─── 1d. runScan — orchestrate ───────────────────────────────────────────────
+export async function runScan(rootDir, productDir) {
+    const summary = {
+        imported: [],
+        skipped: [],
+        unclassified: [],
+    };
+    console.log(`Scanning ${rootDir}...`);
+    const files = await scanRepo(rootDir);
+    console.log(`Found ${files.length} markdown file${files.length === 1 ? "" : "s"}\n`);
+    if (files.length === 0)
+        return summary;
+    console.log("Classified:");
+    for (const file of files) {
+        const raw = await readFile(file.path, "utf8");
+        const parsed = matter(raw);
+        const fm = parsed.data;
+        const classification = classifyFile(file.path, fm, parsed.content);
+        if (!classification) {
+            summary.unclassified.push(file.relativePath);
+            continue;
+        }
+        const { type, confidence } = classification;
+        const fileStat = await stat(file.path);
+        const transformed = transformFile(file.path, fm, parsed.content, type, fileStat.mtime);
+        const destPath = join(productDir, transformed.targetPath);
+        const destRelative = relative(rootDir, destPath);
+        // Check if target already exists
+        try {
+            await access(destPath, constants.F_OK);
+            console.log(`  ↷ ${destRelative} already exists, skipped`);
+            summary.skipped.push({
+                sourcePath: file.relativePath,
+                targetPath: transformed.targetPath,
+                type,
+                confidence,
+            });
+            continue;
+        }
+        catch {
+            // File doesn't exist — proceed
+        }
+        // Ensure target directory exists
+        await mkdir(dirname(destPath), { recursive: true });
+        // Write the transformed file
+        const output = matter.stringify(transformed.body, transformed.frontmatter);
+        await writeFile(destPath, output, "utf8");
+        console.log(`  ✓ ${file.relativePath} → ${destRelative} [${type}, confidence: ${confidence.toFixed(2)}]`);
+        summary.imported.push({
+            sourcePath: file.relativePath,
+            targetPath: transformed.targetPath,
+            type,
+            confidence,
+        });
+    }
+    // Print unclassified
+    if (summary.unclassified.length > 0) {
+        console.log("\nSkipped (not classifiable):");
+        for (const path of summary.unclassified) {
+            console.log(`  · ${path}`);
+        }
+    }
+    const skipCount = summary.skipped.length;
+    console.log(`\nSummary: ${summary.imported.length} imported, ` +
+        `${skipCount} skipped (exists), ` +
+        `${summary.unclassified.length} unclassified`);
+    return summary;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/src/scanner.js.map

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

package/dist/src/schemas.d.ts

@@ -0,0 +1,184 @@
+import { z } from "zod";
+import type { FileType } from "./types.js";
+export declare const ProductSchema: z.ZodObject<{
+    name: z.ZodString;
+    tagline: z.ZodString;
+    problem: z.ZodString;
+    solution: z.ZodString;
+    primary_persona: z.ZodString;
+    tech_stack: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    stage: z.ZodEnum<["idea", "prototype", "early_revenue", "growth", "mature"]>;
+    repo: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    tagline: string;
+    problem: string;
+    solution: string;
+    primary_persona: string;
+    tech_stack: string[];
+    stage: "idea" | "prototype" | "early_revenue" | "growth" | "mature";
+    repo?: string | undefined;
+    url?: string | undefined;
+}, {
+    name: string;
+    tagline: string;
+    problem: string;
+    solution: string;
+    primary_persona: string;
+    stage: "idea" | "prototype" | "early_revenue" | "growth" | "mature";
+    tech_stack?: string[] | undefined;
+    repo?: string | undefined;
+    url?: string | undefined;
+}>;
+export declare const PersonaSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    role: z.ZodString;
+    age_range: z.ZodOptional<z.ZodString>;
+    tech_level: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    primary_goal: z.ZodString;
+    biggest_fear: z.ZodOptional<z.ZodString>;
+    jobs_to_be_done: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    anti_patterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    channels: string[];
+    name: string;
+    id: string;
+    role: string;
+    primary_goal: string;
+    jobs_to_be_done: string[];
+    anti_patterns: string[];
+    age_range?: string | undefined;
+    tech_level?: "low" | "medium" | "high" | undefined;
+    biggest_fear?: string | undefined;
+}, {
+    name: string;
+    id: string;
+    role: string;
+    primary_goal: string;
+    channels?: string[] | undefined;
+    age_range?: string | undefined;
+    tech_level?: "low" | "medium" | "high" | undefined;
+    biggest_fear?: string | undefined;
+    jobs_to_be_done?: string[] | undefined;
+    anti_patterns?: string[] | undefined;
+}>;
+export declare const JourneyStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    goal: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    goal: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    goal: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const JourneySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    persona: z.ZodString;
+    trigger: z.ZodString;
+    success_state: z.ZodString;
+    failure_modes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    steps: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    persona: string;
+    id: string;
+    trigger: string;
+    success_state: string;
+    failure_modes: string[];
+    steps: string[];
+    name?: string | undefined;
+}, {
+    persona: string;
+    id: string;
+    trigger: string;
+    success_state: string;
+    steps: string[];
+    name?: string | undefined;
+    failure_modes?: string[] | undefined;
+}>;
+export declare const SpecSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    persona: z.ZodOptional<z.ZodString>;
+    journey: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["draft", "approved", "in-progress", "done", "deprecated"]>;
+    acceptance_criteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    out_of_scope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    design_ref: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "draft" | "approved" | "in-progress" | "done" | "deprecated";
+    id: string;
+    title: string;
+    acceptance_criteria: string[];
+    out_of_scope: string[];
+    persona?: string | undefined;
+    journey?: string | undefined;
+    design_ref?: string | undefined;
+}, {
+    status: "draft" | "approved" | "in-progress" | "done" | "deprecated";
+    id: string;
+    title: string;
+    persona?: string | undefined;
+    journey?: string | undefined;
+    acceptance_criteria?: string[] | undefined;
+    out_of_scope?: string[] | undefined;
+    design_ref?: string | undefined;
+}>;
+export declare const DecisionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodEnum<["proposed", "accepted", "deprecated", "superseded"]>;
+    date: z.ZodString;
+    context: z.ZodString;
+    decision: z.ZodString;
+    consequences: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    alternatives_rejected: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    superseded_by: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    decision: string;
+    status: "deprecated" | "proposed" | "accepted" | "superseded";
+    date: string;
+    id: string;
+    title: string;
+    context: string;
+    consequences: string[];
+    alternatives_rejected: string[];
+    superseded_by?: string | undefined;
+}, {
+    decision: string;
+    status: "deprecated" | "proposed" | "accepted" | "superseded";
+    date: string;
+    id: string;
+    title: string;
+    context: string;
+    consequences?: string[] | undefined;
+    alternatives_rejected?: string[] | undefined;
+    superseded_by?: string | undefined;
+}>;
+export declare const DomainSchema: z.ZodObject<{
+    id: z.ZodString;
+    critical: z.ZodDefault<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    critical: boolean;
+    title?: string | undefined;
+}, {
+    id: string;
+    title?: string | undefined;
+    critical?: boolean | undefined;
+}>;
+export declare const SCHEMAS: Record<FileType, z.ZodObject<z.ZodRawShape>>;
+export declare function validateFrontmatter(type: FileType, data: unknown): {
+    success: true;
+    data: Record<string, unknown>;
+} | {
+    success: false;
+    error: string;
+};
+export declare function deriveTitle(type: FileType, fm: Record<string, unknown>): string;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/src/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/schemas.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAS3C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUxB,CAAC;AAIH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWxB,CAAC;AAIH,eAAO,MAAM,iBAAiB;;;;;;;;;gCAGd,CAAC;AAEjB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;EAQxB,CAAC;AAIH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;EASrB,CAAC;AAIH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUzB,CAAC;AAIH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAIvB,CAAC;AAIH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAOhE,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,OAAO,GACZ;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAUtF;AAGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQ/E"}

package/dist/src/schemas.js

@@ -0,0 +1,113 @@
+// src/schemas.ts
+// Zod schemas for every file type.
+// These are the contracts — agents rely on predictable structure.
+import { z } from "zod";
+// ─── Shared ───────────────────────────────────────────────────────────────────
+const StringList = z.array(z.string()).default([]);
+const OptStr = z.string().optional();
+// ─── product.md ───────────────────────────────────────────────────────────────
+export const ProductSchema = z.object({
+    name: z.string(),
+    tagline: z.string(),
+    problem: z.string(),
+    solution: z.string(),
+    primary_persona: z.string(),
+    tech_stack: StringList,
+    stage: z.enum(["idea", "prototype", "early_revenue", "growth", "mature"]),
+    repo: OptStr,
+    url: OptStr,
+});
+// ─── personas/*.md ────────────────────────────────────────────────────────────
+export const PersonaSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    role: z.string(),
+    age_range: OptStr,
+    tech_level: z.enum(["low", "medium", "high"]).optional(),
+    primary_goal: z.string(),
+    biggest_fear: OptStr,
+    jobs_to_be_done: StringList,
+    anti_patterns: StringList,
+    channels: StringList, // where they hang out
+});
+// ─── journeys/*.md ────────────────────────────────────────────────────────────
+export const JourneyStepSchema = z.object({
+    id: z.string(),
+    goal: OptStr,
+}).passthrough(); // allow extra step-level keys
+export const JourneySchema = z.object({
+    id: z.string(),
+    name: z.string().optional(),
+    persona: z.string(),
+    trigger: z.string(),
+    success_state: z.string(),
+    failure_modes: StringList,
+    steps: z.array(z.string()), // ordered list of step IDs
+});
+// ─── specs/*.md ───────────────────────────────────────────────────────────────
+export const SpecSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    persona: z.string().optional(),
+    journey: z.string().optional(), // links to journey ID
+    status: z.enum(["draft", "approved", "in-progress", "done", "deprecated"]),
+    acceptance_criteria: StringList,
+    out_of_scope: StringList,
+    design_ref: OptStr, // Figma URL or local path
+});
+// ─── decisions/*.md ───────────────────────────────────────────────────────────
+export const DecisionSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    status: z.enum(["proposed", "accepted", "deprecated", "superseded"]),
+    date: z.string(), // ISO date string
+    context: z.string(),
+    decision: z.string(),
+    consequences: StringList,
+    alternatives_rejected: StringList,
+    superseded_by: OptStr,
+});
+// ─── domain/*.md ──────────────────────────────────────────────────────────────
+export const DomainSchema = z.object({
+    id: z.string(),
+    critical: z.boolean().default(false), // if true, always loaded at session start
+    title: z.string().optional(),
+});
+// ─── Schema registry ──────────────────────────────────────────────────────────
+export const SCHEMAS = {
+    product: ProductSchema,
+    persona: PersonaSchema,
+    journey: JourneySchema,
+    spec: SpecSchema,
+    decision: DecisionSchema,
+    domain: DomainSchema,
+};
+export function validateFrontmatter(type, data) {
+    const schema = SCHEMAS[type];
+    const result = schema.safeParse(data);
+    if (result.success)
+        return { success: true, data: result.data };
+    return {
+        success: false,
+        error: result.error.issues
+            .map((i) => `${i.path.join(".")}: ${i.message}`)
+            .join("; "),
+    };
+}
+// Derive a display title from frontmatter
+export function deriveTitle(type, fm) {
+    if (type === "product")
+        return String(fm.name ?? "Untitled product");
+    if (type === "persona")
+        return String(fm.name ?? fm.id ?? "Unnamed persona");
+    if (type === "journey")
+        return String(fm.name ?? fm.id ?? "Unnamed journey");
+    if (type === "spec")
+        return String(fm.title ?? fm.id ?? "Unnamed spec");
+    if (type === "decision")
+        return String(fm.title ?? fm.id ?? "Unnamed decision");
+    if (type === "domain")
+        return String(fm.title ?? fm.id ?? "Domain rules");
+    return "Unknown";
+}
+//# sourceMappingURL=schemas.js.map

package/dist/src/schemas.js.map

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

package/dist/src/search.d.ts

@@ -0,0 +1,10 @@
+import type Database from "better-sqlite3";
+import type { SearchResult } from "./types.js";
+export type SearchMode = "hybrid" | "semantic" | "keyword";
+export declare function search(db: Database.Database, query: string, opts?: {
+    mode?: SearchMode;
+    topK?: number;
+    types?: string[];
+}): Promise<SearchResult[]>;
+export declare function findRelated(db: Database.Database, sourceId: string, topK?: number): Promise<SearchResult[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/src/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/search.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAe,YAAY,EAAa,MAAM,YAAY,CAAC;AA2CvE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3D,wBAAsB,MAAM,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IACJ,IAAI,CAAC,EAAK,UAAU,CAAC;IACrB,IAAI,CAAC,EAAK,MAAM,CAAC;IACjB,KAAK,CAAC,EAAI,MAAM,EAAE,CAAC;CACf,GACL,OAAO,CAAC,YAAY,EAAE,CAAC,CAwCzB;AAID,wBAAsB,WAAW,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,SAAI,GACP,OAAO,CAAC,YAAY,EAAE,CAAC,CA4BzB"}