@adaas/a-frame 0.0.23 → 0.1.2

package/dist/node/storage.cjs

@@ -1,42 +1,45 @@
 'use strict';
 
-var chunk7A6XGT5J_cjs = require('./chunk-7A6XGT5J.cjs');
-var chunkQFUZVN4Y_cjs = require('./chunk-QFUZVN4Y.cjs');
-require('./chunk-B7ZDJXD3.cjs');
-require('./chunk-KK64VLZN.cjs');
-require('./chunk-KLG6HKFU.cjs');
-require('./chunk-3LOMGNWA.cjs');
+var chunkKKMKQGTR_cjs = require('./chunk-KKMKQGTR.cjs');
+var chunk3SLICJ3L_cjs = require('./chunk-3SLICJ3L.cjs');
+require('./chunk-MXUO7OR5.cjs');
 require('./chunk-YVX4W6SI.cjs');
-require('./chunk-GBTFMT3K.cjs');
+require('./chunk-BSBY37MG.cjs');
+require('./chunk-KK64VLZN.cjs');
+require('./chunk-7SEZMRLI.cjs');
+require('./chunk-HELNAM5Y.cjs');
+require('./chunk-IYEDO7OQ.cjs');
 require('./chunk-ZM2RLVVH.cjs');
-require('./chunk-YWWGJ6EJ.cjs');
+require('./chunk-A7CJIUYY.cjs');
+require('./chunk-HAORARSB.cjs');
+require('./chunk-64QCZG53.cjs');
 require('./chunk-QFHZIG7Y.cjs');
 
 
 
 Object.defineProperty(exports, "A_FrameNodeStorage", {
   enumerable: true,
-  get: function () { return chunk7A6XGT5J_cjs.A_FrameNodeStorage; }
+  get: function () { return chunkKKMKQGTR_cjs.A_FrameNodeStorage; }
 });
 Object.defineProperty(exports, "A_FrameStorage", {
   enumerable: true,
-  get: function () { return chunk7A6XGT5J_cjs.A_FrameStorage; }
+  get: function () { return chunkKKMKQGTR_cjs.A_FrameStorage; }
 });
 Object.defineProperty(exports, "A_FrameStorageError", {
   enumerable: true,
-  get: function () { return chunk7A6XGT5J_cjs.A_FrameStorageError; }
+  get: function () { return chunkKKMKQGTR_cjs.A_FrameStorageError; }
 });
 Object.defineProperty(exports, "A_FrameStorageFeatures", {
   enumerable: true,
-  get: function () { return chunk7A6XGT5J_cjs.A_FrameStorageFeatures; }
+  get: function () { return chunkKKMKQGTR_cjs.A_FrameStorageFeatures; }
 });
 Object.defineProperty(exports, "A_FrameStorageOperation", {
   enumerable: true,
-  get: function () { return chunk7A6XGT5J_cjs.A_FrameStorageOperation; }
+  get: function () { return chunkKKMKQGTR_cjs.A_FrameStorageOperation; }
 });
 Object.defineProperty(exports, "A_FrameStorageCodec", {
   enumerable: true,
-  get: function () { return chunkQFUZVN4Y_cjs.A_FrameStorageCodec; }
+  get: function () { return chunk3SLICJ3L_cjs.A_FrameStorageCodec; }
 });
 //# sourceMappingURL=storage.cjs.map
 //# sourceMappingURL=storage.cjs.map

package/dist/node/storage.d.mts

@@ -1,11 +1,12 @@
-import { A as A_FrameStorage, a as A_FrameContext, b as A_FrameStorageSaveDefinitionOperation, c as A_FrameStorageLoadDefinitionsOperation, d as A_FrameStorageDestroyDefinitionsOperation, e as A_FrameStorageSaveNamespaceOperation, f as A_FrameStorageLoadNamespacesOperation, g as A_FrameStorageDestroyNamespacesOperation } from './A-FrameStorage.component-BYjHfHJJ.mjs';
-export { h as A_FrameStorageDestroyDefinitionsOperationParams, i as A_FrameStorageDestroyDefinitionsOperationResult, j as A_FrameStorageDestroyNamespacesOperationParams, k as A_FrameStorageDestroyNamespacesOperationResult, l as A_FrameStorageLoadDefinitionsOperationParams, m as A_FrameStorageLoadDefinitionsOperationResult, n as A_FrameStorageLoadNamespacesOperationParams, o as A_FrameStorageLoadNamespacesOperationResult, p as A_FrameStorageOperation, q as A_FrameStorageSaveDefinitionOperationParams, r as A_FrameStorageSaveDefinitionOperationResult, s as A_FrameStorageSaveNamespaceOperationParams, t as A_FrameStorageSaveNamespaceOperationResult, I as IA_FrameStorage } from './A-FrameStorage.component-BYjHfHJJ.mjs';
+import { A as A_FrameStorage, a as A_FrameContext, b as A_FrameStorageSaveDefinitionOperation, c as A_FrameStorageLoadDefinitionsOperation, d as A_FrameStorageDestroyDefinitionsOperation, e as A_FrameStorageSaveNamespaceOperation, f as A_FrameStorageLoadNamespacesOperation, g as A_FrameStorageDestroyNamespacesOperation } from './A-FrameStorage.component-CDztogHV.mjs';
+export { h as A_FrameStorageDestroyDefinitionsOperationParams, i as A_FrameStorageDestroyDefinitionsOperationResult, j as A_FrameStorageDestroyNamespacesOperationParams, k as A_FrameStorageDestroyNamespacesOperationResult, l as A_FrameStorageLoadDefinitionsOperationParams, m as A_FrameStorageLoadDefinitionsOperationResult, n as A_FrameStorageLoadNamespacesOperationParams, o as A_FrameStorageLoadNamespacesOperationResult, p as A_FrameStorageOperation, q as A_FrameStorageSaveDefinitionOperationParams, r as A_FrameStorageSaveDefinitionOperationResult, s as A_FrameStorageSaveNamespaceOperationParams, t as A_FrameStorageSaveNamespaceOperationResult, I as IA_FrameStorage } from './A-FrameStorage.component-CDztogHV.mjs';
 import { A_Fragment, A_Error } from '@adaas/a-concept';
-import { e as A_FrameNamespace_Serialized, A as A_FrameNamespace } from './A-FrameNamespace.entity-rCm1AavP.mjs';
-import { c as A_FrameDefinition_Serialized, A as A_FrameDefinition } from './A-FrameDefinition.entity-DWGN_Ujr.mjs';
+import { e as A_FrameNamespace_Serialized, A as A_FrameNamespace } from './A-FrameNamespace.entity-BDg1FUgo.mjs';
+import { b as A_FrameDefinition_Serialized } from './A-FrameDefinition.types-BT02yAhQ.mjs';
 import { A_FrameEnv } from './env.mjs';
 import { A_FrameCrypto } from './crypto.mjs';
-import './A-FrameChannel.types-DQF-IiRq.mjs';
+import { A as A_FrameDefinition } from './A-FrameDefinition.entity-yA0GsBoe.mjs';
+import './A-FrameChannel.types-BsE6bNky.mjs';
 import './vector.mjs';
 
 /**
@@ -35,8 +36,12 @@ declare class A_FrameStorageCodec extends A_Fragment {
     A_FRAME_FILE_VERSION: number;
     A_FRAME_HEADER_SIZE: number;
     static get fileExtension(): string;
-    getFileName(namespace: string): string;
+    /** Returns the definitions file name for a given namespace id, e.g. `my-ns.definitions.aframe` */
+    getDefinitionsFileName(namespaceId: string): string;
+    /** Returns the reserved namespaces index file name: `.namespaces.aframe` */
     getNamespaceFileName(): string;
+    /** Glob pattern that matches all definitions files under a directory, e.g. `*.definitions.aframe` */
+    static get definitionsFilePattern(): string;
     encodePayload(records: A_FrameDefinition_Serialized[]): Uint8Array;
     decodePayload(data: Uint8Array): A_FrameDefinition_Serialized[];
     encodeNamespacePayload(records: A_FrameNamespace_Serialized[]): Uint8Array;
@@ -74,6 +79,13 @@ declare const A_FrameStorageFeatures: {
 declare class A_FrameNodeStorage extends A_FrameStorage {
     /** Returns file contents, or null when the file does not exist yet. Re-throws all other I/O errors. */
     private tryReadFile;
+    /**
+     * Resolves extra storage directories by expanding each comma-separated glob
+     * pattern in `pattern`.  Returns an empty array when `pattern` is blank or
+     * when no paths match.  Errors from unsupported patterns are swallowed so
+     * that a bad env value never breaks the application.
+     */
+    private listExtraStorageDirs;
     /**
      * Save a single definition to local file storage. This is called as part of A_FrameDefinition.save() when using the local file storage provider. It reads the existing namespace file, merges in the new or updated definition, and writes back the encrypted file.
      *

package/dist/node/storage.d.ts

@@ -1,11 +1,12 @@
-import { A as A_FrameStorage, a as A_FrameContext, b as A_FrameStorageSaveDefinitionOperation, c as A_FrameStorageLoadDefinitionsOperation, d as A_FrameStorageDestroyDefinitionsOperation, e as A_FrameStorageSaveNamespaceOperation, f as A_FrameStorageLoadNamespacesOperation, g as A_FrameStorageDestroyNamespacesOperation } from './A-FrameStorage.component-CT01fs-t.js';
-export { h as A_FrameStorageDestroyDefinitionsOperationParams, i as A_FrameStorageDestroyDefinitionsOperationResult, j as A_FrameStorageDestroyNamespacesOperationParams, k as A_FrameStorageDestroyNamespacesOperationResult, l as A_FrameStorageLoadDefinitionsOperationParams, m as A_FrameStorageLoadDefinitionsOperationResult, n as A_FrameStorageLoadNamespacesOperationParams, o as A_FrameStorageLoadNamespacesOperationResult, p as A_FrameStorageOperation, q as A_FrameStorageSaveDefinitionOperationParams, r as A_FrameStorageSaveDefinitionOperationResult, s as A_FrameStorageSaveNamespaceOperationParams, t as A_FrameStorageSaveNamespaceOperationResult, I as IA_FrameStorage } from './A-FrameStorage.component-CT01fs-t.js';
+import { A as A_FrameStorage, a as A_FrameContext, b as A_FrameStorageSaveDefinitionOperation, c as A_FrameStorageLoadDefinitionsOperation, d as A_FrameStorageDestroyDefinitionsOperation, e as A_FrameStorageSaveNamespaceOperation, f as A_FrameStorageLoadNamespacesOperation, g as A_FrameStorageDestroyNamespacesOperation } from './A-FrameStorage.component-emIH1a1M.js';
+export { h as A_FrameStorageDestroyDefinitionsOperationParams, i as A_FrameStorageDestroyDefinitionsOperationResult, j as A_FrameStorageDestroyNamespacesOperationParams, k as A_FrameStorageDestroyNamespacesOperationResult, l as A_FrameStorageLoadDefinitionsOperationParams, m as A_FrameStorageLoadDefinitionsOperationResult, n as A_FrameStorageLoadNamespacesOperationParams, o as A_FrameStorageLoadNamespacesOperationResult, p as A_FrameStorageOperation, q as A_FrameStorageSaveDefinitionOperationParams, r as A_FrameStorageSaveDefinitionOperationResult, s as A_FrameStorageSaveNamespaceOperationParams, t as A_FrameStorageSaveNamespaceOperationResult, I as IA_FrameStorage } from './A-FrameStorage.component-emIH1a1M.js';
 import { A_Fragment, A_Error } from '@adaas/a-concept';
-import { e as A_FrameNamespace_Serialized, A as A_FrameNamespace } from './A-FrameNamespace.entity-D3fZBGDx.js';
-import { c as A_FrameDefinition_Serialized, A as A_FrameDefinition } from './A-FrameDefinition.entity-CAUOdEvU.js';
+import { e as A_FrameNamespace_Serialized, A as A_FrameNamespace } from './A-FrameNamespace.entity-HDXcLGcS.js';
+import { b as A_FrameDefinition_Serialized } from './A-FrameDefinition.types-BA_pLGpo.js';
 import { A_FrameEnv } from './env.js';
 import { A_FrameCrypto } from './crypto.js';
-import './A-FrameChannel.types-DQF-IiRq.js';
+import { A as A_FrameDefinition } from './A-FrameDefinition.entity-C0kzaGJ0.js';
+import './A-FrameChannel.types-DD2B11rf.js';
 import './vector.js';
 
 /**
@@ -35,8 +36,12 @@ declare class A_FrameStorageCodec extends A_Fragment {
     A_FRAME_FILE_VERSION: number;
     A_FRAME_HEADER_SIZE: number;
     static get fileExtension(): string;
-    getFileName(namespace: string): string;
+    /** Returns the definitions file name for a given namespace id, e.g. `my-ns.definitions.aframe` */
+    getDefinitionsFileName(namespaceId: string): string;
+    /** Returns the reserved namespaces index file name: `.namespaces.aframe` */
     getNamespaceFileName(): string;
+    /** Glob pattern that matches all definitions files under a directory, e.g. `*.definitions.aframe` */
+    static get definitionsFilePattern(): string;
     encodePayload(records: A_FrameDefinition_Serialized[]): Uint8Array;
     decodePayload(data: Uint8Array): A_FrameDefinition_Serialized[];
     encodeNamespacePayload(records: A_FrameNamespace_Serialized[]): Uint8Array;
@@ -74,6 +79,13 @@ declare const A_FrameStorageFeatures: {
 declare class A_FrameNodeStorage extends A_FrameStorage {
     /** Returns file contents, or null when the file does not exist yet. Re-throws all other I/O errors. */
     private tryReadFile;
+    /**
+     * Resolves extra storage directories by expanding each comma-separated glob
+     * pattern in `pattern`.  Returns an empty array when `pattern` is blank or
+     * when no paths match.  Errors from unsupported patterns are swallowed so
+     * that a bad env value never breaks the application.
+     */
+    private listExtraStorageDirs;
     /**
      * Save a single definition to local file storage. This is called as part of A_FrameDefinition.save() when using the local file storage provider. It reads the existing namespace file, merges in the new or updated definition, and writes back the encrypted file.
      *

package/dist/node/storage.mjs

@@ -1,13 +1,16 @@
-export { A_FrameNodeStorage, A_FrameStorage, A_FrameStorageError, A_FrameStorageFeatures, A_FrameStorageOperation } from './chunk-OJGCQNAH.mjs';
-export { A_FrameStorageCodec } from './chunk-3ONWH75E.mjs';
-import './chunk-JQBYDEMW.mjs';
-import './chunk-K4MZY4ME.mjs';
-import './chunk-APRYHBEF.mjs';
-import './chunk-TO4BPKCY.mjs';
+export { A_FrameNodeStorage, A_FrameStorage, A_FrameStorageError, A_FrameStorageFeatures, A_FrameStorageOperation } from './chunk-JN3UJBUH.mjs';
+export { A_FrameStorageCodec } from './chunk-OYZAQMKD.mjs';
+import './chunk-SL7FT5R5.mjs';
 import './chunk-UPA7VN4R.mjs';
-import './chunk-B7BXP7K4.mjs';
+import './chunk-5OTXZ7BB.mjs';
+import './chunk-K4MZY4ME.mjs';
+import './chunk-AMMQ76RJ.mjs';
+import './chunk-SKIEPTFS.mjs';
+import './chunk-RVXASBMQ.mjs';
 import './chunk-442DXGOD.mjs';
-import './chunk-3TD2PEDZ.mjs';
+import './chunk-WXCQCHAX.mjs';
+import './chunk-IAL2NK2V.mjs';
+import './chunk-2HUSP34L.mjs';
 import './chunk-OI76LHVT.mjs';
 //# sourceMappingURL=storage.mjs.map
 //# sourceMappingURL=storage.mjs.map

package/dist/node/vector.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkYWWGJ6EJ_cjs = require('./chunk-YWWGJ6EJ.cjs');
+var chunkHAORARSB_cjs = require('./chunk-HAORARSB.cjs');
 require('./chunk-QFHZIG7Y.cjs');
 
 
 
 Object.defineProperty(exports, "A_FrameVector", {
   enumerable: true,
-  get: function () { return chunkYWWGJ6EJ_cjs.A_FrameVector; }
+  get: function () { return chunkHAORARSB_cjs.A_FrameVector; }
 });
 //# sourceMappingURL=vector.cjs.map
 //# sourceMappingURL=vector.cjs.map

package/dist/node/vector.d.mts

@@ -4,10 +4,17 @@ declare class A_FrameVector extends A_Entity {
     static get concept(): string;
     readonly values: Float32Array;
     constructor(values: number[] | Float32Array);
+    get dimensions(): number;
     get length(): number;
+    isEqualTo(vector: A_FrameVector): boolean;
     magnitude(): number;
     normalize(): A_FrameVector;
     dot(other: A_FrameVector): number;
+    /**
+     * Returns the cosine similarity between this vector and `other` (range −1 to 1).
+     * Vectors with zero magnitude return 0.
+     */
+    cosineSimilarity(other: A_FrameVector): number;
     private assertSameLength;
     toArray(): number[];
 }

package/dist/node/vector.d.ts

@@ -4,10 +4,17 @@ declare class A_FrameVector extends A_Entity {
     static get concept(): string;
     readonly values: Float32Array;
     constructor(values: number[] | Float32Array);
+    get dimensions(): number;
     get length(): number;
+    isEqualTo(vector: A_FrameVector): boolean;
     magnitude(): number;
     normalize(): A_FrameVector;
     dot(other: A_FrameVector): number;
+    /**
+     * Returns the cosine similarity between this vector and `other` (range −1 to 1).
+     * Vectors with zero magnitude return 0.
+     */
+    cosineSimilarity(other: A_FrameVector): number;
     private assertSameLength;
     toArray(): number[];
 }

package/dist/node/vector.mjs

@@ -1,4 +1,4 @@
-export { A_FrameVector } from './chunk-3TD2PEDZ.mjs';
+export { A_FrameVector } from './chunk-IAL2NK2V.mjs';
 import './chunk-OI76LHVT.mjs';
 //# sourceMappingURL=vector.mjs.map
 //# sourceMappingURL=vector.mjs.map

package/examples/article/main.ts

@@ -0,0 +1,358 @@
+/**
+ * Dynamic Article Generator — Incremental Content → Component Rendering
+ *
+ * Usage:
+ *   npx ts-node generate-article.ts "The History of Jazz Music"
+ *   npx ts-node generate-article.ts "Popular Dog Breeds"
+ *
+ * What you'll see:
+ *   Clean terminal output — each section appears as a rendered UI component
+ *   the moment it's generated. No logs, no debug noise.
+ *
+ * Where the details go:
+ *   logs/<timestamp>_<topic>.log — full prompt/response traces, embeddings,
+ *   scores, timings, errors. Everything you need for analysis.
+ */
+
+import { A_Component, A_Concept, A_Container, A_Error } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame/core';
+import { A_FrameIndex } from '@adaas/a-frame/index';
+import { A_FrameSegment } from '@adaas/a-frame/segment';
+import { A_FrameSchema } from '@adaas/a-frame/schema';
+import { A_FrameCompletion } from '@adaas/a-frame/completion';
+import { config } from 'dotenv';
+import { FileLogger } from '../logger';
+import { ALL_COMPONENTS, Paragraph, RENDERERS } from '../components';
+
+config();
+// A_FRAME_SYNC=true lets concept.load() handle embedding with storage caching:
+// first run embeds all definitions in parallel and saves them to .aframe/;
+// subsequent runs load from cache and skip the embedding API calls entirely.
+
+// ─── Config ───────────────────────────────────────────────────────────────────
+
+const MAX_RETRIES = 2;
+const MIN_SCORE = 0.50;
+
+// ─── Terminal rendering ───────────────────────────────────────────────────────
+
+const ESC = '\x1b[';
+const S = {
+    reset: `${ESC}0m`, bold: `${ESC}1m`, dim: `${ESC}2m`, italic: `${ESC}3m`,
+    cyan: `${ESC}36m`, bcyan: `${ESC}96m`, green: `${ESC}32m`, bgreen: `${ESC}92m`,
+    yellow: `${ESC}33m`, blue: `${ESC}34m`, bblue: `${ESC}94m`, magenta: `${ESC}35m`,
+    red: `${ESC}31m`, gray: `${ESC}90m`, white: `${ESC}37m`,
+};
+const c = (s: string, ...styles: string[]) => styles.join('') + s + S.reset;
+
+type P = { content: string } & Record<string, string | undefined>;
+
+function wrap(text: string, width = 72): string[] {
+    const words = text.split(/\s+/);
+    const lines: string[] = [];
+    let line = '';
+    for (const w of words) {
+        const next = line ? `${line} ${w}` : w;
+        if (next.length > width) { lines.push(line); line = w; } else line = next;
+    }
+    if (line) lines.push(line);
+    return lines;
+}
+
+// ─── Prompts ──────────────────────────────────────────────────────────────────
+
+const PLAN_SYSTEM = [
+    'You are an editorial planner. Return a JSON array of article sections.',
+    'Each object: {"title": "…", "type": "…", "prompt": "…"}',
+    'type must be one of: title, paragraph, profile_card, bar_chart, data_table, stat_callout, list, image.',
+    'prompt is a concise imperative instruction for generating that section.',
+    'Use VARIED types across the article — never more than 2 consecutive paragraphs.',
+    'Return 6–10 sections. Output ONLY the JSON array, no markdown fences.',
+].join('\n');
+
+const COMPONENT_SELECTOR_SYSTEM = [
+    'You are a UI component selector. Given a piece of article content, describe in 1–2 sentences',
+    'the most appropriate visual UI component to display it.',
+    'Available types: Title/Headline, Paragraph, Profile Card (entity attributes), Bar Chart (comparative numbers),',
+    'Data Table (attribute-value pairs), Stat Callout (single prominent figure + context),',
+    'Bulleted List, Image Block (scene description).',
+    'Output ONLY the component description. No preamble, no markdown, no punctuation at end.',
+    'Example: "A bar chart component showing comparative numerical values across named categories"',
+].join('\n');
+
+function contentSystem(type: string): string {
+    const rules: Record<string, string> = {
+        title: 'Write a single compelling headline. No markdown, no #, just the text.',
+        paragraph: 'Write 2–4 sentences of clear prose. No headings, no markdown.',
+        profile_card: 'Write key attributes as "Label: value" lines. First line is the entity name alone.',
+        bar_chart: 'Write "Category: number" lines with real or realistic data. One per line.',
+        data_table: 'Write "Attribute | Value" lines for comparison. One pair per line.',
+        stat_callout: 'Write one prominent number/fact on the first line, then one line of context.',
+        list: 'Write a set of short items, one per line, starting with a dash.',
+        image: 'Write a single line describing what the image shows.',
+    };
+    return `You are a content writer. ${rules[type] ?? rules.paragraph} Be specific. No markdown headings.`;
+}
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function parseJson<T>(raw: string | undefined, label: string): T {
+    if (!raw?.trim()) throw new Error(`${label}: empty`);
+    const m = raw.match(/```(?:json)?\s*([\s\S]*?)```/);
+    return JSON.parse((m ? m[1] : raw).trim()) as T;
+}
+
+function sleep(ms: number): Promise<void> {
+    return new Promise(r => setTimeout(r, ms));
+}
+
+// ─── Spinner ─────────────────────────────────────────────────────────────────
+
+class Spinner {
+    private readonly frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    private idx = 0;
+    private timer: ReturnType<typeof setInterval> | null = null;
+    private label = '';
+
+    start(label: string): this {
+        this.stop();
+        this.label = label;
+        this.idx = 0;
+        this.timer = setInterval(() => {
+            const frame = this.frames[this.idx++ % this.frames.length];
+            process.stdout.write(`\r  ${S.cyan}${frame}${S.reset}  ${S.dim}${this.label}${S.reset}   `);
+        }, 80);
+        return this;
+    }
+
+    update(label: string): void {
+        this.label = label;
+    }
+
+    stop(message?: string): void {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        process.stdout.write('\r\x1b[2K');
+        if (message) console.log(message);
+    }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function askTopic(): Promise<string> {
+    const readline = await import('readline');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => {
+        rl.question(`${S.bcyan}${S.bold}Enter article topic:${S.reset} `, answer => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+
+async function main(): Promise<void> {
+    let topic = process.argv.slice(2).join(' ').trim();
+    if (!topic) {
+        topic = await askTopic();
+    }
+    if (!topic) {
+        console.error('No topic provided.');
+        process.exit(1);
+    }
+
+    const log = new FileLogger(topic);
+    const spinner = new Spinner();
+
+    // ── Setup ─────────────────────────────────────────────────────────────
+
+    const container = new A_Container({ name: 'ArticleUI', components: ALL_COMPONENTS });
+    const concept = new A_Concept({ name: 'ArticleGenerator', components: [A_Frame], containers: [container] });
+
+    spinner.start('Loading framework + embedding definitions…');
+    await concept.load();
+    spinner.stop();
+
+    const index = concept.scope.resolve(A_FrameIndex)!;
+    const defs = index.listDefinitions();
+
+    log.info('Concept loaded', { components: ALL_COMPONENTS.length, indexed: defs.length });
+
+    // ── Plan ──────────────────────────────────────────────────────────────
+
+    const planPrompt = `Create an article plan about: "${topic}". Return 6–10 sections with varied visual types.`;
+
+    log.prompt('PLAN', planPrompt);
+
+    const planner = new A_FrameCompletion({
+        prompt: planPrompt,
+        options: { system: PLAN_SYSTEM, max_tokens: 800 },
+    });
+    container.scope.register(planner);
+
+    spinner.start('Planning article structure…');
+    const planStart = Date.now();
+    await planner.generate();
+    const planMs = Date.now() - planStart;
+    spinner.stop();
+
+    log.prompt('PLAN (response)', planPrompt, planner.text, planMs);
+
+    type Section = { title: string; type: string; prompt: string };
+    const sections = parseJson<Section[]>(planner.text, 'plan');
+
+    log.info('Plan parsed', { count: sections.length, sections: sections.map(s => `[${s.type}] ${s.title}`) });
+
+    console.log(`\n  ${c('✦', S.bcyan)} ${c('Article:', S.dim)} ${c(topic, S.bold, S.bcyan)}\n`);
+
+    // ── Incremental: generate → map → render each section ────────────────
+
+    for (let i = 0; i < sections.length; i++) {
+        const sec = sections[i];
+
+        log.header(`SECTION ${i + 1}/${sections.length}`, { title: sec.title, type: sec.type });
+
+        let rendered = false;
+
+        for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                // 1. Generate content
+                const genStart = Date.now();
+                spinner.start(`[${i + 1}/${sections.length}] ${sec.type} — ${sec.title}`);
+                const gen = new A_FrameCompletion({
+                    prompt: sec.prompt,
+                    options: { system: contentSystem(sec.type), max_tokens: 300 },
+                });
+                container.scope.register(gen);
+                await gen.generate();
+                spinner.stop();
+                const genMs = Date.now() - genStart;
+
+                const body = gen.text?.trim() ?? '';
+                if (!body) { log.warn('Empty content, retrying'); continue; }
+
+                log.prompt(`CONTENT [${sec.title}]`, sec.prompt, body, genMs);
+
+                // 2. Generate component descriptor (bridge: content → search query)
+                spinner.start('Selecting component type…');
+                const selectorStart = Date.now();
+                const selector = new A_FrameCompletion({
+                    prompt: body,   //`Content:\n${body.slice(0, 400)}`,
+                    options: { system: COMPONENT_SELECTOR_SYSTEM, max_tokens: 80 },
+                });
+                container.scope.register(selector);
+                await selector.generate();
+                const selectorMs = Date.now() - selectorStart;
+                spinner.stop();
+
+                const componentQuery = selector.text?.trim() ?? body.slice(0, 200);
+                log.prompt(`COMPONENT QUERY [${sec.title}]`, body.slice(0, 100), componentQuery, selectorMs);
+
+                // 3. Embed the component descriptor and search index
+                spinner.start('Mapping to component…');
+                const embedStart = Date.now();
+                const contentSegment = new A_FrameSegment({ content: componentQuery });
+                container.scope.register(contentSegment);
+                await contentSegment.embed();
+                const embedMs = Date.now() - embedStart;
+                spinner.stop();
+
+                log.info('Embedded component query', { query: componentQuery, ms: embedMs });
+
+                const results = index.search(contentSegment.vector!, { topK: 3 });
+
+                log.searchResults(body.slice(0, 100), results.map(r => ({
+                    name: r.record.name,
+                    score: r.score,
+                    description: r.record.description,
+                })));
+
+                const best = results[0];
+                if (!best || best.score < MIN_SCORE) {
+                    log.warn(`Score too low: ${best?.score.toFixed(3) ?? 'none'} < ${MIN_SCORE}`);
+                    if (attempt < MAX_RETRIES) { await sleep(400); continue; }
+                }
+
+                // 4. Extract draw params
+                let drawParams: P = { content: body };
+                const meta = (best.record.metadata as any)?.params as Record<string, string> | undefined;
+
+                if (meta && Object.keys(meta).length > 0) {
+                    // Build schema descriptor: key → type hint from component metadata
+                    const schemaDescriptor: Record<string, string> = {};
+                    for (const [k, v] of Object.entries(meta)) schemaDescriptor[k] = String(v);
+
+                    try {
+                        spinner.start('Extracting params…');
+                        const extStart = Date.now();
+
+                        // 3. Use A_FrameSchema to extract typed params from raw content
+                        const extractor = new A_FrameSchema({
+                            prompt: body.slice(0, 500),
+                            schema: schemaDescriptor,
+                        });
+                        container.scope.register(extractor);
+                        await extractor.extract();
+                        const extMs = Date.now() - extStart;
+                        spinner.stop();
+
+                        drawParams = { content: body, ...(extractor.data as Record<string, string> ?? {}) };
+
+                        log.prompt(`EXTRACT [${sec.title}]`, body.slice(0, 100), JSON.stringify(extractor.data), extMs);
+                    } catch (e) {
+                        spinner.stop();
+                        log.error('Param extraction failed — using raw content', e);
+                    }
+                }
+
+                // 5. RENDER immediately
+                const renderer = best.record.name ? RENDERERS.get(best.record.name) : undefined;
+                if (renderer) {
+                    renderer(drawParams);
+                } else {
+                    // Fallback: print as paragraph
+                    Paragraph.render(drawParams);
+                }
+
+                log.mapped({
+                    title: sec.title,
+                    type: sec.type,
+                    component: best.record.name,
+                    score: best.score,
+                    params: drawParams,
+                    ms: Date.now() - genStart,
+                });
+
+                rendered = true;
+                break;
+
+            } catch (err) {
+                spinner.stop();
+                log.error(`Attempt ${attempt} failed`, err);
+                if (attempt < MAX_RETRIES) await sleep(400 * attempt);
+            }
+        }
+
+        if (!rendered) {
+            log.error(`Section "${sec.title}" failed after ${MAX_RETRIES} attempts`);
+        }
+    }
+
+    // Done
+    console.log(c(`\n${'─'.repeat(72)}`, S.gray));
+    console.log(c(`  ✓ Article complete  ·  ${sections.length} sections  ·  log: ${log.path}`, S.dim));
+    console.log(c('─'.repeat(72), S.gray));
+    console.log();
+}
+
+main().catch((err) => {
+    if (err instanceof A_Error) {
+        console.error(`\n${c('✗ A_Error:', S.red)}`, JSON.stringify(err.toJSON(), null, 2));
+    } else {
+        console.error(`\n${c('✗ Error:', S.red)}`, err);
+    }
+    process.exit(1);
+});