aimeat 1.40.1 → 2.1.0

package/dist/src/services/appdev-kb.js

@@ -0,0 +1,178 @@
+/**
+ * @file appdev-kb.ts
+ * @description Shared service layer of the learned AppDev knowledge base — the one place that
+ *   knows the storage conventions of learned pitfalls (reserved knowledge package
+ *   `packages/appdev-pitfalls/{category}/{slug}`, owner-scope aggregation, manifest upkeep)
+ *   so the MCP tools (mcp/appdev-pitfalls.ts) and the profile-UI REST routes
+ *   (routes/appdev-pitfalls.ts) can never drift. Owner scope = the owner GHII + every
+ *   same-owner agent GAII, deduped by key GHII-first.
+ * @structure listOwnerScopeMemory · findOwnEntry · listLearnedPitfalls · setPitfallFlags ·
+ *   deletePitfallEntry · upsertPitfallManifest · PITFALL_* constants
+ * @usage import { listLearnedPitfalls, setPitfallFlags } from './appdev-kb.js';
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — extracted from mcp/appdev-pitfalls.ts + extended with the UI
+ *     management operations (share/status flags, full-body listing) (AppDev KB UI phase).
+ */
+import { parseGAII } from '../utils/gaii.js';
+export const PITFALL_PACKAGE_ID = 'appdev-pitfalls';
+export const PITFALL_PREFIX = `packages/${PITFALL_PACKAGE_ID}/`;
+export const PITFALL_MANIFEST_KEY = `packages/${PITFALL_PACKAGE_ID}/manifest`;
+export const PITFALL_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export function slugifyKb(s) {
+    return s.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 64) || 'entry';
+}
+function ownerOf(callerGaii, _config) {
+    const parsed = parseGAII(callerGaii);
+    if (parsed?.owner)
+        return parsed.owner;
+    if (callerGaii.includes('@') && !callerGaii.includes('#'))
+        return callerGaii.split('@')[0];
+    return null;
+}
+/** Owner-scope memory aggregation (GHII + all same-owner agents), deduped by key GHII-first. */
+export async function listOwnerScopeMemory(storage, config, callerGaii, opts) {
+    const owner = ownerOf(callerGaii, config);
+    if (!owner)
+        return storage.listMemory(callerGaii, opts);
+    const ownerGhii = `${owner}@${config.nodeId}`;
+    const agents = await storage.getAgentsByOwner(owner);
+    const owners = [ownerGhii, ...agents.map(a => a.gaii)];
+    const priority = new Map(owners.map((g, i) => [g, i]));
+    const rows = await storage.listMemoryForOwners(owners, opts);
+    rows.sort((x, y) => (priority.get(x.ownerGaii) ?? 0) - (priority.get(y.ownerGaii) ?? 0));
+    const seen = new Set();
+    const out = [];
+    for (const rec of rows) {
+        if (!seen.has(rec.key)) {
+            seen.add(rec.key);
+            out.push(rec);
+        }
+    }
+    return out;
+}
+/** The identity set (GHII + agent GAIIs) of the caller's owner — for own/other filtering. */
+export async function ownIdentitySet(storage, config, callerGaii) {
+    const owner = ownerOf(callerGaii, config);
+    if (!owner)
+        return new Set([callerGaii]);
+    const agents = await storage.getAgentsByOwner(owner);
+    return new Set([`${owner}@${config.nodeId}`, ...agents.map(a => a.gaii)]);
+}
+/** Find one of the caller's own KB records by exact key (across the owner identity set). */
+export async function findOwnEntry(storage, config, callerGaii, key) {
+    const rows = await listOwnerScopeMemory(storage, config, callerGaii, { prefix: key });
+    return rows.find(r => r.key === key) ?? null;
+}
+/** Keep the reserved package manifest's entries list in sync (add/replace/remove one ref). */
+export async function upsertPitfallManifest(storage, config, callerGaii, entryKey, title, remove = false) {
+    const now = new Date().toISOString();
+    const existing = await findOwnEntry(storage, config, callerGaii, PITFALL_MANIFEST_KEY);
+    const value = existing?.value ?? {
+        name: 'AppDev pitfalls (learned)',
+        content_type: 'appdev-pitfalls',
+        tags: ['pitfall'],
+        entries: [],
+    };
+    const entries = Array.isArray(value.entries) ? value.entries : [];
+    const idx = entries.findIndex(e => e.key === entryKey);
+    if (remove) {
+        if (idx === -1)
+            return;
+        entries.splice(idx, 1);
+    }
+    else if (idx === -1) {
+        entries.push({ key: entryKey, title });
+    }
+    else {
+        entries[idx] = { key: entryKey, title };
+    }
+    value.entries = entries;
+    value.updated = now;
+    await storage.setMemory({
+        key: PITFALL_MANIFEST_KEY,
+        ownerGaii: existing?.ownerGaii ?? callerGaii,
+        value,
+        visibility: existing?.visibility ?? 'owner',
+        tags: existing?.tags ?? ['knowledge-package', 'pitfall'],
+        ttlHours: null,
+        version: (existing?.version ?? 0) + 1,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+    });
+}
+function toEntry(rec, source) {
+    const v = rec.value;
+    return {
+        key: rec.key,
+        source,
+        shared: rec.visibility === 'public',
+        ...(source === 'shared' ? { owner: rec.ownerGaii } : {}),
+        title: v?.title ?? rec.key,
+        symptom: v?.symptom,
+        resolution: v?.resolution,
+        model: v?.model,
+        category: v?.category,
+        slug: v?.slug,
+        applies_to: v?.applies_to ?? [],
+        severity: v?.severity ?? 'warn',
+        status: v?.status ?? 'active',
+        app_ref: v?.app_ref,
+        updated: v?.updated ?? rec.updatedAt,
+    };
+}
+/**
+ * Full-body learned-pitfall listing for the UI: the caller's own entries (any visibility)
+ * and, with includeShared, other owners' public entries. Curated registry entries are NOT
+ * merged here — the UI reads them from GET /v1/appdev/pitfalls directly.
+ */
+export async function listLearnedPitfalls(storage, config, callerGaii, opts = {}) {
+    const own = (await listOwnerScopeMemory(storage, config, callerGaii, { prefix: PITFALL_PREFIX, tags: ['pitfall'] }))
+        .filter(r => r.key !== PITFALL_MANIFEST_KEY)
+        .map(r => toEntry(r, 'own'));
+    if (!opts.includeShared)
+        return own;
+    const ownIds = await ownIdentitySet(storage, config, callerGaii);
+    const { items } = await storage.listAllMemory({ prefix: PITFALL_PREFIX, visibility: 'public', limit: 500 });
+    const shared = items
+        .filter(rec => rec.key !== PITFALL_MANIFEST_KEY)
+        .filter(rec => !ownIds.has(rec.ownerGaii))
+        .filter(rec => (rec.tags ?? []).includes('pitfall'))
+        .map(rec => toEntry(rec, 'shared'));
+    return [...own, ...shared];
+}
+/** Toggle the share (visibility) and/or status flags on one of the caller's own entries. */
+export async function setPitfallFlags(storage, config, callerGaii, category, slug, flags) {
+    const key = `${PITFALL_PREFIX}${slugifyKb(category)}/${slug.toLowerCase()}`;
+    const existing = await findOwnEntry(storage, config, callerGaii, key);
+    if (!existing)
+        return null;
+    const now = new Date().toISOString();
+    const value = { ...existing.value };
+    if (flags.status) {
+        value.status = flags.status;
+        value.updated = now;
+    }
+    const visibility = flags.share === undefined
+        ? existing.visibility
+        : flags.share ? 'public' : 'owner';
+    const updated = {
+        ...existing,
+        value,
+        visibility,
+        version: (existing.version ?? 0) + 1,
+        updatedAt: now,
+    };
+    await storage.setMemory(updated);
+    return toEntry(updated, 'own');
+}
+/** Delete one of the caller's own entries (record + manifest ref). */
+export async function deletePitfallEntry(storage, config, callerGaii, category, slug) {
+    const key = `${PITFALL_PREFIX}${slugifyKb(category)}/${slug.toLowerCase()}`;
+    const existing = await findOwnEntry(storage, config, callerGaii, key);
+    if (!existing)
+        return false;
+    await storage.deleteMemory(existing.ownerGaii, key);
+    await upsertPitfallManifest(storage, config, callerGaii, key, '', true);
+    return true;
+}
+//# sourceMappingURL=appdev-kb.js.map

package/dist/src/services/appdev-kb.js.map

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

package/dist/src/services/appdev-overview.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file appdev-overview.ts
+ * @description The "big picture" research surface for AI agents building apps ON AIMEAT —
+ *   one call returns compact INDEXES of everything relevant to framing a build: the owner's
+ *   existing apps (best templates), library packs (with per-model AEB proof summaries),
+ *   app-shell templates (T1/T2/T3), skills (the paved-path builder skill first), curated +
+ *   learned pitfalls (model-faceted), and the owner's agent-proposed template proposals.
+ *   Progressive disclosure by design: indexes only, hard caps per list, drill-down via the
+ *   existing endpoints/tools each section names. Scope: app development on the platform only.
+ * @structure buildAppdevOverview(storage, config, callerGaii, opts) → AppdevOverview
+ * @usage
+ *   import { buildAppdevOverview } from '../services/appdev-overview.js';
+ *   const overview = await buildAppdevOverview(storage, config, identity, { model, sections });
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — initial (AppDev KB Phase 5).
+ */
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+export declare const OVERVIEW_SECTIONS: readonly ["apps", "library_packs", "app_templates", "skills", "pitfalls_curated", "pitfalls_learned", "template_proposals"];
+export type OverviewSection = (typeof OVERVIEW_SECTIONS)[number];
+export interface AppdevOverviewOpts {
+    /** Indicative model filter — marks matching pack proofs and filters learned pitfalls. */
+    model?: string;
+    /** Subset of sections to build (token economy); default all. */
+    sections?: string[];
+}
+export declare function buildAppdevOverview(storage: Storage, config: AimeatConfig, callerGaii: string, opts?: AppdevOverviewOpts): Promise<Record<string, unknown>>;
+//# sourceMappingURL=appdev-overview.d.ts.map

package/dist/src/services/appdev-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appdev-overview.d.ts","sourceRoot":"","sources":["../../../src/services/appdev-overview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,yBAAyB,CAAC;AASrE,eAAO,MAAM,iBAAiB,6HAGpB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IAC/B,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAoCD,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,kBAAuB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0IlC"}

package/dist/src/services/appdev-overview.js

@@ -0,0 +1,189 @@
+/**
+ * @file appdev-overview.ts
+ * @description The "big picture" research surface for AI agents building apps ON AIMEAT —
+ *   one call returns compact INDEXES of everything relevant to framing a build: the owner's
+ *   existing apps (best templates), library packs (with per-model AEB proof summaries),
+ *   app-shell templates (T1/T2/T3), skills (the paved-path builder skill first), curated +
+ *   learned pitfalls (model-faceted), and the owner's agent-proposed template proposals.
+ *   Progressive disclosure by design: indexes only, hard caps per list, drill-down via the
+ *   existing endpoints/tools each section names. Scope: app development on the platform only.
+ * @structure buildAppdevOverview(storage, config, callerGaii, opts) → AppdevOverview
+ * @usage
+ *   import { buildAppdevOverview } from '../services/appdev-overview.js';
+ *   const overview = await buildAppdevOverview(storage, config, identity, { model, sections });
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — initial (AppDev KB Phase 5).
+ */
+import { parseGAII } from '../utils/gaii.js';
+import { getLibraryPacks } from '../data/library-packs.js';
+import { getAppTemplateIndex } from '../data/app-templates.js';
+import { getAppdevPitfallIndex, getAppdevPitfallFacets } from '../data/appdev-pitfalls.js';
+import { listSkills } from './skills.js';
+const CAP = 25;
+export const OVERVIEW_SECTIONS = [
+    'apps', 'library_packs', 'app_templates', 'skills',
+    'pitfalls_curated', 'pitfalls_learned', 'template_proposals',
+];
+function capped(items) {
+    return { items: items.slice(0, CAP), total: items.length, truncated: items.length > CAP };
+}
+/** Resolve the caller (GHII or GAII) to its owner name + owner GHII. */
+function ownerOf(callerGaii, config) {
+    const parsed = parseGAII(callerGaii);
+    if (parsed?.owner)
+        return { owner: parsed.owner, ownerGhii: `${parsed.owner}@${config.nodeId}` };
+    if (callerGaii.includes('@') && !callerGaii.includes('#')) {
+        return { owner: callerGaii.split('@')[0], ownerGhii: callerGaii };
+    }
+    return { owner: null, ownerGhii: callerGaii };
+}
+/** Owner-scope memory aggregation (GHII + all same-owner agents), deduped by key. */
+async function listOwnerScope(storage, config, callerGaii, opts) {
+    const { owner, ownerGhii } = ownerOf(callerGaii, config);
+    if (!owner)
+        return storage.listMemory(callerGaii, opts);
+    const agents = await storage.getAgentsByOwner(owner);
+    const owners = [ownerGhii, ...agents.map(a => a.gaii)];
+    const priority = new Map(owners.map((g, i) => [g, i]));
+    const rows = await storage.listMemoryForOwners(owners, opts);
+    rows.sort((x, y) => (priority.get(x.ownerGaii) ?? 0) - (priority.get(y.ownerGaii) ?? 0));
+    const seen = new Set();
+    const out = [];
+    for (const rec of rows) {
+        if (!seen.has(rec.key)) {
+            seen.add(rec.key);
+            out.push(rec);
+        }
+    }
+    return out;
+}
+export async function buildAppdevOverview(storage, config, callerGaii, opts = {}) {
+    const model = opts.model?.trim().toLowerCase();
+    const wanted = new Set((opts.sections ?? []).length > 0
+        ? opts.sections.filter(s => OVERVIEW_SECTIONS.includes(s))
+        : OVERVIEW_SECTIONS);
+    const { owner, ownerGhii } = ownerOf(callerGaii, config);
+    const out = {
+        scope_note: 'App development ON AIMEAT only. Flow: research (this) → frame (tier, packs, iam?) → propose to the user → build → publish + report learnings.',
+        ...(model ? { model } : {}),
+    };
+    // ── The owner's existing apps — often the best starting template ──
+    if (wanted.has('apps')) {
+        const { apps, total } = await storage.listApps({
+            limit: CAP + 1, offset: 0, ownerGaii: ownerGhii, viewerGhii: ownerGhii,
+        });
+        out.apps = {
+            items: apps.slice(0, CAP).map(a => ({
+                filename: a.filename,
+                name: a.manifest?.name ?? a.filename,
+                description: a.manifest?.description ?? null,
+                category: a.manifest?.category ?? null,
+                tags: a.manifest?.tags ?? [],
+                version: a.versionNumber,
+                forkable: a.forkable ?? false,
+                forked_from: a.manifest?.forkedFrom ?? null,
+            })),
+            total,
+            truncated: total > CAP,
+            drill_down: 'aimeat_app_get {filename} for metadata; the app URL for source',
+        };
+    }
+    // ── Library packs (registry index + per-model proof summary) ──
+    if (wanted.has('library_packs')) {
+        const packs = getLibraryPacks().filter(p => p.status !== 'deprecated');
+        out.library_packs = {
+            ...capped(packs.map(p => ({
+                id: p.id,
+                kind: p.kind,
+                title: p.title,
+                category: p.category,
+                status: p.status,
+                model_tier: p.modelTier ?? 'any',
+                proven_models: (p.proofs ?? []).filter(pr => pr.verdict === 'pass').map(pr => pr.model),
+                ...(model ? { proven_for_model: (p.proofs ?? []).some(pr => pr.verdict === 'pass' && pr.model === model) } : {}),
+                ...(p.apiCaveat ? { api_caveat: true } : {}),
+            }))),
+            drill_down: 'GET /v1/library-packs/{id} for the ai_doc + include lines',
+        };
+    }
+    // ── App-shell templates (T1/T2/T3) + components ──
+    if (wanted.has('app_templates')) {
+        const idx = getAppTemplateIndex();
+        out.app_templates = {
+            ...capped(idx.map(t => ({
+                id: t.id, kind: t.kind,
+                ...('tier' in t && t.tier ? { tier: t.tier } : {}),
+                title: t.title ?? t.id,
+            }))),
+            tier_guide: 'T1 pure client (auth+data) · T2 +cortex UI libs · T3 +extension (server-side work)',
+            drill_down: 'GET /v1/app-templates/{id} for the scaffold content',
+        };
+    }
+    // ── Skills — the paved-path builder skill first, then the owner's own ──
+    if (wanted.has('skills')) {
+        const accessor = { ownerName: owner, gaii: callerGaii };
+        const [nodeSkills, userSkills] = await Promise.all([
+            listSkills(storage, config, 'node', accessor).catch(() => []),
+            owner ? listSkills(storage, config, 'user', accessor, owner).catch(() => []) : Promise.resolve([]),
+        ]);
+        const builderFirst = [...nodeSkills].sort((a, b) => (a.name === 'aimeat-app-builder' ? -1 : 0) - (b.name === 'aimeat-app-builder' ? -1 : 0));
+        out.skills = {
+            builder_skill: 'node:aimeat-app-builder — load this FIRST (aimeat_skill_get)',
+            node: capped(builderFirst.map(s => ({ ref: s.ref, description: s.description ?? null }))),
+            user: capped(userSkills.map(s => ({ ref: s.ref, description: s.description ?? null, binding: s.binding ?? null }))),
+            drill_down: 'aimeat_skill_get {ref}; app-bound skills via aimeat_skill_list binding=app:{owner}/{filename}',
+        };
+    }
+    // ── Curated pitfalls (platform registry) ──
+    if (wanted.has('pitfalls_curated')) {
+        const idx = getAppdevPitfallIndex();
+        out.pitfalls_curated = {
+            ...capped(idx),
+            facets: getAppdevPitfallFacets(),
+            drill_down: 'GET /v1/appdev/pitfalls/{id} (filter: ?applies_to=&severity=)',
+        };
+    }
+    // ── Learned pitfalls (owner scope, model-faceted) ──
+    if (wanted.has('pitfalls_learned')) {
+        const records = (await listOwnerScope(storage, config, callerGaii, {
+            prefix: 'packages/appdev-pitfalls/', tags: ['pitfall'],
+        })).filter(r => r.key !== 'packages/appdev-pitfalls/manifest');
+        const modelFacets = {};
+        const entries = records.map(r => {
+            const v = r.value;
+            if (v?.model)
+                modelFacets[v.model] = (modelFacets[v.model] ?? 0) + 1;
+            return {
+                key: r.key, title: v?.title ?? r.key, category: v?.category ?? null,
+                model: v?.model ?? null, severity: v?.severity ?? 'warn',
+                status: v?.status ?? 'active', shared: r.visibility === 'public',
+            };
+        }).filter(e => e.status === 'active')
+            .filter(e => !model || e.model === model);
+        out.pitfalls_learned = {
+            ...capped(entries),
+            model_facets: modelFacets,
+            drill_down: 'aimeat_appdev_pitfall_list (scope/category/model filters, pagination); full entries via aimeat_knowledge_get package_id=appdev-pitfalls',
+        };
+    }
+    // ── Agent-proposed template proposals (owner scope) ──
+    if (wanted.has('template_proposals')) {
+        const records = (await listOwnerScope(storage, config, callerGaii, {
+            prefix: 'template.catalog.', tags: ['template'],
+        })).filter(r => /\.manifest$/.test(r.key));
+        const entries = records.map(r => {
+            const v = r.value;
+            return {
+                id: v?.id ?? r.key.replace(/^template\.catalog\./, '').replace(/\.manifest$/, ''),
+                title: v?.title ?? null, tier: v?.tier ?? null, tags: v?.tags ?? [],
+                model: v?.model ?? null, derived_from: v?.derivedFrom ?? null, start_mode: v?.startMode ?? null,
+            };
+        });
+        out.template_proposals = {
+            ...capped(entries),
+            drill_down: 'aimeat_app_template_get {id} (fork-vs-scaffold guidance + source-app commerce fields)',
+        };
+    }
+    return out;
+}
+//# sourceMappingURL=appdev-overview.js.map

package/dist/src/services/appdev-overview.js.map

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

package/dist/src/services/build-app-prompt.d.ts

@@ -12,6 +12,20 @@
  * @usage import { buildAppPrompt } from '../services/build-app-prompt.js';
  *   const { full, body } = buildAppPrompt(config, { lang: 'en', mode: 'new', idea: '...' });
  * @version-history
+ *   2026-07-19 — Mobile safety checklist section (overflow-x:clip, minmax(0,1fr)+min-width:0,
+ *     wrap-wide-content, verify scrollWidth===clientWidth) + viewport meta gains viewport-fit=cover
+ *     + interactive-widget=resizes-content. Prevention baked into the paved path.
+ *   2026-07-19 — Research-first flow (AppDev KB Phase 7): Step 0 + tier decision tree + finish checklist / appdev-flow prompt / handbook module
+ *   v1.5.0 — 2026-07-19 — MCP-agent section: load node:aimeat-app-builder first + curated
+ *     pitfall registry pointer (/v1/appdev/pitfalls) (AppDev KB Phase 2)
+ *   v1.4.0 — 2026-07-16 — Auth Pattern path 3: AIMEAT.auth.on('login'/'logout') — async logins
+ *     (app-subdomain silent SSO, consent-popup return) fire neither onLogin nor a pending
+ *     login(); AEB-3 finding aeb3-flow-001 (a 5/5 app stayed hidden after grant on app origin).
+ *   v1.3.0 — 2026-07-16 — Library sections generated from the library-pack registry
+ *     (src/data/library-packs.ts): SDK groups + Ready-made UI + the NEW "Optional capability
+ *     packs" index (vendored libs with fetch-on-demand docs at GET /v1/library-packs/:id).
+ *     Design Guidelines now name the self-hosted styling stack; improve mode gains the
+ *     conscious-upgrade rule (read the pack changelog, explain, upgrade only with consent).
  *   v1.2.0 — 2026-07-14 — Agent face section (Agent Face phase 3): the three agent surfaces
  *     (read=face, act=WebMCP tools, learn=bound skill), the six face rules, and the
  *     AIMEATAgentFace.publish snippet (aimeat-agentface.js, phase 2)
@@ -20,6 +34,9 @@
  *   v1.0.0 — 2026-07-13 — ported verbatim from app-catalog buildPromptFromBuilder() (cortex.js)
  *     so the node becomes the single source of truth (AEB pilot finding: the best app-building
  *     accelerator was locked inside the browser bundle, invisible to agentic coders).
+ *   v1.1.0 — 2026-07-19 — "Game / playful look — form language, not just palette" section
+ *     (extruded type via the fonts pack, sticker cards, juice, world-object ambient rule) —
+ *     born from pitfall app/candy-palette-alone-is-not-a-game-look.
  */
 import type { AimeatConfig } from '../config.js';
 export interface BuildAppPromptOptions {

package/dist/src/services/build-app-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-app-prompt.d.ts","sourceRoot":"","sources":["../../../src/services/build-app-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,MAAM,WAAW,qBAAqB;IACpC,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,IAAI,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,4FAA4F;IAC5F,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,8FAA8F;AAC9F,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,qBAA0B,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgOhC"}
+{"version":3,"file":"build-app-prompt.d.ts","sourceRoot":"","sources":["../../../src/services/build-app-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAUjD,MAAM,WAAW,qBAAqB;IACpC,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,IAAI,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,4FAA4F;IAC5F,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,8FAA8F;AAC9F,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,qBAA0B,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAsQhC"}