design-brain-memory 0.2.0

package/dist/commands.js

@@ -0,0 +1,178 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { captureDesignFromImage } from './extractFromImage.js';
+import { captureDesignFromUrl } from './extractFromUrl.js';
+import { enrichWithLlm } from './llm.js';
+import { askDesignBrain, searchDesignBrain } from './query.js';
+import { renderAll } from './render.js';
+import { ensureBrainExists, ensureProject, loadDatabase, projectAssetDir, saveDatabase, } from './store.js';
+import { makeId, normalizeUrl, nowIso, slugify, stableHash, unique } from './util.js';
+function computeFingerprint(input) {
+    const basis = {
+        url: input.url ? normalizeUrl(input.url) : null,
+        topColors: input.analysis.colors.slice(0, 20).map((color) => color.hex.toUpperCase()),
+        componentKinds: input.analysis.components.slice(0, 40).map((component) => component.kind),
+        layout: input.analysis.layout.slice(0, 20).map((layout) => `${layout.tag}:${layout.role}`),
+        motion: input.analysis.motion.slice(0, 20).map((motion) => `${motion.transition}|${motion.animation}`),
+    };
+    return stableHash(JSON.stringify(basis));
+}
+function buildDiff(previous, next) {
+    const previousColors = new Set(previous.analysis.colors.map((color) => color.hex.toUpperCase()));
+    const nextColors = new Set(next.colors.map((color) => color.hex.toUpperCase()));
+    const addedColors = [...nextColors].filter((color) => !previousColors.has(color)).slice(0, 30);
+    const removedColors = [...previousColors].filter((color) => !nextColors.has(color)).slice(0, 30);
+    return {
+        previousId: previous.id,
+        addedColors,
+        removedColors,
+        componentCountDelta: next.components.length - previous.analysis.components.length,
+        motionCountDelta: next.motion.length - previous.analysis.motion.length,
+    };
+}
+function resolvePreviousVersion(projectInspirations, fingerprint) {
+    const versions = projectInspirations
+        .filter((entry) => entry.fingerprint === fingerprint)
+        .sort((a, b) => a.capturedAt.localeCompare(b.capturedAt));
+    return versions.at(-1);
+}
+function mergeTags(...lists) {
+    return unique(lists
+        .flat()
+        .map((tag) => slugify(tag))
+        .filter((tag) => tag.length > 0));
+}
+export async function initBrain(rootDir) {
+    await ensureBrainExists(rootDir);
+    const db = await loadDatabase(rootDir);
+    await renderAll(rootDir, db);
+}
+export async function ingestInspiration(options) {
+    if (!options.url && !options.screenshot) {
+        throw new Error('Provide either --url or --screenshot');
+    }
+    if (options.url && options.screenshot) {
+        throw new Error('Use either --url or --screenshot, not both');
+    }
+    await ensureBrainExists(options.rootDir);
+    const db = await loadDatabase(options.rootDir);
+    const project = ensureProject(db, {
+        projectId: options.project,
+        projectName: options.projectName,
+        description: options.projectDescription,
+    });
+    const inspirationName = options.name?.trim() || options.url || options.screenshot || 'inspiration';
+    const inspirationId = makeId('inspo', inspirationName);
+    const assetDir = projectAssetDir(options.rootDir, project.id);
+    await fs.ensureDir(assetDir);
+    let screenshotPath;
+    let analysis;
+    if (options.url) {
+        screenshotPath = path.join(assetDir, `${inspirationId}.png`);
+        const sessionName = `designbrain-${project.id}-${Date.now().toString(36)}`;
+        analysis = await captureDesignFromUrl({
+            url: options.url,
+            sessionName,
+            screenshotPath,
+            workingDir: options.rootDir,
+            journeySteps: options.journeySteps,
+            responsiveViewports: options.responsiveViewports,
+        });
+    }
+    else {
+        const source = path.resolve(options.rootDir, options.screenshot);
+        const ext = path.extname(source) || '.png';
+        screenshotPath = path.join(assetDir, `${inspirationId}${ext}`);
+        await fs.copy(source, screenshotPath);
+        analysis = await captureDesignFromImage({
+            imagePath: screenshotPath,
+            sourceName: inspirationName,
+            notes: options.notes,
+            llm: options.llm,
+        });
+    }
+    let llmEnrichment;
+    if (options.llm) {
+        llmEnrichment = await enrichWithLlm({
+            llm: options.llm,
+            sourceName: inspirationName,
+            sourceUrl: options.url,
+            notes: options.notes,
+            fallbackSummary: options.inspirationSummary,
+            analysis,
+        });
+    }
+    const fingerprint = computeFingerprint({
+        url: options.url,
+        analysis,
+    });
+    const previousVersion = resolvePreviousVersion(project.inspirations, fingerprint);
+    const version = previousVersion ? previousVersion.version + 1 : 1;
+    const mergedTags = mergeTags(options.tags, llmEnrichment?.suggestedTags ?? []);
+    const inspirationSummary = options.inspirationSummary
+        || llmEnrichment?.summary
+        || undefined;
+    const record = {
+        id: inspirationId,
+        name: inspirationName,
+        sourceType: options.url ? 'url' : 'screenshot',
+        url: options.url,
+        originalImagePath: options.screenshot ? path.resolve(options.rootDir, options.screenshot) : undefined,
+        screenshotPath,
+        capturedAt: nowIso(),
+        tags: mergedTags,
+        notes: options.notes,
+        inspirationSummary,
+        llmEnrichment,
+        fingerprint,
+        version,
+        supersedes: previousVersion?.id,
+        diffFromPrevious: previousVersion ? buildDiff(previousVersion, analysis) : undefined,
+        analysis,
+    };
+    project.inspirations.push(record);
+    project.updatedAt = nowIso();
+    await saveDatabase(options.rootDir, db);
+    await renderAll(options.rootDir, db, options.skipVisuals);
+    return { projectId: project.id, inspirationId };
+}
+export async function recordOutcome(options) {
+    if (!options.title.trim()) {
+        throw new Error('--title is required');
+    }
+    if (!options.description.trim()) {
+        throw new Error('--description is required');
+    }
+    await ensureBrainExists(options.rootDir);
+    const db = await loadDatabase(options.rootDir);
+    const project = ensureProject(db, {
+        projectId: options.project,
+    });
+    const outcomeId = makeId('outcome', options.title);
+    const knownInspirationIds = new Set(project.inspirations.map((entry) => entry.id));
+    const inspiredBy = options.inspiredBy.filter((id) => knownInspirationIds.has(id));
+    project.outcomes.push({
+        id: outcomeId,
+        title: options.title,
+        description: options.description,
+        inspiredBy,
+        artifactUrl: options.artifactUrl,
+        createdAt: nowIso(),
+        tags: unique(options.tags.map((tag) => slugify(tag)).filter(Boolean)),
+    });
+    project.updatedAt = nowIso();
+    await saveDatabase(options.rootDir, db);
+    await renderAll(options.rootDir, db);
+    return { projectId: project.id, outcomeId };
+}
+export async function reindexBrain(rootDir, skipVisuals = false) {
+    const db = await loadDatabase(rootDir);
+    await renderAll(rootDir, db, skipVisuals);
+}
+export async function searchBrain(params) {
+    return searchDesignBrain(params);
+}
+export async function askBrain(params) {
+    return askDesignBrain(params);
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/extractFromImage.d.ts

@@ -0,0 +1,7 @@
+import type { DesignAnalysis, LlmConfig } from './types.js';
+export declare function captureDesignFromImage(params: {
+    imagePath: string;
+    sourceName: string;
+    notes?: string;
+    llm?: LlmConfig;
+}): Promise<DesignAnalysis>;

package/dist/extractFromImage.js

@@ -0,0 +1,72 @@
+import fs from 'fs-extra';
+import sharp from 'sharp';
+import { enrichImageWithLlmVision } from './llm.js';
+function channelBucket(value) {
+    return Math.max(0, Math.min(255, Math.round(value / 16) * 16));
+}
+function toHex(value) {
+    return Math.max(0, Math.min(255, value)).toString(16).padStart(2, '0');
+}
+function collectTopColors(raw, channels) {
+    const frequency = new Map();
+    for (let i = 0; i < raw.length; i += channels * 4) {
+        const r = channelBucket(raw[i] ?? 0);
+        const g = channelBucket(raw[i + 1] ?? 0);
+        const b = channelBucket(raw[i + 2] ?? 0);
+        const hex = `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+        const entry = frequency.get(hex) ?? { hex, count: 0, samples: [] };
+        entry.count += 1;
+        frequency.set(hex, entry);
+    }
+    return [...frequency.values()]
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 30)
+        .map((token) => ({
+        hex: token.hex,
+        count: token.count,
+        samples: ['image-palette'],
+    }));
+}
+export async function captureDesignFromImage(params) {
+    await fs.access(params.imagePath);
+    const image = sharp(params.imagePath);
+    const metadata = await image.metadata();
+    const resized = await image
+        .resize({ width: 280, height: 280, fit: 'inside', withoutEnlargement: true })
+        .removeAlpha()
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    const colors = collectTopColors(resized.data, resized.info.channels);
+    const base = {
+        pageTitle: metadata.format ? `Image source (${metadata.format})` : 'Image source',
+        pageUrl: undefined,
+        viewport: {
+            width: metadata.width ?? 0,
+            height: metadata.height ?? 0,
+        },
+        colors,
+        typography: [],
+        components: [],
+        motion: [],
+        layout: [],
+        cssVariables: {},
+        accessibilitySnapshot: undefined,
+    };
+    if (!params.llm) {
+        return base;
+    }
+    const vision = await enrichImageWithLlmVision({
+        llm: params.llm,
+        imagePath: params.imagePath,
+        sourceName: params.sourceName,
+        notes: params.notes,
+    });
+    return {
+        ...base,
+        components: vision.components,
+        typography: vision.typography,
+        motion: vision.motion,
+        layout: vision.layout,
+    };
+}
+//# sourceMappingURL=extractFromImage.js.map

package/dist/extractFromImage.js.map

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

package/dist/extractFromUrl.d.ts

@@ -0,0 +1,13 @@
+import type { DesignAnalysis } from './types.js';
+export declare function captureDesignFromUrl(params: {
+    url: string;
+    sessionName: string;
+    screenshotPath: string;
+    workingDir: string;
+    journeySteps?: number;
+    responsiveViewports?: Array<{
+        label: string;
+        width: number;
+        height: number;
+    }>;
+}): Promise<DesignAnalysis>;