aimeat 1.2.0

package/dist/src/services/csm-parser.d.ts

@@ -0,0 +1,57 @@
+/** Service type is a free-form string — CSM authors define their own types. */
+export type CsmServiceType = string;
+export type CsmVisibilityDefault = 'private' | 'dmz' | 'local' | 'federation' | 'public';
+export interface CsmFieldDef {
+    type: string;
+    min?: number;
+    max?: number;
+    enum?: string[];
+    format?: string;
+    items?: string | CsmFieldDef;
+    properties?: Record<string, CsmFieldDef & {
+        required?: boolean;
+    }>;
+    required?: boolean;
+}
+export interface CsmDefinition {
+    version: string;
+    service: {
+        name: string;
+        type: CsmServiceType;
+        description: string;
+        version: string;
+        author?: string;
+        semantic?: {
+            '@context'?: Record<string, string>;
+            '@type'?: string;
+            [key: string]: unknown;
+        };
+    };
+    schemaMode: 'open' | 'strict';
+    dataSchema: {
+        required: Record<string, CsmFieldDef>;
+        optional: Record<string, CsmFieldDef>;
+    };
+    consentRequirements: {
+        visibilityDefault: 'private' | 'dmz' | 'local' | 'federation' | 'public';
+        requiresConsent: boolean;
+        consentPurpose: string;
+        dataRetention: string;
+    };
+    moderation: {
+        flagsEnabled: boolean;
+        autoHideThreshold: number;
+        appealsEnabled: boolean;
+    };
+    uiHints: {
+        listView: string[];
+        detailView: string[];
+        searchFields: string[];
+        sortOptions?: string[];
+        cardImageField?: string;
+    };
+}
+export declare function parseCsm(yamlContent: string): CsmDefinition;
+export declare function validateCsm(def: CsmDefinition): string[];
+export declare function csmToJsonSchema(def: CsmDefinition): Record<string, unknown>;
+//# sourceMappingURL=csm-parser.d.ts.map

package/dist/src/services/csm-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csm-parser.d.ts","sourceRoot":"","sources":["../../../src/services/csm-parser.ts"],"names":[],"mappings":"AAIA,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEzF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,cAAc,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE;YACT,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACpC,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;IACF,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;KACvC,CAAC;IACF,mBAAmB,EAAE;QACnB,iBAAiB,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC;QACzE,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,OAAO,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAID,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA6C3D;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,EAAE,CA0BxD;AAgED,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2B3E"}

package/dist/src/services/csm-parser.js

@@ -0,0 +1,161 @@
+import { parse as parseYaml } from 'yaml';
+// ── Parser ──
+export function parseCsm(yamlContent) {
+    const raw = parseYaml(yamlContent);
+    const service = raw.service;
+    const dataSchema = raw.data_schema;
+    const consent = raw.consent_requirements;
+    const moderation = raw.moderation;
+    const uiHints = raw.ui_hints;
+    return {
+        version: String(raw.csm ?? '1.0'),
+        service: {
+            name: String(service?.name ?? ''),
+            type: String(service?.type ?? 'directory'),
+            description: String(service?.description ?? ''),
+            version: String(service?.version ?? '1.0'),
+            author: service?.author ? String(service.author) : undefined,
+            semantic: service?.semantic && typeof service.semantic === 'object'
+                ? service.semantic
+                : undefined,
+        },
+        schemaMode: (raw.schema_mode === 'strict' ? 'strict' : 'open'),
+        dataSchema: {
+            required: (dataSchema?.required ?? {}),
+            optional: (dataSchema?.optional ?? {}),
+        },
+        consentRequirements: {
+            visibilityDefault: String(consent?.visibility_default ?? 'federation'),
+            requiresConsent: consent?.requires_consent !== false,
+            consentPurpose: String(consent?.consent_purpose ?? ''),
+            dataRetention: String(consent?.data_retention ?? 'until_revoked'),
+        },
+        moderation: {
+            flagsEnabled: moderation?.flags_enabled !== false,
+            autoHideThreshold: Number(moderation?.auto_hide_threshold ?? 5),
+            appealsEnabled: moderation?.appeals_enabled === true,
+        },
+        uiHints: {
+            listView: Array.isArray(uiHints?.list_view) ? uiHints.list_view : [],
+            detailView: Array.isArray(uiHints?.detail_view) ? uiHints.detail_view : [],
+            searchFields: Array.isArray(uiHints?.search_fields) ? uiHints.search_fields : [],
+            sortOptions: Array.isArray(uiHints?.sort_options) ? uiHints.sort_options : undefined,
+            cardImageField: uiHints?.card_image_field ? String(uiHints.card_image_field) : undefined,
+        },
+    };
+}
+// ── Validator ──
+export function validateCsm(def) {
+    const errors = [];
+    if (!def.version)
+        errors.push('csm version is required');
+    if (!def.service.name)
+        errors.push('service.name is required');
+    if (!def.service.type)
+        errors.push('service.type is required');
+    if (!def.service.description)
+        errors.push('service.description is required');
+    // Validate data_schema: must have at least one required field
+    const reqKeys = Object.keys(def.dataSchema.required);
+    if (reqKeys.length === 0) {
+        errors.push('data_schema.required must have at least one field');
+    }
+    // Validate field types
+    const allFields = { ...def.dataSchema.required, ...def.dataSchema.optional };
+    for (const [name, field] of Object.entries(allFields)) {
+        if (!field.type)
+            errors.push(`data_schema field "${name}" is missing type`);
+    }
+    // Validate consent requirements
+    if (!['private', 'dmz', 'local', 'federation', 'public'].includes(def.consentRequirements.visibilityDefault)) {
+        errors.push('consent_requirements.visibility_default must be one of: private, dmz, local, federation, public');
+    }
+    return errors;
+}
+// ── JSON Schema Generator ──
+function fieldDefToJsonSchema(field) {
+    const schema = {};
+    switch (field.type) {
+        case 'string':
+            schema.type = 'string';
+            if (field.min !== undefined)
+                schema.minLength = field.min;
+            if (field.max !== undefined)
+                schema.maxLength = field.max;
+            if (field.enum)
+                schema.enum = field.enum;
+            if (field.format)
+                schema.format = field.format;
+            break;
+        case 'number':
+            schema.type = 'number';
+            if (field.min !== undefined)
+                schema.minimum = field.min;
+            if (field.max !== undefined)
+                schema.maximum = field.max;
+            break;
+        case 'integer':
+            schema.type = 'integer';
+            if (field.min !== undefined)
+                schema.minimum = field.min;
+            if (field.max !== undefined)
+                schema.maximum = field.max;
+            break;
+        case 'boolean':
+            schema.type = 'boolean';
+            break;
+        case 'array':
+            schema.type = 'array';
+            if (field.items) {
+                schema.items = typeof field.items === 'string'
+                    ? { type: field.items }
+                    : fieldDefToJsonSchema(field.items);
+            }
+            if (field.min !== undefined)
+                schema.minItems = field.min;
+            if (field.max !== undefined)
+                schema.maxItems = field.max;
+            break;
+        case 'object':
+            schema.type = 'object';
+            if (field.properties) {
+                const props = {};
+                const req = [];
+                for (const [pName, pDef] of Object.entries(field.properties)) {
+                    props[pName] = fieldDefToJsonSchema(pDef);
+                    if (pDef.required !== false)
+                        req.push(pName);
+                }
+                schema.properties = props;
+                if (req.length > 0)
+                    schema.required = req;
+            }
+            break;
+        default:
+            schema.type = field.type;
+    }
+    return schema;
+}
+export function csmToJsonSchema(def) {
+    const properties = {};
+    const required = [];
+    for (const [name, field] of Object.entries(def.dataSchema.required)) {
+        properties[name] = fieldDefToJsonSchema(field);
+        required.push(name);
+    }
+    for (const [name, field] of Object.entries(def.dataSchema.optional)) {
+        properties[name] = fieldDefToJsonSchema(field);
+    }
+    const schema = {
+        type: 'object',
+        properties,
+    };
+    if (required.length > 0) {
+        schema.required = required;
+    }
+    if (def.schemaMode === 'strict') {
+        schema.additionalProperties = false;
+    }
+    return schema;
+}
+//# sourceMappingURL=csm-parser.js.map

package/dist/src/services/csm-parser.js.map

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

package/dist/src/services/csm-seed.d.ts

@@ -0,0 +1,15 @@
+import type { Storage } from '../storage/interface.js';
+/**
+ * Seed CSM template schemas and records on server startup.
+ * Reads all .csm.yaml files from docs/csm-examples/, parses them,
+ * generates JSON Schemas, and registers both the schema (via Schema Locking)
+ * and the CSM record in storage.
+ *
+ * Idempotent — skips any CSM that is already registered by name.
+ *
+ * @param storage  Storage implementation
+ * @param systemGaii  System identity used as registeredBy / lockedBy (e.g. "system@node-id")
+ * @returns Number of newly seeded CSM templates
+ */
+export declare function seedCsmTemplates(storage: Storage, systemGaii: string): Promise<number>;
+//# sourceMappingURL=csm-seed.d.ts.map

package/dist/src/services/csm-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csm-seed.d.ts","sourceRoot":"","sources":["../../../src/services/csm-seed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAOvD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6E5F"}

package/dist/src/services/csm-seed.js

@@ -0,0 +1,89 @@
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseCsm, validateCsm, csmToJsonSchema } from './csm-parser.js';
+import { logger } from '../utils/logger.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Seed CSM template schemas and records on server startup.
+ * Reads all .csm.yaml files from docs/csm-examples/, parses them,
+ * generates JSON Schemas, and registers both the schema (via Schema Locking)
+ * and the CSM record in storage.
+ *
+ * Idempotent — skips any CSM that is already registered by name.
+ *
+ * @param storage  Storage implementation
+ * @param systemGaii  System identity used as registeredBy / lockedBy (e.g. "system@node-id")
+ * @returns Number of newly seeded CSM templates
+ */
+export async function seedCsmTemplates(storage, systemGaii) {
+    const templatesDir = join(__dirname, '..', '..', 'docs', 'csm-examples');
+    if (!existsSync(templatesDir)) {
+        logger.debug('CSM templates directory not found, skipping seed', { path: templatesDir });
+        return 0;
+    }
+    const files = readdirSync(templatesDir).filter(f => f.endsWith('.csm.yaml'));
+    if (files.length === 0)
+        return 0;
+    let seeded = 0;
+    const now = new Date().toISOString();
+    for (const file of files) {
+        try {
+            const yaml = readFileSync(join(templatesDir, file), 'utf-8');
+            const definition = parseCsm(yaml);
+            // Validate the CSM definition
+            const errors = validateCsm(definition);
+            if (errors.length > 0) {
+                logger.warn(`Skipping invalid CSM template ${file}: ${errors.join('; ')}`);
+                continue;
+            }
+            // Check if this CSM is already registered (idempotent)
+            const existing = await storage.getCsm(definition.service.name);
+            if (existing)
+                continue;
+            // Generate JSON Schema from CSM data_schema
+            const jsonSchema = csmToJsonSchema(definition);
+            const schemaKey = `csm.${definition.service.name}`;
+            // Extract semantic annotation from CSM service.semantic (Phase 0.7)
+            const serviceSemantic = definition.service.semantic && typeof definition.service.semantic === 'object'
+                ? definition.service.semantic
+                : undefined;
+            const semanticContext = serviceSemantic
+                ? {
+                    '@context': serviceSemantic['@context'],
+                    '@type': serviceSemantic['@type'],
+                }
+                : undefined;
+            // Register schema in Schema Locking system
+            await storage.setSchema({
+                keyPattern: schemaKey,
+                applyTo: 'prefix',
+                schemaJson: jsonSchema,
+                schemaMode: definition.schemaMode,
+                lockedBy: systemGaii,
+                setAt: now,
+                updatedAt: now,
+                ...(semanticContext ? { semanticContext } : {}),
+            });
+            // Store CSM record
+            await storage.createCsm({
+                name: definition.service.name,
+                definition: definition,
+                jsonSchemaKey: schemaKey,
+                serviceType: definition.service.type,
+                registeredBy: systemGaii,
+                registeredAt: now,
+                updatedAt: now,
+                ...(serviceSemantic ? { semantic: serviceSemantic } : {}),
+            });
+            seeded++;
+            logger.debug(`Seeded CSM template: ${definition.service.name} (${file})`);
+        }
+        catch (err) {
+            logger.warn(`Failed to seed CSM template ${file}`, { error: err.message });
+        }
+    }
+    return seeded;
+}
+//# sourceMappingURL=csm-seed.js.map

package/dist/src/services/csm-seed.js.map

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

package/dist/src/services/directory.d.ts

@@ -0,0 +1,86 @@
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+export interface DirectoryEntry {
+    entryType?: 'person' | 'organism';
+    ghii: string;
+    displayName: string;
+    bio?: string;
+    avatar?: string;
+    interests: string[];
+    city?: string;
+    area?: string;
+    country?: string;
+    lat?: number;
+    lon?: number;
+    semantic?: Record<string, unknown>;
+    organismId?: string;
+    memberCount?: number;
+    joinPolicy?: string;
+}
+export interface DirectorySearchOpts {
+    type?: 'people' | 'organisms';
+    city?: string;
+    area?: string;
+    country?: string;
+    interest?: string;
+    interests?: string[];
+    radiusKm?: number;
+    lat?: number;
+    lon?: number;
+    page?: number;
+    perPage?: number;
+}
+export interface DirectorySearchResult {
+    entries: DirectoryEntry[];
+    total: number;
+    facets: {
+        cities: Array<{
+            name: string;
+            count: number;
+        }>;
+        interests: Array<{
+            name: string;
+            count: number;
+        }>;
+    };
+}
+export interface DirectoryStats {
+    totalPeople: number;
+    totalOrganisms?: number;
+    topInterests: Array<{
+        name: string;
+        count: number;
+    }>;
+    topCities: Array<{
+        name: string;
+        count: number;
+    }>;
+    updatedAt: string;
+}
+export declare class DirectoryService {
+    private config;
+    private storage;
+    private index;
+    private lastUpdated;
+    private rebuildTimer;
+    private static readonly DEBOUNCE_MS;
+    constructor(config: AimeatConfig, storage: Storage);
+    /**
+     * Notify the directory that data relevant to its index has changed.
+     * Triggers a debounced rebuild so rapid consecutive writes don't
+     * cause an index rebuild storm.
+     *
+     * Call this when:
+     * - A GHII profile is created, updated, or deleted
+     * - A profile.*.interests or profile.*.location memory key is written
+     * - A federation consent is granted or revoked
+     */
+    notifyChange(): void;
+    /** Rebuild the entire directory index from storage */
+    rebuildIndex(): Promise<void>;
+    /** Search the directory */
+    search(opts: DirectorySearchOpts): Promise<DirectorySearchResult>;
+    /** Get directory statistics */
+    getStats(): DirectoryStats;
+}
+//# sourceMappingURL=directory.d.ts.map

package/dist/src/services/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../../src/services/directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QACN,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/C,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnD,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB;AAuDD,qBAAa,gBAAgB;IAMf,OAAO,CAAC,MAAM;IAAgB,OAAO,CAAC,OAAO;IALzD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAEvB,MAAM,EAAE,YAAY,EAAU,OAAO,EAAE,OAAO;IAElE;;;;;;;;;OASG;IACH,YAAY,IAAI,IAAI;IAYpB,sDAAsD;IAChD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA8HnC,2BAA2B;IACrB,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA4FvE,+BAA+B;IAC/B,QAAQ,IAAI,cAAc;CAiC3B"}